testing-software/Node/Common/drivers/inc/adc_ADS114S0.h at 1faf52a0adcbe0849880f728ff0d0a7991914ead · ParadigmHyperloop/testing-software · GitHub

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
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
#ifndef ADC_ADS114S0_H
#define ADC_ADS114S0_H

#include <SPI.h>

enum Register : uint8_t
{
    STATUS   = 0x01,
    INPMUX   = 0x02,
    PGA      = 0x03,
    DATARATE = 0x04,
    REF      = 0x05,
    IDACMAG  = 0x06,
    IDACMUX  = 0x07,
    VBIAS    = 0x08,
    SYS      = 0x09,
    OFCAL0   = 0x0B,
    OFCAL1   = 0x0C,
    FSCAL0   = 0x0E,
    FSCAL1   = 0x0F,
    GPIODAT  = 0x10,
    GPIOCON  = 0x11
};

enum InputMux : uint8_t
{
    MUX_SINGLE_0    = 0x0C, // Single-ended AIN0
    MUX_SINGLE_1    = 0x1C, // Single-ended AIN1
    MUX_SINGLE_2    = 0x2C, // Single-ended AIN2
    MUX_SINGLE_3    = 0x3C, // Single-ended AIN3
    MUX_SINGLE_4    = 0x4C, // Single-ended AIN4
    MUX_SINGLE_5    = 0x5C, // Single-ended AIN5
    MUX_SINGLE_6    = 0x6C, // Single-ended AIN6
    MUX_SINGLE_7    = 0x7C, // Single-ended AIN7
    MUX_SINGLE_8    = 0x8C, // Single-ended AIN8
    MUX_SINGLE_9    = 0x9C, // Single-ended AIN9
    MUX_SINGLE_10   = 0xAC, // Single-ended AIN10
    MUX_SINGLE_11   = 0xBC  // Single-ended AIN11
};

enum PGAGain : uint8_t
{
    GAIN_DISABLE    = 0x00, // Default
    GAIN_1          = 0x08,
    GAIN_2          = 0x09,
    GAIN_4          = 0x0A,
    GAIN_8          = 0x0B,
    GAIN_16         = 0x0C,
    GAIN_32         = 0x0D,
    GAIN_64         = 0x0E,
    GAIN_128        = 0x0F
};

enum DataRate : uint8_t
{
    SPS_2_5     = 0x10, // 2.5 Samples Per Second
    SPS_5       = 0x11, // 5 Samples Per Second
    SPS_10      = 0x12, // 10 Samples Per Second
    SPS_16_6    = 0x13, // 16.6 Samples Per Second
    SPS_20      = 0x14, // 20 Samples Per Second (default)
    SPS_50      = 0x15, // 50 Samples Per Second
    SPS_60      = 0x16, // 60 Samples Per Second
    SPS_100     = 0x17, // 100 Samples Per Second
    SPS_200     = 0x18, // 200 Samples Per Second
    SPS_400     = 0x19, // 400 Samples Per Second
    SPS_800     = 0x1A, // 800 Samples Per Second
    SPS_1000    = 0x1B, // 1000 Samples Per Second
    SPS_2000    = 0x1C, // 2000 Samples Per Second
    SPS_4000    = 0x1D  // 4000 Samples Per Second
};

enum ConversionMode : uint8_t
{
    SINGLE = 0x10,
    CONTINUOUS = 0x30
};

enum ClockSource : uint8_t
{
    INTERNAL_CLK = 0x10,
    EXTERNAL_CLK = 0x50
};

enum Command : uint8_t
{
    WAKEUP      = 0x02,
    POWERDOWN   = 0x04,
    RESET       = 0x06,
    START       = 0x08,
    STOP        = 0x0A,
    SYOCAL      = 0x16, // System offset calibration
    SYGCAL      = 0x17, // System gain calibration
    SFOCAL      = 0x19, // Self offset calibration
    RDATA       = 0x12
};

constexpr uint16_t RREG = 0x2000;
constexpr uint16_t WREG = 0x3000;
constexpr uint8_t DEFAULTS[] = { 0x80, 0x01, 0x00, 0x14, 0x10, 0x00,
                                    0xFF, 0x00, 0x10, 0x00, 0x00, 0x00,
                                    0x00, 0x00, 0x40, 0x00, 0x00 };

class ADS114S0
{
public:
    ADS114S0(const uint8_t CS);
    void beginSPI();
    void endSPI();
    void reset();
    void writeRegister(const Register, const uint8_t);
    void writeRegisters(const Register, const uint8_t[], const uint8_t);
    uint8_t readRegister(const Register);
    void readRegisters(const Register, uint8_t[], const uint8_t);
    uint16_t readData();
    void setMux(const InputMux);
    void setPGAGain(const PGAGain);
    void setMode(const DataRate, const ClockSource, const ConversionMode);
    void setConversionMode(const ConversionMode);
    void startConversion();
    void stopConversion();

    static const uint32_t SPI_CLOCK = 20000000;
private:
    const uint8_t m_CS;
};

#endif