ads1x1x 0.3.0

Platform-agnostic Rust driver for the ADS1x1x ultra-small, low-power analog-to-digital converters (ADC). Compatible with the devices: ADS1013, ADS1014, ADS1015, ADS1113, ADS1114 and ADS1115.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97

//! ADC input channels.

use crate::{ic, Ads1x1x, BitFlags as BF, Config};

use private::ChannelSelection;

/// Marker type for an ADC input channel.
pub trait ChannelId<T> {
    /// Get the channel.
    fn channel_id() -> ChannelSelection;
}

macro_rules! impl_channels {
    ($(#[doc = $doc:expr] $CH:ident => [$($IC:ident),+]),+ $(,)?) => {
        mod private {
            #[derive(Debug, Clone, Copy)]
            /// ADC input channel selection.
            pub enum ChannelSelection {
                $(
                    #[doc = $doc]
                    $CH,
                )+
            }
        }

        $(
            #[doc = $doc]
            pub struct $CH;

            $(
                impl<I2C, CONV, MODE> ChannelId<Ads1x1x<I2C, ic::$IC, CONV, MODE>> for $CH {
                    fn channel_id() -> ChannelSelection {
                        ChannelSelection::$CH
                    }
                }
            )+
        )+
    };
}

impl_channels!(
    /// Measure signal on input channel 0 differentially to signal on input channel 1.
    DifferentialA0A1 => [Ads1013, Ads1014, Ads1015, Ads1113, Ads1114,  Ads1115],
    /// Measure signal on input channel 0 differentially to signal on input channel 3.
    DifferentialA0A3 => [Ads1015, Ads1115],
    /// Measure signal on input channel 1 differentially to signal on input channel 3.
    DifferentialA1A3 => [Ads1015, Ads1115],
    /// Measure signal on input channel 3 differentially to signal on input channel 3.
    DifferentialA2A3 => [Ads1015, Ads1115],
    /// Measure single-ended signal on input channel 0.
    SingleA0 => [Ads1015, Ads1115],
    /// Measure single-ended signal on input channel 1.
    SingleA1 => [Ads1015, Ads1115],
    /// Measure single-ended signal on input channel 2.
    SingleA2 => [Ads1015, Ads1115],
    /// Measure single-ended signal on input channel 3.
    SingleA3 => [Ads1015, Ads1115]
);

impl Config {
    pub(crate) fn with_mux_bits(&self, ch: ChannelSelection) -> Self {
        match ch {
            ChannelSelection::DifferentialA0A1 => self
                .with_low(BF::MUX2)
                .with_low(BF::MUX1)
                .with_low(BF::MUX0),
            ChannelSelection::DifferentialA0A3 => self
                .with_low(BF::MUX2)
                .with_low(BF::MUX1)
                .with_high(BF::MUX0),
            ChannelSelection::DifferentialA1A3 => self
                .with_low(BF::MUX2)
                .with_high(BF::MUX1)
                .with_low(BF::MUX0),
            ChannelSelection::DifferentialA2A3 => self
                .with_low(BF::MUX2)
                .with_high(BF::MUX1)
                .with_high(BF::MUX0),
            ChannelSelection::SingleA0 => self
                .with_high(BF::MUX2)
                .with_low(BF::MUX1)
                .with_low(BF::MUX0),
            ChannelSelection::SingleA1 => self
                .with_high(BF::MUX2)
                .with_low(BF::MUX1)
                .with_high(BF::MUX0),
            ChannelSelection::SingleA2 => self
                .with_high(BF::MUX2)
                .with_high(BF::MUX1)
                .with_low(BF::MUX0),
            ChannelSelection::SingleA3 => self
                .with_high(BF::MUX2)
                .with_high(BF::MUX1)
                .with_high(BF::MUX0),
        }
    }
}