ADS1x15_PICO

Table of contents

• Overview
• Examples
• Software
  • Constructor
  • I2C settings
  • Gain settings
  • Data rate settings
  • Modes
• Hardware

Overview

• Name: ADS1x15_PICO
• Description:

Library Driver for ADC sensor, ADS1015 and ADS1115 modules, for Raspberry pi PICO RP2040.

ADC Ultra-Small, Low-Power, I2C-Compatible, With Internal Reference, Oscillator, and Programmable Comparator.

1. ADS1015 3.3-kSPS, 12-Bit ADCs
2. ADS1115 860-SPS, 16-Bit ADCs

• Toolchain

  1. Raspberry pi PICO RP2040
  2. SDK C++, compiler G++ for arm-none-eabi
  3. CMAKE , VScode

• Only tested at present on ADS1015 12 bit device, should work on ADS1115 as well

• By adjusting the I2C address you can add 4 of these devices on the I2C bus.

• Lets the user add 4 more ADC channels to a PICO RP2040

Examples

There are five example files. The example files are in example folder. To build the one you want, edit the Cmaketxt file add_executable(${PROJECT_NAME} section, comment in one example file path and one only.

Path Name	Function
single_ended	Shows single ended basic use case, Reading ADC values from AIN0 to AIN3
continuous_interrupt_differential	Shows a differential reading in continuous conversion mode with interrupt
single_shot_differential	Shows a differential reading in single shot mode
differential	Shows a differential reading between AIN1 P and AIN0 N
comparator	Shows use of comparator threshold mode in default settings

The example files output Data to the PC serial port using printf, default settings.(baud rate 38400). See "modes" section below for more information.

Software

Constructor

There are two different constructors one for ADS1015 (12 bit) and one for ADS1115 (16 bit) All examples files are setup for ADS1015. ADS1115 not tested but should work.

I2C settings

In the beginADSX method the user can pass in a number of I2C related arguments. In the header file it is also possible to turn on I2C debugging messages and adjust the timeout of the I2C functions if necessary.

Function	Default
I2C address 8-bit, This is affected by Addr line on chip, see 8.5.1.1 datasheet	0x48
I2C instance of port IC20 or I2C1	I2C1
I2C Clk speed mode in khz, see 8.5.1.3 datasheet	100
I2C data line	GPIO 18
I2C clock Line	GPIO 19

Gain settings

The ADC input range or gain can be changed with setGain() method, but NEVER exceed VDD +0.3V max, or to exceed the upper and lower limits if you adjust the input range. Setting these values incorrectly may damage the ADC module. The default if setGain() not called is ADSXGain_TWOTHIRDS. All examples files are set to ADSXGain_ONE. See datasheet 8.3.3 Programmable gain amplifier(PGA settings)

Argument to setGain(arg)	Voltage range	ADS1015 Res. per 1 bit	ADS1115 Res. per 1 bit
ADSXGain_TWOTHIRDS	2/3 gain +/- 6.144V	3mV	0.1875mV
ADSXGain_ONE	1x gain +/- 4.096V	2mV	0.125mV
ADSXGain_TWO	2x gain +/- 2.048V	1mV	0.0625mV
ADSXGain_FOUR	4x gain +/- 1.024V	0.5mV	0.03125mV
ADSXGain_EIGHT	8x gain +/- 0.512V	0.25mV	0.015625mV
ADSXGain_SIXTEEN	16x gain +/- 0.256V	0.125mV	0.0078125mV

Data rate settings

Data rate can also be set(method setDataRate). See "Data rate" section in header files for all values. Default(mid range) is ADS1015 = 1600 SPS, ADS1115 = 128 SPS.

Modes

Operational mode , the ADS sensor can operate in single shot or continuous mode. Depending on how often conversions needed you can tune the mode.

In single shot mode the ADS1X15 enter a power-down state between conversions to save power. The devices are automatically powered down after one conversion in single-shot mode. therefore, power consumption is significantly reduced during idle periods.

In continuous-conversion mode (MODE bit set to 0), the ADS1X15 perform conversions continuously. It outputs an 8uS pulse on the ALERT line when ready. This can be used to trigger an interrupt to tell PICO to collect the ready data.

Differential. The differential reading of the ADC can also be done with asynchronous calls measuring the difference in voltage between two channels.

Single ended. Four single-ended input measurements Can be performed on the 4 channels.

Comparator Mode. The ADS sensor feature a programmable digital comparator that can issue an alert on the ALERT pin when a threshold is passed. The settings are set to default can be changed within the "startComparator_SingleEnded" method.

Hardware

Pinout

Pin	Function
A3	AIN3 Analog Input Channel 3
A2	AIN3 Analog Input Channel 2
A1	AIN3 Analog Input Channel 1
A0	AIN3 Analog Input Channel 0
ALERT	Digital output Comparator output or conversion ready
ADDR	Digital Input I2C slave address select , see 8.5.1.1 datasheet
SDA	Digital I/O Serial data. Transmits and receives data
SCL	Digital input Serial clock input. Clocks data on SDA
GND	Ground
VCC	Power supply 2-5V in PICO case connect to 3.3v