Texas Instruments DAC8771
Subsystems (2)
cover Texas Instruments DAC8771
Hello
Introduce the TI DAC8771.
The DAC8771 is a single channel, precision, fully integrated 16-bit digital to analog converter (DAC) with adaptive power management, and is designed to meet the requirements of industrial control applications.
Dan
Dan Murphy (2):
dt-binding: iio: dac8771: Add TI DAC8771 binding
iio: dac: Introduce the TI DAC8771 DAC driver
.../bindings/iio/dac/ti,dac8771.yaml | 89 ++++ drivers/iio/dac/Kconfig | 7 + drivers/iio/dac/Makefile | 1 + drivers/iio/dac/ti-dac8771.c | 499 ++++++++++++++++++ 4 files changed, 596 insertions(+) create mode 100644 Documentation/devicetree/bindings/iio/dac/ti,dac8771.yaml create mode 100644 drivers/iio/dac/ti-dac8771.c
Signature · 1 line
2.23.0
PATCH 1/2 dt-binding: iio: dac8771: Add TI DAC8771 binding
Add the TI DAC8771 DT binding.
Datasheet:
http://www.ti.com/lit/ds/symlink/dac8771.pdf
--- .../bindings/iio/dac/ti,dac8771.yaml | 89 +++++++++++++++++++ 1 file changed, 89 insertions(+) create mode 100644 Documentation/devicetree/bindings/iio/dac/ti,dac8771.yaml
Documentation/devicetree/bindings/iio/dac/ti,dac8771.yaml new file +89 -0
@@ -0,0 +1,89 @@ +# SPDX-License-Identifier: GPL-2.0 +# Copyright (C) 2019 Texas Instruments Incorporated +%YAML 1.2 +--- +$id: "http://devicetree.org/schemas/bindings/iio/dac/ti,dac8771.yaml#" +$schema: "http://devicetree.org/meta-schemas/core.yaml#" + +title: Texas Instruments DAC8771 + +maintainers: + - Dan Murphy <[email protected]> + +description: | + The DAC8771 is a single channel, precision, fully integrated 16-bit digital + to analog converter (DAC) with adaptive power management, and is designed to + meet the requirements of industrial control applications. + + Specifications can be found at: + http://www.ti.com/lit/ds/symlink/dac8771.pdf + +properties: + compatible: + enum: + - ti,dac8771 + + reg: + maxItems: 1 + + reset-gpios: + description: | + GPIO used for hardware reset. + + loaddacs-gpios: + description: | + GPIO used to shift the data from the SPI FIFO to the processing engine. + + spi-max-frequency: + maximum: 25000000 + + vref-supply: + description: Phandle to the external reference voltage supply. + + ti,output-range: + description: Output range of the DAC + 0 - Voltage output 0 to +5 V (default) + 1 - Voltage output 0 to +10 V + 2 - Voltage output ±5 V + 3 - Voltage output ±10 V + 4 - Current output 3.5 mA to 23.5 mA + 5 - Current output 0 to 20 mA + 6 - Current output 0 to 24 mA + 7 - Current output ±24 mA + 8 - Voltage output 0 to +6 V + 9 - Voltage output 0 to +12 V + 10 - Voltage output ±6 V + 11 - Voltage output ±12 V + 12 - Current output 4 mA to 20 mA + allOf: + - $ref: /schemas/types.yaml#/definitions/uint8 + - enum: [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12] + + interrupts: + description: IRQ line for the DAC + maxItems: 1 + +required: + - compatible + - reg + - vref-supply + +examples: + - | + #include <dt-bindings/gpio/gpio.h> + spi { + #address-cells = <1>; + #size-cells = <0>; + + dac@0 { + compatible = "ti,dac8771"; + reg = <0>; + spi-max-frequency = <25000000>; + vref-supply = <&ldo3_reg>; + ti,output-range = <2>; + interrupts = <16>; + interrupt-parent = <&gpio1>; + loaddacs-gpios = <&gpio1 17 GPIO_ACTIVE_LOW>; + reset-gpios = <&gpio1 27 GPIO_ACTIVE_LOW>; + }; + };
Signature · 1 line
2.23.0
Jonathan Cameron
maintainerRe: [PATCH 1/2] dt-binding: iio: dac8771: Add TI DAC8771 binding
Quoted 18 lines · On Tue, 17 Dec 2019 08:07:30 -0600 Dan Murphy <[email protected]> wrote:
Add the TI DAC8771 DT binding.
Datasheet:
http://www.ti.com/lit/ds/symlink/dac8771.pdfSigned-off-by Dan Murphy <[email protected]>CC Rob Herring <[email protected]>--- .../bindings/iio/dac/ti,dac8771.yaml | 89 +++++++++++++++++++ 1 file changed, 89 insertions(+) create mode 100644 Documentation/devicetree/bindings/iio/dac/ti,dac8771.yamlDocumentation/devicetree/bindings/iio/dac/ti,dac8771.yaml new file +0
-0
Documentation/devicetree/bindings/iio/dac/ti,dac8771.yaml line 1
Quoted 1 line
Documentation/devicetree/bindings/iio/dac/ti,dac8771.yaml new file +1
-0@@ -0,0 +1,89 @@ +# SPDX-License-Identifier: GPL-2.0
If possible, it is preferred for new bindings to be dual licensed as
(GPL-2.0-only OR BSD-2-Clause)
Quoted 34 lines
Documentation/devicetree/bindings/iio/dac/ti,dac8771.yaml new file +34
-0+# Copyright (C) 2019 Texas Instruments Incorporated +%YAML 1.2 +--- +$id: "http://devicetree.org/schemas/bindings/iio/dac/ti,dac8771.yaml#" +$schema: "http://devicetree.org/meta-schemas/core.yaml#" + +title: Texas Instruments DAC8771 + +maintainers: + - Dan Murphy <[email protected]> + +description: | + The DAC8771 is a single channel, precision, fully integrated 16-bit digital + to analog converter (DAC) with adaptive power management, and is designed to + meet the requirements of industrial control applications. + + Specifications can be found at: + http://www.ti.com/lit/ds/symlink/dac8771.pdf + +properties: + compatible: + enum: + - ti,dac8771 + + reg: + maxItems: 1 + + reset-gpios: + description: | + GPIO used for hardware reset. + + loaddacs-gpios: + description: | + GPIO used to shift the data from the SPI FIFO to the processing engine.
Documentation/devicetree/bindings/iio/dac/ti,dac8771.yaml line 45
Quoted 10 lines
Documentation/devicetree/bindings/iio/dac/ti,dac8771.yaml new file +10
-0+ + spi-max-frequency: + maximum: 25000000 + + vref-supply: + description: Phandle to the external reference voltage supply. + + ti,output-range: + description: Output range of the DAC + 0 - Voltage output 0 to +5 V (default)
Hmm. I'm never keen on opaque bindings, but sometimes things are just too complex to break out as individual fields.
So I guess this is the best we can do.
Quoted 44 lines
Documentation/devicetree/bindings/iio/dac/ti,dac8771.yaml new file +44
-0+ 1 - Voltage output 0 to +10 V + 2 - Voltage output ±5 V + 3 - Voltage output ±10 V + 4 - Current output 3.5 mA to 23.5 mA + 5 - Current output 0 to 20 mA + 6 - Current output 0 to 24 mA + 7 - Current output ±24 mA + 8 - Voltage output 0 to +6 V + 9 - Voltage output 0 to +12 V + 10 - Voltage output ±6 V + 11 - Voltage output ±12 V + 12 - Current output 4 mA to 20 mA + allOf: + - $ref: /schemas/types.yaml#/definitions/uint8 + - enum: [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12] + + interrupts: + description: IRQ line for the DAC + maxItems: 1 + +required: + - compatible + - reg + - vref-supply + +examples: + - | + #include <dt-bindings/gpio/gpio.h> + spi { + #address-cells = <1>; + #size-cells = <0>; + + dac@0 { + compatible = "ti,dac8771"; + reg = <0>; + spi-max-frequency = <25000000>; + vref-supply = <&ldo3_reg>; + ti,output-range = <2>; + interrupts = <16>; + interrupt-parent = <&gpio1>; + loaddacs-gpios = <&gpio1 17 GPIO_ACTIVE_LOW>; + reset-gpios = <&gpio1 27 GPIO_ACTIVE_LOW>; + }; + };
Re: [PATCH 1/2] dt-binding: iio: dac8771: Add TI DAC8771 binding
Jonathan
Thanks for the review. I was on holiday
Quoted 24 lines · Jonathan Cameron
Quoted 18 lines · On Tue, 17 Dec 2019 08:07:30 -0600 Dan Murphy <[email protected]> wrote:
Add the TI DAC8771 DT binding.
Datasheet:
http://www.ti.com/lit/ds/symlink/dac8771.pdfSigned-off-by Dan Murphy <[email protected]>CC Rob Herring <[email protected]>--- .../bindings/iio/dac/ti,dac8771.yaml | 89 +++++++++++++++++++ 1 file changed, 89 insertions(+)create mode 100644
Documentation/devicetree/bindings/iio/dac/ti,dac8771.yamlDocumentation/devicetree/bindings/iio/dac/ti,dac8771.yaml new file +0
-0Documentation/devicetree/bindings/iio/dac/ti,dac8771.yaml line 1
Quoted 1 line
Documentation/devicetree/bindings/iio/dac/ti,dac8771.yaml new file +1
-0@@ -0,0 +1,89 @@ +# SPDX-License-Identifier: GPL-2.0If possible, it is preferred for new bindings to be dual licensed as
Quoted 2 lines
(GPL-2.0-only OR BSD-2-Clause)
Ack
Quoted 47 lines
Quoted 34 lines
Documentation/devicetree/bindings/iio/dac/ti,dac8771.yaml new file +34
-0+# Copyright (C) 2019 Texas Instruments Incorporated +%YAML 1.2 +--- +$id: "http://devicetree.org/schemas/bindings/iio/dac/ti,dac8771.yaml#" +$schema: "http://devicetree.org/meta-schemas/core.yaml#" + +title: Texas Instruments DAC8771 + +maintainers: + - Dan Murphy <[email protected]> + +description: | + The DAC8771 is a single channel, precision, fully integrated 16-bit digital + to analog converter (DAC) with adaptive power management, and is designed to + meet the requirements of industrial control applications. + + Specifications can be found at: + http://www.ti.com/lit/ds/symlink/dac8771.pdf + +properties: + compatible: + enum: + - ti,dac8771 + + reg: + maxItems: 1 + + reset-gpios: + description: | + GPIO used for hardware reset. + + loaddacs-gpios: + description: | + GPIO used to shift the data from the SPI FIFO to the processing engine.Documentation/devicetree/bindings/iio/dac/ti,dac8771.yaml line 45
Quoted 10 lines
Documentation/devicetree/bindings/iio/dac/ti,dac8771.yaml new file +10
-0+ + spi-max-frequency: + maximum: 25000000 + + vref-supply: + description: Phandle to the external reference voltage supply. + + ti,output-range: + description: Output range of the DAC + 0 - Voltage output 0 to +5 V (default)Hmm. I'm never keen on opaque bindings, but sometimes things are just too complex to break out as individual fields.
Quoted 1 line
So I guess this is the best we can do.
Yes that is true. These values are the same as the ones in the data sheet.
It would have been a simpler binding if the current values were not nested with the voltage values.
Dan
PATCH 2/2 iio: dac: Introduce the TI DAC8771 DAC driver
In reply to Dan MurphyAdding the Texas Instruments single channel 16 bit DAC driver. This device has configurable voltage and current output with 16 bit resolution for offset and gain.
--- drivers/iio/dac/Kconfig | 7 + drivers/iio/dac/Makefile | 1 + drivers/iio/dac/ti-dac8771.c | 499 +++++++++++++++++++++++++++++++++++ 3 files changed, 507 insertions(+) create mode 100644 drivers/iio/dac/ti-dac8771.c
drivers/iio/dac/Kconfig +7 -0
@@ -386,6 +386,13 @@ config TI_DAC7612 If compiled as a module, it will be called ti-dac7612. +config TI_DAC8771 + tristate "Texas Instruments 16-bit single channel DAC driver" + depends on SPI_MASTER && GPIOLIB + help + Driver for the Texas Instruments DAC8771. + If compiled as a module, it will be called ti-dac8771. + config VF610_DAC tristate "Vybrid vf610 DAC driver" depends on OF
drivers/iio/dac/Makefile +1 -0
@@ -42,4 +42,5 @@ obj-$(CONFIG_TI_DAC082S085) += ti-dac082s085.o obj-$(CONFIG_TI_DAC5571) += ti-dac5571.o obj-$(CONFIG_TI_DAC7311) += ti-dac7311.o obj-$(CONFIG_TI_DAC7612) += ti-dac7612.o +obj-$(CONFIG_TI_DAC8771) += ti-dac8771.o obj-$(CONFIG_VF610_DAC) += vf610_dac.o
drivers/iio/dac/ti-dac8771.c new file +499 -0
499 lines not on this page · raw message
Signature · 1 line
2.23.0
Jonathan Cameron
maintainerRe: [PATCH 2/2] iio: dac: Introduce the TI DAC8771 DAC driver
Quoted 5 lines · On Tue, 17 Dec 2019 08:07:31 -0600 Dan Murphy <[email protected]> wrote:
Adding the Texas Instruments single channel 16 bit DAC driver. This device has configurable voltage and current output with 16 bit resolution for offset and gain.
Signed-off-by Dan Murphy <[email protected]>
Various small things inline.
Thanks,
Jonathan
Quoted 41 lines
--- drivers/iio/dac/Kconfig | 7 + drivers/iio/dac/Makefile | 1 + drivers/iio/dac/ti-dac8771.c | 499 +++++++++++++++++++++++++++++++++++ 3 files changed, 507 insertions(+) create mode 100644 drivers/iio/dac/ti-dac8771.cdrivers/iio/dac/Kconfig +7
-0@@ -386,6 +386,13 @@ config TI_DAC7612 If compiled as a module, it will be called ti-dac7612. +config TI_DAC8771 + tristate "Texas Instruments 16-bit single channel DAC driver" + depends on SPI_MASTER && GPIOLIB + help + Driver for the Texas Instruments DAC8771. + If compiled as a module, it will be called ti-dac8771. + config VF610_DAC tristate "Vybrid vf610 DAC driver" depends on OFdrivers/iio/dac/Makefile +1
-0@@ -42,4 +42,5 @@ obj-$(CONFIG_TI_DAC082S085) += ti-dac082s085.o obj-$(CONFIG_TI_DAC5571) += ti-dac5571.o obj-$(CONFIG_TI_DAC7311) += ti-dac7311.o obj-$(CONFIG_TI_DAC7612) += ti-dac7612.o +obj-$(CONFIG_TI_DAC8771) += ti-dac8771.o obj-$(CONFIG_VF610_DAC) += vf610_dac.odrivers/iio/dac/ti-dac8771.c new file +0
-0
drivers/iio/dac/ti-dac8771.c line 8
Quoted 8 lines
drivers/iio/dac/ti-dac8771.c new file +8
-0@@ -0,0 +1,499 @@ +// SPDX-License-Identifier: GPL-2.0 +// DAC8771 DAC +// Copyright (C) 2019 Texas Instruments Incorporated - http://www.ti.com/ + +#include <linux/interrupt.h> +#include <linux/module.h> +#include <linux/gpio/consumer.h> +#include <linux/of_gpio.h>
What is using of_gpio.h in here?
Quoted 61 lines
drivers/iio/dac/ti-dac8771.c new file +61
-0+#include <linux/regulator/consumer.h> +#include <linux/spi/spi.h> + +#include <linux/iio/iio.h> +#include <linux/iio/events.h> + +#define DAC8771_RESET 0x01 +#define DAC8771_RESET_CFG 0x02 +#define DAC8771_DAC_SELECT 0x03 +#define DAC8771_DAC_CFG 0x04 +#define DAC8771_DAC_DATA 0x05 +#define DAC8771_BUCK_BOOST_SEL 0x06 +#define DAC8771_BUCK_BOOST_CFG 0x07 +#define DAC8771_CH_CAL_EN 0x08 +#define DAC8771_CH_GAIN_CAL 0x09 +#define DAC8771_CH_OFF_CAL 0x0a +#define DAC8771_STATUS 0x0b +#define DAC8771_STATUS_MSK 0x0c +#define DAC8771_ALARM_ACTION 0x0d +#define DAC8771_ALARM_CODE 0x0e +#define DAC8771_WDOG_RESET 0x10 +#define DAC8771_DEV_ID 0x11 + +#define DAC8771_RESOLUTION 16 + +/* Status register */ +#define DAC8771_OVERTEMP BIT(4) +#define DAC8771_DAC_FAULT BIT(0) +#define DAC8771_STATUS_MASK (DAC8771_OVERTEMP | DAC8771_DAC_FAULT) + +#define DAC8771_READ_EN BIT(7) + +#define DAC8771_SW_RESET BIT(0) +#define DAC8771_SPI_ENABLE 0 +#define DAC8771_SPI_DISABLE 1 + +#define DAC8771_CHA_SEL BIT(5) +#define DAC8771_OUT_RANGE_MSK GENMASK(3, 0) +#define DAC8771_MAX_GAIN_OFF 65535 + +#define DAC8771_OUT_RANGE_DEF 0x0 +#define DAC8771_OUT_RANGE_CURR_LOW 4 +#define DAC8771_OUT_RANGE_CURR_HIGH 7 +#define DAC8771_OUT_RANGE_MAX 12 + +#define DAC8771_SELECT_A BIT(0) + +/** +* struct dac8771_chip - TI DAC chip +* @lock: protects write sequences +* @vref: regulator generating Vref +* @spi: SPI device to send data to the device +* @ldac: load DAC GPIO +* @reset: reset GPIO +* @chan_type: Type of IIO channel either VOLTAGE or CURRENT +* @output_range: output range of the device +* @val: cached value +* @buf: buffer for transfer data +*/ +struct dac8771_chip { +struct mutex lock;
drivers/iio/dac/ti-dac8771.c line 79
Quoted 10 lines
drivers/iio/dac/ti-dac8771.c new file +10
-0+struct regulator *vref; +struct spi_device *spi; +struct gpio_desc *ldac; +struct gpio_desc *reset; +enum iio_chan_type chan_type; +u8 output_range; +u16 val; +union { +__be32 d32; +__be16 d16;
Why? Only d8 seems to be used.
drivers/iio/dac/ti-dac8771.c line 87
Quoted 8 lines
drivers/iio/dac/ti-dac8771.c new file +8
-0+u8 d8[3 ]; + } data[3 ]____cacheline_aligned ; +}; + +static int dac8771_write (struct dac8771_chip *dac8771, +unsigned int reg,int val) +{ +u8 data[3 ];
Spi buffers need to be dma safe. Can't be on the stack because you can't force stack variables to be in a cacheline without anything else that might cause problems during dma transfers.
Quoted 8 lines
drivers/iio/dac/ti-dac8771.c new file +8
-0+ + data[0 ] = reg; + data[1 ] = val >>8 ; + data[2 ] = val &0xff ; + +return spi_write (dac8771->spi, &data,sizeof (data)); +} +
drivers/iio/dac/ti-dac8771.c line 105
Quoted 10 lines
drivers/iio/dac/ti-dac8771.c new file +10
-0+static int dac8771_read (struct dac8771_chip *dac8771,unsigned int reg) +{ +int ret; +struct spi_transfer t[] = { + { + .tx_buf = &dac8771->data[0 ].d8[0 ], + .len =3 , + .cs_change =1 , + }, { + .tx_buf = &dac8771->data[1 ].d8[0 ],
I can't immediately see where anything is put into this buffer to transmit..
Quoted 135 lines
drivers/iio/dac/ti-dac8771.c new file +135
-0+ .rx_buf = &dac8771->data[2].d8[0], + .len = 3, + }, + }; + + dac8771->data[0 ].d8[0 ] = (DAC8771_READ_EN | reg); + + ret =spi_sync_transfer (dac8771->spi, t,ARRAY_SIZE (t)); +if (ret <0 ) +return ret; + +return (dac8771->data[2 ].d8[1 ] <<8 | dac8771->data[2 ].d8[2 ]); +} + +static int dac8771_sync_write (struct dac8771_chip *dac8771, +unsigned int reg,int val) +{ +int ret; + + ret =dac8771_write (dac8771, reg, val); +if (ret) +return ret; + +if (dac8771->ldac) { +gpiod_set_value (dac8771->ldac,1 ); +gpiod_set_value (dac8771->ldac,0 ); + } + +return ret; +} + +static int dac8771_reset (struct dac8771_chip *dac8771) +{ +if (dac8771->reset) { +gpiod_set_value (dac8771->reset,0 ); +gpiod_set_value (dac8771->reset,1 ); + }else { +return dac8771_sync_write (dac8771,DAC8771_RESET , +DAC8771_SW_RESET ); + } + +return 0 ; +} + +static int dac8771_update_bits (struct dac8771_chip *dac8771,unsigned int reg, +int mask,int val) +{ +int write_val; +int tmp; + + tmp =dac8771_read (dac8771, reg); +if (tmp <0 ) +return tmp; + + write_val = (tmp & ~mask); + write_val |= val & mask; + +return dac8771_write (dac8771, reg, write_val); +} + +static int dac8771_read_raw (struct iio_dev *indio_dev, +struct iio_chan_spec const *chan, +int *val,int *val2,long mask) +{ +struct dac8771_chip *dac8771 =iio_priv (indio_dev); +int ret; + +switch (mask) { +case IIO_CHAN_INFO_RAW : + *val = dac8771->val; +return IIO_VAL_INT ; +case IIO_CHAN_INFO_SCALE : + ret =regulator_get_voltage (dac8771->vref); +if (ret <0 ) +return ret; + + *val = ret /1000 ; + *val2 =DAC8771_RESOLUTION ; +return IIO_VAL_FRACTIONAL_LOG2 ; +case IIO_CHAN_INFO_OFFSET : +mutex_lock (&dac8771->lock); + ret =dac8771_read (dac8771,DAC8771_CH_OFF_CAL ); +mutex_unlock (&dac8771->lock); + +if (ret <0 ) +return ret; + + *val = ret; +return IIO_VAL_INT ; +case IIO_CHAN_INFO_HARDWAREGAIN : +mutex_lock (&dac8771->lock); + ret =dac8771_read (dac8771,DAC8771_CH_GAIN_CAL ); +mutex_unlock (&dac8771->lock); + +if (ret <0 ) +return ret; + + *val = ret; +return IIO_VAL_INT ; +default : + ret = -EINVAL ; + } + +return -EINVAL ; +} + +static int dac8771_write_raw (struct iio_dev *indio_dev, +struct iio_chan_spec const *chan, +int val,int val2,long mask) +{ +struct dac8771_chip *dac8771 =iio_priv (indio_dev); +int ret; + +switch (mask) { +case IIO_CHAN_INFO_RAW : +mutex_lock (&dac8771->lock); + ret =dac8771_sync_write (dac8771,DAC8771_DAC_DATA , val); +if (!ret) + dac8771->val = val; +break ; +case IIO_CHAN_INFO_ENABLE : +if (val) + val =DAC8771_CHA_SEL ; +else + val =0 ; + +mutex_lock (&dac8771->lock); + + ret =dac8771_update_bits (dac8771,DAC8771_DAC_SELECT , +DAC8771_CHA_SEL , val); +if (ret) + goto io_err; + + ret = dac8771_update_bits(dac8771, DAC8771_DAC_CFG, + DAC8771_OUT_RANGE_MSK,
drivers/iio/dac/ti-dac8771.c line 250
Quoted 10 lines
drivers/iio/dac/ti-dac8771.c new file +10
-0+ dac8771->output_range); +break ; +case IIO_CHAN_INFO_OFFSET : +if (val >DAC8771_MAX_GAIN_OFF ) +return -EINVAL ; + +mutex_lock (&dac8771->lock); + ret =dac8771_sync_write (dac8771,DAC8771_CH_OFF_CAL , val); +break ; +case IIO_CHAN_INFO_HARDWAREGAIN :
Hmm. I wouldn't expect to see hardware gain on a DAC. It has some very specific usecases, normally focused around device where the thing being measured or generated is not an amplitude (time of flight sensors for example).
For a dac, we would normally have IIO_CHAN_INFO_SCALE controlling user visible 'gain' by specifying the value of 1LSB. We might also have IIO_CHAN_INFO_CALIBSCALE to reflect small correction controls, usually used to compensate for manufacturing variability. So whilst they do move the output value on a DAC, the intent is this is not a general user control but more of a 'trimming control'. Given the register name of _CAL I'm guessing this one should be IIO_CHAN_INFO_CALIBSCALE.
Quoted 21 lines
drivers/iio/dac/ti-dac8771.c new file +21
-0+if (val >DAC8771_MAX_GAIN_OFF ) +return -EINVAL ; + +mutex_lock (&dac8771->lock); + ret =dac8771_sync_write (dac8771,DAC8771_CH_GAIN_CAL , val); +break ; +default : +return -EINVAL ; + } +io_err: +mutex_unlock (&dac8771->lock); +return ret; +} + +static int dac8771_write_raw_get_fmt (struct iio_dev *indio_dev, +struct iio_chan_spec const *chan,long mask) +{ +return IIO_VAL_INT ; +} + +static irqreturn_t dac8771_event_handler (int irq,void *private)
drivers/iio/dac/ti-dac8771.c line 281
Quoted 10 lines
drivers/iio/dac/ti-dac8771.c new file +10
-0+{ +struct iio_dev *indio_dev = private; +struct dac8771_chip *dac8771 =iio_priv (indio_dev); +int clear_bits =0 ; +int ret; + + ret =dac8771_read (dac8771,DAC8771_STATUS ); + +if (ret &DAC8771_OVERTEMP ) { + iio_push_event(private,
Given you have a local indio_dev variable, nicer to use that than private.
drivers/iio/dac/ti-dac8771.c line 292
Quoted 11 lines
drivers/iio/dac/ti-dac8771.c new file +11
-0+IIO_UNMOD_EVENT_CODE (IIO_TEMP , +0 ,IIO_EV_TYPE_THRESH ,IIO_EV_DIR_RISING ), + iio_get_time_ns(private)); + clear_bits =DAC8771_OVERTEMP ; + } + +if (ret &DAC8771_DAC_FAULT ) { +iio_push_event (private, +IIO_UNMOD_EVENT_CODE (dac8771->chan_type, +0 ,IIO_EV_TYPE_CHANGE ,IIO_EV_DIR_NONE ), +iio_get_time_ns (private));
We need some more discussion on why this event is done like this. What does it signify? Would userspace expect to get it this way?
In general, provision for fault cases is poor, at least partly because, every now and then there is discussion on how to report hardware errors like this in general across the kernel, but no good answer has ever being figured out.
Quoted 114 lines
drivers/iio/dac/ti-dac8771.c new file +113
-0+ + clear_bits |=DAC8771_DAC_FAULT ; + } + + ret =dac8771_update_bits (dac8771,DAC8771_STATUS ,DAC8771_STATUS_MASK , + clear_bits); +if (ret) +dev_err (&dac8771->spi->dev, +"Failed to clear status register\n" ); + +return IRQ_HANDLED ; +} + +static const struct iio_info dac8771_info = { + .read_raw = dac8771_read_raw, + .write_raw = dac8771_write_raw, + .write_raw_get_fmt = dac8771_write_raw_get_fmt, +}; + +static int dac8771_probe_dt (struct dac8771_chip *dac8771) +{ +u32 range; +int ret; + + dac8771->ldac =devm_gpiod_get_optional (&dac8771->spi->dev,"loaddacs" , +GPIOD_OUT_HIGH ); +if (IS_ERR (dac8771->ldac)) { + ret =PTR_ERR (dac8771->ldac); +if (ret != -ENODEV ) { +if (ret != -EPROBE_DEFER ) +dev_err (&dac8771->spi->dev, +"Failed to get loaddacs gpio: %d\n" , + ret); +return ret; + } + dac8771->ldac =NULL ; + } + + dac8771->reset =devm_gpiod_get_optional (&dac8771->spi->dev,"reset" , +GPIOD_OUT_HIGH ); +if (IS_ERR (dac8771->reset)) { + ret =PTR_ERR (dac8771->reset); +if (ret != -ENODEV ) { +if (ret != -EPROBE_DEFER ) +dev_err (&dac8771->spi->dev, +"Failed to get reset gpio: %d\n" , + ret); +return ret; + } + dac8771->reset =NULL ; + } + + ret =device_property_read_u32 (&dac8771->spi->dev,"ti,output-range" , + &range); +if (ret) { +dev_err (&dac8771->spi->dev, +"Output range is not set using default\n" ); + range =DAC8771_OUT_RANGE_DEF ; + }else { +if (dac8771->output_range <DAC8771_OUT_RANGE_DEF || + dac8771->output_range >DAC8771_OUT_RANGE_MAX ) { +dev_err (&dac8771->spi->dev, +"Output range is invalid\n" ); +return -EINVAL ; + } + } + + dac8771->output_range = range; +if ((dac8771->output_range >=DAC8771_OUT_RANGE_CURR_LOW && + dac8771->output_range <=DAC8771_OUT_RANGE_CURR_HIGH ) || + dac8771->output_range ==DAC8771_OUT_RANGE_MAX ) + dac8771->chan_type =IIO_CURRENT ; +else + dac8771->chan_type =IIO_VOLTAGE ; + +return 0 ; +} + +static int dac8771_init (struct dac8771_chip *dac8771) +{ +int ret; + + ret =dac8771_reset (dac8771); +if (ret) +return ret; + +return dac8771_write (dac8771,DAC8771_BUCK_BOOST_SEL ,DAC8771_SELECT_A ); +} + +static int dac8771_probe (struct spi_device *spi) +{ +struct device *dev = &spi->dev; +struct dac8771_chip *dac8771; +struct iio_dev *indio_dev; +struct iio_chan_spec *chan; +int ret; + + indio_dev =devm_iio_device_alloc (dev,sizeof (*dac8771)); +if (!indio_dev) { +dev_err (dev,"can not allocate iio device\n" ); +return -ENOMEM ; + } + + spi->mode =SPI_MODE_2 ; +spi_setup (spi); +spi_set_drvdata (spi, indio_dev); + + dac8771 =iio_priv (indio_dev); + dac8771->spi = spi; + + ret =dac8771_probe_dt (dac8771); +if (ret) +return ret;
drivers/iio/dac/ti-dac8771.c line 415
Quoted 10 lines
drivers/iio/dac/ti-dac8771.c new file +10
-0+ + indio_dev->dev.parent = dev; + indio_dev->dev.of_node = spi->dev.of_node; + indio_dev->info = &dac8771_info; + indio_dev->name =spi_get_device_id (spi)->name; + indio_dev->modes =INDIO_DIRECT_MODE ; + indio_dev->num_channels =1 ; + + chan =devm_kzalloc (&indio_dev->dev,sizeof (struct iio_chan_spec ), +GFP_KERNEL );
If it's always the same size, why not embed it in the dac8711 structure? Will avoid the need for an extra allocation.
drivers/iio/dac/ti-dac8771.c line 417
Quoted 2 lines
drivers/iio/dac/ti-dac8771.c new file +2
-0+ + chan->type = dac8771->chan_type;
As there are only two types (I think!) I'd prefer to see this done as a pick between two static const structures rather than via dynamic setup.
drivers/iio/dac/ti-dac8771.c line 429
Quoted 12 lines
drivers/iio/dac/ti-dac8771.c new file +12
-0+ chan->channel =0 ; + chan->output = true; + chan->info_mask_shared_by_type =BIT (IIO_CHAN_INFO_SCALE ); + chan->info_mask_separate =BIT (IIO_CHAN_INFO_RAW ) | +BIT (IIO_CHAN_INFO_OFFSET ) | +BIT (IIO_CHAN_INFO_HARDWAREGAIN ) | +BIT (IIO_CHAN_INFO_ENABLE ) | +BIT (IIO_CHAN_INFO_SCALE ); + + indio_dev->channels = chan; + + dac8771->vref =devm_regulator_get (&dac8771->spi->dev,"vref" );
A quick glance at the datasheet suggests this device can be used with an internal reference? Ideally we'd support that by making the provision of a vref regulator optional.
It also seems that there are a number of other power supplies that should be in the dt bindings even if not yet supported by the driver.
Quoted 18 lines
drivers/iio/dac/ti-dac8771.c new file +18
-0+if (IS_ERR (dac8771->vref)) { +dev_err (&dac8771->spi->dev,"error to get regulator\n" ); +return PTR_ERR (dac8771->vref); + } + + ret =regulator_enable (dac8771->vref); +if (ret <0 ) { +dev_err (dev,"can not enable regulator\n" ); +return ret; + } + +mutex_init (&dac8771->lock); + +if (spi->irq) { + ret = devm_request_threaded_irq(&spi->dev, spi->irq, NULL, + &dac8771_event_handler, + IRQF_TRIGGER_FALLING | IRQF_ONESHOT, + spi_get_device_id(dac8771->spi)->name,
drivers/iio/dac/ti-dac8771.c line 457
Quoted 10 lines
drivers/iio/dac/ti-dac8771.c new file +10
-0+ indio_dev); +if (ret) + goto err; + } + + ret =dac8771_init (dac8771); +if (ret) + goto err; + +return devm_iio_device_register (&spi->dev, indio_dev);
You can't safely mix managed and unmanaged code like this.
By the time the userspace interfacs are removed as a result of the equivalent of iio_device_unregister being called as the device managed code unwinds, we will have turned the reference voltage off. Any readings that happen to occur in that narrow window will get unpredictable results.
One option for that is to use devm_add_action_or_reset to register an additional unwind function to deal with the regulator disable in the remove path. The argument for not having a devm_regulator_enable has been that it is almost always desirable to turn regulators off in other paths (suspend or runtime suspend) so normally it doesn't make that much sense to have a general always approach.
Note we hardly ever bother with mutex_destroy as it is only for debug purposes and usually only relevant if complex handling is going on within the driver. For that reason I guess, no one has ever bothered with a devm_mutex_init().
Quoted 42 lines
drivers/iio/dac/ti-dac8771.c new file +42
-0+err: +mutex_destroy (&dac8771->lock); +regulator_disable (dac8771->vref); +return ret; +} + +static int dac8771_remove (struct spi_device *spi) +{ +struct iio_dev *indio_dev =spi_get_drvdata (spi); +struct dac8771_chip *dac8771 =iio_priv (indio_dev); + +mutex_destroy (&dac8771->lock); +regulator_disable (dac8771->vref); +return 0 ; +} + +static const struct of_device_id dac8771_of_id[] = { + { .compatible ="ti,dac8771" }, + { } +}; +MODULE_DEVICE_TABLE (of, dac8771_of_id); + +static const struct spi_device_id dac8771_spi_id[] = { + {"dac8771" ,0 }, + { } +}; +MODULE_DEVICE_TABLE (spi, dac8771_spi_id); + +static struct spi_driver dac8771_driver = { + .driver = { + .name ="ti-dac8771" , + .of_match_table = dac8771_of_id, + }, + .probe = dac8771_probe, + .remove = dac8771_remove, + .id_table = dac8771_spi_id, +}; +module_spi_driver (dac8771_driver); + +MODULE_AUTHOR ("Dan Murphy <[email protected]>" ); +MODULE_DESCRIPTION ("Texas Instruments DAC8771 driver" ); +MODULE_LICENSE ("GPL v2" );
Re: [PATCH 2/2] iio: dac: Introduce the TI DAC8771 DAC driver
Jonathan
Quoted 56 lines · Jonathan Cameron
Quoted 5 lines · On Tue, 17 Dec 2019 08:07:31 -0600 Dan Murphy <[email protected]> wrote:
Adding the Texas Instruments single channel 16 bit DAC driver. This device has configurable voltage and current output with 16 bit resolution for offset and gain.
Signed-off-by Dan Murphy <[email protected]>Various small things inline.
Thanks,
Jonathan
Quoted 42 lines
--- drivers/iio/dac/Kconfig | 7 + drivers/iio/dac/Makefile | 1 + drivers/iio/dac/ti-dac8771.c | 499 +++++++++++++++++++++++++++++++++++ 3 files changed, 507 insertions(+)create mode 100644
drivers/iio/dac/ti-dac8771.cdrivers/iio/dac/Kconfig +7
-0@@ -386,6 +386,13 @@ config TI_DAC7612 If compiled as a module, it will be called ti-dac7612. +config TI_DAC8771 + tristate "Texas Instruments 16-bit single channel DAC driver" + depends on SPI_MASTER && GPIOLIB + help + Driver for the Texas Instruments DAC8771. + If compiled as a module, it will be called ti-dac8771. + config VF610_DAC tristate "Vybrid vf610 DAC driver" depends on OFdrivers/iio/dac/Makefile +1
-0@@ -42,4 +42,5 @@ obj-$(CONFIG_TI_DAC082S085) += ti-dac082s085.o obj-$(CONFIG_TI_DAC5571) += ti-dac5571.o obj-$(CONFIG_TI_DAC7311) += ti-dac7311.o obj-$(CONFIG_TI_DAC7612) += ti-dac7612.o +obj-$(CONFIG_TI_DAC8771) += ti-dac8771.o obj-$(CONFIG_VF610_DAC) += vf610_dac.odrivers/iio/dac/ti-dac8771.c new file +1
-0@@ -0,0 +1,499 @@ +// SPDX-License-Identifier: GPL-2.0
Quoted 8 lines
drivers/iio/dac/ti-dac8771.c line 8
Quoted 7 lines
drivers/iio/dac/ti-dac8771.c new file +7
-0+// DAC8771 DAC +// Copyright (C) 2019 Texas Instruments Incorporated - http://www.ti.com/ + +#include <linux/interrupt.h> +#include <linux/module.h> +#include <linux/gpio/consumer.h> +#include <linux/of_gpio.h> What is using
of_gpio.hin here?
Ack that can be removed.
Quoted 64 lines
Quoted 64 lines
drivers/iio/dac/ti-dac8771.c new file +64
-0+#include <linux/regulator/consumer.h> +#include <linux/spi/spi.h> + +#include <linux/iio/iio.h> +#include <linux/iio/events.h> + +#define DAC8771_RESET 0x01 +#define DAC8771_RESET_CFG 0x02 +#define DAC8771_DAC_SELECT 0x03 +#define DAC8771_DAC_CFG 0x04 +#define DAC8771_DAC_DATA 0x05 +#define DAC8771_BUCK_BOOST_SEL 0x06 +#define DAC8771_BUCK_BOOST_CFG 0x07 +#define DAC8771_CH_CAL_EN 0x08 +#define DAC8771_CH_GAIN_CAL 0x09 +#define DAC8771_CH_OFF_CAL 0x0a +#define DAC8771_STATUS 0x0b +#define DAC8771_STATUS_MSK 0x0c +#define DAC8771_ALARM_ACTION 0x0d +#define DAC8771_ALARM_CODE 0x0e +#define DAC8771_WDOG_RESET 0x10 +#define DAC8771_DEV_ID 0x11 + +#define DAC8771_RESOLUTION 16 + +/* Status register */ +#define DAC8771_OVERTEMP BIT(4) +#define DAC8771_DAC_FAULT BIT(0) +#define DAC8771_STATUS_MASK (DAC8771_OVERTEMP | DAC8771_DAC_FAULT) + +#define DAC8771_READ_EN BIT(7) + +#define DAC8771_SW_RESET BIT(0) +#define DAC8771_SPI_ENABLE 0 +#define DAC8771_SPI_DISABLE 1 + +#define DAC8771_CHA_SEL BIT(5) +#define DAC8771_OUT_RANGE_MSK GENMASK(3, 0) +#define DAC8771_MAX_GAIN_OFF 65535 + +#define DAC8771_OUT_RANGE_DEF 0x0 +#define DAC8771_OUT_RANGE_CURR_LOW 4 +#define DAC8771_OUT_RANGE_CURR_HIGH 7 +#define DAC8771_OUT_RANGE_MAX 12 + +#define DAC8771_SELECT_A BIT(0) + +/** +* struct dac8771_chip - TI DAC chip +* @lock: protects write sequences +* @vref: regulator generating Vref +* @spi: SPI device to send data to the device +* @ldac: load DAC GPIO +* @reset: reset GPIO +* @chan_type: Type of IIO channel either VOLTAGE or CURRENT +* @output_range: output range of the device +* @val: cached value +* @buf: buffer for transfer data +*/ +struct dac8771_chip { +struct mutex lock; +struct regulator *vref; +struct spi_device *spi; +struct gpio_desc *ldac;
Quoted 8 lines
drivers/iio/dac/ti-dac8771.c line 79
Quoted 7 lines
drivers/iio/dac/ti-dac8771.c new file +7
-0+struct gpio_desc *reset; +enum iio_chan_type chan_type; +u8 output_range; +u16 val; +union { +__be32 d32; +__be16 d16;Why? Only d8 seems to be used.
It was a development artifact it can be removed
Quoted 12 lines
drivers/iio/dac/ti-dac8771.c line 87
Quoted 9 lines
drivers/iio/dac/ti-dac8771.c new file +8
-0+u8 d8[3 ]; + } data[3 ]____cacheline_aligned ; +}; + +static int dac8771_write (struct dac8771_chip *dac8771, +unsigned int reg,int val) +{ +u8 data[3 ];Spi buffers need to be dma safe. Can't be on the stack because you can't force stack variables to be in a cacheline without anything else that might cause problems during dma transfers.
ok. I will need to fix the write
Quoted 11 lines
Quoted 11 lines
drivers/iio/dac/ti-dac8771.c new file +11
-0+ + data[0 ] = reg; + data[1 ] = val >>8 ; + data[2 ] = val &0xff ; + +return spi_write (dac8771->spi, &data,sizeof (data)); +} + +static int dac8771_read (struct dac8771_chip *dac8771,unsigned int reg) +{ +int ret;
Quoted 9 lines
drivers/iio/dac/ti-dac8771.c line 105
Quoted 7 lines
drivers/iio/dac/ti-dac8771.c new file +7
-0+struct spi_transfer t[] = { + { + .tx_buf = &dac8771->data[0 ].d8[0 ], + .len =3 , + .cs_change =1 , + }, { + .tx_buf = &dac8771->data[1 ].d8[0 ],I can't immediately see where anything is put into this buffer to transmit..
I will have to look into this.
The device requires some clocking NOOPs to shift the data into the buffers.
Quoted 149 lines
Quoted 135 lines
drivers/iio/dac/ti-dac8771.c new file +135
-0+ .rx_buf = &dac8771->data[2].d8[0], + .len = 3, + }, + }; + + dac8771->data[0 ].d8[0 ] = (DAC8771_READ_EN | reg); + + ret =spi_sync_transfer (dac8771->spi, t,ARRAY_SIZE (t)); +if (ret <0 ) +return ret; + +return (dac8771->data[2 ].d8[1 ] <<8 | dac8771->data[2 ].d8[2 ]); +} + +static int dac8771_sync_write (struct dac8771_chip *dac8771, +unsigned int reg,int val) +{ +int ret; + + ret =dac8771_write (dac8771, reg, val); +if (ret) +return ret; + +if (dac8771->ldac) { +gpiod_set_value (dac8771->ldac,1 ); +gpiod_set_value (dac8771->ldac,0 ); + } + +return ret; +} + +static int dac8771_reset (struct dac8771_chip *dac8771) +{ +if (dac8771->reset) { +gpiod_set_value (dac8771->reset,0 ); +gpiod_set_value (dac8771->reset,1 ); + }else { +return dac8771_sync_write (dac8771,DAC8771_RESET , +DAC8771_SW_RESET ); + } + +return 0 ; +} + +static int dac8771_update_bits (struct dac8771_chip *dac8771,unsigned int reg, +int mask,int val) +{ +int write_val; +int tmp; + + tmp =dac8771_read (dac8771, reg); +if (tmp <0 ) +return tmp; + + write_val = (tmp & ~mask); + write_val |= val & mask; + +return dac8771_write (dac8771, reg, write_val); +} + +static int dac8771_read_raw (struct iio_dev *indio_dev, +struct iio_chan_spec const *chan, +int *val,int *val2,long mask) +{ +struct dac8771_chip *dac8771 =iio_priv (indio_dev); +int ret; + +switch (mask) { +case IIO_CHAN_INFO_RAW : + *val = dac8771->val; +return IIO_VAL_INT ; +case IIO_CHAN_INFO_SCALE : + ret =regulator_get_voltage (dac8771->vref); +if (ret <0 ) +return ret; + + *val = ret /1000 ; + *val2 =DAC8771_RESOLUTION ; +return IIO_VAL_FRACTIONAL_LOG2 ; +case IIO_CHAN_INFO_OFFSET : +mutex_lock (&dac8771->lock); + ret =dac8771_read (dac8771,DAC8771_CH_OFF_CAL ); +mutex_unlock (&dac8771->lock); + +if (ret <0 ) +return ret; + + *val = ret; +return IIO_VAL_INT ; +case IIO_CHAN_INFO_HARDWAREGAIN : +mutex_lock (&dac8771->lock); + ret =dac8771_read (dac8771,DAC8771_CH_GAIN_CAL ); +mutex_unlock (&dac8771->lock); + +if (ret <0 ) +return ret; + + *val = ret; +return IIO_VAL_INT ; +default : + ret = -EINVAL ; + } + +return -EINVAL ; +} + +static int dac8771_write_raw (struct iio_dev *indio_dev, +struct iio_chan_spec const *chan, +int val,int val2,long mask) +{ +struct dac8771_chip *dac8771 =iio_priv (indio_dev); +int ret; + +switch (mask) { +case IIO_CHAN_INFO_RAW : +mutex_lock (&dac8771->lock); + ret =dac8771_sync_write (dac8771,DAC8771_DAC_DATA , val); +if (!ret) + dac8771->val = val; +break ; +case IIO_CHAN_INFO_ENABLE : +if (val) + val =DAC8771_CHA_SEL ; +else + val =0 ; + +mutex_lock (&dac8771->lock); + + ret =dac8771_update_bits (dac8771,DAC8771_DAC_SELECT , +DAC8771_CHA_SEL , val); +if (ret) + goto io_err; + + ret = dac8771_update_bits(dac8771, DAC8771_DAC_CFG, + DAC8771_OUT_RANGE_MSK,drivers/iio/dac/ti-dac8771.c line 250
Quoted 10 lines
drivers/iio/dac/ti-dac8771.c new file +10
-0+ dac8771->output_range); +break ; +case IIO_CHAN_INFO_OFFSET : +if (val >DAC8771_MAX_GAIN_OFF ) +return -EINVAL ; + +mutex_lock (&dac8771->lock); + ret =dac8771_sync_write (dac8771,DAC8771_CH_OFF_CAL , val); +break ; +case IIO_CHAN_INFO_HARDWAREGAIN :Hmm. I wouldn't expect to see hardware gain on a DAC. It has some very specific usecases, normally focused around device where the thing being measured or generated is not an amplitude (time of flight sensors for example).
Quoted 7 lines
For a dac, we would normally have
IIO_CHAN_INFO_SCALEcontrolling user visible 'gain' by specifying the value of 1LSB. We might also haveIIO_CHAN_INFO_CALIBSCALEto reflect small correction controls, usually used to compensate for manufacturing variability. So whilst they do move the output value on a DAC, the intent is this is not a general user control but more of a 'trimming control'. Given the register name of_CALI'm guessing this one should beIIO_CHAN_INFO_CALIBSCALE.
ACK. I originally had scale declared but thought HARDWARE_GAIN made more sense.
I have no issue changing it to INFO_SCALE.
Quoted 26 lines
Quoted 26 lines
drivers/iio/dac/ti-dac8771.c new file +24
-0+if (val >DAC8771_MAX_GAIN_OFF ) +return -EINVAL ; + +mutex_lock (&dac8771->lock); + ret =dac8771_sync_write (dac8771,DAC8771_CH_GAIN_CAL , val); +break ; +default : +return -EINVAL ; + } +io_err: +mutex_unlock (&dac8771->lock); +return ret; +} + +static int dac8771_write_raw_get_fmt (struct iio_dev *indio_dev, +struct iio_chan_spec const *chan,long mask) +{ +return IIO_VAL_INT ; +} + +static irqreturn_t dac8771_event_handler (int irq,void *private) +{ +struct iio_dev *indio_dev = private; +struct dac8771_chip *dac8771 =iio_priv (indio_dev);
Quoted 8 lines
drivers/iio/dac/ti-dac8771.c line 281
Quoted 7 lines
drivers/iio/dac/ti-dac8771.c new file +7
-0+int clear_bits =0 ; +int ret; + + ret =dac8771_read (dac8771,DAC8771_STATUS ); + +if (ret &DAC8771_OVERTEMP ) { + iio_push_event(private,Given you have a local
indio_devvariable, nicer to use that than private.
ACK
Quoted 14 lines
drivers/iio/dac/ti-dac8771.c line 292
Quoted 12 lines
drivers/iio/dac/ti-dac8771.c new file +11
-0+IIO_UNMOD_EVENT_CODE (IIO_TEMP , +0 ,IIO_EV_TYPE_THRESH ,IIO_EV_DIR_RISING ), + iio_get_time_ns(private)); + clear_bits =DAC8771_OVERTEMP ; + } + +if (ret &DAC8771_DAC_FAULT ) { +iio_push_event (private, +IIO_UNMOD_EVENT_CODE (dac8771->chan_type, +0 ,IIO_EV_TYPE_CHANGE ,IIO_EV_DIR_NONE ), +iio_get_time_ns (private));We need some more discussion on why this event is done like this. What does it signify? Would userspace expect to get it this way?
Unfortunately this is how the data sheet declares this fault just as DAC Fault.
It is a generic fault condition unlike the TMP fault above.
Quoted 131 lines
In general, provision for fault cases is poor, at least partly because, every now and then there is discussion on how to report hardware errors like this in general across the kernel, but no good answer has ever being figured out.
Quoted 113 lines
drivers/iio/dac/ti-dac8771.c new file +113
-0+ + clear_bits |=DAC8771_DAC_FAULT ; + } + + ret =dac8771_update_bits (dac8771,DAC8771_STATUS ,DAC8771_STATUS_MASK , + clear_bits); +if (ret) +dev_err (&dac8771->spi->dev, +"Failed to clear status register\n" ); + +return IRQ_HANDLED ; +} + +static const struct iio_info dac8771_info = { + .read_raw = dac8771_read_raw, + .write_raw = dac8771_write_raw, + .write_raw_get_fmt = dac8771_write_raw_get_fmt, +}; + +static int dac8771_probe_dt (struct dac8771_chip *dac8771) +{ +u32 range; +int ret; + + dac8771->ldac =devm_gpiod_get_optional (&dac8771->spi->dev,"loaddacs" , +GPIOD_OUT_HIGH ); +if (IS_ERR (dac8771->ldac)) { + ret =PTR_ERR (dac8771->ldac); +if (ret != -ENODEV ) { +if (ret != -EPROBE_DEFER ) +dev_err (&dac8771->spi->dev, +"Failed to get loaddacs gpio: %d\n" , + ret); +return ret; + } + dac8771->ldac =NULL ; + } + + dac8771->reset =devm_gpiod_get_optional (&dac8771->spi->dev,"reset" , +GPIOD_OUT_HIGH ); +if (IS_ERR (dac8771->reset)) { + ret =PTR_ERR (dac8771->reset); +if (ret != -ENODEV ) { +if (ret != -EPROBE_DEFER ) +dev_err (&dac8771->spi->dev, +"Failed to get reset gpio: %d\n" , + ret); +return ret; + } + dac8771->reset =NULL ; + } + + ret =device_property_read_u32 (&dac8771->spi->dev,"ti,output-range" , + &range); +if (ret) { +dev_err (&dac8771->spi->dev, +"Output range is not set using default\n" ); + range =DAC8771_OUT_RANGE_DEF ; + }else { +if (dac8771->output_range <DAC8771_OUT_RANGE_DEF || + dac8771->output_range >DAC8771_OUT_RANGE_MAX ) { +dev_err (&dac8771->spi->dev, +"Output range is invalid\n" ); +return -EINVAL ; + } + } + + dac8771->output_range = range; +if ((dac8771->output_range >=DAC8771_OUT_RANGE_CURR_LOW && + dac8771->output_range <=DAC8771_OUT_RANGE_CURR_HIGH ) || + dac8771->output_range ==DAC8771_OUT_RANGE_MAX ) + dac8771->chan_type =IIO_CURRENT ; +else + dac8771->chan_type =IIO_VOLTAGE ; + +return 0 ; +} + +static int dac8771_init (struct dac8771_chip *dac8771) +{ +int ret; + + ret =dac8771_reset (dac8771); +if (ret) +return ret; + +return dac8771_write (dac8771,DAC8771_BUCK_BOOST_SEL ,DAC8771_SELECT_A ); +} + +static int dac8771_probe (struct spi_device *spi) +{ +struct device *dev = &spi->dev; +struct dac8771_chip *dac8771; +struct iio_dev *indio_dev; +struct iio_chan_spec *chan; +int ret; + + indio_dev =devm_iio_device_alloc (dev,sizeof (*dac8771)); +if (!indio_dev) { +dev_err (dev,"can not allocate iio device\n" ); +return -ENOMEM ; + } + + spi->mode =SPI_MODE_2 ; +spi_setup (spi); +spi_set_drvdata (spi, indio_dev); + + dac8771 =iio_priv (indio_dev); + dac8771->spi = spi; + + ret =dac8771_probe_dt (dac8771); +if (ret) +return ret;drivers/iio/dac/ti-dac8771.c line 415
Quoted 10 lines
drivers/iio/dac/ti-dac8771.c new file +10
-0+ + indio_dev->dev.parent = dev; + indio_dev->dev.of_node = spi->dev.of_node; + indio_dev->info = &dac8771_info; + indio_dev->name =spi_get_device_id (spi)->name; + indio_dev->modes =INDIO_DIRECT_MODE ; + indio_dev->num_channels =1 ; + + chan =devm_kzalloc (&indio_dev->dev,sizeof (struct iio_chan_spec ), +GFP_KERNEL );If it's always the same size, why not embed it in the dac8711 structure? Will avoid the need for an extra allocation.
Quoted 5 lines
drivers/iio/dac/ti-dac8771.c line 417
Quoted 2 lines
drivers/iio/dac/ti-dac8771.c new file +2
-0+ + chan->type = dac8771->chan_type;As there are only two types (I think!) I'd prefer to see this done as a pick between two static const structures rather than via dynamic setup.
There are only two types VOLTAGE and CURRENT which is determined by the DAC configuration register.
This is passed in via the binding to control what type of channel it is and setup the appropriate RANGE of the output.
So I can do a static const structure that passes in the chan_type to setup the correct channel type since the other values are constant.
Quoted 16 lines
drivers/iio/dac/ti-dac8771.c line 429
Quoted 13 lines
drivers/iio/dac/ti-dac8771.c new file +12
-0+ chan->channel =0 ; + chan->output = true; + chan->info_mask_shared_by_type =BIT (IIO_CHAN_INFO_SCALE ); + chan->info_mask_separate =BIT (IIO_CHAN_INFO_RAW ) | +BIT (IIO_CHAN_INFO_OFFSET ) | +BIT (IIO_CHAN_INFO_HARDWAREGAIN ) | +BIT (IIO_CHAN_INFO_ENABLE ) | +BIT (IIO_CHAN_INFO_SCALE ); + + indio_dev->channels = chan; + + dac8771->vref =devm_regulator_get (&dac8771->spi->dev,"vref" );A quick glance at the datasheet suggests this device can be used with an internal reference? Ideally we'd support that by making the provision of a vref regulator optional.
Ack. Missed that.
Quoted 3 lines
It also seems that there are a number of other power supplies that should be in the dt bindings even if not yet supported by the driver
This is true. I did not have the current need to manage those additional supplies.
I think you are referring to AVDD, DVDD and PVDD.
Quoted 45 lines
.
Quoted 18 lines
drivers/iio/dac/ti-dac8771.c new file +18
-0+if (IS_ERR (dac8771->vref)) { +dev_err (&dac8771->spi->dev,"error to get regulator\n" ); +return PTR_ERR (dac8771->vref); + } + + ret =regulator_enable (dac8771->vref); +if (ret <0 ) { +dev_err (dev,"can not enable regulator\n" ); +return ret; + } + +mutex_init (&dac8771->lock); + +if (spi->irq) { + ret = devm_request_threaded_irq(&spi->dev, spi->irq, NULL, + &dac8771_event_handler, + IRQF_TRIGGER_FALLING | IRQF_ONESHOT, + spi_get_device_id(dac8771->spi)->name,drivers/iio/dac/ti-dac8771.c line 457
Quoted 10 lines
drivers/iio/dac/ti-dac8771.c new file +10
-0+ indio_dev); +if (ret) + goto err; + } + + ret =dac8771_init (dac8771); +if (ret) + goto err; + +return devm_iio_device_register (&spi->dev, indio_dev);You can't safely mix managed and unmanaged code like this.
By the time the userspace interfacs are removed as a result of the equivalent of
iio_device_unregisterbeing called as the device managed code unwinds, we will have turned the reference voltage off. Any readings that happen to occur in that narrow window will get unpredictable results.One option for that is to use
devm_add_action_or_resetto register an additional unwind function to deal with the regulator disable in the remove path. The argument for not having adevm_regulator_enablehas been that it is almost always desirable to turn regulators off in other paths (suspend or runtime suspend) so normally it doesn't make that much sense to have a general always approach.
Quoted 4 lines
Note we hardly ever bother with
mutex_destroyas it is only for debug purposes and usually only relevant if complex handling is going on within the driver. For that reason I guess, no one has ever bothered with adevm_mutex_init().
Ack
Dan