^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1) // SPDX-License-Identifier: GPL-2.0-or-later
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2) /*
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 3) * max517.c - Support for Maxim MAX517, MAX518 and MAX519
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 4) *
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 5) * Copyright (C) 2010, 2011 Roland Stigge <stigge@antcom.de>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 6) */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 7)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 8) #include <linux/module.h>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 9) #include <linux/slab.h>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 10) #include <linux/jiffies.h>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 11) #include <linux/i2c.h>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 12) #include <linux/err.h>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 13)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 14) #include <linux/iio/iio.h>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 15) #include <linux/iio/sysfs.h>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 16) #include <linux/iio/dac/max517.h>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 17)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 18) #define MAX517_DRV_NAME "max517"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 19)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 20) /* Commands */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 21) #define COMMAND_CHANNEL0 0x00
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 22) #define COMMAND_CHANNEL1 0x01 /* for MAX518 and MAX519 */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 23) #define COMMAND_PD 0x08 /* Power Down */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 24)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 25) enum max517_device_ids {
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 26) ID_MAX517,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 27) ID_MAX518,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 28) ID_MAX519,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 29) ID_MAX520,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 30) ID_MAX521,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 31) };
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 32)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 33) struct max517_data {
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 34) struct i2c_client *client;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 35) unsigned short vref_mv[8];
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 36) };
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 37)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 38) /*
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 39) * channel: bit 0: channel 1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 40) * bit 1: channel 2
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 41) * (this way, it's possible to set both channels at once)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 42) */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 43) static int max517_set_value(struct iio_dev *indio_dev,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 44) long val, int channel)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 45) {
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 46) struct max517_data *data = iio_priv(indio_dev);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 47) struct i2c_client *client = data->client;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 48) u8 outbuf[2];
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 49) int res;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 50)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 51) if (val < 0 || val > 255)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 52) return -EINVAL;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 53)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 54) outbuf[0] = channel;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 55) outbuf[1] = val;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 56)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 57) res = i2c_master_send(client, outbuf, 2);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 58) if (res < 0)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 59) return res;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 60) else if (res != 2)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 61) return -EIO;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 62) else
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 63) return 0;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 64) }
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 65)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 66) static int max517_read_raw(struct iio_dev *indio_dev,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 67) struct iio_chan_spec const *chan,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 68) int *val,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 69) int *val2,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 70) long m)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 71) {
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 72) struct max517_data *data = iio_priv(indio_dev);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 73)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 74) switch (m) {
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 75) case IIO_CHAN_INFO_SCALE:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 76) /* Corresponds to Vref / 2^(bits) */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 77) *val = data->vref_mv[chan->channel];
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 78) *val2 = 8;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 79) return IIO_VAL_FRACTIONAL_LOG2;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 80) default:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 81) break;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 82) }
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 83) return -EINVAL;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 84) }
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 85)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 86) static int max517_write_raw(struct iio_dev *indio_dev,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 87) struct iio_chan_spec const *chan, int val, int val2, long mask)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 88) {
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 89) int ret;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 90)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 91) switch (mask) {
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 92) case IIO_CHAN_INFO_RAW:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 93) ret = max517_set_value(indio_dev, val, chan->channel);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 94) break;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 95) default:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 96) ret = -EINVAL;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 97) break;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 98) }
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 99)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 100) return ret;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 101) }
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 102)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 103) static int __maybe_unused max517_suspend(struct device *dev)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 104) {
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 105) u8 outbuf = COMMAND_PD;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 106)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 107) return i2c_master_send(to_i2c_client(dev), &outbuf, 1);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 108) }
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 109)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 110) static int __maybe_unused max517_resume(struct device *dev)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 111) {
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 112) u8 outbuf = 0;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 113)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 114) return i2c_master_send(to_i2c_client(dev), &outbuf, 1);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 115) }
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 116)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 117) static SIMPLE_DEV_PM_OPS(max517_pm_ops, max517_suspend, max517_resume);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 118)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 119) static const struct iio_info max517_info = {
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 120) .read_raw = max517_read_raw,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 121) .write_raw = max517_write_raw,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 122) };
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 123)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 124) #define MAX517_CHANNEL(chan) { \
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 125) .type = IIO_VOLTAGE, \
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 126) .indexed = 1, \
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 127) .output = 1, \
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 128) .channel = (chan), \
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 129) .info_mask_separate = BIT(IIO_CHAN_INFO_RAW) | \
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 130) BIT(IIO_CHAN_INFO_SCALE), \
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 131) }
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 132)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 133) static const struct iio_chan_spec max517_channels[] = {
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 134) MAX517_CHANNEL(0),
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 135) MAX517_CHANNEL(1),
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 136) MAX517_CHANNEL(2),
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 137) MAX517_CHANNEL(3),
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 138) MAX517_CHANNEL(4),
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 139) MAX517_CHANNEL(5),
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 140) MAX517_CHANNEL(6),
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 141) MAX517_CHANNEL(7),
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 142) };
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 143)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 144) static int max517_probe(struct i2c_client *client,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 145) const struct i2c_device_id *id)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 146) {
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 147) struct max517_data *data;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 148) struct iio_dev *indio_dev;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 149) struct max517_platform_data *platform_data = client->dev.platform_data;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 150) int chan;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 151)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 152) indio_dev = devm_iio_device_alloc(&client->dev, sizeof(*data));
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 153) if (!indio_dev)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 154) return -ENOMEM;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 155) data = iio_priv(indio_dev);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 156) i2c_set_clientdata(client, indio_dev);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 157) data->client = client;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 158)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 159) switch (id->driver_data) {
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 160) case ID_MAX521:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 161) indio_dev->num_channels = 8;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 162) break;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 163) case ID_MAX520:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 164) indio_dev->num_channels = 4;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 165) break;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 166) case ID_MAX519:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 167) case ID_MAX518:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 168) indio_dev->num_channels = 2;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 169) break;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 170) default: /* single channel for MAX517 */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 171) indio_dev->num_channels = 1;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 172) break;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 173) }
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 174) indio_dev->channels = max517_channels;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 175) indio_dev->modes = INDIO_DIRECT_MODE;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 176) indio_dev->info = &max517_info;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 177)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 178) /*
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 179) * Reference voltage on MAX518 and default is 5V, else take vref_mv
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 180) * from platform_data
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 181) */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 182) for (chan = 0; chan < indio_dev->num_channels; chan++) {
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 183) if (id->driver_data == ID_MAX518 || !platform_data)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 184) data->vref_mv[chan] = 5000; /* mV */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 185) else
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 186) data->vref_mv[chan] = platform_data->vref_mv[chan];
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 187) }
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 188)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 189) return iio_device_register(indio_dev);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 190) }
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 191)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 192) static int max517_remove(struct i2c_client *client)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 193) {
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 194) iio_device_unregister(i2c_get_clientdata(client));
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 195) return 0;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 196) }
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 197)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 198) static const struct i2c_device_id max517_id[] = {
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 199) { "max517", ID_MAX517 },
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 200) { "max518", ID_MAX518 },
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 201) { "max519", ID_MAX519 },
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 202) { "max520", ID_MAX520 },
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 203) { "max521", ID_MAX521 },
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 204) { }
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 205) };
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 206) MODULE_DEVICE_TABLE(i2c, max517_id);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 207)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 208) static struct i2c_driver max517_driver = {
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 209) .driver = {
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 210) .name = MAX517_DRV_NAME,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 211) .pm = &max517_pm_ops,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 212) },
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 213) .probe = max517_probe,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 214) .remove = max517_remove,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 215) .id_table = max517_id,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 216) };
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 217) module_i2c_driver(max517_driver);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 218)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 219) MODULE_AUTHOR("Roland Stigge <stigge@antcom.de>");
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 220) MODULE_DESCRIPTION("MAX517/518/519/520/521 8-bit DAC");
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 221) MODULE_LICENSE("GPL");