ratel-lis3dhtr
This is an implementation of the LIS3DHTR 3-axis accelerometer for Ratel. This replicates the Arduino library.
Installation
nimble install https://github.com/garrettkinman/ratel-lis3dhtr
Usage
import board
import board / [times, serial, i2c]
import std / strformat
import lis3dhtr
import lis3dhtr / constants
Serial.init(9600.Hz)
Led.output()
I2cBus.init()
# remember to shl 1, as the address is in the 7 MSbits
const sensor: LIS3DHTRDevice = LIS3DHTRDevice(bus: I2cBus, address: LIS3DHTR_ADDRESS_UPDATED shl 1)
sensor.begin()
delayMs(100)
# tiny func for displaying floats over Serial from MCUs
# that struggle with formatting strings with floats
# e.g., the arduino uno
func f2i(f: float32): int =
return (f * 1000).toInt
var
x: float32 = 0.0
y: float32 = 0.0
z: float32 = 0.0
while true:
Led.high()
sensor.getAcceleration(x, y, z)
Serial.send &"x: {x.f2i()}, y: {y.f2i()}, z: {z.f2i()}\p"
delayMs(1000)
Led.low()
delayMs(1000)
Notes
- Not all methods are fully tested, as the purpose of this library was mostly an exercise in recreating an existing C sensor library in Nim for Ratel (if anyone does test them and finds issues, I'm happy to merge a PR or try to make minor fixes)
- Not all docstrings are completed because I simply don't understand what all of them do well enough (if anyone desires to add them, I'm happy to merge a PR)
- The original Arduino library also allows SPI, but Ratel does not support SPI at the time of writing this