Re: [PATCH] regulator/max1586: support increased V3 voltage range

From: Robert Jarzmik
Date: Wed May 27 2009 - 11:13:21 EST


pHilipp Zabel <philipp.zabel@xxxxxxxxx> writes:

>>> -#define MAX1586_V3_MIN_UV Â 700000
>>> -#define MAX1586_V3_MAX_UV Â1475000
>>> -#define MAX1586_V3_STEP_UV Â 25000
>> These 3 should be kept I think, see below.
>
> The nice thing about the switch statement below was that I just had to
> take the nominal values from the datasheet and not think about the
> actual mechanism at all.
I know. But board with funky resistor values can come (or worst, a voltage
regulator providing reference voltage to pin FB3 : watch the "chicken and egg"
problem comming :))

>>> Â/*
>>> Â * V3 voltage
>>> Â * On I2C bus, sending a "x" byte to the max1586 means :
>>> - * Â set V3 to 0.700V + (x & 0x1f) * 0.025V
>>> + * Â set V3 to 0.700V + (x & 0x1f) * 0.025V,
>>> + * Â set V3 to 0.730V + (x & 0x1f) * 0.026V,
>>> + * Â set V3 to 0.750V + (x & 0x1f) * 0.027V or
>>> + * Â set V3 to 0.780V + (x & 0x1f) * 0.028V
>>> + * depending on the external resistance R24.
>> That's not really the full truth.
>
> Hm, right. My MAX1586A/MAX1586B/MAX1587A data sheet only has this
> information in (Figure 9. Adding R24 and R25 to Increase Core Voltage
> Programming Range):
>
> R24 = 3.32kOhm, V3: 0.73V TO 1.55V, 26mV/STEP
> R24 = 5.11kOhm, V3: 0.75V TO 1.60V, 27mV/STEP
> R24 = 7.5kkOhm, V3: 0.78V TO 1.65V, 28mV/STEP
>
> With R25 = 100kOhm. There's no mention of 185.5(kOhm?) anywhere.
That's an internal resistor of the MAX158x, connected from FB3 pin to ground.

>> The real V3 is (0.700V + (x & 0x1f) * 0.025V) * gain, where :
>> Â- if R24 is not connected, gain = 1
>> Â- if R24 and R25 are connected, gain = 1 + R24/R25 + R24/185.5
>
> Ok, so for example:
> R24 = 3.32kOhm --> gain = 1.051098 --> 735768uV ... 1550369uV
> But the nominal values from the datasheet for this R24 resistor are
> 730mV and 1550mV. Should we trust this calculation over the nominal
> values?
I'd rather trust the calculation, as it seems related to the electronics. From
what I see, R24 forms a voltage divisor with the resultant resistor formed by
R25 and 185.5 kOhms in parallel formation.

>
>> Â Here, it should be assumed that R25 >> 10k.ohm, which means that R24/R25
>> Â becomes meaningless compared to R24/185.5.
>> Therefore, the formula becomes:
>> gain = 1 + R24/185.5
>
> That is not true. For this formula to make sense, 185.5 has to be
> given in kÎ, so R24/R25 is actually the bigger contribution.
Ah, specification british touch. The formula was written with R24/185,500, and I
took the comma for ... the decimal separator, while it was 185.5 k.ohms as you
say. You're right.

And so, the formula has to take into accound R25 as well, and become :
gain = 1 + R24/185500 + R24/R25

>> For reference, R24 and R25 are described in Max1586 datasheet, in figure7
>> (extending the maximum core voltage range).
>>
>> I'd like that put in the comment please.
>
> Yes, it would be better to document this.

>>>
>>> Âstatic int max1586_v3_set(struct regulator_dev *rdev, int min_uV, int max_uV)
>>> Â{
>>> - Â Â struct i2c_client *client = rdev_get_drvdata(rdev);
>>> + Â Â struct max1586_data *max1586 = rdev_get_drvdata(rdev);
>>> + Â Â struct i2c_client *client = max1586->client;
>>> + Â Â unsigned range_uV = max1586->max_uV - max1586->min_uV;
>>> Â Â Â unsigned selector;
>>> Â Â Â u8 v3_prog;
>>>
>>> - Â Â if (min_uV < MAX1586_V3_MIN_UV || min_uV > MAX1586_V3_MAX_UV)
>>> - Â Â Â Â Â Â return -EINVAL;
>>> - Â Â if (max_uV < MAX1586_V3_MIN_UV || max_uV > MAX1586_V3_MAX_UV)
>>> + Â Â if (min_uV > max1586->max_uV || max_uV < max1586->min_uV)
>>> Â Â Â Â Â Â Â return -EINVAL;
>>> + Â Â if (min_uV < max1586->min_uV)
>>> + Â Â Â Â Â Â min_uV = max1586->min_uV;
>>>
>>> - Â Â selector = (min_uV - MAX1586_V3_MIN_UV) / MAX1586_V3_STEP_UV;
>>> - Â Â if (max1586_v3_calc_voltage(selector) > max_uV)
>>> + Â Â selector = (min_uV - max1586->min_uV) * 31 / range_uV;
>> Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â\-> ???
>> Why 31 ? Could I have a define here, and probably that define would be a value
>> of 32 (as there are 32 different steps, not 31).
>
> We have 32 steps, 0 to 31. The difference between the smallest and
> largest value is still 31. I should have used MAX1586_V3_MAX_VSEL here
> to avoid confusion.
OK, that's right.

>>> @@ -71,9 +84,11 @@ static int max1586_v3_set(struct regulator_dev *rdev, int min_uV, int max_uV)
>>>
>>> Âstatic int max1586_v3_list(struct regulator_dev *rdev, unsigned selector)
>>> Â{
>>> + Â Â struct max1586_data *max1586 = rdev_get_drvdata(rdev);
>>> +
>>> Â Â Â if (selector > MAX1586_V3_MAX_VSEL)
>>> Â Â Â Â Â Â Â return -EINVAL;
>>> - Â Â return max1586_v3_calc_voltage(selector);
>>> + Â Â return max1586_v3_calc_voltage(max1586, selector);
>>> Â}
>>>
>>> Â/*
>>> @@ -164,12 +179,33 @@ static int max1586_pmic_probe(struct i2c_client *client,
>>> Â{
>>> Â Â Â struct regulator_dev **rdev;
>>> Â Â Â struct max1586_platform_data *pdata = client->dev.platform_data;
>>> - Â Â int i, id, ret = 0;
>>> + Â Â struct max1586_data *max1586;
>>> + Â Â int i, id, ret = -ENOMEM;
>>>
>>> Â Â Â rdev = kzalloc(sizeof(struct regulator_dev *) * (MAX1586_V6 + 1),
>>> Â Â Â Â Â Â Â Â Â Â ÂGFP_KERNEL);
>>> Â Â Â if (!rdev)
>>> - Â Â Â Â Â Â return -ENOMEM;
>>> + Â Â Â Â Â Â goto out;
>>> +
>>> + Â Â max1586 = kzalloc(sizeof(struct max1586_data *), GFP_KERNEL);
>>> + Â Â if (!max1586)
>>> + Â Â Â Â Â Â goto out_unmap;
>>> +
>>> + Â Â max1586->client = client;
>>
>>> + Â Â switch (pdata->r24) {
>>> + Â Â case MAX1586_R24_3k32:
>>> + Â Â Â Â Â Â max1586->min_uV = 730000;
>>> + Â Â Â Â Â Â max1586->max_uV = 1550000;
>>> + Â Â Â Â Â Â break;
>>> + Â Â case MAX1586_R24_5k11:
>>> + Â Â Â Â Â Â max1586->min_uV = 750000;
>>> + Â Â Â Â Â Â max1586->max_uV = 1600000;
>>> + Â Â Â Â Â Â break;
>>> + Â Â case MAX1586_R24_7k5:
>>> + Â Â Â Â Â Â max1586->min_uV = 780000;
>>> + Â Â Â Â Â Â max1586->max_uV = 1650000;
>>> + Â Â Â Â Â Â break;
>>> + Â Â }

>> I would like that changed to something more or less like :
>> if (pdata->r24 == 0)
>> Â Â Â Âgain = 1;
>> else
>> Â Â Â Âgain = 1 + R24/185.5;
What do you think of putting directly the gain in the pdata structure ?
Something like pdata->gain_e6, which is equal to :
1000000 * (1 + R24/185000 + R24/R25).

That way, whatever the electronics do (say someone crazy puts a voltage
regulator providing voltage reference for FB3 pin), the system still works.

>
> No floating point in the kernel, so let's say I do some ugly rounding:
>
> e6 = 1000000;
> gain = e6 + e6*r24/100000 + e6*r24/185500;
> min_uV = ((MAX1586_V3_MIN_UV/1000 * gain) / e6) / 10 * 10000;
> max_uV = ((MAX1586_V3_MAX_UV/1000 * gain) / e6 + 9) / 10 * 10000;
>
> Then I get all the (nominal) values for R24 = 3220, 5110, 7500.
> But of course not for values inbetween, which kind of defeats the
> purpose of calculating it in the first place...
OK. Maybe would be easier if gain was in pdata ?

> If I don't round up the max values, I get something like 1.548V
> instead of the nominal 1.55V for max, so requests to set the voltage
> to 1.55V will fail even though it's in the 1.5% tolerance.


>>> diff --git a/include/linux/regulator/max1586.h b/include/linux/regulator/max1586.h
>>> index 2056973..cdf2010 100644
>>> --- a/include/linux/regulator/max1586.h
>>> +++ b/include/linux/regulator/max1586.h
>>> @@ -26,6 +26,10 @@
>>> Â#define MAX1586_V3 0
>>> Â#define MAX1586_V6 1
>>>
>>> +#define MAX1586_R24_3k32 3320
>>> +#define MAX1586_R24_5k11 5110
>>> +#define MAX1586_R24_7k5 Â7500
>> This could be gone, as R24 will define the exact value of R24 in ohms.
>
> I thought it would be good to have the values given in the datasheet
> as a reference somewhere.
True. What would you think of defining something like :
#define MAX1586_GAIN_R24_3k32 <your_computed_value>
and so on ?

>>> Â/**
>>> Â * max1586_subdev_data - regulator data
>>> Â * @id: regulator Id (either MAX1586_V3 or MAX1586_V6)
>>> @@ -43,10 +47,13 @@ struct max1586_subdev_data {
>>> Â * @num_subdevs: number of regultors used (may be 1 or 2)
>>> Â * @subdevs: regulator used
>>> Â * Â Â Â Â Â At most, there will be a regulator for V3 and one for V6 voltages.
>>> + * @r24: external regulator to increase V3 range
>> Rather :
>> + * @r24: external resistor value to increase V3 range (in ohms), or 0 if none
>
> As Mark noted, it is probably a good idea not to allow a value of 0 here.
And replacing with a gain ?

Cheers.

--
Robert
--
To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at http://vger.kernel.org/majordomo-info.html
Please read the FAQ at http://www.tux.org/lkml/