1 // SPDX-License-Identifier: GPL-2.0
3  *  of-thermal.c - Generic Thermal Management device tree support.
15 #include <linux/thermal.h>
24  * It maps 'enum thermal_trip_type' found in include/linux/thermal.h
35  * thermal_of_get_trip_type - Get phy mode for given device_node
60 	return -ENODEV;  in thermal_of_get_trip_type()
74 	trip->temperature = prop;  in thermal_of_populate_trip()
81 	trip->hysteresis = prop;  in thermal_of_populate_trip()
83 	ret = thermal_of_get_trip_type(np, &trip->type);  in thermal_of_populate_trip()
89 	trip->flags = THERMAL_TRIP_FLAG_RW_TEMP;  in thermal_of_populate_trip()
91 	trip->priv = np;  in thermal_of_populate_trip()
114 		ret = -ENOMEM;  in thermal_of_trips_init()
144 	np = of_find_node_by_name(NULL, "thermal-zones");  in of_thermal_zone_find()
146 		pr_debug("No thermal zones description\n");  in of_thermal_zone_find()
147 		return ERR_PTR(-ENODEV);  in of_thermal_zone_find()
151 	 * Search for each thermal zone, a defined sensor  in of_thermal_zone_find()
158 		count = of_count_phandle_with_args(child, "thermal-sensors",  in of_thermal_zone_find()
159 						   "#thermal-sensor-cells");  in of_thermal_zone_find()
161 			pr_err("%pOFn: missing thermal sensor\n", child);  in of_thermal_zone_find()
162 			tz = ERR_PTR(-EINVAL);  in of_thermal_zone_find()
170 			ret = of_parse_phandle_with_args(child, "thermal-sensors",  in of_thermal_zone_find()
171 							 "#thermal-sensor-cells",  in of_thermal_zone_find()
174 				pr_err("%pOFn: Failed to read thermal-sensors cells: %d\n", child, ret);  in of_thermal_zone_find()
187 	tz = ERR_PTR(-ENODEV);  in of_thermal_zone_find()
197 	ret = of_property_read_u32(np, "polling-delay-passive", pdelay);  in thermal_of_monitor_init()
198 	if (ret == -EINVAL) {  in thermal_of_monitor_init()
201 		pr_err("%pOFn: Couldn't get polling-delay-passive: %d\n", np, ret);  in thermal_of_monitor_init()
205 	ret = of_property_read_u32(np, "polling-delay", delay);  in thermal_of_monitor_init()
206 	if (ret == -EINVAL) {  in thermal_of_monitor_init()
209 		pr_err("%pOFn: Couldn't get polling-delay: %d\n", np, ret);  in thermal_of_monitor_init()
223 	tzp->no_hwmon = true;  in thermal_of_parameters_init()
225 	if (!of_property_read_u32(np, "sustainable-power", &prop))  in thermal_of_parameters_init()
226 		tzp->sustainable_power = prop;  in thermal_of_parameters_init()
229 	 * For now, the thermal framework supports only one sensor per  in thermal_of_parameters_init()
230 	 * thermal zone. Thus, we are considering only the first two  in thermal_of_parameters_init()
239 	tzp->slope = coef[0];  in thermal_of_parameters_init()
240 	tzp->offset = coef[1];  in thermal_of_parameters_init()
247 	np = of_find_node_by_name(NULL, "thermal-zones");  in thermal_of_zone_get_by_name()
249 		return ERR_PTR(-ENODEV);  in thermal_of_zone_get_by_name()
251 	tz_np = of_get_child_by_name(np, tz->type);  in thermal_of_zone_get_by_name()
256 		return ERR_PTR(-ENODEV);  in thermal_of_zone_get_by_name()
270 	ret = of_parse_phandle_with_args(map_np, "cooling-device", "#cooling-cells",  in thermal_of_get_cooling_spec()
274 		pr_err("Invalid cooling-device entry\n");  in thermal_of_get_cooling_spec()
285 	if (cooling_spec.np != cdev->np)  in thermal_of_get_cooling_spec()
288 	c->lower = cooling_spec.args[0];  in thermal_of_get_cooling_spec()
289 	c->upper = cooling_spec.args[1];  in thermal_of_get_cooling_spec()
290 	c->weight = weight;  in thermal_of_get_cooling_spec()
309 	cm_np = of_get_child_by_name(tz_np, "cooling-maps");  in thermal_of_should_bind()
319 		if (tr_np != trip->priv)  in thermal_of_should_bind()
323 		count = of_count_phandle_with_args(child, "cooling-device", "#cooling-cells");  in thermal_of_should_bind()
345  * thermal_of_zone_unregister - Cleanup the specific allocated ressources
347  * This function disables the thermal zone and frees the different
348  * ressources allocated specific to the thermal OF.
350  * @tz: a pointer to the thermal zone structure
359  * thermal_of_zone_register - Register a thermal zone with device node
363  * node sensor and identifier. It searches for the thermal zone
364  * associated to the couple sensor/id and retrieves all the thermal
365  * zone properties and registers new thermal zone with those
370  * @data: A private data to be stored in the thermal zone dedicated private area
371  * @ops: A set of thermal sensor ops
373  * Return: a valid thermal zone structure pointer on success.
374  *	- EINVAL: if the device tree thermal description is malformed
375  *	- ENOMEM: if one structure can not be allocated
376  *	- Other negative errors are returned by the underlying called functions
393 		if (PTR_ERR(np) != -ENODEV)  in thermal_of_zone_register()
394 			pr_err("Failed to find thermal zone for %pOFn id=%d\n", sensor, id);  in thermal_of_zone_register()
418 	ret = of_property_read_string(np, "critical-action", &action);  in thermal_of_zone_register()
423 	tz = thermal_zone_device_register_with_trips(np->name, trips, ntrips,  in thermal_of_zone_register()
428 		pr_err("Failed to register thermal zone %pOFn: %d\n", np, ret);  in thermal_of_zone_register()
437 		pr_err("Failed to enabled thermal zone '%s', id=%d: %d\n",  in thermal_of_zone_register()
438 		       tz->type, tz->id, ret);  in thermal_of_zone_register()
470  * devm_thermal_of_zone_register - register a thermal tied with the sensor life cycle
474  * @dev: a device structure pointer to sensor to be tied with the thermal zone OF life cycle
476  * @data: a pointer to a private data to be stored in the thermal zone 'devdata' field
487 		return ERR_PTR(-ENOMEM);  in devm_thermal_of_zone_register()
489 	tzd = thermal_of_zone_register(dev->of_node, sensor_id, data, ops);  in devm_thermal_of_zone_register()
503  * devm_thermal_of_zone_unregister - Resource managed version of
509  * thermal zone device registered with devm_thermal_zone_of_sensor_register()
511  * thermal zone device callbacks.