1Rockchip SRAM for IO Voltage Domains: 2------------------------------------- 3 4IO domain voltages on some Rockchip SoCs are variable but need to be 5kept in sync between the regulators and the SoC using a special 6register. 7 8A specific example using rk3288: 9- If the regulator hooked up to a pin like SDMMC0_VDD is 3.3V then 10 bit 7 of GRF_IO_VSEL needs to be 0. If the regulator hooked up to 11 that same pin is 1.8V then bit 7 of GRF_IO_VSEL needs to be 1. 12 13Said another way, this driver simply handles keeping bits in the SoC's 14general register file (GRF) in sync with the actual value of a voltage 15hooked up to the pins. 16 17Note that this driver specifically doesn't include: 18- any logic for deciding what voltage we should set regulators to 19- any logic for deciding whether regulators (or internal SoC blocks) 20 should have power or not have power 21 22If there were some other software that had the smarts of making 23decisions about regulators, it would work in conjunction with this 24driver. When that other software adjusted a regulator's voltage then 25this driver would handle telling the SoC about it. A good example is 26vqmmc for SD. In that case the dw_mmc driver simply is told about a 27regulator. It changes the regulator between 3.3V and 1.8V at the 28right time. This driver notices the change and makes sure that the 29SoC is on the same page. 30 31 32Required properties: 33- compatible: should be one of: 34 - "rockchip,px30-io-voltage-domain" for px30 35 - "rockchip,px30-pmu-io-voltage-domain" for px30 pmu-domains 36 - "rockchip,rk3188-io-voltage-domain" for rk3188 37 - "rockchip,rk3228-io-voltage-domain" for rk3228 38 - "rockchip,rk3288-io-voltage-domain" for rk3288 39 - "rockchip,rk3308-io-voltage-domain" for rk3308 40 - "rockchip,rk3328-io-voltage-domain" for rk3328 41 - "rockchip,rk3368-io-voltage-domain" for rk3368 42 - "rockchip,rk3368-pmu-io-voltage-domain" for rk3368 pmu-domains 43 - "rockchip,rk3399-io-voltage-domain" for rk3399 44 - "rockchip,rk3399-pmu-io-voltage-domain" for rk3399 pmu-domains 45 - "rockchip,rk3568-pmu-io-voltage-domain" for rk3568 pmu-domains 46 - "rockchip,rv1108-io-voltage-domain" for rv1108 47 - "rockchip,rv1108-pmu-io-voltage-domain" for rv1108 pmu-domains 48 - "rockchip,rv1126-pmu-io-voltage-domain" for rv1126 pmu-domains 49 50Deprecated properties: 51- rockchip,grf: phandle to the syscon managing the "general register files" 52 Systems should move the io-domains to a sub-node of the grf simple-mfd. 53 54You specify supplies using the standard regulator bindings by including 55a phandle the relevant regulator. All specified supplies must be able 56to report their voltage. The IO Voltage Domain for any non-specified 57supplies will be not be touched. 58 59Possible supplies for PX30: 60- vccio6-supply: The supply connected to VCCIO6. 61- vccio1-supply: The supply connected to VCCIO1. 62- vccio2-supply: The supply connected to VCCIO2. 63- vccio3-supply: The supply connected to VCCIO3. 64- vccio4-supply: The supply connected to VCCIO4. 65- vccio5-supply: The supply connected to VCCIO5. 66- vccio-oscgpi-supply: The supply connected to VCCIO_OSCGPI. 67 68Possible supplies for PX30 pmu-domains: 69- pmuio1-supply: The supply connected to PMUIO1. 70- pmuio2-supply: The supply connected to PMUIO2. 71 72Possible supplies for rk3188: 73- ap0-supply: The supply connected to AP0_VCC. 74- ap1-supply: The supply connected to AP1_VCC. 75- cif-supply: The supply connected to CIF_VCC. 76- flash-supply: The supply connected to FLASH_VCC. 77- lcdc0-supply: The supply connected to LCD0_VCC. 78- lcdc1-supply: The supply connected to LCD1_VCC. 79- vccio0-supply: The supply connected to VCCIO0. 80- vccio1-supply: The supply connected to VCCIO1. 81 Sometimes also labeled VCCIO1 and VCCIO2. 82 83Possible supplies for rk3228: 84- vccio1-supply: The supply connected to VCCIO1. 85- vccio2-supply: The supply connected to VCCIO2. 86- vccio3-supply: The supply connected to VCCIO3. 87- vccio4-supply: The supply connected to VCCIO4. 88 89Possible supplies for rk3288: 90- audio-supply: The supply connected to APIO4_VDD. 91- bb-supply: The supply connected to APIO5_VDD. 92- dvp-supply: The supply connected to DVPIO_VDD. 93- flash0-supply: The supply connected to FLASH0_VDD. Typically for eMMC 94- flash1-supply: The supply connected to FLASH1_VDD. Also known as SDIO1. 95- gpio30-supply: The supply connected to APIO1_VDD. 96- gpio1830 The supply connected to APIO2_VDD. 97- lcdc-supply: The supply connected to LCDC_VDD. 98- sdcard-supply: The supply connected to SDMMC0_VDD. 99- wifi-supply: The supply connected to APIO3_VDD. Also known as SDIO0. 100 101Possible supplies for rk3368: 102- audio-supply: The supply connected to APIO3_VDD. 103- dvp-supply: The supply connected to DVPIO_VDD. 104- flash0-supply: The supply connected to FLASH0_VDD. Typically for eMMC 105- gpio30-supply: The supply connected to APIO1_VDD. 106- gpio1830 The supply connected to APIO4_VDD. 107- sdcard-supply: The supply connected to SDMMC0_VDD. 108- wifi-supply: The supply connected to APIO2_VDD. Also known as SDIO0. 109 110Possible supplies for rk3368 pmu-domains: 111- pmu-supply: The supply connected to PMUIO_VDD. 112- vop-supply: The supply connected to LCDC_VDD. 113 114Possible supplies for rk3399: 115- bt656-supply: The supply connected to APIO2_VDD. 116- audio-supply: The supply connected to APIO5_VDD. 117- sdmmc-supply: The supply connected to SDMMC0_VDD. 118- gpio1830-supply: The supply connected to APIO4_VDD. 119 120Possible supplies for rk3399 pmu-domains: 121- pmu1830-supply:The supply connected to PMUIO2_VDD. 122 123Possible supplies for rk3568 pmu-domains: 124- vccio1-supply:The supply connected to VCCIO1. 125- vccio2-supply:The supply connected to VCCIO2, can be reserved since ignored by driver. 126- vccio3-supply:The supply connected to VCCIO3. 127- vccio4-supply:The supply connected to VCCIO4. 128- vccio5-supply:The supply connected to VCCIO5. 129- vccio6-supply:The supply connected to VCCIO6. 130- vccio7-supply:The supply connected to VCCIO7. 131- pmuio1-supply:The supply connected to PMUIO1, 3.3v only can be reserved 132- pmuio2-supply:The supply connected to PMUIO2. 133 134Possible supplies for rv1126 pmu-domains: 135- vccio1-supply:The supply connected to VCCIO1_VDD. 136- vccio2-supply:The supply connected to VCCIO2_VDD. 137- vccio3-supply:The supply connected to VCCIO3_VDD. 138- vccio4-supply:The supply connected to VCCIO4_VDD. 139- vccio5-supply:The supply connected to VCCIO5_VDD. 140- vccio6-supply:The supply connected to VCCIO6_VDD. 141- vccio7-supply:The supply connected to VCCIO7_VDD. 142- pmuio1-supply:The supply connected to PMUIO1_VDD. 143- pmuio2-supply:The supply connected to PMUIO2_VDD. 144 145Example: 146 147 io-domains { 148 compatible = "rockchip,rk3288-io-voltage-domain"; 149 rockchip,grf = <&grf>; 150 151 audio-supply = <&vcc18_codec>; 152 bb-supply = <&vcc33_io>; 153 dvp-supply = <&vcc_18>; 154 flash0-supply = <&vcc18_flashio>; 155 gpio1830-supply = <&vcc33_io>; 156 gpio30-supply = <&vcc33_pmuio>; 157 lcdc-supply = <&vcc33_lcd>; 158 sdcard-supply = <&vccio_sd>; 159 wifi-supply = <&vcc18_wl>; 160 }; 161