dt-bindings: hwmon: Add nct7802 bindings
Subsystems (2)
PATCH v3 1/2 dt-bindings: hwmon: Add nct7802 bindings
Document bindings for the Nuvoton NCT7802Y driver.
--- .../bindings/hwmon/nuvoton,nct7802.yaml | 142 ++++++++++++++++++ 1 file changed, 142 insertions(+) create mode 100644 Documentation/devicetree/bindings/hwmon/nuvoton,nct7802.yaml
Documentation/devicetree/bindings/hwmon/nuvoton,nct7802.yaml new file +142 -0
@@ -0,0 +1,142 @@ +# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause) +%YAML 1.2 +--- + +$id: http://devicetree.org/schemas/hwmon/nuvoton,nct7802.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Nuvoton NCT7802Y Hardware Monitoring IC + +maintainers: + - Guenter Roeck <[email protected]> + +description: | + The NCT7802Y is a hardware monitor IC which supports one on-die and up to + 5 remote temperature sensors with SMBus interface. + + Datasheets: + https://www.nuvoton.com/export/resource-files/Nuvoton_NCT7802Y_Datasheet_V12.pdf + +properties: + compatible: + enum: + - nuvoton,nct7802 + + reg: + maxItems: 1 + + "#address-cells": + const: 1 + + "#size-cells": + const: 0 + + input@0: + type: object + description: Local Temperature Sensor ("LTD") + properties: + reg: + const: 0 + required: + - reg + + input@1: + type: object + description: Remote Temperature Sensor or Voltage Sensor ("RTD1") + properties: + reg: + const: 1 + sensor-type: + items: + - enum: + - temperature + - voltage + temperature-mode: + items: + - enum: + - thermistor + - thermal-diode + required: + - reg + - sensor-type + + input@2: + type: object + description: Remote Temperature Sensor or Voltage Sensor ("RTD2") + properties: + reg: + const: 2 + sensor-type: + items: + - enum: + - temperature + - voltage + temperature-mode: + items: + - enum: + - thermistor + - thermal-diode + required: + - reg + - sensor-type + + input@3: + type: object + description: Remote Temperature Sensor or Voltage Sensor ("RTD3") + properties: + reg: + const: 3 + sensor-type: + items: + - enum: + - temperature + - voltage + required: + - reg + - sensor-type + +required: + - compatible + - reg + +additionalProperties: false + +examples: + - | + i2c { + #address-cells = <1>; + #size-cells = <0>; + + nct7802@28 { + compatible = "nuvoton,nct7802"; + reg = <0x28>; + + #address-cells = <1>; + #size-cells = <0>; + + input@0 { /* LTD */ + reg = <0>; + status = "okay"; + }; + + input@1 { /* RTD1 */ + reg = <1>; + status = "okay"; + sensor-type = "temperature"; + temperature-mode = "thermistor"; + }; + + input@2 { /* RTD2 */ + reg = <2>; + status = "okay"; + sensor-type = "temperature"; + temperature-mode = "thermal-diode"; + }; + + input@3 { /* RTD3 */ + reg = <3>; + status = "okay"; + sensor-type = "voltage"; + }; + }; + };
Signature · 1 line
2.33.0.882.g93a45727a2-goog
PATCH v3 2/2 hwmon: (nct7802) Make temperature sensors configurable.
This change allows LTD and RTD inputs to be configured via device tree bindings. If the DT bindings are not present, the input configuration is not modified and left at HW defaults.
--- drivers/hwmon/nct7802.c | 160 ++++++++++++++++++++++++++++++++++++---- 1 file changed, 145 insertions(+), 15 deletions(-)
drivers/hwmon/nct7802.c +145 -15
@@ -51,6 +51,23 @@ static const u8 REG_VOLTAGE_LIMIT_MSB_SHIFT[2][5] = {#define REG_CHIP_ID 0xfe#define REG_VERSION_ID 0xff +/* +* Resistance temperature detector (RTD) modes according to 7.2.32 Mode +* Selection Register +*/ +#define RTD_MODE_CURRENT 0x1 +#define RTD_MODE_THERMISTOR 0x2 +#define RTD_MODE_VOLTAGE 0x3 + +#define MODE_RTD_MASK 0x3 +#define MODE_LTD_EN 0x40 + +/* +* Bit offset for sensors modes in REG_MODE. +* Valid for index 0..2, indicating RTD1..3. +*/ +#define MODE_BIT_OFFSET_RTD (index) ((index) * 2) +/* * Data structures and manipulation thereof */
@@ -74,7 +91,9 @@ static ssize_t temp_type_show(struct device *dev,if (ret <0 )return ret; -return sprintf (buf,"%u\n" , (mode >> (2 * sattr->index) &3 ) +2 ); +return sprintf (buf,"%u\n" , + ((mode >>MODE_BIT_OFFSET_RTD (sattr->index)) & +MODE_RTD_MASK ) +2 ); } static ssize_t temp_type_store(struct device *dev,
@@ -94,7 +113,8 @@ static ssize_t temp_type_store(struct device *dev,if (type <3 || type >4 )return -EINVAL ; err =regmap_update_bits (data->regmap,REG_MODE , -3 <<2 * sattr->index, (type -2 ) <<2 * sattr->index); +MODE_RTD_MASK <<MODE_BIT_OFFSET_RTD (sattr->index), + (type -2 ) <<MODE_BIT_OFFSET_RTD (sattr->index));return err ? : count; }
@@ -682,24 +702,24 @@ static umode_t nct7802_temp_is_visible(struct kobject *kobj,struct device *dev =kobj_to_dev (kobj);struct nct7802_data *data =dev_get_drvdata (dev);unsigned int reg; +unsigned int rtd_mode;int err; err =regmap_read (data->regmap,REG_MODE , ®);if (err <0 )return 0 ; -if (index <10 && - (reg &03 ) !=0x01 && (reg &0x03 ) !=0x02 )/* RD1 */ + rtd_mode = (reg >>MODE_BIT_OFFSET_RTD (index /10 )) &MODE_RTD_MASK ; +if (index >=0 && index <20 &&/* RD1, RD 2*/ + rtd_mode !=0x01 && rtd_mode !=0x02 )return 0 ; -if (index >=10 && index <20 && - (reg &0x0c ) !=0x04 && (reg &0x0c ) !=0x08 )/* RD2 */ -return 0 ; -if (index >=20 && index <30 && (reg &0x30 ) !=0x20 )/* RD3 */ +if (index >=20 && index <30 && rtd_mode !=0x02 )/* RD3 */ return 0 ; -if (index >=30 && index <38 )/* local */ -return attr->mode; +if (index >=30 && index <38 &&/* local */ + (reg &MODE_LTD_EN ) !=MODE_LTD_EN ) +return 0 ; err =regmap_read (data->regmap,REG_PECI_ENABLE , ®);if (err <0 )
@@ -1038,7 +1058,118 @@ static const struct regmap_config nct7802_regmap_config = { .volatile_reg = nct7802_regmap_is_volatile, }; -static int nct7802_init_chip (struct nct7802_data *data) +static bool nct7802_get_input_config (struct device *dev, +struct device_node *input,u8 *mode_mask,u8 *mode_val) +{ +u32 reg; +const char *type_str, *md_str; +u8 md; + +if (!input->name ||of_node_cmp (input->name,"input" )) +return false; + +if (of_property_read_u32 (input,"reg" , ®)) { +dev_err (dev,"Could not read reg value for '%s'\n" , + input->full_name); +return false; + } + +if (reg >3 ) { +dev_err (dev, +"Invalid reg (%u) in '%s'\n" , reg, input->full_name); +return false; + } + +if (reg ==0 ) { +if (!of_device_is_available (input)) + *mode_val &= ~MODE_LTD_EN ; +else + *mode_val |=MODE_LTD_EN ; + *mode_mask |=MODE_LTD_EN ; +return true; + } + +if (reg >=1 && reg <=3 && !of_device_is_available (input)) { + *mode_val &= ~(MODE_RTD_MASK + <<MODE_BIT_OFFSET_RTD (reg-1 )); + *mode_mask |=MODE_RTD_MASK + <<MODE_BIT_OFFSET_RTD (reg-1 ); +return true; + } + +if (of_property_read_string (input,"sensor-type" , &type_str)) { +dev_err (dev,"No type for '%s'\n" , input->full_name); +return false; + } + +if (!strcmp (type_str,"voltage" )) { + *mode_val |= (RTD_MODE_VOLTAGE &MODE_RTD_MASK ) + <<MODE_BIT_OFFSET_RTD (reg-1 ); + *mode_mask |=MODE_RTD_MASK + <<MODE_BIT_OFFSET_RTD (reg-1 ); +return true; + } + +if (strcmp (type_str,"temperature" )) { +dev_err (dev,"Invalid type '%s' for '%s'\n" , type_str, + input->full_name); +return false; + } + +if (reg ==3 ) { +/* RTD3 only supports thermistor mode */ + md =RTD_MODE_THERMISTOR ; + }else { +if (of_property_read_string (input,"temperature-mode" , + &md_str)) { +dev_err (dev,"No mode for '%s'\n" , input->full_name); +return false; + } + +if (!strcmp (md_str,"thermal-diode" )) + md =RTD_MODE_CURRENT ; +else if (!strcmp (md_str,"thermistor" )) + md =RTD_MODE_THERMISTOR ; +else { +dev_err (dev,"Invalid mode '%s' for '%s'\n" , md_str, + input->full_name); +return false; + } + } + + *mode_val |= (md &MODE_RTD_MASK ) + <<MODE_BIT_OFFSET_RTD (reg-1 ); + *mode_mask |=MODE_RTD_MASK + <<MODE_BIT_OFFSET_RTD (reg-1 ); + +return true; +} + +static int nct7802_configure_inputs (struct device *dev, +struct nct7802_data *data) +{ +bool found_input_config = false; +u8 mode_mask =0 , mode_val =0 ; +struct device_node *input; + +if (dev->of_node) { +for_each_child_of_node (dev->of_node, input) { +if (nct7802_get_input_config (dev, input, &mode_mask, + &mode_val)) + found_input_config = true; + } + } + +if (!found_input_config) { +/* Enable local temperature sensor by default */ + mode_val |=MODE_LTD_EN ; + mode_mask |=MODE_LTD_EN ; + } + +return regmap_update_bits (data->regmap,REG_MODE , mode_mask, mode_val); +} + +static int nct7802_init_chip (struct device *dev,struct nct7802_data *data) {int err;
@@ -1047,12 +1178,11 @@ static int nct7802_init_chip(struct nct7802_data *data)if (err)return err; -/* Enable local temperature sensor */ - err =regmap_update_bits (data->regmap,REG_MODE ,0x40 ,0x40 ); + err =nct7802_configure_inputs (dev, data);if (err)return err; -/* Enable Vcore and VCC voltage monitoring */ +/* Enable Vcore and VCC voltage monit, struct nct7802_data *dataoring */ return regmap_update_bits (data->regmap,REG_VMON_ENABLE ,0x03 ,0x03 ); }
@@ -1074,7 +1204,7 @@ static int nct7802_probe(struct i2c_client *client)mutex_init (&data->access_lock);mutex_init (&data->in_alarm_lock); - ret =nct7802_init_chip (data); + ret =nct7802_init_chip (dev, data);if (ret <0 )return ret;
Signature · 1 line
2.33.0.882.g93a45727a2-goog
Guenter Roeck
maintainerHi Oskar,
Quoted 3 lines · Oskar Senft
Document bindings for the Nuvoton NCT7802Y driver.
Signed-off-by Oskar Senft <[email protected]>
Please pdon't expect from reviewers to figure out what changed between versions and provide change logs.
Thanks,
Guenter
Quoted 154 lines
--- .../bindings/hwmon/nuvoton,nct7802.yaml | 142 ++++++++++++++++++ 1 file changed, 142 insertions(+)create mode 100644
Documentation/devicetree/bindings/hwmon/nuvoton,nct7802.yamlDocumentation/devicetree/bindings/hwmon/nuvoton,nct7802.yaml new file +142
-0@@ -0,0 +1,142 @@ +# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause) +%YAML 1.2 +--- + +$id: http://devicetree.org/schemas/hwmon/nuvoton,nct7802.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Nuvoton NCT7802Y Hardware Monitoring IC + +maintainers: + - Guenter Roeck <[email protected]> + +description: | + The NCT7802Y is a hardware monitor IC which supports one on-die and up to + 5 remote temperature sensors with SMBus interface. + + Datasheets: + https://www.nuvoton.com/export/resource-files/Nuvoton_NCT7802Y_Datasheet_V12.pdf + +properties: + compatible: + enum: + - nuvoton,nct7802 + + reg: + maxItems: 1 + + "#address-cells": + const: 1 + + "#size-cells": + const: 0 + + input@0: + type: object + description: Local Temperature Sensor ("LTD") + properties: + reg: + const: 0 + required: + - reg + + input@1: + type: object + description: Remote Temperature Sensor or Voltage Sensor ("RTD1") + properties: + reg: + const: 1 + sensor-type: + items: + - enum: + - temperature + - voltage + temperature-mode: + items: + - enum: + - thermistor + - thermal-diode + required: + - reg + - sensor-type + + input@2: + type: object + description: Remote Temperature Sensor or Voltage Sensor ("RTD2") + properties: + reg: + const: 2 + sensor-type: + items: + - enum: + - temperature + - voltage + temperature-mode: + items: + - enum: + - thermistor + - thermal-diode + required: + - reg + - sensor-type + + input@3: + type: object + description: Remote Temperature Sensor or Voltage Sensor ("RTD3") + properties: + reg: + const: 3 + sensor-type: + items: + - enum: + - temperature + - voltage + required: + - reg + - sensor-type + +required: + - compatible + - reg + +additionalProperties: false + +examples: + - | + i2c { + #address-cells = <1>; + #size-cells = <0>; + + nct7802@28 { + compatible = "nuvoton,nct7802"; + reg = <0x28>; + + #address-cells = <1>; + #size-cells = <0>; + + input@0 { /* LTD */ + reg = <0>; + status = "okay"; + }; + + input@1 { /* RTD1 */ + reg = <1>; + status = "okay"; + sensor-type = "temperature"; + temperature-mode = "thermistor"; + }; + + input@2 { /* RTD2 */ + reg = <2>; + status = "okay"; + sensor-type = "temperature"; + temperature-mode = "thermal-diode"; + }; + + input@3 { /* RTD3 */ + reg = <3>; + status = "okay"; + sensor-type = "voltage"; + }; + }; + };
Hi everyone
Quoted 6 lines
Quoted 3 lines
Document bindings for the Nuvoton NCT7802Y driver.
Signed-off-by Oskar Senft <[email protected]>Please pdon't expect from reviewers to figure out what changed between versions and provide change logs.
Uh, I'm sorry, I'm new to the Linux upstreaming game. I'm used to using code review tools like Gerrit, which help with that.
Changes from "PATCH v2 1/2" to "PATCH v4 1/2" (v3 was sent with a typo, so please ignore v3):
- Removed extra layer "temperature-sensors" as discussed.
- Renamed "sensor" to "input" as discussed.
- Renamed "mode" to "sensor-type" to indicate temperature or voltage.
- Added "temperature-mode" to indicate "thermistor" or "thermal-diode".
- Removed description attributes from "sensor-type" and didn't add for "temperature-mode", since they would have just repeated the names of the properties.
- Numbered sensors 0 (LTD) and 1..3 (RTD1..3).
Some notes:
- While 1..3 are "natural numberings", there's no equivalent for "0" in the datasheet - the name "0" is arbitrary. An alternative would be to name this sensor "ltd" instead of "input", since it's not configurable (beyond disabling it).
- I wasn't sure what the correct way is to enforce a match from "input@X" to "reg = <X>", so I listed the inputs individually. Technically RTD1 and RTD2 could be done as "patternProperties", if we could enforce the match between @X and reg.
I hope I included all the various comments and discussion points both from PATCH v2 and from the "tmp421" thread [1]. Please let me know if I missed anything.
Does this proposal match the general thinking and goals for dt-bindings for hwmon devices?
Thanks
Oskar.