From patchwork Sat May 1 18:24:28 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: =?utf-8?q?J=C3=B3zsef_Horv=C3=A1th?= X-Patchwork-Id: 12234961 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-22.2 required=3.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,HEADER_FROM_DIFFERENT_DOMAINS,INCLUDES_CR_TRAILER, INCLUDES_PATCH,MAILING_LIST_MULTI,MENTIONS_GIT_HOSTING,SPF_HELO_NONE,SPF_PASS, URIBL_BLOCKED,USER_AGENT_SANE_1 autolearn=ham autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id 395CAC433B4 for ; Sat, 1 May 2021 18:31:46 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by mail.kernel.org (Postfix) with ESMTP id 0C1786142B for ; Sat, 1 May 2021 18:31:46 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S232135AbhEAScf (ORCPT ); Sat, 1 May 2021 14:32:35 -0400 Received: from bmail1.ministro.hu ([5.249.150.236]:34814 "EHLO bmail1.ministro.hu" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S231426AbhEASce (ORCPT ); Sat, 1 May 2021 14:32:34 -0400 Received: from localhost (localhost [127.0.0.1]) by bmail1.ministro.hu (Postfix) with ESMTP id 5A71D123F6E; Sat, 1 May 2021 20:25:20 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=ministro.hu; s=201804; t=1619893520; bh=tHM9Y9okh6FjXB+hr+oiUWdj7GXuyOHYCxihl3yKQY4=; h=Date:From:To:Subject:From; b=K0NgHESo3lpHA0Ts/pfHhNEqdPz7qTRO98HexTnVbQExBGZ0T38NXKXE+5gfcBrVv 7yKclRX7stNwbxQfxTNPL2nxyXJccEEjdofaLC0H8hCKpOqMg2zK3HGmEQcE9rqSUb +HrlmlxJHNi0fNL0JbbPzBusXc85pfQ0gelb558b+jsYi2RA4qowm66sGCdLkr4PVH kzzo09zo4fVx2Tw8GPxTYM5vSkItqZnEtnd/gulmI76HWC/edza4rOkJXfihY6WSTT o8Red8eflSug8vYGTk9aQYNllgbHUNVWdGtnhZr1UY23f054FAop9QUKHDxsXyI4KW xk9eIBggvE8/A== X-Virus-Scanned: Debian amavisd-new at ministro.hu Received: from bmail1.ministro.hu ([127.0.0.1]) by localhost (bmail1.ministro.hu [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id vVpjDtr_dvYC; Sat, 1 May 2021 20:24:31 +0200 (CEST) Received: from dev (localhost [127.0.0.1]) by bmail1.ministro.hu (Postfix) with ESMTPSA id 12376123F6B; Sat, 1 May 2021 20:24:29 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=ministro.hu; s=201804; t=1619893471; bh=tHM9Y9okh6FjXB+hr+oiUWdj7GXuyOHYCxihl3yKQY4=; h=Date:From:To:Subject:From; b=vj6a0w3Mv6ZNtxer7tYN39vnOqZw4UcxugGed/g9Cvs51+w36arMpvxK5KpLigVxR KRkZyxHUKOYTykTiddS3M6U1+HtboxWmhjws9poRfChAk4TafFo56525Ly6uwJXEDL q41+AceUF7drUUOWcAhKxpMYMAWE3BtjExO474xbPC88Rhmb4NMFjOqXQgIydKR24P Tel9fQPM0GI2q7W8plONjM0HV+ZQI6CAqufJFAkJKSTdmuSTM0okHHw5ev+kbgxwH0 KwTns2a3VIUCdegb+vYQ54Uy48JJXuHyq1RnjAG71j03wHx+X8YfhH83SfjOtdLpX7 3+QoGHFmovmlA== Date: Sat, 1 May 2021 18:24:28 +0000 From: Jozsef Horvath To: Jozsef Horvath , Jonathan Cameron , Lars-Peter Clausen , Peter Meerwald-Stadler , Rob Herring , Liam Girdwood , Mark Brown , Alexandru Ardelean , Heiko Stuebner , Andy Shevchenko , Alex Dewar , Gene Chen , Saravanan Sekar , Lee Jones , linux-iio@vger.kernel.org, devicetree@vger.kernel.org, linux-kernel@vger.kernel.org Subject: [PATCH 1/2] iio: adc: driver for texas instruments ads7142 Message-ID: MIME-Version: 1.0 Content-Disposition: inline User-Agent: Mutt/1.9.4 (2018-02-28) Precedence: bulk List-ID: X-Mailing-List: linux-iio@vger.kernel.org This is an iio driver for Texas Instruments ADS7142 dual-channel, programmable sensor monitor. Operation modes supportedby the driver: When the 'ti,monitoring-mode' property is not present in the devicetree node definition, the driver initiates a single conversion in the device for each read request (/sys/bus/iio/devices/iio:deviceX/in_voltageY_raw). This is a one-shot conversion, and it is called "Manual Mode" in the datasheet. When the 'ti,monitoring-mode' property is present in the devicetree node definition, the driver configures the device's digital window comparator and sets the device's data buffer operation mode to pre alert data mode. The driver reads the conversion result when the BUSY/RDY interrupt fires, and keeps the value until the next BUSY/RDY interrupt or the first read request (/sys/bus/iio/devices/iio:deviceX/in_voltageY_raw). The digital window comparator and hysteresis parameters can be controlled by: - the devicetree definition of channel node - iio sysfs interfaces This is event driven conversion, and is called "Autonomous Mode with Pre Alert Data" in the datasheet. This mode can be used to wake up the system with the ALERT pin, in case when the monitored voltage level is out of the configured range. Datasheet: https://www.ti.com/lit/ds/symlink/ads7142.pdf Signed-off-by: Jozsef Horvath --- --- MAINTAINERS | 6 + drivers/iio/adc/Kconfig | 10 + drivers/iio/adc/Makefile | 1 + drivers/iio/adc/ti-ads7142.c | 1215 ++++++++++++++++++++++++++++++++++ 4 files changed, 1232 insertions(+) create mode 100644 drivers/iio/adc/ti-ads7142.c diff --git a/MAINTAINERS b/MAINTAINERS index 9450e052f1b1..954cbabde801 100644 --- a/MAINTAINERS +++ b/MAINTAINERS @@ -17694,6 +17694,12 @@ T: git git://github.com/czankel/xtensa-linux.git F: arch/xtensa/ F: drivers/irqchip/irq-xtensa-* +TEXAS INSTRUMENTS ADS7142 ADC DRIVER +M: Jozsef Horvath +S: Maintained +F: Documentation/devicetree/bindings/iio/adc/ti,ads7142.yaml +F: drivers/iio/adc/ti-ads7142.c + TEXAS INSTRUMENTS ASoC DRIVERS M: Peter Ujfalusi L: alsa-devel@alsa-project.org (moderated for non-subscribers) diff --git a/drivers/iio/adc/Kconfig b/drivers/iio/adc/Kconfig index e0667c4b3c08..69d672298719 100644 --- a/drivers/iio/adc/Kconfig +++ b/drivers/iio/adc/Kconfig @@ -1111,6 +1111,16 @@ config TI_ADS1015 This driver can also be built as a module. If so, the module will be called ti-ads1015. +config TI_ADS7142 + tristate "Texas Instruments ADS7142 ADC driver" + depends on I2C + help + This driver is for Texas Instruments ADS7142 Nanopower, Dual-Channel, Programmable Sensor Monitor. + Say 'Y' here if you wish to use it. + + To compile this driver as a module, choose M here: the + module will be called ti-ads7142. + config TI_ADS7950 tristate "Texas Instruments ADS7950 ADC driver" depends on SPI && GPIOLIB diff --git a/drivers/iio/adc/Makefile b/drivers/iio/adc/Makefile index 5fca90ada0ec..83d2a72ab758 100644 --- a/drivers/iio/adc/Makefile +++ b/drivers/iio/adc/Makefile @@ -99,6 +99,7 @@ obj-$(CONFIG_TI_ADC108S102) += ti-adc108s102.o obj-$(CONFIG_TI_ADC128S052) += ti-adc128s052.o obj-$(CONFIG_TI_ADC161S626) += ti-adc161s626.o obj-$(CONFIG_TI_ADS1015) += ti-ads1015.o +obj-$(CONFIG_TI_ADS7142) += ti-ads7142.o obj-$(CONFIG_TI_ADS7950) += ti-ads7950.o obj-$(CONFIG_TI_ADS8344) += ti-ads8344.o obj-$(CONFIG_TI_ADS8688) += ti-ads8688.o diff --git a/drivers/iio/adc/ti-ads7142.c b/drivers/iio/adc/ti-ads7142.c new file mode 100644 index 000000000000..6e42efe5f1e8 --- /dev/null +++ b/drivers/iio/adc/ti-ads7142.c @@ -0,0 +1,1215 @@ +// SPDX-License-Identifier: GPL-2.0 +/* + * Copyright (C) 2020 Jozsef Horvath + * + */ +#include +#include +#include +#include +#include +#include +#include +#include +#include + +#define TI_ADS7142_NAME "ads7142" + +#define TI_ADS7142_DATA_VALID_TIMEOUT 100 + +/* Opcodes for commands */ +/* General */ +#define TI_ADS7142_OC_GENERAL 0x00 +/* Single Register Read */ +#define TI_ADS7142_OC_SINGLE_REG_READ 0x10 +/* Single Register Write */ +#define TI_ADS7142_OC_SINGLE_REG_WRITE 0x08 +/* Single Bit Set */ +#define TI_ADS7142_OC_SET_BIT 0x18 +/* Single Bit Clear */ +#define TI_ADS7142_OC_CLEAR_BIT 0x20 +/* Block Register Read */ +#define TI_ADS7142_OC_BLOCK_READ 0x30 +/* Block Register Write */ +#define TI_ADS7142_OC_BLOCK_WRITE 0x28 + +/* Registers */ +/* Reset registers */ +#define TI_ADS7142_WKEY 0x17 +#define TI_ADS7142_DEVICE_RESET 0x14 +/* Functional mode select registers */ +#define TI_ADS7142_OFFSET_CAL 0x15 +#define TI_ADS7142_OPMODE_SEL 0x1C +#define TI_ADS7142_OPMODE_SEL_MANUALCH0 (0) +#define TI_ADS7142_OPMODE_SEL_MANUALSEQ (4) +#define TI_ADS7142_OPMODE_SEL_MONITORING (6) +#define TI_ADS7142_OPMODE_SEL_HIGHPREC (7) +#define TI_ADS7142_OPMODE_STATUS 0x00 +#define TI_ADS7142_OPMODE_STATUS_OPMODE_MSK (3) +#define TI_ADS7142_OPMODE_STATUS_OPMODE_MANUAL (0) +#define TI_ADS7142_OPMODE_STATUS_OPMODE_AUTO (2) +#define TI_ADS7142_OPMODE_STATUS_OPMODE_HIGHPREC (3) +#define TI_ADS7142_OPMODE_STATUS_HS_MODE BIT(2) + +/* Input config register */ +#define TI_ADS7142_CH_INPUT_CFG 0x24 +#define TI_ADS7142_CH_INPUT_CFG_TCSE (0) +#define TI_ADS7142_CH_INPUT_CFG_SCSE (1) +#define TI_ADS7142_CH_INPUT_CFG_SCPD (2) +/* Analog mux and sequencer registers */ +#define TI_ADS7142_AUTO_SEQ_CHEN 0x20 +#define TI_ADS7142_AUTO_SEQ_CHEN_CH0 BIT(0) +#define TI_ADS7142_AUTO_SEQ_CHEN_CH1 BIT(1) +#define TI_ADS7142_START_SEQUENCE 0x1E +#define TI_ADS7142_START_SEQUENCE_SEQ_START BIT(0) +#define TI_ADS7142_ABORT_SEQUENCE 0x1F +#define TI_ADS7142_ABORT_SEQUENCE_SEQ_ABORT BIT(0) +#define TI_ADS7142_SEQUENCE_STATUS 0x04 +#define TI_ADS7142_SEQUENCE_STATUS_SEQ_ERR_ST_MSK (0x06) +#define TI_ADS7142_SEQUENCE_STATUS_SEQ_DISABLED (0x00) +#define TI_ADS7142_SEQUENCE_STATUS_SEQ_ENABLED (0x02) +#define TI_ADS7142_SEQUENCE_STATUS_SEQ_ERROR (0x06) +/* Oscillator and timing control registers */ +#define TI_ADS7142_OSC_SEL 0x18 +#define TI_ADS7142_OSC_SEL_HSZ_LP BIT(0) +#define TI_ADS7142_NCLK_SEL 0x19 +/* Data buffer control register */ +#define TI_ADS7142_DATA_BUFFER_OPMODE 0x2C +#define TI_ADS7142_DATA_BUFFER_OPMODE_STOP_BURST (0) +#define TI_ADS7142_DATA_BUFFER_OPMODE_START_BURST (1) +#define TI_ADS7142_DATA_BUFFER_OPMODE_PRE_ALERT (4) +#define TI_ADS7142_DATA_BUFFER_OPMODE_POST_ALERT (6) +#define TI_ADS7142_DOUT_FORMAT_CFG 0x28 +#define TI_ADS7142_DOUT_FORMAT_CFG_12B (0) +#define TI_ADS7142_DOUT_FORMAT_CFG_12BCH (1) +#define TI_ADS7142_DOUT_FORMAT_CFG_12BCHDV (2) +#define TI_ADS7142_DATA_BUFFER_STATUS 0x01 +/* Accumulator control register */ +#define TI_ADS7142_ACC_EN 0x30 +#define TI_ADS7142_ACC_CH0_LSB 0x08 +#define TI_ADS7142_ACC_CH0_MSB 0x09 +#define TI_ADS7142_ACC_CH1_LSB 0x0A +#define TI_ADS7142_ACC_CH1_MSB 0x0B +#define TI_ADS7142_ACC_STATUS 0x02 +/* Digital window comparator registers */ +#define TI_ADS7142_ALERT_DWC_EN 0x37 +#define TI_ADS7142_ALERT_DWC_EN_BLOCK_EN BIT(0) +#define TI_ADS7142_ALERT_CHEN 0x34 +#define TI_ADS7142_DWC_HTH_CH0_LSB 0x38 +#define TI_ADS7142_DWC_HTH_CH0_MSB 0x39 +#define TI_ADS7142_DWC_LTH_CH0_LSB 0x3A +#define TI_ADS7142_DWC_LTH_CH0_MSB 0x3B +#define TI_ADS7142_DWC_HYS_CH0 0x40 +#define TI_ADS7142_DWC_HTH_CH1_LSB 0x3C +#define TI_ADS7142_DWC_HTH_CH1_MSB 0x3D +#define TI_ADS7142_DWC_LTH_CH1_LSB 0x3E +#define TI_ADS7142_DWC_LTH_CH1_MSB 0x3F +#define TI_ADS7142_DWC_HYS_CH1 0x41 +#define TI_ADS7142_PRE_ALT_EVT_CNT 0x36 +#define TI_ADS7142_ALT_TRIG_CHID 0x03 +#define TI_ADS7142_ALT_LOW_FLAGS 0x0C +#define TI_ADS7142_ALT_LOW_FLAGS_CH0 BIT(0) +#define TI_ADS7142_ALT_LOW_FLAGS_CH1 BIT(1) +#define TI_ADS7142_ALT_HIGH_FLAGS 0x0E +#define TI_ADS7142_ALT_HIGH_FLAGS_CH0 BIT(0) +#define TI_ADS7142_ALT_HIGH_FLAGS_CH1 BIT(1) + +#define TI_ADS7142_THRESHOLD_MSK 0xFFF +#define TI_ADS7142_HYSTERESIS_MSK 0x3F + +struct ti_ads7142_channel_data { + int status; + int value; +}; + +struct ti_ads7142_channel_config { + bool alert_low; + bool alert_high; + int high_threshold; + int low_threshold; + int hysteresis; +}; + +struct ti_ads7142_channel { + struct ti_ads7142_channel_config config; + struct ti_ads7142_channel_data data; + u32 channel; +}; + +struct ti_ads7142_config { + bool osc_sel; + u32 n_clk; + bool monitoring_mode; +}; + +struct ti_ads7142_priv { + struct mutex lock; /* For syncing access to device */ + struct regulator *vref; + struct regulator *power; + struct ti_ads7142_config config; + int channel_count; + struct ti_ads7142_channel *channels; + bool monitor_pending; +}; + +static const struct iio_event_spec ti_ads7142_events[] = { + { + .type = IIO_EV_TYPE_THRESH, + .dir = IIO_EV_DIR_RISING, + .mask_separate = BIT(IIO_EV_INFO_VALUE) + | BIT(IIO_EV_INFO_ENABLE), + }, { + .type = IIO_EV_TYPE_THRESH, + .dir = IIO_EV_DIR_FALLING, + .mask_separate = BIT(IIO_EV_INFO_VALUE) + | BIT(IIO_EV_INFO_ENABLE), + }, { + .type = IIO_EV_TYPE_THRESH, + .dir = IIO_EV_DIR_EITHER, + .mask_separate = BIT(IIO_EV_INFO_HYSTERESIS), + }, +}; + +static int ti_ads7142_reg_write(const struct i2c_client *client, u8 reg, + u8 data) +{ + struct i2c_msg msg; + u8 buf[3]; + int ret; + + buf[0] = TI_ADS7142_OC_SINGLE_REG_WRITE; + buf[1] = reg; + buf[2] = data; + + msg.addr = client->addr; + msg.flags = 0; + msg.len = 3; + msg.buf = buf; + + ret = i2c_transfer(client->adapter, &msg, 1); + + return ret >= 0 ? 0 : ret; +} + +static int ti_ads7142_reg_read(const struct i2c_client *client, u8 reg, + u8 *data) +{ + struct i2c_msg msg[2]; + u8 buf[2]; + int ret; + + buf[0] = TI_ADS7142_OC_SINGLE_REG_READ; + buf[1] = reg; + + msg[0].addr = client->addr; + msg[0].flags = 0; + msg[0].len = 2; + msg[0].buf = buf; + + msg[1].addr = client->addr; + msg[1].flags = I2C_M_RD; + msg[1].len = 1; + msg[1].buf = data; + + ret = i2c_transfer(client->adapter, msg, 2); + + return ret >= 0 ? 0 : ret; +} + +static int ti_ads7142_data_buffer_read(const struct i2c_client *client, + int length, void *data) +{ + struct i2c_msg msg; + int ret; + + msg.addr = client->addr; + msg.flags = I2C_M_RD; + msg.len = length; + msg.buf = data; + + ret = i2c_transfer(client->adapter, &msg, 1); + + return ret >= 0 ? 0 : ret; +} + +static int ti_ads7142_soft_reset(const struct i2c_client *client) +{ + struct i2c_msg msg; + u8 buf[2]; + int ret; + + buf[0] = TI_ADS7142_OC_GENERAL; + buf[1] = 0x06; + + msg.addr = client->addr; + msg.flags = 0; + msg.len = 2; + msg.buf = buf; + + ret = i2c_transfer(client->adapter, &msg, 1); + + return ret >= 0 ? 0 : ret; +} + +static int ti_ads7142_address2channel(struct iio_dev *indio_dev, + int address, + struct ti_ads7142_channel **channel) +{ + struct ti_ads7142_priv *priv = iio_priv(indio_dev); + int i; + + for (i = 0; i < priv->channel_count; i++) { + if (address == priv->channels[i].channel) { + *channel = &priv->channels[i]; + return 0; + } + } + return -ENODEV; +} + +static int ti_ads7142_sequence_start(struct iio_dev *indio_dev) +{ + struct i2c_client *client = to_i2c_client(indio_dev->dev.parent); + + return ti_ads7142_reg_write(client, TI_ADS7142_START_SEQUENCE, + TI_ADS7142_START_SEQUENCE_SEQ_START); +} + +static int ti_ads7142_sequence_abort(struct iio_dev *indio_dev) +{ + struct i2c_client *client = to_i2c_client(indio_dev->dev.parent); + + return ti_ads7142_reg_write(client, TI_ADS7142_ABORT_SEQUENCE, + TI_ADS7142_ABORT_SEQUENCE_SEQ_ABORT); +} + +static int ti_ads7142_osc_set(struct iio_dev *indio_dev) +{ + struct ti_ads7142_priv *priv = iio_priv(indio_dev); + struct i2c_client *client = to_i2c_client(indio_dev->dev.parent); + int ret; + + ret = ti_ads7142_reg_write(client, TI_ADS7142_OSC_SEL, + priv->config.osc_sel ? TI_ADS7142_OSC_SEL_HSZ_LP : 0); + if (ret) + return ret; + + return ti_ads7142_reg_write(client, TI_ADS7142_NCLK_SEL, + priv->config.n_clk); +} + +static int ti_ads7142_input_cfg_set(struct iio_dev *indio_dev) +{ + struct i2c_client *client = to_i2c_client(indio_dev->dev.parent); + + return ti_ads7142_reg_write(client, TI_ADS7142_CH_INPUT_CFG, + TI_ADS7142_CH_INPUT_CFG_TCSE); +} + +static int ti_ads7142_dout_format_set(struct iio_dev *indio_dev) +{ + struct i2c_client *client = to_i2c_client(indio_dev->dev.parent); + + return ti_ads7142_reg_write(client, TI_ADS7142_DOUT_FORMAT_CFG, + TI_ADS7142_DOUT_FORMAT_CFG_12BCHDV); +} + +static int ti_ads7142_hth_set(struct iio_dev *indio_dev, int channel, + int threshold) +{ + struct i2c_client *client = to_i2c_client(indio_dev->dev.parent); + int ret; + + if (threshold < 0 || threshold > TI_ADS7142_THRESHOLD_MSK) + return -EINVAL; + + ret = ti_ads7142_reg_write(client, + TI_ADS7142_DWC_HTH_CH0_LSB + channel * 4, + threshold & 0xFF); + if (ret) + return ret; + + ret = ti_ads7142_reg_write(client, + TI_ADS7142_DWC_HTH_CH0_MSB + channel * 4, + (threshold >> 8) & 0xF); + return ret; +} + +static int ti_ads7142_lth_set(struct iio_dev *indio_dev, int channel, + int threshold) +{ + struct i2c_client *client = to_i2c_client(indio_dev->dev.parent); + int ret; + + if (threshold < 0 || threshold > TI_ADS7142_THRESHOLD_MSK) + return -EINVAL; + + ret = ti_ads7142_reg_write(client, + TI_ADS7142_DWC_LTH_CH0_LSB + channel * 4, + threshold & 0xFF); + if (ret) + return ret; + + ret = ti_ads7142_reg_write(client, + TI_ADS7142_DWC_LTH_CH0_MSB + channel * 4, + (threshold >> 8) & 0xF); + return ret; +} + +static int ti_ads7142_hys_set(struct iio_dev *indio_dev, int channel, + int hysteresis) +{ + struct i2c_client *client = to_i2c_client(indio_dev->dev.parent); + int ret; + + if (hysteresis < 0 || hysteresis > TI_ADS7142_HYSTERESIS_MSK) + return -EINVAL; + + ret = ti_ads7142_reg_write(client, TI_ADS7142_DWC_HYS_CH0 + channel, + hysteresis & TI_ADS7142_HYSTERESIS_MSK); + return ret; +} + +static int ti_ads7142_collect_channel_data(struct iio_dev *indio_dev, + int *channel_collected) +{ + struct i2c_client *client = to_i2c_client(indio_dev->dev.parent); + struct ti_ads7142_channel *channel; + u16 data_buffer; + u8 data_buffer_status; + int data_valid; + int channel_address; + int value; + int ret; + + ret = ti_ads7142_reg_read(client, TI_ADS7142_DATA_BUFFER_STATUS, + &data_buffer_status); + if (ret) + return ret; + + data_buffer_status &= 0x1F; + + do { + ret = ti_ads7142_data_buffer_read(client, sizeof(data_buffer), + &data_buffer); + if (ret) + break; + data_buffer = be16_to_cpu(data_buffer); + data_valid = data_buffer & 1; + if (data_valid) { + channel_address = (data_buffer >> 1) & 0x7; + value = data_buffer >> 4; + ret = ti_ads7142_address2channel(indio_dev, + channel_address, + &channel); + if (!ret) { + channel->data.status = data_valid; + channel->data.value = value; + *channel_collected |= 1 << channel_address; + } + } + } while (--data_buffer_status); + + return ret; +} + +static int ti_ads7142_do_work(struct iio_dev *indio_dev) +{ + struct ti_ads7142_priv *priv = iio_priv(indio_dev); + struct i2c_client *client = to_i2c_client(indio_dev->dev.parent); + int i; + int alert_ch = 0; + int ret; + + if (!priv->config.monitoring_mode) + return 0; + + mutex_lock(&priv->lock); + priv->monitor_pending = false; + + ret = ti_ads7142_sequence_abort(indio_dev); + if (ret) + goto final; + + ret = ti_ads7142_osc_set(indio_dev); + if (ret) + goto final; + + ret = ti_ads7142_input_cfg_set(indio_dev); + if (ret) + goto final; + + ret = ti_ads7142_dout_format_set(indio_dev); + if (ret) + goto final; + + ret = ti_ads7142_reg_write(client, TI_ADS7142_DATA_BUFFER_OPMODE, + TI_ADS7142_DATA_BUFFER_OPMODE_PRE_ALERT); + if (ret) + goto final; + + ret = ti_ads7142_reg_write(client, TI_ADS7142_OPMODE_SEL, + TI_ADS7142_OPMODE_SEL_MONITORING); + if (ret) + goto final; + + ret = ti_ads7142_reg_write(client, TI_ADS7142_AUTO_SEQ_CHEN, + TI_ADS7142_AUTO_SEQ_CHEN_CH0 + | TI_ADS7142_AUTO_SEQ_CHEN_CH1); + if (ret) + goto final; + + ret = ti_ads7142_reg_write(client, TI_ADS7142_PRE_ALT_EVT_CNT, 0); + if (ret) + goto final; + + ret = ti_ads7142_reg_write(client, TI_ADS7142_ALT_LOW_FLAGS, + TI_ADS7142_ALT_LOW_FLAGS_CH0 + | TI_ADS7142_ALT_LOW_FLAGS_CH1); + if (ret) + goto final; + + ret = ti_ads7142_reg_write(client, TI_ADS7142_ALT_HIGH_FLAGS, + TI_ADS7142_ALT_HIGH_FLAGS_CH0 + | TI_ADS7142_ALT_HIGH_FLAGS_CH1); + if (ret) + goto final; + + for (i = 0; i < priv->channel_count; i++) { + ret = ti_ads7142_hth_set(indio_dev, priv->channels[i].channel, + priv->channels[i].config.high_threshold); + if (ret) + goto final; + + ret = ti_ads7142_lth_set(indio_dev, priv->channels[i].channel, + priv->channels[i].config.low_threshold); + if (ret) + goto final; + + ret = ti_ads7142_hys_set(indio_dev, priv->channels[i].channel, + priv->channels[i].config.hysteresis); + if (ret) + goto final; + + if (priv->channels[i].config.alert_low || + priv->channels[i].config.alert_high) { + alert_ch |= 1 << priv->channels[i].channel; + } + } + + ret = ti_ads7142_reg_write(client, TI_ADS7142_ALERT_DWC_EN, + alert_ch ? TI_ADS7142_ALERT_DWC_EN_BLOCK_EN : 0); + if (ret) + goto final; + + ret = ti_ads7142_reg_write(client, TI_ADS7142_ALERT_CHEN, + alert_ch); + if (ret) + goto final; + + if (alert_ch) { + ret = ti_ads7142_sequence_start(indio_dev); + priv->monitor_pending = !ret; + } +final: + mutex_unlock(&priv->lock); + return ret; +} + +static int ti_ads7142_read_channel_manual(struct iio_dev *indio_dev, + int address, int *val) +{ + struct ti_ads7142_priv *priv = iio_priv(indio_dev); + struct i2c_client *client = to_i2c_client(indio_dev->dev.parent); + u16 data_buffer; + int ret; + + if (address < 0 || address > 1) + return -EINVAL; + + mutex_lock(&priv->lock); + ret = ti_ads7142_sequence_abort(indio_dev); + if (ret) + goto final; + + ret = ti_ads7142_osc_set(indio_dev); + if (ret) + goto final; + + ret = ti_ads7142_input_cfg_set(indio_dev); + if (ret) + goto final; + + ret = ti_ads7142_dout_format_set(indio_dev); + if (ret) + goto final; + + ret = ti_ads7142_reg_write(client, TI_ADS7142_OPMODE_SEL, + TI_ADS7142_OPMODE_SEL_MANUALSEQ); + if (ret) + goto final; + + ret = ti_ads7142_reg_write(client, TI_ADS7142_AUTO_SEQ_CHEN, + 1 << address); + if (ret) + goto final; + + ret = ti_ads7142_sequence_start(indio_dev); + if (ret) + goto final; + + ret = ti_ads7142_data_buffer_read(client, sizeof(data_buffer), + &data_buffer); + if (ret) + goto abort; + + *val = (be16_to_cpu(data_buffer) >> 4); + +abort: + ret = ti_ads7142_sequence_abort(indio_dev); +final: + mutex_unlock(&priv->lock); + return ret; +} + +static int ti_ads7142_read_channel_monitor(struct iio_dev *indio_dev, + int address, int *val) +{ + struct ti_ads7142_priv *priv = iio_priv(indio_dev); + struct ti_ads7142_channel *channel; + int ret; + + if (address < 0 || address > 1) + return -EINVAL; + + ret = ti_ads7142_address2channel(indio_dev, address, &channel); + if (ret) + return ret; + + mutex_lock(&priv->lock); + if (!channel->data.status) { + ret = -EAGAIN; + } else { + *val = channel->data.value; + channel->data.status = 0; + ret = 0; + } + mutex_unlock(&priv->lock); + return ret; +} + +static int ti_ads7142_read_channel(struct iio_dev *indio_dev, + int address, int *val) +{ + struct ti_ads7142_priv *priv = iio_priv(indio_dev); + + if (priv->config.monitoring_mode) + return ti_ads7142_read_channel_monitor(indio_dev, address, + val); + return ti_ads7142_read_channel_manual(indio_dev, address, val); +} + +static irqreturn_t ti_ads7142_ist(int irq, void *dev_id) +{ + struct iio_dev *indio_dev = dev_id; + struct i2c_client *client = to_i2c_client(indio_dev->dev.parent); + struct ti_ads7142_priv *priv = iio_priv(indio_dev); + struct ti_ads7142_channel *channel; + u8 low_flags; + u8 high_flags; + u8 seq_st; + int i; + int ret; + int channel_collected; + s64 timestamp = iio_get_time_ns(indio_dev); + + mutex_lock(&priv->lock); + if (!priv->config.monitoring_mode || !priv->monitor_pending) { + mutex_unlock(&priv->lock); + return IRQ_NONE; + } + + ret = ti_ads7142_reg_read(client, TI_ADS7142_SEQUENCE_STATUS, &seq_st); + if (ret) { + dev_err(indio_dev->dev.parent, + "%s: SEQUENCE_STATUS reg read error(%i)", + __func__, ret); + goto final; + } + + if ((seq_st & TI_ADS7142_SEQUENCE_STATUS_SEQ_ERR_ST_MSK) + != TI_ADS7142_SEQUENCE_STATUS_SEQ_ENABLED) { + dev_err(indio_dev->dev.parent, + "%s: SEQUENCE_STATUS error(%i)", + __func__, seq_st); + goto final; + } + + ret = ti_ads7142_reg_read(client, TI_ADS7142_ALT_LOW_FLAGS, + &low_flags); + if (ret) { + dev_err(indio_dev->dev.parent, + "%s: ALT_LOW_FLAGS reg read error(%i)", + __func__, ret); + goto final; + } + + ret = ti_ads7142_reg_read(client, TI_ADS7142_ALT_HIGH_FLAGS, + &high_flags); + if (ret) { + dev_err(indio_dev->dev.parent, + "%s: ALT_HIGH_FLAGS reg read error(%i)", + __func__, ret); + goto final; + } + + channel_collected = 0; + ret = ti_ads7142_collect_channel_data(indio_dev, &channel_collected); + if (ret) + goto final; + + if (!channel_collected) + goto final; + + for (i = 0; i < priv->channel_count; i++) { + channel = &priv->channels[i]; + if (!(channel_collected & (1 << channel->channel))) + continue; + if (channel->config.alert_low && + (low_flags & (1 << channel->channel))) { + iio_push_event(indio_dev, + IIO_UNMOD_EVENT_CODE(IIO_VOLTAGE, + channel->channel, + IIO_EV_TYPE_THRESH, + IIO_EV_DIR_FALLING), + timestamp); + } + + if (channel->config.alert_high && + (high_flags & (1 << channel->channel))) { + iio_push_event(indio_dev, + IIO_UNMOD_EVENT_CODE(IIO_VOLTAGE, + channel->channel, + IIO_EV_TYPE_THRESH, + IIO_EV_DIR_RISING), + timestamp); + } + } + +final: + mutex_unlock(&priv->lock); + + ret = ti_ads7142_do_work(indio_dev); + if (ret) { + dev_err(indio_dev->dev.parent, + "%s: start monitoring error(%i)", + __func__, ret); + return IRQ_NONE; + } + return IRQ_HANDLED; +} + +static int ti_ads7142_read_raw(struct iio_dev *indio_dev, + struct iio_chan_spec const *chan, + int *val, int *val2, long info) +{ + struct ti_ads7142_priv *priv = iio_priv(indio_dev); + int ret; + + switch (info) { + case IIO_CHAN_INFO_RAW: + ret = ti_ads7142_read_channel(indio_dev, chan->address, val); + if (!ret) + ret = IIO_VAL_INT; + break; + case IIO_CHAN_INFO_SAMP_FREQ: + *val = priv->config.n_clk; + ret = IIO_VAL_INT; + break; + case IIO_CHAN_INFO_SCALE: + if (IS_ERR(priv->vref)) { + ret = -EINVAL; + } else { + *val = regulator_get_voltage(priv->vref) / 1000; + *val2 = chan->scan_type.realbits; + ret = IIO_VAL_FRACTIONAL_LOG2; + } + break; + default: + ret = -EINVAL; + } + return ret; +} + +static int ti_ads7142_write_raw(struct iio_dev *indio_dev, + struct iio_chan_spec const *chan, + int val, int val2, long mask) +{ + struct ti_ads7142_priv *priv = iio_priv(indio_dev); + int ret; + + switch (mask) { + case IIO_CHAN_INFO_SAMP_FREQ: + priv->config.n_clk = val; + if (priv->config.monitoring_mode) + ret = ti_ads7142_do_work(indio_dev); + else + ret = 0; + break; + default: + ret = -EINVAL; + break; + } + + return ret; +} + +static int ti_ads7142_read_event_value(struct iio_dev *indio_dev, + const struct iio_chan_spec *chan, + enum iio_event_type type, + enum iio_event_direction dir, + enum iio_event_info info, + int *val, int *val2) +{ + struct ti_ads7142_priv *priv = iio_priv(indio_dev); + struct ti_ads7142_channel *channel; + int ret; + + if (!priv->config.monitoring_mode) + return -EINVAL; + + ret = ti_ads7142_address2channel(indio_dev, chan->address, + &channel); + if (ret) + return ret; + + switch (info) { + case IIO_EV_INFO_VALUE: + if (dir == IIO_EV_DIR_RISING) + *val = channel->config.high_threshold; + else + *val = channel->config.low_threshold; + ret = IIO_VAL_INT; + break; + case IIO_EV_INFO_HYSTERESIS: + *val = channel->config.hysteresis; + ret = IIO_VAL_INT; + break; + default: + ret = -EINVAL; + break; + } + return ret; +} + +static int ti_ads7142_write_event_value(struct iio_dev *indio_dev, + const struct iio_chan_spec *chan, + enum iio_event_type type, + enum iio_event_direction dir, + enum iio_event_info info, + int val, int val2) +{ + struct ti_ads7142_priv *priv = iio_priv(indio_dev); + struct ti_ads7142_channel *channel; + bool have_to_do = false; + int ret; + + if (!priv->config.monitoring_mode) + return -EINVAL; + + ret = ti_ads7142_address2channel(indio_dev, chan->address, + &channel); + if (ret) + return ret; + + mutex_lock(&priv->lock); + switch (info) { + case IIO_EV_INFO_VALUE: + if (val < 0 || val > TI_ADS7142_THRESHOLD_MSK) { + ret = -EINVAL; + } else { + if (dir == IIO_EV_DIR_RISING) { + if (val != channel->config.high_threshold) { + channel->config.high_threshold = val; + have_to_do = true; + } + } else { + if (val != channel->config.low_threshold) { + channel->config.low_threshold = val; + have_to_do = true; + } + } + } + break; + case IIO_EV_INFO_HYSTERESIS: + if (val < 0 || val > TI_ADS7142_HYSTERESIS_MSK) { + ret = -EINVAL; + } else { + if (val != channel->config.hysteresis) { + channel->config.hysteresis = val; + have_to_do = true; + } + } + break; + default: + ret = -EINVAL; + break; + } + mutex_unlock(&priv->lock); + if (!ret && have_to_do) + ret = ti_ads7142_do_work(indio_dev); + return ret; +} + +static int ti_ads7142_read_event_config(struct iio_dev *indio_dev, + const struct iio_chan_spec *chan, + enum iio_event_type type, + enum iio_event_direction dir) +{ + struct ti_ads7142_priv *priv = iio_priv(indio_dev); + struct ti_ads7142_channel *channel; + int ret; + + if (!priv->config.monitoring_mode) + return -EINVAL; + + if (type != IIO_EV_TYPE_THRESH) + return -EINVAL; + + ret = ti_ads7142_address2channel(indio_dev, chan->address, + &channel); + if (ret) + return ret; + + if (dir == IIO_EV_DIR_RISING) + ret = channel->config.alert_high ? 1 : 0; + else + ret = channel->config.alert_low ? 1 : 0; + + return ret; +} + +static int ti_ads7142_write_event_config(struct iio_dev *indio_dev, + const struct iio_chan_spec *chan, + enum iio_event_type type, + enum iio_event_direction dir, + int state) +{ + struct ti_ads7142_priv *priv = iio_priv(indio_dev); + struct ti_ads7142_channel *channel; + bool have_to_do = false; + int ret; + + if (!priv->config.monitoring_mode) + return -EINVAL; + + if (type != IIO_EV_TYPE_THRESH) + return -EINVAL; + + ret = ti_ads7142_address2channel(indio_dev, chan->address, + &channel); + if (ret) + return ret; + + mutex_lock(&priv->lock); + if (dir == IIO_EV_DIR_RISING) { + if (channel->config.alert_high != state) { + channel->config.alert_high = state; + have_to_do = true; + } + } else { + if (channel->config.alert_low != state) { + channel->config.alert_low = state; + have_to_do = true; + } + } + mutex_unlock(&priv->lock); + + if (have_to_do) + ret = ti_ads7142_do_work(indio_dev); + + return ret; +} + +static const struct iio_info ti_ads7142_iio_info = { + .read_raw = ti_ads7142_read_raw, + .write_raw = ti_ads7142_write_raw, + .read_event_value = ti_ads7142_read_event_value, + .write_event_value = ti_ads7142_write_event_value, + .read_event_config = ti_ads7142_read_event_config, + .write_event_config = ti_ads7142_write_event_config, +}; + +static int ti_ads7142_parse_channel_config_of(struct device *dev, + struct iio_dev *indio_dev) +{ + struct ti_ads7142_priv *priv = iio_priv(indio_dev); + struct device_node *channel_node; + struct iio_chan_spec *iio_channels; + struct iio_chan_spec *iio_channel; + struct ti_ads7142_channel *ads_channel; + int channel_index = 0; + int ret; + + priv->channel_count = of_get_available_child_count(dev->of_node); + if (!priv->channel_count) { + dev_err(dev, "dt: there is no channel definition"); + return -ENODEV; + } + + priv->channels = devm_kcalloc(dev, priv->channel_count, + sizeof(*priv->channels), + GFP_KERNEL); + if (!priv->channels) + return -ENOMEM; + + indio_dev->num_channels = priv->channel_count; + iio_channels = devm_kcalloc(dev, priv->channel_count, + sizeof(*iio_channels), + GFP_KERNEL); + if (!iio_channels) + return -ENOMEM; + + indio_dev->channels = iio_channels; + + for_each_available_child_of_node(dev->of_node, channel_node) { + ads_channel = &priv->channels[channel_index]; + + ret = of_property_read_u32(channel_node, "reg", + &ads_channel->channel); + if (ret) + goto err; + + iio_channel = &iio_channels[channel_index]; + iio_channel->type = IIO_VOLTAGE; + iio_channel->indexed = 1; + iio_channel->info_mask_separate = BIT(IIO_CHAN_INFO_RAW) + | BIT(IIO_CHAN_INFO_SAMP_FREQ); + if (!IS_ERR(priv->vref)) + iio_channel->info_mask_separate |= BIT(IIO_CHAN_INFO_SCALE); + iio_channel->scan_type.sign = 'u'; + iio_channel->scan_type.realbits = 12; + iio_channel->scan_type.storagebits = 16; + iio_channel->scan_type.shift = 0; + iio_channel->scan_type.endianness = IIO_CPU; + iio_channel->address = ads_channel->channel; + iio_channel->scan_index = ads_channel->channel; + iio_channel->channel = ads_channel->channel; + if (priv->config.monitoring_mode) { + iio_channel->event_spec = ti_ads7142_events; + iio_channel->num_event_specs = ARRAY_SIZE(ti_ads7142_events); + } + + ads_channel->config.high_threshold = TI_ADS7142_THRESHOLD_MSK; + ret = of_property_read_u32(channel_node, "ti,threshold-rising", + &ads_channel->config.high_threshold); + ads_channel->config.alert_high = !ret; + ret = of_property_read_u32(channel_node, "ti,threshold-falling", + &ads_channel->config.low_threshold); + ads_channel->config.alert_low = !ret; + ret = of_property_read_u32(channel_node, "ti,hysteresis", + &ads_channel->config.hysteresis); + channel_index++; + } + + return 0; +err: + of_node_put(channel_node); + return ret; +} + +static int ti_ads7142_parse_config_of(struct device *dev, + struct iio_dev *indio_dev) +{ + struct ti_ads7142_priv *priv = iio_priv(indio_dev); + + priv->config.osc_sel = of_property_read_bool(dev->of_node, + "ti,osc-sel"); + of_property_read_u32(dev->of_node, "ti,n-clk", &priv->config.n_clk); + priv->config.monitoring_mode = of_property_read_bool(dev->of_node, + "ti,monitoring-mode"); + + return ti_ads7142_parse_channel_config_of(dev, indio_dev); +} + +static int ti_ads7142_probe(struct i2c_client *client, + const struct i2c_device_id *id) +{ + struct iio_dev *indio_dev; + struct ti_ads7142_priv *priv; + int ret; + + ret = ti_ads7142_soft_reset(client); + if (ret) + return ret; + + indio_dev = devm_iio_device_alloc(&client->dev, sizeof(*priv)); + if (!indio_dev) + return -ENOMEM; + + priv = iio_priv(indio_dev); + i2c_set_clientdata(client, indio_dev); + + indio_dev->dev.parent = &client->dev; + indio_dev->dev.of_node = client->dev.of_node; + indio_dev->name = TI_ADS7142_NAME; + indio_dev->modes = INDIO_DIRECT_MODE; + indio_dev->info = &ti_ads7142_iio_info; + + mutex_init(&priv->lock); + + priv->vref = devm_regulator_get_optional(&client->dev, "vref"); + if (!IS_ERR(priv->vref)) { + ret = regulator_enable(priv->vref); + if (ret) + goto err; + } + + priv->power = devm_regulator_get_optional(&client->dev, "power"); + if (!IS_ERR(priv->power)) { + ret = regulator_enable(priv->power); + if (ret) + goto err_regulator; + } + + ret = ti_ads7142_parse_config_of(&client->dev, indio_dev); + if (ret) + goto err_regulator; + + if (!client->irq && priv->config.monitoring_mode) { + ret = -EINVAL; + dev_err(&client->dev, "Interrupt not specified\n"); + goto err_regulator; + } + if (client->irq && priv->config.monitoring_mode) { + ret = devm_request_threaded_irq(&client->dev, client->irq, + NULL, ti_ads7142_ist, + IRQF_ONESHOT | IRQF_SHARED, + dev_name(&client->dev), + indio_dev); + if (ret) { + dev_err(&client->dev, "Unable to request IRQ %i", + client->irq); + goto err_regulator; + } + } + + ret = iio_device_register(indio_dev); + if (ret) { + dev_err(&client->dev, "Failed to register iio device"); + goto err_regulator; + } + + ret = ti_ads7142_do_work(indio_dev); + if (!ret) { + dev_info(&client->dev, "%s is a %s device at address 0x%X", + dev_name(&indio_dev->dev), indio_dev->name, + client->addr); + return ret; + } + + iio_device_unregister(indio_dev); + +err_regulator: + if (!IS_ERR(priv->vref)) + regulator_disable(priv->vref); + if (!IS_ERR(priv->power)) + regulator_disable(priv->power); +err: + mutex_destroy(&priv->lock); + + return ret; +} + +static int ti_ads7142_remove(struct i2c_client *client) +{ + struct iio_dev *indio_dev = i2c_get_clientdata(client); + struct ti_ads7142_priv *priv = iio_priv(indio_dev); + + if (!IS_ERR(priv->vref)) + regulator_disable(priv->vref); + if (!IS_ERR(priv->power)) + regulator_disable(priv->power); + mutex_destroy(&priv->lock); + iio_device_unregister(indio_dev); + + return 0; +} + +static int __maybe_unused ti_ads7142_suspend(struct device *dev) +{ + struct iio_dev *indio_dev = i2c_get_clientdata(to_i2c_client(dev)); + struct ti_ads7142_priv *priv = iio_priv(indio_dev); + + /** + * Keep all regulators on when the device in autonomous + * monitoring mode. + * The device can wake up the system with ALERT pin + **/ + if (priv->config.monitoring_mode && priv->monitor_pending) + return 0; + + if (!IS_ERR(priv->vref)) + regulator_disable(priv->vref); + if (!IS_ERR(priv->power)) + regulator_disable(priv->power); + + return 0; +} + +static int __maybe_unused ti_ads7142_resume(struct device *dev) +{ + struct iio_dev *indio_dev = i2c_get_clientdata(to_i2c_client(dev)); + struct ti_ads7142_priv *priv = iio_priv(indio_dev); + int ret; + + /** + * Nothing to do when the device in autonomous monitoring mode. + **/ + if (priv->config.monitoring_mode && priv->monitor_pending) + return 0; + + if (!IS_ERR(priv->vref)) { + ret = regulator_enable(priv->vref); + if (ret) + return ret; + } + if (!IS_ERR(priv->power)) { + ret = regulator_enable(priv->power); + if (ret) + return ret; + } + return 0; +} + +static SIMPLE_DEV_PM_OPS(ti_ads7142_pm_ops, ti_ads7142_suspend, + ti_ads7142_resume); + +static const struct i2c_device_id ti_ads7142_id[] = { + { TI_ADS7142_NAME, 0 }, + { } +}; +MODULE_DEVICE_TABLE(i2c, ti_ads7142_id); + +static const struct of_device_id ti_ads7142_of_match[] = { + { .compatible = "ti,ads7142" }, + {} +}; +MODULE_DEVICE_TABLE(of, ti_ads7142_of_match); + +static struct i2c_driver ti_ads7142_driver = { + .driver = { + .name = TI_ADS7142_NAME, + .of_match_table = ti_ads7142_of_match, + .pm = &ti_ads7142_pm_ops, + }, + .probe = ti_ads7142_probe, + .remove = ti_ads7142_remove, + .id_table = ti_ads7142_id, +}; + +module_i2c_driver(ti_ads7142_driver); + +MODULE_LICENSE("GPL"); +MODULE_AUTHOR("Jozsef Horvath "); +MODULE_DESCRIPTION("Texas Instruments TI_ADS7142 ADC driver"); From patchwork Sat May 1 18:25:18 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: =?utf-8?q?J=C3=B3zsef_Horv=C3=A1th?= X-Patchwork-Id: 12234959 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-17.2 required=3.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,HEADER_FROM_DIFFERENT_DOMAINS,INCLUDES_CR_TRAILER, INCLUDES_PATCH,MAILING_LIST_MULTI,SPF_HELO_NONE,SPF_PASS,URIBL_BLOCKED, USER_AGENT_SANE_1 autolearn=unavailable autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id 1E74CC433ED for ; Sat, 1 May 2021 18:31:43 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by mail.kernel.org (Postfix) with ESMTP id D734661477 for ; Sat, 1 May 2021 18:31:42 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S231934AbhEAScb (ORCPT ); Sat, 1 May 2021 14:32:31 -0400 Received: from bmail1.ministro.hu ([5.249.150.236]:34802 "EHLO bmail1.ministro.hu" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S231426AbhEASca (ORCPT ); Sat, 1 May 2021 14:32:30 -0400 X-Greylist: delayed 378 seconds by postgrey-1.27 at vger.kernel.org; Sat, 01 May 2021 14:32:30 EDT Received: from localhost (localhost [127.0.0.1]) by bmail1.ministro.hu (Postfix) with ESMTP id 8E79B123F6F; Sat, 1 May 2021 20:25:55 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=ministro.hu; s=201804; t=1619893555; bh=qTRWs0MU8ud+smZK2st9yKNYtpQS+ibBbiEpu91vyhc=; h=Date:From:To:Subject:References:In-Reply-To:From; b=S/KvMUUclPHJpP9gDC3IvdRLpYKzo6u+s7ELmD3zxxpzXrBO8ZsSCTJVi3rr+ztYt 3sT1FDkAqBCQMS8T/31jl2bdFjrwJ43LZl+CSNKEKO1e+mWAVfllI+aJEcfwe6S0MK yqRp1uK0TqJeQUk5h0pnbqH/u5TUAXtk9RddoACoc3hTfmYZ5A4NJul2TJPv2KG/FO 1KzRUe7DtKPMs/0t6LlkbdopDCkOnLV/wQPsU0rGESg1KqC5SN4jnYm85OuaziMOF3 qg9MY+G9Od9mDev4jU/pbXPJy+w2vBLZOg/52zoFPBWvrBwniI0tjCsQ4HS8MXjmaf 7ou0kAb3q68lQ== X-Virus-Scanned: Debian amavisd-new at ministro.hu Received: from bmail1.ministro.hu ([127.0.0.1]) by localhost (bmail1.ministro.hu [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id AYlxnAuENFIg; Sat, 1 May 2021 20:25:21 +0200 (CEST) Received: from dev (localhost [127.0.0.1]) by bmail1.ministro.hu (Postfix) with ESMTPSA id 1388A123F6D; Sat, 1 May 2021 20:25:20 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=ministro.hu; s=201804; t=1619893521; bh=qTRWs0MU8ud+smZK2st9yKNYtpQS+ibBbiEpu91vyhc=; h=Date:From:To:Subject:References:In-Reply-To:From; b=kTsILt4NnNwpDBrO+6vK9cMMzhYHYvVoBw9vt+v1BwI4Q3GLxvgK5qW30SkRtqwpR LHgcCLG5IJa49X2fqHL6o/Wp48K7oAcLHQHY0P3VYRDrrrsSWzGtADrm6K0BpHVh0j XMiQH0sG7012OzXCICMZBR/+cL4502BT4gu6iQ0zlGMUIx6xWwXavgmjVWJoWJ66Za 4FiqKj0dpXB31zy8ZMi9yNqbC5yGp5gg3RrQGknVGba8LnPY5zwworHsLD5BiCB6D3 A29TUjgrD/1JJ+mVkv8gawhQqrSS25G4i54hLoS3wGNhqC5XwTF57okXzzRaXkMAYm FVwOdbVdhYAPQ== Date: Sat, 1 May 2021 18:25:18 +0000 From: Jozsef Horvath To: Jozsef Horvath , Jonathan Cameron , Lars-Peter Clausen , Peter Meerwald-Stadler , Rob Herring , Liam Girdwood , Mark Brown , Alexandru Ardelean , Heiko Stuebner , Andy Shevchenko , Alex Dewar , Gene Chen , Saravanan Sekar , Lee Jones , linux-iio@vger.kernel.org, devicetree@vger.kernel.org, linux-kernel@vger.kernel.org Subject: [PATCH 2/2] dt-bindings: iio: adc: devicetree bindings for texas instruments ads7142 iio driver Message-ID: <69205d4de46dd21c82b31ca1c35cbf12fbce629b.1619892171.git.info@ministro.hu> References: MIME-Version: 1.0 Content-Disposition: inline In-Reply-To: User-Agent: Mutt/1.9.4 (2018-02-28) Precedence: bulk List-ID: X-Mailing-List: linux-iio@vger.kernel.org This is a device tree schema for iio driver for Texas Instruments ADS7142 dual-channel, programmable sensor monitor. Datasheet: https://www.ti.com/lit/ds/symlink/ads7142.pdf Signed-off-by: Jozsef Horvath --- --- .../bindings/iio/adc/ti,ads7142.yaml | 198 ++++++++++++++++++ 1 file changed, 198 insertions(+) create mode 100644 Documentation/devicetree/bindings/iio/adc/ti,ads7142.yaml diff --git a/Documentation/devicetree/bindings/iio/adc/ti,ads7142.yaml b/Documentation/devicetree/bindings/iio/adc/ti,ads7142.yaml new file mode 100644 index 000000000000..b4e752160156 --- /dev/null +++ b/Documentation/devicetree/bindings/iio/adc/ti,ads7142.yaml @@ -0,0 +1,198 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2 +--- +$id: "http://devicetree.org/schemas/iio/adc/ti,ads7142.yaml#" +$schema: "http://devicetree.org/meta-schemas/core.yaml#" + +title: Texas Instruments ADS7142 adc driver device tree bindings + +maintainers: + - József Horváth + +description: | + This document is for describing the required device tree parameters + for ads7142 adc driver. + The required parameters for proper operation are described below. + + Datasheet: https://www.ti.com/lit/ds/symlink/ads7142.pdf + + Operation modes supportedby the driver: + When the 'ti,monitoring-mode' property is not present + in the devicetree node definition, the driver initiates a single + conversion in the device for each read request + (/sys/bus/iio/devices/iio:deviceX/in_voltageY_raw). + This is a one-shot conversion, and it is called + "Manual Mode" in the datasheet. + + When the 'ti,monitoring-mode' property is present + in the devicetree node definition, the driver configures + the device's digital window comparator and sets the device's + data buffer operation mode to pre alert data mode. + The driver reads the conversion result when the BUSY/RDY interrupt + fires, and keeps the value until the next BUSY/RDY interrupt + or the first read request + (/sys/bus/iio/devices/iio:deviceX/in_voltageY_raw). + The digital window comparator and hysteresis parameters + can be controlled by: + - the devicetree definition of channel node + - iio sysfs interfaces + This is event driven conversion, and is called + "Autonomous Mode with Pre Alert Data" in the datasheet. + This mode can be used to wake up the system with the ALERT pin, + in case when the monitored voltage level is out of the configured range. + +properties: + compatible: + const: ti,ads7142 + + reg: + maxItems: 1 + + interrupts: + description: | + The BUSY/PDY pin is used as interrupt line in autonomous monitoring mode. + maxItems: 1 + + vref-supply: + description: Regulator for the reference voltage + + power-supply: true + + "#address-cells": + const: 1 + + "#size-cells": + const: 0 + + "#io-channel-cells": + const: 1 + + ti,osc-sel: + description: | + If present, the driver selects the high speed oscillator. + See chapter 7.3.5 Oscillator and Timing Control in datasheet. + type: boolean + + ti,n-clk: + description: | + nCLK is number of clocks in one conversion cycle. + See chapter 7.3.5 Oscillator and Timing Control in datasheet. + $ref: /schemas/types.yaml#/definitions/uint32 + maximum: 255 + minimum: 0 + + ti,monitoring-mode: + description: | + If present, the driver selects the autonomous monitoring mode with pre alert data. + See chapter 7.4 Device Functional Modes in datasheet. + type: boolean + +patternProperties: + "^channel@[0-1]$": + $ref: "adc.yaml" + type: object + description: | + Represents the external channels which are connected to the ADC. + properties: + reg: + description: | + The channel number. + items: + minimum: 0 + maximum: 1 + "ti,threshold-falling": + description: The low threshold for channel + $ref: /schemas/types.yaml#/definitions/uint32 + maximum: 4095 + minimum: 0 + "ti,threshold-rising": + description: The high threshold for channel + $ref: /schemas/types.yaml#/definitions/uint32 + maximum: 4095 + minimum: 0 + "ti,hysteresis": + description: The hysteresis for both comparators for channel + $ref: /schemas/types.yaml#/definitions/uint32 + maximum: 63 + minimum: 0 + + required: + - reg + + additionalProperties: false + +allOf: + - if: + required: + - ti,monitoring-mode + then: + required: + - interrupts + +required: + - compatible + - "#io-channel-cells" + +additionalProperties: false + +examples: + - | + i2c { + #address-cells = <1>; + #size-cells = <0>; + adc@18 { + compatible = "ti,ads7142"; + reg = <0x18>; + #address-cells = <1>; + #size-cells = <0>; + #io-channel-cells = <1>; + + vref-supply = <&vdd_3v3_reg>; + power-supply = <&vdd_1v8_reg>; + + channel@0 { + reg = <0>; + }; + + channel@1 { + reg = <1>; + }; + }; + }; + - | + i2c { + #address-cells = <1>; + #size-cells = <0>; + adc@1f { + compatible = "ti,ads7142"; + reg = <0x1f>; + #address-cells = <1>; + #size-cells = <0>; + + #io-channel-cells = <1>; + + vref-supply = <&vdd_3v3_reg>; + power-supply = <&vdd_1v8_reg>; + + interrupt-parent = <&gpio>; + interrupts = <7 2>; + + ti,monitoring-mode; + + channel@0 { + reg = <0>; + ti,threshold-falling = <1000>; + ti,threshold-rising = <2000>; + ti,hysteresis = <20>; + }; + + channel@1 { + reg = <1>; + ti,threshold-falling = <100>; + ti,threshold-rising = <2500>; + ti,hysteresis = <0>; + }; + }; + }; +... +