Documentation/devicetree/bindings/opp/ti-omap5-opp-supply.txt

   1 Texas Instruments OMAP compatible OPP supply description
   2
   3 OMAP5, DRA7, and AM57 family of SoCs have Class0 AVS eFuse registers which
   4 contain data that can be used to adjust voltages programmed for some of their
   5 supplies for more efficient operation. This binding provides the information
   6 needed to read these values and use them to program the main regulator during
   7 an OPP transitions.
   8
   9 Also, some supplies may have an associated vbb-supply which is an Adaptive Body
  10 Bias regulator which much be transitioned in a specific sequence with regards
  11 to the vdd-supply and clk when making an OPP transition. By supplying two
  12 regulators to the device that will undergo OPP transitions we can make use
  13 of the multi regulator binding that is part of the OPP core described here [1]
  14 to describe both regulators needed by the platform.
  15
  16 [1] Documentation/devicetree/bindings/opp/opp-v2.yaml
  17
  18 Required Properties for Device Node:
  19 - vdd-supply: phandle to regulator controlling VDD supply
  20 - vbb-supply: phandle to regulator controlling Body Bias supply
  21               (Usually Adaptive Body Bias regulator)
  22
  23 Required Properties for opp-supply node:
  24 - compatible: Should be one of:
  25         "ti,omap-opp-supply" - basic OPP supply controlling VDD and VBB
  26         "ti,omap5-opp-supply" - OMAP5+ optimized voltages in efuse(class0)VDD
  27                             along with VBB
  28         "ti,omap5-core-opp-supply" - OMAP5+ optimized voltages in efuse(class0) VDD
  29                             but no VBB.
  30 - reg: Address and length of the efuse register set for the device (mandatory
  31         only for "ti,omap5-opp-supply")
  32 - ti,efuse-settings: An array of u32 tuple items providing information about
  33         optimized efuse configuration. Each item consists of the following:
  34         volt: voltage in uV - reference voltage (OPP voltage)
  35         efuse_offseet: efuse offset from reg where the optimized voltage is stored.
  36 - ti,absolute-max-voltage-uv: absolute maximum voltage for the OPP supply.
  37
  38 Example:
  39
  40 /* Device Node (CPU)  */
  41 cpus {
  42         cpu0: cpu@0 {
  43                 device_type = "cpu";
  44
  45                 ...
  46
  47                 vdd-supply = <&vcc>;
  48                 vbb-supply = <&abb_mpu>;
  49         };
  50 };
  51
  52 /* OMAP OPP Supply with Class0 registers */
  53 opp_supply_mpu: opp_supply@4a003b20 {
  54         compatible = "ti,omap5-opp-supply";
  55         reg = <0x4a003b20 0x8>;
  56         ti,efuse-settings = <
  57         /* uV   offset */
  58         1060000 0x0
  59         1160000 0x4
  60         1210000 0x8
  61         >;
  62         ti,absolute-max-voltage-uv = <1500000>;
  63 };