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