// SPDX-License-Identifier: GPL-2.0-only /* * Analog Devices AD3552R * Digital to Analog converter driver, High Speed version * * Copyright 2024 Analog Devices Inc.
*/
/* * Important notes for register map access: * ======================================== * * Register address space is divided in 2 regions, primary (config) and * secondary (DAC). Primary region can only be accessed in simple SPI mode, * with exception for ad355x models where setting QSPI pin high allows QSPI * access to both the regions. * * Due to the fact that ad3541/2r do not implement QSPI, for proper device * detection, HDL keeps "QSPI" pin level low at boot (see ad3552r manual, rev B * table 7, pin 31, digital input). For this reason, actually the working mode * between SPI, DSPI and QSPI must be set via software, configuring the target * DAC appropriately, together with the backend API to configure the bus mode * accordingly. * * Also, important to note that none of the three modes allow to read in DDR. * * In non-buffering operations, mode is set to simple SPI SDR for all primary * and secondary region r/w accesses, to avoid to switch the mode each time DAC * register is accessed (raw accesses, r/w), and to be able to dump registers * content (possible as non DDR only). * In buffering mode, driver sets best possible mode, D/QSPI and DDR.
*/
staticint ad3552r_hs_read_raw(struct iio_dev *indio_dev, struct iio_chan_spec const *chan, int *val, int *val2, long mask)
{ struct ad3552r_hs_state *st = iio_priv(indio_dev); int ret; int ch = chan->channel;
switch (mask) { case IIO_CHAN_INFO_SAMP_FREQ: /* * Using a "num_spi_data_lanes" variable since ad3541/2 have * only DSPI interface, while ad355x is QSPI. Then using 2 as * DDR mode is considered always on (considering buffering * mode always).
*/
*val = DIV_ROUND_CLOSEST(st->data->bus_sample_data_clock_hz *
st->model_data->num_spi_data_lanes * 2,
chan->scan_type.realbits);
return IIO_VAL_INT;
case IIO_CHAN_INFO_RAW: /* For RAW accesses, stay always in simple-spi. */
ret = ad3552r_hs_reg_read(st,
AD3552R_REG_ADDR_CH_DAC_16B(chan->channel),
val, 2); if (ret) return ret;
staticint ad3552r_hs_write_raw(struct iio_dev *indio_dev, struct iio_chan_spec const *chan, int val, int val2, long mask)
{ struct ad3552r_hs_state *st = iio_priv(indio_dev); int ret;
switch (mask) { case IIO_CHAN_INFO_RAW: if (!iio_device_claim_direct(indio_dev)) return -EBUSY; /* For RAW accesses, stay always in simple-spi. */
ret = st->data->bus_reg_write(st->back,
AD3552R_REG_ADDR_CH_DAC_16B(chan->channel),
val, 2);
/* * Best access for secondary reg area, QSPI where possible, * else as DSPI.
*/ if (st->model_data->num_spi_data_lanes == 4)
mode_target = AD3552R_QUAD_SPI; else
mode_target = AD3552R_DUAL_SPI;
/* * Better to not use update here, since generally it is already * set as DDR mode, and it's not possible to read in DDR mode.
*/ return st->data->bus_reg_write(st->back,
AD3552R_REG_ADDR_TRANSFER_REGISTER,
FIELD_PREP(AD3552R_MASK_MULTI_IO_MODE,
mode_target) |
AD3552R_MASK_STREAM_LENGTH_KEEP_VALUE, 1);
}
switch (*indio_dev->active_scan_mask) { case AD3552R_CH0_ACTIVE:
st->single_channel = true;
loop_len = 2;
val = AD3552R_REG_ADDR_CH_DAC_16B(0); break; case AD3552R_CH1_ACTIVE:
st->single_channel = true;
loop_len = 2;
val = AD3552R_REG_ADDR_CH_DAC_16B(1); break; case AD3552R_CH0_ACTIVE | AD3552R_CH1_ACTIVE:
st->single_channel = false;
loop_len = 4;
val = AD3552R_REG_ADDR_CH_DAC_16B(1); break; default: return -EINVAL;
}
/* * With ad3541/2r support, QSPI pin is held low at reset from HDL, * streaming start sequence must respect strictly the order below.
*/
/* Primary region access, set streaming mode (now in SPI + SDR). */
ret = ad3552r_hs_update_reg_bits(st,
AD3552R_REG_ADDR_INTERFACE_CONFIG_B,
AD3552R_MASK_SINGLE_INST, 0, 1); if (ret) return ret;
/* * Set target loop len, keeping the value: streaming writes at address * 0x2c or 0x2a, in descending loop (2 or 4 bytes), keeping loop len * value so that it's not cleared hereafter when _CS is deasserted.
*/
ret = ad3552r_hs_update_reg_bits(st, AD3552R_REG_ADDR_TRANSFER_REGISTER,
AD3552R_MASK_STREAM_LENGTH_KEEP_VALUE,
AD3552R_MASK_STREAM_LENGTH_KEEP_VALUE,
1); if (ret) goto exit_err_streaming;
ret = st->data->bus_reg_write(st->back,
AD3552R_REG_ADDR_STREAM_MODE,
loop_len, 1); if (ret) goto exit_err_streaming;
st->config_d |= AD3552R_MASK_SPI_CONFIG_DDR;
ret = st->data->bus_reg_write(st->back,
AD3552R_REG_ADDR_INTERFACE_CONFIG_D,
st->config_d, 1); if (ret) goto exit_err_streaming;
ret = iio_backend_ddr_enable(st->back); if (ret) goto exit_err_ddr_mode_target;
/* * From here onward mode is DDR, so reading any register is not possible * anymore, including calling "ad3552r_hs_update_reg_bits" function.
*/
/* Set target to best high speed mode (D or QSPI). */
ret = ad3552r_hs_set_target_io_mode_hs(st); if (ret) goto exit_err_ddr_mode;
/* Set bus to best high speed mode (D or QSPI). */
ret = ad3552r_hs_set_bus_io_mode_hs(st); if (ret) goto exit_err_bus_mode_target;
/* * Backend setup must be done now only, or related register values will * be disrupted by previous bus accesses.
*/
ret = iio_backend_data_transfer_addr(st->back, val); if (ret) goto exit_err_bus_mode_target;
ret = iio_backend_data_format_set(st->back, 0, &fmt); if (ret) goto exit_err_bus_mode_target;
ret = iio_backend_data_stream_enable(st->back); if (ret) goto exit_err_bus_mode_target;
return 0;
exit_err_bus_mode_target: /* Back to simple SPI, not using update to avoid read. */
st->data->bus_reg_write(st->back, AD3552R_REG_ADDR_TRANSFER_REGISTER,
FIELD_PREP(AD3552R_MASK_MULTI_IO_MODE,
AD3552R_SPI) |
AD3552R_MASK_STREAM_LENGTH_KEEP_VALUE, 1);
/* * Back bus to simple SPI, this must be executed together with above * target mode unwind, and can be done only after it.
*/
st->data->bus_set_io_mode(st->back, AD3552R_IO_MODE_SPI);
exit_err_ddr_mode_target: /* * Back to SDR. In DDR we cannot read, whatever the mode is, so not * using update.
*/
st->config_d &= ~AD3552R_MASK_SPI_CONFIG_DDR;
st->data->bus_reg_write(st->back, AD3552R_REG_ADDR_INTERFACE_CONFIG_D,
st->config_d, 1);
exit_err_streaming: /* Back to single instruction mode, disabling loop. */
st->data->bus_reg_write(st->back, AD3552R_REG_ADDR_INTERFACE_CONFIG_B,
AD3552R_MASK_SINGLE_INST |
AD3552R_MASK_SHORT_INSTRUCTION, 1);
ret = iio_backend_data_stream_disable(st->back); if (ret) return ret;
/* * Set us to simple SPI, even if still in ddr, so to be able to write * in primary region.
*/
ret = st->data->bus_set_io_mode(st->back, AD3552R_IO_MODE_SPI); if (ret) return ret;
/* * Back to SDR (in DDR we cannot read, whatever the mode is, so not * using update).
*/
st->config_d &= ~AD3552R_MASK_SPI_CONFIG_DDR;
ret = st->data->bus_reg_write(st->back,
AD3552R_REG_ADDR_INTERFACE_CONFIG_D,
st->config_d, 1); if (ret) return ret;
ret = iio_backend_ddr_disable(st->back); if (ret) return ret;
/* * Back to simple SPI for secondary region too now, so to be able to * dump/read registers there too if needed.
*/
ret = ad3552r_hs_update_reg_bits(st, AD3552R_REG_ADDR_TRANSFER_REGISTER,
AD3552R_MASK_MULTI_IO_MODE,
AD3552R_SPI, 1); if (ret) return ret;
/* Back to single instruction mode, disabling loop. */
ret = ad3552r_hs_update_reg_bits(st,
AD3552R_REG_ADDR_INTERFACE_CONFIG_B,
AD3552R_MASK_SINGLE_INST,
AD3552R_MASK_SINGLE_INST, 1); if (ret) return ret;
return 0;
}
staticinlineint ad3552r_hs_set_output_range(struct ad3552r_hs_state *st, int ch, unsignedint mode)
{ int val;
if (ch == 0)
val = FIELD_PREP(AD3552R_MASK_CH0_RANGE, mode); else
val = FIELD_PREP(AD3552R_MASK_CH1_RANGE, mode);
if (reg > st->model_data->max_reg_addr) return -EINVAL;
/* * There are 8, 16 or 24 bit registers, but HDL supports only reading 8 * or 16 bit data, not 24. So, also to avoid to check any proper read * alignment, supporting only 8-bit readings here.
*/ if (readval) return ad3552r_hs_reg_read(st, reg, readval, 1);
staticint ad3552r_hs_setup(struct ad3552r_hs_state *st)
{
u16 id;
u16 gain = 0, offset = 0;
u32 ch, val, range; int ret;
ret = ad3552r_hs_reset(st); if (ret) return ret;
/* HDL starts with DDR enabled, disabling it. */
ret = iio_backend_ddr_disable(st->back); if (ret) return ret;
ret = st->data->bus_reg_write(st->back,
AD3552R_REG_ADDR_INTERFACE_CONFIG_B,
AD3552R_MASK_SINGLE_INST |
AD3552R_MASK_SHORT_INSTRUCTION, 1); if (ret) return ret;
ret = ad3552r_hs_scratch_pad_test(st); if (ret) return ret;
/* * Caching config_d, needed to restore it after streaming, * and also, to detect possible DDR read, that's not allowed.
*/
ret = st->data->bus_reg_read(st->back,
AD3552R_REG_ADDR_INTERFACE_CONFIG_D,
&st->config_d, 1); if (ret) return ret;
ret = ad3552r_hs_reg_read(st, AD3552R_REG_ADDR_PRODUCT_ID_L, &val, 1); if (ret) return ret;
id = val;
ret = ad3552r_hs_reg_read(st, AD3552R_REG_ADDR_PRODUCT_ID_H, &val, 1); if (ret) return ret;
id |= val << 8; if (id != st->model_data->chip_id)
dev_warn(st->dev, "chip ID mismatch, detected 0x%x but expected 0x%x\n",
id, st->model_data->chip_id);
dev_dbg(st->dev, "chip id %s detected", st->model_data->model_name);
/* Clear reset error flag, see ad3552r manual, rev B table 38. */
ret = st->data->bus_reg_write(st->back, AD3552R_REG_ADDR_ERR_STATUS,
AD3552R_MASK_RESET_STATUS, 1); if (ret) return ret;
ret = st->data->bus_reg_write(st->back,
AD3552R_REG_ADDR_SH_REFERENCE_CONFIG,
0, 1); if (ret) return ret;
ret = ad3552r_hs_set_data_source(st, IIO_BACKEND_EXTERNAL); if (ret) return ret;
ret = ad3552r_get_ref_voltage(st->dev, &val); if (ret < 0) return ret;
val = ret;
ret = ad3552r_hs_update_reg_bits(st,
AD3552R_REG_ADDR_SH_REFERENCE_CONFIG,
AD3552R_MASK_REFERENCE_VOLTAGE_SEL,
val, 1); if (ret) return ret;
ret = ad3552r_get_drive_strength(st->dev, &val); if (!ret) {
st->config_d |=
FIELD_PREP(AD3552R_MASK_SDO_DRIVE_STRENGTH, val);
ret = st->data->bus_reg_write(st->back,
AD3552R_REG_ADDR_INTERFACE_CONFIG_D,
st->config_d, 1); if (ret) return ret;
}
device_for_each_child_node_scoped(st->dev, child) {
ret = fwnode_property_read_u32(child, "reg", &ch); if (ret) return dev_err_probe(st->dev, ret, "reg property missing\n");
ret = ad3552r_get_output_range(st->dev, st->model_data, child,
&range); if (ret && ret != -ENOENT) return ret; if (ret == -ENOENT) {
ret = ad3552r_get_custom_gain(st->dev, child,
&st->ch_data[ch].p,
&st->ch_data[ch].n,
&st->ch_data[ch].rfb,
&st->ch_data[ch].gain_offset); if (ret) return ret;
gain = ad3552r_calc_custom_gain(st->ch_data[ch].p,
st->ch_data[ch].n,
st->ch_data[ch].gain_offset);
offset = abs(st->ch_data[ch].gain_offset);
st->ch_data[ch].range_override = 1;
ret = ad3552r_hs_setup_custom_gain(st, ch, gain,
offset); if (ret) return ret;
} else {
st->ch_data[ch].range = range;
ret = ad3552r_hs_set_output_range(st, ch, range); if (ret) return ret;
}
Die Informationen auf dieser Webseite wurden
nach bestem Wissen sorgfältig zusammengestellt. Es wird jedoch weder Vollständigkeit, noch Richtigkeit,
noch Qualität der bereit gestellten Informationen zugesichert.
Bemerkung:
Die farbliche Syntaxdarstellung und die Messung sind noch experimentell.