123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513 |
- // SPDX-License-Identifier: GPL-2.0-only
- /*
- * ADRF6780 driver
- *
- * Copyright 2021 Analog Devices Inc.
- */
- #include <linux/bitfield.h>
- #include <linux/bits.h>
- #include <linux/clk.h>
- #include <linux/clkdev.h>
- #include <linux/clk-provider.h>
- #include <linux/delay.h>
- #include <linux/device.h>
- #include <linux/iio/iio.h>
- #include <linux/module.h>
- #include <linux/mod_devicetable.h>
- #include <linux/spi/spi.h>
- #include <asm/unaligned.h>
- /* ADRF6780 Register Map */
- #define ADRF6780_REG_CONTROL 0x00
- #define ADRF6780_REG_ALARM_READBACK 0x01
- #define ADRF6780_REG_ALARM_MASKS 0x02
- #define ADRF6780_REG_ENABLE 0x03
- #define ADRF6780_REG_LINEARIZE 0x04
- #define ADRF6780_REG_LO_PATH 0x05
- #define ADRF6780_REG_ADC_CONTROL 0x06
- #define ADRF6780_REG_ADC_OUTPUT 0x0C
- /* ADRF6780_REG_CONTROL Map */
- #define ADRF6780_PARITY_EN_MSK BIT(15)
- #define ADRF6780_SOFT_RESET_MSK BIT(14)
- #define ADRF6780_CHIP_ID_MSK GENMASK(11, 4)
- #define ADRF6780_CHIP_ID 0xA
- #define ADRF6780_CHIP_REVISION_MSK GENMASK(3, 0)
- /* ADRF6780_REG_ALARM_READBACK Map */
- #define ADRF6780_PARITY_ERROR_MSK BIT(15)
- #define ADRF6780_TOO_FEW_ERRORS_MSK BIT(14)
- #define ADRF6780_TOO_MANY_ERRORS_MSK BIT(13)
- #define ADRF6780_ADDRESS_RANGE_ERROR_MSK BIT(12)
- /* ADRF6780_REG_ENABLE Map */
- #define ADRF6780_VGA_BUFFER_EN_MSK BIT(8)
- #define ADRF6780_DETECTOR_EN_MSK BIT(7)
- #define ADRF6780_LO_BUFFER_EN_MSK BIT(6)
- #define ADRF6780_IF_MODE_EN_MSK BIT(5)
- #define ADRF6780_IQ_MODE_EN_MSK BIT(4)
- #define ADRF6780_LO_X2_EN_MSK BIT(3)
- #define ADRF6780_LO_PPF_EN_MSK BIT(2)
- #define ADRF6780_LO_EN_MSK BIT(1)
- #define ADRF6780_UC_BIAS_EN_MSK BIT(0)
- /* ADRF6780_REG_LINEARIZE Map */
- #define ADRF6780_RDAC_LINEARIZE_MSK GENMASK(7, 0)
- /* ADRF6780_REG_LO_PATH Map */
- #define ADRF6780_LO_SIDEBAND_MSK BIT(10)
- #define ADRF6780_Q_PATH_PHASE_ACCURACY_MSK GENMASK(7, 4)
- #define ADRF6780_I_PATH_PHASE_ACCURACY_MSK GENMASK(3, 0)
- /* ADRF6780_REG_ADC_CONTROL Map */
- #define ADRF6780_VDET_OUTPUT_SELECT_MSK BIT(3)
- #define ADRF6780_ADC_START_MSK BIT(2)
- #define ADRF6780_ADC_EN_MSK BIT(1)
- #define ADRF6780_ADC_CLOCK_EN_MSK BIT(0)
- /* ADRF6780_REG_ADC_OUTPUT Map */
- #define ADRF6780_ADC_STATUS_MSK BIT(8)
- #define ADRF6780_ADC_VALUE_MSK GENMASK(7, 0)
- struct adrf6780_state {
- struct spi_device *spi;
- struct clk *clkin;
- /* Protect against concurrent accesses to the device */
- struct mutex lock;
- bool vga_buff_en;
- bool lo_buff_en;
- bool if_mode_en;
- bool iq_mode_en;
- bool lo_x2_en;
- bool lo_ppf_en;
- bool lo_en;
- bool uc_bias_en;
- bool lo_sideband;
- bool vdet_out_en;
- u8 data[3] __aligned(IIO_DMA_MINALIGN);
- };
- static int __adrf6780_spi_read(struct adrf6780_state *st, unsigned int reg,
- unsigned int *val)
- {
- int ret;
- struct spi_transfer t = {0};
- st->data[0] = 0x80 | (reg << 1);
- st->data[1] = 0x0;
- st->data[2] = 0x0;
- t.rx_buf = &st->data[0];
- t.tx_buf = &st->data[0];
- t.len = 3;
- ret = spi_sync_transfer(st->spi, &t, 1);
- if (ret)
- return ret;
- *val = (get_unaligned_be24(&st->data[0]) >> 1) & GENMASK(15, 0);
- return ret;
- }
- static int adrf6780_spi_read(struct adrf6780_state *st, unsigned int reg,
- unsigned int *val)
- {
- int ret;
- mutex_lock(&st->lock);
- ret = __adrf6780_spi_read(st, reg, val);
- mutex_unlock(&st->lock);
- return ret;
- }
- static int __adrf6780_spi_write(struct adrf6780_state *st,
- unsigned int reg,
- unsigned int val)
- {
- put_unaligned_be24((val << 1) | (reg << 17), &st->data[0]);
- return spi_write(st->spi, &st->data[0], 3);
- }
- static int adrf6780_spi_write(struct adrf6780_state *st, unsigned int reg,
- unsigned int val)
- {
- int ret;
- mutex_lock(&st->lock);
- ret = __adrf6780_spi_write(st, reg, val);
- mutex_unlock(&st->lock);
- return ret;
- }
- static int __adrf6780_spi_update_bits(struct adrf6780_state *st,
- unsigned int reg, unsigned int mask,
- unsigned int val)
- {
- int ret;
- unsigned int data, temp;
- ret = __adrf6780_spi_read(st, reg, &data);
- if (ret)
- return ret;
- temp = (data & ~mask) | (val & mask);
- return __adrf6780_spi_write(st, reg, temp);
- }
- static int adrf6780_spi_update_bits(struct adrf6780_state *st, unsigned int reg,
- unsigned int mask, unsigned int val)
- {
- int ret;
- mutex_lock(&st->lock);
- ret = __adrf6780_spi_update_bits(st, reg, mask, val);
- mutex_unlock(&st->lock);
- return ret;
- }
- static int adrf6780_read_adc_raw(struct adrf6780_state *st, unsigned int *read_val)
- {
- int ret;
- mutex_lock(&st->lock);
- ret = __adrf6780_spi_update_bits(st, ADRF6780_REG_ADC_CONTROL,
- ADRF6780_ADC_EN_MSK |
- ADRF6780_ADC_CLOCK_EN_MSK |
- ADRF6780_ADC_START_MSK,
- FIELD_PREP(ADRF6780_ADC_EN_MSK, 1) |
- FIELD_PREP(ADRF6780_ADC_CLOCK_EN_MSK, 1) |
- FIELD_PREP(ADRF6780_ADC_START_MSK, 1));
- if (ret)
- goto exit;
- /* Recommended delay for the ADC to be ready*/
- usleep_range(200, 250);
- ret = __adrf6780_spi_read(st, ADRF6780_REG_ADC_OUTPUT, read_val);
- if (ret)
- goto exit;
- if (!(*read_val & ADRF6780_ADC_STATUS_MSK)) {
- ret = -EINVAL;
- goto exit;
- }
- ret = __adrf6780_spi_update_bits(st, ADRF6780_REG_ADC_CONTROL,
- ADRF6780_ADC_START_MSK,
- FIELD_PREP(ADRF6780_ADC_START_MSK, 0));
- if (ret)
- goto exit;
- ret = __adrf6780_spi_read(st, ADRF6780_REG_ADC_OUTPUT, read_val);
- exit:
- mutex_unlock(&st->lock);
- return ret;
- }
- static int adrf6780_read_raw(struct iio_dev *indio_dev,
- struct iio_chan_spec const *chan,
- int *val, int *val2, long info)
- {
- struct adrf6780_state *dev = iio_priv(indio_dev);
- unsigned int data;
- int ret;
- switch (info) {
- case IIO_CHAN_INFO_RAW:
- ret = adrf6780_read_adc_raw(dev, &data);
- if (ret)
- return ret;
- *val = data & ADRF6780_ADC_VALUE_MSK;
- return IIO_VAL_INT;
- case IIO_CHAN_INFO_SCALE:
- ret = adrf6780_spi_read(dev, ADRF6780_REG_LINEARIZE, &data);
- if (ret)
- return ret;
- *val = data & ADRF6780_RDAC_LINEARIZE_MSK;
- return IIO_VAL_INT;
- case IIO_CHAN_INFO_PHASE:
- ret = adrf6780_spi_read(dev, ADRF6780_REG_LO_PATH, &data);
- if (ret)
- return ret;
- switch (chan->channel2) {
- case IIO_MOD_I:
- *val = data & ADRF6780_I_PATH_PHASE_ACCURACY_MSK;
- return IIO_VAL_INT;
- case IIO_MOD_Q:
- *val = FIELD_GET(ADRF6780_Q_PATH_PHASE_ACCURACY_MSK,
- data);
- return IIO_VAL_INT;
- default:
- return -EINVAL;
- }
- default:
- return -EINVAL;
- }
- }
- static int adrf6780_write_raw(struct iio_dev *indio_dev,
- struct iio_chan_spec const *chan,
- int val, int val2, long info)
- {
- struct adrf6780_state *st = iio_priv(indio_dev);
- switch (info) {
- case IIO_CHAN_INFO_SCALE:
- return adrf6780_spi_write(st, ADRF6780_REG_LINEARIZE, val);
- case IIO_CHAN_INFO_PHASE:
- switch (chan->channel2) {
- case IIO_MOD_I:
- return adrf6780_spi_update_bits(st,
- ADRF6780_REG_LO_PATH,
- ADRF6780_I_PATH_PHASE_ACCURACY_MSK,
- FIELD_PREP(ADRF6780_I_PATH_PHASE_ACCURACY_MSK, val));
- case IIO_MOD_Q:
- return adrf6780_spi_update_bits(st,
- ADRF6780_REG_LO_PATH,
- ADRF6780_Q_PATH_PHASE_ACCURACY_MSK,
- FIELD_PREP(ADRF6780_Q_PATH_PHASE_ACCURACY_MSK, val));
- default:
- return -EINVAL;
- }
- default:
- return -EINVAL;
- }
- }
- static int adrf6780_reg_access(struct iio_dev *indio_dev,
- unsigned int reg,
- unsigned int write_val,
- unsigned int *read_val)
- {
- struct adrf6780_state *st = iio_priv(indio_dev);
- if (read_val)
- return adrf6780_spi_read(st, reg, read_val);
- else
- return adrf6780_spi_write(st, reg, write_val);
- }
- static const struct iio_info adrf6780_info = {
- .read_raw = adrf6780_read_raw,
- .write_raw = adrf6780_write_raw,
- .debugfs_reg_access = &adrf6780_reg_access,
- };
- #define ADRF6780_CHAN_ADC(_channel) { \
- .type = IIO_ALTVOLTAGE, \
- .output = 0, \
- .indexed = 1, \
- .channel = _channel, \
- .info_mask_separate = BIT(IIO_CHAN_INFO_RAW) \
- }
- #define ADRF6780_CHAN_RDAC(_channel) { \
- .type = IIO_ALTVOLTAGE, \
- .output = 1, \
- .indexed = 1, \
- .channel = _channel, \
- .info_mask_separate = BIT(IIO_CHAN_INFO_SCALE) \
- }
- #define ADRF6780_CHAN_IQ_PHASE(_channel, rf_comp) { \
- .type = IIO_ALTVOLTAGE, \
- .modified = 1, \
- .output = 1, \
- .indexed = 1, \
- .channel2 = IIO_MOD_##rf_comp, \
- .channel = _channel, \
- .info_mask_separate = BIT(IIO_CHAN_INFO_PHASE) \
- }
- static const struct iio_chan_spec adrf6780_channels[] = {
- ADRF6780_CHAN_ADC(0),
- ADRF6780_CHAN_RDAC(0),
- ADRF6780_CHAN_IQ_PHASE(0, I),
- ADRF6780_CHAN_IQ_PHASE(0, Q),
- };
- static int adrf6780_reset(struct adrf6780_state *st)
- {
- int ret;
- struct spi_device *spi = st->spi;
- ret = __adrf6780_spi_update_bits(st, ADRF6780_REG_CONTROL,
- ADRF6780_SOFT_RESET_MSK,
- FIELD_PREP(ADRF6780_SOFT_RESET_MSK, 1));
- if (ret) {
- dev_err(&spi->dev, "ADRF6780 SPI software reset failed.\n");
- return ret;
- }
- ret = __adrf6780_spi_update_bits(st, ADRF6780_REG_CONTROL,
- ADRF6780_SOFT_RESET_MSK,
- FIELD_PREP(ADRF6780_SOFT_RESET_MSK, 0));
- if (ret) {
- dev_err(&spi->dev, "ADRF6780 SPI software reset disable failed.\n");
- return ret;
- }
- return 0;
- }
- static int adrf6780_init(struct adrf6780_state *st)
- {
- int ret;
- unsigned int chip_id, enable_reg, enable_reg_msk;
- struct spi_device *spi = st->spi;
- /* Perform a software reset */
- ret = adrf6780_reset(st);
- if (ret)
- return ret;
- ret = __adrf6780_spi_read(st, ADRF6780_REG_CONTROL, &chip_id);
- if (ret)
- return ret;
- chip_id = FIELD_GET(ADRF6780_CHIP_ID_MSK, chip_id);
- if (chip_id != ADRF6780_CHIP_ID) {
- dev_err(&spi->dev, "ADRF6780 Invalid Chip ID.\n");
- return -EINVAL;
- }
- enable_reg_msk = ADRF6780_VGA_BUFFER_EN_MSK |
- ADRF6780_DETECTOR_EN_MSK |
- ADRF6780_LO_BUFFER_EN_MSK |
- ADRF6780_IF_MODE_EN_MSK |
- ADRF6780_IQ_MODE_EN_MSK |
- ADRF6780_LO_X2_EN_MSK |
- ADRF6780_LO_PPF_EN_MSK |
- ADRF6780_LO_EN_MSK |
- ADRF6780_UC_BIAS_EN_MSK;
- enable_reg = FIELD_PREP(ADRF6780_VGA_BUFFER_EN_MSK, st->vga_buff_en) |
- FIELD_PREP(ADRF6780_DETECTOR_EN_MSK, 1) |
- FIELD_PREP(ADRF6780_LO_BUFFER_EN_MSK, st->lo_buff_en) |
- FIELD_PREP(ADRF6780_IF_MODE_EN_MSK, st->if_mode_en) |
- FIELD_PREP(ADRF6780_IQ_MODE_EN_MSK, st->iq_mode_en) |
- FIELD_PREP(ADRF6780_LO_X2_EN_MSK, st->lo_x2_en) |
- FIELD_PREP(ADRF6780_LO_PPF_EN_MSK, st->lo_ppf_en) |
- FIELD_PREP(ADRF6780_LO_EN_MSK, st->lo_en) |
- FIELD_PREP(ADRF6780_UC_BIAS_EN_MSK, st->uc_bias_en);
- ret = __adrf6780_spi_update_bits(st, ADRF6780_REG_ENABLE,
- enable_reg_msk, enable_reg);
- if (ret)
- return ret;
- ret = __adrf6780_spi_update_bits(st, ADRF6780_REG_LO_PATH,
- ADRF6780_LO_SIDEBAND_MSK,
- FIELD_PREP(ADRF6780_LO_SIDEBAND_MSK, st->lo_sideband));
- if (ret)
- return ret;
- return __adrf6780_spi_update_bits(st, ADRF6780_REG_ADC_CONTROL,
- ADRF6780_VDET_OUTPUT_SELECT_MSK,
- FIELD_PREP(ADRF6780_VDET_OUTPUT_SELECT_MSK, st->vdet_out_en));
- }
- static void adrf6780_properties_parse(struct adrf6780_state *st)
- {
- struct spi_device *spi = st->spi;
- st->vga_buff_en = device_property_read_bool(&spi->dev, "adi,vga-buff-en");
- st->lo_buff_en = device_property_read_bool(&spi->dev, "adi,lo-buff-en");
- st->if_mode_en = device_property_read_bool(&spi->dev, "adi,if-mode-en");
- st->iq_mode_en = device_property_read_bool(&spi->dev, "adi,iq-mode-en");
- st->lo_x2_en = device_property_read_bool(&spi->dev, "adi,lo-x2-en");
- st->lo_ppf_en = device_property_read_bool(&spi->dev, "adi,lo-ppf-en");
- st->lo_en = device_property_read_bool(&spi->dev, "adi,lo-en");
- st->uc_bias_en = device_property_read_bool(&spi->dev, "adi,uc-bias-en");
- st->lo_sideband = device_property_read_bool(&spi->dev, "adi,lo-sideband");
- st->vdet_out_en = device_property_read_bool(&spi->dev, "adi,vdet-out-en");
- }
- static void adrf6780_powerdown(void *data)
- {
- /* Disable all components in the Enable Register */
- adrf6780_spi_write(data, ADRF6780_REG_ENABLE, 0x0);
- }
- static int adrf6780_probe(struct spi_device *spi)
- {
- struct iio_dev *indio_dev;
- struct adrf6780_state *st;
- int ret;
- indio_dev = devm_iio_device_alloc(&spi->dev, sizeof(*st));
- if (!indio_dev)
- return -ENOMEM;
- st = iio_priv(indio_dev);
- indio_dev->info = &adrf6780_info;
- indio_dev->name = "adrf6780";
- indio_dev->channels = adrf6780_channels;
- indio_dev->num_channels = ARRAY_SIZE(adrf6780_channels);
- st->spi = spi;
- adrf6780_properties_parse(st);
- st->clkin = devm_clk_get_enabled(&spi->dev, "lo_in");
- if (IS_ERR(st->clkin))
- return dev_err_probe(&spi->dev, PTR_ERR(st->clkin),
- "failed to get the LO input clock\n");
- mutex_init(&st->lock);
- ret = adrf6780_init(st);
- if (ret)
- return ret;
- ret = devm_add_action_or_reset(&spi->dev, adrf6780_powerdown, st);
- if (ret)
- return ret;
- return devm_iio_device_register(&spi->dev, indio_dev);
- }
- static const struct spi_device_id adrf6780_id[] = {
- { "adrf6780", 0 },
- {}
- };
- MODULE_DEVICE_TABLE(spi, adrf6780_id);
- static const struct of_device_id adrf6780_of_match[] = {
- { .compatible = "adi,adrf6780" },
- {}
- };
- MODULE_DEVICE_TABLE(of, adrf6780_of_match);
- static struct spi_driver adrf6780_driver = {
- .driver = {
- .name = "adrf6780",
- .of_match_table = adrf6780_of_match,
- },
- .probe = adrf6780_probe,
- .id_table = adrf6780_id,
- };
- module_spi_driver(adrf6780_driver);
- MODULE_AUTHOR("Antoniu Miclaus <[email protected]");
- MODULE_DESCRIPTION("Analog Devices ADRF6780");
- MODULE_LICENSE("GPL v2");
|