| Message ID | aef8227a9ac7246791bf3f086008e2d381ddd463.1625529219.git.plr.vincent@gmail.com (mailing list archive) |
|---|---|
| State | Changes Requested |
| Headers | show |
| Series | [1/3] mfd: da9063: Add HWMON dependencies | expand |
On 7/5/21 5:01 PM, Vincent Pelletier wrote: > From: "Opensource [Steve Twiss]" <stwiss.opensource@diasemi.com> > > Addition of HWMON documentation for the DA9063 driver. > > Signed-off-by: Opensource [Steve Twiss] <stwiss.opensource@diasemi.com> > > Updated temperature formula, as of datasheet rev 2.3. > > Signed-off-by: Vincent Pelletier <plr.vincent@gmail.com> > --- > Originally submitted by Steve Twiss in 2014: > https://marc.info/?l=linux-kernel&m=139560868209856&w=2 > > Documentation/hwmon/da9063 | 67 ++++++++++++++++++++++++++++++++++++++ Documentation is now in .rst format. > 1 file changed, 67 insertions(+) > create mode 100644 Documentation/hwmon/da9063 > > diff --git a/Documentation/hwmon/da9063 b/Documentation/hwmon/da9063 > new file mode 100644 > index 000000000000..879f1d0fb3e4 > --- /dev/null > +++ b/Documentation/hwmon/da9063 > @@ -0,0 +1,67 @@ > + > +Kernel driver da9063-hwmon > +========================== > + > +Supported chips: > + * Dialog Semiconductor DA9063 PMIC > + Prefix: 'da9063' > + Datasheet: > + http://www.dialog-semiconductor.com/products/power-management/DA9063 > + > +Authors: S Twiss <stwiss.opensource@diasemi.com> > + > +Description > +----------- > + > +The DA9063 PMIC provides a general purpose ADC with 10 bits of resolution. > +It uses track and hold circuitry with an analogue input multiplexer which > +allows the conversion of up to 9 different inputs. > + > + Channel 0: VSYS_RES measurement of the system VDD (2.5 - 5.5V) > + Channel 1: ADCIN1_RES high impedance input (0 - 2.5V) > + Channel 2: ADCIN2_RES high impedance input (0 - 2.5V) > + Channel 3: ADCIN3_RES high impedance input (0 - 2.5V) > + Channel 4: Tjunc measurement of internal temperature sensor > + Channel 5: VBBAT measurement of the backup battery voltage (0 - 5.0V) > + Channel 6: N/A Reserved > + Channel 7: N/A Reserved > + Channel 8: MON1_RES group 1 internal regulators voltage (0 - 5.0V) > + Channel 9: MON2_RES group 2 internal regulators voltage (0 - 5.0V) > + Channel 10: MON3_RES group 3 internal regulators voltage (0 - 5.0V) > + > +The MUX selects from and isolates the 9 inputs and presents the channel to > +be measured to the ADC input. When selected, an input amplifier on the VSYS > +channel subtracts the VDDCORE reference voltage and scales the signal to the > +correct value for the ADC. > + > +The analog ADC includes current sources at ADC_IN1, ADC_IN2 and ADC_IN3 to > +support resistive measurements. > + > +Channels 1, 2 and 3 current source capability can be set through the ADC > +thresholds ADC_CFG register and values for ADCIN1_CUR, ADCIN2_CUR and > +ADCIN3_CUR. Settings for ADCIN1_CUR and ADCIN2_CUR are 1.0, 2.0, 10 and > +40 micro Amps. The setting for ADCIN3_CUR is 10 micro Amps. > + > +Voltage Monitoring > +------------------ > + > +The manual measurement allows monitoring of the system voltage VSYS, the > +auxiliary channels ADCIN1, ADCIN2 and ADCIN3, and a VBBAT measurement of > +the backup battery voltage (0 - 5.0V). The manual measurements store 10 > +bits of ADC resolution. > + > +The manual ADC measurements attributes described above are supported by > +the driver. > + > +The automatic ADC measurement is not supported by the driver. > + > +Temperature Monitoring > +---------------------- > + > +Channel 4 (Tjunc) will be used to measure the output of the internal > +temperature sensor. The ADC measurement result and the T_OFFSET value can > +be used by the host to calculate the internal junction temperature > + > + Tjunc = -0.398 * (ADC - T_OFFSET) + 330; > + > +The junction temperature attribute is supported by the driver. >
diff --git a/Documentation/hwmon/da9063 b/Documentation/hwmon/da9063 new file mode 100644 index 000000000000..879f1d0fb3e4 --- /dev/null +++ b/Documentation/hwmon/da9063 @@ -0,0 +1,67 @@ + +Kernel driver da9063-hwmon +========================== + +Supported chips: + * Dialog Semiconductor DA9063 PMIC + Prefix: 'da9063' + Datasheet: + http://www.dialog-semiconductor.com/products/power-management/DA9063 + +Authors: S Twiss <stwiss.opensource@diasemi.com> + +Description +----------- + +The DA9063 PMIC provides a general purpose ADC with 10 bits of resolution. +It uses track and hold circuitry with an analogue input multiplexer which +allows the conversion of up to 9 different inputs. + + Channel 0: VSYS_RES measurement of the system VDD (2.5 - 5.5V) + Channel 1: ADCIN1_RES high impedance input (0 - 2.5V) + Channel 2: ADCIN2_RES high impedance input (0 - 2.5V) + Channel 3: ADCIN3_RES high impedance input (0 - 2.5V) + Channel 4: Tjunc measurement of internal temperature sensor + Channel 5: VBBAT measurement of the backup battery voltage (0 - 5.0V) + Channel 6: N/A Reserved + Channel 7: N/A Reserved + Channel 8: MON1_RES group 1 internal regulators voltage (0 - 5.0V) + Channel 9: MON2_RES group 2 internal regulators voltage (0 - 5.0V) + Channel 10: MON3_RES group 3 internal regulators voltage (0 - 5.0V) + +The MUX selects from and isolates the 9 inputs and presents the channel to +be measured to the ADC input. When selected, an input amplifier on the VSYS +channel subtracts the VDDCORE reference voltage and scales the signal to the +correct value for the ADC. + +The analog ADC includes current sources at ADC_IN1, ADC_IN2 and ADC_IN3 to +support resistive measurements. + +Channels 1, 2 and 3 current source capability can be set through the ADC +thresholds ADC_CFG register and values for ADCIN1_CUR, ADCIN2_CUR and +ADCIN3_CUR. Settings for ADCIN1_CUR and ADCIN2_CUR are 1.0, 2.0, 10 and +40 micro Amps. The setting for ADCIN3_CUR is 10 micro Amps. + +Voltage Monitoring +------------------ + +The manual measurement allows monitoring of the system voltage VSYS, the +auxiliary channels ADCIN1, ADCIN2 and ADCIN3, and a VBBAT measurement of +the backup battery voltage (0 - 5.0V). The manual measurements store 10 +bits of ADC resolution. + +The manual ADC measurements attributes described above are supported by +the driver. + +The automatic ADC measurement is not supported by the driver. + +Temperature Monitoring +---------------------- + +Channel 4 (Tjunc) will be used to measure the output of the internal +temperature sensor. The ADC measurement result and the T_OFFSET value can +be used by the host to calculate the internal junction temperature + + Tjunc = -0.398 * (ADC - T_OFFSET) + 330; + +The junction temperature attribute is supported by the driver.