1 // SPDX-License-Identifier: GPL-2.0
3  *  of-thermal.c - Generic Thermal Management device tree support.
15 #include <linux/thermal.h>
32 		return -EINVAL;  in of_find_trip_id()
47 	i = -ENXIO;  in of_find_trip_id()
55  * It maps 'enum thermal_trip_type' found in include/linux/thermal.h
66  * thermal_of_get_trip_type - Get phy mode for given device_node
91 	return -ENODEV;  in thermal_of_get_trip_type()
105 	trip->temperature = prop;  in thermal_of_populate_trip()
112 	trip->hysteresis = prop;  in thermal_of_populate_trip()
114 	ret = thermal_of_get_trip_type(np, &trip->type);  in thermal_of_populate_trip()
141 		ret = -ENOMEM;  in thermal_of_trips_init()
166 static struct device_node *of_thermal_zone_find(struct device_node *sensor, int id)  in of_thermal_zone_find()  argument
171 	np = of_find_node_by_name(NULL, "thermal-zones");  in of_thermal_zone_find()
173 		pr_debug("No thermal zones description\n");  in of_thermal_zone_find()
174 		return ERR_PTR(-ENODEV);  in of_thermal_zone_find()
178 	 * Search for each thermal zone, a defined sensor  in of_thermal_zone_find()
185 		count = of_count_phandle_with_args(child, "thermal-sensors",  in of_thermal_zone_find()
186 						   "#thermal-sensor-cells");  in of_thermal_zone_find()
188 			pr_err("%pOFn: missing thermal sensor\n", child);  in of_thermal_zone_find()
189 			tz = ERR_PTR(-EINVAL);  in of_thermal_zone_find()
197 			ret = of_parse_phandle_with_args(child, "thermal-sensors",  in of_thermal_zone_find()
198 							 "#thermal-sensor-cells",  in of_thermal_zone_find()
201 				pr_err("%pOFn: Failed to read thermal-sensors cells: %d\n", child, ret);  in of_thermal_zone_find()
206 			if ((sensor == sensor_specs.np) && id == (sensor_specs.args_count ?  in of_thermal_zone_find()
208 				pr_debug("sensor %pOFn id=%d belongs to %pOFn\n", sensor, id, child);  in of_thermal_zone_find()
214 	tz = ERR_PTR(-ENODEV);  in of_thermal_zone_find()
224 	ret = of_property_read_u32(np, "polling-delay-passive", pdelay);  in thermal_of_monitor_init()
225 	if (ret == -EINVAL) {  in thermal_of_monitor_init()
228 		pr_err("%pOFn: Couldn't get polling-delay-passive: %d\n", np, ret);  in thermal_of_monitor_init()
232 	ret = of_property_read_u32(np, "polling-delay", delay);  in thermal_of_monitor_init()
233 	if (ret == -EINVAL) {  in thermal_of_monitor_init()
236 		pr_err("%pOFn: Couldn't get polling-delay: %d\n", np, ret);  in thermal_of_monitor_init()
250 	tzp->no_hwmon = true;  in thermal_of_parameters_init()
252 	if (!of_property_read_u32(np, "sustainable-power", &prop))  in thermal_of_parameters_init()
253 		tzp->sustainable_power = prop;  in thermal_of_parameters_init()
256 	 * For now, the thermal framework supports only one sensor per  in thermal_of_parameters_init()
257 	 * thermal zone. Thus, we are considering only the first two  in thermal_of_parameters_init()
266 	tzp->slope = coef[0];  in thermal_of_parameters_init()
267 	tzp->offset = coef[1];  in thermal_of_parameters_init()
274 	np = of_find_node_by_name(NULL, "thermal-zones");  in thermal_of_zone_get_by_name()
276 		return ERR_PTR(-ENODEV);  in thermal_of_zone_get_by_name()
278 	tz_np = of_get_child_by_name(np, tz->type);  in thermal_of_zone_get_by_name()
283 		return ERR_PTR(-ENODEV);  in thermal_of_zone_get_by_name()
294 	ret = of_parse_phandle_with_args(map_np, "cooling-device", "#cooling-cells",  in __thermal_of_unbind()
298 		pr_err("Invalid cooling-device entry\n");  in __thermal_of_unbind()
306 		return -EINVAL;  in __thermal_of_unbind()
309 	if (cooling_spec.np != cdev->np)  in __thermal_of_unbind()
314 		pr_err("Failed to unbind '%s' with '%s': %d\n", tz->type, cdev->type, ret);  in __thermal_of_unbind()
327 	ret = of_parse_phandle_with_args(map_np, "cooling-device", "#cooling-cells",  in __thermal_of_bind()
331 		pr_err("Invalid cooling-device entry\n");  in __thermal_of_bind()
339 		return -EINVAL;  in __thermal_of_bind()
342 	if (cooling_spec.np != cdev->np)  in __thermal_of_bind()
349 		pr_err("Failed to bind '%s' with '%s': %d\n", tz->type, cdev->type, ret);  in __thermal_of_bind()
364 		return -ENODEV;  in thermal_of_for_each_cooling_device()
370 	count = of_count_phandle_with_args(map_np, "cooling-device", "#cooling-cells");  in thermal_of_for_each_cooling_device()
373 		return -ENOENT;  in thermal_of_for_each_cooling_device()
401 	cm_np = of_get_child_by_name(tz_np, "cooling-maps");  in thermal_of_for_each_cooling_maps()
433  * thermal_of_zone_unregister - Cleanup the specific allocated ressources
435  * This function disables the thermal zone and frees the different
436  * ressources allocated specific to the thermal OF.
438  * @tz: a pointer to the thermal zone structure
442 	struct thermal_trip *trips = tz->trips;  in thermal_of_zone_unregister()
443 	struct thermal_zone_device_ops *ops = tz->ops;  in thermal_of_zone_unregister()
452  * thermal_of_zone_register - Register a thermal zone with device node
453  * sensor
456  * node sensor and identifier. It searches for the thermal zone
457  * associated to the couple sensor/id and retrieves all the thermal
458  * zone properties and registers new thermal zone with those
461  * @sensor: A device node pointer corresponding to the sensor in the device tree
462  * @id: An integer as sensor identifier
463  * @data: A private data to be stored in the thermal zone dedicated private area
464  * @ops: A set of thermal sensor ops
466  * Return: a valid thermal zone structure pointer on success.
467  * 	- EINVAL: if the device tree thermal description is malformed
468  *	- ENOMEM: if one structure can not be allocated
469  *	- Other negative errors are returned by the underlying called functions
471 static struct thermal_zone_device *thermal_of_zone_register(struct device_node *sensor, int id, voi…  in thermal_of_zone_register()  argument
485 		return ERR_PTR(-ENOMEM);  in thermal_of_zone_register()
487 	np = of_thermal_zone_find(sensor, id);  in thermal_of_zone_register()
489 		if (PTR_ERR(np) != -ENODEV)  in thermal_of_zone_register()
490 			pr_err("Failed to find thermal zone for %pOFn id=%d\n", sensor, id);  in thermal_of_zone_register()
497 		pr_err("Failed to parse trip points for %pOFn id=%d\n", sensor, id);  in thermal_of_zone_register()
503 		pr_info("No trip points found for %pOFn id=%d\n", sensor, id);  in thermal_of_zone_register()
513 	of_ops->bind = thermal_of_bind;  in thermal_of_zone_register()
514 	of_ops->unbind = thermal_of_unbind;  in thermal_of_zone_register()
516 	mask = GENMASK_ULL((ntrips) - 1, 0);  in thermal_of_zone_register()
518 	tz = thermal_zone_device_register_with_trips(np->name, trips, ntrips,  in thermal_of_zone_register()
523 		pr_err("Failed to register thermal zone %pOFn: %d\n", np, ret);  in thermal_of_zone_register()
529 		pr_err("Failed to enabled thermal zone '%s', id=%d: %d\n",  in thermal_of_zone_register()
530 		       tz->type, tz->id, ret);  in thermal_of_zone_register()
562  * devm_thermal_of_zone_register - register a thermal tied with the sensor life cycle
566  * @dev: a device structure pointer to sensor to be tied with the thermal zone OF life cycle
567  * @sensor_id: the sensor identifier
568  * @data: a pointer to a private data to be stored in the thermal zone 'devdata' field
569  * @ops: a pointer to the ops structure associated with the sensor
579 		return ERR_PTR(-ENOMEM);  in devm_thermal_of_zone_register()
581 	tzd = thermal_of_zone_register(dev->of_node, sensor_id, data, ops);  in devm_thermal_of_zone_register()
595  * devm_thermal_of_zone_unregister - Resource managed version of
598  * @tz: a pointer to struct thermal_zone where the sensor is registered.
600  * This function removes the sensor callbacks and private data from the
601  * thermal zone device registered with devm_thermal_zone_of_sensor_register()
603  * thermal zone device callbacks.