Documentation/devicetree/bindings/power/rockchip-io-domain.txt

   1 Rockchip SRAM for IO Voltage Domains:
   2 -------------------------------------
   3
   4 IO domain voltages on some Rockchip SoCs are variable but need to be
   5 kept in sync between the regulators and the SoC using a special
   6 register.
   7
   8 A 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
  13 Said another way, this driver simply handles keeping bits in the SoC's
  14 general register file (GRF) in sync with the actual value of a voltage
  15 hooked up to the pins.
  16
  17 Note 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
  22 If there were some other software that had the smarts of making
  23 decisions about regulators, it would work in conjunction with this
  24 driver.  When that other software adjusted a regulator's voltage then
  25 this driver would handle telling the SoC about it.  A good example is
  26 vqmmc for SD.  In that case the dw_mmc driver simply is told about a
  27 regulator.  It changes the regulator between 3.3V and 1.8V at the
  28 right time.  This driver notices the change and makes sure that the
  29 SoC is on the same page.
  30
  31
  32 Required properties:
  33 - compatible: should be one of:
  34   - "rockchip,rk3188-io-voltage-domain" for rk3188
  35   - "rockchip,rk3228-io-voltage-domain" for rk3228
  36   - "rockchip,rk3288-io-voltage-domain" for rk3288
  37   - "rockchip,rk3328-io-voltage-domain" for rk3328
  38   - "rockchip,rk3368-io-voltage-domain" for rk3368
  39   - "rockchip,rk3368-pmu-io-voltage-domain" for rk3368 pmu-domains
  40   - "rockchip,rk3399-io-voltage-domain" for rk3399
  41   - "rockchip,rk3399-pmu-io-voltage-domain" for rk3399 pmu-domains
  42   - "rockchip,rv1108-io-voltage-domain" for rv1108
  43   - "rockchip,rv1108-pmu-io-voltage-domain" for rv1108 pmu-domains
  44
  45 Deprecated properties:
  46 - rockchip,grf: phandle to the syscon managing the "general register files"
  47     Systems should move the io-domains to a sub-node of the grf simple-mfd.
  48
  49 You specify supplies using the standard regulator bindings by including
  50 a phandle the relevant regulator.  All specified supplies must be able
  51 to report their voltage.  The IO Voltage Domain for any non-specified
  52 supplies will be not be touched.
  53
  54 Possible supplies for rk3188:
  55 - ap0-supply:    The supply connected to AP0_VCC.
  56 - ap1-supply:    The supply connected to AP1_VCC.
  57 - cif-supply:    The supply connected to CIF_VCC.
  58 - flash-supply:  The supply connected to FLASH_VCC.
  59 - lcdc0-supply:  The supply connected to LCD0_VCC.
  60 - lcdc1-supply:  The supply connected to LCD1_VCC.
  61 - vccio0-supply: The supply connected to VCCIO0.
  62 - vccio1-supply: The supply connected to VCCIO1.
  63                  Sometimes also labeled VCCIO1 and VCCIO2.
  64
  65 Possible supplies for rk3228:
  66 - vccio1-supply: The supply connected to VCCIO1.
  67 - vccio2-supply: The supply connected to VCCIO2.
  68 - vccio3-supply: The supply connected to VCCIO3.
  69 - vccio4-supply: The supply connected to VCCIO4.
  70
  71 Possible supplies for rk3288:
  72 - audio-supply:  The supply connected to APIO4_VDD.
  73 - bb-supply:     The supply connected to APIO5_VDD.
  74 - dvp-supply:    The supply connected to DVPIO_VDD.
  75 - flash0-supply: The supply connected to FLASH0_VDD.  Typically for eMMC
  76 - flash1-supply: The supply connected to FLASH1_VDD.  Also known as SDIO1.
  77 - gpio30-supply: The supply connected to APIO1_VDD.
  78 - gpio1830       The supply connected to APIO2_VDD.
  79 - lcdc-supply:   The supply connected to LCDC_VDD.
  80 - sdcard-supply: The supply connected to SDMMC0_VDD.
  81 - wifi-supply:   The supply connected to APIO3_VDD.  Also known as SDIO0.
  82
  83 Possible supplies for rk3368:
  84 - audio-supply:  The supply connected to APIO3_VDD.
  85 - dvp-supply:    The supply connected to DVPIO_VDD.
  86 - flash0-supply: The supply connected to FLASH0_VDD.  Typically for eMMC
  87 - gpio30-supply: The supply connected to APIO1_VDD.
  88 - gpio1830       The supply connected to APIO4_VDD.
  89 - sdcard-supply: The supply connected to SDMMC0_VDD.
  90 - wifi-supply:   The supply connected to APIO2_VDD.  Also known as SDIO0.
  91
  92 Possible supplies for rk3368 pmu-domains:
  93 - pmu-supply:    The supply connected to PMUIO_VDD.
  94 - vop-supply:    The supply connected to LCDC_VDD.
  95
  96 Possible supplies for rk3399:
  97 - bt656-supply:  The supply connected to APIO2_VDD.
  98 - audio-supply:  The supply connected to APIO5_VDD.
  99 - sdmmc-supply:  The supply connected to SDMMC0_VDD.
 100 - gpio1830       The supply connected to APIO4_VDD.
 101
 102 Possible supplies for rk3399 pmu-domains:
 103 - pmu1830-supply:The supply connected to PMUIO2_VDD.
 104
 105 Example:
 106
 107         io-domains {
 108                 compatible = "rockchip,rk3288-io-voltage-domain";
 109                 rockchip,grf = <&grf>;
 110
 111                 audio-supply = <&vcc18_codec>;
 112                 bb-supply = <&vcc33_io>;
 113                 dvp-supply = <&vcc_18>;
 114                 flash0-supply = <&vcc18_flashio>;
 115                 gpio1830-supply = <&vcc33_io>;
 116                 gpio30-supply = <&vcc33_pmuio>;
 117                 lcdc-supply = <&vcc33_lcd>;
 118                 sdcard-supply = <&vccio_sd>;
 119                 wifi-supply = <&vcc18_wl>;
 120         };