tjh.dev
Linux kernel mirror (for testing)
git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel
os
linux
1/* SPDX-License-Identifier: GPL-2.0 */
2/*
3 * thermal_core.h
4 *
5 * Copyright (C) 2012 Intel Corp
6 * Author: Durgadoss R <durgadoss.r@intel.com>
7 */
8
9#ifndef __THERMAL_CORE_H__
10#define __THERMAL_CORE_H__
11
12#include <linux/device.h>
13#include <linux/thermal.h>
14
15/* Initial state of a cooling device during binding */
16#define THERMAL_NO_TARGET -1UL
17
18/* Init section thermal table */
19extern struct thermal_governor *__governor_thermal_table[];
20extern struct thermal_governor *__governor_thermal_table_end[];
21
22#define THERMAL_TABLE_ENTRY(table, name) \
23 static typeof(name) *__thermal_table_entry_##name \
24 __used __section(__##table##_thermal_table) = &name
25
26#define THERMAL_GOVERNOR_DECLARE(name) THERMAL_TABLE_ENTRY(governor, name)
27
28#define for_each_governor_table(__governor) \
29 for (__governor = __governor_thermal_table; \
30 __governor < __governor_thermal_table_end; \
31 __governor++)
32
33/*
34 * This structure is used to describe the behavior of
35 * a certain cooling device on a certain trip point
36 * in a certain thermal zone
37 */
38struct thermal_instance {
39 int id;
40 char name[THERMAL_NAME_LENGTH];
41 struct thermal_zone_device *tz;
42 struct thermal_cooling_device *cdev;
43 int trip;
44 bool initialized;
45 unsigned long upper; /* Highest cooling state for this trip point */
46 unsigned long lower; /* Lowest cooling state for this trip point */
47 unsigned long target; /* expected cooling state */
48 char attr_name[THERMAL_NAME_LENGTH];
49 struct device_attribute attr;
50 char weight_attr_name[THERMAL_NAME_LENGTH];
51 struct device_attribute weight_attr;
52 struct list_head tz_node; /* node in tz->thermal_instances */
53 struct list_head cdev_node; /* node in cdev->thermal_instances */
54 unsigned int weight; /* The weight of the cooling device */
55};
56
57#define to_thermal_zone(_dev) \
58 container_of(_dev, struct thermal_zone_device, device)
59
60#define to_cooling_device(_dev) \
61 container_of(_dev, struct thermal_cooling_device, device)
62
63int thermal_register_governor(struct thermal_governor *);
64void thermal_unregister_governor(struct thermal_governor *);
65void thermal_zone_device_rebind_exception(struct thermal_zone_device *,
66 const char *, size_t);
67void thermal_zone_device_unbind_exception(struct thermal_zone_device *,
68 const char *, size_t);
69int thermal_zone_device_set_policy(struct thermal_zone_device *, char *);
70int thermal_build_list_of_policies(char *buf);
71
72/* sysfs I/F */
73int thermal_zone_create_device_groups(struct thermal_zone_device *, int);
74void thermal_zone_destroy_device_groups(struct thermal_zone_device *);
75void thermal_cooling_device_setup_sysfs(struct thermal_cooling_device *);
76void thermal_cooling_device_destroy_sysfs(struct thermal_cooling_device *cdev);
77/* used only at binding time */
78ssize_t trip_point_show(struct device *, struct device_attribute *, char *);
79ssize_t weight_show(struct device *, struct device_attribute *, char *);
80ssize_t weight_store(struct device *, struct device_attribute *, const char *,
81 size_t);
82
83#ifdef CONFIG_THERMAL_STATISTICS
84void thermal_cooling_device_stats_update(struct thermal_cooling_device *cdev,
85 unsigned long new_state);
86#else
87static inline void
88thermal_cooling_device_stats_update(struct thermal_cooling_device *cdev,
89 unsigned long new_state) {}
90#endif /* CONFIG_THERMAL_STATISTICS */
91
92/* device tree support */
93#ifdef CONFIG_THERMAL_OF
94int of_parse_thermal_zones(void);
95void of_thermal_destroy_zones(void);
96int of_thermal_get_ntrips(struct thermal_zone_device *);
97bool of_thermal_is_trip_valid(struct thermal_zone_device *, int);
98const struct thermal_trip *
99of_thermal_get_trip_points(struct thermal_zone_device *);
100#else
101static inline int of_parse_thermal_zones(void) { return 0; }
102static inline void of_thermal_destroy_zones(void) { }
103static inline int of_thermal_get_ntrips(struct thermal_zone_device *tz)
104{
105 return 0;
106}
107static inline bool of_thermal_is_trip_valid(struct thermal_zone_device *tz,
108 int trip)
109{
110 return false;
111}
112static inline const struct thermal_trip *
113of_thermal_get_trip_points(struct thermal_zone_device *tz)
114{
115 return NULL;
116}
117#endif
118
119#endif /* __THERMAL_CORE_H__ */