ADS1015

A Node.js library for an ADS1015 analog to digital converter

Theses are super inexpensive on amazon!

(Converting analog joystick input and displaying on an ssd1327)

The joystick is: here
The display is: here
  --> Also checkout my node module for it!: here

// const connection = [1, 0x48, 'i2c-bus']
//  use an `i2cdriver` board for development!...
const connection = ['/dev/tty.usbserial-DO010000', 0x48, 'i2cdriver/i2c-bus']
 
ADS1015.open(...connection).then(async (ads1015) => {
  ads1015.gain = 1
 
  for (let i = 0; i < 1000; i++) {
    let x = await ads1015.measure('0+GND')
    let y = await ads1015.measure('1+GND')
    console.log(x, y)
  }
})

Or, use with an existing bus instance:

const ADS1015 = require('ads1015')
 
const i2c = require('i2c-bus')
i2c.openPromisified(1).then(async (bus) => {
  const ads1015 = await ADS1015(bus)
  // ads1015.gain = 1
 
  for (let i = 0; i < 1000; i++) {
    let value = await ads1015.measure('0+GND')
    console.log(value)
  }
})

Install

https://npmjs.com/package/ads1015

npm install ads1015 i2c-bus

*i2c-bus not included in dependencies

To prevent multiple instances of i2c-bus being installed in your project- it is NOT included as a dependency. You just need to install it separately.

This also allows you to swap in a different bus, such as an i2cdriver if desired.

API

ADS1015(bus, addr = 0x48)

Creates an ADS1015 instance using and existing bus object.

ADS1015.open(busNum, addr = 0x48, provider = 'i2c-bus')

Opens an i2c bus and creates a new ads1015 instance.

busNum - The bus to open
addr - The address of the ads1015 device
provider - The i2c module to use to open the bus. (default i2c-bus)
   The module must conform to the i2c-bus@^5.0.0 interface.
   TIP! Try an i2cdriver for development!

ads1015.gain

Gets or sets the gain. You can use a Number or String.

Valid values:
2/3 = +/- 6.144V (default)
1 = +/- 4.096V
2 = +/- 2.048V
4 = +/- 1.024V
8 = +/- 0.512V
16 = +/- 0.256V

ads1015.measure(mux)

Requests a single measurement.

Valid values for mux parameter:
'0+1' = Differential measurement between A0 & A1
'0+3' = Differential measurement between A0 & A3
'1+3' = Differential measurement between A1 & A3
'2+3' = Differential measurement between A2 & A3
'0+GND' = Single-ended measurement on A0
'1+GND' = Single-ended measurement on A1
'2+GND' = Single-ended measurement on A2
'3+GND' = Single-ended measurement on A3

License

MIT