as1115 0.1.0

Rust driver for ams AS1115 LED Driver IC
Documentation
  • Coverage
  • 21.51%
    20 out of 93 items documented0 out of 22 items with examples
  • Size
  • Source code size: 31.12 kB This is the summed size of all the files inside the crates.io package for this release.
  • Documentation size: 604.17 kB This is the summed size of all files generated by rustdoc for all configured targets
  • Ø build duration
  • this release: 10s Average build duration of successful builds.
  • all releases: 10s Average build duration of successful builds in releases after 2024-10-23.
  • Links
  • nonik0/as1115
    1 0 0
  • crates.io
  • Dependencies
  • Versions
  • Owners
  • nonik0

AS1115 driver

Crates.io Crates.io docs.rs

lint build

Driver for ams AS1115 LED Driver IC. Many thanks to @blemasle's existing AS1115 Arduino library, which I used as a reference implementation.

Features:

  • Using embedded-hal v1.0 traits for maximum compatibility with embedded platforms
  • Generic numeric functions using num-traits for displaying decimal, hexadecimal and floating-point values
  • Support for displaying ASCII characters and custom segment data
  • Also supports hardware's global and individual brightness comtrol, self-test functionality, and keyscan input
  • Example for Arduino Uno, based on avr-hal

Install

To install this driver in your project add the following line to your Cargo.toml's dependencies table:

as1115 = "0.1.0"

For projects needing float support (increases binary size, avoid using on MCUs without native float support):

as1115 = { version = "0.1.0", features = ["display_float_value"] }

How to Use

The AS1115 uses I2C for communication and requires access to an I2C bus that implements the embedded_hal::i2c::I2c trait. This allows the driver to work with any HAL that provides I2C functionality.

use as1115::AS1115;

const NUM_DIGITS: u8 = 4; // AS1115 supports 1-8 seven-segment displays
const INTENSITY: u8 = 3; // global brightness [0-15]

let mut as1115: AS1115<_, NUM_DIGITS> = AS1115::new(i2c_device);
as1115.init(INTENSITY).unwrap();

as1115.display_value(1234).unwrap();
as1115.display_hex_value(0xDEAD).unwrap();
as1115.display_ascii(b"HI").unwrap();

// Requires "display_float_value" feature
as1115.display_float_value(12.34, 2).unwrap();

Or to specify an address using the self-addressing feature (also needs pins wired correctly):

use as1115::AS1115;

const NUM_DIGITS: u8 = 4;
const INTENSITY: u8 = 2;
const I2C_ADDR: u8 = 0x01;

let mut as1115: AS1115<_, NUM_DIGITS> = AS1115::new_with_addr(i2c_device, I2C_ADDR);
as1115.init(INTENSITY).unwrap();

as1115.display_value(4321).unwrap();
as1115.display_hex_value(0xBEEF).unwrap();

// Requires "display_float_value" feature
as1115.display_float_value(432.1, 1).unwrap();

TODO

  • More display configuration options, e.g. enabling leading zeros for values, showing float special values, etc.
  • Handle edge cases better for NUM_DIGITS=1
  • More complete set of tests
  • Implement rest of hardware self-testing functionality