Unverified Commit 4add09ab authored by Mark Brown's avatar Mark Brown
Browse files

mfd: cpcap: convert documentation to schema and add 

Merge series from Svyatoslav Ryhel <clamor95@gmail.com>:

The initial goal was only to add support for the CPCAP used in the Mot
Tegra20 board; however, since the documentation was already partially
converted, I decided to complete the conversion to schema too.
parents f308205e d90c0f78

Documentation/devicetree/bindings/regulator/cpcap-regulator.txt

deleted100644 → 0
+0 −35
Original line number Diff line number Diff line 
Motorola CPCAP PMIC voltage regulators

------------------------------------



Requires node properties:

- "compatible" value one of:

    "motorola,cpcap-regulator"

    "motorola,mapphone-cpcap-regulator"

    "motorola,xoom-cpcap-regulator"



Required regulator properties:

- "regulator-name"

- "regulator-enable-ramp-delay"

- "regulator-min-microvolt"

- "regulator-max-microvolt"



Optional regulator properties:

- "regulator-boot-on"



See Documentation/devicetree/bindings/regulator/regulator.txt

for more details about the regulator properties.



Example:



cpcap_regulator: regulator {

	compatible = "motorola,cpcap-regulator";



	cpcap_regulators: regulators {

		sw5: SW5 {

			regulator-min-microvolt = <5050000>;

			regulator-max-microvolt = <5050000>;

			regulator-enable-ramp-delay = <50000>;

			regulator-boot-on;

		};

	};

};

Documentation/devicetree/bindings/regulator/motorola,cpcap-regulator.yaml

0 → 100644
+47 −0
Original line number Diff line number Diff line 
# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)

%YAML 1.2

---

$id: http://devicetree.org/schemas/regulator/motorola,cpcap-regulator.yaml#

$schema: http://devicetree.org/meta-schemas/core.yaml#



title: Motorola CPCAP PMIC regulators



maintainers:

  - Svyatoslav Ryhel <clamor95@gmail.com>



description:

  This module is part of the Motorola CPCAP MFD device. For more details

  see Documentation/devicetree/bindings/mfd/motorola,cpcap.yaml. The

  regulator controller is represented as a sub-node of the PMIC node

  on the device tree.



properties:

  compatible:

    enum:

      - motorola,cpcap-regulator

      - motorola,mapphone-cpcap-regulator

      - motorola,mot-cpcap-regulator

      - motorola,xoom-cpcap-regulator



  regulators:

    type: object



    patternProperties:

      "^(SW[1-6]|V(CAM|CSI|DAC|DIG|FUSE|HVIO|SDIO|PLL|RF[12]|RFREF|WLAN[12]|SIM|SIMCARD|VIB|USB|AUDIO))$":

        $ref: /schemas/regulator/regulator.yaml#

        type: object



        required:

          - regulator-name

          - regulator-enable-ramp-delay

          - regulator-min-microvolt

          - regulator-max-microvolt



        unevaluatedProperties: false



required:

  - compatible



additionalProperties: false



...

drivers/regulator/cpcap-regulator.c

+105 −0
Original line number Diff line number Diff line
@@ -261,6 +261,30 @@ static const struct regulator_ops cpcap_regulator_ops = { 
};



static const unsigned int unknown_val_tbl[] = { 0, };

static const unsigned int sw_mot_val_tbl[] =  { 600000, 612500, 625000,

						637500, 650000, 662500,

						675000, 687500, 700000,

						712500, 725000, 737500,

						750000, 762500, 775000,

						787500, 800000, 812500,

						825000, 837500, 850000,

						862500, 875000, 887500,

						900000, 912500, 925000,

						937500, 950000, 962500,

						975000, 987500, 1000000,

						1012500, 1025000, 1037500,

						1050000, 1062500, 1075000,

						1087500, 1100000, 1112500,

						1125000, 1137500, 1150000,

						1162500, 1175000, 1187500,

						1200000, 1212500, 1225000,

						1237500, 1250000, 1262500,

						1275000, 1287500, 1300000,

						1312500, 1325000, 1337500,

						1350000, 1362500, 1375000,

						1387500, 1400000, 1412500,

						1425000, 1437500, 1450000,

						1462500, 1475000, };

static const unsigned int sw2_sw4_val_tbl[] = { 612500, 625000, 637500,

						650000, 662500, 675000,

						687500, 700000, 712500,
@@ -284,6 +308,7 @@ static const unsigned int sw2_sw4_val_tbl[] = { 612500, 625000, 637500, 
						1362500, 1375000, 1387500,

						1400000, 1412500, 1425000,

						1437500, 1450000, 1462500, };

static const unsigned int sw3_val_tbl[] = { 1350000, 1800000, 1850000, 1875000, };

static const unsigned int sw5_val_tbl[] = { 0, 5050000, };

static const unsigned int vcam_val_tbl[] = { 2600000, 2700000, 2800000,

					     2900000, };
@@ -402,6 +427,82 @@ static const struct cpcap_regulator omap4_regulators[] = { 
	{ /* sentinel */ },

};



static const struct cpcap_regulator mot_regulators[] = {

	CPCAP_REG(SW1, CPCAP_REG_S1C1, CPCAP_REG_ASSIGN2,

		  CPCAP_BIT_SW1_SEL, sw_mot_val_tbl,

		  0x6f00, 0x7f, 0x6800, 0, 0),

	CPCAP_REG(SW2, CPCAP_REG_S2C1, CPCAP_REG_ASSIGN2,

		  CPCAP_BIT_SW2_SEL, sw_mot_val_tbl,

		  0x6f00, 0x7f, 0x4804, 0, 0),

	CPCAP_REG(SW3, CPCAP_REG_S3C, CPCAP_REG_ASSIGN2,

		  CPCAP_BIT_SW3_SEL, sw3_val_tbl,

		  0x578, 0x3, 0x043c, 0, 0),

	CPCAP_REG(SW4, CPCAP_REG_S4C1, CPCAP_REG_ASSIGN2,

		  CPCAP_BIT_SW4_SEL, sw_mot_val_tbl,

		  0x6f00, 0x7f, 0x4909, 0, 0),

	CPCAP_REG(SW5, CPCAP_REG_S5C, CPCAP_REG_ASSIGN2,

		  CPCAP_BIT_SW5_SEL, sw5_val_tbl,

		  0x28, 0, 0x20, 0, 0),

	CPCAP_REG(SW6, CPCAP_REG_S6C, CPCAP_REG_ASSIGN2,

		  CPCAP_BIT_SW6_SEL, unknown_val_tbl,

		  0, 0, 0, 0, 0),

	CPCAP_REG(VCAM, CPCAP_REG_VCAMC, CPCAP_REG_ASSIGN2,

		  CPCAP_BIT_VCAM_SEL, vcam_val_tbl,

		  0x87, 0x30, 0x7, 0, 420),

	CPCAP_REG(VCSI, CPCAP_REG_VCSIC, CPCAP_REG_ASSIGN3,

		  CPCAP_BIT_VCSI_SEL, vcsi_val_tbl,

		  0x47, 0x10, 0x7, 0, 350),

	CPCAP_REG(VDAC, CPCAP_REG_VDACC, CPCAP_REG_ASSIGN3,

		  CPCAP_BIT_VDAC_SEL, vdac_val_tbl,

		  0x87, 0x30, 0x0, 0, 420),

	CPCAP_REG(VDIG, CPCAP_REG_VDIGC, CPCAP_REG_ASSIGN2,

		  CPCAP_BIT_VDIG_SEL, vdig_val_tbl,

		  0x87, 0x30, 0x0, 0, 420),

	CPCAP_REG(VFUSE, CPCAP_REG_VFUSEC, CPCAP_REG_ASSIGN3,

		  CPCAP_BIT_VFUSE_SEL, vfuse_val_tbl,

		  0xa0, 0xf, 0x0, 0, 420),

	CPCAP_REG(VHVIO, CPCAP_REG_VHVIOC, CPCAP_REG_ASSIGN3,

		  CPCAP_BIT_VHVIO_SEL, vhvio_val_tbl,

		  0x17, 0, 0x2, 0, 0),

	CPCAP_REG(VSDIO, CPCAP_REG_VSDIOC, CPCAP_REG_ASSIGN2,

		  CPCAP_BIT_VSDIO_SEL, vsdio_val_tbl,

		  0x87, 0x38, 0x2, 0, 420),

	CPCAP_REG(VPLL, CPCAP_REG_VPLLC, CPCAP_REG_ASSIGN3,

		  CPCAP_BIT_VPLL_SEL, vpll_val_tbl,

		  0x47, 0x18, 0x1, 0, 420),

	CPCAP_REG(VRF1, CPCAP_REG_VRF1C, CPCAP_REG_ASSIGN3,

		  CPCAP_BIT_VRF1_SEL, vrf1_val_tbl,

		  0xac, 0x2, 0, 0, 10),

	CPCAP_REG(VRF2, CPCAP_REG_VRF2C, CPCAP_REG_ASSIGN3,

		  CPCAP_BIT_VRF2_SEL, vrf2_val_tbl,

		  0x23, 0x8, 0, 0, 10),

	CPCAP_REG(VRFREF, CPCAP_REG_VRFREFC, CPCAP_REG_ASSIGN3,

		  CPCAP_BIT_VRFREF_SEL, vrfref_val_tbl,

		  0x23, 0x8, 0, 0, 420),

	CPCAP_REG(VWLAN1, CPCAP_REG_VWLAN1C, CPCAP_REG_ASSIGN3,

		  CPCAP_BIT_VWLAN1_SEL, vwlan1_val_tbl,

		  0x47, 0x10, 0x5, 0, 420),

	CPCAP_REG(VWLAN2, CPCAP_REG_VWLAN2C, CPCAP_REG_ASSIGN3,

		  CPCAP_BIT_VWLAN2_SEL, vwlan2_val_tbl,

		  0x20c, 0xc0, 0xd, 0, 420),

	CPCAP_REG(VSIM, CPCAP_REG_VSIMC, CPCAP_REG_ASSIGN3,

		  0xffff, vsim_val_tbl,

		  0x23, 0x8, 0, 0, 420),

	CPCAP_REG(VSIMCARD, CPCAP_REG_VSIMC, CPCAP_REG_ASSIGN3,

		  0xffff, vsimcard_val_tbl,

		  0x1e80, 0x8, 0x1e00, 0, 420),

	CPCAP_REG(VVIB, CPCAP_REG_VVIBC, CPCAP_REG_ASSIGN3,

		  CPCAP_BIT_VVIB_SEL, vvib_val_tbl,

		  0x1, 0xc, 0x1, 0, 500),

	CPCAP_REG(VUSB, CPCAP_REG_VUSBC, CPCAP_REG_ASSIGN3,

		  CPCAP_BIT_VUSB_SEL, vusb_val_tbl,

		  0x11c, 0x40, 0xc, 0, 0),

	CPCAP_REG(VAUDIO, CPCAP_REG_VAUDIOC, CPCAP_REG_ASSIGN4,

		  CPCAP_BIT_VAUDIO_SEL, vaudio_val_tbl,

		  0x16, 0x1, 0x5, 0, 0),

	{ /* sentinel */ }

};



static const struct cpcap_regulator xoom_regulators[] = {

	CPCAP_REG(SW1, CPCAP_REG_S1C1, CPCAP_REG_ASSIGN2,

		  CPCAP_BIT_SW1_SEL, unknown_val_tbl,
@@ -486,6 +587,10 @@ static const struct of_device_id cpcap_regulator_id_table[] = { 
		.compatible = "motorola,mapphone-cpcap-regulator",

		.data = omap4_regulators,

	},

	{

		.compatible = "motorola,mot-cpcap-regulator",

		.data = mot_regulators,

	},

	{

		.compatible = "motorola,xoom-cpcap-regulator",

		.data = xoom_regulators,