Re: [PATCH 2/2] iio: chemical: acd10: Add driver for ACD10 CO2 sensor
From: Jonathan Cameron
Date: Sun Nov 22 2026 - 14:32:09 EST
On Sun, 22 Nov 2026 06:32:46 +0000
Akhilesh Patil <akhilesh.patil@xxxxxxxxx> wrote:
> Add driver for Aosong ASAIR ACD10 carbon dioxide sensor.
> Use serdev interface to communicate with sensor over UART.
> Implement read co2, get software revision, get instrument number
> commands.
>
> Tested on TI am62x sk board on UART5 with 1200 baud rate.
>
> Signed-off-by: Akhilesh Patil <akhilesh.patil@xxxxxxxxx>
A few things from sashiko. I didn't look at whether they were correct or not
https://sashiko.dev/#/patchset/cover.1795326744.git.akhilesh.patil%40linux.dev
Some other comments below. Given this is a new driver, give it about a week
before sending v2 to allow others time to review.
Thanks,
Jonathan
> diff --git a/drivers/iio/chemical/acd10.c b/drivers/iio/chemical/acd10.c
> new file mode 100644
> index 000000000000..b92f01e7bf4a
> --- /dev/null
> +++ b/drivers/iio/chemical/acd10.c
> @@ -0,0 +1,365 @@
> +// SPDX-License-Identifier: GPL-2.0
> +/*
> + * ACD10 CO2 gas sensor driver
> + *
> + * Copyright (c) 2026 Akhilesh Patil <akhilesh.patil@xxxxxxxxx>
> + *
> + * Datasheet:
> + * https://www.es.co.th/Schemetic/PDF/ACD10.PDF
> + *
> + * TODO additional features:
> + * 1) single-point calibration feature.
> + * 2) Sensor preheat wait feature.
> + */
> +
> +#include <linux/array_size.h>
> +#include <linux/bits.h>
> +#include <linux/cleanup.h>
> +#include <linux/completion.h>
> +#include <linux/dev_printk.h>
> +#include <linux/device.h>
I haven't checked for things actually in device.h but make
sure this shouldn't be replaced with more specific headers.
> +#include <linux/errno.h>
> +#include <linux/iio/iio.h>
> +#include <linux/iio/types.h>
> +#include <linux/jiffies.h>
> +#include <linux/mod_devicetable.h>
Not needed any more unless something is wrong in the serdev
header. These are now assumed to always come from the bus header.
> +#include <linux/module.h>
> +#include <linux/mutex.h>
> +#include <linux/serdev.h>
> +#include <linux/string.h>
> +#include <linux/types.h>
> +#include <linux/unaligned.h>
> +
> +enum acd10_cmds {
> + ACD10_CMD_READ_CO2 = 0,
Where they line up with values on the datasheet, I would always
specify them all. Doesn't matter so much when there are only 4
but for large lists it saves on a lot of counting!
> + ACD10_CMD_CAL,
> + ACD10_CMD_READ_SWREV,
> + ACD10_CMD_READ_INS_NUM,
> +};
> +
> +struct acd10_cmd_info {
> + u8 cmd_code;
> + u8 tx_frame_len;
> + u8 tx_data_len;
> + u8 rx_frame_len;
> +};
> +
> +/*
> + * Do transfer based on command and fill drv_state->buf with received data.
> + * Caller of this function should use mutex drv_state->lock.
__must_hold() markings can change that documentation to something enforced
but the static analysis tools.
> + */
> +static int acd10_serdev_transfer(struct iio_dev *indio_dev, enum acd10_cmds cmd)
> +{
> + struct acd10_state *drv_state = iio_priv(indio_dev);
> + struct serdev_device *serdev = drv_state->serdev;
> + struct device *dev = &indio_dev->dev;
> + int ret;
> +
> + /* Prepare transmit buffer along with checksum */
> + drv_state->buf[0] = ACD10_FRAME_START;
> + drv_state->buf[1] = ACD10_FRAME_FIXED_CODE;
> + drv_state->buf[ACD10_FRAME_DATA_LEN_IDX] = cmd_info[cmd].tx_data_len;
Why do these two get IDX defines whils previous do not?
> + drv_state->buf[ACD10_FRAME_CMD_CODE_IDX] = cmd_info[cmd].cmd_code;
> + drv_state->buf[cmd_info[cmd].tx_frame_len - 1] =
> + acd10_get_checksum(drv_state->buf, cmd_info[cmd].tx_frame_len);
Are there even any entries between this and the previous? I would kind of
expect to see some zeroing of those prior to CRC given the code here.
If there aren't what is tx_frame_len for?
> + drv_state->buf_idx = 0;
> + drv_state->rx_expected_len = cmd_info[cmd].rx_frame_len;
> + reinit_completion(&drv_state->buf_ready);
> +
> + /* Transmit the buffer over serdev */
> + ret = serdev_device_write(serdev, drv_state->buf, cmd_info[cmd].tx_frame_len,
> + ACD10_SERDEV_TIMEOUT);
> + if (ret < 0)
> + return ret;
> + if (ret != cmd_info[cmd].tx_frame_len)
> + return -EIO;
> +
> + /* Read the received bytes in buffer */
> + ret = wait_for_completion_interruptible_timeout(&drv_state->buf_ready,
> + ACD10_SERDEV_TIMEOUT);
> + if (ret < 0)
> + return ret;
> + if (!ret)
> + return -ETIMEDOUT;
> +
> + /* validate frame header */
> + if (drv_state->buf[0] != ACD10_FRAME_START ||
> + drv_state->buf[1] != ACD10_FRAME_FIXED_CODE) {
> + dev_err(dev, "RX frame invalid\n");
> + return -EIO;
> + }
> +
> + /* Maximum data len can be max 11 */
> + if (drv_state->buf[ACD10_FRAME_DATA_LEN_IDX] > ACD10_FRAME_DATA_LEN_MAX)
> + return -EIO;
> +
> + /* Validate command echo */
> + if (drv_state->buf[ACD10_FRAME_CMD_CODE_IDX] != cmd_info[cmd].cmd_code)
> + return -EIO;
> +
> + /* Validate checksum */
That's fairly obvious from the code. Keep comment for where they add
value over what can be seen without. Same applies to at least some of the ones above.
> + if (drv_state->buf[cmd_info[cmd].rx_frame_len - 1] !=
> + acd10_get_checksum(drv_state->buf, cmd_info[cmd].rx_frame_len)) {
> + dev_err(dev, "Checksum error\n");
> + return -EIO;
> + }
> +
> + return 0;
> +}
> +
> +static int acd10_get_sw_rev(struct iio_dev *indio_dev)
> +{
> + struct acd10_state *drv_state = iio_priv(indio_dev);
> + struct device *dev = &indio_dev->dev;
> + int ret;
> +
> + ret = acd10_serdev_transfer(indio_dev, ACD10_CMD_READ_SWREV);
> + if (ret)
> + return ret;
> +
> + memcpy(drv_state->sw_rev, &drv_state->buf[ACD10_FRAME_DATA_START], 10);
> + drv_state->sw_rev[10] = '\0';
> +
> + dev_info(dev, "Software revision: %s\n", drv_state->sw_rev);
dev_dbg() probably.
We tend to not print this stuff by default as it leads to ever more bloated
kernel logs.
> +
> + return 0;
> +}
> +
> +static int acd10_get_instrument_num(struct iio_dev *indio_dev)
> +{
> + struct acd10_state *drv_state = iio_priv(indio_dev);
> + struct device *dev = &indio_dev->dev;
> + int ret;
> +
> + ret = acd10_serdev_transfer(indio_dev, ACD10_CMD_READ_INS_NUM);
> + if (ret)
> + return ret;
> +
> + memcpy(drv_state->inst_num, &drv_state->buf[ACD10_FRAME_DATA_START], 10);
> + drv_state->inst_num[10] = '\0';
> +
> + dev_info(dev, "Instrument number: %s\n", drv_state->inst_num);
Noisy. I'm not sure what this is. Can it map to serial_number which is
standard ABI?
> +
> + return 0;
> +}
> +static int acd10_read_raw(struct iio_dev *indio_dev,
> + struct iio_chan_spec const *chan,
> + int *val, int *val2, long mask)
> +{
> + struct acd10_state *drv_state = iio_priv(indio_dev);
> + int ret;
> +
> + switch (mask) {
> + case IIO_CHAN_INFO_RAW:
> +
> + /* Read CO2 sensor value*/
> + scoped_guard(mutex, &drv_state->lock) {
Preference where it is applicable is to use scope definition for case blocks that
need a guard.
case IIO_CHAN_INFO_RAW: {
int ret;
guard(mutex)(&drv_state->lock);
ret = acd10_serdev_transfer(indio_dev, ACD10_CMD_READ_CO2);
if (ret)
return ret;
*val = get_unaligned_be16(&drv_state->buf[ACD10_FRAME_DATA_START]);
return IIO_VAL_INT;
}
Mostly because it remove unnecessary indent.
> + ret = acd10_serdev_transfer(indio_dev, ACD10_CMD_READ_CO2);
> + if (ret)
> + return ret;
> +
> + *val = get_unaligned_be16(&drv_state->buf[ACD10_FRAME_DATA_START]);
> + }
> +
> + return IIO_VAL_INT;
> +
> + case IIO_CHAN_INFO_SCALE:
> + *val = 0;
> + *val2 = 100;
> + return IIO_VAL_INT_PLUS_MICRO;
> +
> + default:
> + return -EINVAL;
> + }
> +}
> +
> +static int acd10_probe(struct serdev_device *serdev)
> +{
> + int ret;
Where ordering isn't required due to dependencies mild preference for
reverse xmas tree.
> + struct device *dev = &serdev->dev;
> + struct iio_dev *indio_dev;
> + struct acd10_state *drv_state;
> + unsigned int baudrate;
> +
> + indio_dev = devm_iio_device_alloc(dev, sizeof(struct acd10_state));
sizeof(*drv_state)
> + if (!indio_dev)
> + return -ENOMEM;
> +
> + indio_dev->name = "acd10";
> + indio_dev->channels = acd10_channels;
> + indio_dev->num_channels = ARRAY_SIZE(acd10_channels);
> + indio_dev->info = &acd10_info;
> +
> + serdev_device_set_drvdata(serdev, indio_dev);
> +
> + drv_state = iio_priv(indio_dev);
> + drv_state->serdev = serdev;
> +
> + init_completion(&drv_state->buf_ready);
> + ret = devm_mutex_init(dev, &drv_state->lock);
> + if (ret)
> + return ret;
> +
> + serdev_device_set_client_ops(serdev, &acd10_ser_ops);
> + ret = devm_serdev_device_open(dev, serdev);
> + if (ret) {
> + dev_err(dev, "ACD10: serial device open failed\n");
> + return ret;
return dev_err_probe(dev, ret, ...
It's both shorter and saves any effort by reviewer to figure
out if deferral is possible on a given call. Use this for every
error print in probe + any in functions only called from probe.
> + }
> +
> + baudrate = serdev_device_set_baudrate(serdev, ACD10_SERIAL_BAUDRATE);
> + dev_info(dev, "baud rate set to: %u\n", baudrate);
Too noisy for a production driver. dev_dbg() or drop it entirely.
> + if (baudrate != ACD10_SERIAL_BAUDRATE) {
> + dev_err(dev, "baud rate expected: %u, got: %u\n",
> + ACD10_SERIAL_BAUDRATE, baudrate);
> + return -EIO;
> + }
> + serdev_device_set_flow_control(serdev, false);
> + ret = serdev_device_set_parity(serdev, SERDEV_PARITY_NONE);
> + if (ret)
> + return ret;
> +
> + ret = acd10_get_sw_rev(indio_dev);
> + if (ret)
> + return ret;
> +
> + ret = acd10_get_instrument_num(indio_dev);
> + if (ret)
> + return ret;
> +
> + ret = devm_iio_device_register(dev, indio_dev);
> + if (ret)
> + return ret;
> +
> + return 0;
return devm_iio_device_register();
> +}