Loading Documentation/devicetree/bindings/mfd/as3722.txt 0 → 100644 +194 −0 Original line number Diff line number Diff line * ams AS3722 Power management IC. Required properties: ------------------- - compatible: Must be "ams,as3722". - reg: I2C device address. - interrupt-controller: AS3722 has internal interrupt controller which takes the interrupt request from internal sub-blocks like RTC, regulators, GPIOs as well as external input. - #interrupt-cells: Should be set to 2 for IRQ number and flags. The first cell is the IRQ number. IRQ numbers for different interrupt source of AS3722 are defined at dt-bindings/mfd/as3722.h The second cell is the flags, encoded as the trigger masks from binding document interrupts.txt, using dt-bindings/irq. Optional submodule and their properties: ======================================= Pinmux and GPIO: =============== Device has 8 GPIO pins which can be configured as GPIO as well as the special IO functions. Please refer to pinctrl-bindings.txt in this directory for details of the common pinctrl bindings used by client devices, including the meaning of the phrase "pin configuration node". Following are properties which is needed if GPIO and pinmux functionality is required: Required properties: ------------------- - gpio-controller: Marks the device node as a GPIO controller. - #gpio-cells: Number of GPIO cells. Refer to binding document gpio/gpio.txt Optional properties: -------------------- Following properties are require if pin control setting is required at boot. - pinctrl-names: A pinctrl state named "default" be defined, using the bindings in pinctrl/pinctrl-binding.txt. - pinctrl[0...n]: Properties to contain the phandle that refer to different nodes of pin control settings. These nodes represents the pin control setting of state 0 to state n. Each of these nodes contains different subnodes to represents some desired configuration for a list of pins. This configuration can include the mux function to select on those pin(s), and various pin configuration parameters, such as pull-up, open drain. Each subnode have following properties: Required properties: - pins: List of pins. Valid values of pins properties are: gpio0, gpio1, gpio2, gpio3, gpio4, gpio5, gpio6, gpio7 Optional properties: function, bias-disable, bias-pull-up, bias-pull-down, bias-high-impedance, drive-open-drain. Valid values for function properties are: gpio, interrupt-out, gpio-in-interrupt, vsup-vbat-low-undebounce-out, vsup-vbat-low-debounce-out, voltage-in-standby, oc-pg-sd0, oc-pg-sd6, powergood-out, pwm-in, pwm-out, clk32k-out, watchdog-in, soft-reset-in Regulators: =========== Device has multiple DCDC and LDOs. The node "regulators" is require if regulator functionality is needed. Following are properties of regulator subnode. Optional properties: ------------------- The input supply of regulators are the optional properties on the regulator node. The input supply of these regulators are provided through following properties: vsup-sd2-supply: Input supply for SD2. vsup-sd3-supply: Input supply for SD3. vsup-sd4-supply: Input supply for SD4. vsup-sd5-supply: Input supply for SD5. vin-ldo0-supply: Input supply for LDO0. vin-ldo1-6-supply: Input supply for LDO1 and LDO6. vin-ldo2-5-7-supply: Input supply for LDO2, LDO5 and LDO7. vin-ldo3-4-supply: Input supply for LDO3 and LDO4. vin-ldo9-10-supply: Input supply for LDO9 and LDO10. vin-ldo11-supply: Input supply for LDO11. Optional sub nodes for regulators: --------------------------------- The subnodes name is the name of regulator and it must be one of: sd[0-6], ldo[0-7], ldo[9-11] Each sub-node should contain the constraints and initialization information for that regulator. See regulator.txt for a description of standard properties for these sub-nodes. Additional optional custom properties are listed below. ams,ext-control: External control of the rail. The option of this properties will tell which external input is controlling this rail. Valid values are 0, 1, 2 ad 3. 0: There is no external control of this rail. 1: Rail is controlled by ENABLE1 input pin. 2: Rail is controlled by ENABLE2 input pin. 3: Rail is controlled by ENABLE3 input pin. Missing this property on DT will be assume as no external control. The external control pin macros are defined @dt-bindings/mfd/as3722.h ams,enable-tracking: Enable tracking with SD1, only supported by LDO3. Example: -------- #include <dt-bindings/mfd/as3722.h> ... ams3722 { compatible = "ams,as3722"; reg = <0x48>; interrupt-parent = <&intc>; interrupt-controller; #interrupt-cells = <2>; gpio-controller; #gpio-cells = <2>; pinctrl-names = "default"; pinctrl-0 = <&as3722_default>; as3722_default: pinmux { gpio0 { pins = "gpio0"; function = "gpio"; bias-pull-down; }; gpio1_2_4_7 { pins = "gpio1", "gpio2", "gpio4", "gpio7"; function = "gpio"; bias-pull-up; }; gpio5 { pins = "gpio5"; function = "clk32k_out"; }; } regulators { vsup-sd2-supply = <...>; ... sd0 { regulator-name = "vdd_cpu"; regulator-min-microvolt = <700000>; regulator-max-microvolt = <1400000>; regulator-always-on; ams,ext-control = <2>; }; sd1 { regulator-name = "vdd_core"; regulator-min-microvolt = <700000>; regulator-max-microvolt = <1400000>; regulator-always-on; ams,ext-control = <1>; }; sd2 { regulator-name = "vddio_ddr"; regulator-min-microvolt = <1350000>; regulator-max-microvolt = <1350000>; regulator-always-on; }; sd4 { regulator-name = "avdd-hdmi-pex"; regulator-min-microvolt = <1050000>; regulator-max-microvolt = <1050000>; regulator-always-on; }; sd5 { regulator-name = "vdd-1v8"; regulator-min-microvolt = <1800000>; regulator-max-microvolt = <1800000>; regulator-always-on; }; .... }; }; drivers/mfd/88pm860x-core.c +1 −1 Original line number Diff line number Diff line Loading @@ -1247,7 +1247,7 @@ static struct i2c_driver pm860x_driver = { .name = "88PM860x", .owner = THIS_MODULE, .pm = &pm860x_pm_ops, .of_match_table = of_match_ptr(pm860x_dt_ids), .of_match_table = pm860x_dt_ids, }, .probe = pm860x_probe, .remove = pm860x_remove, Loading drivers/mfd/Kconfig +22 −0 Original line number Diff line number Diff line Loading @@ -27,6 +27,18 @@ config MFD_AS3711 help Support for the AS3711 PMIC from AMS config MFD_AS3722 bool "ams AS3722 Power Management IC" select MFD_CORE select REGMAP_I2C select REGMAP_IRQ depends on I2C && OF help The ams AS3722 is a compact system PMU suitable for mobile phones, tablets etc. It has 4 DC/DC step-down regulators, 3 DC/DC step-down controllers, 11 LDOs, RTC, automatic battery, temperature and over current monitoring, GPIOs, ADC and a watchdog. config PMIC_ADP5520 bool "Analog Devices ADP5520/01 MFD PMIC Core Support" depends on I2C=y Loading Loading @@ -1151,6 +1163,16 @@ config MFD_WM8994 core support for the WM8994, in order to use the actual functionaltiy of the device other drivers must be enabled. config MFD_STW481X bool "Support for ST Microelectronics STw481x" depends on I2C && ARCH_NOMADIK select REGMAP_I2C select MFD_CORE help Select this option to enable the STw481x chip driver used in various ST Microelectronics and ST-Ericsson embedded Nomadik series. endmenu endif Loading drivers/mfd/Makefile +2 −0 Original line number Diff line number Diff line Loading @@ -162,3 +162,5 @@ obj-$(CONFIG_MFD_LM3533) += lm3533-core.o lm3533-ctrlbank.o obj-$(CONFIG_VEXPRESS_CONFIG) += vexpress-config.o vexpress-sysreg.o obj-$(CONFIG_MFD_RETU) += retu-mfd.o obj-$(CONFIG_MFD_AS3711) += as3711.o obj-$(CONFIG_MFD_AS3722) += as3722.o obj-$(CONFIG_MFD_STW481X) += stw481x.o drivers/mfd/aat2870-core.c +1 −1 Original line number Diff line number Diff line Loading @@ -293,7 +293,7 @@ static ssize_t aat2870_reg_write_file(struct file *file, unsigned long addr, val; int ret; buf_size = min(count, (sizeof(buf)-1)); buf_size = min(count, (size_t)(sizeof(buf)-1)); if (copy_from_user(buf, user_buf, buf_size)) { dev_err(aat2870->dev, "Failed to copy from user\n"); return -EFAULT; Loading Loading
Documentation/devicetree/bindings/mfd/as3722.txt 0 → 100644 +194 −0 Original line number Diff line number Diff line * ams AS3722 Power management IC. Required properties: ------------------- - compatible: Must be "ams,as3722". - reg: I2C device address. - interrupt-controller: AS3722 has internal interrupt controller which takes the interrupt request from internal sub-blocks like RTC, regulators, GPIOs as well as external input. - #interrupt-cells: Should be set to 2 for IRQ number and flags. The first cell is the IRQ number. IRQ numbers for different interrupt source of AS3722 are defined at dt-bindings/mfd/as3722.h The second cell is the flags, encoded as the trigger masks from binding document interrupts.txt, using dt-bindings/irq. Optional submodule and their properties: ======================================= Pinmux and GPIO: =============== Device has 8 GPIO pins which can be configured as GPIO as well as the special IO functions. Please refer to pinctrl-bindings.txt in this directory for details of the common pinctrl bindings used by client devices, including the meaning of the phrase "pin configuration node". Following are properties which is needed if GPIO and pinmux functionality is required: Required properties: ------------------- - gpio-controller: Marks the device node as a GPIO controller. - #gpio-cells: Number of GPIO cells. Refer to binding document gpio/gpio.txt Optional properties: -------------------- Following properties are require if pin control setting is required at boot. - pinctrl-names: A pinctrl state named "default" be defined, using the bindings in pinctrl/pinctrl-binding.txt. - pinctrl[0...n]: Properties to contain the phandle that refer to different nodes of pin control settings. These nodes represents the pin control setting of state 0 to state n. Each of these nodes contains different subnodes to represents some desired configuration for a list of pins. This configuration can include the mux function to select on those pin(s), and various pin configuration parameters, such as pull-up, open drain. Each subnode have following properties: Required properties: - pins: List of pins. Valid values of pins properties are: gpio0, gpio1, gpio2, gpio3, gpio4, gpio5, gpio6, gpio7 Optional properties: function, bias-disable, bias-pull-up, bias-pull-down, bias-high-impedance, drive-open-drain. Valid values for function properties are: gpio, interrupt-out, gpio-in-interrupt, vsup-vbat-low-undebounce-out, vsup-vbat-low-debounce-out, voltage-in-standby, oc-pg-sd0, oc-pg-sd6, powergood-out, pwm-in, pwm-out, clk32k-out, watchdog-in, soft-reset-in Regulators: =========== Device has multiple DCDC and LDOs. The node "regulators" is require if regulator functionality is needed. Following are properties of regulator subnode. Optional properties: ------------------- The input supply of regulators are the optional properties on the regulator node. The input supply of these regulators are provided through following properties: vsup-sd2-supply: Input supply for SD2. vsup-sd3-supply: Input supply for SD3. vsup-sd4-supply: Input supply for SD4. vsup-sd5-supply: Input supply for SD5. vin-ldo0-supply: Input supply for LDO0. vin-ldo1-6-supply: Input supply for LDO1 and LDO6. vin-ldo2-5-7-supply: Input supply for LDO2, LDO5 and LDO7. vin-ldo3-4-supply: Input supply for LDO3 and LDO4. vin-ldo9-10-supply: Input supply for LDO9 and LDO10. vin-ldo11-supply: Input supply for LDO11. Optional sub nodes for regulators: --------------------------------- The subnodes name is the name of regulator and it must be one of: sd[0-6], ldo[0-7], ldo[9-11] Each sub-node should contain the constraints and initialization information for that regulator. See regulator.txt for a description of standard properties for these sub-nodes. Additional optional custom properties are listed below. ams,ext-control: External control of the rail. The option of this properties will tell which external input is controlling this rail. Valid values are 0, 1, 2 ad 3. 0: There is no external control of this rail. 1: Rail is controlled by ENABLE1 input pin. 2: Rail is controlled by ENABLE2 input pin. 3: Rail is controlled by ENABLE3 input pin. Missing this property on DT will be assume as no external control. The external control pin macros are defined @dt-bindings/mfd/as3722.h ams,enable-tracking: Enable tracking with SD1, only supported by LDO3. Example: -------- #include <dt-bindings/mfd/as3722.h> ... ams3722 { compatible = "ams,as3722"; reg = <0x48>; interrupt-parent = <&intc>; interrupt-controller; #interrupt-cells = <2>; gpio-controller; #gpio-cells = <2>; pinctrl-names = "default"; pinctrl-0 = <&as3722_default>; as3722_default: pinmux { gpio0 { pins = "gpio0"; function = "gpio"; bias-pull-down; }; gpio1_2_4_7 { pins = "gpio1", "gpio2", "gpio4", "gpio7"; function = "gpio"; bias-pull-up; }; gpio5 { pins = "gpio5"; function = "clk32k_out"; }; } regulators { vsup-sd2-supply = <...>; ... sd0 { regulator-name = "vdd_cpu"; regulator-min-microvolt = <700000>; regulator-max-microvolt = <1400000>; regulator-always-on; ams,ext-control = <2>; }; sd1 { regulator-name = "vdd_core"; regulator-min-microvolt = <700000>; regulator-max-microvolt = <1400000>; regulator-always-on; ams,ext-control = <1>; }; sd2 { regulator-name = "vddio_ddr"; regulator-min-microvolt = <1350000>; regulator-max-microvolt = <1350000>; regulator-always-on; }; sd4 { regulator-name = "avdd-hdmi-pex"; regulator-min-microvolt = <1050000>; regulator-max-microvolt = <1050000>; regulator-always-on; }; sd5 { regulator-name = "vdd-1v8"; regulator-min-microvolt = <1800000>; regulator-max-microvolt = <1800000>; regulator-always-on; }; .... }; };
drivers/mfd/88pm860x-core.c +1 −1 Original line number Diff line number Diff line Loading @@ -1247,7 +1247,7 @@ static struct i2c_driver pm860x_driver = { .name = "88PM860x", .owner = THIS_MODULE, .pm = &pm860x_pm_ops, .of_match_table = of_match_ptr(pm860x_dt_ids), .of_match_table = pm860x_dt_ids, }, .probe = pm860x_probe, .remove = pm860x_remove, Loading
drivers/mfd/Kconfig +22 −0 Original line number Diff line number Diff line Loading @@ -27,6 +27,18 @@ config MFD_AS3711 help Support for the AS3711 PMIC from AMS config MFD_AS3722 bool "ams AS3722 Power Management IC" select MFD_CORE select REGMAP_I2C select REGMAP_IRQ depends on I2C && OF help The ams AS3722 is a compact system PMU suitable for mobile phones, tablets etc. It has 4 DC/DC step-down regulators, 3 DC/DC step-down controllers, 11 LDOs, RTC, automatic battery, temperature and over current monitoring, GPIOs, ADC and a watchdog. config PMIC_ADP5520 bool "Analog Devices ADP5520/01 MFD PMIC Core Support" depends on I2C=y Loading Loading @@ -1151,6 +1163,16 @@ config MFD_WM8994 core support for the WM8994, in order to use the actual functionaltiy of the device other drivers must be enabled. config MFD_STW481X bool "Support for ST Microelectronics STw481x" depends on I2C && ARCH_NOMADIK select REGMAP_I2C select MFD_CORE help Select this option to enable the STw481x chip driver used in various ST Microelectronics and ST-Ericsson embedded Nomadik series. endmenu endif Loading
drivers/mfd/Makefile +2 −0 Original line number Diff line number Diff line Loading @@ -162,3 +162,5 @@ obj-$(CONFIG_MFD_LM3533) += lm3533-core.o lm3533-ctrlbank.o obj-$(CONFIG_VEXPRESS_CONFIG) += vexpress-config.o vexpress-sysreg.o obj-$(CONFIG_MFD_RETU) += retu-mfd.o obj-$(CONFIG_MFD_AS3711) += as3711.o obj-$(CONFIG_MFD_AS3722) += as3722.o obj-$(CONFIG_MFD_STW481X) += stw481x.o
drivers/mfd/aat2870-core.c +1 −1 Original line number Diff line number Diff line Loading @@ -293,7 +293,7 @@ static ssize_t aat2870_reg_write_file(struct file *file, unsigned long addr, val; int ret; buf_size = min(count, (sizeof(buf)-1)); buf_size = min(count, (size_t)(sizeof(buf)-1)); if (copy_from_user(buf, user_buf, buf_size)) { dev_err(aat2870->dev, "Failed to copy from user\n"); return -EFAULT; Loading