Lines Matching +full:mcp3561_2_4r +full:- +full:data +full:- +full:sheet +full:- +full:ds200006391c
1 // SPDX-License-Identifier: GPL-2.0+
5 * Copyright (C) 2022-2023 Microchip Technology Inc. and its subsidiaries
10 …s/aemDocuments/documents/MSLD/ProductDocuments/DataSheets/MCP3561-2-4-Family-Data-Sheet-DS20006181…
12 …ds/aemDocuments/documents/APID/ProductDocuments/DataSheets/MCP3561_2_4R-Data-Sheet-DS200006391C.pdf
14 …ProductDocuments/DataSheets/MCP3461-2-4-Two-Four-Eight-Channel-153.6-ksps-Low-Noise-16-Bit-Delta-S…
16 …/aemDocuments/documents/APID/ProductDocuments/DataSheets/MCP3461-2-4R-Family-Data-Sheet-DS20006404…
64 * ADC Output Data Format 32-bit (25-bit right justified data + Channel ID):
65 * CHID[3:0] + SGN extension (4 bits) + 24-bit ADC data.
70 * ADC Output Data Format 32-bit (25-bit right justified data):
71 * SGN extension (8-bit) + 24-bit ADC data.
76 * ADC Output Data Format 32-bit (24-bit left justified data):
77 * 24-bit ADC data + 0x00 (8-bit).
82 * ADC Output Data Format 24-bit (default ADC coding):
83 * 24-bit ADC data.
92 * One-shot conversion or one-shot cycle in SCAN mode. It sets ADC_MODE[1:0] to ‘10’
97 * One-shot conversion or one-shot cycle in SCAN mode. It sets ADC_MODE[1:0] to ‘0x’ (ADC
276 * Current Source/Sink Selection Bits for Sensor Bias (source on VIN+/sink on VIN-)
299 -8388608, /* min: -2^23 */
301 8388607 /* max: 2^23 - 1 */
307 * unsigned 24-bit register that holds the digital gain error
310 * The gain error calibration value range in equivalent voltage is [0; 2-2^(-23)]
315 16777215 /* max: 2 - 2^(-23) */
335 * struct mcp3564_chip_info - chip specific data
349 * struct mcp3564_state - working data for a ADC device
350 * @chip_info: chip specific data
364 * @auto_zeroing_mux: set if ADC auto-zeroing algorithm is enabled
365 * @auto_zeroing_ref: set if ADC auto-Zeroing Reference Buffer Setting is enabled
409 tx_buf = mcp3564_cmd_read(adc->dev_addr, reg); in mcp3564_read_8bits()
411 ret = spi_write_then_read(adc->spi, &tx_buf, sizeof(tx_buf), in mcp3564_read_8bits()
424 tx_buf = mcp3564_cmd_read(adc->dev_addr, reg); in mcp3564_read_16bits()
426 ret = spi_write_then_read(adc->spi, &tx_buf, sizeof(tx_buf), in mcp3564_read_16bits()
439 tx_buf = mcp3564_cmd_read(adc->dev_addr, reg); in mcp3564_read_32bits()
441 ret = spi_write_then_read(adc->spi, &tx_buf, sizeof(tx_buf), in mcp3564_read_32bits()
452 tx_buf[0] = mcp3564_cmd_write(adc->dev_addr, reg); in mcp3564_write_8bits()
455 return spi_write_then_read(adc->spi, tx_buf, sizeof(tx_buf), NULL, 0); in mcp3564_write_8bits()
462 val |= (mcp3564_cmd_write(adc->dev_addr, reg) << 24); in mcp3564_write_24bits()
465 return spi_write_then_read(adc->spi, &val_be, sizeof(val_be), NULL, 0); in mcp3564_write_24bits()
472 val = FIELD_PREP(MCP3564_CMD_HW_ADDR_MASK, adc->dev_addr) | in mcp3564_fast_cmd()
475 return spi_write_then_read(adc->spi, &val, 1, NULL, 0); in mcp3564_fast_cmd()
502 dev_dbg(&indio_dev->dev, "%s: %d\n", __func__, mode); in mcp3564_set_current_boost_mode()
504 mutex_lock(&adc->lock); in mcp3564_set_current_boost_mode()
509 dev_err(&indio_dev->dev, "Failed to configure CONFIG2 register\n"); in mcp3564_set_current_boost_mode()
511 adc->current_boost_mode = mode; in mcp3564_set_current_boost_mode()
513 mutex_unlock(&adc->lock); in mcp3564_set_current_boost_mode()
523 return adc->current_boost_mode; in mcp3564_get_current_boost_mode()
551 return sysfs_emit(buf, "%d\n", adc->auto_zeroing_mux); in mcp3564_auto_zeroing_mux_show()
567 mutex_lock(&adc->lock); in mcp3564_auto_zeroing_mux_store()
572 dev_err(&indio_dev->dev, "Failed to update CONFIG2 register\n"); in mcp3564_auto_zeroing_mux_store()
574 adc->auto_zeroing_mux = auto_zero; in mcp3564_auto_zeroing_mux_store()
576 mutex_unlock(&adc->lock); in mcp3564_auto_zeroing_mux_store()
588 return sysfs_emit(buf, "%d\n", adc->auto_zeroing_ref); in mcp3564_auto_zeroing_ref_show()
604 mutex_lock(&adc->lock); in mcp3564_auto_zeroing_ref_store()
609 dev_err(&indio_dev->dev, "Failed to update CONFIG2 register\n"); in mcp3564_auto_zeroing_ref_store()
611 adc->auto_zeroing_ref = auto_zero; in mcp3564_auto_zeroing_ref_store()
613 mutex_unlock(&adc->lock); in mcp3564_auto_zeroing_ref_store()
661 * single_ended_input = (CH0 - GND), (CH1 - GND) = 2
662 * differential_input = (CH0 - CH1), (CH0 - CH0) = 2
753 ret = mcp3564_write_8bits(adc, MCP3564_MUX_REG, channel->address); in mcp3564_read_single_value()
780 return -EBUSY; in mcp3564_read_single_value()
794 if (!channel->output) in mcp3564_read_avail()
795 return -EINVAL; in mcp3564_read_avail()
807 *vals = (int *)adc->scale_tbls; in mcp3564_read_avail()
808 *length = ARRAY_SIZE(adc->scale_tbls) * 2; in mcp3564_read_avail()
820 return -EINVAL; in mcp3564_read_avail()
833 if (channel->output) { in mcp3564_read_raw()
834 mutex_lock(&adc->lock); in mcp3564_read_raw()
835 *val = mcp3564_burnout_avail[adc->burnout_mode][0]; in mcp3564_read_raw()
836 *val2 = mcp3564_burnout_avail[adc->burnout_mode][1]; in mcp3564_read_raw()
837 mutex_unlock(&adc->lock); in mcp3564_read_raw()
843 return -EINVAL; in mcp3564_read_raw()
846 mutex_lock(&adc->lock); in mcp3564_read_raw()
847 *val = adc->scale_tbls[adc->hwgain][0]; in mcp3564_read_raw()
848 *val2 = adc->scale_tbls[adc->hwgain][1]; in mcp3564_read_raw()
849 mutex_unlock(&adc->lock); in mcp3564_read_raw()
852 *val = mcp3564_oversampling_avail[adc->oversampling]; in mcp3564_read_raw()
855 *val = adc->calib_bias; in mcp3564_read_raw()
858 *val = adc->calib_scale; in mcp3564_read_raw()
861 return -EINVAL; in mcp3564_read_raw()
879 return -EINVAL; in mcp3564_write_raw_get_fmt()
895 if (!channel->output) in mcp3564_write_raw()
896 return -EINVAL; in mcp3564_write_raw()
904 return -EINVAL; in mcp3564_write_raw()
906 if (burnout == adc->burnout_mode) in mcp3564_write_raw()
909 mutex_lock(&adc->lock); in mcp3564_write_raw()
915 dev_err(&indio_dev->dev, "Failed to configure burnout current\n"); in mcp3564_write_raw()
917 adc->burnout_mode = burnout; in mcp3564_write_raw()
918 mutex_unlock(&adc->lock); in mcp3564_write_raw()
922 return -EINVAL; in mcp3564_write_raw()
924 mutex_lock(&adc->lock); in mcp3564_write_raw()
927 adc->calib_bias = val; in mcp3564_write_raw()
928 mutex_unlock(&adc->lock); in mcp3564_write_raw()
932 return -EINVAL; in mcp3564_write_raw()
934 if (adc->calib_scale == val) in mcp3564_write_raw()
937 mutex_lock(&adc->lock); in mcp3564_write_raw()
940 adc->calib_scale = val; in mcp3564_write_raw()
941 mutex_unlock(&adc->lock); in mcp3564_write_raw()
945 return -EINVAL; in mcp3564_write_raw()
950 if (adc->oversampling == tmp) in mcp3564_write_raw()
953 mutex_lock(&adc->lock); in mcp3564_write_raw()
957 adc->oversampling)); in mcp3564_write_raw()
959 adc->oversampling = tmp; in mcp3564_write_raw()
960 mutex_unlock(&adc->lock); in mcp3564_write_raw()
964 if (val == adc->scale_tbls[hwgain][0] && in mcp3564_write_raw()
965 val2 == adc->scale_tbls[hwgain][1]) in mcp3564_write_raw()
969 return -EINVAL; in mcp3564_write_raw()
971 if (hwgain == adc->hwgain) in mcp3564_write_raw()
974 mutex_lock(&adc->lock); in mcp3564_write_raw()
979 adc->hwgain = hwgain; in mcp3564_write_raw()
981 mutex_unlock(&adc->lock); in mcp3564_write_raw()
984 return -EINVAL; in mcp3564_write_raw()
993 return sprintf(label, "%s\n", adc->labels[chan->scan_index]); in mcp3564_read_label()
999 struct device *dev = &adc->spi->dev; in mcp3564_parse_fw_children()
1014 return dev_err_probe(&indio_dev->dev, -ENODEV, in mcp3564_parse_fw_children()
1020 if (num_ch > adc->chip_info->num_channels) in mcp3564_parse_fw_children()
1021 return dev_err_probe(dev, -EINVAL, "Too many channels %d > %d\n", in mcp3564_parse_fw_children()
1022 num_ch, adc->chip_info->num_channels); in mcp3564_parse_fw_children()
1026 return dev_err_probe(dev, -ENOMEM, "Can't allocate memory\n"); in mcp3564_parse_fw_children()
1031 if (fwnode_property_present(child, "diff-channels")) { in mcp3564_parse_fw_children()
1033 "diff-channels", in mcp3564_parse_fw_children()
1051 return dev_err_probe(&indio_dev->dev, -EINVAL, in mcp3564_parse_fw_children()
1064 adc->labels[chan_idx] = label; in mcp3564_parse_fw_children()
1074 adc->labels[chan_idx] = mcp3564_channel_labels[0]; in mcp3564_parse_fw_children()
1081 adc->labels[chan_idx] = mcp3564_channel_labels[1]; in mcp3564_parse_fw_children()
1084 indio_dev->num_channels = chan_idx; in mcp3564_parse_fw_children()
1085 indio_dev->channels = channels; in mcp3564_parse_fw_children()
1097 unsigned int pow = adc->chip_info->resolution - 1; in mcp3564_fill_scale_tbls()
1104 ref = adc->vref_mv; in mcp3564_fill_scale_tbls()
1111 adc->scale_tbls[i][1] = tmp0; in mcp3564_fill_scale_tbls()
1118 struct device *dev = &adc->spi->dev; in mcp3564_config()
1128 * The address is set on a per-device basis by fuses in the factory, in mcp3564_config()
1135 device_property_read_u32(dev, "microchip,hw-device-address", &tmp); in mcp3564_config()
1139 "invalid device address. Must be in range 0-3.\n"); in mcp3564_config()
1140 return -EINVAL; in mcp3564_config()
1143 adc->dev_addr = FIELD_GET(MCP3564_HW_ADDR_MASK, tmp); in mcp3564_config()
1145 dev_dbg(dev, "use HW device address %i\n", adc->dev_addr); in mcp3564_config()
1153 adc->have_vref = false; in mcp3564_config()
1156 adc->have_vref = true; in mcp3564_config()
1170 if (adc->have_vref) in mcp3564_config()
1176 if (adc->have_vref) in mcp3564_config()
1182 if (adc->have_vref) in mcp3564_config()
1188 if (adc->have_vref) in mcp3564_config()
1194 if (adc->have_vref) in mcp3564_config()
1200 if (adc->have_vref) in mcp3564_config()
1216 adc->chip_info = spi_get_device_match_data(adc->spi); in mcp3564_config()
1217 if (!adc->chip_info) { in mcp3564_config()
1218 dev_id = spi_get_device_id(adc->spi); in mcp3564_config()
1219 adc->chip_info = (const struct mcp3564_chip_info *)dev_id->driver_data; in mcp3564_config()
1222 adc->have_vref = adc->chip_info->have_vref; in mcp3564_config()
1224 adc->chip_info = &mcp3564_chip_infos_tbl[ids]; in mcp3564_config()
1227 dev_dbg(dev, "Found %s chip\n", adc->chip_info->name); in mcp3564_config()
1229 adc->vref = devm_regulator_get_optional(dev, "vref"); in mcp3564_config()
1230 if (IS_ERR(adc->vref)) { in mcp3564_config()
1231 if (PTR_ERR(adc->vref) != -ENODEV) in mcp3564_config()
1232 return dev_err_probe(dev, PTR_ERR(adc->vref), in mcp3564_config()
1236 if (!adc->have_vref) in mcp3564_config()
1237 return dev_err_probe(dev, PTR_ERR(adc->vref), in mcp3564_config()
1239 adc->vref = NULL; in mcp3564_config()
1242 ret = regulator_enable(adc->vref); in mcp3564_config()
1247 adc->vref); in mcp3564_config()
1253 ret = regulator_get_voltage(adc->vref); in mcp3564_config()
1258 adc->vref_mv = ret / MILLI; in mcp3564_config()
1267 * in any cases of loss-of-power scenario (Full Chip Reset): in mcp3564_config()
1268 * - Write LOCK register to 0xA5 in mcp3564_config()
1269 * - Write IRQ register to 0x03 in mcp3564_config()
1270 * - Send "Device Full Reset" fast command in mcp3564_config()
1271 * - Wait 1ms for "Full Reset" to complete in mcp3564_config()
1298 adc->calib_scale = MCP3564_DEFAULT_GAINCAL; in mcp3564_config()
1343 adc->hwgain = 0x01; in mcp3564_config()
1344 adc->auto_zeroing_mux = true; in mcp3564_config()
1345 adc->auto_zeroing_ref = false; in mcp3564_config()
1346 adc->current_boost_mode = MCP3564_BOOST_CURRENT_x1_00; in mcp3564_config()
1354 adc->oversampling = MCP3564_OVERSAMPLING_RATIO_98304; in mcp3564_config()
1361 if (!adc->vref) { in mcp3564_config()
1363 adc->vref_mv = MCP3564R_INT_VREF_MV; in mcp3564_config()
1368 adc->burnout_mode = MCP3564_CONFIG0_CS_SEL_0_0_uA; in mcp3564_config()
1424 indio_dev = devm_iio_device_alloc(&spi->dev, sizeof(*adc)); in mcp3564_probe()
1426 return -ENOMEM; in mcp3564_probe()
1429 adc->spi = spi; in mcp3564_probe()
1431 dev_dbg(&spi->dev, "%s: probe(spi = 0x%p)\n", __func__, spi); in mcp3564_probe()
1441 return dev_err_probe(&spi->dev, ret, in mcp3564_probe()
1444 dev_dbg(&spi->dev, "%s: Vref (mV): %d\n", __func__, adc->vref_mv); in mcp3564_probe()
1448 indio_dev->name = adc->chip_info->name; in mcp3564_probe()
1449 indio_dev->modes = INDIO_DIRECT_MODE; in mcp3564_probe()
1451 if (!adc->vref) in mcp3564_probe()
1452 indio_dev->info = &mcp3564r_info; in mcp3564_probe()
1454 indio_dev->info = &mcp3564_info; in mcp3564_probe()
1456 mutex_init(&adc->lock); in mcp3564_probe()
1458 ret = devm_iio_device_register(&spi->dev, indio_dev); in mcp3564_probe()
1460 return dev_err_probe(&spi->dev, ret, in mcp3564_probe()
1467 { .compatible = "microchip,mcp3461", .data = &mcp3564_chip_infos_tbl[mcp3461] },
1468 { .compatible = "microchip,mcp3462", .data = &mcp3564_chip_infos_tbl[mcp3462] },
1469 { .compatible = "microchip,mcp3464", .data = &mcp3564_chip_infos_tbl[mcp3464] },
1470 { .compatible = "microchip,mcp3561", .data = &mcp3564_chip_infos_tbl[mcp3561] },
1471 { .compatible = "microchip,mcp3562", .data = &mcp3564_chip_infos_tbl[mcp3562] },
1472 { .compatible = "microchip,mcp3564", .data = &mcp3564_chip_infos_tbl[mcp3564] },
1473 { .compatible = "microchip,mcp3461r", .data = &mcp3564_chip_infos_tbl[mcp3461r] },
1474 { .compatible = "microchip,mcp3462r", .data = &mcp3564_chip_infos_tbl[mcp3462r] },
1475 { .compatible = "microchip,mcp3464r", .data = &mcp3564_chip_infos_tbl[mcp3464r] },
1476 { .compatible = "microchip,mcp3561r", .data = &mcp3564_chip_infos_tbl[mcp3561r] },
1477 { .compatible = "microchip,mcp3562r", .data = &mcp3564_chip_infos_tbl[mcp3562r] },
1478 { .compatible = "microchip,mcp3564r", .data = &mcp3564_chip_infos_tbl[mcp3564r] },