Orange Pi5 kernel

^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  1) # SPDX-License-Identifier: GPL-2.0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  2) %YAML 1.2
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  3) ---
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  4) $id: http://devicetree.org/schemas/spmi/spmi.yaml#
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  5) $schema: http://devicetree.org/meta-schemas/core.yaml#
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  6) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  7) title: System Power Management Interface (SPMI) Controller
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  8) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  9) maintainers:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 10)   - Stephen Boyd <sboyd@kernel.org>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 11) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 12) description: |
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 13)   The System Power Management (SPMI) controller is a 2-wire bus defined
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 14)   by the MIPI Alliance for power management control to be used on SoC designs.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 15) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 16)   SPMI controllers are modelled in device tree using a generic set of
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 17)   bindings defined here, plus any bus controller specific properties, if
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 18)   needed.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 19) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 20)   Each SPMI controller has zero or more child nodes (up to 16 ones), each
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 21)   one representing an unique slave at the bus.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 22) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 23) properties:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 24)   $nodename:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 25)     pattern: "^spmi@.*"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 26) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 27)   reg:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 28)     maxItems: 1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 29) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 30)   "#address-cells":
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 31)     const: 2
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 32) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 33)   "#size-cells":
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 34)     const: 0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 35) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 36) patternProperties:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 37)   "@[0-9a-f]$":
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 38)     description: up to 16 child PMIC nodes
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 39)     type: object
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 40) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 41)     properties:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 42)       reg:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 43)         minItems: 1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 44)         maxItems: 2
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 45)         items:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 46)           - minimum: 0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 47)             maximum: 0xf
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 48)           - enum: [ 0 ]
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 49)             description: |
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 50)               0 means user ID address. 1 is reserved for group ID address.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 51) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 52)     required:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 53)       - reg
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 54) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 55) required:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 56)   - reg
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 57) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 58) additionalProperties: true
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 59) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 60) examples:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 61)   - |
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 62)     #include <dt-bindings/spmi/spmi.h>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 63) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 64)     spmi@0 {
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 65)       reg = <0 0>;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 66) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 67)       #address-cells = <2>;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 68)       #size-cells = <0>;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 69) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 70)       child@0 {
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 71)         reg = <0 SPMI_USID>;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 72)       };
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 73) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 74)       child@7 {
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 75)         reg = <7 SPMI_USID>;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 76)       };
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 77)     };