Skip to content

bolderflight/ams5915

main
Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
img
 
 
src
 
 
 
 
 
 
 
 
 
 
 
 

License: MIT

Bolder Flight Systems Logo     Arduino Logo

Ams5915

This library communicates with AMS-5915 pressure transducers and is compatible with Arduino and CMake build systems.

Description

The Analog Microelectronics AMS-5915 pressure transducers are fully signal conditioned, amplified, and temperature compensated over a temperature range of -25 to +85 C. These sensors generate data with high precision, high stability and low drift. Digital measurements are sampled with a 14 bit resolution. The AMS-5915 sensors are available in a wide variety of pressure ranges and in configurations suited for barometric, differential, and bidirectional differential measurement.

Usage

This library communicates with the AMS 5915 sensors using an I2C interface. The default I2C address for the AMS-5915 is 0x28; however, a USB starter kit may be purchased to enable programming additional addresses. Pressure and temperature data can be provided at rates of up to 2 kHz.

Installation

Arduino

Simply clone or download and extract the zipped library into your Arduino/libraries folder. The library is added as:

#include "ams5915.h"

An example Arduino executable is located in: examples/arduino/ams5915_example/ams5915_example.ino. Teensy 3.x, 4.x, and LC devices are used for testing under Arduino and this library should be compatible with other Arduino devices.

CMake

CMake is used to build this library, which is exported as a library target called ams5915. The header is added as:

#include "ams5915.h"

The library can be also be compiled stand-alone using the CMake idiom of creating a build directory and then, from within that directory issuing:

cmake .. -DMCU=MK66FX1M0
make

This will build the library and an example executable called ams5915_example. The example executable source file is located at examples/cmake/ams5915_example.cc. Notice that the cmake command includes a define specifying the microcontroller the code is being compiled for. This is required to correctly configure the code, CPU frequency, and compile/linker options. The available MCUs are:

  • MK20DX128
  • MK20DX256
  • MK64FX512
  • MK66FX1M0
  • MKL26Z64
  • IMXRT1062_T40
  • IMXRT1062_T41
  • IMXRT1062_MMOD

These are known to work with the same packages used in Teensy products. Also switching packages is known to work well, as long as it's only a package change.

Each target also has a _hex, for creating the hex file to upload to the microcontroller, and an _upload for using the Teensy CLI Uploader to flash the Teensy. Please note that the CMake build tooling is expected to be run under Linux or WSL, instructions for setting up your build environment can be found in our build-tools repo.

Namespace

This library is within the namespace bfs.

Ams5915

Ams5915() Default constructor, requires calling the Config method to setup the I2C bus, I2C address, and transducer type.

Ams5915(i2c_t3 *bus, const uint8_t addr, const Transducer type) Creates an Ams5915 object. A pointer to the I2C bus object is passed along with the I2C address of the sensor and the AMS-5915 transducer type. The enumerated transducer types are:

Sensor Name Enumerated Type Pressure Type Pressure Range
AMS 5915-0005-D AMS5915_0005_D differential / relative 0...500 Pa
AMS 5915-0010-D AMS5915_0010_D differential / relative 0...1000 Pa
AMS 5915-0005-D-B AMS5915_0005_D_B bidirectional differential -500...+500 Pa
AMS 5915-0010-D-B AMS5915_0010_D_B bidirectional differential -1000...+1000 Pa
AMS 5915-0020-D AMS5915_0020_D differential / relative 0...2000 Pa
AMS 5915-0050-D AMS5915_0050_D differential / relative 0...5000 Pa
AMS 5915-0100-D AMS5915_0100_D differential / relative 0...10000 Pa
AMS 5915-0020-D-B AMS5915_0020_D_B bidirectional differential -2000...+2000 Pa
AMS 5915-0050-D-B AMS5915_0050_D_B bidirectional differential -5000...+5000 Pa
AMS 5915-0100-D-B AMS5915_0100_D_B bidirectional differential -10000...+10000 Pa
AMS 5915-0200-D AMS5915_0200_D differential / relative 0...20000 Pa
AMS 5915-0350-D AMS5915_0350_D differential / relative 0...35000 Pa
AMS 5915-1000-D AMS5915_1000_D differential / relative 0...100000 Pa
AMS 5915-2000-D AMS5915_2000_D differential / relative 0...200000 Pa
AMS 5915-4000-D AMS5915_4000_D differential / relative 0...400000 Pa
AMS 5915-7000-D AMS5915_7000_D differential / relative 0...700000 Pa
AMS 5915-10000-D AMS5915_10000_D differential / relative 0...1000000 Pa
AMS 5915-0200-D-B AMS5915_0200_D_B bidirectional differential -20000...+20000 Pa
AMS 5915-0350-D-B AMS5915_0350_D_B bidirectional differential -35000...+35000 Pa
AMS 5915-1000-D-B AMS5915_1000_D_B bidirectional differential -100000...+100000 Pa
AMS 5915-1000-A AMS5915_1000_A absolute 0...100000 Pa
AMS 5915-1200-B AMS5915_1200_B barometric 70000...120000 Pa

For example, the following code declares an AMS5915 object called ams with an AMS5915-1200-B sensor located on I2C bus 0 with an I2C address of 0x10:

bfs::Ams5915 ams(&Wire, 0x10, bfs::Ams5915::AMS5915_1200_B);

void Config(TwoWire *bus, const uint8_t addr, const Transducer type) This is required when using the default constructor and sets up the I2C bus, I2C address, and transducer type.

bool Begin() Initializes communication with the sensor and configures the sensor driver for the specified transducer. True is returned if communication is able to be established with the sensor and configuration completes successfully, otherwise, false is returned. The communication bus is not initialized within this library and must be initialized seperately; this enhances compatibility with other sensors that may on the same bus.

Wire.begin();
Wire.setClock(400000);
bool status = ams.Begin();
if (!status) {
  // ERROR
}

bool Read() Reads data from the AMS-5915 and stores the data in the Ams5915 object. Returns true if data is successfully read, otherwise, returns false.

/* Read the sensor data */
if (ams.Read()) {
}

float pres_pa() Returns the pressure data from the Ams5915 object in units of Pa.

float pressure = ams.pres_pa();

float die_temp_c Returns the die temperature of the sensor from the Ams5915 object in units of degrees C.

float temperature = ams.die_temp_c();

Example List

  • ams5915_example: demonstrates declaring an object, initializing the sensor, and collecting data. In this example the sensor is an AMS5915-1200-B with a sensor address of 0x12 located on I2C bus 0.

Wiring and Pullups

Please refer to the Analog Microelectronics AMS 5915 datasheet and your microcontroller's pinout diagram.

The silver dot on the AMS 5915 marks the location of Pin 1. The AMS 5915 pinout is:

  • Pin 1: Ground
  • Pin 2: VCC, this should be a 3.0V to 3.6V power source.
  • Pin 3: SDA
  • Pin 4: SCL

2.2 kOhm resistors should be used as pullups on SDA and SCL, these resistors should pullup with a 3.3V source.

About

Arduino and CMake library for communicating with Analog Microelectronics AMS 5915 pressure transducers.

Topics

Resources

License

Stars

Watchers

Forks