Fix issues on pf8x00 driver
Subsystems (3)
v5 cover Fix issues on pf8x00 driver
Hello,
this patch set aims is to fix some issues contains in the pf8x00 driver. Some issues are documentation ones, some others are in code.
These issues where found while developing another version of the same driver. I prefer to share with you the patch for it.
I do these patches on the master branch of the linux-next repository.
1: there is a missing documentation when we build the driver as a module.
2: nxp,phase-shift documentation was not optimal.
3: nxp,ilim-ma is useless since another property does (nearly) the same.
4: Same than 4, in driver code.
5: It's better to use a linear_range to describe the voltage of bucks.
6: Fix several mistakes in the handle of nxp,phase-shift property.
Changes introduced in v2:
Some patches were mixed (and did not compile separately); Add path 7 for the handle of nxp,phase-shift property.
Changes introduced in v3:
Remove useless patch 0;
Do requested fixes in patches.
Changes introduced in v4:
Mark nxp,ilim-ma as deprecated since it was already present in a kernel version.
Changes introduced in v5
Use deprecated: true flag in nxp,ilim-ma description
Thanks,
Adrien Grassein (6):
regulator: pf8x00: add a doc for the module
regulator: dt-bindings: pf8x00: fix nxp,phase-shift doc
regulator: dt-bindings: pf8x00: mark nxp,ilim-ma property as
deprecated
regulator: pf8x00: mark nxp,ilim-ma property as deprecated
regulator: pf8x00: use linear range for buck 1-6
regulator: pf8x00: fix nxp,phase-shift
.../regulator/nxp,pf8x00-regulator.yaml | 17 +- drivers/regulator/Kconfig | 4 + drivers/regulator/pf8x00-regulator.c | 203 +++++++++++------- 3 files changed, 136 insertions(+), 88 deletions(-)
Signature · 1 line
2.25.1
PATCH v5 1/6 regulator: pf8x00: add a doc for the module
pf8x00 module build was not documented.
--- drivers/regulator/Kconfig | 4 ++++ 1 file changed, 4 insertions(+)
drivers/regulator/Kconfig +4 -0
@@ -846,6 +846,10 @@ config REGULATOR_PF8X00 Say y here to support the regulators found on the NXP PF8100/PF8121A/PF8200 PMIC. + Say M here if you want to support for the regulators found + on the NXP PF8100/PF8121A/PF8200 PMIC. The module will be named + "pf8x00-regulator". + config REGULATOR_PFUZE100 tristate "Freescale PFUZE100/200/3000/3001 regulator driver" depends on I2C && OF
Signature · 1 line
2.25.1
PATCH v5 2/6 regulator: dt-bindings: pf8x00: fix nxp,phase-shift doc
In reply to Adrien Grasseinnxp,phase-shift is an enum so use enum format to describe it. Minimum and maximum values are also wrong.
--- .../bindings/regulator/nxp,pf8x00-regulator.yaml | 14 ++------------ 1 file changed, 2 insertions(+), 12 deletions(-)
Documentation/devicetree/bindings/regulator/nxp,pf8x00-regulator.yaml +2 -12
@@ -73,21 +73,11 @@ properties: nxp,phase-shift: $ref: "/schemas/types.yaml#/definitions/uint32" - minimum: 45 - maximum: 0 + default: 0 + enum: [ 0, 45, 90, 135, 180, 225, 270, 315 ] description: BUCK regulators phase shift control in degrees. - Listed phase shift control values in degrees are, - 45 - 90 - 135 - 180 - 225 - 270 - 315 - 0 (default) - unevaluatedProperties: false "^vsnvs$":
Signature · 1 line
2.25.1
PATCH v5 3/6 regulator: dt-bindings: pf8x00: mark nxp,ilim-ma property as deprecated
In reply to Adrien GrasseinThis property seems useless because we can use the regulator-max-microamp generic property to do the same and using generic code.
As this property was already released in a kernel version, we can't remove it, just mark it as deprecated
--- .../devicetree/bindings/regulator/nxp,pf8x00-regulator.yaml | 3 +++ 1 file changed, 3 insertions(+)
Documentation/devicetree/bindings/regulator/nxp,pf8x00-regulator.yaml +3 -0
@@ -62,8 +62,11 @@ properties: $ref: "/schemas/types.yaml#/definitions/uint32" minimum: 2100 maximum: 4500 + deprecated: true description: BUCK regulators current limit in mA. + This property is deprecated, please use + "regulator-max-microamp" instead. Listed current limits in mA are, 2100 (default)
Signature · 1 line
2.25.1
PATCH v5 4/6 regulator: pf8x00: mark nxp,ilim-ma property as deprecated
In reply to Adrien GrasseinThis property seems useless because we can use the regulator-max-microamp generic property to do the same and using generic code.
As this property was already released in a kernel version, we can't remove it, just mark it as deprecated.
--- drivers/regulator/pf8x00-regulator.c | 55 +++++++++++++++++++++------- 1 file changed, 41 insertions(+), 14 deletions(-)
drivers/regulator/pf8x00-regulator.c +41 -14
@@ -128,7 +128,6 @@ enum pf8x00_devid {struct pf8x00_regulator {struct regulator_desc desc; -u8 ilim;u8 phase_shift; };
@@ -150,6 +149,11 @@ static const int pf8x00_ldo_voltages[] = { 3100000, 3150000, 3200000, 3300000, 3350000, 1650000, 1700000, 5000000, }; +/* Output: 2.1A to 4.5A */ +static const unsigned int pf8x00_sw_current_table[] = { +2100000 ,2600000 ,3000000 ,4500000 , +}; +#define SWV (i) (6250 * i + 400000)#define SWV_LINE (i) SWV(i*8+0), SWV(i*8+1), SWV(i*8+2), SWV(i*8+3), \ SWV(i*8+4), SWV(i*8+5), SWV(i*8+6), SWV(i*8+7)
@@ -199,10 +203,10 @@ static struct pf8x00_regulator *desc_to_regulator(const struct regulator_desc *d return container_of(desc, struct pf8x00_regulator, desc); } -static void swxilim_select (const struct regulator_desc *desc,int ilim) +static void swxilim_select (struct pf8x00_chip *chip,int id,int ilim) { -struct pf8x00_regulator *data =desc_to_regulator (desc);u8 ilim_sel; +u8 reg =PF8X00_SW_BASE (id) +SW_CONFIG2 ;switch (ilim) {case 2100 :
@@ -222,7 +226,32 @@ static void swxilim_select(const struct regulator_desc *desc, int ilim)break ; } - data->ilim = ilim_sel; +regmap_update_bits (chip->regmap, reg, +PF8X00_SWXILIM_MASK , + ilim_sel <<PF8X00_SWXILIM_SHIFT ); +} + +static void handle_ilim_property (struct device_node *np, +const struct regulator_desc *desc, +struct regulator_config *config) +{ +struct pf8x00_chip *chip = config->driver_data; +int ret; +int val; + +if ((desc->id >=PF8X00_BUCK1 ) && (desc->id <=PF8X00_BUCK7 )) { + ret =of_property_read_u32 (np,"nxp,ilim-ma" , &val); +if (ret) { +dev_dbg (chip->dev,"unspecified ilim for BUCK%d, use value stored in OTP\n" , + desc->id -PF8X00_LDO4 ); +return ; + } + +dev_warn (chip->dev,"nxp,ilim-ma is deprecated, please use regulator-max-microamp\n" ); +swxilim_select (chip, desc->id, val); + + }else +dev_warn (chip->dev,"nxp,ilim-ma used with incorrect regulator (%d)\n" , desc->id); } static int pf8x00_of_parse_cb(struct device_node *np,
@@ -235,12 +264,7 @@ static int pf8x00_of_parse_cb(struct device_node *np,int val;int ret; - ret =of_property_read_u32 (np,"nxp,ilim-ma" , &val); -if (ret) -dev_dbg (chip->dev,"unspecified ilim for BUCK%d, use 2100 mA\n" , - desc->id -PF8X00_LDO4 ); - -swxilim_select (desc, val); +handle_ilim_property (np, desc, config); ret =of_property_read_u32 (np,"nxp,phase-shift" , &val);if (ret) {
@@ -279,6 +303,8 @@ static const struct regulator_ops pf8x00_buck_ops = { .list_voltage = regulator_list_voltage_table, .set_voltage_sel = regulator_set_voltage_sel_regmap, .get_voltage_sel = regulator_get_voltage_sel_regmap, + .get_current_limit = regulator_get_current_limit_regmap, + .set_current_limit = regulator_set_current_limit_regmap, };static const struct regulator_ops pf8x00_vsnvs_ops = {
@@ -327,6 +353,11 @@ static const struct regulator_ops pf8x00_vsnvs_ops = { .volt_table = voltages, \ .vsel_reg = (base) + SW_RUN_VOLT, \ .vsel_mask = 0xff, \ + .curr_table = pf8x00_sw_current_table, \ + .n_current_limits = \ + ARRAY_SIZE(pf8x00_sw_current_table), \ + .csel_reg = (base) + SW_CONFIG2, \ + .csel_mask = PF8X00_SWXILIM_MASK, \ .enable_reg = (base) + SW_MODE1, \ .enable_val = 0x3, \ .disable_val = 0x0, \
@@ -458,10 +489,6 @@ static int pf8x00_i2c_probe(struct i2c_client *client)regmap_update_bits (chip->regmap, reg,PF8X00_SWXPHASE_MASK , data->phase_shift); - -regmap_update_bits (chip->regmap, reg, -PF8X00_SWXILIM_MASK , - data->ilim <<PF8X00_SWXILIM_SHIFT ); } }
Signature · 1 line
2.25.1
PATCH v5 5/6 regulator: pf8x00: use linear range for buck 1-6
In reply to Adrien GrasseinUse a linear range to describe the voltages of the bucks 1-6 instead of listing it one by one (via a macro)
--- drivers/regulator/pf8x00-regulator.c | 83 +++++++++++++++++----------- 1 file changed, 51 insertions(+), 32 deletions(-)
drivers/regulator/pf8x00-regulator.c +51 -32
@@ -154,35 +154,11 @@ static const unsigned int pf8x00_sw_current_table[] = { 2100000, 2600000, 3000000, 4500000, }; -#define SWV (i) (6250 * i + 400000) -#define SWV_LINE (i) SWV(i*8+0), SWV(i*8+1), SWV(i*8+2), SWV(i*8+3), \ - SWV(i*8+4), SWV(i*8+5), SWV(i*8+6), SWV(i*8+7) -/* Output: 0.4V to 1.8V */ -static const int pf8x00_sw1_to_6_voltages[] = { -SWV_LINE (0 ), -SWV_LINE (1 ), -SWV_LINE (2 ), -SWV_LINE (3 ), -SWV_LINE (4 ), -SWV_LINE (5 ), -SWV_LINE (6 ), -SWV_LINE (7 ), -SWV_LINE (8 ), -SWV_LINE (9 ), -SWV_LINE (10 ), -SWV_LINE (11 ), -SWV_LINE (12 ), -SWV_LINE (13 ), -SWV_LINE (14 ), -SWV_LINE (15 ), -SWV_LINE (16 ), -SWV_LINE (17 ), -SWV_LINE (18 ), -SWV_LINE (19 ), -SWV_LINE (20 ), -SWV_LINE (21 ), -1500000 ,1800000 , +#define PF8XOO_SW1_6_VOLTAGE_NUM 0xB2 +static const struct linear_range pf8x00_sw1_to_6_voltages[] = { +REGULATOR_LINEAR_RANGE (400000 ,0x00 ,0xB0 ,6250 ), +REGULATOR_LINEAR_RANGE (1800000 ,0xB1 ,0xB1 ,0 ), };/* Output: 1.0V to 4.1V */
@@ -296,7 +272,19 @@ static const struct regulator_ops pf8x00_ldo_ops = { .get_voltage_sel = regulator_get_voltage_sel_regmap, }; -static const struct regulator_ops pf8x00_buck_ops = { + +static const struct regulator_ops pf8x00_buck1_6_ops = { + .enable = regulator_enable_regmap, + .disable = regulator_disable_regmap, + .is_enabled = regulator_is_enabled_regmap, + .list_voltage = regulator_list_voltage_linear_range, + .set_voltage_sel = regulator_set_voltage_sel_regmap, + .get_voltage_sel = regulator_get_voltage_sel_regmap, + .get_current_limit = regulator_get_current_limit_regmap, + .set_current_limit = regulator_set_current_limit_regmap, +}; + +static const struct regulator_ops pf8x00_buck7_ops = { .enable = regulator_enable_regmap, .disable = regulator_disable_regmap, .is_enabled = regulator_is_enabled_regmap,
@@ -345,11 +333,41 @@ static const struct regulator_ops pf8x00_vsnvs_ops = { .of_match = _name, \ .regulators_node = "regulators", \ .of_parse_cb = pf8x00_of_parse_cb, \ - .n_voltages = ARRAY_SIZE(voltages), \ - .ops = &pf8x00_buck_ops, \ + .n_voltages = PF8XOO_SW1_6_VOLTAGE_NUM, \ + .ops = &pf8x00_buck1_6_ops, \ .type = REGULATOR_VOLTAGE, \ .id = PF8X00_BUCK ## _id, \ .owner = THIS_MODULE, \ + .linear_ranges = pf8x00_sw1_to_6_voltages, \ + .n_linear_ranges = \ + ARRAY_SIZE(pf8x00_sw1_to_6_voltages), \ + .vsel_reg = (base) + SW_RUN_VOLT, \ + .vsel_mask = 0xff, \ + .curr_table = pf8x00_sw_current_table, \ + .n_current_limits = \ + ARRAY_SIZE(pf8x00_sw_current_table), \ + .csel_reg = (base) + SW_CONFIG2, \ + .csel_mask = PF8X00_SWXILIM_MASK, \ + .enable_reg = (base) + SW_MODE1, \ + .enable_val = 0x3, \ + .disable_val = 0x0, \ + .enable_mask = 0x3, \ + .enable_time = 500, \ + }, \ + } + +#define PF8X00BUCK7 (_name, base, voltages) \ + [PF8X00_BUCK7] = { \ + .desc = { \ + .name = _name, \ + .of_match = _name, \ + .regulators_node = "regulators", \ + .of_parse_cb = pf8x00_of_parse_cb, \ + .n_voltages = ARRAY_SIZE(voltages), \ + .ops = &pf8x00_buck7_ops, \ + .type = REGULATOR_VOLTAGE, \ + .id = PF8X00_BUCK7, \ + .owner = THIS_MODULE, \ .volt_table = voltages, \ .vsel_reg = (base) + SW_RUN_VOLT, \ .vsel_mask = 0xff, \
@@ -366,6 +384,7 @@ static const struct regulator_ops pf8x00_vsnvs_ops = { }, \ } +#define PF8X00VSNVS (_name, base, voltages) \ [PF8X00_VSNVS] = { \ .desc = { \
@@ -394,7 +413,7 @@ static struct pf8x00_regulator pf8x00_regulators_data[PF8X00_MAX_REGULATORS] = {PF8X00BUCK (4 ,"buck4" ,PF8X00_SW_BASE (PF8X00_BUCK4 ), pf8x00_sw1_to_6_voltages),PF8X00BUCK (5 ,"buck5" ,PF8X00_SW_BASE (PF8X00_BUCK5 ), pf8x00_sw1_to_6_voltages),PF8X00BUCK (6 ,"buck6" ,PF8X00_SW_BASE (PF8X00_BUCK6 ), pf8x00_sw1_to_6_voltages), -PF8X00BUCK (7 ,"buck7" ,PF8X00_SW_BASE (PF8X00_BUCK7 ), pf8x00_sw7_voltages), +PF8X00BUCK7 ("buck7" ,PF8X00_SW_BASE (PF8X00_BUCK7 ), pf8x00_sw7_voltages), PF8X00VSNVS("vsnvs", PF8X00_VSNVS_CONFIG1, pf8x00_vsnvs_voltages), };
Signature · 1 line
2.25.1
PATCH v5 6/6 regulator: pf8x00: fix nxp,phase-shift
In reply to Adrien GrasseinFix the ternary condition which is a bad coding style in the kernel
I also remove the defering configuration of the nxp,phase-shift. The configuration is now done at parsing time. It save some memory and it's better for comprehension.
I also use the OTP default configuration when the parameter is wrong or not specified.
I think that it's better to use the default configuration from the chip than an arbitrary value.
--- drivers/regulator/pf8x00-regulator.c | 71 +++++++++++++++------------- 1 file changed, 38 insertions(+), 33 deletions(-)
drivers/regulator/pf8x00-regulator.c +38 -33
@@ -114,7 +114,6 @@ enum swxilim_bits {#define PF8X00_SWXILIM_SHIFT 3#define PF8X00_SWXILIM_MASK GENMASK(4, 3)#define PF8X00_SWXPHASE_MASK GENMASK(2, 0) -#define PF8X00_SWXPHASE_DEFAULT 0#define PF8X00_SWXPHASE_SHIFT 7enum pf8x00_devid {
@@ -128,7 +127,6 @@ enum pf8x00_devid {struct pf8x00_regulator {struct regulator_desc desc; -u8 phase_shift; };struct pf8x00_chip {
@@ -174,11 +172,6 @@ static const int pf8x00_vsnvs_voltages[] = { 0, 1800000, 3000000, 3300000, }; -static struct pf8x00_regulator *desc_to_regulator (const struct regulator_desc *desc) -{ - return container_of(desc, struct pf8x00_regulator, desc); -} -static void swxilim_select (struct pf8x00_chip *chip,int id,int ilim) {u8 ilim_sel;
@@ -230,35 +223,55 @@ static void handle_ilim_property(struct device_node *np,dev_warn (chip->dev,"nxp,ilim-ma used with incorrect regulator (%d)\n" , desc->id); } -static int pf8x00_of_parse_cb (struct device_node *np, +static void handle_shift_property (struct device_node *np,const struct regulator_desc *desc,struct regulator_config *config) { -struct pf8x00_regulator *data =desc_to_regulator (desc); +unsigned char id = desc->id -PF8X00_LDO4 ; +unsigned char reg =PF8X00_SW_BASE (id) +SW_CONFIG2 ;struct pf8x00_chip *chip = config->driver_data; +int phase;int val;int ret; +if ((desc->id >=PF8X00_BUCK1 ) && (desc->id <=PF8X00_BUCK7 )) { + ret =of_property_read_u32 (np,"nxp,phase-shift" , &val); +if (ret) { +dev_dbg (chip->dev, +"unspecified phase-shift for BUCK%d, using OTP configuration\n" , + id); +return ; + } -handle_ilim_property (np, desc, config); +if (val <0 || val >315 || val %45 !=0 ) { +dev_warn (config->dev, +"invalid phase_shift %d for BUCK%d, using OTP configuration\n" , + val, id); +return ; + } - ret =of_property_read_u32 (np,"nxp,phase-shift" , &val); -if (ret) { -dev_dbg (chip->dev, -"unspecified phase-shift for BUCK%d, use 0 degrees\n" , - desc->id -PF8X00_LDO4 ); - val =PF8X00_SWXPHASE_DEFAULT ; - } + phase = val /45 ; - phase = val /45 ; -if ((phase *45 ) != val) { -dev_warn (config->dev, -"invalid phase_shift %d for BUCK%d, use 0 degrees\n" , - (phase *45 ), desc->id -PF8X00_LDO4 ); - phase =PF8X00_SWXPHASE_SHIFT ; - } +if (phase >=1 ) + phase -=1 ; +else + phase =PF8X00_SWXPHASE_SHIFT ; + +regmap_update_bits (chip->regmap, reg, +PF8X00_SWXPHASE_MASK , + phase); + }else +dev_warn (chip->dev,"nxp,phase-shift used with incorrect regulator (%d)\n" , id); + +} + +static int pf8x00_of_parse_cb (struct device_node *np, +const struct regulator_desc *desc, +struct regulator_config *config) +{ - data->phase_shift = (phase >=1 ) ? phase -1 :PF8X00_SWXPHASE_SHIFT ; +handle_ilim_property (np, desc, config); +handle_shift_property (np, desc, config);return 0 ; }
@@ -501,14 +514,6 @@ static int pf8x00_i2c_probe(struct i2c_client *client) "failed to register %s regulator\n", data->desc.name);return PTR_ERR (rdev); } - -if ((id >=PF8X00_BUCK1 ) && (id <=PF8X00_BUCK7 )) { -u8 reg =PF8X00_SW_BASE (id) +SW_CONFIG2 ; - -regmap_update_bits (chip->regmap, reg, -PF8X00_SWXPHASE_MASK , - data->phase_shift); - } }return 0 ;
Signature · 1 line
2.25.1
Mark Brown
maintainerQuoted 9 lines · Adrien Grassein
this patch set aims is to fix some issues contains in the pf8x00 driver. Some issues are documentation ones, some others are in code.
These issues where found while developing another version of the same driver. I prefer to share with you the patch for it.
I do these patches on the master branch of the linux-next repository.
[...]
Applied to
https://git.kernel.org/pub/scm/linux/kernel/git/broonie/regulator.git for-next
Thanks!
[1/6] regulator: pf8x00: add a doc for the module
commit: 4d23b84d1fcd1eadbc5c6cd93e76b02a8d191d66
[2/6] regulator: dt-bindings: pf8x00: fix nxp,phase-shift doc
commit: 988d0d42509a2c1fad0844a6e8f9c7bce7c930dd
[3/6] regulator: dt-bindings: pf8x00: mark nxp,ilim-ma property as deprecated
commit: 34b860aa0b6221b21eea6bac76357063f525b561
[4/6] regulator: pf8x00: mark nxp,ilim-ma property as deprecated
commit: 245f5f65229a6c6f5b04fa90221b44818a928916
[5/6] regulator: pf8x00: use linear range for buck 1-6
commit: 35a93349932e0e04c284f8a4954f3d1236c97d85
[6/6] regulator: pf8x00: fix nxp,phase-shift
commit: 475a5d85ff62f7ca73f51f23977e7e3ec8c9f906All being well this means that it will be integrated into the linux-next tree (usually sometime in the next 24 hours) and sent to Linus during the next merge window (or sooner if it is a bug fix), however if problems are discovered then the patch may be dropped or reverted.
You may get further e-mails resulting from automated or manual testing and review of the tree, please engage with people reporting problems and send followup patches addressing any issues that are reported if needed.
If any updates are required or you are submitting further changes they should be sent as incremental updates against current git, existing patches will not be replaced.
Please add any relevant lists and maintainers to the CCs when replying to this mail.
Thanks,
Mark