Skip to contentSkip to conversation

hwmon: Documentation: Add usage example for HWMON_CHANNEL_INFO

PATCH New Guenter Roeck 1 participant 1 message Mar 31, 2019

Subsystems (2)
lore
Share & tools
lore

Guenter Roeck

author maintainer
#0 lore raw

PATCH 1/1 hwmon: Documentation: Add usage example for HWMON_CHANNEL_INFO

The new HWMON_CHANNEL_INFO macro simplifies the code, reduces the likelihood of errors, and makes the code easier to read. Add a usage example to help driver writers to actually use it.

---
 Documentation/hwmon/hwmon-kernel-api.txt | 13 +++++++++++++
 1 file changed, 13 insertions(+)
Documentation/hwmon/hwmon-kernel-api.txt +13 -0
index 8bdefb41be30..f8e2ab5c21b9 100644
@@ -207,6 +207,19 @@ static const struct hwmon_channel_info *lm75_info[] = {
 	NULL
 };
 
+The HWMON_CHANNEL_INFO() macro can and should be used when possible.
+With this macro, the above example can be simplified to
+
+static const struct hwmon_channel_info *lm75_info[] = {
+	HWMON_CHANNEL_INFO(chip,
+			   HWMON_C_REGISTER_TZ | HWMON_C_UPDATE_INTERVAL),
+	HWMON_CHANNEL_INFO(temp,
+			   HWMON_T_INPUT | HWMON_T_MAX | HWMON_T_MAX_HYST),
+	NULL
+};
+
+The remaining declarations are as follows.
+
 static const struct hwmon_ops lm75_hwmon_ops = {
 	.is_visible = lm75_is_visible,
 	.read = lm75_read,
Signature · 1 line
2.7.4