Loading...
1// SPDX-License-Identifier: (GPL-2.0 OR BSD-3-Clause)
2//
3// Copyright (c) 2018 Mellanox Technologies. All rights reserved.
4// Copyright (c) 2018 Vadim Pasternak <vadimp@mellanox.com>
5
6#include <linux/bitops.h>
7#include <linux/device.h>
8#include <linux/hwmon.h>
9#include <linux/module.h>
10#include <linux/platform_data/mlxreg.h>
11#include <linux/platform_device.h>
12#include <linux/regmap.h>
13#include <linux/thermal.h>
14
15#define MLXREG_FAN_MAX_TACHO 24
16#define MLXREG_FAN_MAX_PWM 4
17#define MLXREG_FAN_PWM_NOT_CONNECTED 0xff
18#define MLXREG_FAN_MAX_STATE 10
19#define MLXREG_FAN_MIN_DUTY 51 /* 20% */
20#define MLXREG_FAN_MAX_DUTY 255 /* 100% */
21#define MLXREG_FAN_SPEED_MIN_LEVEL 2 /* 20 percent */
22#define MLXREG_FAN_TACHO_SAMPLES_PER_PULSE_DEF 44
23#define MLXREG_FAN_TACHO_DIV_MIN 283
24#define MLXREG_FAN_TACHO_DIV_DEF (MLXREG_FAN_TACHO_DIV_MIN * 4)
25#define MLXREG_FAN_TACHO_DIV_SCALE_MAX 64
26/*
27 * FAN datasheet defines the formula for RPM calculations as RPM = 15/t-high.
28 * The logic in a programmable device measures the time t-high by sampling the
29 * tachometer every t-sample (with the default value 11.32 uS) and increment
30 * a counter (N) as long as the pulse has not change:
31 * RPM = 15 / (t-sample * (K + Regval)), where:
32 * Regval: is the value read from the programmable device register;
33 * - 0xff - represents tachometer fault;
34 * - 0xfe - represents tachometer minimum value , which is 4444 RPM;
35 * - 0x00 - represents tachometer maximum value , which is 300000 RPM;
36 * K: is 44 and it represents the minimum allowed samples per pulse;
37 * N: is equal K + Regval;
38 * In order to calculate RPM from the register value the following formula is
39 * used: RPM = 15 / ((Regval + K) * 11.32) * 10^(-6)), which in the
40 * default case is modified to:
41 * RPM = 15000000 * 100 / ((Regval + 44) * 1132);
42 * - for Regval 0x00, RPM will be 15000000 * 100 / (44 * 1132) = 30115;
43 * - for Regval 0xfe, RPM will be 15000000 * 100 / ((254 + 44) * 1132) = 4446;
44 * In common case the formula is modified to:
45 * RPM = 15000000 * 100 / ((Regval + samples) * divider).
46 */
47#define MLXREG_FAN_GET_RPM(rval, d, s) (DIV_ROUND_CLOSEST(15000000 * 100, \
48 ((rval) + (s)) * (d)))
49#define MLXREG_FAN_GET_FAULT(val, mask) ((val) == (mask))
50#define MLXREG_FAN_PWM_DUTY2STATE(duty) (DIV_ROUND_CLOSEST((duty) * \
51 MLXREG_FAN_MAX_STATE, \
52 MLXREG_FAN_MAX_DUTY))
53#define MLXREG_FAN_PWM_STATE2DUTY(stat) (DIV_ROUND_CLOSEST((stat) * \
54 MLXREG_FAN_MAX_DUTY, \
55 MLXREG_FAN_MAX_STATE))
56
57struct mlxreg_fan;
58
59/*
60 * struct mlxreg_fan_tacho - tachometer data (internal use):
61 *
62 * @connected: indicates if tachometer is connected;
63 * @reg: register offset;
64 * @mask: fault mask;
65 * @prsnt: present register offset;
66 */
67struct mlxreg_fan_tacho {
68 bool connected;
69 u32 reg;
70 u32 mask;
71 u32 prsnt;
72};
73
74/*
75 * struct mlxreg_fan_pwm - PWM data (internal use):
76 *
77 * @fan: private data;
78 * @connected: indicates if PWM is connected;
79 * @reg: register offset;
80 * @cooling: cooling device levels;
81 * @last_hwmon_state: last cooling state set by hwmon subsystem;
82 * @last_thermal_state: last cooling state set by thermal subsystem;
83 * @cdev: cooling device;
84 */
85struct mlxreg_fan_pwm {
86 struct mlxreg_fan *fan;
87 bool connected;
88 u32 reg;
89 unsigned long last_hwmon_state;
90 unsigned long last_thermal_state;
91 struct thermal_cooling_device *cdev;
92};
93
94/*
95 * struct mlxreg_fan - private data (internal use):
96 *
97 * @dev: basic device;
98 * @regmap: register map of parent device;
99 * @tacho: tachometer data;
100 * @pwm: PWM data;
101 * @tachos_per_drwr - number of tachometers per drawer;
102 * @samples: minimum allowed samples per pulse;
103 * @divider: divider value for tachometer RPM calculation;
104 */
105struct mlxreg_fan {
106 struct device *dev;
107 void *regmap;
108 struct mlxreg_core_platform_data *pdata;
109 struct mlxreg_fan_tacho tacho[MLXREG_FAN_MAX_TACHO];
110 struct mlxreg_fan_pwm pwm[MLXREG_FAN_MAX_PWM];
111 int tachos_per_drwr;
112 int samples;
113 int divider;
114};
115
116static int mlxreg_fan_set_cur_state(struct thermal_cooling_device *cdev,
117 unsigned long state);
118
119static int
120mlxreg_fan_read(struct device *dev, enum hwmon_sensor_types type, u32 attr,
121 int channel, long *val)
122{
123 struct mlxreg_fan *fan = dev_get_drvdata(dev);
124 struct mlxreg_fan_tacho *tacho;
125 struct mlxreg_fan_pwm *pwm;
126 u32 regval;
127 int err;
128
129 switch (type) {
130 case hwmon_fan:
131 tacho = &fan->tacho[channel];
132 switch (attr) {
133 case hwmon_fan_input:
134 /*
135 * Check FAN presence: FAN related bit in presence register is one,
136 * if FAN is physically connected, zero - otherwise.
137 */
138 if (tacho->prsnt && fan->tachos_per_drwr) {
139 err = regmap_read(fan->regmap, tacho->prsnt, ®val);
140 if (err)
141 return err;
142
143 /*
144 * Map channel to presence bit - drawer can be equipped with
145 * one or few FANs, while presence is indicated per drawer.
146 */
147 if (BIT(channel / fan->tachos_per_drwr) & regval) {
148 /* FAN is not connected - return zero for FAN speed. */
149 *val = 0;
150 return 0;
151 }
152 }
153
154 err = regmap_read(fan->regmap, tacho->reg, ®val);
155 if (err)
156 return err;
157
158 if (MLXREG_FAN_GET_FAULT(regval, tacho->mask)) {
159 /* FAN is broken - return zero for FAN speed. */
160 *val = 0;
161 return 0;
162 }
163
164 *val = MLXREG_FAN_GET_RPM(regval, fan->divider,
165 fan->samples);
166 break;
167
168 case hwmon_fan_fault:
169 err = regmap_read(fan->regmap, tacho->reg, ®val);
170 if (err)
171 return err;
172
173 *val = MLXREG_FAN_GET_FAULT(regval, tacho->mask);
174 break;
175
176 default:
177 return -EOPNOTSUPP;
178 }
179 break;
180
181 case hwmon_pwm:
182 pwm = &fan->pwm[channel];
183 switch (attr) {
184 case hwmon_pwm_input:
185 err = regmap_read(fan->regmap, pwm->reg, ®val);
186 if (err)
187 return err;
188
189 *val = regval;
190 break;
191
192 default:
193 return -EOPNOTSUPP;
194 }
195 break;
196
197 default:
198 return -EOPNOTSUPP;
199 }
200
201 return 0;
202}
203
204static int
205mlxreg_fan_write(struct device *dev, enum hwmon_sensor_types type, u32 attr,
206 int channel, long val)
207{
208 struct mlxreg_fan *fan = dev_get_drvdata(dev);
209 struct mlxreg_fan_pwm *pwm;
210
211 switch (type) {
212 case hwmon_pwm:
213 switch (attr) {
214 case hwmon_pwm_input:
215 if (val < MLXREG_FAN_MIN_DUTY ||
216 val > MLXREG_FAN_MAX_DUTY)
217 return -EINVAL;
218 pwm = &fan->pwm[channel];
219 /* If thermal is configured - handle PWM limit setting. */
220 if (IS_REACHABLE(CONFIG_THERMAL)) {
221 pwm->last_hwmon_state = MLXREG_FAN_PWM_DUTY2STATE(val);
222 /*
223 * Update PWM only in case requested state is not less than the
224 * last thermal state.
225 */
226 if (pwm->last_hwmon_state >= pwm->last_thermal_state)
227 return mlxreg_fan_set_cur_state(pwm->cdev,
228 pwm->last_hwmon_state);
229 return 0;
230 }
231 return regmap_write(fan->regmap, pwm->reg, val);
232 default:
233 return -EOPNOTSUPP;
234 }
235 break;
236
237 default:
238 return -EOPNOTSUPP;
239 }
240
241 return -EOPNOTSUPP;
242}
243
244static umode_t
245mlxreg_fan_is_visible(const void *data, enum hwmon_sensor_types type, u32 attr,
246 int channel)
247{
248 switch (type) {
249 case hwmon_fan:
250 if (!(((struct mlxreg_fan *)data)->tacho[channel].connected))
251 return 0;
252
253 switch (attr) {
254 case hwmon_fan_input:
255 case hwmon_fan_fault:
256 return 0444;
257 default:
258 break;
259 }
260 break;
261
262 case hwmon_pwm:
263 if (!(((struct mlxreg_fan *)data)->pwm[channel].connected))
264 return 0;
265
266 switch (attr) {
267 case hwmon_pwm_input:
268 return 0644;
269 default:
270 break;
271 }
272 break;
273
274 default:
275 break;
276 }
277
278 return 0;
279}
280
281static char *mlxreg_fan_name[] = {
282 "mlxreg_fan",
283 "mlxreg_fan1",
284 "mlxreg_fan2",
285 "mlxreg_fan3",
286};
287
288static const struct hwmon_channel_info * const mlxreg_fan_hwmon_info[] = {
289 HWMON_CHANNEL_INFO(fan,
290 HWMON_F_INPUT | HWMON_F_FAULT,
291 HWMON_F_INPUT | HWMON_F_FAULT,
292 HWMON_F_INPUT | HWMON_F_FAULT,
293 HWMON_F_INPUT | HWMON_F_FAULT,
294 HWMON_F_INPUT | HWMON_F_FAULT,
295 HWMON_F_INPUT | HWMON_F_FAULT,
296 HWMON_F_INPUT | HWMON_F_FAULT,
297 HWMON_F_INPUT | HWMON_F_FAULT,
298 HWMON_F_INPUT | HWMON_F_FAULT,
299 HWMON_F_INPUT | HWMON_F_FAULT,
300 HWMON_F_INPUT | HWMON_F_FAULT,
301 HWMON_F_INPUT | HWMON_F_FAULT,
302 HWMON_F_INPUT | HWMON_F_FAULT,
303 HWMON_F_INPUT | HWMON_F_FAULT,
304 HWMON_F_INPUT | HWMON_F_FAULT,
305 HWMON_F_INPUT | HWMON_F_FAULT,
306 HWMON_F_INPUT | HWMON_F_FAULT,
307 HWMON_F_INPUT | HWMON_F_FAULT,
308 HWMON_F_INPUT | HWMON_F_FAULT,
309 HWMON_F_INPUT | HWMON_F_FAULT,
310 HWMON_F_INPUT | HWMON_F_FAULT,
311 HWMON_F_INPUT | HWMON_F_FAULT,
312 HWMON_F_INPUT | HWMON_F_FAULT,
313 HWMON_F_INPUT | HWMON_F_FAULT),
314 HWMON_CHANNEL_INFO(pwm,
315 HWMON_PWM_INPUT,
316 HWMON_PWM_INPUT,
317 HWMON_PWM_INPUT,
318 HWMON_PWM_INPUT),
319 NULL
320};
321
322static const struct hwmon_ops mlxreg_fan_hwmon_hwmon_ops = {
323 .is_visible = mlxreg_fan_is_visible,
324 .read = mlxreg_fan_read,
325 .write = mlxreg_fan_write,
326};
327
328static const struct hwmon_chip_info mlxreg_fan_hwmon_chip_info = {
329 .ops = &mlxreg_fan_hwmon_hwmon_ops,
330 .info = mlxreg_fan_hwmon_info,
331};
332
333static int mlxreg_fan_get_max_state(struct thermal_cooling_device *cdev,
334 unsigned long *state)
335{
336 *state = MLXREG_FAN_MAX_STATE;
337 return 0;
338}
339
340static int mlxreg_fan_get_cur_state(struct thermal_cooling_device *cdev,
341 unsigned long *state)
342
343{
344 struct mlxreg_fan_pwm *pwm = cdev->devdata;
345 struct mlxreg_fan *fan = pwm->fan;
346 u32 regval;
347 int err;
348
349 err = regmap_read(fan->regmap, pwm->reg, ®val);
350 if (err) {
351 dev_err(fan->dev, "Failed to query PWM duty\n");
352 return err;
353 }
354
355 *state = MLXREG_FAN_PWM_DUTY2STATE(regval);
356
357 return 0;
358}
359
360static int mlxreg_fan_set_cur_state(struct thermal_cooling_device *cdev,
361 unsigned long state)
362
363{
364 struct mlxreg_fan_pwm *pwm = cdev->devdata;
365 struct mlxreg_fan *fan = pwm->fan;
366 int err;
367
368 if (state > MLXREG_FAN_MAX_STATE)
369 return -EINVAL;
370
371 /* Save thermal state. */
372 pwm->last_thermal_state = state;
373
374 state = max_t(unsigned long, state, pwm->last_hwmon_state);
375 err = regmap_write(fan->regmap, pwm->reg,
376 MLXREG_FAN_PWM_STATE2DUTY(state));
377 if (err) {
378 dev_err(fan->dev, "Failed to write PWM duty\n");
379 return err;
380 }
381 return 0;
382}
383
384static const struct thermal_cooling_device_ops mlxreg_fan_cooling_ops = {
385 .get_max_state = mlxreg_fan_get_max_state,
386 .get_cur_state = mlxreg_fan_get_cur_state,
387 .set_cur_state = mlxreg_fan_set_cur_state,
388};
389
390static int mlxreg_fan_connect_verify(struct mlxreg_fan *fan,
391 struct mlxreg_core_data *data)
392{
393 u32 regval;
394 int err;
395
396 err = regmap_read(fan->regmap, data->capability, ®val);
397 if (err) {
398 dev_err(fan->dev, "Failed to query capability register 0x%08x\n",
399 data->capability);
400 return err;
401 }
402
403 return !!(regval & data->bit);
404}
405
406static int mlxreg_pwm_connect_verify(struct mlxreg_fan *fan,
407 struct mlxreg_core_data *data)
408{
409 u32 regval;
410 int err;
411
412 err = regmap_read(fan->regmap, data->reg, ®val);
413 if (err) {
414 dev_err(fan->dev, "Failed to query pwm register 0x%08x\n",
415 data->reg);
416 return err;
417 }
418
419 return regval != MLXREG_FAN_PWM_NOT_CONNECTED;
420}
421
422static int mlxreg_fan_speed_divider_get(struct mlxreg_fan *fan,
423 struct mlxreg_core_data *data)
424{
425 u32 regval;
426 int err;
427
428 err = regmap_read(fan->regmap, data->capability, ®val);
429 if (err) {
430 dev_err(fan->dev, "Failed to query capability register 0x%08x\n",
431 data->capability);
432 return err;
433 }
434
435 /*
436 * Set divider value according to the capability register, in case it
437 * contains valid value. Otherwise use default value. The purpose of
438 * this validation is to protect against the old hardware, in which
439 * this register can return zero.
440 */
441 if (regval > 0 && regval <= MLXREG_FAN_TACHO_DIV_SCALE_MAX)
442 fan->divider = regval * MLXREG_FAN_TACHO_DIV_MIN;
443
444 return 0;
445}
446
447static int mlxreg_fan_config(struct mlxreg_fan *fan,
448 struct mlxreg_core_platform_data *pdata)
449{
450 int tacho_num = 0, tacho_avail = 0, pwm_num = 0, i;
451 struct mlxreg_core_data *data = pdata->data;
452 bool configured = false;
453 int err;
454
455 fan->samples = MLXREG_FAN_TACHO_SAMPLES_PER_PULSE_DEF;
456 fan->divider = MLXREG_FAN_TACHO_DIV_DEF;
457 for (i = 0; i < pdata->counter; i++, data++) {
458 if (strnstr(data->label, "tacho", sizeof(data->label))) {
459 if (tacho_num == MLXREG_FAN_MAX_TACHO) {
460 dev_err(fan->dev, "too many tacho entries: %s\n",
461 data->label);
462 return -EINVAL;
463 }
464
465 if (data->capability) {
466 err = mlxreg_fan_connect_verify(fan, data);
467 if (err < 0)
468 return err;
469 else if (!err) {
470 tacho_num++;
471 continue;
472 }
473 }
474
475 fan->tacho[tacho_num].reg = data->reg;
476 fan->tacho[tacho_num].mask = data->mask;
477 fan->tacho[tacho_num].prsnt = data->reg_prsnt;
478 fan->tacho[tacho_num++].connected = true;
479 tacho_avail++;
480 } else if (strnstr(data->label, "pwm", sizeof(data->label))) {
481 if (pwm_num == MLXREG_FAN_MAX_TACHO) {
482 dev_err(fan->dev, "too many pwm entries: %s\n",
483 data->label);
484 return -EINVAL;
485 }
486
487 /* Validate if more then one PWM is connected. */
488 if (pwm_num) {
489 err = mlxreg_pwm_connect_verify(fan, data);
490 if (err < 0)
491 return err;
492 else if (!err)
493 continue;
494 }
495
496 fan->pwm[pwm_num].reg = data->reg;
497 fan->pwm[pwm_num].connected = true;
498 pwm_num++;
499 } else if (strnstr(data->label, "conf", sizeof(data->label))) {
500 if (configured) {
501 dev_err(fan->dev, "duplicate conf entry: %s\n",
502 data->label);
503 return -EINVAL;
504 }
505 /* Validate that conf parameters are not zeros. */
506 if (!data->mask && !data->bit && !data->capability) {
507 dev_err(fan->dev, "invalid conf entry params: %s\n",
508 data->label);
509 return -EINVAL;
510 }
511 if (data->capability) {
512 err = mlxreg_fan_speed_divider_get(fan, data);
513 if (err)
514 return err;
515 } else {
516 if (data->mask)
517 fan->samples = data->mask;
518 if (data->bit)
519 fan->divider = data->bit;
520 }
521 configured = true;
522 } else {
523 dev_err(fan->dev, "invalid label: %s\n", data->label);
524 return -EINVAL;
525 }
526 }
527
528 if (pdata->capability) {
529 int drwr_avail;
530 u32 regval;
531
532 /* Obtain the number of FAN drawers, supported by system. */
533 err = regmap_read(fan->regmap, pdata->capability, ®val);
534 if (err) {
535 dev_err(fan->dev, "Failed to query capability register 0x%08x\n",
536 pdata->capability);
537 return err;
538 }
539
540 drwr_avail = hweight32(regval);
541 if (!tacho_avail || !drwr_avail || tacho_avail < drwr_avail) {
542 dev_err(fan->dev, "Configuration is invalid: drawers num %d tachos num %d\n",
543 drwr_avail, tacho_avail);
544 return -EINVAL;
545 }
546
547 /* Set the number of tachometers per one drawer. */
548 fan->tachos_per_drwr = tacho_avail / drwr_avail;
549 }
550
551 return 0;
552}
553
554static int mlxreg_fan_cooling_config(struct device *dev, struct mlxreg_fan *fan)
555{
556 int i;
557
558 for (i = 0; i < MLXREG_FAN_MAX_PWM; i++) {
559 struct mlxreg_fan_pwm *pwm = &fan->pwm[i];
560
561 if (!pwm->connected)
562 continue;
563 pwm->fan = fan;
564 pwm->cdev = devm_thermal_of_cooling_device_register(dev, NULL, mlxreg_fan_name[i],
565 pwm, &mlxreg_fan_cooling_ops);
566 if (IS_ERR(pwm->cdev)) {
567 dev_err(dev, "Failed to register cooling device\n");
568 return PTR_ERR(pwm->cdev);
569 }
570
571 /* Set minimal PWM speed. */
572 pwm->last_hwmon_state = MLXREG_FAN_PWM_DUTY2STATE(MLXREG_FAN_MIN_DUTY);
573 }
574
575 return 0;
576}
577
578static int mlxreg_fan_probe(struct platform_device *pdev)
579{
580 struct mlxreg_core_platform_data *pdata;
581 struct device *dev = &pdev->dev;
582 struct mlxreg_fan *fan;
583 struct device *hwm;
584 int err;
585
586 pdata = dev_get_platdata(dev);
587 if (!pdata) {
588 dev_err(dev, "Failed to get platform data.\n");
589 return -EINVAL;
590 }
591
592 fan = devm_kzalloc(dev, sizeof(*fan), GFP_KERNEL);
593 if (!fan)
594 return -ENOMEM;
595
596 fan->dev = dev;
597 fan->regmap = pdata->regmap;
598
599 err = mlxreg_fan_config(fan, pdata);
600 if (err)
601 return err;
602
603 hwm = devm_hwmon_device_register_with_info(dev, "mlxreg_fan",
604 fan,
605 &mlxreg_fan_hwmon_chip_info,
606 NULL);
607 if (IS_ERR(hwm)) {
608 dev_err(dev, "Failed to register hwmon device\n");
609 return PTR_ERR(hwm);
610 }
611
612 if (IS_REACHABLE(CONFIG_THERMAL))
613 err = mlxreg_fan_cooling_config(dev, fan);
614
615 return err;
616}
617
618static struct platform_driver mlxreg_fan_driver = {
619 .driver = {
620 .name = "mlxreg-fan",
621 },
622 .probe = mlxreg_fan_probe,
623};
624
625module_platform_driver(mlxreg_fan_driver);
626
627MODULE_AUTHOR("Vadim Pasternak <vadimp@mellanox.com>");
628MODULE_DESCRIPTION("Mellanox FAN driver");
629MODULE_LICENSE("GPL");
630MODULE_ALIAS("platform:mlxreg-fan");
1// SPDX-License-Identifier: (GPL-2.0 OR BSD-3-Clause)
2//
3// Copyright (c) 2018 Mellanox Technologies. All rights reserved.
4// Copyright (c) 2018 Vadim Pasternak <vadimp@mellanox.com>
5
6#include <linux/bitops.h>
7#include <linux/device.h>
8#include <linux/hwmon.h>
9#include <linux/module.h>
10#include <linux/platform_data/mlxreg.h>
11#include <linux/platform_device.h>
12#include <linux/regmap.h>
13#include <linux/thermal.h>
14
15#define MLXREG_FAN_MAX_TACHO 12
16#define MLXREG_FAN_MAX_STATE 10
17#define MLXREG_FAN_MIN_DUTY 51 /* 20% */
18#define MLXREG_FAN_MAX_DUTY 255 /* 100% */
19/*
20 * Minimum and maximum FAN allowed speed in percent: from 20% to 100%. Values
21 * MLXREG_FAN_MAX_STATE + x, where x is between 2 and 10 are used for
22 * setting FAN speed dynamic minimum. For example, if value is set to 14 (40%)
23 * cooling levels vector will be set to 4, 4, 4, 4, 4, 5, 6, 7, 8, 9, 10 to
24 * introduce PWM speed in percent: 40, 40, 40, 40, 40, 50, 60. 70, 80, 90, 100.
25 */
26#define MLXREG_FAN_SPEED_MIN (MLXREG_FAN_MAX_STATE + 2)
27#define MLXREG_FAN_SPEED_MAX (MLXREG_FAN_MAX_STATE * 2)
28#define MLXREG_FAN_SPEED_MIN_LEVEL 2 /* 20 percent */
29#define MLXREG_FAN_TACHO_SAMPLES_PER_PULSE_DEF 44
30#define MLXREG_FAN_TACHO_DIV_MIN 283
31#define MLXREG_FAN_TACHO_DIV_DEF (MLXREG_FAN_TACHO_DIV_MIN * 4)
32#define MLXREG_FAN_TACHO_DIV_SCALE_MAX 64
33/*
34 * FAN datasheet defines the formula for RPM calculations as RPM = 15/t-high.
35 * The logic in a programmable device measures the time t-high by sampling the
36 * tachometer every t-sample (with the default value 11.32 uS) and increment
37 * a counter (N) as long as the pulse has not change:
38 * RPM = 15 / (t-sample * (K + Regval)), where:
39 * Regval: is the value read from the programmable device register;
40 * - 0xff - represents tachometer fault;
41 * - 0xfe - represents tachometer minimum value , which is 4444 RPM;
42 * - 0x00 - represents tachometer maximum value , which is 300000 RPM;
43 * K: is 44 and it represents the minimum allowed samples per pulse;
44 * N: is equal K + Regval;
45 * In order to calculate RPM from the register value the following formula is
46 * used: RPM = 15 / ((Regval + K) * 11.32) * 10^(-6)), which in the
47 * default case is modified to:
48 * RPM = 15000000 * 100 / ((Regval + 44) * 1132);
49 * - for Regval 0x00, RPM will be 15000000 * 100 / (44 * 1132) = 30115;
50 * - for Regval 0xfe, RPM will be 15000000 * 100 / ((254 + 44) * 1132) = 4446;
51 * In common case the formula is modified to:
52 * RPM = 15000000 * 100 / ((Regval + samples) * divider).
53 */
54#define MLXREG_FAN_GET_RPM(rval, d, s) (DIV_ROUND_CLOSEST(15000000 * 100, \
55 ((rval) + (s)) * (d)))
56#define MLXREG_FAN_GET_FAULT(val, mask) ((val) == (mask))
57#define MLXREG_FAN_PWM_DUTY2STATE(duty) (DIV_ROUND_CLOSEST((duty) * \
58 MLXREG_FAN_MAX_STATE, \
59 MLXREG_FAN_MAX_DUTY))
60#define MLXREG_FAN_PWM_STATE2DUTY(stat) (DIV_ROUND_CLOSEST((stat) * \
61 MLXREG_FAN_MAX_DUTY, \
62 MLXREG_FAN_MAX_STATE))
63
64/*
65 * struct mlxreg_fan_tacho - tachometer data (internal use):
66 *
67 * @connected: indicates if tachometer is connected;
68 * @reg: register offset;
69 * @mask: fault mask;
70 * @prsnt: present register offset;
71 */
72struct mlxreg_fan_tacho {
73 bool connected;
74 u32 reg;
75 u32 mask;
76 u32 prsnt;
77};
78
79/*
80 * struct mlxreg_fan_pwm - PWM data (internal use):
81 *
82 * @connected: indicates if PWM is connected;
83 * @reg: register offset;
84 */
85struct mlxreg_fan_pwm {
86 bool connected;
87 u32 reg;
88};
89
90/*
91 * struct mlxreg_fan - private data (internal use):
92 *
93 * @dev: basic device;
94 * @regmap: register map of parent device;
95 * @tacho: tachometer data;
96 * @pwm: PWM data;
97 * @tachos_per_drwr - number of tachometers per drawer;
98 * @samples: minimum allowed samples per pulse;
99 * @divider: divider value for tachometer RPM calculation;
100 * @cooling: cooling device levels;
101 * @cdev: cooling device;
102 */
103struct mlxreg_fan {
104 struct device *dev;
105 void *regmap;
106 struct mlxreg_core_platform_data *pdata;
107 struct mlxreg_fan_tacho tacho[MLXREG_FAN_MAX_TACHO];
108 struct mlxreg_fan_pwm pwm;
109 int tachos_per_drwr;
110 int samples;
111 int divider;
112 u8 cooling_levels[MLXREG_FAN_MAX_STATE + 1];
113 struct thermal_cooling_device *cdev;
114};
115
116static int
117mlxreg_fan_read(struct device *dev, enum hwmon_sensor_types type, u32 attr,
118 int channel, long *val)
119{
120 struct mlxreg_fan *fan = dev_get_drvdata(dev);
121 struct mlxreg_fan_tacho *tacho;
122 u32 regval;
123 int err;
124
125 switch (type) {
126 case hwmon_fan:
127 tacho = &fan->tacho[channel];
128 switch (attr) {
129 case hwmon_fan_input:
130 /*
131 * Check FAN presence: FAN related bit in presence register is one,
132 * if FAN is physically connected, zero - otherwise.
133 */
134 if (tacho->prsnt && fan->tachos_per_drwr) {
135 err = regmap_read(fan->regmap, tacho->prsnt, ®val);
136 if (err)
137 return err;
138
139 /*
140 * Map channel to presence bit - drawer can be equipped with
141 * one or few FANs, while presence is indicated per drawer.
142 */
143 if (BIT(channel / fan->tachos_per_drwr) & regval) {
144 /* FAN is not connected - return zero for FAN speed. */
145 *val = 0;
146 return 0;
147 }
148 }
149
150 err = regmap_read(fan->regmap, tacho->reg, ®val);
151 if (err)
152 return err;
153
154 *val = MLXREG_FAN_GET_RPM(regval, fan->divider,
155 fan->samples);
156 break;
157
158 case hwmon_fan_fault:
159 err = regmap_read(fan->regmap, tacho->reg, ®val);
160 if (err)
161 return err;
162
163 *val = MLXREG_FAN_GET_FAULT(regval, tacho->mask);
164 break;
165
166 default:
167 return -EOPNOTSUPP;
168 }
169 break;
170
171 case hwmon_pwm:
172 switch (attr) {
173 case hwmon_pwm_input:
174 err = regmap_read(fan->regmap, fan->pwm.reg, ®val);
175 if (err)
176 return err;
177
178 *val = regval;
179 break;
180
181 default:
182 return -EOPNOTSUPP;
183 }
184 break;
185
186 default:
187 return -EOPNOTSUPP;
188 }
189
190 return 0;
191}
192
193static int
194mlxreg_fan_write(struct device *dev, enum hwmon_sensor_types type, u32 attr,
195 int channel, long val)
196{
197 struct mlxreg_fan *fan = dev_get_drvdata(dev);
198
199 switch (type) {
200 case hwmon_pwm:
201 switch (attr) {
202 case hwmon_pwm_input:
203 if (val < MLXREG_FAN_MIN_DUTY ||
204 val > MLXREG_FAN_MAX_DUTY)
205 return -EINVAL;
206 return regmap_write(fan->regmap, fan->pwm.reg, val);
207 default:
208 return -EOPNOTSUPP;
209 }
210 break;
211
212 default:
213 return -EOPNOTSUPP;
214 }
215
216 return -EOPNOTSUPP;
217}
218
219static umode_t
220mlxreg_fan_is_visible(const void *data, enum hwmon_sensor_types type, u32 attr,
221 int channel)
222{
223 switch (type) {
224 case hwmon_fan:
225 if (!(((struct mlxreg_fan *)data)->tacho[channel].connected))
226 return 0;
227
228 switch (attr) {
229 case hwmon_fan_input:
230 case hwmon_fan_fault:
231 return 0444;
232 default:
233 break;
234 }
235 break;
236
237 case hwmon_pwm:
238 if (!(((struct mlxreg_fan *)data)->pwm.connected))
239 return 0;
240
241 switch (attr) {
242 case hwmon_pwm_input:
243 return 0644;
244 default:
245 break;
246 }
247 break;
248
249 default:
250 break;
251 }
252
253 return 0;
254}
255
256static const struct hwmon_channel_info *mlxreg_fan_hwmon_info[] = {
257 HWMON_CHANNEL_INFO(fan,
258 HWMON_F_INPUT | HWMON_F_FAULT,
259 HWMON_F_INPUT | HWMON_F_FAULT,
260 HWMON_F_INPUT | HWMON_F_FAULT,
261 HWMON_F_INPUT | HWMON_F_FAULT,
262 HWMON_F_INPUT | HWMON_F_FAULT,
263 HWMON_F_INPUT | HWMON_F_FAULT,
264 HWMON_F_INPUT | HWMON_F_FAULT,
265 HWMON_F_INPUT | HWMON_F_FAULT,
266 HWMON_F_INPUT | HWMON_F_FAULT,
267 HWMON_F_INPUT | HWMON_F_FAULT,
268 HWMON_F_INPUT | HWMON_F_FAULT,
269 HWMON_F_INPUT | HWMON_F_FAULT),
270 HWMON_CHANNEL_INFO(pwm,
271 HWMON_PWM_INPUT),
272 NULL
273};
274
275static const struct hwmon_ops mlxreg_fan_hwmon_hwmon_ops = {
276 .is_visible = mlxreg_fan_is_visible,
277 .read = mlxreg_fan_read,
278 .write = mlxreg_fan_write,
279};
280
281static const struct hwmon_chip_info mlxreg_fan_hwmon_chip_info = {
282 .ops = &mlxreg_fan_hwmon_hwmon_ops,
283 .info = mlxreg_fan_hwmon_info,
284};
285
286static int mlxreg_fan_get_max_state(struct thermal_cooling_device *cdev,
287 unsigned long *state)
288{
289 *state = MLXREG_FAN_MAX_STATE;
290 return 0;
291}
292
293static int mlxreg_fan_get_cur_state(struct thermal_cooling_device *cdev,
294 unsigned long *state)
295
296{
297 struct mlxreg_fan *fan = cdev->devdata;
298 u32 regval;
299 int err;
300
301 err = regmap_read(fan->regmap, fan->pwm.reg, ®val);
302 if (err) {
303 dev_err(fan->dev, "Failed to query PWM duty\n");
304 return err;
305 }
306
307 *state = MLXREG_FAN_PWM_DUTY2STATE(regval);
308
309 return 0;
310}
311
312static int mlxreg_fan_set_cur_state(struct thermal_cooling_device *cdev,
313 unsigned long state)
314
315{
316 struct mlxreg_fan *fan = cdev->devdata;
317 unsigned long cur_state;
318 int i, config = 0;
319 u32 regval;
320 int err;
321
322 /*
323 * Verify if this request is for changing allowed FAN dynamical
324 * minimum. If it is - update cooling levels accordingly and update
325 * state, if current state is below the newly requested minimum state.
326 * For example, if current state is 5, and minimal state is to be
327 * changed from 4 to 6, fan->cooling_levels[0 to 5] will be changed all
328 * from 4 to 6. And state 5 (fan->cooling_levels[4]) should be
329 * overwritten.
330 */
331 if (state >= MLXREG_FAN_SPEED_MIN && state <= MLXREG_FAN_SPEED_MAX) {
332 /*
333 * This is configuration change, which is only supported through sysfs.
334 * For configuration non-zero value is to be returned to avoid thermal
335 * statistics update.
336 */
337 config = 1;
338 state -= MLXREG_FAN_MAX_STATE;
339 for (i = 0; i < state; i++)
340 fan->cooling_levels[i] = state;
341 for (i = state; i <= MLXREG_FAN_MAX_STATE; i++)
342 fan->cooling_levels[i] = i;
343
344 err = regmap_read(fan->regmap, fan->pwm.reg, ®val);
345 if (err) {
346 dev_err(fan->dev, "Failed to query PWM duty\n");
347 return err;
348 }
349
350 cur_state = MLXREG_FAN_PWM_DUTY2STATE(regval);
351 if (state < cur_state)
352 return config;
353
354 state = cur_state;
355 }
356
357 if (state > MLXREG_FAN_MAX_STATE)
358 return -EINVAL;
359
360 /* Normalize the state to the valid speed range. */
361 state = fan->cooling_levels[state];
362 err = regmap_write(fan->regmap, fan->pwm.reg,
363 MLXREG_FAN_PWM_STATE2DUTY(state));
364 if (err) {
365 dev_err(fan->dev, "Failed to write PWM duty\n");
366 return err;
367 }
368 return config;
369}
370
371static const struct thermal_cooling_device_ops mlxreg_fan_cooling_ops = {
372 .get_max_state = mlxreg_fan_get_max_state,
373 .get_cur_state = mlxreg_fan_get_cur_state,
374 .set_cur_state = mlxreg_fan_set_cur_state,
375};
376
377static int mlxreg_fan_connect_verify(struct mlxreg_fan *fan,
378 struct mlxreg_core_data *data)
379{
380 u32 regval;
381 int err;
382
383 err = regmap_read(fan->regmap, data->capability, ®val);
384 if (err) {
385 dev_err(fan->dev, "Failed to query capability register 0x%08x\n",
386 data->capability);
387 return err;
388 }
389
390 return !!(regval & data->bit);
391}
392
393static int mlxreg_fan_speed_divider_get(struct mlxreg_fan *fan,
394 struct mlxreg_core_data *data)
395{
396 u32 regval;
397 int err;
398
399 err = regmap_read(fan->regmap, data->capability, ®val);
400 if (err) {
401 dev_err(fan->dev, "Failed to query capability register 0x%08x\n",
402 data->capability);
403 return err;
404 }
405
406 /*
407 * Set divider value according to the capability register, in case it
408 * contains valid value. Otherwise use default value. The purpose of
409 * this validation is to protect against the old hardware, in which
410 * this register can return zero.
411 */
412 if (regval > 0 && regval <= MLXREG_FAN_TACHO_DIV_SCALE_MAX)
413 fan->divider = regval * MLXREG_FAN_TACHO_DIV_MIN;
414
415 return 0;
416}
417
418static int mlxreg_fan_config(struct mlxreg_fan *fan,
419 struct mlxreg_core_platform_data *pdata)
420{
421 struct mlxreg_core_data *data = pdata->data;
422 int tacho_num = 0, tacho_avail = 0, i;
423 bool configured = false;
424 int err;
425
426 fan->samples = MLXREG_FAN_TACHO_SAMPLES_PER_PULSE_DEF;
427 fan->divider = MLXREG_FAN_TACHO_DIV_DEF;
428 for (i = 0; i < pdata->counter; i++, data++) {
429 if (strnstr(data->label, "tacho", sizeof(data->label))) {
430 if (tacho_num == MLXREG_FAN_MAX_TACHO) {
431 dev_err(fan->dev, "too many tacho entries: %s\n",
432 data->label);
433 return -EINVAL;
434 }
435
436 if (data->capability) {
437 err = mlxreg_fan_connect_verify(fan, data);
438 if (err < 0)
439 return err;
440 else if (!err) {
441 tacho_num++;
442 continue;
443 }
444 }
445
446 fan->tacho[tacho_num].reg = data->reg;
447 fan->tacho[tacho_num].mask = data->mask;
448 fan->tacho[tacho_num].prsnt = data->reg_prsnt;
449 fan->tacho[tacho_num++].connected = true;
450 tacho_avail++;
451 } else if (strnstr(data->label, "pwm", sizeof(data->label))) {
452 if (fan->pwm.connected) {
453 dev_err(fan->dev, "duplicate pwm entry: %s\n",
454 data->label);
455 return -EINVAL;
456 }
457 fan->pwm.reg = data->reg;
458 fan->pwm.connected = true;
459 } else if (strnstr(data->label, "conf", sizeof(data->label))) {
460 if (configured) {
461 dev_err(fan->dev, "duplicate conf entry: %s\n",
462 data->label);
463 return -EINVAL;
464 }
465 /* Validate that conf parameters are not zeros. */
466 if (!data->mask && !data->bit && !data->capability) {
467 dev_err(fan->dev, "invalid conf entry params: %s\n",
468 data->label);
469 return -EINVAL;
470 }
471 if (data->capability) {
472 err = mlxreg_fan_speed_divider_get(fan, data);
473 if (err)
474 return err;
475 } else {
476 if (data->mask)
477 fan->samples = data->mask;
478 if (data->bit)
479 fan->divider = data->bit;
480 }
481 configured = true;
482 } else {
483 dev_err(fan->dev, "invalid label: %s\n", data->label);
484 return -EINVAL;
485 }
486 }
487
488 if (pdata->capability) {
489 int drwr_avail;
490 u32 regval;
491
492 /* Obtain the number of FAN drawers, supported by system. */
493 err = regmap_read(fan->regmap, pdata->capability, ®val);
494 if (err) {
495 dev_err(fan->dev, "Failed to query capability register 0x%08x\n",
496 pdata->capability);
497 return err;
498 }
499
500 drwr_avail = hweight32(regval);
501 if (!tacho_avail || !drwr_avail || tacho_avail < drwr_avail) {
502 dev_err(fan->dev, "Configuration is invalid: drawers num %d tachos num %d\n",
503 drwr_avail, tacho_avail);
504 return -EINVAL;
505 }
506
507 /* Set the number of tachometers per one drawer. */
508 fan->tachos_per_drwr = tacho_avail / drwr_avail;
509 }
510
511 /* Init cooling levels per PWM state. */
512 for (i = 0; i < MLXREG_FAN_SPEED_MIN_LEVEL; i++)
513 fan->cooling_levels[i] = MLXREG_FAN_SPEED_MIN_LEVEL;
514 for (i = MLXREG_FAN_SPEED_MIN_LEVEL; i <= MLXREG_FAN_MAX_STATE; i++)
515 fan->cooling_levels[i] = i;
516
517 return 0;
518}
519
520static int mlxreg_fan_probe(struct platform_device *pdev)
521{
522 struct mlxreg_core_platform_data *pdata;
523 struct device *dev = &pdev->dev;
524 struct mlxreg_fan *fan;
525 struct device *hwm;
526 int err;
527
528 pdata = dev_get_platdata(dev);
529 if (!pdata) {
530 dev_err(dev, "Failed to get platform data.\n");
531 return -EINVAL;
532 }
533
534 fan = devm_kzalloc(dev, sizeof(*fan), GFP_KERNEL);
535 if (!fan)
536 return -ENOMEM;
537
538 fan->dev = dev;
539 fan->regmap = pdata->regmap;
540
541 err = mlxreg_fan_config(fan, pdata);
542 if (err)
543 return err;
544
545 hwm = devm_hwmon_device_register_with_info(dev, "mlxreg_fan",
546 fan,
547 &mlxreg_fan_hwmon_chip_info,
548 NULL);
549 if (IS_ERR(hwm)) {
550 dev_err(dev, "Failed to register hwmon device\n");
551 return PTR_ERR(hwm);
552 }
553
554 if (IS_REACHABLE(CONFIG_THERMAL)) {
555 fan->cdev = devm_thermal_of_cooling_device_register(dev,
556 NULL, "mlxreg_fan", fan, &mlxreg_fan_cooling_ops);
557 if (IS_ERR(fan->cdev)) {
558 dev_err(dev, "Failed to register cooling device\n");
559 return PTR_ERR(fan->cdev);
560 }
561 }
562
563 return 0;
564}
565
566static struct platform_driver mlxreg_fan_driver = {
567 .driver = {
568 .name = "mlxreg-fan",
569 },
570 .probe = mlxreg_fan_probe,
571};
572
573module_platform_driver(mlxreg_fan_driver);
574
575MODULE_AUTHOR("Vadim Pasternak <vadimp@mellanox.com>");
576MODULE_DESCRIPTION("Mellanox FAN driver");
577MODULE_LICENSE("GPL");
578MODULE_ALIAS("platform:mlxreg-fan");