1 // SPDX-License-Identifier: GPL-2.0
3 * System Control and Management Interface (SCMI) Sensor Protocol
5 * Copyright (C) 2018 ARM Ltd.
8 #define pr_fmt(fmt) "SCMI Notifications SENSOR - " fmt
10 #include <linux/scmi_protocol.h>
15 enum scmi_sensor_protocol_cmd {
16 SENSOR_DESCRIPTION_GET = 0x3,
17 SENSOR_TRIP_POINT_NOTIFY = 0x4,
18 SENSOR_TRIP_POINT_CONFIG = 0x5,
19 SENSOR_READING_GET = 0x6,
22 struct scmi_msg_resp_sensor_attributes {
31 struct scmi_msg_resp_sensor_description {
36 __le32 attributes_low;
37 #define SUPPORTS_ASYNC_READ(x) ((x) & BIT(31))
38 #define NUM_TRIP_POINTS(x) ((x) & 0xff)
39 __le32 attributes_high;
40 #define SENSOR_TYPE(x) ((x) & 0xff)
41 #define SENSOR_SCALE(x) (((x) >> 11) & 0x1f)
42 #define SENSOR_SCALE_SIGN BIT(4)
43 #define SENSOR_SCALE_EXTEND GENMASK(7, 5)
44 #define SENSOR_UPDATE_SCALE(x) (((x) >> 22) & 0x1f)
45 #define SENSOR_UPDATE_BASE(x) (((x) >> 27) & 0x1f)
46 u8 name[SCMI_MAX_STR_SIZE];
50 struct scmi_msg_sensor_trip_point_notify {
53 #define SENSOR_TP_NOTIFY_ALL BIT(0)
56 struct scmi_msg_set_sensor_trip_point {
59 #define SENSOR_TP_EVENT_MASK (0x3)
60 #define SENSOR_TP_DISABLED 0x0
61 #define SENSOR_TP_POSITIVE 0x1
62 #define SENSOR_TP_NEGATIVE 0x2
63 #define SENSOR_TP_BOTH 0x3
64 #define SENSOR_TP_ID(x) (((x) & 0xff) << 4)
69 struct scmi_msg_sensor_reading_get {
72 #define SENSOR_READ_ASYNC BIT(0)
75 struct scmi_sensor_trip_notify_payld {
78 __le32 trip_point_desc;
87 struct scmi_sensor_info *sensors;
90 static int scmi_sensor_attributes_get(const struct scmi_handle *handle,
91 struct sensors_info *si)
95 struct scmi_msg_resp_sensor_attributes *attr;
97 ret = scmi_xfer_get_init(handle, PROTOCOL_ATTRIBUTES,
98 SCMI_PROTOCOL_SENSOR, 0, sizeof(*attr), &t);
104 ret = scmi_do_xfer(handle, t);
106 si->num_sensors = le16_to_cpu(attr->num_sensors);
107 si->max_requests = attr->max_requests;
108 si->reg_addr = le32_to_cpu(attr->reg_addr_low) |
109 (u64)le32_to_cpu(attr->reg_addr_high) << 32;
110 si->reg_size = le32_to_cpu(attr->reg_size);
113 scmi_xfer_put(handle, t);
117 static int scmi_sensor_description_get(const struct scmi_handle *handle,
118 struct sensors_info *si)
122 u16 num_returned, num_remaining;
124 struct scmi_msg_resp_sensor_description *buf;
126 ret = scmi_xfer_get_init(handle, SENSOR_DESCRIPTION_GET,
127 SCMI_PROTOCOL_SENSOR, sizeof(__le32), 0, &t);
134 /* Set the number of sensors to be skipped/already read */
135 put_unaligned_le32(desc_index, t->tx.buf);
137 ret = scmi_do_xfer(handle, t);
141 num_returned = le16_to_cpu(buf->num_returned);
142 num_remaining = le16_to_cpu(buf->num_remaining);
144 if (desc_index + num_returned > si->num_sensors) {
145 dev_err(handle->dev, "No. of sensors can't exceed %d",
150 for (cnt = 0; cnt < num_returned; cnt++) {
152 struct scmi_sensor_info *s;
154 attrl = le32_to_cpu(buf->desc[cnt].attributes_low);
155 attrh = le32_to_cpu(buf->desc[cnt].attributes_high);
156 s = &si->sensors[desc_index + cnt];
157 s->id = le32_to_cpu(buf->desc[cnt].id);
158 s->type = SENSOR_TYPE(attrh);
159 s->scale = SENSOR_SCALE(attrh);
160 /* Sign extend to a full s8 */
161 if (s->scale & SENSOR_SCALE_SIGN)
162 s->scale |= SENSOR_SCALE_EXTEND;
163 s->async = SUPPORTS_ASYNC_READ(attrl);
164 s->num_trip_points = NUM_TRIP_POINTS(attrl);
165 strlcpy(s->name, buf->desc[cnt].name, SCMI_MAX_STR_SIZE);
168 desc_index += num_returned;
170 scmi_reset_rx_to_maxsz(handle, t);
172 * check for both returned and remaining to avoid infinite
173 * loop due to buggy firmware
175 } while (num_returned && num_remaining);
177 scmi_xfer_put(handle, t);
181 static int scmi_sensor_trip_point_notify(const struct scmi_handle *handle,
182 u32 sensor_id, bool enable)
185 u32 evt_cntl = enable ? SENSOR_TP_NOTIFY_ALL : 0;
187 struct scmi_msg_sensor_trip_point_notify *cfg;
189 ret = scmi_xfer_get_init(handle, SENSOR_TRIP_POINT_NOTIFY,
190 SCMI_PROTOCOL_SENSOR, sizeof(*cfg), 0, &t);
195 cfg->id = cpu_to_le32(sensor_id);
196 cfg->event_control = cpu_to_le32(evt_cntl);
198 ret = scmi_do_xfer(handle, t);
200 scmi_xfer_put(handle, t);
205 scmi_sensor_trip_point_config(const struct scmi_handle *handle, u32 sensor_id,
206 u8 trip_id, u64 trip_value)
209 u32 evt_cntl = SENSOR_TP_BOTH;
211 struct scmi_msg_set_sensor_trip_point *trip;
213 ret = scmi_xfer_get_init(handle, SENSOR_TRIP_POINT_CONFIG,
214 SCMI_PROTOCOL_SENSOR, sizeof(*trip), 0, &t);
219 trip->id = cpu_to_le32(sensor_id);
220 trip->event_control = cpu_to_le32(evt_cntl | SENSOR_TP_ID(trip_id));
221 trip->value_low = cpu_to_le32(trip_value & 0xffffffff);
222 trip->value_high = cpu_to_le32(trip_value >> 32);
224 ret = scmi_do_xfer(handle, t);
226 scmi_xfer_put(handle, t);
230 static int scmi_sensor_reading_get(const struct scmi_handle *handle,
231 u32 sensor_id, u64 *value)
235 struct scmi_msg_sensor_reading_get *sensor;
236 struct sensors_info *si = handle->sensor_priv;
237 struct scmi_sensor_info *s = si->sensors + sensor_id;
239 ret = scmi_xfer_get_init(handle, SENSOR_READING_GET,
240 SCMI_PROTOCOL_SENSOR, sizeof(*sensor),
246 sensor->id = cpu_to_le32(sensor_id);
249 sensor->flags = cpu_to_le32(SENSOR_READ_ASYNC);
250 ret = scmi_do_xfer_with_response(handle, t);
252 *value = get_unaligned_le64((void *)
253 ((__le32 *)t->rx.buf + 1));
255 sensor->flags = cpu_to_le32(0);
256 ret = scmi_do_xfer(handle, t);
258 *value = get_unaligned_le64(t->rx.buf);
261 scmi_xfer_put(handle, t);
265 static const struct scmi_sensor_info *
266 scmi_sensor_info_get(const struct scmi_handle *handle, u32 sensor_id)
268 struct sensors_info *si = handle->sensor_priv;
270 return si->sensors + sensor_id;
273 static int scmi_sensor_count_get(const struct scmi_handle *handle)
275 struct sensors_info *si = handle->sensor_priv;
277 return si->num_sensors;
280 static const struct scmi_sensor_ops sensor_ops = {
281 .count_get = scmi_sensor_count_get,
282 .info_get = scmi_sensor_info_get,
283 .trip_point_config = scmi_sensor_trip_point_config,
284 .reading_get = scmi_sensor_reading_get,
287 static int scmi_sensor_set_notify_enabled(const struct scmi_handle *handle,
288 u8 evt_id, u32 src_id, bool enable)
292 ret = scmi_sensor_trip_point_notify(handle, src_id, enable);
294 pr_debug("FAIL_ENABLED - evt[%X] dom[%d] - ret:%d\n",
295 evt_id, src_id, ret);
300 static void *scmi_sensor_fill_custom_report(const struct scmi_handle *handle,
301 u8 evt_id, ktime_t timestamp,
302 const void *payld, size_t payld_sz,
303 void *report, u32 *src_id)
305 const struct scmi_sensor_trip_notify_payld *p = payld;
306 struct scmi_sensor_trip_point_report *r = report;
308 if (evt_id != SCMI_EVENT_SENSOR_TRIP_POINT_EVENT ||
309 sizeof(*p) != payld_sz)
312 r->timestamp = timestamp;
313 r->agent_id = le32_to_cpu(p->agent_id);
314 r->sensor_id = le32_to_cpu(p->sensor_id);
315 r->trip_point_desc = le32_to_cpu(p->trip_point_desc);
316 *src_id = r->sensor_id;
321 static const struct scmi_event sensor_events[] = {
323 .id = SCMI_EVENT_SENSOR_TRIP_POINT_EVENT,
324 .max_payld_sz = sizeof(struct scmi_sensor_trip_notify_payld),
325 .max_report_sz = sizeof(struct scmi_sensor_trip_point_report),
329 static const struct scmi_event_ops sensor_event_ops = {
330 .set_notify_enabled = scmi_sensor_set_notify_enabled,
331 .fill_custom_report = scmi_sensor_fill_custom_report,
334 static int scmi_sensors_protocol_init(struct scmi_handle *handle)
337 struct sensors_info *sinfo;
339 scmi_version_get(handle, SCMI_PROTOCOL_SENSOR, &version);
341 dev_dbg(handle->dev, "Sensor Version %d.%d\n",
342 PROTOCOL_REV_MAJOR(version), PROTOCOL_REV_MINOR(version));
344 sinfo = devm_kzalloc(handle->dev, sizeof(*sinfo), GFP_KERNEL);
348 scmi_sensor_attributes_get(handle, sinfo);
350 sinfo->sensors = devm_kcalloc(handle->dev, sinfo->num_sensors,
351 sizeof(*sinfo->sensors), GFP_KERNEL);
355 scmi_sensor_description_get(handle, sinfo);
357 scmi_register_protocol_events(handle,
358 SCMI_PROTOCOL_SENSOR, SCMI_PROTO_QUEUE_SZ,
359 &sensor_event_ops, sensor_events,
360 ARRAY_SIZE(sensor_events),
363 sinfo->version = version;
364 handle->sensor_ops = &sensor_ops;
365 handle->sensor_priv = sinfo;
370 DEFINE_SCMI_PROTOCOL_REGISTER_UNREGISTER(SCMI_PROTOCOL_SENSOR, sensors)