Message ID | 20210121232147.1849509-2-jbhayana@google.com (mailing list archive) |
---|---|
State | New, archived |
Headers | show |
Series | Adding support for IIO SCMI based sensors | expand |
Hi Jyoti, a few remarks below. On Thu, Jan 21, 2021 at 11:21:47PM +0000, Jyoti Bhayana wrote: > This change provides ARM SCMI Protocol based IIO device. > This driver provides support for Accelerometer and Gyroscope using > new SCMI Sensor Protocol defined by the upcoming SCMIv3.0 I'd say: new SCMI Sensor Protocol extension added by the upcoming SCMIv3.0 given that SCMI Sensor existed already in SCMIv2.0 > ARM specification > > Signed-off-by: Jyoti Bhayana <jbhayana@google.com> > --- > MAINTAINERS | 6 + > drivers/iio/common/Kconfig | 1 + > drivers/iio/common/Makefile | 1 + > drivers/iio/common/scmi_sensors/Kconfig | 18 + > drivers/iio/common/scmi_sensors/Makefile | 5 + > drivers/iio/common/scmi_sensors/scmi_iio.c | 736 +++++++++++++++++++++ > 6 files changed, 767 insertions(+) > create mode 100644 drivers/iio/common/scmi_sensors/Kconfig > create mode 100644 drivers/iio/common/scmi_sensors/Makefile > create mode 100644 drivers/iio/common/scmi_sensors/scmi_iio.c > > diff --git a/MAINTAINERS b/MAINTAINERS > index b516bb34a8d5..ccf37d43ab41 100644 > --- a/MAINTAINERS > +++ b/MAINTAINERS > @@ -8567,6 +8567,12 @@ S: Maintained > F: Documentation/devicetree/bindings/iio/multiplexer/io-channel-mux.txt > F: drivers/iio/multiplexer/iio-mux.c > > +IIO SCMI BASED DRIVER > +M: Jyoti Bhayana <jbhayana@google.com> > +L: linux-iio@vger.kernel.org > +S: Maintained > +F: drivers/iio/common/scmi_sensors/scmi_iio.c > + > IIO SUBSYSTEM AND DRIVERS > M: Jonathan Cameron <jic23@kernel.org> > R: Lars-Peter Clausen <lars@metafoo.de> > diff --git a/drivers/iio/common/Kconfig b/drivers/iio/common/Kconfig > index 2b9ee9161abd..0334b4954773 100644 > --- a/drivers/iio/common/Kconfig > +++ b/drivers/iio/common/Kconfig > @@ -6,5 +6,6 @@ > source "drivers/iio/common/cros_ec_sensors/Kconfig" > source "drivers/iio/common/hid-sensors/Kconfig" > source "drivers/iio/common/ms_sensors/Kconfig" > +source "drivers/iio/common/scmi_sensors/Kconfig" > source "drivers/iio/common/ssp_sensors/Kconfig" > source "drivers/iio/common/st_sensors/Kconfig" > diff --git a/drivers/iio/common/Makefile b/drivers/iio/common/Makefile > index 4bc30bb548e2..fad40e1e1718 100644 > --- a/drivers/iio/common/Makefile > +++ b/drivers/iio/common/Makefile > @@ -11,5 +11,6 @@ > obj-y += cros_ec_sensors/ > obj-y += hid-sensors/ > obj-y += ms_sensors/ > +obj-y += scmi_sensors/ > obj-y += ssp_sensors/ > obj-y += st_sensors/ > diff --git a/drivers/iio/common/scmi_sensors/Kconfig b/drivers/iio/common/scmi_sensors/Kconfig > new file mode 100644 > index 000000000000..67e084cbb1ab > --- /dev/null > +++ b/drivers/iio/common/scmi_sensors/Kconfig > @@ -0,0 +1,18 @@ > +# > +# IIO over SCMI > +# > +# When adding new entries keep the list in alphabetical order > + > +menu "IIO SCMI Sensors" > + > +config IIO_SCMI > + tristate "IIO SCMI" > + depends on ARM_SCMI_PROTOCOL > + select IIO_BUFFER > + select IIO_KFIFO_BUF > + help > + Say yes here to build support for IIO SCMI Driver. > + This provides ARM SCMI Protocol based IIO device. > + This driver provides support for accelerometer and gyroscope > + sensors available on SCMI based platforms. > +endmenu > diff --git a/drivers/iio/common/scmi_sensors/Makefile b/drivers/iio/common/scmi_sensors/Makefile > new file mode 100644 > index 000000000000..f13140a2575a > --- /dev/null > +++ b/drivers/iio/common/scmi_sensors/Makefile > @@ -0,0 +1,5 @@ > +# SPDX - License - Identifier : GPL - 2.0 - only > +# > +# Makefile for the IIO over SCMI > +# > +obj-$(CONFIG_IIO_SCMI) += scmi_iio.o > diff --git a/drivers/iio/common/scmi_sensors/scmi_iio.c b/drivers/iio/common/scmi_sensors/scmi_iio.c > new file mode 100644 > index 000000000000..3b76cc54511c > --- /dev/null > +++ b/drivers/iio/common/scmi_sensors/scmi_iio.c > @@ -0,0 +1,736 @@ > +// SPDX-License-Identifier: GPL-2.0 > + > +/* > + * System Control and Management Interface(SCMI) based IIO sensor driver > + * > + * Copyright (C) 2020 Google LLC > + */ > + > +#include <linux/delay.h> > +#include <linux/err.h> > +#include <linux/iio/buffer.h> > +#include <linux/iio/iio.h> > +#include <linux/iio/kfifo_buf.h> > +#include <linux/iio/sysfs.h> > +#include <linux/kernel.h> > +#include <linux/kthread.h> > +#include <linux/module.h> > +#include <linux/scmi_protocol.h> > +#include <linux/time.h> > +#include <linux/types.h> > + > +#define ilog10(x) (ilog2(x) / const_ilog2(10)) > +#define UHZ_PER_HZ 1000000UL > +#define ODR_EXPAND(odr, uodr) (((odr) * 1000000ULL) + (uodr)) > +#define MAX_NUM_OF_CHANNELS 4 > +#define H32(x) (((x) & 0xFFFFFFFF00000000LL) >> 32) > +#define L32(x) ((x) & 0xFFFFFFFFLL) Probaly you want to use GENMASK here to define the masks, and not sure but maybe there are already similar macros in linux to extract upper/lower 32 bits. > + > +struct scmi_iio_priv { > + struct scmi_handle *handle; > + const struct scmi_sensor_info *sensor_info; > + struct iio_dev *indio_dev; > + long long iio_buf[MAX_NUM_OF_CHANNELS]; > + struct notifier_block sensor_update_nb; > + u32 *freq_avail; > + /* > + * range_avail = [minRange resolution maxRange] > + * with IIO val type as IIO_VAL_FRACTIONAL. > + * Hence, array of size 6. > + */ > + int range_avail[6]; > +}; > + > +static int scmi_iio_sensor_update_cb(struct notifier_block *nb, > + unsigned long event, void *data) > +{ > + struct scmi_sensor_update_report *sensor_update = data; > + struct iio_dev *scmi_iio_dev; > + struct scmi_iio_priv *sensor; > + s8 tstamp_scale; > + u64 time, time_ns; > + int i; > + > + if (sensor_update->readings_count == 0) > + return NOTIFY_DONE; > + > + sensor = container_of(nb, struct scmi_iio_priv, sensor_update_nb); > + > + for (i = 0; i < sensor_update->readings_count; i++) > + sensor->iio_buf[i] = sensor_update->readings[i].value; > + > + if (!sensor->sensor_info->timestamped) { > + time_ns = iio_get_time_ns(scmi_iio_dev); This scmi_iio_dev is on the stack and still NOT initialized here right ? Moreover, if this is meant to attach a timestamp of arrival also to NON-timestamped sensor notifications, note that, if you want, scmi_sensor_update_report contains a 'timestamp' (as all SCMI notif reports) ktime field (ns) which represents the time (ns from boot with ktime_get_boottime()) of reception of this notification taken by the SCMI core as soon as it arrives in the RX ISR. (so in the OSPM Linux world) If you grab the timestamp here with iio_get_time_ns() you are indeed getting a timestamp inside the notification callback so at the end of the notifications processing chain, i.e. in a deferred worker processing this queue of events and in turn calling this function, so potentially you're timestamping a lot later than when the event arrived really in the OSPM world (especially on a loaded system); it is more the time of arrival in IIO framework. On the other side timestamped events handled in the else-branch down below carry a timestamp set by the SCMI platform fw early on when the event has been detected by the sensor in the real world. Not sure how these values are used at the end, but just to let you know this detail if it was not apparent. > + } else { > + /* > + * All the axes are supposed to have the same value for timestamp. > + * We are just using the values from the Axis 0 here. > + */ > + time = sensor_update->readings[0].timestamp; > + > + /* > + * Timestamp returned by SCMI is in seconds and is equal to > + * time * power-of-10 multiplier(tstamp_scale) seconds. > + * Converting the timestamp to nanoseconds below. > + */ > + tstamp_scale = sensor->sensor_info->tstamp_scale + > + ilog10(NSEC_PER_SEC); > + if (tstamp_scale < 0) > + time_ns = div64_u64(time, > + int_pow(10, abs(tstamp_scale))); > + else > + time_ns = time * int_pow(10, tstamp_scale); > + } > + > + scmi_iio_dev = sensor->indio_dev; > + iio_push_to_buffers_with_timestamp(scmi_iio_dev, sensor->iio_buf, > + time_ns); > + return NOTIFY_OK; > +} > + > +static int scmi_iio_buffer_preenable(struct iio_dev *iio_dev) > +{ > + struct scmi_iio_priv *sensor = iio_priv(iio_dev); > + u32 sensor_id = sensor->sensor_info->id; > + u32 sensor_config; > + int err; > + > + if (sensor->sensor_info->timestamped) > + sensor_config |= FIELD_PREP(SCMI_SENS_CFG_TSTAMP_ENABLED_MASK, > + SCMI_SENS_CFG_TSTAMP_ENABLE); The initial sensor_config ORed here is NOT initialized nor zeroed. > + > + sensor_config |= FIELD_PREP(SCMI_SENS_CFG_SENSOR_ENABLED_MASK, > + SCMI_SENS_CFG_SENSOR_ENABLE); > + > + err = sensor->handle->notify_ops->register_event_notifier(sensor->handle, > + SCMI_PROTOCOL_SENSOR, SCMI_EVENT_SENSOR_UPDATE, > + &sensor_id, &sensor->sensor_update_nb); > + if (err) { > + dev_err(&iio_dev->dev, > + "Error in registering sensor update notifier for sensor %s err %d", > + sensor->sensor_info->name, err); > + return err; > + } > + > + err = sensor->handle->sensor_ops->config_set(sensor->handle, > + sensor->sensor_info->id, sensor_config); > + if (err) > + dev_err(&iio_dev->dev, "Error in enabling sensor %s err %d", > + sensor->sensor_info->name, err); Here you do not unregister the notification above here when you fail the config_set. If you happen to retry this code path again you'll end up registering the same notifier_block sensor_update_nb() in the same notification chain (same event samme sensor_id), which is broken and probably triggers a WARN from the core kernel notification chains machinery too. In an upcoming series on SCMI core I'll introduce a devm_ variant for SCMI notification registration, but as of now you have to properly unregister on error paths. > + > + return err; > +} > + > +static int scmi_iio_buffer_postdisable(struct iio_dev *iio_dev) > +{ > + struct scmi_iio_priv *sensor = iio_priv(iio_dev); > + u32 sensor_id = sensor->sensor_info->id; > + u32 sensor_config = 0; > + int err; > + > + sensor_config |= FIELD_PREP(SCMI_SENS_CFG_SENSOR_ENABLED_MASK, > + SCMI_SENS_CFG_SENSOR_DISABLE); > + > + err = sensor->handle->notify_ops->unregister_event_notifier(sensor->handle, > + SCMI_PROTOCOL_SENSOR, SCMI_EVENT_SENSOR_UPDATE, > + &sensor_id, &sensor->sensor_update_nb); This alignment here is a bit awkaward. > + if (err) { > + dev_err(&iio_dev->dev, > + "Error in unregistering sensor update notifier for sensor %s err %d", > + sensor->sensor_info->name, err); > + return err; > + } > + > + err = sensor->handle->sensor_ops->config_set(sensor->handle, sensor_id, > + sensor_config); > + if (err) > + dev_err(&iio_dev->dev, > + "Error in disabling sensor %s with err %d", > + sensor->sensor_info->name, err); > + > + return err; > +} > + > +static const struct iio_buffer_setup_ops scmi_iio_buffer_ops = { > + .preenable = scmi_iio_buffer_preenable, > + .postdisable = scmi_iio_buffer_postdisable, > +}; > + Being not so familiar with IIO, may I ask when annd ho wmuch frequently these ops are called ? (given they include a register/unregister + enable/disable every time) > +static int scmi_iio_read_avail(struct iio_dev *iio_dev, > + struct iio_chan_spec const *chan, > + const int **vals, int *type, int *length, > + long mask) > +{ > + struct scmi_iio_priv *sensor = iio_priv(iio_dev); > + > + switch (mask) { > + case IIO_CHAN_INFO_SAMP_FREQ: > + *vals = sensor->freq_avail; > + *type = IIO_VAL_INT_PLUS_MICRO; > + *length = sensor->sensor_info->intervals.count * 2; > + if (sensor->sensor_info->intervals.segmented) > + return IIO_AVAIL_RANGE; > + else > + return IIO_AVAIL_LIST; > + case IIO_CHAN_INFO_RAW: > + *vals = sensor->range_avail; > + *type = IIO_VAL_FRACTIONAL; > + *length = ARRAY_SIZE(sensor->range_avail); > + return IIO_AVAIL_RANGE; > + default: > + return -EINVAL; > + } > +} > + > +static int scmi_iio_set_odr_val(struct iio_dev *iio_dev, int val, int val2) > +{ > + struct scmi_iio_priv *sensor = iio_priv(iio_dev); > + u64 sec, mult, uHz; > + u32 sensor_config; > + > + int err = sensor->handle->sensor_ops->config_get(sensor->handle, > + sensor->sensor_info->id, &sensor_config); > + if (err) { > + dev_err(&iio_dev->dev, > + "Error in getting sensor config for sensor %s err %d", > + sensor->sensor_info->name, err); > + return err; > + } > + > + uHz = ODR_EXPAND(val, val2); > + > + /* > + * The seconds field in the sensor interval in SCMI is 16 bits long > + * Therefore seconds = 1/Hz <= 0xFFFF. As floating point calculations are > + * discouraged in the kernel driver code, to calculate the scale factor (sf) > + * (1* 1000000 * sf)/uHz <= 0xFFFF. Therefore, sf <= (uHz * 0xFFFF)/1000000 > + */ > + mult = ilog10(((u64)uHz * 0xFFFF) / UHZ_PER_HZ); > + > + sec = div64_u64(int_pow(10, mult) * UHZ_PER_HZ, uHz); > + if (sec == 0) { > + dev_err(&iio_dev->dev, > + "Trying to set invalid sensor update value for sensor %s", > + sensor->sensor_info->name); > + return -EINVAL; > + } > + > + sensor_config &= ~SCMI_SENS_CFG_UPDATE_SECS_MASK; > + sensor_config |= FIELD_PREP(SCMI_SENS_CFG_UPDATE_SECS_MASK, sec); > + sensor_config &= ~SCMI_SENS_CFG_UPDATE_EXP_MASK; > + sensor_config |= FIELD_PREP(SCMI_SENS_CFG_UPDATE_EXP_MASK, -mult); > + > + if (sensor->sensor_info->timestamped) { > + sensor_config &= ~SCMI_SENS_CFG_TSTAMP_ENABLED_MASK; > + sensor_config |= FIELD_PREP(SCMI_SENS_CFG_TSTAMP_ENABLED_MASK, > + SCMI_SENS_CFG_TSTAMP_ENABLE); > + } > + > + sensor_config &= ~SCMI_SENS_CFG_ROUND_MASK; > + sensor_config |= > + FIELD_PREP(SCMI_SENS_CFG_ROUND_MASK, SCMI_SENS_CFG_ROUND_AUTO); > + > + err = sensor->handle->sensor_ops->config_set(sensor->handle, > + sensor->sensor_info->id, sensor_config); > + if (err) > + dev_err(&iio_dev->dev, > + "Error in setting sensor update interval for sensor %s value %u err %d", > + sensor->sensor_info->name, sensor_config, err); > + > + return err; > +} > + > +static int scmi_iio_write_raw(struct iio_dev *iio_dev, > + struct iio_chan_spec const *chan, int val, > + int val2, long mask) > +{ > + int err; > + > + switch (mask) { > + case IIO_CHAN_INFO_SAMP_FREQ: > + mutex_lock(&iio_dev->mlock); > + err = scmi_iio_set_odr_val(iio_dev, val, val2); > + mutex_unlock(&iio_dev->mlock); > + return err; > + default: > + return -EINVAL; > + } > +} > + > +static u64 scmi_iio_convert_interval_to_ns(u32 val) > +{ > + u64 sensor_update_interval = > + SCMI_SENS_INTVL_GET_SECS(val) * NSEC_PER_SEC; > + u64 sensor_interval_mult; > + int mult; > + > + mult = SCMI_SENS_INTVL_GET_EXP(val); > + if (mult < 0) { > + sensor_interval_mult = int_pow(10, abs(mult)); > + sensor_update_interval = > + sensor_update_interval / sensor_interval_mult; > + } else { > + sensor_interval_mult = int_pow(10, mult); > + sensor_update_interval = > + sensor_update_interval * sensor_interval_mult; > + } > + return sensor_update_interval; > +} > + > +static void convert_ns_to_freq(u64 interval_ns, u64 *hz, u64 *uhz) > +{ > + u64 rem; > + > + *hz = div64_u64_rem(NSEC_PER_SEC, interval_ns, &rem); > + *uhz = (rem * 1000000UL) / interval_ns; > +} > + > +static int scmi_iio_get_odr_val(struct iio_dev *iio_dev, int *val, int *val2) > +{ > + u64 sensor_update_interval, sensor_interval_mult, hz, uhz; > + struct scmi_iio_priv *sensor = iio_priv(iio_dev); > + u32 sensor_config; > + int mult; > + > + int err = sensor->handle->sensor_ops->config_get(sensor->handle, > + sensor->sensor_info->id, &sensor_config); > + if (err) { > + dev_err(&iio_dev->dev, > + "Error in getting sensor config for sensor %s err %d", > + sensor->sensor_info->name, err); > + return err; > + } > + > + sensor_update_interval = > + SCMI_SENS_CFG_GET_UPDATE_SECS(sensor_config) * NSEC_PER_SEC; > + > + mult = SCMI_SENS_CFG_GET_UPDATE_EXP(sensor_config); > + if (mult < 0) { > + sensor_interval_mult = int_pow(10, abs(mult)); > + sensor_update_interval = > + sensor_update_interval / sensor_interval_mult; > + } else { > + sensor_interval_mult = int_pow(10, mult); > + sensor_update_interval = > + sensor_update_interval * sensor_interval_mult; > + } > + > + convert_ns_to_freq(sensor_update_interval, &hz, &uhz); > + *val = hz; > + *val2 = uhz; > + return 0; > +} > + > +static int scmi_iio_read_raw(struct iio_dev *iio_dev, > + struct iio_chan_spec const *ch, int *val, > + int *val2, long mask) > +{ > + struct scmi_iio_priv *sensor = iio_priv(iio_dev); > + s8 scale; > + int ret; > + > + switch (mask) { > + case IIO_CHAN_INFO_SCALE: > + scale = sensor->sensor_info->axis[ch->scan_index].scale; > + if (scale < 0) { > + *val = 1; > + *val2 = int_pow(10, abs(scale)); > + return IIO_VAL_FRACTIONAL; > + } > + *val = int_pow(10, scale); > + return IIO_VAL_INT; > + case IIO_CHAN_INFO_SAMP_FREQ: > + ret = scmi_iio_get_odr_val(iio_dev, val, val2); > + return ret ? ret : IIO_VAL_INT_PLUS_MICRO; > + default: > + return -EINVAL; > + } > +} > + > +static const struct iio_info scmi_iio_info = { > + .read_raw = scmi_iio_read_raw, > + .read_avail = scmi_iio_read_avail, > + .write_raw = scmi_iio_write_raw, > +}; > + > +static void scmi_iio_set_timestamp_channel(struct iio_chan_spec *iio_chan, > + int scan_index) > +{ > + iio_chan->type = IIO_TIMESTAMP; > + iio_chan->channel = -1; > + iio_chan->scan_index = scan_index; > + iio_chan->scan_type.sign = 'u'; > + iio_chan->scan_type.realbits = 64; > + iio_chan->scan_type.storagebits = 64; > +} > + > +static void scmi_iio_set_data_channel(struct iio_chan_spec *iio_chan, > + enum iio_chan_type type, > + enum iio_modifier mod, int scan_index) > +{ > + iio_chan->type = type; > + iio_chan->modified = 1; > + iio_chan->channel2 = mod; > + iio_chan->info_mask_separate = BIT(IIO_CHAN_INFO_SCALE); > + iio_chan->info_mask_shared_by_type = BIT(IIO_CHAN_INFO_SAMP_FREQ); > + iio_chan->info_mask_shared_by_type_available = > + BIT(IIO_CHAN_INFO_SAMP_FREQ) | BIT(IIO_CHAN_INFO_RAW); > + iio_chan->scan_index = scan_index; > + iio_chan->scan_type.sign = 's'; > + iio_chan->scan_type.realbits = 64; > + iio_chan->scan_type.storagebits = 64; > + iio_chan->scan_type.endianness = IIO_LE; > +} > + > +static int scmi_iio_get_chan_modifier(const char *name, > + enum iio_modifier *modifier) > +{ AFAIU this is called during IIO init and derives a modifier from the name of the sensors which are passed by the platform fw with sensor descriptors, so I would not trust them to be weell formed (:D) and try to be picky about *name as it was user-input to validate. > + char *pch; > + > + pch = strrchr(name, '_'); What happens if name is NULL ? > + if (!pch) > + return -EINVAL; > + > + if (strcmp(pch + 1, "X") == 0) { > + *modifier = IIO_MOD_X; > + return 0; > + } else if (strcmp(pch + 1, "Y") == 0) { > + *modifier = IIO_MOD_Y; > + return 0; > + } else if (strcmp(pch + 1, "Z") == 0) { > + *modifier = IIO_MOD_Z; > + return 0; > + } else { > + return -EINVAL; > + } Moroever, being a single char compare cannot this be done with a switch ? char mod = *(pch + 1); switch(mod) { case 'X': *modifier = IIO_MOD_X; break ... > +} > + > +static int scmi_iio_get_chan_type(u8 scmi_type, enum iio_chan_type *iio_type) > +{ > + switch (scmi_type) { > + case METERS_SEC_SQUARED: > + *iio_type = IIO_ACCEL; > + return 0; why not a break to a final 'return ret;' (with ret properly set) ? > + case RADIANS_SEC: > + *iio_type = IIO_ANGL_VEL; > + return 0; > + default: > + return -EINVAL; > + } > +} > + > +static int scmi_iio_get_sensor_max_range(struct iio_dev *iio_dev, int *val, > + int *val2) > +{ > + struct scmi_iio_priv *sensor = iio_priv(iio_dev); > + int max_range_high, max_range_low; > + long long max_range; > + > + /* > + * All the axes are supposed to have the same value for max range. > + * We are just using the values from the Axis 0 here. > + */ > + if (sensor->sensor_info->axis[0].extended_attrs) { > + max_range = sensor->sensor_info->axis[0].attrs.max_range; > + max_range_high = H32(max_range); > + max_range_low = L32(max_range); > + > + /* > + * As IIO Val types have no provision for 64 bit values, > + * and currently there are no known sensors using 64 bit > + * for the range, this driver only supports sensor with > + * 32 bit range value. > + */ > + if (max_range_high != 0) > + return -EINVAL; > + > + *val = max_range_low; > + *val2 = 1; > + } > + return 0; > +} > + > +static void scmi_iio_get_sensor_resolution(struct iio_dev *iio_dev, int *val, > + int *val2) > +{ > + struct scmi_iio_priv *sensor = iio_priv(iio_dev); > + > + /* > + * All the axes are supposed to have the same value for resolution > + * and exponent. We are just using the values from the Axis 0 here. > + */ > + if (sensor->sensor_info->axis[0].extended_attrs) { > + uint resolution = sensor->sensor_info->axis[0].resolution; > + s8 exponent = sensor->sensor_info->axis[0].exponent; > + s8 scale = sensor->sensor_info->axis[0].scale; > + > + /* > + * To provide the raw value for the resolution to the userspace, > + * need to divide the resolution exponent by the sensor scale > + */ > + exponent = exponent - scale; > + if (exponent >= 0) { > + *val = resolution * int_pow(10, exponent); > + *val2 = 1; > + } else { > + *val = resolution; > + *val2 = int_pow(10, abs(exponent)); > + } > + } > +} > + > +static int scmi_iio_get_sensor_min_range(struct iio_dev *iio_dev, int *val, > + int *val2) > +{ > + struct scmi_iio_priv *sensor = iio_priv(iio_dev); > + int min_range_high, min_range_low; > + long long min_range; > + > + /* > + * All the axes are supposed to have the same value for min range. > + * We are just using the values from the Axis 0 here. > + */ > + if (sensor->sensor_info->axis[0].extended_attrs) { > + min_range = sensor->sensor_info->axis[0].attrs.min_range; > + min_range_high = H32(min_range); > + min_range_low = L32(min_range); > + > + /* > + * As IIO Val types have no provision for 64 bit values, > + * and currently there are no known sensors using 64 bit > + * for the range, this driver only supports sensor with > + * 32 bit range value. > + */ > + if (min_range_high != 0xFFFFFFFF) > + return -EINVAL; > + > + *val = min_range_low; > + *val2 = 1; > + } > + return 0; > +} > + > +static int scmi_iio_set_sensor_range_avail(struct iio_dev *iio_dev) > +{ > + struct scmi_iio_priv *sensor = iio_priv(iio_dev); > + int ret; > + > + ret = scmi_iio_get_sensor_min_range(iio_dev, &sensor->range_avail[0], > + &sensor->range_avail[1]); > + if (ret) > + return ret; > + > + scmi_iio_get_sensor_resolution(iio_dev, &sensor->range_avail[2], > + &sensor->range_avail[3]); > + ret = scmi_iio_get_sensor_max_range(iio_dev, &sensor->range_avail[4], > + &sensor->range_avail[5]); > + return ret; > +} > + > +static int scmi_iio_set_sampling_freq_avail(struct iio_dev *iio_dev) > +{ > + u64 cur_interval_ns, low_interval_ns, high_interval_ns, step_size_ns, > + hz, uhz; > + unsigned int cur_interval, low_interval, high_interval, step_size; > + struct scmi_iio_priv *sensor = iio_priv(iio_dev); > + int i; > + > + sensor->freq_avail = devm_kzalloc(&iio_dev->dev, > + sizeof(u32) * (sensor->sensor_info->intervals.count * 2), > + GFP_KERNEL); > + if (!sensor->freq_avail) > + return -ENOMEM; > + > + if (sensor->sensor_info->intervals.segmented) { > + low_interval = sensor->sensor_info->intervals > + .desc[SCMI_SENS_INTVL_SEGMENT_LOW]; > + low_interval_ns = scmi_iio_convert_interval_to_ns(low_interval); > + convert_ns_to_freq(low_interval_ns, &hz, &uhz); > + sensor->freq_avail[0] = hz; > + sensor->freq_avail[1] = uhz; > + > + step_size = sensor->sensor_info->intervals > + .desc[SCMI_SENS_INTVL_SEGMENT_STEP]; > + step_size_ns = scmi_iio_convert_interval_to_ns(step_size); > + convert_ns_to_freq(step_size_ns, &hz, &uhz); > + sensor->freq_avail[2] = hz; > + sensor->freq_avail[3] = uhz; > + > + high_interval = sensor->sensor_info->intervals > + .desc[SCMI_SENS_INTVL_SEGMENT_HIGH]; > + high_interval_ns = > + scmi_iio_convert_interval_to_ns(high_interval); > + convert_ns_to_freq(high_interval_ns, &hz, &uhz); > + sensor->freq_avail[4] = hz; > + sensor->freq_avail[5] = uhz; > + } else { > + for (i = 0; i < sensor->sensor_info->intervals.count; i++) { > + cur_interval = sensor->sensor_info->intervals.desc[i]; > + cur_interval_ns = scmi_iio_convert_interval_to_ns(cur_interval); > + convert_ns_to_freq(cur_interval_ns, &hz, &uhz); > + sensor->freq_avail[i * 2] = hz; > + sensor->freq_avail[i * 2 + 1] = uhz; > + } > + } > + return 0; > +} > + > +static int scmi_iio_buffers_setup(struct iio_dev *scmi_iiodev) > +{ > + struct iio_buffer *buffer; > + > + buffer = devm_iio_kfifo_allocate(&scmi_iiodev->dev); > + if (!buffer) > + return -ENOMEM; > + > + iio_device_attach_buffer(scmi_iiodev, buffer); > + scmi_iiodev->modes |= INDIO_BUFFER_SOFTWARE; > + scmi_iiodev->setup_ops = &scmi_iio_buffer_ops; Not familiar with IIO, but is it fine to setup ops and modes AFTER having attached the buffer to the scmi_iiodev ? Is is not 'racy-possible' that the buffer is already operational without any ops immediately after being attached ? > + return 0; > +} > + > +static int scmi_alloc_iiodev(struct device *dev, struct scmi_handle *handle, > + const struct scmi_sensor_info *sensor_info, > + struct iio_dev **scmi_iio_dev) > +{ > + struct iio_chan_spec *iio_channels; > + struct scmi_iio_priv *sensor; > + enum iio_modifier modifier; > + enum iio_chan_type type; > + struct iio_dev *iiodev; > + int i, ret; > + > + iiodev = devm_iio_device_alloc(dev, sizeof(*sensor)); > + if (!iiodev) > + return -ENOMEM; > + > + iiodev->modes = INDIO_DIRECT_MODE; > + iiodev->dev.parent = dev; > + sensor = iio_priv(iiodev); > + sensor->handle = handle; > + sensor->sensor_info = sensor_info; > + sensor->sensor_update_nb.notifier_call = scmi_iio_sensor_update_cb; > + sensor->indio_dev = iiodev; > + > + /* adding one additional channel for timestamp */ > + iiodev->num_channels = sensor_info->num_axis + 1; > + iiodev->name = sensor_info->name; > + iiodev->info = &scmi_iio_info; > + > + iio_channels = > + devm_kzalloc(dev, > + sizeof(*iio_channels) * (iiodev->num_channels), > + GFP_KERNEL); > + if (!iio_channels) > + return -ENOMEM; > + > + scmi_iio_set_sampling_freq_avail(iiodev); > + > + ret = scmi_iio_set_sensor_range_avail(iiodev); > + if (ret) { > + dev_err(dev, "Error while setting the sensor %s range %d", > + sensor_info->name, ret); > + return ret; > + } > + > + for (i = 0; i < sensor_info->num_axis; i++) { > + ret = scmi_iio_get_chan_type(sensor_info->axis[i].type, &type); > + if (ret < 0) > + return ret; > + > + ret = scmi_iio_get_chan_modifier(sensor_info->axis[i].name, > + &modifier); > + if (ret < 0) > + return ret; > + > + scmi_iio_set_data_channel(&iio_channels[i], type, modifier, > + sensor_info->axis[i].id); > + } > + > + scmi_iio_set_timestamp_channel(&iio_channels[i], i); > + iiodev->channels = iio_channels; > + *scmi_iio_dev = iiodev; > + return ret; > +} > + > +static int scmi_iio_dev_probe(struct scmi_device *sdev) > +{ > + const struct scmi_sensor_info *sensor_info; > + struct scmi_handle *handle = sdev->handle; > + struct device *dev = &sdev->dev; > + struct iio_dev *scmi_iio_dev; > + u16 nr_sensors; > + int err, i; > + > + if (!handle || !handle->sensor_ops || !handle->sensor_ops->count_get || > + !handle->sensor_ops->info_get || !handle->sensor_ops->config_get || > + !handle->sensor_ops->config_set) { In all other SCMI driver we just check for: !handle && !handle->sensor_ops it should be enough, since all the ops are defined if the stack you are using supports SCMIv3.0, if not this driver would not even compile since some SCMIv3.0 Sensor Extension sensor_ops would be missing as a whole inside the struct itself. Thanks Cristian > + dev_err(dev, "SCMI device has no sensor interface\n"); > + return -EINVAL; > + } > + > + nr_sensors = handle->sensor_ops->count_get(handle); > + if (!nr_sensors) { > + dev_dbg(dev, "0 sensors found via SCMI bus\n"); > + return -EINVAL; > + } > + > + dev_dbg(dev, "%d sensors found via SCMI bus\n", nr_sensors); > + > + for (i = 0; i < nr_sensors; i++) { > + sensor_info = handle->sensor_ops->info_get(handle, i); > + if (!sensor_info) { > + dev_err(dev, "SCMI sensor %d has missing info\n", i); > + return -EINVAL; > + } > + > + /* Skipping scalar sensor,as this driver only supports accel and gyro */ > + if (sensor_info->num_axis == 0) > + continue; > + > + err = scmi_alloc_iiodev(dev, handle, sensor_info, > + &scmi_iio_dev); > + if (err < 0) { > + dev_err(dev, > + "failed to allocate IIO device for sensor %s: %d\n", > + sensor_info->name, err); > + return err; > + } > + > + err = scmi_iio_buffers_setup(scmi_iio_dev); > + if (err < 0) { > + dev_err(dev, > + "IIO buffer setup error at sensor %s: %d\n", > + sensor_info->name, err); > + return err; > + } > + > + err = devm_iio_device_register(dev, scmi_iio_dev); > + if (err) { > + dev_err(dev, > + "IIO device registration failed at sensor %s: %d\n", > + sensor_info->name, err); > + return err; > + } > + } > + return err; > +} > + > +static const struct scmi_device_id scmi_id_table[] = { > + { SCMI_PROTOCOL_SENSOR, "iiodev" }, > + {}, > +}; > + > +MODULE_DEVICE_TABLE(scmi, scmi_id_table); > + > +static struct scmi_driver scmi_iiodev_driver = { > + .name = "scmi-sensor-iiodev", > + .probe = scmi_iio_dev_probe, > + .id_table = scmi_id_table, > +}; > + > +module_scmi_driver(scmi_iiodev_driver); > + > +MODULE_AUTHOR("Jyoti Bhayana <jbhayana@google.com>"); > +MODULE_DESCRIPTION("SCMI IIO Driver"); > +MODULE_LICENSE("GPL v2"); > -- > 2.30.0.280.ga3ce27912f-goog >
On 22.01.21 00:21, Jyoti Bhayana wrote: <snip> > + > +static int scmi_iio_get_sensor_max_range(struct iio_dev *iio_dev, int *val, > + int *val2) > +{ > + struct scmi_iio_priv *sensor = iio_priv(iio_dev); > + int max_range_high, max_range_low; > + long long max_range; > + > + /* > + * All the axes are supposed to have the same value for max range. > + * We are just using the values from the Axis 0 here. > + */ > + if (sensor->sensor_info->axis[0].extended_attrs) { > + max_range = sensor->sensor_info->axis[0].attrs.max_range; > + max_range_high = H32(max_range); > + max_range_low = L32(max_range); > + > + /* > + * As IIO Val types have no provision for 64 bit values, > + * and currently there are no known sensors using 64 bit > + * for the range, this driver only supports sensor with > + * 32 bit range value. > + */ This comment and the corresponding one in scmi_iio_get_sensor_min_range() seem to be misleading to me. The extrema will probably exceed 32 bits even for physical sensors which do have less than 32 bits of resolution. The reason is that the SCMI sensor management protocol does not transmit a `scale' value as used by IIO. Instead, SCMI transmits an exponent with base ten. So, an SCMI sensor with a unit/LSB value which is not a power of ten will have its unit/LSB value split into an exponent (with base ten) and a mantissa. The SCMI platform (which exposes the physical sensor) will have to incorporate the mantissa into the sensor value. The simplest approach is to just multiply the mantissa with the raw physical sensor value, which will use more bits than the raw physical sensor value, depending on the unit/LSB value (and on the split of the unit/LSB value into exponent and mantissa). So I think the comment should at least make clear that the overflow may also happen for physical sensors with less than 32 bit of resolution, since it cannot be assumed that SCMI platforms will, without any apparent need, restrict the values to 32 bits, when that would mean additional complexity and potential loss of accuracy. (And in the long term this driver could IMHO try to handle a greater value range by adjusting the `scale' value accordingly.) Best regards, Peter > + if (max_range_high != 0) > + return -EINVAL; > + > + *val = max_range_low; > + *val2 = 1; > + } > + return 0; > +} > + > +static void scmi_iio_get_sensor_resolution(struct iio_dev *iio_dev, int *val, > + int *val2) > +{ > + struct scmi_iio_priv *sensor = iio_priv(iio_dev); > + > + /* > + * All the axes are supposed to have the same value for resolution > + * and exponent. We are just using the values from the Axis 0 here. > + */ > + if (sensor->sensor_info->axis[0].extended_attrs) { > + uint resolution = sensor->sensor_info->axis[0].resolution; > + s8 exponent = sensor->sensor_info->axis[0].exponent; > + s8 scale = sensor->sensor_info->axis[0].scale; > + > + /* > + * To provide the raw value for the resolution to the userspace, > + * need to divide the resolution exponent by the sensor scale > + */ > + exponent = exponent - scale; > + if (exponent >= 0) { > + *val = resolution * int_pow(10, exponent); > + *val2 = 1; > + } else { > + *val = resolution; > + *val2 = int_pow(10, abs(exponent)); > + } > + } > +} > + > +static int scmi_iio_get_sensor_min_range(struct iio_dev *iio_dev, int *val, > + int *val2) > +{ > + struct scmi_iio_priv *sensor = iio_priv(iio_dev); > + int min_range_high, min_range_low; > + long long min_range; > + > + /* > + * All the axes are supposed to have the same value for min range. > + * We are just using the values from the Axis 0 here. > + */ > + if (sensor->sensor_info->axis[0].extended_attrs) { > + min_range = sensor->sensor_info->axis[0].attrs.min_range; > + min_range_high = H32(min_range); > + min_range_low = L32(min_range); > + > + /* > + * As IIO Val types have no provision for 64 bit values, > + * and currently there are no known sensors using 64 bit > + * for the range, this driver only supports sensor with > + * 32 bit range value. > + */ > + if (min_range_high != 0xFFFFFFFF) > + return -EINVAL; > + > + *val = min_range_low; > + *val2 = 1; > + } > + return 0; > +} > + > +static int scmi_iio_set_sensor_range_avail(struct iio_dev *iio_dev) > +{ > + struct scmi_iio_priv *sensor = iio_priv(iio_dev); > + int ret; > + > + ret = scmi_iio_get_sensor_min_range(iio_dev, &sensor->range_avail[0], > + &sensor->range_avail[1]); > + if (ret) > + return ret; > + > + scmi_iio_get_sensor_resolution(iio_dev, &sensor->range_avail[2], > + &sensor->range_avail[3]); > + ret = scmi_iio_get_sensor_max_range(iio_dev, &sensor->range_avail[4], > + &sensor->range_avail[5]); > + return ret; > +} > + > +static int scmi_iio_set_sampling_freq_avail(struct iio_dev *iio_dev) > +{ > + u64 cur_interval_ns, low_interval_ns, high_interval_ns, step_size_ns, > + hz, uhz; > + unsigned int cur_interval, low_interval, high_interval, step_size; > + struct scmi_iio_priv *sensor = iio_priv(iio_dev); > + int i; > + > + sensor->freq_avail = devm_kzalloc(&iio_dev->dev, > + sizeof(u32) * (sensor->sensor_info->intervals.count * 2), > + GFP_KERNEL); > + if (!sensor->freq_avail) > + return -ENOMEM; > + > + if (sensor->sensor_info->intervals.segmented) { > + low_interval = sensor->sensor_info->intervals > + .desc[SCMI_SENS_INTVL_SEGMENT_LOW]; > + low_interval_ns = scmi_iio_convert_interval_to_ns(low_interval); > + convert_ns_to_freq(low_interval_ns, &hz, &uhz); > + sensor->freq_avail[0] = hz; > + sensor->freq_avail[1] = uhz; > + > + step_size = sensor->sensor_info->intervals > + .desc[SCMI_SENS_INTVL_SEGMENT_STEP]; > + step_size_ns = scmi_iio_convert_interval_to_ns(step_size); > + convert_ns_to_freq(step_size_ns, &hz, &uhz); > + sensor->freq_avail[2] = hz; > + sensor->freq_avail[3] = uhz; > + > + high_interval = sensor->sensor_info->intervals > + .desc[SCMI_SENS_INTVL_SEGMENT_HIGH]; > + high_interval_ns = > + scmi_iio_convert_interval_to_ns(high_interval); > + convert_ns_to_freq(high_interval_ns, &hz, &uhz); > + sensor->freq_avail[4] = hz; > + sensor->freq_avail[5] = uhz; > + } else { > + for (i = 0; i < sensor->sensor_info->intervals.count; i++) { > + cur_interval = sensor->sensor_info->intervals.desc[i]; > + cur_interval_ns = scmi_iio_convert_interval_to_ns(cur_interval); > + convert_ns_to_freq(cur_interval_ns, &hz, &uhz); > + sensor->freq_avail[i * 2] = hz; > + sensor->freq_avail[i * 2 + 1] = uhz; > + } > + } > + return 0; > +} > + > +static int scmi_iio_buffers_setup(struct iio_dev *scmi_iiodev) > +{ > + struct iio_buffer *buffer; > + > + buffer = devm_iio_kfifo_allocate(&scmi_iiodev->dev); > + if (!buffer) > + return -ENOMEM; > + > + iio_device_attach_buffer(scmi_iiodev, buffer); > + scmi_iiodev->modes |= INDIO_BUFFER_SOFTWARE; > + scmi_iiodev->setup_ops = &scmi_iio_buffer_ops; > + return 0; > +} > + > +static int scmi_alloc_iiodev(struct device *dev, struct scmi_handle *handle, > + const struct scmi_sensor_info *sensor_info, > + struct iio_dev **scmi_iio_dev) > +{ > + struct iio_chan_spec *iio_channels; > + struct scmi_iio_priv *sensor; > + enum iio_modifier modifier; > + enum iio_chan_type type; > + struct iio_dev *iiodev; > + int i, ret; > + > + iiodev = devm_iio_device_alloc(dev, sizeof(*sensor)); > + if (!iiodev) > + return -ENOMEM; > + > + iiodev->modes = INDIO_DIRECT_MODE; > + iiodev->dev.parent = dev; > + sensor = iio_priv(iiodev); > + sensor->handle = handle; > + sensor->sensor_info = sensor_info; > + sensor->sensor_update_nb.notifier_call = scmi_iio_sensor_update_cb; > + sensor->indio_dev = iiodev; > + > + /* adding one additional channel for timestamp */ > + iiodev->num_channels = sensor_info->num_axis + 1; > + iiodev->name = sensor_info->name; > + iiodev->info = &scmi_iio_info; > + > + iio_channels = > + devm_kzalloc(dev, > + sizeof(*iio_channels) * (iiodev->num_channels), > + GFP_KERNEL); > + if (!iio_channels) > + return -ENOMEM; > + > + scmi_iio_set_sampling_freq_avail(iiodev); > + > + ret = scmi_iio_set_sensor_range_avail(iiodev); > + if (ret) { > + dev_err(dev, "Error while setting the sensor %s range %d", > + sensor_info->name, ret); > + return ret; > + } > + > + for (i = 0; i < sensor_info->num_axis; i++) { > + ret = scmi_iio_get_chan_type(sensor_info->axis[i].type, &type); > + if (ret < 0) > + return ret; > + > + ret = scmi_iio_get_chan_modifier(sensor_info->axis[i].name, > + &modifier); > + if (ret < 0) > + return ret; > + > + scmi_iio_set_data_channel(&iio_channels[i], type, modifier, > + sensor_info->axis[i].id); > + } > + > + scmi_iio_set_timestamp_channel(&iio_channels[i], i); > + iiodev->channels = iio_channels; > + *scmi_iio_dev = iiodev; > + return ret; > +} > + > +static int scmi_iio_dev_probe(struct scmi_device *sdev) > +{ > + const struct scmi_sensor_info *sensor_info; > + struct scmi_handle *handle = sdev->handle; > + struct device *dev = &sdev->dev; > + struct iio_dev *scmi_iio_dev; > + u16 nr_sensors; > + int err, i; > + > + if (!handle || !handle->sensor_ops || !handle->sensor_ops->count_get || > + !handle->sensor_ops->info_get || !handle->sensor_ops->config_get || > + !handle->sensor_ops->config_set) { > + dev_err(dev, "SCMI device has no sensor interface\n"); > + return -EINVAL; > + } > + > + nr_sensors = handle->sensor_ops->count_get(handle); > + if (!nr_sensors) { > + dev_dbg(dev, "0 sensors found via SCMI bus\n"); > + return -EINVAL; > + } > + > + dev_dbg(dev, "%d sensors found via SCMI bus\n", nr_sensors); > + > + for (i = 0; i < nr_sensors; i++) { > + sensor_info = handle->sensor_ops->info_get(handle, i); > + if (!sensor_info) { > + dev_err(dev, "SCMI sensor %d has missing info\n", i); > + return -EINVAL; > + } > + > + /* Skipping scalar sensor,as this driver only supports accel and gyro */ > + if (sensor_info->num_axis == 0) > + continue; > + > + err = scmi_alloc_iiodev(dev, handle, sensor_info, > + &scmi_iio_dev); > + if (err < 0) { > + dev_err(dev, > + "failed to allocate IIO device for sensor %s: %d\n", > + sensor_info->name, err); > + return err; > + } > + > + err = scmi_iio_buffers_setup(scmi_iio_dev); > + if (err < 0) { > + dev_err(dev, > + "IIO buffer setup error at sensor %s: %d\n", > + sensor_info->name, err); > + return err; > + } > + > + err = devm_iio_device_register(dev, scmi_iio_dev); > + if (err) { > + dev_err(dev, > + "IIO device registration failed at sensor %s: %d\n", > + sensor_info->name, err); > + return err; > + } > + } > + return err; > +} > + > +static const struct scmi_device_id scmi_id_table[] = { > + { SCMI_PROTOCOL_SENSOR, "iiodev" }, > + {}, > +}; > + > +MODULE_DEVICE_TABLE(scmi, scmi_id_table); > + > +static struct scmi_driver scmi_iiodev_driver = { > + .name = "scmi-sensor-iiodev", > + .probe = scmi_iio_dev_probe, > + .id_table = scmi_id_table, > +}; > + > +module_scmi_driver(scmi_iiodev_driver); > + > +MODULE_AUTHOR("Jyoti Bhayana <jbhayana@google.com>"); > +MODULE_DESCRIPTION("SCMI IIO Driver"); > +MODULE_LICENSE("GPL v2"); >
Hi Christian, I have addressed your feedback in v4 of the patch. Please find below the answers to some of your questions: > The initial sensor_config ORed here is NOT initialized nor zeroed. There is no need to initialize as it is already initialized to 0 when defined. > being not so familiar with IIO, may I ask when and how much frequently > these ops are called ? (given they include a register/unregister + > enable/disable every time) These are called whenever the sensor is enabled/disabled by writing to buffer/enable sysfs node >AFAIU this is called during IIO init and derives a modifier from the name >of the sensors which are passed by the platform fw with sensor descriptors, >so I would not trust them to be weell formed (:D) and try to be picky about >*name as it was user-input to validate. The SCMI specification has mentioned the naming convention for the axis as below . "A NULL terminated UTF-8 format string with the sensor axis name, of up to 16 bytes. It is recommended that the name ends with ‘_’ followed by the axis of the sensor in uppercase. For example, the name for the x-axis of a triaxial accelerometer could be “acc_X” or “_X” If there is any other better way to get the modifier, please let me know. > why not a break to a final 'return ret;' (with ret properly set) ? According to Jonathan, direct returns are preferred. >Not familiar with IIO, but is it fine to setup ops and modes AFTER >having attached the buffer to the scmi_iiodev ? >Is is not 'racy-possible' that the buffer is already operational without >any ops immediately after being attached ? I have looked at other IIO drivers and they all do it this way. Thanks, Jyoti On Fri, Jan 22, 2021 at 5:37 AM Cristian Marussi <cristian.marussi@arm.com> wrote: > > Hi Jyoti, > > a few remarks below. > > On Thu, Jan 21, 2021 at 11:21:47PM +0000, Jyoti Bhayana wrote: > > This change provides ARM SCMI Protocol based IIO device. > > This driver provides support for Accelerometer and Gyroscope using > > new SCMI Sensor Protocol defined by the upcoming SCMIv3.0 > > I'd say: > > new SCMI Sensor Protocol extension added by the upcoming SCMIv3.0 > > given that SCMI Sensor existed already in SCMIv2.0 > > > ARM specification > > > > Signed-off-by: Jyoti Bhayana <jbhayana@google.com> > > --- > > MAINTAINERS | 6 + > > drivers/iio/common/Kconfig | 1 + > > drivers/iio/common/Makefile | 1 + > > drivers/iio/common/scmi_sensors/Kconfig | 18 + > > drivers/iio/common/scmi_sensors/Makefile | 5 + > > drivers/iio/common/scmi_sensors/scmi_iio.c | 736 +++++++++++++++++++++ > > 6 files changed, 767 insertions(+) > > create mode 100644 drivers/iio/common/scmi_sensors/Kconfig > > create mode 100644 drivers/iio/common/scmi_sensors/Makefile > > create mode 100644 drivers/iio/common/scmi_sensors/scmi_iio.c > > > > diff --git a/MAINTAINERS b/MAINTAINERS > > index b516bb34a8d5..ccf37d43ab41 100644 > > --- a/MAINTAINERS > > +++ b/MAINTAINERS > > @@ -8567,6 +8567,12 @@ S: Maintained > > F: Documentation/devicetree/bindings/iio/multiplexer/io-channel-mux.txt > > F: drivers/iio/multiplexer/iio-mux.c > > > > +IIO SCMI BASED DRIVER > > +M: Jyoti Bhayana <jbhayana@google.com> > > +L: linux-iio@vger.kernel.org > > +S: Maintained > > +F: drivers/iio/common/scmi_sensors/scmi_iio.c > > + > > IIO SUBSYSTEM AND DRIVERS > > M: Jonathan Cameron <jic23@kernel.org> > > R: Lars-Peter Clausen <lars@metafoo.de> > > diff --git a/drivers/iio/common/Kconfig b/drivers/iio/common/Kconfig > > index 2b9ee9161abd..0334b4954773 100644 > > --- a/drivers/iio/common/Kconfig > > +++ b/drivers/iio/common/Kconfig > > @@ -6,5 +6,6 @@ > > source "drivers/iio/common/cros_ec_sensors/Kconfig" > > source "drivers/iio/common/hid-sensors/Kconfig" > > source "drivers/iio/common/ms_sensors/Kconfig" > > +source "drivers/iio/common/scmi_sensors/Kconfig" > > source "drivers/iio/common/ssp_sensors/Kconfig" > > source "drivers/iio/common/st_sensors/Kconfig" > > diff --git a/drivers/iio/common/Makefile b/drivers/iio/common/Makefile > > index 4bc30bb548e2..fad40e1e1718 100644 > > --- a/drivers/iio/common/Makefile > > +++ b/drivers/iio/common/Makefile > > @@ -11,5 +11,6 @@ > > obj-y += cros_ec_sensors/ > > obj-y += hid-sensors/ > > obj-y += ms_sensors/ > > +obj-y += scmi_sensors/ > > obj-y += ssp_sensors/ > > obj-y += st_sensors/ > > diff --git a/drivers/iio/common/scmi_sensors/Kconfig b/drivers/iio/common/scmi_sensors/Kconfig > > new file mode 100644 > > index 000000000000..67e084cbb1ab > > --- /dev/null > > +++ b/drivers/iio/common/scmi_sensors/Kconfig > > @@ -0,0 +1,18 @@ > > +# > > +# IIO over SCMI > > +# > > +# When adding new entries keep the list in alphabetical order > > + > > +menu "IIO SCMI Sensors" > > + > > +config IIO_SCMI > > + tristate "IIO SCMI" > > + depends on ARM_SCMI_PROTOCOL > > + select IIO_BUFFER > > + select IIO_KFIFO_BUF > > + help > > + Say yes here to build support for IIO SCMI Driver. > > + This provides ARM SCMI Protocol based IIO device. > > + This driver provides support for accelerometer and gyroscope > > + sensors available on SCMI based platforms. > > +endmenu > > diff --git a/drivers/iio/common/scmi_sensors/Makefile b/drivers/iio/common/scmi_sensors/Makefile > > new file mode 100644 > > index 000000000000..f13140a2575a > > --- /dev/null > > +++ b/drivers/iio/common/scmi_sensors/Makefile > > @@ -0,0 +1,5 @@ > > +# SPDX - License - Identifier : GPL - 2.0 - only > > +# > > +# Makefile for the IIO over SCMI > > +# > > +obj-$(CONFIG_IIO_SCMI) += scmi_iio.o > > diff --git a/drivers/iio/common/scmi_sensors/scmi_iio.c b/drivers/iio/common/scmi_sensors/scmi_iio.c > > new file mode 100644 > > index 000000000000..3b76cc54511c > > --- /dev/null > > +++ b/drivers/iio/common/scmi_sensors/scmi_iio.c > > @@ -0,0 +1,736 @@ > > +// SPDX-License-Identifier: GPL-2.0 > > + > > +/* > > + * System Control and Management Interface(SCMI) based IIO sensor driver > > + * > > + * Copyright (C) 2020 Google LLC > > + */ > > + > > +#include <linux/delay.h> > > +#include <linux/err.h> > > +#include <linux/iio/buffer.h> > > +#include <linux/iio/iio.h> > > +#include <linux/iio/kfifo_buf.h> > > +#include <linux/iio/sysfs.h> > > +#include <linux/kernel.h> > > +#include <linux/kthread.h> > > +#include <linux/module.h> > > +#include <linux/scmi_protocol.h> > > +#include <linux/time.h> > > +#include <linux/types.h> > > + > > +#define ilog10(x) (ilog2(x) / const_ilog2(10)) > > +#define UHZ_PER_HZ 1000000UL > > +#define ODR_EXPAND(odr, uodr) (((odr) * 1000000ULL) + (uodr)) > > +#define MAX_NUM_OF_CHANNELS 4 > > +#define H32(x) (((x) & 0xFFFFFFFF00000000LL) >> 32) > > +#define L32(x) ((x) & 0xFFFFFFFFLL) > > Probaly you want to use GENMASK here to define the masks, and not sure > but maybe there are already similar macros in linux to extract > upper/lower 32 bits. > > > + > > +struct scmi_iio_priv { > > + struct scmi_handle *handle; > > + const struct scmi_sensor_info *sensor_info; > > + struct iio_dev *indio_dev; > > + long long iio_buf[MAX_NUM_OF_CHANNELS]; > > + struct notifier_block sensor_update_nb; > > + u32 *freq_avail; > > + /* > > + * range_avail = [minRange resolution maxRange] > > + * with IIO val type as IIO_VAL_FRACTIONAL. > > + * Hence, array of size 6. > > + */ > > + int range_avail[6]; > > +}; > > + > > +static int scmi_iio_sensor_update_cb(struct notifier_block *nb, > > + unsigned long event, void *data) > > +{ > > + struct scmi_sensor_update_report *sensor_update = data; > > + struct iio_dev *scmi_iio_dev; > > + struct scmi_iio_priv *sensor; > > + s8 tstamp_scale; > > + u64 time, time_ns; > > + int i; > > + > > + if (sensor_update->readings_count == 0) > > + return NOTIFY_DONE; > > + > > + sensor = container_of(nb, struct scmi_iio_priv, sensor_update_nb); > > + > > + for (i = 0; i < sensor_update->readings_count; i++) > > + sensor->iio_buf[i] = sensor_update->readings[i].value; > > + > > + if (!sensor->sensor_info->timestamped) { > > + time_ns = iio_get_time_ns(scmi_iio_dev); > > This scmi_iio_dev is on the stack and still NOT initialized here right ? > > Moreover, if this is meant to attach a timestamp of arrival also to > NON-timestamped sensor notifications, note that, if you want, scmi_sensor_update_report > contains a 'timestamp' (as all SCMI notif reports) ktime field (ns) which > represents the time (ns from boot with ktime_get_boottime()) of reception > of this notification taken by the SCMI core as soon as it arrives in the > RX ISR. (so in the OSPM Linux world) > > If you grab the timestamp here with iio_get_time_ns() you are indeed > getting a timestamp inside the notification callback so at the end of > the notifications processing chain, i.e. in a deferred worker processing > this queue of events and in turn calling this function, so potentially > you're timestamping a lot later than when the event arrived really in > the OSPM world (especially on a loaded system); it is more the time of > arrival in IIO framework. > > On the other side timestamped events handled in the else-branch down > below carry a timestamp set by the SCMI platform fw early on when the > event has been detected by the sensor in the real world. > > Not sure how these values are used at the end, but just to let you know > this detail if it was not apparent. > > > + } else { > > + /* > > + * All the axes are supposed to have the same value for timestamp. > > + * We are just using the values from the Axis 0 here. > > + */ > > + time = sensor_update->readings[0].timestamp; > > + > > + /* > > + * Timestamp returned by SCMI is in seconds and is equal to > > + * time * power-of-10 multiplier(tstamp_scale) seconds. > > + * Converting the timestamp to nanoseconds below. > > + */ > > + tstamp_scale = sensor->sensor_info->tstamp_scale + > > + ilog10(NSEC_PER_SEC); > > + if (tstamp_scale < 0) > > + time_ns = div64_u64(time, > > + int_pow(10, abs(tstamp_scale))); > > + else > > + time_ns = time * int_pow(10, tstamp_scale); > > + } > > + > > + scmi_iio_dev = sensor->indio_dev; > > + iio_push_to_buffers_with_timestamp(scmi_iio_dev, sensor->iio_buf, > > + time_ns); > > + return NOTIFY_OK; > > +} > > + > > +static int scmi_iio_buffer_preenable(struct iio_dev *iio_dev) > > +{ > > + struct scmi_iio_priv *sensor = iio_priv(iio_dev); > > + u32 sensor_id = sensor->sensor_info->id; > > + u32 sensor_config; > > + int err; > > + > > + if (sensor->sensor_info->timestamped) > > + sensor_config |= FIELD_PREP(SCMI_SENS_CFG_TSTAMP_ENABLED_MASK, > > + SCMI_SENS_CFG_TSTAMP_ENABLE); > > The initial sensor_config ORed here is NOT initialized nor zeroed. > > + > > + sensor_config |= FIELD_PREP(SCMI_SENS_CFG_SENSOR_ENABLED_MASK, > > + SCMI_SENS_CFG_SENSOR_ENABLE); > > + > > + err = sensor->handle->notify_ops->register_event_notifier(sensor->handle, > > + SCMI_PROTOCOL_SENSOR, SCMI_EVENT_SENSOR_UPDATE, > > + &sensor_id, &sensor->sensor_update_nb); > > + if (err) { > > + dev_err(&iio_dev->dev, > > + "Error in registering sensor update notifier for sensor %s err %d", > > + sensor->sensor_info->name, err); > > + return err; > > + } > > + > > + err = sensor->handle->sensor_ops->config_set(sensor->handle, > > + sensor->sensor_info->id, sensor_config); > > + if (err) > > + dev_err(&iio_dev->dev, "Error in enabling sensor %s err %d", > > + sensor->sensor_info->name, err); > > Here you do not unregister the notification above here when you fail > the config_set. > If you happen to retry this code path again you'll end up registering > the same notifier_block sensor_update_nb() in the same notification chain > (same event samme sensor_id), which is broken and probably triggers a WARN > from the core kernel notification chains machinery too. > > In an upcoming series on SCMI core I'll introduce a devm_ variant for > SCMI notification registration, but as of now you have to properly unregister > on error paths. > > > + > > + return err; > > +} > > + > > +static int scmi_iio_buffer_postdisable(struct iio_dev *iio_dev) > > +{ > > + struct scmi_iio_priv *sensor = iio_priv(iio_dev); > > + u32 sensor_id = sensor->sensor_info->id; > > + u32 sensor_config = 0; > > + int err; > > + > > + sensor_config |= FIELD_PREP(SCMI_SENS_CFG_SENSOR_ENABLED_MASK, > > + SCMI_SENS_CFG_SENSOR_DISABLE); > > + > > + err = sensor->handle->notify_ops->unregister_event_notifier(sensor->handle, > > + SCMI_PROTOCOL_SENSOR, SCMI_EVENT_SENSOR_UPDATE, > > + &sensor_id, &sensor->sensor_update_nb); > > This alignment here is a bit awkaward. > > > + if (err) { > > + dev_err(&iio_dev->dev, > > + "Error in unregistering sensor update notifier for sensor %s err %d", > > + sensor->sensor_info->name, err); > > + return err; > > + } > > + > > + err = sensor->handle->sensor_ops->config_set(sensor->handle, sensor_id, > > + sensor_config); > > + if (err) > > + dev_err(&iio_dev->dev, > > + "Error in disabling sensor %s with err %d", > > + sensor->sensor_info->name, err); > > + > > + return err; > > +} > > + > > +static const struct iio_buffer_setup_ops scmi_iio_buffer_ops = { > > + .preenable = scmi_iio_buffer_preenable, > > + .postdisable = scmi_iio_buffer_postdisable, > > +}; > > + > > Being not so familiar with IIO, may I ask when annd ho wmuch frequently > these ops are called ? (given they include a register/unregister + > enable/disable every time) > > > +static int scmi_iio_read_avail(struct iio_dev *iio_dev, > > + struct iio_chan_spec const *chan, > > + const int **vals, int *type, int *length, > > + long mask) > > +{ > > + struct scmi_iio_priv *sensor = iio_priv(iio_dev); > > + > > + switch (mask) { > > + case IIO_CHAN_INFO_SAMP_FREQ: > > + *vals = sensor->freq_avail; > > + *type = IIO_VAL_INT_PLUS_MICRO; > > + *length = sensor->sensor_info->intervals.count * 2; > > + if (sensor->sensor_info->intervals.segmented) > > + return IIO_AVAIL_RANGE; > > + else > > + return IIO_AVAIL_LIST; > > + case IIO_CHAN_INFO_RAW: > > + *vals = sensor->range_avail; > > + *type = IIO_VAL_FRACTIONAL; > > + *length = ARRAY_SIZE(sensor->range_avail); > > + return IIO_AVAIL_RANGE; > > + default: > > + return -EINVAL; > > + } > > +} > > + > > +static int scmi_iio_set_odr_val(struct iio_dev *iio_dev, int val, int val2) > > +{ > > + struct scmi_iio_priv *sensor = iio_priv(iio_dev); > > + u64 sec, mult, uHz; > > + u32 sensor_config; > > + > > + int err = sensor->handle->sensor_ops->config_get(sensor->handle, > > + sensor->sensor_info->id, &sensor_config); > > + if (err) { > > + dev_err(&iio_dev->dev, > > + "Error in getting sensor config for sensor %s err %d", > > + sensor->sensor_info->name, err); > > + return err; > > + } > > + > > + uHz = ODR_EXPAND(val, val2); > > + > > + /* > > + * The seconds field in the sensor interval in SCMI is 16 bits long > > + * Therefore seconds = 1/Hz <= 0xFFFF. As floating point calculations are > > + * discouraged in the kernel driver code, to calculate the scale factor (sf) > > + * (1* 1000000 * sf)/uHz <= 0xFFFF. Therefore, sf <= (uHz * 0xFFFF)/1000000 > > + */ > > + mult = ilog10(((u64)uHz * 0xFFFF) / UHZ_PER_HZ); > > + > > + sec = div64_u64(int_pow(10, mult) * UHZ_PER_HZ, uHz); > > + if (sec == 0) { > > + dev_err(&iio_dev->dev, > > + "Trying to set invalid sensor update value for sensor %s", > > + sensor->sensor_info->name); > > + return -EINVAL; > > + } > > + > > + sensor_config &= ~SCMI_SENS_CFG_UPDATE_SECS_MASK; > > + sensor_config |= FIELD_PREP(SCMI_SENS_CFG_UPDATE_SECS_MASK, sec); > > + sensor_config &= ~SCMI_SENS_CFG_UPDATE_EXP_MASK; > > + sensor_config |= FIELD_PREP(SCMI_SENS_CFG_UPDATE_EXP_MASK, -mult); > > + > > + if (sensor->sensor_info->timestamped) { > > + sensor_config &= ~SCMI_SENS_CFG_TSTAMP_ENABLED_MASK; > > + sensor_config |= FIELD_PREP(SCMI_SENS_CFG_TSTAMP_ENABLED_MASK, > > + SCMI_SENS_CFG_TSTAMP_ENABLE); > > + } > > + > > + sensor_config &= ~SCMI_SENS_CFG_ROUND_MASK; > > + sensor_config |= > > + FIELD_PREP(SCMI_SENS_CFG_ROUND_MASK, SCMI_SENS_CFG_ROUND_AUTO); > > + > > + err = sensor->handle->sensor_ops->config_set(sensor->handle, > > + sensor->sensor_info->id, sensor_config); > > + if (err) > > + dev_err(&iio_dev->dev, > > + "Error in setting sensor update interval for sensor %s value %u err %d", > > + sensor->sensor_info->name, sensor_config, err); > > + > > + return err; > > +} > > + > > +static int scmi_iio_write_raw(struct iio_dev *iio_dev, > > + struct iio_chan_spec const *chan, int val, > > + int val2, long mask) > > +{ > > + int err; > > + > > + switch (mask) { > > + case IIO_CHAN_INFO_SAMP_FREQ: > > + mutex_lock(&iio_dev->mlock); > > + err = scmi_iio_set_odr_val(iio_dev, val, val2); > > + mutex_unlock(&iio_dev->mlock); > > + return err; > > + default: > > + return -EINVAL; > > + } > > +} > > + > > +static u64 scmi_iio_convert_interval_to_ns(u32 val) > > +{ > > + u64 sensor_update_interval = > > + SCMI_SENS_INTVL_GET_SECS(val) * NSEC_PER_SEC; > > + u64 sensor_interval_mult; > > + int mult; > > + > > + mult = SCMI_SENS_INTVL_GET_EXP(val); > > + if (mult < 0) { > > + sensor_interval_mult = int_pow(10, abs(mult)); > > + sensor_update_interval = > > + sensor_update_interval / sensor_interval_mult; > > + } else { > > + sensor_interval_mult = int_pow(10, mult); > > + sensor_update_interval = > > + sensor_update_interval * sensor_interval_mult; > > + } > > + return sensor_update_interval; > > +} > > + > > +static void convert_ns_to_freq(u64 interval_ns, u64 *hz, u64 *uhz) > > +{ > > + u64 rem; > > + > > + *hz = div64_u64_rem(NSEC_PER_SEC, interval_ns, &rem); > > + *uhz = (rem * 1000000UL) / interval_ns; > > +} > > + > > +static int scmi_iio_get_odr_val(struct iio_dev *iio_dev, int *val, int *val2) > > +{ > > + u64 sensor_update_interval, sensor_interval_mult, hz, uhz; > > + struct scmi_iio_priv *sensor = iio_priv(iio_dev); > > + u32 sensor_config; > > + int mult; > > + > > + int err = sensor->handle->sensor_ops->config_get(sensor->handle, > > + sensor->sensor_info->id, &sensor_config); > > + if (err) { > > + dev_err(&iio_dev->dev, > > + "Error in getting sensor config for sensor %s err %d", > > + sensor->sensor_info->name, err); > > + return err; > > + } > > + > > + sensor_update_interval = > > + SCMI_SENS_CFG_GET_UPDATE_SECS(sensor_config) * NSEC_PER_SEC; > > + > > + mult = SCMI_SENS_CFG_GET_UPDATE_EXP(sensor_config); > > + if (mult < 0) { > > + sensor_interval_mult = int_pow(10, abs(mult)); > > + sensor_update_interval = > > + sensor_update_interval / sensor_interval_mult; > > + } else { > > + sensor_interval_mult = int_pow(10, mult); > > + sensor_update_interval = > > + sensor_update_interval * sensor_interval_mult; > > + } > > + > > + convert_ns_to_freq(sensor_update_interval, &hz, &uhz); > > + *val = hz; > > + *val2 = uhz; > > + return 0; > > +} > > + > > +static int scmi_iio_read_raw(struct iio_dev *iio_dev, > > + struct iio_chan_spec const *ch, int *val, > > + int *val2, long mask) > > +{ > > + struct scmi_iio_priv *sensor = iio_priv(iio_dev); > > + s8 scale; > > + int ret; > > + > > + switch (mask) { > > + case IIO_CHAN_INFO_SCALE: > > + scale = sensor->sensor_info->axis[ch->scan_index].scale; > > + if (scale < 0) { > > + *val = 1; > > + *val2 = int_pow(10, abs(scale)); > > + return IIO_VAL_FRACTIONAL; > > + } > > + *val = int_pow(10, scale); > > + return IIO_VAL_INT; > > + case IIO_CHAN_INFO_SAMP_FREQ: > > + ret = scmi_iio_get_odr_val(iio_dev, val, val2); > > + return ret ? ret : IIO_VAL_INT_PLUS_MICRO; > > + default: > > + return -EINVAL; > > + } > > +} > > + > > +static const struct iio_info scmi_iio_info = { > > + .read_raw = scmi_iio_read_raw, > > + .read_avail = scmi_iio_read_avail, > > + .write_raw = scmi_iio_write_raw, > > +}; > > + > > +static void scmi_iio_set_timestamp_channel(struct iio_chan_spec *iio_chan, > > + int scan_index) > > +{ > > + iio_chan->type = IIO_TIMESTAMP; > > + iio_chan->channel = -1; > > + iio_chan->scan_index = scan_index; > > + iio_chan->scan_type.sign = 'u'; > > + iio_chan->scan_type.realbits = 64; > > + iio_chan->scan_type.storagebits = 64; > > +} > > + > > +static void scmi_iio_set_data_channel(struct iio_chan_spec *iio_chan, > > + enum iio_chan_type type, > > + enum iio_modifier mod, int scan_index) > > +{ > > + iio_chan->type = type; > > + iio_chan->modified = 1; > > + iio_chan->channel2 = mod; > > + iio_chan->info_mask_separate = BIT(IIO_CHAN_INFO_SCALE); > > + iio_chan->info_mask_shared_by_type = BIT(IIO_CHAN_INFO_SAMP_FREQ); > > + iio_chan->info_mask_shared_by_type_available = > > + BIT(IIO_CHAN_INFO_SAMP_FREQ) | BIT(IIO_CHAN_INFO_RAW); > > + iio_chan->scan_index = scan_index; > > + iio_chan->scan_type.sign = 's'; > > + iio_chan->scan_type.realbits = 64; > > + iio_chan->scan_type.storagebits = 64; > > + iio_chan->scan_type.endianness = IIO_LE; > > +} > > + > > +static int scmi_iio_get_chan_modifier(const char *name, > > + enum iio_modifier *modifier) > > +{ > > AFAIU this is called during IIO init and derives a modifier from the name > of the sensors which are passed by the platform fw with sensor descriptors, > so I would not trust them to be weell formed (:D) and try to be picky about > *name as it was user-input to validate. > > > + char *pch; > > + > > + pch = strrchr(name, '_'); > > What happens if name is NULL ? > > > + if (!pch) > > + return -EINVAL; > > + > > + if (strcmp(pch + 1, "X") == 0) { > > + *modifier = IIO_MOD_X; > > + return 0; > > + } else if (strcmp(pch + 1, "Y") == 0) { > > + *modifier = IIO_MOD_Y; > > + return 0; > > + } else if (strcmp(pch + 1, "Z") == 0) { > > + *modifier = IIO_MOD_Z; > > + return 0; > > + } else { > > + return -EINVAL; > > + } > > Moroever, being a single char compare cannot this be done with a switch ? > > char mod = *(pch + 1); > > switch(mod) { > case 'X': > *modifier = IIO_MOD_X; > break > ... > > > +} > > + > > +static int scmi_iio_get_chan_type(u8 scmi_type, enum iio_chan_type *iio_type) > > +{ > > + switch (scmi_type) { > > + case METERS_SEC_SQUARED: > > + *iio_type = IIO_ACCEL; > > + return 0; > why not a break to a final 'return ret;' (with ret properly set) ? > > > + case RADIANS_SEC: > > + *iio_type = IIO_ANGL_VEL; > > + return 0; > > + default: > > + return -EINVAL; > > + } > > +} > > + > > +static int scmi_iio_get_sensor_max_range(struct iio_dev *iio_dev, int *val, > > + int *val2) > > +{ > > + struct scmi_iio_priv *sensor = iio_priv(iio_dev); > > + int max_range_high, max_range_low; > > + long long max_range; > > + > > + /* > > + * All the axes are supposed to have the same value for max range. > > + * We are just using the values from the Axis 0 here. > > + */ > > + if (sensor->sensor_info->axis[0].extended_attrs) { > > + max_range = sensor->sensor_info->axis[0].attrs.max_range; > > + max_range_high = H32(max_range); > > + max_range_low = L32(max_range); > > + > > + /* > > + * As IIO Val types have no provision for 64 bit values, > > + * and currently there are no known sensors using 64 bit > > + * for the range, this driver only supports sensor with > > + * 32 bit range value. > > + */ > > + if (max_range_high != 0) > > + return -EINVAL; > > + > > + *val = max_range_low; > > + *val2 = 1; > > + } > > + return 0; > > +} > > + > > +static void scmi_iio_get_sensor_resolution(struct iio_dev *iio_dev, int *val, > > + int *val2) > > +{ > > + struct scmi_iio_priv *sensor = iio_priv(iio_dev); > > + > > + /* > > + * All the axes are supposed to have the same value for resolution > > + * and exponent. We are just using the values from the Axis 0 here. > > + */ > > + if (sensor->sensor_info->axis[0].extended_attrs) { > > + uint resolution = sensor->sensor_info->axis[0].resolution; > > + s8 exponent = sensor->sensor_info->axis[0].exponent; > > + s8 scale = sensor->sensor_info->axis[0].scale; > > + > > + /* > > + * To provide the raw value for the resolution to the userspace, > > + * need to divide the resolution exponent by the sensor scale > > + */ > > + exponent = exponent - scale; > > + if (exponent >= 0) { > > + *val = resolution * int_pow(10, exponent); > > + *val2 = 1; > > + } else { > > + *val = resolution; > > + *val2 = int_pow(10, abs(exponent)); > > + } > > + } > > +} > > + > > +static int scmi_iio_get_sensor_min_range(struct iio_dev *iio_dev, int *val, > > + int *val2) > > +{ > > + struct scmi_iio_priv *sensor = iio_priv(iio_dev); > > + int min_range_high, min_range_low; > > + long long min_range; > > + > > + /* > > + * All the axes are supposed to have the same value for min range. > > + * We are just using the values from the Axis 0 here. > > + */ > > + if (sensor->sensor_info->axis[0].extended_attrs) { > > + min_range = sensor->sensor_info->axis[0].attrs.min_range; > > + min_range_high = H32(min_range); > > + min_range_low = L32(min_range); > > + > > + /* > > + * As IIO Val types have no provision for 64 bit values, > > + * and currently there are no known sensors using 64 bit > > + * for the range, this driver only supports sensor with > > + * 32 bit range value. > > + */ > > + if (min_range_high != 0xFFFFFFFF) > > + return -EINVAL; > > + > > + *val = min_range_low; > > + *val2 = 1; > > + } > > + return 0; > > +} > > + > > +static int scmi_iio_set_sensor_range_avail(struct iio_dev *iio_dev) > > +{ > > + struct scmi_iio_priv *sensor = iio_priv(iio_dev); > > + int ret; > > + > > + ret = scmi_iio_get_sensor_min_range(iio_dev, &sensor->range_avail[0], > > + &sensor->range_avail[1]); > > + if (ret) > > + return ret; > > + > > + scmi_iio_get_sensor_resolution(iio_dev, &sensor->range_avail[2], > > + &sensor->range_avail[3]); > > + ret = scmi_iio_get_sensor_max_range(iio_dev, &sensor->range_avail[4], > > + &sensor->range_avail[5]); > > + return ret; > > +} > > + > > +static int scmi_iio_set_sampling_freq_avail(struct iio_dev *iio_dev) > > +{ > > + u64 cur_interval_ns, low_interval_ns, high_interval_ns, step_size_ns, > > + hz, uhz; > > + unsigned int cur_interval, low_interval, high_interval, step_size; > > + struct scmi_iio_priv *sensor = iio_priv(iio_dev); > > + int i; > > + > > + sensor->freq_avail = devm_kzalloc(&iio_dev->dev, > > + sizeof(u32) * (sensor->sensor_info->intervals.count * 2), > > + GFP_KERNEL); > > + if (!sensor->freq_avail) > > + return -ENOMEM; > > + > > + if (sensor->sensor_info->intervals.segmented) { > > + low_interval = sensor->sensor_info->intervals > > + .desc[SCMI_SENS_INTVL_SEGMENT_LOW]; > > + low_interval_ns = scmi_iio_convert_interval_to_ns(low_interval); > > + convert_ns_to_freq(low_interval_ns, &hz, &uhz); > > + sensor->freq_avail[0] = hz; > > + sensor->freq_avail[1] = uhz; > > + > > + step_size = sensor->sensor_info->intervals > > + .desc[SCMI_SENS_INTVL_SEGMENT_STEP]; > > + step_size_ns = scmi_iio_convert_interval_to_ns(step_size); > > + convert_ns_to_freq(step_size_ns, &hz, &uhz); > > + sensor->freq_avail[2] = hz; > > + sensor->freq_avail[3] = uhz; > > + > > + high_interval = sensor->sensor_info->intervals > > + .desc[SCMI_SENS_INTVL_SEGMENT_HIGH]; > > + high_interval_ns = > > + scmi_iio_convert_interval_to_ns(high_interval); > > + convert_ns_to_freq(high_interval_ns, &hz, &uhz); > > + sensor->freq_avail[4] = hz; > > + sensor->freq_avail[5] = uhz; > > + } else { > > + for (i = 0; i < sensor->sensor_info->intervals.count; i++) { > > + cur_interval = sensor->sensor_info->intervals.desc[i]; > > + cur_interval_ns = scmi_iio_convert_interval_to_ns(cur_interval); > > + convert_ns_to_freq(cur_interval_ns, &hz, &uhz); > > + sensor->freq_avail[i * 2] = hz; > > + sensor->freq_avail[i * 2 + 1] = uhz; > > + } > > + } > > + return 0; > > +} > > + > > +static int scmi_iio_buffers_setup(struct iio_dev *scmi_iiodev) > > +{ > > + struct iio_buffer *buffer; > > + > > + buffer = devm_iio_kfifo_allocate(&scmi_iiodev->dev); > > + if (!buffer) > > + return -ENOMEM; > > + > > + iio_device_attach_buffer(scmi_iiodev, buffer); > > + scmi_iiodev->modes |= INDIO_BUFFER_SOFTWARE; > > + scmi_iiodev->setup_ops = &scmi_iio_buffer_ops; > > Not familiar with IIO, but is it fine to setup ops and modes AFTER > having attached the buffer to the scmi_iiodev ? > > Is is not 'racy-possible' that the buffer is already operational without > any ops immediately after being attached ? > > > + return 0; > > +} > > + > > +static int scmi_alloc_iiodev(struct device *dev, struct scmi_handle *handle, > > + const struct scmi_sensor_info *sensor_info, > > + struct iio_dev **scmi_iio_dev) > > +{ > > + struct iio_chan_spec *iio_channels; > > + struct scmi_iio_priv *sensor; > > + enum iio_modifier modifier; > > + enum iio_chan_type type; > > + struct iio_dev *iiodev; > > + int i, ret; > > + > > + iiodev = devm_iio_device_alloc(dev, sizeof(*sensor)); > > + if (!iiodev) > > + return -ENOMEM; > > + > > + iiodev->modes = INDIO_DIRECT_MODE; > > + iiodev->dev.parent = dev; > > + sensor = iio_priv(iiodev); > > + sensor->handle = handle; > > + sensor->sensor_info = sensor_info; > > + sensor->sensor_update_nb.notifier_call = scmi_iio_sensor_update_cb; > > + sensor->indio_dev = iiodev; > > + > > + /* adding one additional channel for timestamp */ > > + iiodev->num_channels = sensor_info->num_axis + 1; > > + iiodev->name = sensor_info->name; > > + iiodev->info = &scmi_iio_info; > > + > > + iio_channels = > > + devm_kzalloc(dev, > > + sizeof(*iio_channels) * (iiodev->num_channels), > > + GFP_KERNEL); > > + if (!iio_channels) > > + return -ENOMEM; > > + > > + scmi_iio_set_sampling_freq_avail(iiodev); > > + > > + ret = scmi_iio_set_sensor_range_avail(iiodev); > > + if (ret) { > > + dev_err(dev, "Error while setting the sensor %s range %d", > > + sensor_info->name, ret); > > + return ret; > > + } > > + > > + for (i = 0; i < sensor_info->num_axis; i++) { > > + ret = scmi_iio_get_chan_type(sensor_info->axis[i].type, &type); > > + if (ret < 0) > > + return ret; > > + > > + ret = scmi_iio_get_chan_modifier(sensor_info->axis[i].name, > > + &modifier); > > + if (ret < 0) > > + return ret; > > + > > + scmi_iio_set_data_channel(&iio_channels[i], type, modifier, > > + sensor_info->axis[i].id); > > + } > > + > > + scmi_iio_set_timestamp_channel(&iio_channels[i], i); > > + iiodev->channels = iio_channels; > > + *scmi_iio_dev = iiodev; > > + return ret; > > +} > > + > > +static int scmi_iio_dev_probe(struct scmi_device *sdev) > > +{ > > + const struct scmi_sensor_info *sensor_info; > > + struct scmi_handle *handle = sdev->handle; > > + struct device *dev = &sdev->dev; > > + struct iio_dev *scmi_iio_dev; > > + u16 nr_sensors; > > + int err, i; > > + > > + if (!handle || !handle->sensor_ops || !handle->sensor_ops->count_get || > > + !handle->sensor_ops->info_get || !handle->sensor_ops->config_get || > > + !handle->sensor_ops->config_set) { > > In all other SCMI driver we just check for: > > !handle && !handle->sensor_ops > > it should be enough, since all the ops are defined if the stack you are > using supports SCMIv3.0, if not this driver would not even compile since > some SCMIv3.0 Sensor Extension sensor_ops would be missing as a whole > inside the struct itself. > > Thanks > > Cristian > > > + dev_err(dev, "SCMI device has no sensor interface\n"); > > + return -EINVAL; > > + } > > + > > + nr_sensors = handle->sensor_ops->count_get(handle); > > + if (!nr_sensors) { > > + dev_dbg(dev, "0 sensors found via SCMI bus\n"); > > + return -EINVAL; > > + } > > + > > + dev_dbg(dev, "%d sensors found via SCMI bus\n", nr_sensors); > > + > > + for (i = 0; i < nr_sensors; i++) { > > + sensor_info = handle->sensor_ops->info_get(handle, i); > > + if (!sensor_info) { > > + dev_err(dev, "SCMI sensor %d has missing info\n", i); > > + return -EINVAL; > > + } > > + > > + /* Skipping scalar sensor,as this driver only supports accel and gyro */ > > + if (sensor_info->num_axis == 0) > > + continue; > > + > > + err = scmi_alloc_iiodev(dev, handle, sensor_info, > > + &scmi_iio_dev); > > + if (err < 0) { > > + dev_err(dev, > > + "failed to allocate IIO device for sensor %s: %d\n", > > + sensor_info->name, err); > > + return err; > > + } > > + > > + err = scmi_iio_buffers_setup(scmi_iio_dev); > > + if (err < 0) { > > + dev_err(dev, > > + "IIO buffer setup error at sensor %s: %d\n", > > + sensor_info->name, err); > > + return err; > > + } > > + > > + err = devm_iio_device_register(dev, scmi_iio_dev); > > + if (err) { > > + dev_err(dev, > > + "IIO device registration failed at sensor %s: %d\n", > > + sensor_info->name, err); > > + return err; > > + } > > + } > > + return err; > > +} > > + > > +static const struct scmi_device_id scmi_id_table[] = { > > + { SCMI_PROTOCOL_SENSOR, "iiodev" }, > > + {}, > > +}; > > + > > +MODULE_DEVICE_TABLE(scmi, scmi_id_table); > > + > > +static struct scmi_driver scmi_iiodev_driver = { > > + .name = "scmi-sensor-iiodev", > > + .probe = scmi_iio_dev_probe, > > + .id_table = scmi_id_table, > > +}; > > + > > +module_scmi_driver(scmi_iiodev_driver); > > + > > +MODULE_AUTHOR("Jyoti Bhayana <jbhayana@google.com>"); > > +MODULE_DESCRIPTION("SCMI IIO Driver"); > > +MODULE_LICENSE("GPL v2"); > > -- > > 2.30.0.280.ga3ce27912f-goog > >
Hi Peter, I have modified the comments in v4 of that patch. Regarding your suggestion of this driver handling a greater value range by adjusting the scale accordingly, it would also require the driver to change the sensor readings as well based on the updated scale and the accuracy of the sensor reading will be lost as the sensor readings are 64 bit integers and not float. If the IIO driver needs to support a 64 bit sensor range, then I would prefer to add a new IIO val type for 64 bit fractional value which takes 4 int vals: val_high,val_low, val2_high and val2_low. Thanks, Jyoti On Tue, Jan 26, 2021 at 7:29 AM Peter Hilber <peter.hilber@opensynergy.com> wrote: > > On 22.01.21 00:21, Jyoti Bhayana wrote: > > <snip> > > > + > > +static int scmi_iio_get_sensor_max_range(struct iio_dev *iio_dev, int *val, > > + int *val2) > > +{ > > + struct scmi_iio_priv *sensor = iio_priv(iio_dev); > > + int max_range_high, max_range_low; > > + long long max_range; > > + > > + /* > > + * All the axes are supposed to have the same value for max range. > > + * We are just using the values from the Axis 0 here. > > + */ > > + if (sensor->sensor_info->axis[0].extended_attrs) { > > + max_range = sensor->sensor_info->axis[0].attrs.max_range; > > + max_range_high = H32(max_range); > > + max_range_low = L32(max_range); > > + > > + /* > > + * As IIO Val types have no provision for 64 bit values, > > + * and currently there are no known sensors using 64 bit > > + * for the range, this driver only supports sensor with > > + * 32 bit range value. > > + */ > This comment and the corresponding one in > scmi_iio_get_sensor_min_range() seem to be misleading to me. The extrema > will probably exceed 32 bits even for physical sensors which do have > less than 32 bits of resolution. The reason is that the SCMI sensor > management protocol does not transmit a `scale' value as used by IIO. > Instead, SCMI transmits an exponent with base ten. > > So, an SCMI sensor with a unit/LSB value which is not a power of ten > will have its unit/LSB value split into an exponent (with base ten) and > a mantissa. > > The SCMI platform (which exposes the physical sensor) will have to > incorporate the mantissa into the sensor value. The simplest approach is > to just multiply the mantissa with the raw physical sensor value, which > will use more bits than the raw physical sensor value, depending on the > unit/LSB value (and on the split of the unit/LSB value into exponent and > mantissa). > > So I think the comment should at least make clear that the overflow may > also happen for physical sensors with less than 32 bit of resolution, > since it cannot be assumed that SCMI platforms will, without any > apparent need, restrict the values to 32 bits, when that would mean > additional complexity and potential loss of accuracy. (And in the long > term this driver could IMHO try to handle a greater value range by > adjusting the `scale' value accordingly.) > > Best regards, > > Peter > > > + if (max_range_high != 0) > > + return -EINVAL; > > + > > + *val = max_range_low; > > + *val2 = 1; > > + } > > + return 0; > > +} > > + > > +static void scmi_iio_get_sensor_resolution(struct iio_dev *iio_dev, int *val, > > + int *val2) > > +{ > > + struct scmi_iio_priv *sensor = iio_priv(iio_dev); > > + > > + /* > > + * All the axes are supposed to have the same value for resolution > > + * and exponent. We are just using the values from the Axis 0 here. > > + */ > > + if (sensor->sensor_info->axis[0].extended_attrs) { > > + uint resolution = sensor->sensor_info->axis[0].resolution; > > + s8 exponent = sensor->sensor_info->axis[0].exponent; > > + s8 scale = sensor->sensor_info->axis[0].scale; > > + > > + /* > > + * To provide the raw value for the resolution to the userspace, > > + * need to divide the resolution exponent by the sensor scale > > + */ > > + exponent = exponent - scale; > > + if (exponent >= 0) { > > + *val = resolution * int_pow(10, exponent); > > + *val2 = 1; > > + } else { > > + *val = resolution; > > + *val2 = int_pow(10, abs(exponent)); > > + } > > + } > > +} > > + > > +static int scmi_iio_get_sensor_min_range(struct iio_dev *iio_dev, int *val, > > + int *val2) > > +{ > > + struct scmi_iio_priv *sensor = iio_priv(iio_dev); > > + int min_range_high, min_range_low; > > + long long min_range; > > + > > + /* > > + * All the axes are supposed to have the same value for min range. > > + * We are just using the values from the Axis 0 here. > > + */ > > + if (sensor->sensor_info->axis[0].extended_attrs) { > > + min_range = sensor->sensor_info->axis[0].attrs.min_range; > > + min_range_high = H32(min_range); > > + min_range_low = L32(min_range); > > + > > + /* > > + * As IIO Val types have no provision for 64 bit values, > > + * and currently there are no known sensors using 64 bit > > + * for the range, this driver only supports sensor with > > + * 32 bit range value. > > + */ > > + if (min_range_high != 0xFFFFFFFF) > > + return -EINVAL; > > + > > + *val = min_range_low; > > + *val2 = 1; > > + } > > + return 0; > > +} > > + > > +static int scmi_iio_set_sensor_range_avail(struct iio_dev *iio_dev) > > +{ > > + struct scmi_iio_priv *sensor = iio_priv(iio_dev); > > + int ret; > > + > > + ret = scmi_iio_get_sensor_min_range(iio_dev, &sensor->range_avail[0], > > + &sensor->range_avail[1]); > > + if (ret) > > + return ret; > > + > > + scmi_iio_get_sensor_resolution(iio_dev, &sensor->range_avail[2], > > + &sensor->range_avail[3]); > > + ret = scmi_iio_get_sensor_max_range(iio_dev, &sensor->range_avail[4], > > + &sensor->range_avail[5]); > > + return ret; > > +} > > + > > +static int scmi_iio_set_sampling_freq_avail(struct iio_dev *iio_dev) > > +{ > > + u64 cur_interval_ns, low_interval_ns, high_interval_ns, step_size_ns, > > + hz, uhz; > > + unsigned int cur_interval, low_interval, high_interval, step_size; > > + struct scmi_iio_priv *sensor = iio_priv(iio_dev); > > + int i; > > + > > + sensor->freq_avail = devm_kzalloc(&iio_dev->dev, > > + sizeof(u32) * (sensor->sensor_info->intervals.count * 2), > > + GFP_KERNEL); > > + if (!sensor->freq_avail) > > + return -ENOMEM; > > + > > + if (sensor->sensor_info->intervals.segmented) { > > + low_interval = sensor->sensor_info->intervals > > + .desc[SCMI_SENS_INTVL_SEGMENT_LOW]; > > + low_interval_ns = scmi_iio_convert_interval_to_ns(low_interval); > > + convert_ns_to_freq(low_interval_ns, &hz, &uhz); > > + sensor->freq_avail[0] = hz; > > + sensor->freq_avail[1] = uhz; > > + > > + step_size = sensor->sensor_info->intervals > > + .desc[SCMI_SENS_INTVL_SEGMENT_STEP]; > > + step_size_ns = scmi_iio_convert_interval_to_ns(step_size); > > + convert_ns_to_freq(step_size_ns, &hz, &uhz); > > + sensor->freq_avail[2] = hz; > > + sensor->freq_avail[3] = uhz; > > + > > + high_interval = sensor->sensor_info->intervals > > + .desc[SCMI_SENS_INTVL_SEGMENT_HIGH]; > > + high_interval_ns = > > + scmi_iio_convert_interval_to_ns(high_interval); > > + convert_ns_to_freq(high_interval_ns, &hz, &uhz); > > + sensor->freq_avail[4] = hz; > > + sensor->freq_avail[5] = uhz; > > + } else { > > + for (i = 0; i < sensor->sensor_info->intervals.count; i++) { > > + cur_interval = sensor->sensor_info->intervals.desc[i]; > > + cur_interval_ns = scmi_iio_convert_interval_to_ns(cur_interval); > > + convert_ns_to_freq(cur_interval_ns, &hz, &uhz); > > + sensor->freq_avail[i * 2] = hz; > > + sensor->freq_avail[i * 2 + 1] = uhz; > > + } > > + } > > + return 0; > > +} > > + > > +static int scmi_iio_buffers_setup(struct iio_dev *scmi_iiodev) > > +{ > > + struct iio_buffer *buffer; > > + > > + buffer = devm_iio_kfifo_allocate(&scmi_iiodev->dev); > > + if (!buffer) > > + return -ENOMEM; > > + > > + iio_device_attach_buffer(scmi_iiodev, buffer); > > + scmi_iiodev->modes |= INDIO_BUFFER_SOFTWARE; > > + scmi_iiodev->setup_ops = &scmi_iio_buffer_ops; > > + return 0; > > +} > > + > > +static int scmi_alloc_iiodev(struct device *dev, struct scmi_handle *handle, > > + const struct scmi_sensor_info *sensor_info, > > + struct iio_dev **scmi_iio_dev) > > +{ > > + struct iio_chan_spec *iio_channels; > > + struct scmi_iio_priv *sensor; > > + enum iio_modifier modifier; > > + enum iio_chan_type type; > > + struct iio_dev *iiodev; > > + int i, ret; > > + > > + iiodev = devm_iio_device_alloc(dev, sizeof(*sensor)); > > + if (!iiodev) > > + return -ENOMEM; > > + > > + iiodev->modes = INDIO_DIRECT_MODE; > > + iiodev->dev.parent = dev; > > + sensor = iio_priv(iiodev); > > + sensor->handle = handle; > > + sensor->sensor_info = sensor_info; > > + sensor->sensor_update_nb.notifier_call = scmi_iio_sensor_update_cb; > > + sensor->indio_dev = iiodev; > > + > > + /* adding one additional channel for timestamp */ > > + iiodev->num_channels = sensor_info->num_axis + 1; > > + iiodev->name = sensor_info->name; > > + iiodev->info = &scmi_iio_info; > > + > > + iio_channels = > > + devm_kzalloc(dev, > > + sizeof(*iio_channels) * (iiodev->num_channels), > > + GFP_KERNEL); > > + if (!iio_channels) > > + return -ENOMEM; > > + > > + scmi_iio_set_sampling_freq_avail(iiodev); > > + > > + ret = scmi_iio_set_sensor_range_avail(iiodev); > > + if (ret) { > > + dev_err(dev, "Error while setting the sensor %s range %d", > > + sensor_info->name, ret); > > + return ret; > > + } > > + > > + for (i = 0; i < sensor_info->num_axis; i++) { > > + ret = scmi_iio_get_chan_type(sensor_info->axis[i].type, &type); > > + if (ret < 0) > > + return ret; > > + > > + ret = scmi_iio_get_chan_modifier(sensor_info->axis[i].name, > > + &modifier); > > + if (ret < 0) > > + return ret; > > + > > + scmi_iio_set_data_channel(&iio_channels[i], type, modifier, > > + sensor_info->axis[i].id); > > + } > > + > > + scmi_iio_set_timestamp_channel(&iio_channels[i], i); > > + iiodev->channels = iio_channels; > > + *scmi_iio_dev = iiodev; > > + return ret; > > +} > > + > > +static int scmi_iio_dev_probe(struct scmi_device *sdev) > > +{ > > + const struct scmi_sensor_info *sensor_info; > > + struct scmi_handle *handle = sdev->handle; > > + struct device *dev = &sdev->dev; > > + struct iio_dev *scmi_iio_dev; > > + u16 nr_sensors; > > + int err, i; > > + > > + if (!handle || !handle->sensor_ops || !handle->sensor_ops->count_get || > > + !handle->sensor_ops->info_get || !handle->sensor_ops->config_get || > > + !handle->sensor_ops->config_set) { > > + dev_err(dev, "SCMI device has no sensor interface\n"); > > + return -EINVAL; > > + } > > + > > + nr_sensors = handle->sensor_ops->count_get(handle); > > + if (!nr_sensors) { > > + dev_dbg(dev, "0 sensors found via SCMI bus\n"); > > + return -EINVAL; > > + } > > + > > + dev_dbg(dev, "%d sensors found via SCMI bus\n", nr_sensors); > > + > > + for (i = 0; i < nr_sensors; i++) { > > + sensor_info = handle->sensor_ops->info_get(handle, i); > > + if (!sensor_info) { > > + dev_err(dev, "SCMI sensor %d has missing info\n", i); > > + return -EINVAL; > > + } > > + > > + /* Skipping scalar sensor,as this driver only supports accel and gyro */ > > + if (sensor_info->num_axis == 0) > > + continue; > > + > > + err = scmi_alloc_iiodev(dev, handle, sensor_info, > > + &scmi_iio_dev); > > + if (err < 0) { > > + dev_err(dev, > > + "failed to allocate IIO device for sensor %s: %d\n", > > + sensor_info->name, err); > > + return err; > > + } > > + > > + err = scmi_iio_buffers_setup(scmi_iio_dev); > > + if (err < 0) { > > + dev_err(dev, > > + "IIO buffer setup error at sensor %s: %d\n", > > + sensor_info->name, err); > > + return err; > > + } > > + > > + err = devm_iio_device_register(dev, scmi_iio_dev); > > + if (err) { > > + dev_err(dev, > > + "IIO device registration failed at sensor %s: %d\n", > > + sensor_info->name, err); > > + return err; > > + } > > + } > > + return err; > > +} > > + > > +static const struct scmi_device_id scmi_id_table[] = { > > + { SCMI_PROTOCOL_SENSOR, "iiodev" }, > > + {}, > > +}; > > + > > +MODULE_DEVICE_TABLE(scmi, scmi_id_table); > > + > > +static struct scmi_driver scmi_iiodev_driver = { > > + .name = "scmi-sensor-iiodev", > > + .probe = scmi_iio_dev_probe, > > + .id_table = scmi_id_table, > > +}; > > + > > +module_scmi_driver(scmi_iiodev_driver); > > + > > +MODULE_AUTHOR("Jyoti Bhayana <jbhayana@google.com>"); > > +MODULE_DESCRIPTION("SCMI IIO Driver"); > > +MODULE_LICENSE("GPL v2"); > > > >
Hi Jyoti, On Fri, Jan 29, 2021 at 02:43:13PM -0800, Jyoti Bhayana wrote: > Hi Christian, > > I have addressed your feedback in v4 of the patch. Please find below > the answers to some of your questions: > > The initial sensor_config ORed here is NOT initialized nor zeroed. > > There is no need to initialize as it is already initialized to 0 when defined. > True for the sensor_config in scmi_iio_buffer_postdisable(), BUT it is not indeed zero-initialized at definition time in the other similar function scmi_iio_buffer_preenable(), that is what the above comment was referred to. > > being not so familiar with IIO, may I ask when and how much frequently > > these ops are called ? (given they include a register/unregister + > > enable/disable every time) > > These are called whenever the sensor is enabled/disabled by writing > to buffer/enable sysfs node > Ok, thanks. > >AFAIU this is called during IIO init and derives a modifier from the name > >of the sensors which are passed by the platform fw with sensor descriptors, > >so I would not trust them to be weell formed (:D) and try to be picky about > >*name as it was user-input to validate. > > The SCMI specification has mentioned the naming convention for the > axis as below . > "A NULL terminated UTF-8 format string with the sensor axis name, of > up to 16 bytes. It is recommended that the name ends with ‘_’ followed > by the axis of the sensor in uppercase. For example, the name for the > x-axis of a triaxial accelerometer could be “acc_X” or “_X” > > If there is any other better way to get the modifier, please let me know. > What I was trying to say was simply that, despite what the spec says, you cannot trust the fw/platform produced values (fw buggy ? data on channel corrupted ? malicious pkt injections ? fuzzing ? ) and so you should be picky and validate them also against any possible out-of-spec data, since the Kernel must not crash even if presented with unreasonable out-of-spec garbage-like data, thing that indeed you did in v4 by adding the check for NULL against name param. :D (the other case of a malformed name like "acc_" seemed to me handled properly already by the kernel strcmp) > > why not a break to a final 'return ret;' (with ret properly set) ? > > According to Jonathan, direct returns are preferred. > Ok > >Not familiar with IIO, but is it fine to setup ops and modes AFTER > >having attached the buffer to the scmi_iiodev ? > >Is is not 'racy-possible' that the buffer is already operational without > >any ops immediately after being attached ? > > I have looked at other IIO drivers and they all do it this way. > Ok. Thanks, I'll have a look at v4. Cristian > Thanks, > Jyoti > > > > > > > > On Fri, Jan 22, 2021 at 5:37 AM Cristian Marussi > <cristian.marussi@arm.com> wrote: > > > > Hi Jyoti, > > > > a few remarks below. > > > > On Thu, Jan 21, 2021 at 11:21:47PM +0000, Jyoti Bhayana wrote: > > > This change provides ARM SCMI Protocol based IIO device. > > > This driver provides support for Accelerometer and Gyroscope using > > > new SCMI Sensor Protocol defined by the upcoming SCMIv3.0 > > > > I'd say: > > > > new SCMI Sensor Protocol extension added by the upcoming SCMIv3.0 > > > > given that SCMI Sensor existed already in SCMIv2.0 > > > > > ARM specification > > > > > > Signed-off-by: Jyoti Bhayana <jbhayana@google.com> > > > --- > > > MAINTAINERS | 6 + > > > drivers/iio/common/Kconfig | 1 + > > > drivers/iio/common/Makefile | 1 + > > > drivers/iio/common/scmi_sensors/Kconfig | 18 + > > > drivers/iio/common/scmi_sensors/Makefile | 5 + > > > drivers/iio/common/scmi_sensors/scmi_iio.c | 736 +++++++++++++++++++++ > > > 6 files changed, 767 insertions(+) > > > create mode 100644 drivers/iio/common/scmi_sensors/Kconfig > > > create mode 100644 drivers/iio/common/scmi_sensors/Makefile > > > create mode 100644 drivers/iio/common/scmi_sensors/scmi_iio.c > > > > > > diff --git a/MAINTAINERS b/MAINTAINERS > > > index b516bb34a8d5..ccf37d43ab41 100644 > > > --- a/MAINTAINERS > > > +++ b/MAINTAINERS > > > @@ -8567,6 +8567,12 @@ S: Maintained > > > F: Documentation/devicetree/bindings/iio/multiplexer/io-channel-mux.txt > > > F: drivers/iio/multiplexer/iio-mux.c > > > > > > +IIO SCMI BASED DRIVER > > > +M: Jyoti Bhayana <jbhayana@google.com> > > > +L: linux-iio@vger.kernel.org > > > +S: Maintained > > > +F: drivers/iio/common/scmi_sensors/scmi_iio.c > > > + > > > IIO SUBSYSTEM AND DRIVERS > > > M: Jonathan Cameron <jic23@kernel.org> > > > R: Lars-Peter Clausen <lars@metafoo.de> > > > diff --git a/drivers/iio/common/Kconfig b/drivers/iio/common/Kconfig > > > index 2b9ee9161abd..0334b4954773 100644 > > > --- a/drivers/iio/common/Kconfig > > > +++ b/drivers/iio/common/Kconfig > > > @@ -6,5 +6,6 @@ > > > source "drivers/iio/common/cros_ec_sensors/Kconfig" > > > source "drivers/iio/common/hid-sensors/Kconfig" > > > source "drivers/iio/common/ms_sensors/Kconfig" > > > +source "drivers/iio/common/scmi_sensors/Kconfig" > > > source "drivers/iio/common/ssp_sensors/Kconfig" > > > source "drivers/iio/common/st_sensors/Kconfig" > > > diff --git a/drivers/iio/common/Makefile b/drivers/iio/common/Makefile > > > index 4bc30bb548e2..fad40e1e1718 100644 > > > --- a/drivers/iio/common/Makefile > > > +++ b/drivers/iio/common/Makefile > > > @@ -11,5 +11,6 @@ > > > obj-y += cros_ec_sensors/ > > > obj-y += hid-sensors/ > > > obj-y += ms_sensors/ > > > +obj-y += scmi_sensors/ > > > obj-y += ssp_sensors/ > > > obj-y += st_sensors/ > > > diff --git a/drivers/iio/common/scmi_sensors/Kconfig b/drivers/iio/common/scmi_sensors/Kconfig > > > new file mode 100644 > > > index 000000000000..67e084cbb1ab > > > --- /dev/null > > > +++ b/drivers/iio/common/scmi_sensors/Kconfig > > > @@ -0,0 +1,18 @@ > > > +# > > > +# IIO over SCMI > > > +# > > > +# When adding new entries keep the list in alphabetical order > > > + > > > +menu "IIO SCMI Sensors" > > > + > > > +config IIO_SCMI > > > + tristate "IIO SCMI" > > > + depends on ARM_SCMI_PROTOCOL > > > + select IIO_BUFFER > > > + select IIO_KFIFO_BUF > > > + help > > > + Say yes here to build support for IIO SCMI Driver. > > > + This provides ARM SCMI Protocol based IIO device. > > > + This driver provides support for accelerometer and gyroscope > > > + sensors available on SCMI based platforms. > > > +endmenu > > > diff --git a/drivers/iio/common/scmi_sensors/Makefile b/drivers/iio/common/scmi_sensors/Makefile > > > new file mode 100644 > > > index 000000000000..f13140a2575a > > > --- /dev/null > > > +++ b/drivers/iio/common/scmi_sensors/Makefile > > > @@ -0,0 +1,5 @@ > > > +# SPDX - License - Identifier : GPL - 2.0 - only > > > +# > > > +# Makefile for the IIO over SCMI > > > +# > > > +obj-$(CONFIG_IIO_SCMI) += scmi_iio.o > > > diff --git a/drivers/iio/common/scmi_sensors/scmi_iio.c b/drivers/iio/common/scmi_sensors/scmi_iio.c > > > new file mode 100644 > > > index 000000000000..3b76cc54511c > > > --- /dev/null > > > +++ b/drivers/iio/common/scmi_sensors/scmi_iio.c > > > @@ -0,0 +1,736 @@ > > > +// SPDX-License-Identifier: GPL-2.0 > > > + > > > +/* > > > + * System Control and Management Interface(SCMI) based IIO sensor driver > > > + * > > > + * Copyright (C) 2020 Google LLC > > > + */ > > > + > > > +#include <linux/delay.h> > > > +#include <linux/err.h> > > > +#include <linux/iio/buffer.h> > > > +#include <linux/iio/iio.h> > > > +#include <linux/iio/kfifo_buf.h> > > > +#include <linux/iio/sysfs.h> > > > +#include <linux/kernel.h> > > > +#include <linux/kthread.h> > > > +#include <linux/module.h> > > > +#include <linux/scmi_protocol.h> > > > +#include <linux/time.h> > > > +#include <linux/types.h> > > > + > > > +#define ilog10(x) (ilog2(x) / const_ilog2(10)) > > > +#define UHZ_PER_HZ 1000000UL > > > +#define ODR_EXPAND(odr, uodr) (((odr) * 1000000ULL) + (uodr)) > > > +#define MAX_NUM_OF_CHANNELS 4 > > > +#define H32(x) (((x) & 0xFFFFFFFF00000000LL) >> 32) > > > +#define L32(x) ((x) & 0xFFFFFFFFLL) > > > > Probaly you want to use GENMASK here to define the masks, and not sure > > but maybe there are already similar macros in linux to extract > > upper/lower 32 bits. > > > > > + > > > +struct scmi_iio_priv { > > > + struct scmi_handle *handle; > > > + const struct scmi_sensor_info *sensor_info; > > > + struct iio_dev *indio_dev; > > > + long long iio_buf[MAX_NUM_OF_CHANNELS]; > > > + struct notifier_block sensor_update_nb; > > > + u32 *freq_avail; > > > + /* > > > + * range_avail = [minRange resolution maxRange] > > > + * with IIO val type as IIO_VAL_FRACTIONAL. > > > + * Hence, array of size 6. > > > + */ > > > + int range_avail[6]; > > > +}; > > > + > > > +static int scmi_iio_sensor_update_cb(struct notifier_block *nb, > > > + unsigned long event, void *data) > > > +{ > > > + struct scmi_sensor_update_report *sensor_update = data; > > > + struct iio_dev *scmi_iio_dev; > > > + struct scmi_iio_priv *sensor; > > > + s8 tstamp_scale; > > > + u64 time, time_ns; > > > + int i; > > > + > > > + if (sensor_update->readings_count == 0) > > > + return NOTIFY_DONE; > > > + > > > + sensor = container_of(nb, struct scmi_iio_priv, sensor_update_nb); > > > + > > > + for (i = 0; i < sensor_update->readings_count; i++) > > > + sensor->iio_buf[i] = sensor_update->readings[i].value; > > > + > > > + if (!sensor->sensor_info->timestamped) { > > > + time_ns = iio_get_time_ns(scmi_iio_dev); > > > > This scmi_iio_dev is on the stack and still NOT initialized here right ? > > > > Moreover, if this is meant to attach a timestamp of arrival also to > > NON-timestamped sensor notifications, note that, if you want, scmi_sensor_update_report > > contains a 'timestamp' (as all SCMI notif reports) ktime field (ns) which > > represents the time (ns from boot with ktime_get_boottime()) of reception > > of this notification taken by the SCMI core as soon as it arrives in the > > RX ISR. (so in the OSPM Linux world) > > > > If you grab the timestamp here with iio_get_time_ns() you are indeed > > getting a timestamp inside the notification callback so at the end of > > the notifications processing chain, i.e. in a deferred worker processing > > this queue of events and in turn calling this function, so potentially > > you're timestamping a lot later than when the event arrived really in > > the OSPM world (especially on a loaded system); it is more the time of > > arrival in IIO framework. > > > > On the other side timestamped events handled in the else-branch down > > below carry a timestamp set by the SCMI platform fw early on when the > > event has been detected by the sensor in the real world. > > > > Not sure how these values are used at the end, but just to let you know > > this detail if it was not apparent. > > > > > + } else { > > > + /* > > > + * All the axes are supposed to have the same value for timestamp. > > > + * We are just using the values from the Axis 0 here. > > > + */ > > > + time = sensor_update->readings[0].timestamp; > > > + > > > + /* > > > + * Timestamp returned by SCMI is in seconds and is equal to > > > + * time * power-of-10 multiplier(tstamp_scale) seconds. > > > + * Converting the timestamp to nanoseconds below. > > > + */ > > > + tstamp_scale = sensor->sensor_info->tstamp_scale + > > > + ilog10(NSEC_PER_SEC); > > > + if (tstamp_scale < 0) > > > + time_ns = div64_u64(time, > > > + int_pow(10, abs(tstamp_scale))); > > > + else > > > + time_ns = time * int_pow(10, tstamp_scale); > > > + } > > > + > > > + scmi_iio_dev = sensor->indio_dev; > > > + iio_push_to_buffers_with_timestamp(scmi_iio_dev, sensor->iio_buf, > > > + time_ns); > > > + return NOTIFY_OK; > > > +} > > > + > > > +static int scmi_iio_buffer_preenable(struct iio_dev *iio_dev) > > > +{ > > > + struct scmi_iio_priv *sensor = iio_priv(iio_dev); > > > + u32 sensor_id = sensor->sensor_info->id; > > > + u32 sensor_config; > > > + int err; > > > + > > > + if (sensor->sensor_info->timestamped) > > > + sensor_config |= FIELD_PREP(SCMI_SENS_CFG_TSTAMP_ENABLED_MASK, > > > + SCMI_SENS_CFG_TSTAMP_ENABLE); > > > > The initial sensor_config ORed here is NOT initialized nor zeroed. > > > + > > > + sensor_config |= FIELD_PREP(SCMI_SENS_CFG_SENSOR_ENABLED_MASK, > > > + SCMI_SENS_CFG_SENSOR_ENABLE); > > > + > > > + err = sensor->handle->notify_ops->register_event_notifier(sensor->handle, > > > + SCMI_PROTOCOL_SENSOR, SCMI_EVENT_SENSOR_UPDATE, > > > + &sensor_id, &sensor->sensor_update_nb); > > > + if (err) { > > > + dev_err(&iio_dev->dev, > > > + "Error in registering sensor update notifier for sensor %s err %d", > > > + sensor->sensor_info->name, err); > > > + return err; > > > + } > > > + > > > + err = sensor->handle->sensor_ops->config_set(sensor->handle, > > > + sensor->sensor_info->id, sensor_config); > > > + if (err) > > > + dev_err(&iio_dev->dev, "Error in enabling sensor %s err %d", > > > + sensor->sensor_info->name, err); > > > > Here you do not unregister the notification above here when you fail > > the config_set. > > If you happen to retry this code path again you'll end up registering > > the same notifier_block sensor_update_nb() in the same notification chain > > (same event samme sensor_id), which is broken and probably triggers a WARN > > from the core kernel notification chains machinery too. > > > > In an upcoming series on SCMI core I'll introduce a devm_ variant for > > SCMI notification registration, but as of now you have to properly unregister > > on error paths. > > > > > + > > > + return err; > > > +} > > > + > > > +static int scmi_iio_buffer_postdisable(struct iio_dev *iio_dev) > > > +{ > > > + struct scmi_iio_priv *sensor = iio_priv(iio_dev); > > > + u32 sensor_id = sensor->sensor_info->id; > > > + u32 sensor_config = 0; > > > + int err; > > > + > > > + sensor_config |= FIELD_PREP(SCMI_SENS_CFG_SENSOR_ENABLED_MASK, > > > + SCMI_SENS_CFG_SENSOR_DISABLE); > > > + > > > + err = sensor->handle->notify_ops->unregister_event_notifier(sensor->handle, > > > + SCMI_PROTOCOL_SENSOR, SCMI_EVENT_SENSOR_UPDATE, > > > + &sensor_id, &sensor->sensor_update_nb); > > > > This alignment here is a bit awkaward. > > > > > + if (err) { > > > + dev_err(&iio_dev->dev, > > > + "Error in unregistering sensor update notifier for sensor %s err %d", > > > + sensor->sensor_info->name, err); > > > + return err; > > > + } > > > + > > > + err = sensor->handle->sensor_ops->config_set(sensor->handle, sensor_id, > > > + sensor_config); > > > + if (err) > > > + dev_err(&iio_dev->dev, > > > + "Error in disabling sensor %s with err %d", > > > + sensor->sensor_info->name, err); > > > + > > > + return err; > > > +} > > > + > > > +static const struct iio_buffer_setup_ops scmi_iio_buffer_ops = { > > > + .preenable = scmi_iio_buffer_preenable, > > > + .postdisable = scmi_iio_buffer_postdisable, > > > +}; > > > + > > > > Being not so familiar with IIO, may I ask when annd ho wmuch frequently > > these ops are called ? (given they include a register/unregister + > > enable/disable every time) > > > > > +static int scmi_iio_read_avail(struct iio_dev *iio_dev, > > > + struct iio_chan_spec const *chan, > > > + const int **vals, int *type, int *length, > > > + long mask) > > > +{ > > > + struct scmi_iio_priv *sensor = iio_priv(iio_dev); > > > + > > > + switch (mask) { > > > + case IIO_CHAN_INFO_SAMP_FREQ: > > > + *vals = sensor->freq_avail; > > > + *type = IIO_VAL_INT_PLUS_MICRO; > > > + *length = sensor->sensor_info->intervals.count * 2; > > > + if (sensor->sensor_info->intervals.segmented) > > > + return IIO_AVAIL_RANGE; > > > + else > > > + return IIO_AVAIL_LIST; > > > + case IIO_CHAN_INFO_RAW: > > > + *vals = sensor->range_avail; > > > + *type = IIO_VAL_FRACTIONAL; > > > + *length = ARRAY_SIZE(sensor->range_avail); > > > + return IIO_AVAIL_RANGE; > > > + default: > > > + return -EINVAL; > > > + } > > > +} > > > + > > > +static int scmi_iio_set_odr_val(struct iio_dev *iio_dev, int val, int val2) > > > +{ > > > + struct scmi_iio_priv *sensor = iio_priv(iio_dev); > > > + u64 sec, mult, uHz; > > > + u32 sensor_config; > > > + > > > + int err = sensor->handle->sensor_ops->config_get(sensor->handle, > > > + sensor->sensor_info->id, &sensor_config); > > > + if (err) { > > > + dev_err(&iio_dev->dev, > > > + "Error in getting sensor config for sensor %s err %d", > > > + sensor->sensor_info->name, err); > > > + return err; > > > + } > > > + > > > + uHz = ODR_EXPAND(val, val2); > > > + > > > + /* > > > + * The seconds field in the sensor interval in SCMI is 16 bits long > > > + * Therefore seconds = 1/Hz <= 0xFFFF. As floating point calculations are > > > + * discouraged in the kernel driver code, to calculate the scale factor (sf) > > > + * (1* 1000000 * sf)/uHz <= 0xFFFF. Therefore, sf <= (uHz * 0xFFFF)/1000000 > > > + */ > > > + mult = ilog10(((u64)uHz * 0xFFFF) / UHZ_PER_HZ); > > > + > > > + sec = div64_u64(int_pow(10, mult) * UHZ_PER_HZ, uHz); > > > + if (sec == 0) { > > > + dev_err(&iio_dev->dev, > > > + "Trying to set invalid sensor update value for sensor %s", > > > + sensor->sensor_info->name); > > > + return -EINVAL; > > > + } > > > + > > > + sensor_config &= ~SCMI_SENS_CFG_UPDATE_SECS_MASK; > > > + sensor_config |= FIELD_PREP(SCMI_SENS_CFG_UPDATE_SECS_MASK, sec); > > > + sensor_config &= ~SCMI_SENS_CFG_UPDATE_EXP_MASK; > > > + sensor_config |= FIELD_PREP(SCMI_SENS_CFG_UPDATE_EXP_MASK, -mult); > > > + > > > + if (sensor->sensor_info->timestamped) { > > > + sensor_config &= ~SCMI_SENS_CFG_TSTAMP_ENABLED_MASK; > > > + sensor_config |= FIELD_PREP(SCMI_SENS_CFG_TSTAMP_ENABLED_MASK, > > > + SCMI_SENS_CFG_TSTAMP_ENABLE); > > > + } > > > + > > > + sensor_config &= ~SCMI_SENS_CFG_ROUND_MASK; > > > + sensor_config |= > > > + FIELD_PREP(SCMI_SENS_CFG_ROUND_MASK, SCMI_SENS_CFG_ROUND_AUTO); > > > + > > > + err = sensor->handle->sensor_ops->config_set(sensor->handle, > > > + sensor->sensor_info->id, sensor_config); > > > + if (err) > > > + dev_err(&iio_dev->dev, > > > + "Error in setting sensor update interval for sensor %s value %u err %d", > > > + sensor->sensor_info->name, sensor_config, err); > > > + > > > + return err; > > > +} > > > + > > > +static int scmi_iio_write_raw(struct iio_dev *iio_dev, > > > + struct iio_chan_spec const *chan, int val, > > > + int val2, long mask) > > > +{ > > > + int err; > > > + > > > + switch (mask) { > > > + case IIO_CHAN_INFO_SAMP_FREQ: > > > + mutex_lock(&iio_dev->mlock); > > > + err = scmi_iio_set_odr_val(iio_dev, val, val2); > > > + mutex_unlock(&iio_dev->mlock); > > > + return err; > > > + default: > > > + return -EINVAL; > > > + } > > > +} > > > + > > > +static u64 scmi_iio_convert_interval_to_ns(u32 val) > > > +{ > > > + u64 sensor_update_interval = > > > + SCMI_SENS_INTVL_GET_SECS(val) * NSEC_PER_SEC; > > > + u64 sensor_interval_mult; > > > + int mult; > > > + > > > + mult = SCMI_SENS_INTVL_GET_EXP(val); > > > + if (mult < 0) { > > > + sensor_interval_mult = int_pow(10, abs(mult)); > > > + sensor_update_interval = > > > + sensor_update_interval / sensor_interval_mult; > > > + } else { > > > + sensor_interval_mult = int_pow(10, mult); > > > + sensor_update_interval = > > > + sensor_update_interval * sensor_interval_mult; > > > + } > > > + return sensor_update_interval; > > > +} > > > + > > > +static void convert_ns_to_freq(u64 interval_ns, u64 *hz, u64 *uhz) > > > +{ > > > + u64 rem; > > > + > > > + *hz = div64_u64_rem(NSEC_PER_SEC, interval_ns, &rem); > > > + *uhz = (rem * 1000000UL) / interval_ns; > > > +} > > > + > > > +static int scmi_iio_get_odr_val(struct iio_dev *iio_dev, int *val, int *val2) > > > +{ > > > + u64 sensor_update_interval, sensor_interval_mult, hz, uhz; > > > + struct scmi_iio_priv *sensor = iio_priv(iio_dev); > > > + u32 sensor_config; > > > + int mult; > > > + > > > + int err = sensor->handle->sensor_ops->config_get(sensor->handle, > > > + sensor->sensor_info->id, &sensor_config); > > > + if (err) { > > > + dev_err(&iio_dev->dev, > > > + "Error in getting sensor config for sensor %s err %d", > > > + sensor->sensor_info->name, err); > > > + return err; > > > + } > > > + > > > + sensor_update_interval = > > > + SCMI_SENS_CFG_GET_UPDATE_SECS(sensor_config) * NSEC_PER_SEC; > > > + > > > + mult = SCMI_SENS_CFG_GET_UPDATE_EXP(sensor_config); > > > + if (mult < 0) { > > > + sensor_interval_mult = int_pow(10, abs(mult)); > > > + sensor_update_interval = > > > + sensor_update_interval / sensor_interval_mult; > > > + } else { > > > + sensor_interval_mult = int_pow(10, mult); > > > + sensor_update_interval = > > > + sensor_update_interval * sensor_interval_mult; > > > + } > > > + > > > + convert_ns_to_freq(sensor_update_interval, &hz, &uhz); > > > + *val = hz; > > > + *val2 = uhz; > > > + return 0; > > > +} > > > + > > > +static int scmi_iio_read_raw(struct iio_dev *iio_dev, > > > + struct iio_chan_spec const *ch, int *val, > > > + int *val2, long mask) > > > +{ > > > + struct scmi_iio_priv *sensor = iio_priv(iio_dev); > > > + s8 scale; > > > + int ret; > > > + > > > + switch (mask) { > > > + case IIO_CHAN_INFO_SCALE: > > > + scale = sensor->sensor_info->axis[ch->scan_index].scale; > > > + if (scale < 0) { > > > + *val = 1; > > > + *val2 = int_pow(10, abs(scale)); > > > + return IIO_VAL_FRACTIONAL; > > > + } > > > + *val = int_pow(10, scale); > > > + return IIO_VAL_INT; > > > + case IIO_CHAN_INFO_SAMP_FREQ: > > > + ret = scmi_iio_get_odr_val(iio_dev, val, val2); > > > + return ret ? ret : IIO_VAL_INT_PLUS_MICRO; > > > + default: > > > + return -EINVAL; > > > + } > > > +} > > > + > > > +static const struct iio_info scmi_iio_info = { > > > + .read_raw = scmi_iio_read_raw, > > > + .read_avail = scmi_iio_read_avail, > > > + .write_raw = scmi_iio_write_raw, > > > +}; > > > + > > > +static void scmi_iio_set_timestamp_channel(struct iio_chan_spec *iio_chan, > > > + int scan_index) > > > +{ > > > + iio_chan->type = IIO_TIMESTAMP; > > > + iio_chan->channel = -1; > > > + iio_chan->scan_index = scan_index; > > > + iio_chan->scan_type.sign = 'u'; > > > + iio_chan->scan_type.realbits = 64; > > > + iio_chan->scan_type.storagebits = 64; > > > +} > > > + > > > +static void scmi_iio_set_data_channel(struct iio_chan_spec *iio_chan, > > > + enum iio_chan_type type, > > > + enum iio_modifier mod, int scan_index) > > > +{ > > > + iio_chan->type = type; > > > + iio_chan->modified = 1; > > > + iio_chan->channel2 = mod; > > > + iio_chan->info_mask_separate = BIT(IIO_CHAN_INFO_SCALE); > > > + iio_chan->info_mask_shared_by_type = BIT(IIO_CHAN_INFO_SAMP_FREQ); > > > + iio_chan->info_mask_shared_by_type_available = > > > + BIT(IIO_CHAN_INFO_SAMP_FREQ) | BIT(IIO_CHAN_INFO_RAW); > > > + iio_chan->scan_index = scan_index; > > > + iio_chan->scan_type.sign = 's'; > > > + iio_chan->scan_type.realbits = 64; > > > + iio_chan->scan_type.storagebits = 64; > > > + iio_chan->scan_type.endianness = IIO_LE; > > > +} > > > + > > > +static int scmi_iio_get_chan_modifier(const char *name, > > > + enum iio_modifier *modifier) > > > +{ > > > > AFAIU this is called during IIO init and derives a modifier from the name > > of the sensors which are passed by the platform fw with sensor descriptors, > > so I would not trust them to be weell formed (:D) and try to be picky about > > *name as it was user-input to validate. > > > > > + char *pch; > > > + > > > + pch = strrchr(name, '_'); > > > > What happens if name is NULL ? > > > > > + if (!pch) > > > + return -EINVAL; > > > + > > > + if (strcmp(pch + 1, "X") == 0) { > > > + *modifier = IIO_MOD_X; > > > + return 0; > > > + } else if (strcmp(pch + 1, "Y") == 0) { > > > + *modifier = IIO_MOD_Y; > > > + return 0; > > > + } else if (strcmp(pch + 1, "Z") == 0) { > > > + *modifier = IIO_MOD_Z; > > > + return 0; > > > + } else { > > > + return -EINVAL; > > > + } > > > > Moroever, being a single char compare cannot this be done with a switch ? > > > > char mod = *(pch + 1); > > > > switch(mod) { > > case 'X': > > *modifier = IIO_MOD_X; > > break > > ... > > > > > +} > > > + > > > +static int scmi_iio_get_chan_type(u8 scmi_type, enum iio_chan_type *iio_type) > > > +{ > > > + switch (scmi_type) { > > > + case METERS_SEC_SQUARED: > > > + *iio_type = IIO_ACCEL; > > > + return 0; > > why not a break to a final 'return ret;' (with ret properly set) ? > > > > > + case RADIANS_SEC: > > > + *iio_type = IIO_ANGL_VEL; > > > + return 0; > > > + default: > > > + return -EINVAL; > > > + } > > > +} > > > + > > > +static int scmi_iio_get_sensor_max_range(struct iio_dev *iio_dev, int *val, > > > + int *val2) > > > +{ > > > + struct scmi_iio_priv *sensor = iio_priv(iio_dev); > > > + int max_range_high, max_range_low; > > > + long long max_range; > > > + > > > + /* > > > + * All the axes are supposed to have the same value for max range. > > > + * We are just using the values from the Axis 0 here. > > > + */ > > > + if (sensor->sensor_info->axis[0].extended_attrs) { > > > + max_range = sensor->sensor_info->axis[0].attrs.max_range; > > > + max_range_high = H32(max_range); > > > + max_range_low = L32(max_range); > > > + > > > + /* > > > + * As IIO Val types have no provision for 64 bit values, > > > + * and currently there are no known sensors using 64 bit > > > + * for the range, this driver only supports sensor with > > > + * 32 bit range value. > > > + */ > > > + if (max_range_high != 0) > > > + return -EINVAL; > > > + > > > + *val = max_range_low; > > > + *val2 = 1; > > > + } > > > + return 0; > > > +} > > > + > > > +static void scmi_iio_get_sensor_resolution(struct iio_dev *iio_dev, int *val, > > > + int *val2) > > > +{ > > > + struct scmi_iio_priv *sensor = iio_priv(iio_dev); > > > + > > > + /* > > > + * All the axes are supposed to have the same value for resolution > > > + * and exponent. We are just using the values from the Axis 0 here. > > > + */ > > > + if (sensor->sensor_info->axis[0].extended_attrs) { > > > + uint resolution = sensor->sensor_info->axis[0].resolution; > > > + s8 exponent = sensor->sensor_info->axis[0].exponent; > > > + s8 scale = sensor->sensor_info->axis[0].scale; > > > + > > > + /* > > > + * To provide the raw value for the resolution to the userspace, > > > + * need to divide the resolution exponent by the sensor scale > > > + */ > > > + exponent = exponent - scale; > > > + if (exponent >= 0) { > > > + *val = resolution * int_pow(10, exponent); > > > + *val2 = 1; > > > + } else { > > > + *val = resolution; > > > + *val2 = int_pow(10, abs(exponent)); > > > + } > > > + } > > > +} > > > + > > > +static int scmi_iio_get_sensor_min_range(struct iio_dev *iio_dev, int *val, > > > + int *val2) > > > +{ > > > + struct scmi_iio_priv *sensor = iio_priv(iio_dev); > > > + int min_range_high, min_range_low; > > > + long long min_range; > > > + > > > + /* > > > + * All the axes are supposed to have the same value for min range. > > > + * We are just using the values from the Axis 0 here. > > > + */ > > > + if (sensor->sensor_info->axis[0].extended_attrs) { > > > + min_range = sensor->sensor_info->axis[0].attrs.min_range; > > > + min_range_high = H32(min_range); > > > + min_range_low = L32(min_range); > > > + > > > + /* > > > + * As IIO Val types have no provision for 64 bit values, > > > + * and currently there are no known sensors using 64 bit > > > + * for the range, this driver only supports sensor with > > > + * 32 bit range value. > > > + */ > > > + if (min_range_high != 0xFFFFFFFF) > > > + return -EINVAL; > > > + > > > + *val = min_range_low; > > > + *val2 = 1; > > > + } > > > + return 0; > > > +} > > > + > > > +static int scmi_iio_set_sensor_range_avail(struct iio_dev *iio_dev) > > > +{ > > > + struct scmi_iio_priv *sensor = iio_priv(iio_dev); > > > + int ret; > > > + > > > + ret = scmi_iio_get_sensor_min_range(iio_dev, &sensor->range_avail[0], > > > + &sensor->range_avail[1]); > > > + if (ret) > > > + return ret; > > > + > > > + scmi_iio_get_sensor_resolution(iio_dev, &sensor->range_avail[2], > > > + &sensor->range_avail[3]); > > > + ret = scmi_iio_get_sensor_max_range(iio_dev, &sensor->range_avail[4], > > > + &sensor->range_avail[5]); > > > + return ret; > > > +} > > > + > > > +static int scmi_iio_set_sampling_freq_avail(struct iio_dev *iio_dev) > > > +{ > > > + u64 cur_interval_ns, low_interval_ns, high_interval_ns, step_size_ns, > > > + hz, uhz; > > > + unsigned int cur_interval, low_interval, high_interval, step_size; > > > + struct scmi_iio_priv *sensor = iio_priv(iio_dev); > > > + int i; > > > + > > > + sensor->freq_avail = devm_kzalloc(&iio_dev->dev, > > > + sizeof(u32) * (sensor->sensor_info->intervals.count * 2), > > > + GFP_KERNEL); > > > + if (!sensor->freq_avail) > > > + return -ENOMEM; > > > + > > > + if (sensor->sensor_info->intervals.segmented) { > > > + low_interval = sensor->sensor_info->intervals > > > + .desc[SCMI_SENS_INTVL_SEGMENT_LOW]; > > > + low_interval_ns = scmi_iio_convert_interval_to_ns(low_interval); > > > + convert_ns_to_freq(low_interval_ns, &hz, &uhz); > > > + sensor->freq_avail[0] = hz; > > > + sensor->freq_avail[1] = uhz; > > > + > > > + step_size = sensor->sensor_info->intervals > > > + .desc[SCMI_SENS_INTVL_SEGMENT_STEP]; > > > + step_size_ns = scmi_iio_convert_interval_to_ns(step_size); > > > + convert_ns_to_freq(step_size_ns, &hz, &uhz); > > > + sensor->freq_avail[2] = hz; > > > + sensor->freq_avail[3] = uhz; > > > + > > > + high_interval = sensor->sensor_info->intervals > > > + .desc[SCMI_SENS_INTVL_SEGMENT_HIGH]; > > > + high_interval_ns = > > > + scmi_iio_convert_interval_to_ns(high_interval); > > > + convert_ns_to_freq(high_interval_ns, &hz, &uhz); > > > + sensor->freq_avail[4] = hz; > > > + sensor->freq_avail[5] = uhz; > > > + } else { > > > + for (i = 0; i < sensor->sensor_info->intervals.count; i++) { > > > + cur_interval = sensor->sensor_info->intervals.desc[i]; > > > + cur_interval_ns = scmi_iio_convert_interval_to_ns(cur_interval); > > > + convert_ns_to_freq(cur_interval_ns, &hz, &uhz); > > > + sensor->freq_avail[i * 2] = hz; > > > + sensor->freq_avail[i * 2 + 1] = uhz; > > > + } > > > + } > > > + return 0; > > > +} > > > + > > > +static int scmi_iio_buffers_setup(struct iio_dev *scmi_iiodev) > > > +{ > > > + struct iio_buffer *buffer; > > > + > > > + buffer = devm_iio_kfifo_allocate(&scmi_iiodev->dev); > > > + if (!buffer) > > > + return -ENOMEM; > > > + > > > + iio_device_attach_buffer(scmi_iiodev, buffer); > > > + scmi_iiodev->modes |= INDIO_BUFFER_SOFTWARE; > > > + scmi_iiodev->setup_ops = &scmi_iio_buffer_ops; > > > > Not familiar with IIO, but is it fine to setup ops and modes AFTER > > having attached the buffer to the scmi_iiodev ? > > > > Is is not 'racy-possible' that the buffer is already operational without > > any ops immediately after being attached ? > > > > > + return 0; > > > +} > > > + > > > +static int scmi_alloc_iiodev(struct device *dev, struct scmi_handle *handle, > > > + const struct scmi_sensor_info *sensor_info, > > > + struct iio_dev **scmi_iio_dev) > > > +{ > > > + struct iio_chan_spec *iio_channels; > > > + struct scmi_iio_priv *sensor; > > > + enum iio_modifier modifier; > > > + enum iio_chan_type type; > > > + struct iio_dev *iiodev; > > > + int i, ret; > > > + > > > + iiodev = devm_iio_device_alloc(dev, sizeof(*sensor)); > > > + if (!iiodev) > > > + return -ENOMEM; > > > + > > > + iiodev->modes = INDIO_DIRECT_MODE; > > > + iiodev->dev.parent = dev; > > > + sensor = iio_priv(iiodev); > > > + sensor->handle = handle; > > > + sensor->sensor_info = sensor_info; > > > + sensor->sensor_update_nb.notifier_call = scmi_iio_sensor_update_cb; > > > + sensor->indio_dev = iiodev; > > > + > > > + /* adding one additional channel for timestamp */ > > > + iiodev->num_channels = sensor_info->num_axis + 1; > > > + iiodev->name = sensor_info->name; > > > + iiodev->info = &scmi_iio_info; > > > + > > > + iio_channels = > > > + devm_kzalloc(dev, > > > + sizeof(*iio_channels) * (iiodev->num_channels), > > > + GFP_KERNEL); > > > + if (!iio_channels) > > > + return -ENOMEM; > > > + > > > + scmi_iio_set_sampling_freq_avail(iiodev); > > > + > > > + ret = scmi_iio_set_sensor_range_avail(iiodev); > > > + if (ret) { > > > + dev_err(dev, "Error while setting the sensor %s range %d", > > > + sensor_info->name, ret); > > > + return ret; > > > + } > > > + > > > + for (i = 0; i < sensor_info->num_axis; i++) { > > > + ret = scmi_iio_get_chan_type(sensor_info->axis[i].type, &type); > > > + if (ret < 0) > > > + return ret; > > > + > > > + ret = scmi_iio_get_chan_modifier(sensor_info->axis[i].name, > > > + &modifier); > > > + if (ret < 0) > > > + return ret; > > > + > > > + scmi_iio_set_data_channel(&iio_channels[i], type, modifier, > > > + sensor_info->axis[i].id); > > > + } > > > + > > > + scmi_iio_set_timestamp_channel(&iio_channels[i], i); > > > + iiodev->channels = iio_channels; > > > + *scmi_iio_dev = iiodev; > > > + return ret; > > > +} > > > + > > > +static int scmi_iio_dev_probe(struct scmi_device *sdev) > > > +{ > > > + const struct scmi_sensor_info *sensor_info; > > > + struct scmi_handle *handle = sdev->handle; > > > + struct device *dev = &sdev->dev; > > > + struct iio_dev *scmi_iio_dev; > > > + u16 nr_sensors; > > > + int err, i; > > > + > > > + if (!handle || !handle->sensor_ops || !handle->sensor_ops->count_get || > > > + !handle->sensor_ops->info_get || !handle->sensor_ops->config_get || > > > + !handle->sensor_ops->config_set) { > > > > In all other SCMI driver we just check for: > > > > !handle && !handle->sensor_ops > > > > it should be enough, since all the ops are defined if the stack you are > > using supports SCMIv3.0, if not this driver would not even compile since > > some SCMIv3.0 Sensor Extension sensor_ops would be missing as a whole > > inside the struct itself. > > > > Thanks > > > > Cristian > > > > > + dev_err(dev, "SCMI device has no sensor interface\n"); > > > + return -EINVAL; > > > + } > > > + > > > + nr_sensors = handle->sensor_ops->count_get(handle); > > > + if (!nr_sensors) { > > > + dev_dbg(dev, "0 sensors found via SCMI bus\n"); > > > + return -EINVAL; > > > + } > > > + > > > + dev_dbg(dev, "%d sensors found via SCMI bus\n", nr_sensors); > > > + > > > + for (i = 0; i < nr_sensors; i++) { > > > + sensor_info = handle->sensor_ops->info_get(handle, i); > > > + if (!sensor_info) { > > > + dev_err(dev, "SCMI sensor %d has missing info\n", i); > > > + return -EINVAL; > > > + } > > > + > > > + /* Skipping scalar sensor,as this driver only supports accel and gyro */ > > > + if (sensor_info->num_axis == 0) > > > + continue; > > > + > > > + err = scmi_alloc_iiodev(dev, handle, sensor_info, > > > + &scmi_iio_dev); > > > + if (err < 0) { > > > + dev_err(dev, > > > + "failed to allocate IIO device for sensor %s: %d\n", > > > + sensor_info->name, err); > > > + return err; > > > + } > > > + > > > + err = scmi_iio_buffers_setup(scmi_iio_dev); > > > + if (err < 0) { > > > + dev_err(dev, > > > + "IIO buffer setup error at sensor %s: %d\n", > > > + sensor_info->name, err); > > > + return err; > > > + } > > > + > > > + err = devm_iio_device_register(dev, scmi_iio_dev); > > > + if (err) { > > > + dev_err(dev, > > > + "IIO device registration failed at sensor %s: %d\n", > > > + sensor_info->name, err); > > > + return err; > > > + } > > > + } > > > + return err; > > > +} > > > + > > > +static const struct scmi_device_id scmi_id_table[] = { > > > + { SCMI_PROTOCOL_SENSOR, "iiodev" }, > > > + {}, > > > +}; > > > + > > > +MODULE_DEVICE_TABLE(scmi, scmi_id_table); > > > + > > > +static struct scmi_driver scmi_iiodev_driver = { > > > + .name = "scmi-sensor-iiodev", > > > + .probe = scmi_iio_dev_probe, > > > + .id_table = scmi_id_table, > > > +}; > > > + > > > +module_scmi_driver(scmi_iiodev_driver); > > > + > > > +MODULE_AUTHOR("Jyoti Bhayana <jbhayana@google.com>"); > > > +MODULE_DESCRIPTION("SCMI IIO Driver"); > > > +MODULE_LICENSE("GPL v2"); > > > -- > > > 2.30.0.280.ga3ce27912f-goog > > >
diff --git a/MAINTAINERS b/MAINTAINERS index b516bb34a8d5..ccf37d43ab41 100644 --- a/MAINTAINERS +++ b/MAINTAINERS @@ -8567,6 +8567,12 @@ S: Maintained F: Documentation/devicetree/bindings/iio/multiplexer/io-channel-mux.txt F: drivers/iio/multiplexer/iio-mux.c +IIO SCMI BASED DRIVER +M: Jyoti Bhayana <jbhayana@google.com> +L: linux-iio@vger.kernel.org +S: Maintained +F: drivers/iio/common/scmi_sensors/scmi_iio.c + IIO SUBSYSTEM AND DRIVERS M: Jonathan Cameron <jic23@kernel.org> R: Lars-Peter Clausen <lars@metafoo.de> diff --git a/drivers/iio/common/Kconfig b/drivers/iio/common/Kconfig index 2b9ee9161abd..0334b4954773 100644 --- a/drivers/iio/common/Kconfig +++ b/drivers/iio/common/Kconfig @@ -6,5 +6,6 @@ source "drivers/iio/common/cros_ec_sensors/Kconfig" source "drivers/iio/common/hid-sensors/Kconfig" source "drivers/iio/common/ms_sensors/Kconfig" +source "drivers/iio/common/scmi_sensors/Kconfig" source "drivers/iio/common/ssp_sensors/Kconfig" source "drivers/iio/common/st_sensors/Kconfig" diff --git a/drivers/iio/common/Makefile b/drivers/iio/common/Makefile index 4bc30bb548e2..fad40e1e1718 100644 --- a/drivers/iio/common/Makefile +++ b/drivers/iio/common/Makefile @@ -11,5 +11,6 @@ obj-y += cros_ec_sensors/ obj-y += hid-sensors/ obj-y += ms_sensors/ +obj-y += scmi_sensors/ obj-y += ssp_sensors/ obj-y += st_sensors/ diff --git a/drivers/iio/common/scmi_sensors/Kconfig b/drivers/iio/common/scmi_sensors/Kconfig new file mode 100644 index 000000000000..67e084cbb1ab --- /dev/null +++ b/drivers/iio/common/scmi_sensors/Kconfig @@ -0,0 +1,18 @@ +# +# IIO over SCMI +# +# When adding new entries keep the list in alphabetical order + +menu "IIO SCMI Sensors" + +config IIO_SCMI + tristate "IIO SCMI" + depends on ARM_SCMI_PROTOCOL + select IIO_BUFFER + select IIO_KFIFO_BUF + help + Say yes here to build support for IIO SCMI Driver. + This provides ARM SCMI Protocol based IIO device. + This driver provides support for accelerometer and gyroscope + sensors available on SCMI based platforms. +endmenu diff --git a/drivers/iio/common/scmi_sensors/Makefile b/drivers/iio/common/scmi_sensors/Makefile new file mode 100644 index 000000000000..f13140a2575a --- /dev/null +++ b/drivers/iio/common/scmi_sensors/Makefile @@ -0,0 +1,5 @@ +# SPDX - License - Identifier : GPL - 2.0 - only +# +# Makefile for the IIO over SCMI +# +obj-$(CONFIG_IIO_SCMI) += scmi_iio.o diff --git a/drivers/iio/common/scmi_sensors/scmi_iio.c b/drivers/iio/common/scmi_sensors/scmi_iio.c new file mode 100644 index 000000000000..3b76cc54511c --- /dev/null +++ b/drivers/iio/common/scmi_sensors/scmi_iio.c @@ -0,0 +1,736 @@ +// SPDX-License-Identifier: GPL-2.0 + +/* + * System Control and Management Interface(SCMI) based IIO sensor driver + * + * Copyright (C) 2020 Google LLC + */ + +#include <linux/delay.h> +#include <linux/err.h> +#include <linux/iio/buffer.h> +#include <linux/iio/iio.h> +#include <linux/iio/kfifo_buf.h> +#include <linux/iio/sysfs.h> +#include <linux/kernel.h> +#include <linux/kthread.h> +#include <linux/module.h> +#include <linux/scmi_protocol.h> +#include <linux/time.h> +#include <linux/types.h> + +#define ilog10(x) (ilog2(x) / const_ilog2(10)) +#define UHZ_PER_HZ 1000000UL +#define ODR_EXPAND(odr, uodr) (((odr) * 1000000ULL) + (uodr)) +#define MAX_NUM_OF_CHANNELS 4 +#define H32(x) (((x) & 0xFFFFFFFF00000000LL) >> 32) +#define L32(x) ((x) & 0xFFFFFFFFLL) + +struct scmi_iio_priv { + struct scmi_handle *handle; + const struct scmi_sensor_info *sensor_info; + struct iio_dev *indio_dev; + long long iio_buf[MAX_NUM_OF_CHANNELS]; + struct notifier_block sensor_update_nb; + u32 *freq_avail; + /* + * range_avail = [minRange resolution maxRange] + * with IIO val type as IIO_VAL_FRACTIONAL. + * Hence, array of size 6. + */ + int range_avail[6]; +}; + +static int scmi_iio_sensor_update_cb(struct notifier_block *nb, + unsigned long event, void *data) +{ + struct scmi_sensor_update_report *sensor_update = data; + struct iio_dev *scmi_iio_dev; + struct scmi_iio_priv *sensor; + s8 tstamp_scale; + u64 time, time_ns; + int i; + + if (sensor_update->readings_count == 0) + return NOTIFY_DONE; + + sensor = container_of(nb, struct scmi_iio_priv, sensor_update_nb); + + for (i = 0; i < sensor_update->readings_count; i++) + sensor->iio_buf[i] = sensor_update->readings[i].value; + + if (!sensor->sensor_info->timestamped) { + time_ns = iio_get_time_ns(scmi_iio_dev); + } else { + /* + * All the axes are supposed to have the same value for timestamp. + * We are just using the values from the Axis 0 here. + */ + time = sensor_update->readings[0].timestamp; + + /* + * Timestamp returned by SCMI is in seconds and is equal to + * time * power-of-10 multiplier(tstamp_scale) seconds. + * Converting the timestamp to nanoseconds below. + */ + tstamp_scale = sensor->sensor_info->tstamp_scale + + ilog10(NSEC_PER_SEC); + if (tstamp_scale < 0) + time_ns = div64_u64(time, + int_pow(10, abs(tstamp_scale))); + else + time_ns = time * int_pow(10, tstamp_scale); + } + + scmi_iio_dev = sensor->indio_dev; + iio_push_to_buffers_with_timestamp(scmi_iio_dev, sensor->iio_buf, + time_ns); + return NOTIFY_OK; +} + +static int scmi_iio_buffer_preenable(struct iio_dev *iio_dev) +{ + struct scmi_iio_priv *sensor = iio_priv(iio_dev); + u32 sensor_id = sensor->sensor_info->id; + u32 sensor_config; + int err; + + if (sensor->sensor_info->timestamped) + sensor_config |= FIELD_PREP(SCMI_SENS_CFG_TSTAMP_ENABLED_MASK, + SCMI_SENS_CFG_TSTAMP_ENABLE); + + sensor_config |= FIELD_PREP(SCMI_SENS_CFG_SENSOR_ENABLED_MASK, + SCMI_SENS_CFG_SENSOR_ENABLE); + + err = sensor->handle->notify_ops->register_event_notifier(sensor->handle, + SCMI_PROTOCOL_SENSOR, SCMI_EVENT_SENSOR_UPDATE, + &sensor_id, &sensor->sensor_update_nb); + if (err) { + dev_err(&iio_dev->dev, + "Error in registering sensor update notifier for sensor %s err %d", + sensor->sensor_info->name, err); + return err; + } + + err = sensor->handle->sensor_ops->config_set(sensor->handle, + sensor->sensor_info->id, sensor_config); + if (err) + dev_err(&iio_dev->dev, "Error in enabling sensor %s err %d", + sensor->sensor_info->name, err); + + return err; +} + +static int scmi_iio_buffer_postdisable(struct iio_dev *iio_dev) +{ + struct scmi_iio_priv *sensor = iio_priv(iio_dev); + u32 sensor_id = sensor->sensor_info->id; + u32 sensor_config = 0; + int err; + + sensor_config |= FIELD_PREP(SCMI_SENS_CFG_SENSOR_ENABLED_MASK, + SCMI_SENS_CFG_SENSOR_DISABLE); + + err = sensor->handle->notify_ops->unregister_event_notifier(sensor->handle, + SCMI_PROTOCOL_SENSOR, SCMI_EVENT_SENSOR_UPDATE, + &sensor_id, &sensor->sensor_update_nb); + if (err) { + dev_err(&iio_dev->dev, + "Error in unregistering sensor update notifier for sensor %s err %d", + sensor->sensor_info->name, err); + return err; + } + + err = sensor->handle->sensor_ops->config_set(sensor->handle, sensor_id, + sensor_config); + if (err) + dev_err(&iio_dev->dev, + "Error in disabling sensor %s with err %d", + sensor->sensor_info->name, err); + + return err; +} + +static const struct iio_buffer_setup_ops scmi_iio_buffer_ops = { + .preenable = scmi_iio_buffer_preenable, + .postdisable = scmi_iio_buffer_postdisable, +}; + +static int scmi_iio_read_avail(struct iio_dev *iio_dev, + struct iio_chan_spec const *chan, + const int **vals, int *type, int *length, + long mask) +{ + struct scmi_iio_priv *sensor = iio_priv(iio_dev); + + switch (mask) { + case IIO_CHAN_INFO_SAMP_FREQ: + *vals = sensor->freq_avail; + *type = IIO_VAL_INT_PLUS_MICRO; + *length = sensor->sensor_info->intervals.count * 2; + if (sensor->sensor_info->intervals.segmented) + return IIO_AVAIL_RANGE; + else + return IIO_AVAIL_LIST; + case IIO_CHAN_INFO_RAW: + *vals = sensor->range_avail; + *type = IIO_VAL_FRACTIONAL; + *length = ARRAY_SIZE(sensor->range_avail); + return IIO_AVAIL_RANGE; + default: + return -EINVAL; + } +} + +static int scmi_iio_set_odr_val(struct iio_dev *iio_dev, int val, int val2) +{ + struct scmi_iio_priv *sensor = iio_priv(iio_dev); + u64 sec, mult, uHz; + u32 sensor_config; + + int err = sensor->handle->sensor_ops->config_get(sensor->handle, + sensor->sensor_info->id, &sensor_config); + if (err) { + dev_err(&iio_dev->dev, + "Error in getting sensor config for sensor %s err %d", + sensor->sensor_info->name, err); + return err; + } + + uHz = ODR_EXPAND(val, val2); + + /* + * The seconds field in the sensor interval in SCMI is 16 bits long + * Therefore seconds = 1/Hz <= 0xFFFF. As floating point calculations are + * discouraged in the kernel driver code, to calculate the scale factor (sf) + * (1* 1000000 * sf)/uHz <= 0xFFFF. Therefore, sf <= (uHz * 0xFFFF)/1000000 + */ + mult = ilog10(((u64)uHz * 0xFFFF) / UHZ_PER_HZ); + + sec = div64_u64(int_pow(10, mult) * UHZ_PER_HZ, uHz); + if (sec == 0) { + dev_err(&iio_dev->dev, + "Trying to set invalid sensor update value for sensor %s", + sensor->sensor_info->name); + return -EINVAL; + } + + sensor_config &= ~SCMI_SENS_CFG_UPDATE_SECS_MASK; + sensor_config |= FIELD_PREP(SCMI_SENS_CFG_UPDATE_SECS_MASK, sec); + sensor_config &= ~SCMI_SENS_CFG_UPDATE_EXP_MASK; + sensor_config |= FIELD_PREP(SCMI_SENS_CFG_UPDATE_EXP_MASK, -mult); + + if (sensor->sensor_info->timestamped) { + sensor_config &= ~SCMI_SENS_CFG_TSTAMP_ENABLED_MASK; + sensor_config |= FIELD_PREP(SCMI_SENS_CFG_TSTAMP_ENABLED_MASK, + SCMI_SENS_CFG_TSTAMP_ENABLE); + } + + sensor_config &= ~SCMI_SENS_CFG_ROUND_MASK; + sensor_config |= + FIELD_PREP(SCMI_SENS_CFG_ROUND_MASK, SCMI_SENS_CFG_ROUND_AUTO); + + err = sensor->handle->sensor_ops->config_set(sensor->handle, + sensor->sensor_info->id, sensor_config); + if (err) + dev_err(&iio_dev->dev, + "Error in setting sensor update interval for sensor %s value %u err %d", + sensor->sensor_info->name, sensor_config, err); + + return err; +} + +static int scmi_iio_write_raw(struct iio_dev *iio_dev, + struct iio_chan_spec const *chan, int val, + int val2, long mask) +{ + int err; + + switch (mask) { + case IIO_CHAN_INFO_SAMP_FREQ: + mutex_lock(&iio_dev->mlock); + err = scmi_iio_set_odr_val(iio_dev, val, val2); + mutex_unlock(&iio_dev->mlock); + return err; + default: + return -EINVAL; + } +} + +static u64 scmi_iio_convert_interval_to_ns(u32 val) +{ + u64 sensor_update_interval = + SCMI_SENS_INTVL_GET_SECS(val) * NSEC_PER_SEC; + u64 sensor_interval_mult; + int mult; + + mult = SCMI_SENS_INTVL_GET_EXP(val); + if (mult < 0) { + sensor_interval_mult = int_pow(10, abs(mult)); + sensor_update_interval = + sensor_update_interval / sensor_interval_mult; + } else { + sensor_interval_mult = int_pow(10, mult); + sensor_update_interval = + sensor_update_interval * sensor_interval_mult; + } + return sensor_update_interval; +} + +static void convert_ns_to_freq(u64 interval_ns, u64 *hz, u64 *uhz) +{ + u64 rem; + + *hz = div64_u64_rem(NSEC_PER_SEC, interval_ns, &rem); + *uhz = (rem * 1000000UL) / interval_ns; +} + +static int scmi_iio_get_odr_val(struct iio_dev *iio_dev, int *val, int *val2) +{ + u64 sensor_update_interval, sensor_interval_mult, hz, uhz; + struct scmi_iio_priv *sensor = iio_priv(iio_dev); + u32 sensor_config; + int mult; + + int err = sensor->handle->sensor_ops->config_get(sensor->handle, + sensor->sensor_info->id, &sensor_config); + if (err) { + dev_err(&iio_dev->dev, + "Error in getting sensor config for sensor %s err %d", + sensor->sensor_info->name, err); + return err; + } + + sensor_update_interval = + SCMI_SENS_CFG_GET_UPDATE_SECS(sensor_config) * NSEC_PER_SEC; + + mult = SCMI_SENS_CFG_GET_UPDATE_EXP(sensor_config); + if (mult < 0) { + sensor_interval_mult = int_pow(10, abs(mult)); + sensor_update_interval = + sensor_update_interval / sensor_interval_mult; + } else { + sensor_interval_mult = int_pow(10, mult); + sensor_update_interval = + sensor_update_interval * sensor_interval_mult; + } + + convert_ns_to_freq(sensor_update_interval, &hz, &uhz); + *val = hz; + *val2 = uhz; + return 0; +} + +static int scmi_iio_read_raw(struct iio_dev *iio_dev, + struct iio_chan_spec const *ch, int *val, + int *val2, long mask) +{ + struct scmi_iio_priv *sensor = iio_priv(iio_dev); + s8 scale; + int ret; + + switch (mask) { + case IIO_CHAN_INFO_SCALE: + scale = sensor->sensor_info->axis[ch->scan_index].scale; + if (scale < 0) { + *val = 1; + *val2 = int_pow(10, abs(scale)); + return IIO_VAL_FRACTIONAL; + } + *val = int_pow(10, scale); + return IIO_VAL_INT; + case IIO_CHAN_INFO_SAMP_FREQ: + ret = scmi_iio_get_odr_val(iio_dev, val, val2); + return ret ? ret : IIO_VAL_INT_PLUS_MICRO; + default: + return -EINVAL; + } +} + +static const struct iio_info scmi_iio_info = { + .read_raw = scmi_iio_read_raw, + .read_avail = scmi_iio_read_avail, + .write_raw = scmi_iio_write_raw, +}; + +static void scmi_iio_set_timestamp_channel(struct iio_chan_spec *iio_chan, + int scan_index) +{ + iio_chan->type = IIO_TIMESTAMP; + iio_chan->channel = -1; + iio_chan->scan_index = scan_index; + iio_chan->scan_type.sign = 'u'; + iio_chan->scan_type.realbits = 64; + iio_chan->scan_type.storagebits = 64; +} + +static void scmi_iio_set_data_channel(struct iio_chan_spec *iio_chan, + enum iio_chan_type type, + enum iio_modifier mod, int scan_index) +{ + iio_chan->type = type; + iio_chan->modified = 1; + iio_chan->channel2 = mod; + iio_chan->info_mask_separate = BIT(IIO_CHAN_INFO_SCALE); + iio_chan->info_mask_shared_by_type = BIT(IIO_CHAN_INFO_SAMP_FREQ); + iio_chan->info_mask_shared_by_type_available = + BIT(IIO_CHAN_INFO_SAMP_FREQ) | BIT(IIO_CHAN_INFO_RAW); + iio_chan->scan_index = scan_index; + iio_chan->scan_type.sign = 's'; + iio_chan->scan_type.realbits = 64; + iio_chan->scan_type.storagebits = 64; + iio_chan->scan_type.endianness = IIO_LE; +} + +static int scmi_iio_get_chan_modifier(const char *name, + enum iio_modifier *modifier) +{ + char *pch; + + pch = strrchr(name, '_'); + if (!pch) + return -EINVAL; + + if (strcmp(pch + 1, "X") == 0) { + *modifier = IIO_MOD_X; + return 0; + } else if (strcmp(pch + 1, "Y") == 0) { + *modifier = IIO_MOD_Y; + return 0; + } else if (strcmp(pch + 1, "Z") == 0) { + *modifier = IIO_MOD_Z; + return 0; + } else { + return -EINVAL; + } +} + +static int scmi_iio_get_chan_type(u8 scmi_type, enum iio_chan_type *iio_type) +{ + switch (scmi_type) { + case METERS_SEC_SQUARED: + *iio_type = IIO_ACCEL; + return 0; + case RADIANS_SEC: + *iio_type = IIO_ANGL_VEL; + return 0; + default: + return -EINVAL; + } +} + +static int scmi_iio_get_sensor_max_range(struct iio_dev *iio_dev, int *val, + int *val2) +{ + struct scmi_iio_priv *sensor = iio_priv(iio_dev); + int max_range_high, max_range_low; + long long max_range; + + /* + * All the axes are supposed to have the same value for max range. + * We are just using the values from the Axis 0 here. + */ + if (sensor->sensor_info->axis[0].extended_attrs) { + max_range = sensor->sensor_info->axis[0].attrs.max_range; + max_range_high = H32(max_range); + max_range_low = L32(max_range); + + /* + * As IIO Val types have no provision for 64 bit values, + * and currently there are no known sensors using 64 bit + * for the range, this driver only supports sensor with + * 32 bit range value. + */ + if (max_range_high != 0) + return -EINVAL; + + *val = max_range_low; + *val2 = 1; + } + return 0; +} + +static void scmi_iio_get_sensor_resolution(struct iio_dev *iio_dev, int *val, + int *val2) +{ + struct scmi_iio_priv *sensor = iio_priv(iio_dev); + + /* + * All the axes are supposed to have the same value for resolution + * and exponent. We are just using the values from the Axis 0 here. + */ + if (sensor->sensor_info->axis[0].extended_attrs) { + uint resolution = sensor->sensor_info->axis[0].resolution; + s8 exponent = sensor->sensor_info->axis[0].exponent; + s8 scale = sensor->sensor_info->axis[0].scale; + + /* + * To provide the raw value for the resolution to the userspace, + * need to divide the resolution exponent by the sensor scale + */ + exponent = exponent - scale; + if (exponent >= 0) { + *val = resolution * int_pow(10, exponent); + *val2 = 1; + } else { + *val = resolution; + *val2 = int_pow(10, abs(exponent)); + } + } +} + +static int scmi_iio_get_sensor_min_range(struct iio_dev *iio_dev, int *val, + int *val2) +{ + struct scmi_iio_priv *sensor = iio_priv(iio_dev); + int min_range_high, min_range_low; + long long min_range; + + /* + * All the axes are supposed to have the same value for min range. + * We are just using the values from the Axis 0 here. + */ + if (sensor->sensor_info->axis[0].extended_attrs) { + min_range = sensor->sensor_info->axis[0].attrs.min_range; + min_range_high = H32(min_range); + min_range_low = L32(min_range); + + /* + * As IIO Val types have no provision for 64 bit values, + * and currently there are no known sensors using 64 bit + * for the range, this driver only supports sensor with + * 32 bit range value. + */ + if (min_range_high != 0xFFFFFFFF) + return -EINVAL; + + *val = min_range_low; + *val2 = 1; + } + return 0; +} + +static int scmi_iio_set_sensor_range_avail(struct iio_dev *iio_dev) +{ + struct scmi_iio_priv *sensor = iio_priv(iio_dev); + int ret; + + ret = scmi_iio_get_sensor_min_range(iio_dev, &sensor->range_avail[0], + &sensor->range_avail[1]); + if (ret) + return ret; + + scmi_iio_get_sensor_resolution(iio_dev, &sensor->range_avail[2], + &sensor->range_avail[3]); + ret = scmi_iio_get_sensor_max_range(iio_dev, &sensor->range_avail[4], + &sensor->range_avail[5]); + return ret; +} + +static int scmi_iio_set_sampling_freq_avail(struct iio_dev *iio_dev) +{ + u64 cur_interval_ns, low_interval_ns, high_interval_ns, step_size_ns, + hz, uhz; + unsigned int cur_interval, low_interval, high_interval, step_size; + struct scmi_iio_priv *sensor = iio_priv(iio_dev); + int i; + + sensor->freq_avail = devm_kzalloc(&iio_dev->dev, + sizeof(u32) * (sensor->sensor_info->intervals.count * 2), + GFP_KERNEL); + if (!sensor->freq_avail) + return -ENOMEM; + + if (sensor->sensor_info->intervals.segmented) { + low_interval = sensor->sensor_info->intervals + .desc[SCMI_SENS_INTVL_SEGMENT_LOW]; + low_interval_ns = scmi_iio_convert_interval_to_ns(low_interval); + convert_ns_to_freq(low_interval_ns, &hz, &uhz); + sensor->freq_avail[0] = hz; + sensor->freq_avail[1] = uhz; + + step_size = sensor->sensor_info->intervals + .desc[SCMI_SENS_INTVL_SEGMENT_STEP]; + step_size_ns = scmi_iio_convert_interval_to_ns(step_size); + convert_ns_to_freq(step_size_ns, &hz, &uhz); + sensor->freq_avail[2] = hz; + sensor->freq_avail[3] = uhz; + + high_interval = sensor->sensor_info->intervals + .desc[SCMI_SENS_INTVL_SEGMENT_HIGH]; + high_interval_ns = + scmi_iio_convert_interval_to_ns(high_interval); + convert_ns_to_freq(high_interval_ns, &hz, &uhz); + sensor->freq_avail[4] = hz; + sensor->freq_avail[5] = uhz; + } else { + for (i = 0; i < sensor->sensor_info->intervals.count; i++) { + cur_interval = sensor->sensor_info->intervals.desc[i]; + cur_interval_ns = scmi_iio_convert_interval_to_ns(cur_interval); + convert_ns_to_freq(cur_interval_ns, &hz, &uhz); + sensor->freq_avail[i * 2] = hz; + sensor->freq_avail[i * 2 + 1] = uhz; + } + } + return 0; +} + +static int scmi_iio_buffers_setup(struct iio_dev *scmi_iiodev) +{ + struct iio_buffer *buffer; + + buffer = devm_iio_kfifo_allocate(&scmi_iiodev->dev); + if (!buffer) + return -ENOMEM; + + iio_device_attach_buffer(scmi_iiodev, buffer); + scmi_iiodev->modes |= INDIO_BUFFER_SOFTWARE; + scmi_iiodev->setup_ops = &scmi_iio_buffer_ops; + return 0; +} + +static int scmi_alloc_iiodev(struct device *dev, struct scmi_handle *handle, + const struct scmi_sensor_info *sensor_info, + struct iio_dev **scmi_iio_dev) +{ + struct iio_chan_spec *iio_channels; + struct scmi_iio_priv *sensor; + enum iio_modifier modifier; + enum iio_chan_type type; + struct iio_dev *iiodev; + int i, ret; + + iiodev = devm_iio_device_alloc(dev, sizeof(*sensor)); + if (!iiodev) + return -ENOMEM; + + iiodev->modes = INDIO_DIRECT_MODE; + iiodev->dev.parent = dev; + sensor = iio_priv(iiodev); + sensor->handle = handle; + sensor->sensor_info = sensor_info; + sensor->sensor_update_nb.notifier_call = scmi_iio_sensor_update_cb; + sensor->indio_dev = iiodev; + + /* adding one additional channel for timestamp */ + iiodev->num_channels = sensor_info->num_axis + 1; + iiodev->name = sensor_info->name; + iiodev->info = &scmi_iio_info; + + iio_channels = + devm_kzalloc(dev, + sizeof(*iio_channels) * (iiodev->num_channels), + GFP_KERNEL); + if (!iio_channels) + return -ENOMEM; + + scmi_iio_set_sampling_freq_avail(iiodev); + + ret = scmi_iio_set_sensor_range_avail(iiodev); + if (ret) { + dev_err(dev, "Error while setting the sensor %s range %d", + sensor_info->name, ret); + return ret; + } + + for (i = 0; i < sensor_info->num_axis; i++) { + ret = scmi_iio_get_chan_type(sensor_info->axis[i].type, &type); + if (ret < 0) + return ret; + + ret = scmi_iio_get_chan_modifier(sensor_info->axis[i].name, + &modifier); + if (ret < 0) + return ret; + + scmi_iio_set_data_channel(&iio_channels[i], type, modifier, + sensor_info->axis[i].id); + } + + scmi_iio_set_timestamp_channel(&iio_channels[i], i); + iiodev->channels = iio_channels; + *scmi_iio_dev = iiodev; + return ret; +} + +static int scmi_iio_dev_probe(struct scmi_device *sdev) +{ + const struct scmi_sensor_info *sensor_info; + struct scmi_handle *handle = sdev->handle; + struct device *dev = &sdev->dev; + struct iio_dev *scmi_iio_dev; + u16 nr_sensors; + int err, i; + + if (!handle || !handle->sensor_ops || !handle->sensor_ops->count_get || + !handle->sensor_ops->info_get || !handle->sensor_ops->config_get || + !handle->sensor_ops->config_set) { + dev_err(dev, "SCMI device has no sensor interface\n"); + return -EINVAL; + } + + nr_sensors = handle->sensor_ops->count_get(handle); + if (!nr_sensors) { + dev_dbg(dev, "0 sensors found via SCMI bus\n"); + return -EINVAL; + } + + dev_dbg(dev, "%d sensors found via SCMI bus\n", nr_sensors); + + for (i = 0; i < nr_sensors; i++) { + sensor_info = handle->sensor_ops->info_get(handle, i); + if (!sensor_info) { + dev_err(dev, "SCMI sensor %d has missing info\n", i); + return -EINVAL; + } + + /* Skipping scalar sensor,as this driver only supports accel and gyro */ + if (sensor_info->num_axis == 0) + continue; + + err = scmi_alloc_iiodev(dev, handle, sensor_info, + &scmi_iio_dev); + if (err < 0) { + dev_err(dev, + "failed to allocate IIO device for sensor %s: %d\n", + sensor_info->name, err); + return err; + } + + err = scmi_iio_buffers_setup(scmi_iio_dev); + if (err < 0) { + dev_err(dev, + "IIO buffer setup error at sensor %s: %d\n", + sensor_info->name, err); + return err; + } + + err = devm_iio_device_register(dev, scmi_iio_dev); + if (err) { + dev_err(dev, + "IIO device registration failed at sensor %s: %d\n", + sensor_info->name, err); + return err; + } + } + return err; +} + +static const struct scmi_device_id scmi_id_table[] = { + { SCMI_PROTOCOL_SENSOR, "iiodev" }, + {}, +}; + +MODULE_DEVICE_TABLE(scmi, scmi_id_table); + +static struct scmi_driver scmi_iiodev_driver = { + .name = "scmi-sensor-iiodev", + .probe = scmi_iio_dev_probe, + .id_table = scmi_id_table, +}; + +module_scmi_driver(scmi_iiodev_driver); + +MODULE_AUTHOR("Jyoti Bhayana <jbhayana@google.com>"); +MODULE_DESCRIPTION("SCMI IIO Driver"); +MODULE_LICENSE("GPL v2");
This change provides ARM SCMI Protocol based IIO device. This driver provides support for Accelerometer and Gyroscope using new SCMI Sensor Protocol defined by the upcoming SCMIv3.0 ARM specification Signed-off-by: Jyoti Bhayana <jbhayana@google.com> --- MAINTAINERS | 6 + drivers/iio/common/Kconfig | 1 + drivers/iio/common/Makefile | 1 + drivers/iio/common/scmi_sensors/Kconfig | 18 + drivers/iio/common/scmi_sensors/Makefile | 5 + drivers/iio/common/scmi_sensors/scmi_iio.c | 736 +++++++++++++++++++++ 6 files changed, 767 insertions(+) create mode 100644 drivers/iio/common/scmi_sensors/Kconfig create mode 100644 drivers/iio/common/scmi_sensors/Makefile create mode 100644 drivers/iio/common/scmi_sensors/scmi_iio.c