samples/drivers/adc: Rework to use channel configurations from DT
Allow specifying configuration of channels through child nodes of ADC controllers. This way analog inputs can be specified for channels in SoCs that require this and it is also possible, for example, to use different gain or reference selections for particular channels. This commit also removes a few former limitations of the sample: now it is possible to use more than 2 channels and each channel can use a different ADC controller. Also the ADC resolution to be used can be specified through devicetree. Signed-off-by: Andrzej Głąbek <andrzej.glabek@nordicsemi.no>
This commit is contained in:
Andrzej Głąbek
Marti Bolivar
parent
3e0679f01c
commit
f5ffd05e6b
3 changed files with 143 additions and 97 deletions
|
|
@ -8,21 +8,13 @@ Overview
|
|||
|
||||
This sample demonstrates how to use the ADC driver API.
|
||||
|
||||
Depending on the MCU type, it reads the ADC samples of one or two ADC channels
|
||||
and prints the readings to the console. If supported by the driver, the raw
|
||||
readings are converted to millivolts.
|
||||
Depending on the target board, it reads ADC samples from one or more channels
|
||||
and prints the readings on the console. If voltage of the used reference can
|
||||
be obtained, the raw readings are converted to millivolts.
|
||||
|
||||
The pins of the ADC channels are board-specific. Please refer to the board
|
||||
or MCU datasheet for further details.
|
||||
|
||||
.. note::
|
||||
|
||||
This sample does not work on Nordic platforms where there is a distinction
|
||||
between channel and analog input that requires additional configuration. See
|
||||
:zephyr_file:`samples/boards/nrf/battery` for an example of using the ADC
|
||||
infrastructure on Nordic hardware.
|
||||
|
||||
|
||||
Building and Running
|
||||
********************
|
||||
|
||||
|
|
@ -32,7 +24,15 @@ sure that the ADC is enabled (``status = "okay";``).
|
|||
In addition to that, this sample requires an ADC channel specified in the
|
||||
``io-channels`` property of the ``zephyr,user`` node. This is usually done with
|
||||
a devicetree overlay. The example overlay in the ``boards`` subdirectory for
|
||||
the :ref:`nucleo_l073rz_board` can be easily adjusted for other boards.
|
||||
the ``nucleo_l073rz`` board can be easily adjusted for other boards.
|
||||
|
||||
Configuration of channels (settings like gain, reference, or acquisition time)
|
||||
can be specified in devicetree, in ADC controller child nodes. Also the ADC
|
||||
resolution and oversampling setting to be used for particular channels can
|
||||
be specified there. See :zephyr_file:`boards/nrf52840dk_nrf52840.overlay
|
||||
<samples/drivers/adc/boards/nrf52840dk_nrf52840.overlay>` for an example of
|
||||
such setup. If these parameters are not specified in devicetree, default values,
|
||||
supposed to be supported by most ADCs, are used instead.
|
||||
|
||||
Building and Running for ST Nucleo L073RZ
|
||||
=========================================
|
||||
|
|
|
|||
|
|
@ -9,6 +9,7 @@ tests:
|
|||
harness: console
|
||||
timeout: 10
|
||||
harness_config:
|
||||
type: one_line
|
||||
type: multi_line
|
||||
regex:
|
||||
- "ADC reading: (.*)"
|
||||
- "ADC reading:"
|
||||
- " - .+, channel \\d+: \\d+"
|
||||
|
|
|
|||
|
|
@ -13,114 +13,159 @@
|
|||
#error "No suitable devicetree overlay specified"
|
||||
#endif
|
||||
|
||||
#define ADC_NUM_CHANNELS DT_PROP_LEN(DT_PATH(zephyr_user), io_channels)
|
||||
#define DT_SPEC_AND_COMMA(node_id, prop, idx) \
|
||||
ADC_DT_SPEC_GET_BY_IDX(node_id, idx),
|
||||
|
||||
#if ADC_NUM_CHANNELS > 2
|
||||
#error "Currently only 1 or 2 channels supported in this sample"
|
||||
#endif
|
||||
/* Data of ADC io-channels specified in devicetree. */
|
||||
static const struct adc_dt_spec adc_channels[] = {
|
||||
DT_FOREACH_PROP_ELEM(DT_PATH(zephyr_user), io_channels,
|
||||
DT_SPEC_AND_COMMA)
|
||||
};
|
||||
|
||||
#if ADC_NUM_CHANNELS == 2 && !DT_SAME_NODE( \
|
||||
DT_PHANDLE_BY_IDX(DT_PATH(zephyr_user), io_channels, 0), \
|
||||
DT_PHANDLE_BY_IDX(DT_PATH(zephyr_user), io_channels, 1))
|
||||
#error "Channels have to use the same ADC."
|
||||
#endif
|
||||
#define LABEL_AND_COMMA(node_id, prop, idx) \
|
||||
DT_LABEL(DT_IO_CHANNELS_CTLR_BY_IDX(node_id, idx)),
|
||||
|
||||
#define ADC_NODE DT_PHANDLE(DT_PATH(zephyr_user), io_channels)
|
||||
/* Labels of ADC controllers referenced by the above io-channels. */
|
||||
static const char *const adc_labels[] = {
|
||||
DT_FOREACH_PROP_ELEM(DT_PATH(zephyr_user), io_channels,
|
||||
LABEL_AND_COMMA)
|
||||
};
|
||||
|
||||
/* Common settings supported by most ADCs */
|
||||
/*
|
||||
* Common settings supported by most ADCs.
|
||||
* If for a given channel a configuration is available in devicetree, values
|
||||
* for gain, reference, and acquisition time are taken from there instead of
|
||||
* those below. Also resolution can be optionally specified together with
|
||||
* the channel configuration in devicetree. If it is, that value is used
|
||||
* instead of the default one below.
|
||||
*/
|
||||
#define ADC_RESOLUTION 12
|
||||
#define ADC_GAIN ADC_GAIN_1
|
||||
#define ADC_REFERENCE ADC_REF_INTERNAL
|
||||
#define ADC_ACQUISITION_TIME ADC_ACQ_TIME_DEFAULT
|
||||
|
||||
#ifdef CONFIG_ADC_NRFX_SAADC
|
||||
#define ADC_INPUT_POS_OFFSET SAADC_CH_PSELP_PSELP_AnalogInput0
|
||||
#else
|
||||
#define ADC_INPUT_POS_OFFSET 0
|
||||
#endif
|
||||
static void configure_channel(const struct adc_dt_spec *dt_spec,
|
||||
uint16_t *vref_mv)
|
||||
{
|
||||
/* If a configuration for the channel is specified in devicetree,
|
||||
* use it, otherwise use default settings that should be suitable
|
||||
* for most ADCs.
|
||||
*/
|
||||
if (dt_spec->channel_cfg_dt_node_exists) {
|
||||
adc_channel_setup(dt_spec->dev, &dt_spec->channel_cfg);
|
||||
|
||||
/* Get the numbers of up to two channels */
|
||||
static uint8_t channel_ids[ADC_NUM_CHANNELS] = {
|
||||
DT_IO_CHANNELS_INPUT_BY_IDX(DT_PATH(zephyr_user), 0),
|
||||
#if ADC_NUM_CHANNELS == 2
|
||||
DT_IO_CHANNELS_INPUT_BY_IDX(DT_PATH(zephyr_user), 1)
|
||||
#endif
|
||||
};
|
||||
/* For the internal reference, use the voltage value returned
|
||||
* by the dedicated API function. For others, use the value
|
||||
* from devicetree if available.
|
||||
*/
|
||||
if (dt_spec->channel_cfg.reference == ADC_REF_INTERNAL) {
|
||||
*vref_mv = adc_ref_internal(dt_spec->dev);
|
||||
} else if (dt_spec->vref_mv > 0) {
|
||||
*vref_mv = dt_spec->vref_mv;
|
||||
}
|
||||
} else {
|
||||
struct adc_channel_cfg channel_cfg = {
|
||||
.channel_id = dt_spec->channel_id,
|
||||
.gain = ADC_GAIN,
|
||||
.reference = ADC_REFERENCE,
|
||||
.acquisition_time = ADC_ACQUISITION_TIME,
|
||||
};
|
||||
|
||||
static int16_t sample_buffer[ADC_NUM_CHANNELS];
|
||||
adc_channel_setup(dt_spec->dev, &channel_cfg);
|
||||
|
||||
struct adc_channel_cfg channel_cfg = {
|
||||
.gain = ADC_GAIN,
|
||||
.reference = ADC_REFERENCE,
|
||||
.acquisition_time = ADC_ACQUISITION_TIME,
|
||||
/* channel ID will be overwritten below */
|
||||
.channel_id = 0,
|
||||
.differential = 0
|
||||
};
|
||||
*vref_mv = adc_ref_internal(dt_spec->dev);
|
||||
}
|
||||
}
|
||||
|
||||
struct adc_sequence sequence = {
|
||||
/* individual channels will be added below */
|
||||
.channels = 0,
|
||||
.buffer = sample_buffer,
|
||||
/* buffer size in bytes, not number of samples */
|
||||
.buffer_size = sizeof(sample_buffer),
|
||||
.resolution = ADC_RESOLUTION,
|
||||
};
|
||||
static void prepare_sequence(struct adc_sequence *sequence,
|
||||
const struct adc_dt_spec *dt_spec)
|
||||
{
|
||||
sequence->channels = BIT(dt_spec->channel_id);
|
||||
sequence->resolution = ADC_RESOLUTION;
|
||||
sequence->oversampling = 0;
|
||||
|
||||
if (dt_spec->channel_cfg_dt_node_exists) {
|
||||
if (dt_spec->resolution) {
|
||||
sequence->resolution = dt_spec->resolution;
|
||||
}
|
||||
if (dt_spec->oversampling) {
|
||||
sequence->oversampling = dt_spec->oversampling;
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
static void print_millivolts(int32_t value,
|
||||
uint16_t vref_mv,
|
||||
uint8_t resolution,
|
||||
const struct adc_dt_spec *dt_spec)
|
||||
{
|
||||
enum adc_gain gain = ADC_GAIN;
|
||||
|
||||
if (dt_spec->channel_cfg_dt_node_exists) {
|
||||
gain = dt_spec->channel_cfg.gain;
|
||||
|
||||
/*
|
||||
* For differential channels, one bit less needs to be specified
|
||||
* for resolution to achieve correct conversion.
|
||||
*/
|
||||
if (dt_spec->channel_cfg.differential) {
|
||||
resolution -= 1;
|
||||
}
|
||||
}
|
||||
|
||||
adc_raw_to_millivolts(vref_mv, gain, resolution, &value);
|
||||
printk(" = %d mV", value);
|
||||
}
|
||||
|
||||
void main(void)
|
||||
{
|
||||
int err;
|
||||
const struct device *dev_adc = DEVICE_DT_GET(ADC_NODE);
|
||||
int16_t sample_buffer[1];
|
||||
struct adc_sequence sequence = {
|
||||
.buffer = sample_buffer,
|
||||
/* buffer size in bytes, not number of samples */
|
||||
.buffer_size = sizeof(sample_buffer),
|
||||
};
|
||||
uint16_t vref_mv[ARRAY_SIZE(adc_channels)] = { 0 };
|
||||
|
||||
if (!device_is_ready(dev_adc)) {
|
||||
printk("ADC device not found\n");
|
||||
return;
|
||||
}
|
||||
|
||||
/*
|
||||
* Configure channels individually prior to sampling
|
||||
*/
|
||||
for (uint8_t i = 0; i < ADC_NUM_CHANNELS; i++) {
|
||||
channel_cfg.channel_id = channel_ids[i];
|
||||
#ifdef CONFIG_ADC_CONFIGURABLE_INPUTS
|
||||
channel_cfg.input_positive = ADC_INPUT_POS_OFFSET + channel_ids[i];
|
||||
#endif
|
||||
|
||||
adc_channel_setup(dev_adc, &channel_cfg);
|
||||
|
||||
sequence.channels |= BIT(channel_ids[i]);
|
||||
}
|
||||
|
||||
int32_t adc_vref = adc_ref_internal(dev_adc);
|
||||
|
||||
while (1) {
|
||||
/*
|
||||
* Read sequence of channels (fails if not supported by MCU)
|
||||
*/
|
||||
err = adc_read(dev_adc, &sequence);
|
||||
if (err != 0) {
|
||||
printk("ADC reading failed with error %d.\n", err);
|
||||
/* Configure channels individually prior to sampling. */
|
||||
for (uint8_t i = 0; i < ARRAY_SIZE(adc_channels); i++) {
|
||||
if (!device_is_ready(adc_channels[i].dev)) {
|
||||
printk("ADC device not found\n");
|
||||
return;
|
||||
}
|
||||
|
||||
printk("ADC reading:");
|
||||
for (uint8_t i = 0; i < ADC_NUM_CHANNELS; i++) {
|
||||
int32_t raw_value = sample_buffer[i];
|
||||
configure_channel(&adc_channels[i], &vref_mv[i]);
|
||||
}
|
||||
|
||||
printk(" %d", raw_value);
|
||||
if (adc_vref > 0) {
|
||||
/*
|
||||
* Convert raw reading to millivolts if driver
|
||||
* supports reading of ADC reference voltage
|
||||
*/
|
||||
int32_t mv_value = raw_value;
|
||||
while (1) {
|
||||
printk("ADC reading:\n");
|
||||
for (uint8_t i = 0; i < ARRAY_SIZE(adc_channels); i++) {
|
||||
printk(" - %s, channel %d: ",
|
||||
adc_labels[i], adc_channels[i].channel_id);
|
||||
|
||||
adc_raw_to_millivolts(adc_vref, ADC_GAIN,
|
||||
ADC_RESOLUTION, &mv_value);
|
||||
printk(" = %d mV ", mv_value);
|
||||
prepare_sequence(&sequence, &adc_channels[i]);
|
||||
|
||||
err = adc_read(adc_channels[i].dev, &sequence);
|
||||
if (err < 0) {
|
||||
printk("error %d\n", err);
|
||||
continue;
|
||||
} else {
|
||||
printk("%d", sample_buffer[0]);
|
||||
}
|
||||
|
||||
/*
|
||||
* Convert raw reading to millivolts if the reference
|
||||
* voltage is known.
|
||||
*/
|
||||
if (vref_mv[i] > 0) {
|
||||
print_millivolts(sample_buffer[0],
|
||||
vref_mv[i],
|
||||
sequence.resolution,
|
||||
&adc_channels[i]);
|
||||
}
|
||||
printk("\n");
|
||||
}
|
||||
printk("\n");
|
||||
|
||||
k_sleep(K_MSEC(1000));
|
||||
}
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue