1 // SPDX-License-Identifier: GPL-2.0-only
3 * Copyright (c) 2020 Sartura Ltd.
5 * Driver for the TI TPS23861 PoE PSE.
7 * Author: Robert Marko <robert.marko@sartura.hr>
10 #include <linux/bitfield.h>
11 #include <linux/debugfs.h>
12 #include <linux/delay.h>
13 #include <linux/hwmon-sysfs.h>
14 #include <linux/hwmon.h>
15 #include <linux/i2c.h>
16 #include <linux/module.h>
17 #include <linux/of_device.h>
18 #include <linux/regmap.h>
20 #define TEMPERATURE 0x2c
21 #define INPUT_VOLTAGE_LSB 0x2e
22 #define INPUT_VOLTAGE_MSB 0x2f
23 #define PORT_1_CURRENT_LSB 0x30
24 #define PORT_1_CURRENT_MSB 0x31
25 #define PORT_1_VOLTAGE_LSB 0x32
26 #define PORT_1_VOLTAGE_MSB 0x33
27 #define PORT_2_CURRENT_LSB 0x34
28 #define PORT_2_CURRENT_MSB 0x35
29 #define PORT_2_VOLTAGE_LSB 0x36
30 #define PORT_2_VOLTAGE_MSB 0x37
31 #define PORT_3_CURRENT_LSB 0x38
32 #define PORT_3_CURRENT_MSB 0x39
33 #define PORT_3_VOLTAGE_LSB 0x3a
34 #define PORT_3_VOLTAGE_MSB 0x3b
35 #define PORT_4_CURRENT_LSB 0x3c
36 #define PORT_4_CURRENT_MSB 0x3d
37 #define PORT_4_VOLTAGE_LSB 0x3e
38 #define PORT_4_VOLTAGE_MSB 0x3f
39 #define PORT_N_CURRENT_LSB_OFFSET 0x04
40 #define PORT_N_VOLTAGE_LSB_OFFSET 0x04
41 #define VOLTAGE_CURRENT_MASK GENMASK(13, 0)
42 #define PORT_1_RESISTANCE_LSB 0x60
43 #define PORT_1_RESISTANCE_MSB 0x61
44 #define PORT_2_RESISTANCE_LSB 0x62
45 #define PORT_2_RESISTANCE_MSB 0x63
46 #define PORT_3_RESISTANCE_LSB 0x64
47 #define PORT_3_RESISTANCE_MSB 0x65
48 #define PORT_4_RESISTANCE_LSB 0x66
49 #define PORT_4_RESISTANCE_MSB 0x67
50 #define PORT_N_RESISTANCE_LSB_OFFSET 0x02
51 #define PORT_RESISTANCE_MASK GENMASK(13, 0)
52 #define PORT_RESISTANCE_RSN_MASK GENMASK(15, 14)
53 #define PORT_RESISTANCE_RSN_OTHER 0
54 #define PORT_RESISTANCE_RSN_LOW 1
55 #define PORT_RESISTANCE_RSN_OPEN 2
56 #define PORT_RESISTANCE_RSN_SHORT 3
57 #define PORT_1_STATUS 0x0c
58 #define PORT_2_STATUS 0x0d
59 #define PORT_3_STATUS 0x0e
60 #define PORT_4_STATUS 0x0f
61 #define PORT_STATUS_CLASS_MASK GENMASK(7, 4)
62 #define PORT_STATUS_DETECT_MASK GENMASK(3, 0)
63 #define PORT_CLASS_UNKNOWN 0
64 #define PORT_CLASS_1 1
65 #define PORT_CLASS_2 2
66 #define PORT_CLASS_3 3
67 #define PORT_CLASS_4 4
68 #define PORT_CLASS_RESERVED 5
69 #define PORT_CLASS_0 6
70 #define PORT_CLASS_OVERCURRENT 7
71 #define PORT_CLASS_MISMATCH 8
72 #define PORT_DETECT_UNKNOWN 0
73 #define PORT_DETECT_SHORT 1
74 #define PORT_DETECT_RESERVED 2
75 #define PORT_DETECT_RESISTANCE_LOW 3
76 #define PORT_DETECT_RESISTANCE_OK 4
77 #define PORT_DETECT_RESISTANCE_HIGH 5
78 #define PORT_DETECT_OPEN_CIRCUIT 6
79 #define PORT_DETECT_RESERVED_2 7
80 #define PORT_DETECT_MOSFET_FAULT 8
81 #define PORT_DETECT_LEGACY 9
82 /* Measurment beyond clamp voltage */
83 #define PORT_DETECT_CAPACITANCE_INVALID_BEYOND 10
84 /* Insufficient voltage delta */
85 #define PORT_DETECT_CAPACITANCE_INVALID_DELTA 11
86 #define PORT_DETECT_CAPACITANCE_OUT_OF_RANGE 12
88 #define OPERATING_MODE 0x12
89 #define OPERATING_MODE_OFF 0
90 #define OPERATING_MODE_MANUAL 1
91 #define OPERATING_MODE_SEMI 2
92 #define OPERATING_MODE_AUTO 3
93 #define OPERATING_MODE_PORT_1_MASK GENMASK(1, 0)
94 #define OPERATING_MODE_PORT_2_MASK GENMASK(3, 2)
95 #define OPERATING_MODE_PORT_3_MASK GENMASK(5, 4)
96 #define OPERATING_MODE_PORT_4_MASK GENMASK(7, 6)
98 #define DETECT_CLASS_RESTART 0x18
99 #define POWER_ENABLE 0x19
100 #define TPS23861_NUM_PORTS 4
102 #define TEMPERATURE_LSB 652 /* 0.652 degrees Celsius */
103 #define VOLTAGE_LSB 3662 /* 3.662 mV */
104 #define SHUNT_RESISTOR_DEFAULT 255000 /* 255 mOhm */
105 #define CURRENT_LSB_255 62260 /* 62.260 uA */
106 #define CURRENT_LSB_250 61039 /* 61.039 uA */
107 #define RESISTANCE_LSB 110966 /* 11.0966 Ohm*/
108 #define RESISTANCE_LSB_LOW 157216 /* 15.7216 Ohm*/
110 struct tps23861_data {
111 struct regmap *regmap;
113 struct i2c_client *client;
114 struct dentry *debugfs_dir;
117 static struct regmap_config tps23861_regmap_config = {
120 .max_register = 0x6f,
123 static int tps23861_read_temp(struct tps23861_data *data, long *val)
128 err = regmap_read(data->regmap, TEMPERATURE, ®val);
132 *val = (regval * TEMPERATURE_LSB) - 20000;
137 static int tps23861_read_voltage(struct tps23861_data *data, int channel,
143 if (channel < TPS23861_NUM_PORTS) {
144 err = regmap_bulk_read(data->regmap,
145 PORT_1_VOLTAGE_LSB + channel * PORT_N_VOLTAGE_LSB_OFFSET,
148 err = regmap_bulk_read(data->regmap,
155 *val = (FIELD_GET(VOLTAGE_CURRENT_MASK, regval) * VOLTAGE_LSB) / 1000;
160 static int tps23861_read_current(struct tps23861_data *data, int channel,
163 unsigned int current_lsb;
167 if (data->shunt_resistor == SHUNT_RESISTOR_DEFAULT)
168 current_lsb = CURRENT_LSB_255;
170 current_lsb = CURRENT_LSB_250;
172 err = regmap_bulk_read(data->regmap,
173 PORT_1_CURRENT_LSB + channel * PORT_N_CURRENT_LSB_OFFSET,
178 *val = (FIELD_GET(VOLTAGE_CURRENT_MASK, regval) * current_lsb) / 1000000;
183 static int tps23861_port_disable(struct tps23861_data *data, int channel)
185 unsigned int regval = 0;
188 regval |= BIT(channel + 4);
189 err = regmap_write(data->regmap, POWER_ENABLE, regval);
194 static int tps23861_port_enable(struct tps23861_data *data, int channel)
196 unsigned int regval = 0;
199 regval |= BIT(channel);
200 regval |= BIT(channel + 4);
201 err = regmap_write(data->regmap, DETECT_CLASS_RESTART, regval);
206 static umode_t tps23861_is_visible(const void *data, enum hwmon_sensor_types type,
207 u32 attr, int channel)
212 case hwmon_temp_input:
213 case hwmon_temp_label:
223 case hwmon_in_enable:
230 case hwmon_curr_input:
231 case hwmon_curr_label:
241 static int tps23861_write(struct device *dev, enum hwmon_sensor_types type,
242 u32 attr, int channel, long val)
244 struct tps23861_data *data = dev_get_drvdata(dev);
250 case hwmon_in_enable:
252 err = tps23861_port_disable(data, channel);
254 err = tps23861_port_enable(data, channel);
269 static int tps23861_read(struct device *dev, enum hwmon_sensor_types type,
270 u32 attr, int channel, long *val)
272 struct tps23861_data *data = dev_get_drvdata(dev);
278 case hwmon_temp_input:
279 err = tps23861_read_temp(data, val);
288 err = tps23861_read_voltage(data, channel, val);
296 case hwmon_curr_input:
297 err = tps23861_read_current(data, channel, val);
310 static const char * const tps23861_port_label[] = {
318 static int tps23861_read_string(struct device *dev,
319 enum hwmon_sensor_types type,
320 u32 attr, int channel, const char **str)
325 *str = tps23861_port_label[channel];
337 static const struct hwmon_channel_info *tps23861_info[] = {
338 HWMON_CHANNEL_INFO(chip,
339 HWMON_C_REGISTER_TZ),
340 HWMON_CHANNEL_INFO(temp,
341 HWMON_T_INPUT | HWMON_T_LABEL),
342 HWMON_CHANNEL_INFO(in,
343 HWMON_I_INPUT | HWMON_I_ENABLE | HWMON_I_LABEL,
344 HWMON_I_INPUT | HWMON_I_ENABLE | HWMON_I_LABEL,
345 HWMON_I_INPUT | HWMON_I_ENABLE | HWMON_I_LABEL,
346 HWMON_I_INPUT | HWMON_I_ENABLE | HWMON_I_LABEL,
347 HWMON_I_INPUT | HWMON_I_LABEL),
348 HWMON_CHANNEL_INFO(curr,
349 HWMON_C_INPUT | HWMON_C_LABEL,
350 HWMON_C_INPUT | HWMON_C_LABEL,
351 HWMON_C_INPUT | HWMON_C_LABEL,
352 HWMON_C_INPUT | HWMON_C_LABEL),
356 static const struct hwmon_ops tps23861_hwmon_ops = {
357 .is_visible = tps23861_is_visible,
358 .write = tps23861_write,
359 .read = tps23861_read,
360 .read_string = tps23861_read_string,
363 static const struct hwmon_chip_info tps23861_chip_info = {
364 .ops = &tps23861_hwmon_ops,
365 .info = tps23861_info,
368 static char *tps23861_port_operating_mode(struct tps23861_data *data, int port)
373 regmap_read(data->regmap, OPERATING_MODE, ®val);
377 mode = FIELD_GET(OPERATING_MODE_PORT_1_MASK, regval);
380 mode = FIELD_GET(OPERATING_MODE_PORT_2_MASK, regval);
383 mode = FIELD_GET(OPERATING_MODE_PORT_3_MASK, regval);
386 mode = FIELD_GET(OPERATING_MODE_PORT_4_MASK, regval);
393 case OPERATING_MODE_OFF:
395 case OPERATING_MODE_MANUAL:
397 case OPERATING_MODE_SEMI:
399 case OPERATING_MODE_AUTO:
406 static char *tps23861_port_detect_status(struct tps23861_data *data, int port)
410 regmap_read(data->regmap,
411 PORT_1_STATUS + (port - 1),
414 switch (FIELD_GET(PORT_STATUS_DETECT_MASK, regval)) {
415 case PORT_DETECT_UNKNOWN:
416 return "Unknown device";
417 case PORT_DETECT_SHORT:
418 return "Short circuit";
419 case PORT_DETECT_RESISTANCE_LOW:
420 return "Too low resistance";
421 case PORT_DETECT_RESISTANCE_OK:
422 return "Valid resistance";
423 case PORT_DETECT_RESISTANCE_HIGH:
424 return "Too high resistance";
425 case PORT_DETECT_OPEN_CIRCUIT:
426 return "Open circuit";
427 case PORT_DETECT_MOSFET_FAULT:
428 return "MOSFET fault";
429 case PORT_DETECT_LEGACY:
430 return "Legacy device";
431 case PORT_DETECT_CAPACITANCE_INVALID_BEYOND:
432 return "Invalid capacitance, beyond clamp voltage";
433 case PORT_DETECT_CAPACITANCE_INVALID_DELTA:
434 return "Invalid capacitance, insufficient voltage delta";
435 case PORT_DETECT_CAPACITANCE_OUT_OF_RANGE:
436 return "Valid capacitance, outside of legacy range";
437 case PORT_DETECT_RESERVED:
438 case PORT_DETECT_RESERVED_2:
444 static char *tps23861_port_class_status(struct tps23861_data *data, int port)
448 regmap_read(data->regmap,
449 PORT_1_STATUS + (port - 1),
452 switch (FIELD_GET(PORT_STATUS_CLASS_MASK, regval)) {
453 case PORT_CLASS_UNKNOWN:
455 case PORT_CLASS_RESERVED:
466 case PORT_CLASS_OVERCURRENT:
467 return "Overcurrent";
468 case PORT_CLASS_MISMATCH:
475 static char *tps23861_port_poe_plus_status(struct tps23861_data *data, int port)
479 regmap_read(data->regmap, POE_PLUS, ®val);
481 if (BIT(port + 3) & regval)
487 static int tps23861_port_resistance(struct tps23861_data *data, int port)
491 regmap_bulk_read(data->regmap,
492 PORT_1_RESISTANCE_LSB + PORT_N_RESISTANCE_LSB_OFFSET * (port - 1),
496 switch (FIELD_GET(PORT_RESISTANCE_RSN_MASK, regval)) {
497 case PORT_RESISTANCE_RSN_OTHER:
498 return (FIELD_GET(PORT_RESISTANCE_MASK, regval) * RESISTANCE_LSB) / 10000;
499 case PORT_RESISTANCE_RSN_LOW:
500 return (FIELD_GET(PORT_RESISTANCE_MASK, regval) * RESISTANCE_LSB_LOW) / 10000;
501 case PORT_RESISTANCE_RSN_SHORT:
502 case PORT_RESISTANCE_RSN_OPEN:
508 static int tps23861_port_status_show(struct seq_file *s, void *data)
510 struct tps23861_data *priv = s->private;
513 for (i = 1; i < TPS23861_NUM_PORTS + 1; i++) {
514 seq_printf(s, "Port: \t\t%d\n", i);
515 seq_printf(s, "Operating mode: %s\n", tps23861_port_operating_mode(priv, i));
516 seq_printf(s, "Detected: \t%s\n", tps23861_port_detect_status(priv, i));
517 seq_printf(s, "Class: \t\t%s\n", tps23861_port_class_status(priv, i));
518 seq_printf(s, "PoE Plus: \t%s\n", tps23861_port_poe_plus_status(priv, i));
519 seq_printf(s, "Resistance: \t%d\n", tps23861_port_resistance(priv, i));
526 DEFINE_SHOW_ATTRIBUTE(tps23861_port_status);
528 static void tps23861_init_debugfs(struct tps23861_data *data)
530 data->debugfs_dir = debugfs_create_dir(data->client->name, NULL);
532 debugfs_create_file("port_status",
536 &tps23861_port_status_fops);
539 static int tps23861_probe(struct i2c_client *client)
541 struct device *dev = &client->dev;
542 struct tps23861_data *data;
543 struct device *hwmon_dev;
546 data = devm_kzalloc(dev, sizeof(*data), GFP_KERNEL);
550 data->client = client;
551 i2c_set_clientdata(client, data);
553 data->regmap = devm_regmap_init_i2c(client, &tps23861_regmap_config);
554 if (IS_ERR(data->regmap)) {
555 dev_err(dev, "failed to allocate register map\n");
556 return PTR_ERR(data->regmap);
559 if (!of_property_read_u32(dev->of_node, "shunt-resistor-micro-ohms", &shunt_resistor))
560 data->shunt_resistor = shunt_resistor;
562 data->shunt_resistor = SHUNT_RESISTOR_DEFAULT;
564 hwmon_dev = devm_hwmon_device_register_with_info(dev, client->name,
565 data, &tps23861_chip_info,
567 if (IS_ERR(hwmon_dev))
568 return PTR_ERR(hwmon_dev);
570 tps23861_init_debugfs(data);
575 static int tps23861_remove(struct i2c_client *client)
577 struct tps23861_data *data = i2c_get_clientdata(client);
579 debugfs_remove_recursive(data->debugfs_dir);
584 static const struct of_device_id __maybe_unused tps23861_of_match[] = {
585 { .compatible = "ti,tps23861", },
588 MODULE_DEVICE_TABLE(of, tps23861_of_match);
590 static struct i2c_driver tps23861_driver = {
591 .probe_new = tps23861_probe,
592 .remove = tps23861_remove,
595 .of_match_table = of_match_ptr(tps23861_of_match),
598 module_i2c_driver(tps23861_driver);
600 MODULE_LICENSE("GPL");
601 MODULE_AUTHOR("Robert Marko <robert.marko@sartura.hr>");
602 MODULE_DESCRIPTION("TI TPS23861 PoE PSE");