The Design and Implementation of the FreeBSD Operating System, Second Edition
Now available: The Design and Implementation of the FreeBSD Operating System (Second Edition)


[ source navigation ] [ diff markup ] [ identifier search ] [ freetext search ] [ file search ] [ list types ] [ track identifier ]

FreeBSD/Linux Kernel Cross Reference
sys/contrib/device-tree/Bindings/soc/ti/sci-pm-domain.txt

Version: -  FREEBSD  -  FREEBSD-13-STABLE  -  FREEBSD-13-0  -  FREEBSD-12-STABLE  -  FREEBSD-12-0  -  FREEBSD-11-STABLE  -  FREEBSD-11-0  -  FREEBSD-10-STABLE  -  FREEBSD-10-0  -  FREEBSD-9-STABLE  -  FREEBSD-9-0  -  FREEBSD-8-STABLE  -  FREEBSD-8-0  -  FREEBSD-7-STABLE  -  FREEBSD-7-0  -  FREEBSD-6-STABLE  -  FREEBSD-6-0  -  FREEBSD-5-STABLE  -  FREEBSD-5-0  -  FREEBSD-4-STABLE  -  FREEBSD-3-STABLE  -  FREEBSD22  -  l41  -  OPENBSD  -  linux-2.6  -  MK84  -  PLAN9  -  xnu-8792 
SearchContext: -  none  -  3  -  10 

    1 Texas Instruments TI-SCI Generic Power Domain
    2 ---------------------------------------------
    3 
    4 Some TI SoCs contain a system controller (like the PMMC, etc...) that is
    5 responsible for controlling the state of the IPs that are present.
    6 Communication between the host processor running an OS and the system
    7 controller happens through a protocol known as TI-SCI [1].
    8 
    9 [1] Documentation/devicetree/bindings/arm/keystone/ti,sci.txt
   10 
   11 PM Domain Node
   12 ==============
   13 The PM domain node represents the global PM domain managed by the PMMC, which
   14 in this case is the implementation as documented by the generic PM domain
   15 bindings in Documentation/devicetree/bindings/power/power-domain.yaml.  Because
   16 this relies on the TI SCI protocol to communicate with the PMMC it must be a
   17 child of the pmmc node.
   18 
   19 Required Properties:
   20 --------------------
   21 - compatible: should be "ti,sci-pm-domain"
   22 - #power-domain-cells: Can be one of the following:
   23                         1: Containing the device id of each node
   24                         2: First entry should be device id
   25                            Second entry should be one of the floowing:
   26                            TI_SCI_PD_EXCLUSIVE: To allow device to be
   27                                                 exclusively controlled by
   28                                                 the requesting hosts.
   29                            TI_SCI_PD_SHARED: To allow device to be shared
   30                                              by multiple hosts.
   31 
   32 Example (K2G):
   33 -------------
   34         pmmc: pmmc {
   35                 compatible = "ti,k2g-sci";
   36                 ...
   37 
   38                 k2g_pds: power-controller {
   39                         compatible = "ti,sci-pm-domain";
   40                         #power-domain-cells = <1>;
   41                 };
   42         };
   43 
   44 PM Domain Consumers
   45 ===================
   46 Hardware blocks belonging to a PM domain should contain a "power-domains"
   47 property that is a phandle pointing to the corresponding PM domain node
   48 along with an index representing the device id to be passed to the PMMC
   49 for device control.
   50 
   51 Required Properties:
   52 --------------------
   53 - power-domains: phandle pointing to the corresponding PM domain node
   54                  and an ID representing the device.
   55 
   56 See http://processors.wiki.ti.com/index.php/TISCI#66AK2G02_Data for the list
   57 of valid identifiers for k2g.
   58 
   59 Example (K2G):
   60 --------------------
   61         uart0: serial@2530c00 {
   62                 compatible = "ns16550a";
   63                 ...
   64                 power-domains = <&k2g_pds 0x002c>;
   65         };

Cache object: cbef96b335d0951e82f935a1b3252e1a


[ source navigation ] [ diff markup ] [ identifier search ] [ freetext search ] [ file search ] [ list types ] [ track identifier ]


This page is part of the FreeBSD/Linux Linux Kernel Cross-Reference, and was automatically generated using a modified version of the LXR engine.