xref: /linux/drivers/thermal/thermal_debugfs.c (revision e6a901a00822659181c93c86d8bbc2a17779fddc)
1 // SPDX-License-Identifier: GPL-2.0
2 /*
3  * Copyright 2023 Linaro Limited
4  *
5  * Author: Daniel Lezcano <daniel.lezcano@linaro.org>
6  *
7  * Thermal subsystem debug support
8  */
9 #include <linux/debugfs.h>
10 #include <linux/ktime.h>
11 #include <linux/list.h>
12 #include <linux/minmax.h>
13 #include <linux/mutex.h>
14 #include <linux/thermal.h>
15 
16 #include "thermal_core.h"
17 
18 static struct dentry *d_root;
19 static struct dentry *d_cdev;
20 static struct dentry *d_tz;
21 
22 /*
23  * Length of the string containing the thermal zone id or the cooling
24  * device id, including the ending nul character. We can reasonably
25  * assume there won't be more than 256 thermal zones as the maximum
26  * observed today is around 32.
27  */
28 #define IDSLENGTH 4
29 
30 /*
31  * The cooling device transition list is stored in a hash table where
32  * the size is CDEVSTATS_HASH_SIZE. The majority of cooling devices
33  * have dozen of states but some can have much more, so a hash table
34  * is more adequate in this case, because the cost of browsing the entire
35  * list when storing the transitions may not be negligible.
36  */
37 #define CDEVSTATS_HASH_SIZE 16
38 
39 /**
40  * struct cdev_debugfs - per cooling device statistics structure
41  * A cooling device can have a high number of states. Showing the
42  * transitions on a matrix based representation can be overkill given
43  * most of the transitions won't happen and we end up with a matrix
44  * filled with zero. Instead, we show the transitions which actually
45  * happened.
46  *
47  * Every transition updates the current_state and the timestamp. The
48  * transitions and the durations are stored in lists.
49  *
50  * @total: the number of transitions for this cooling device
51  * @current_state: the current cooling device state
52  * @timestamp: the state change timestamp
53  * @transitions: an array of lists containing the state transitions
54  * @durations: an array of lists containing the residencies of each state
55  */
56 struct cdev_debugfs {
57 	u32 total;
58 	int current_state;
59 	ktime_t timestamp;
60 	struct list_head transitions[CDEVSTATS_HASH_SIZE];
61 	struct list_head durations[CDEVSTATS_HASH_SIZE];
62 };
63 
64 /**
65  * struct cdev_record - Common structure for cooling device entry
66  *
67  * The following common structure allows to store the information
68  * related to the transitions and to the state residencies. They are
69  * identified with a id which is associated to a value. It is used as
70  * nodes for the "transitions" and "durations" above.
71  *
72  * @node: node to insert the structure in a list
73  * @id: identifier of the value which can be a state or a transition
74  * @residency: a ktime_t representing a state residency duration
75  * @count: a number of occurrences
76  */
77 struct cdev_record {
78 	struct list_head node;
79 	int id;
80 	union {
81                 ktime_t residency;
82                 u64 count;
83         };
84 };
85 
86 /**
87  * struct trip_stats - Thermal trip statistics
88  *
89  * The trip_stats structure has the relevant information to show the
90  * statistics related to temperature going above a trip point.
91  *
92  * @timestamp: the trip crossing timestamp
93  * @duration: total time when the zone temperature was above the trip point
94  * @count: the number of times the zone temperature was above the trip point
95  * @max: maximum recorded temperature above the trip point
96  * @min: minimum recorded temperature above the trip point
97  * @avg: average temperature above the trip point
98  */
99 struct trip_stats {
100 	ktime_t timestamp;
101 	ktime_t duration;
102 	int count;
103 	int max;
104 	int min;
105 	int avg;
106 };
107 
108 /**
109  * struct tz_episode - A mitigation episode information
110  *
111  * The tz_episode structure describes a mitigation episode. A
112  * mitigation episode begins the trip point with the lower temperature
113  * is crossed the way up and ends when it is crossed the way
114  * down. During this episode we can have multiple trip points crossed
115  * the way up and down if there are multiple trip described in the
116  * firmware after the lowest temperature trip point.
117  *
118  * @timestamp: first trip point crossed the way up
119  * @duration: total duration of the mitigation episode
120  * @node: a list element to be added to the list of tz events
121  * @trip_stats: per trip point statistics, flexible array
122  */
123 struct tz_episode {
124 	ktime_t timestamp;
125 	ktime_t duration;
126 	struct list_head node;
127 	struct trip_stats trip_stats[];
128 };
129 
130 /**
131  * struct tz_debugfs - Store all mitigation episodes for a thermal zone
132  *
133  * The tz_debugfs structure contains the list of the mitigation
134  * episodes and has to track which trip point has been crossed in
135  * order to handle correctly nested trip point mitigation episodes.
136  *
137  * We keep the history of the trip point crossed in an array and as we
138  * can go back and forth inside this history, eg. trip 0,1,2,1,2,1,0,
139  * we keep track of the current position in the history array.
140  *
141  * @tz_episodes: a list of thermal mitigation episodes
142  * @trips_crossed: an array of trip points crossed by id
143  * @nr_trips: the number of trip points currently being crossed
144  */
145 struct tz_debugfs {
146 	struct list_head tz_episodes;
147 	int *trips_crossed;
148 	int nr_trips;
149 };
150 
151 /**
152  * struct thermal_debugfs - High level structure for a thermal object in debugfs
153  *
154  * The thermal_debugfs structure is the common structure used by the
155  * cooling device or the thermal zone to store the statistics.
156  *
157  * @d_top: top directory of the thermal object directory
158  * @lock: per object lock to protect the internals
159  *
160  * @cdev_dbg: a cooling device debug structure
161  * @tz_dbg: a thermal zone debug structure
162  */
163 struct thermal_debugfs {
164 	struct dentry *d_top;
165 	struct mutex lock;
166 	union {
167 		struct cdev_debugfs cdev_dbg;
168 		struct tz_debugfs tz_dbg;
169 	};
170 };
171 
172 void thermal_debug_init(void)
173 {
174 	d_root = debugfs_create_dir("thermal", NULL);
175 	if (!d_root)
176 		return;
177 
178 	d_cdev = debugfs_create_dir("cooling_devices", d_root);
179 	if (!d_cdev)
180 		return;
181 
182 	d_tz = debugfs_create_dir("thermal_zones", d_root);
183 }
184 
185 static struct thermal_debugfs *thermal_debugfs_add_id(struct dentry *d, int id)
186 {
187 	struct thermal_debugfs *thermal_dbg;
188 	char ids[IDSLENGTH];
189 
190 	thermal_dbg = kzalloc(sizeof(*thermal_dbg), GFP_KERNEL);
191 	if (!thermal_dbg)
192 		return NULL;
193 
194 	mutex_init(&thermal_dbg->lock);
195 
196 	snprintf(ids, IDSLENGTH, "%d", id);
197 
198 	thermal_dbg->d_top = debugfs_create_dir(ids, d);
199 	if (!thermal_dbg->d_top) {
200 		kfree(thermal_dbg);
201 		return NULL;
202 	}
203 
204 	return thermal_dbg;
205 }
206 
207 static void thermal_debugfs_remove_id(struct thermal_debugfs *thermal_dbg)
208 {
209 	if (!thermal_dbg)
210 		return;
211 
212 	debugfs_remove(thermal_dbg->d_top);
213 
214 	kfree(thermal_dbg);
215 }
216 
217 static struct cdev_record *
218 thermal_debugfs_cdev_record_alloc(struct thermal_debugfs *thermal_dbg,
219 				  struct list_head *lists, int id)
220 {
221 	struct cdev_record *cdev_record;
222 
223 	cdev_record = kzalloc(sizeof(*cdev_record), GFP_KERNEL);
224 	if (!cdev_record)
225 		return NULL;
226 
227 	cdev_record->id = id;
228 	INIT_LIST_HEAD(&cdev_record->node);
229 	list_add_tail(&cdev_record->node,
230 		      &lists[cdev_record->id % CDEVSTATS_HASH_SIZE]);
231 
232 	return cdev_record;
233 }
234 
235 static struct cdev_record *
236 thermal_debugfs_cdev_record_find(struct thermal_debugfs *thermal_dbg,
237 				 struct list_head *lists, int id)
238 {
239 	struct cdev_record *entry;
240 
241 	list_for_each_entry(entry, &lists[id % CDEVSTATS_HASH_SIZE], node)
242 		if (entry->id == id)
243 			return entry;
244 
245 	return NULL;
246 }
247 
248 static struct cdev_record *
249 thermal_debugfs_cdev_record_get(struct thermal_debugfs *thermal_dbg,
250 				struct list_head *lists, int id)
251 {
252 	struct cdev_record *cdev_record;
253 
254 	cdev_record = thermal_debugfs_cdev_record_find(thermal_dbg, lists, id);
255 	if (cdev_record)
256 		return cdev_record;
257 
258 	return thermal_debugfs_cdev_record_alloc(thermal_dbg, lists, id);
259 }
260 
261 static void thermal_debugfs_cdev_clear(struct cdev_debugfs *cdev_dbg)
262 {
263 	int i;
264 	struct cdev_record *entry, *tmp;
265 
266 	for (i = 0; i < CDEVSTATS_HASH_SIZE; i++) {
267 
268 		list_for_each_entry_safe(entry, tmp,
269 					 &cdev_dbg->transitions[i], node) {
270 			list_del(&entry->node);
271 			kfree(entry);
272 		}
273 
274 		list_for_each_entry_safe(entry, tmp,
275 					 &cdev_dbg->durations[i], node) {
276 			list_del(&entry->node);
277 			kfree(entry);
278 		}
279 	}
280 
281 	cdev_dbg->total = 0;
282 }
283 
284 static void *cdev_seq_start(struct seq_file *s, loff_t *pos)
285 {
286 	struct thermal_debugfs *thermal_dbg = s->private;
287 
288 	mutex_lock(&thermal_dbg->lock);
289 
290 	return (*pos < CDEVSTATS_HASH_SIZE) ? pos : NULL;
291 }
292 
293 static void *cdev_seq_next(struct seq_file *s, void *v, loff_t *pos)
294 {
295 	(*pos)++;
296 
297 	return (*pos < CDEVSTATS_HASH_SIZE) ? pos : NULL;
298 }
299 
300 static void cdev_seq_stop(struct seq_file *s, void *v)
301 {
302 	struct thermal_debugfs *thermal_dbg = s->private;
303 
304 	mutex_unlock(&thermal_dbg->lock);
305 }
306 
307 static int cdev_tt_seq_show(struct seq_file *s, void *v)
308 {
309 	struct thermal_debugfs *thermal_dbg = s->private;
310 	struct cdev_debugfs *cdev_dbg = &thermal_dbg->cdev_dbg;
311 	struct list_head *transitions = cdev_dbg->transitions;
312 	struct cdev_record *entry;
313 	int i = *(loff_t *)v;
314 
315 	if (!i)
316 		seq_puts(s, "Transition\tOccurences\n");
317 
318 	list_for_each_entry(entry, &transitions[i], node) {
319 		/*
320 		 * Assuming maximum cdev states is 1024, the longer
321 		 * string for a transition would be "1024->1024\0"
322 		 */
323 		char buffer[11];
324 
325 		snprintf(buffer, ARRAY_SIZE(buffer), "%d->%d",
326 			 entry->id >> 16, entry->id & 0xFFFF);
327 
328 		seq_printf(s, "%-10s\t%-10llu\n", buffer, entry->count);
329 	}
330 
331 	return 0;
332 }
333 
334 static const struct seq_operations tt_sops = {
335 	.start = cdev_seq_start,
336 	.next = cdev_seq_next,
337 	.stop = cdev_seq_stop,
338 	.show = cdev_tt_seq_show,
339 };
340 
341 DEFINE_SEQ_ATTRIBUTE(tt);
342 
343 static int cdev_dt_seq_show(struct seq_file *s, void *v)
344 {
345 	struct thermal_debugfs *thermal_dbg = s->private;
346 	struct cdev_debugfs *cdev_dbg = &thermal_dbg->cdev_dbg;
347 	struct list_head *durations = cdev_dbg->durations;
348 	struct cdev_record *entry;
349 	int i = *(loff_t *)v;
350 
351 	if (!i)
352 		seq_puts(s, "State\tResidency\n");
353 
354 	list_for_each_entry(entry, &durations[i], node) {
355 		s64 duration = ktime_to_ms(entry->residency);
356 
357 		if (entry->id == cdev_dbg->current_state)
358 			duration += ktime_ms_delta(ktime_get(),
359 						   cdev_dbg->timestamp);
360 
361 		seq_printf(s, "%-5d\t%-10llu\n", entry->id, duration);
362 	}
363 
364 	return 0;
365 }
366 
367 static const struct seq_operations dt_sops = {
368 	.start = cdev_seq_start,
369 	.next = cdev_seq_next,
370 	.stop = cdev_seq_stop,
371 	.show = cdev_dt_seq_show,
372 };
373 
374 DEFINE_SEQ_ATTRIBUTE(dt);
375 
376 static int cdev_clear_set(void *data, u64 val)
377 {
378 	struct thermal_debugfs *thermal_dbg = data;
379 
380 	if (!val)
381 		return -EINVAL;
382 
383 	mutex_lock(&thermal_dbg->lock);
384 
385 	thermal_debugfs_cdev_clear(&thermal_dbg->cdev_dbg);
386 
387 	mutex_unlock(&thermal_dbg->lock);
388 
389 	return 0;
390 }
391 
392 DEFINE_DEBUGFS_ATTRIBUTE(cdev_clear_fops, NULL, cdev_clear_set, "%llu\n");
393 
394 /**
395  * thermal_debug_cdev_state_update - Update a cooling device state change
396  *
397  * Computes a transition and the duration of the previous state residency.
398  *
399  * @cdev : a pointer to a cooling device
400  * @new_state: an integer corresponding to the new cooling device state
401  */
402 void thermal_debug_cdev_state_update(const struct thermal_cooling_device *cdev,
403 				     int new_state)
404 {
405 	struct thermal_debugfs *thermal_dbg = cdev->debugfs;
406 	struct cdev_debugfs *cdev_dbg;
407 	struct cdev_record *cdev_record;
408 	int transition, old_state;
409 
410 	if (!thermal_dbg || (thermal_dbg->cdev_dbg.current_state == new_state))
411 		return;
412 
413 	mutex_lock(&thermal_dbg->lock);
414 
415 	cdev_dbg = &thermal_dbg->cdev_dbg;
416 
417 	old_state = cdev_dbg->current_state;
418 
419 	/*
420 	 * Get the old state information in the durations list. If
421 	 * this one does not exist, a new allocated one will be
422 	 * returned. Recompute the total duration in the old state and
423 	 * get a new timestamp for the new state.
424 	 */
425 	cdev_record = thermal_debugfs_cdev_record_get(thermal_dbg,
426 						      cdev_dbg->durations,
427 						      old_state);
428 	if (cdev_record) {
429 		ktime_t now = ktime_get();
430 		ktime_t delta = ktime_sub(now, cdev_dbg->timestamp);
431 		cdev_record->residency = ktime_add(cdev_record->residency, delta);
432 		cdev_dbg->timestamp = now;
433 	}
434 
435 	cdev_dbg->current_state = new_state;
436 	transition = (old_state << 16) | new_state;
437 
438 	/*
439 	 * Get the transition in the transitions list. If this one
440 	 * does not exist, a new allocated one will be returned.
441 	 * Increment the occurrence of this transition which is stored
442 	 * in the value field.
443 	 */
444 	cdev_record = thermal_debugfs_cdev_record_get(thermal_dbg,
445 						      cdev_dbg->transitions,
446 						      transition);
447 	if (cdev_record)
448 		cdev_record->count++;
449 
450 	cdev_dbg->total++;
451 
452 	mutex_unlock(&thermal_dbg->lock);
453 }
454 
455 /**
456  * thermal_debug_cdev_add - Add a cooling device debugfs entry
457  *
458  * Allocates a cooling device object for debug, initializes the
459  * statistics and create the entries in sysfs.
460  * @cdev: a pointer to a cooling device
461  */
462 void thermal_debug_cdev_add(struct thermal_cooling_device *cdev)
463 {
464 	struct thermal_debugfs *thermal_dbg;
465 	struct cdev_debugfs *cdev_dbg;
466 	int i;
467 
468 	thermal_dbg = thermal_debugfs_add_id(d_cdev, cdev->id);
469 	if (!thermal_dbg)
470 		return;
471 
472 	cdev_dbg = &thermal_dbg->cdev_dbg;
473 
474 	for (i = 0; i < CDEVSTATS_HASH_SIZE; i++) {
475 		INIT_LIST_HEAD(&cdev_dbg->transitions[i]);
476 		INIT_LIST_HEAD(&cdev_dbg->durations[i]);
477 	}
478 
479 	cdev_dbg->current_state = 0;
480 	cdev_dbg->timestamp = ktime_get();
481 
482 	debugfs_create_file("trans_table", 0400, thermal_dbg->d_top,
483 			    thermal_dbg, &tt_fops);
484 
485 	debugfs_create_file("time_in_state_ms", 0400, thermal_dbg->d_top,
486 			    thermal_dbg, &dt_fops);
487 
488 	debugfs_create_file("clear", 0200, thermal_dbg->d_top,
489 			    thermal_dbg, &cdev_clear_fops);
490 
491 	debugfs_create_u32("total_trans", 0400, thermal_dbg->d_top,
492 			   &cdev_dbg->total);
493 
494 	cdev->debugfs = thermal_dbg;
495 }
496 
497 /**
498  * thermal_debug_cdev_remove - Remove a cooling device debugfs entry
499  *
500  * Frees the statistics memory data and remove the debugfs entry
501  *
502  * @cdev: a pointer to a cooling device
503  */
504 void thermal_debug_cdev_remove(struct thermal_cooling_device *cdev)
505 {
506 	struct thermal_debugfs *thermal_dbg = cdev->debugfs;
507 
508 	if (!thermal_dbg)
509 		return;
510 
511 	mutex_lock(&thermal_dbg->lock);
512 
513 	thermal_debugfs_cdev_clear(&thermal_dbg->cdev_dbg);
514 	cdev->debugfs = NULL;
515 
516 	mutex_unlock(&thermal_dbg->lock);
517 
518 	thermal_debugfs_remove_id(thermal_dbg);
519 }
520 
521 static struct tz_episode *thermal_debugfs_tz_event_alloc(struct thermal_zone_device *tz,
522 							ktime_t now)
523 {
524 	struct tz_episode *tze;
525 	int i;
526 
527 	tze = kzalloc(struct_size(tze, trip_stats, tz->num_trips), GFP_KERNEL);
528 	if (!tze)
529 		return NULL;
530 
531 	INIT_LIST_HEAD(&tze->node);
532 	tze->timestamp = now;
533 
534 	for (i = 0; i < tz->num_trips; i++) {
535 		tze->trip_stats[i].min = INT_MAX;
536 		tze->trip_stats[i].max = INT_MIN;
537 	}
538 
539 	return tze;
540 }
541 
542 void thermal_debug_tz_trip_up(struct thermal_zone_device *tz,
543 			      const struct thermal_trip *trip)
544 {
545 	struct tz_episode *tze;
546 	struct tz_debugfs *tz_dbg;
547 	struct thermal_debugfs *thermal_dbg = tz->debugfs;
548 	int temperature = tz->temperature;
549 	int trip_id = thermal_zone_trip_id(tz, trip);
550 	ktime_t now = ktime_get();
551 
552 	if (!thermal_dbg)
553 		return;
554 
555 	mutex_lock(&thermal_dbg->lock);
556 
557 	tz_dbg = &thermal_dbg->tz_dbg;
558 
559 	/*
560 	 * The mitigation is starting. A mitigation can contain
561 	 * several episodes where each of them is related to a
562 	 * temperature crossing a trip point. The episodes are
563 	 * nested. That means when the temperature is crossing the
564 	 * first trip point, the duration begins to be measured. If
565 	 * the temperature continues to increase and reaches the
566 	 * second trip point, the duration of the first trip must be
567 	 * also accumulated.
568 	 *
569 	 * eg.
570 	 *
571 	 * temp
572 	 *   ^
573 	 *   |             --------
574 	 * trip 2         /        \         ------
575 	 *   |           /|        |\      /|      |\
576 	 * trip 1       / |        | `----  |      | \
577 	 *   |         /| |        |        |      | |\
578 	 * trip 0     / | |        |        |      | | \
579 	 *   |       /| | |        |        |      | | |\
580 	 *   |      / | | |        |        |      | | | `--
581 	 *   |     /  | | |        |        |      | | |
582 	 *   |-----   | | |        |        |      | | |
583 	 *   |        | | |        |        |      | | |
584 	 *    --------|-|-|--------|--------|------|-|-|------------------> time
585 	 *            | | |<--t2-->|        |<-t2'>| | |
586 	 *            | |                            | |
587 	 *            | |<------------t1------------>| |
588 	 *            |                                |
589 	 *            |<-------------t0--------------->|
590 	 *
591 	 */
592 	if (!tz_dbg->nr_trips) {
593 		tze = thermal_debugfs_tz_event_alloc(tz, now);
594 		if (!tze)
595 			goto unlock;
596 
597 		list_add(&tze->node, &tz_dbg->tz_episodes);
598 	}
599 
600 	/*
601 	 * Each time a trip point is crossed the way up, the trip_id
602 	 * is stored in the trip_crossed array and the nr_trips is
603 	 * incremented. A nr_trips equal to zero means we are entering
604 	 * a mitigation episode.
605 	 *
606 	 * The trip ids may not be in the ascending order but the
607 	 * result in the array trips_crossed will be in the ascending
608 	 * temperature order. The function detecting when a trip point
609 	 * is crossed the way down will handle the very rare case when
610 	 * the trip points may have been reordered during this
611 	 * mitigation episode.
612 	 */
613 	tz_dbg->trips_crossed[tz_dbg->nr_trips++] = trip_id;
614 
615 	tze = list_first_entry(&tz_dbg->tz_episodes, struct tz_episode, node);
616 	tze->trip_stats[trip_id].timestamp = now;
617 	tze->trip_stats[trip_id].max = max(tze->trip_stats[trip_id].max, temperature);
618 	tze->trip_stats[trip_id].min = min(tze->trip_stats[trip_id].min, temperature);
619 	tze->trip_stats[trip_id].count++;
620 	tze->trip_stats[trip_id].avg = tze->trip_stats[trip_id].avg +
621 		(temperature - tze->trip_stats[trip_id].avg) /
622 		tze->trip_stats[trip_id].count;
623 
624 unlock:
625 	mutex_unlock(&thermal_dbg->lock);
626 }
627 
628 void thermal_debug_tz_trip_down(struct thermal_zone_device *tz,
629 				const struct thermal_trip *trip)
630 {
631 	struct thermal_debugfs *thermal_dbg = tz->debugfs;
632 	struct tz_episode *tze;
633 	struct tz_debugfs *tz_dbg;
634 	ktime_t delta, now = ktime_get();
635 	int trip_id = thermal_zone_trip_id(tz, trip);
636 	int i;
637 
638 	if (!thermal_dbg)
639 		return;
640 
641 	mutex_lock(&thermal_dbg->lock);
642 
643 	tz_dbg = &thermal_dbg->tz_dbg;
644 
645 	/*
646 	 * The temperature crosses the way down but there was not
647 	 * mitigation detected before. That may happen when the
648 	 * temperature is greater than a trip point when registering a
649 	 * thermal zone, which is a common use case as the kernel has
650 	 * no mitigation mechanism yet at boot time.
651 	 */
652 	if (!tz_dbg->nr_trips)
653 		goto out;
654 
655 	for (i = tz_dbg->nr_trips - 1; i >= 0; i--) {
656 		if (tz_dbg->trips_crossed[i] == trip_id)
657 			break;
658 	}
659 
660 	if (i < 0)
661 		goto out;
662 
663 	tz_dbg->nr_trips--;
664 
665 	if (i < tz_dbg->nr_trips)
666 		tz_dbg->trips_crossed[i] = tz_dbg->trips_crossed[tz_dbg->nr_trips];
667 
668 	tze = list_first_entry(&tz_dbg->tz_episodes, struct tz_episode, node);
669 
670 	delta = ktime_sub(now, tze->trip_stats[trip_id].timestamp);
671 
672 	tze->trip_stats[trip_id].duration =
673 		ktime_add(delta, tze->trip_stats[trip_id].duration);
674 
675 	/*
676 	 * This event closes the mitigation as we are crossing the
677 	 * last trip point the way down.
678 	 */
679 	if (!tz_dbg->nr_trips)
680 		tze->duration = ktime_sub(now, tze->timestamp);
681 
682 out:
683 	mutex_unlock(&thermal_dbg->lock);
684 }
685 
686 void thermal_debug_update_temp(struct thermal_zone_device *tz)
687 {
688 	struct thermal_debugfs *thermal_dbg = tz->debugfs;
689 	struct tz_episode *tze;
690 	struct tz_debugfs *tz_dbg;
691 	int trip_id, i;
692 
693 	if (!thermal_dbg)
694 		return;
695 
696 	mutex_lock(&thermal_dbg->lock);
697 
698 	tz_dbg = &thermal_dbg->tz_dbg;
699 
700 	if (!tz_dbg->nr_trips)
701 		goto out;
702 
703 	for (i = 0; i < tz_dbg->nr_trips; i++) {
704 		trip_id = tz_dbg->trips_crossed[i];
705 		tze = list_first_entry(&tz_dbg->tz_episodes, struct tz_episode, node);
706 		tze->trip_stats[trip_id].count++;
707 		tze->trip_stats[trip_id].max = max(tze->trip_stats[trip_id].max, tz->temperature);
708 		tze->trip_stats[trip_id].min = min(tze->trip_stats[trip_id].min, tz->temperature);
709 		tze->trip_stats[trip_id].avg = tze->trip_stats[trip_id].avg +
710 			(tz->temperature - tze->trip_stats[trip_id].avg) /
711 			tze->trip_stats[trip_id].count;
712 	}
713 out:
714 	mutex_unlock(&thermal_dbg->lock);
715 }
716 
717 static void *tze_seq_start(struct seq_file *s, loff_t *pos)
718 {
719 	struct thermal_zone_device *tz = s->private;
720 	struct thermal_debugfs *thermal_dbg = tz->debugfs;
721 	struct tz_debugfs *tz_dbg = &thermal_dbg->tz_dbg;
722 
723 	mutex_lock(&thermal_dbg->lock);
724 
725 	return seq_list_start(&tz_dbg->tz_episodes, *pos);
726 }
727 
728 static void *tze_seq_next(struct seq_file *s, void *v, loff_t *pos)
729 {
730 	struct thermal_zone_device *tz = s->private;
731 	struct thermal_debugfs *thermal_dbg = tz->debugfs;
732 	struct tz_debugfs *tz_dbg = &thermal_dbg->tz_dbg;
733 
734 	return seq_list_next(v, &tz_dbg->tz_episodes, pos);
735 }
736 
737 static void tze_seq_stop(struct seq_file *s, void *v)
738 {
739 	struct thermal_zone_device *tz = s->private;
740 	struct thermal_debugfs *thermal_dbg = tz->debugfs;
741 
742 	mutex_unlock(&thermal_dbg->lock);
743 }
744 
745 static int tze_seq_show(struct seq_file *s, void *v)
746 {
747 	struct thermal_zone_device *tz = s->private;
748 	struct thermal_trip *trip;
749 	struct tz_episode *tze;
750 	const char *type;
751 	int trip_id;
752 
753 	tze = list_entry((struct list_head *)v, struct tz_episode, node);
754 
755 	seq_printf(s, ",-Mitigation at %lluus, duration=%llums\n",
756 		   ktime_to_us(tze->timestamp),
757 		   ktime_to_ms(tze->duration));
758 
759 	seq_printf(s, "| trip |     type | temp(°mC) | hyst(°mC) |  duration  |  avg(°mC) |  min(°mC) |  max(°mC) |\n");
760 
761 	for_each_trip(tz, trip) {
762 		/*
763 		 * There is no possible mitigation happening at the
764 		 * critical trip point, so the stats will be always
765 		 * zero, skip this trip point
766 		 */
767 		if (trip->type == THERMAL_TRIP_CRITICAL)
768 			continue;
769 
770 		if (trip->type == THERMAL_TRIP_PASSIVE)
771 			type = "passive";
772 		else if (trip->type == THERMAL_TRIP_ACTIVE)
773 			type = "active";
774 		else
775 			type = "hot";
776 
777 		trip_id = thermal_zone_trip_id(tz, trip);
778 
779 		seq_printf(s, "| %*d | %*s | %*d | %*d | %*lld | %*d | %*d | %*d |\n",
780 			   4 , trip_id,
781 			   8, type,
782 			   9, trip->temperature,
783 			   9, trip->hysteresis,
784 			   10, ktime_to_ms(tze->trip_stats[trip_id].duration),
785 			   9, tze->trip_stats[trip_id].avg,
786 			   9, tze->trip_stats[trip_id].min,
787 			   9, tze->trip_stats[trip_id].max);
788 	}
789 
790 	return 0;
791 }
792 
793 static const struct seq_operations tze_sops = {
794 	.start = tze_seq_start,
795 	.next = tze_seq_next,
796 	.stop = tze_seq_stop,
797 	.show = tze_seq_show,
798 };
799 
800 DEFINE_SEQ_ATTRIBUTE(tze);
801 
802 void thermal_debug_tz_add(struct thermal_zone_device *tz)
803 {
804 	struct thermal_debugfs *thermal_dbg;
805 	struct tz_debugfs *tz_dbg;
806 
807 	thermal_dbg = thermal_debugfs_add_id(d_tz, tz->id);
808 	if (!thermal_dbg)
809 		return;
810 
811 	tz_dbg = &thermal_dbg->tz_dbg;
812 
813 	tz_dbg->trips_crossed = kzalloc(sizeof(int) * tz->num_trips, GFP_KERNEL);
814 	if (!tz_dbg->trips_crossed) {
815 		thermal_debugfs_remove_id(thermal_dbg);
816 		return;
817 	}
818 
819 	INIT_LIST_HEAD(&tz_dbg->tz_episodes);
820 
821 	debugfs_create_file("mitigations", 0400, thermal_dbg->d_top, tz, &tze_fops);
822 
823 	tz->debugfs = thermal_dbg;
824 }
825 
826 void thermal_debug_tz_remove(struct thermal_zone_device *tz)
827 {
828 	struct thermal_debugfs *thermal_dbg = tz->debugfs;
829 
830 	if (!thermal_dbg)
831 		return;
832 
833 	mutex_lock(&thermal_dbg->lock);
834 
835 	tz->debugfs = NULL;
836 
837 	mutex_unlock(&thermal_dbg->lock);
838 
839 	thermal_debugfs_remove_id(thermal_dbg);
840 }
841