Expand description
Concrete sensor drivers for the pamoja SDK.
pamoja-gpio builds the address and mode bytes a
controller puts on an I2C or SPI bus; this crate is the layer just above it, the
per-part knowledge that turns the raw register bytes a specific sensor returns
into a physical reading. Each module is one named part: it knows that part’s
register map, builds the bytes that configure it, and decodes what it sends back,
applying the exact conversion the manufacturer’s datasheet specifies.
Like the rest of the SDK’s hardware crates, these are the decode-and-configure
half ahead of the actual bus driver: pure logic with no I/O, so the same code runs
on a microcontroller and in a test. A caller pairs a module here with whatever
performs the transfers (a pamoja-gpio Linux backend, an embedded-hal bus, or a
simulator) and gets calibrated readings without re-deriving a datasheet.
The conversions are anchored to each datasheet’s own reference values, since they are where memory-driven bugs hide. The BME280 compensation is ported from Bosch’s published reference code and cross-checked against its floating-point form; the DS18B20 decode is pinned to the datasheet’s temperature/data table and its CRC to the Maxim 1-Wire polynomial; the INA219 math is checked against the datasheet’s worked design example; the ADS1115 full-scale conversion against its per-gain LSB sizes. The parts added after those follow the same rule: the BMP280 port of Bosch’s integer compensation against its floating-point form; the SHT3x and SCD4x conversions against the endpoints of their linear formulas, their command words against the tables, and their CRC-8 against Sensirion’s published check value; the TMP117 decode against its temperature data table; the HDC1080 equations against their endpoints and identification registers; the OPT3001 lux decode against its table of worked result words and its full-scale table; the INA226 math against the datasheet’s calibration example.
bme280- Bosch temperature, pressure, and humidity over I2C or SPI.bmp280- Bosch pressure and temperature, the BME280 without humidity.ds18b20- Maxim 1-Wire digital thermometer, with CRC-checked scratchpads.hdc1080- Texas Instruments low-power I2C humidity and temperature sensor.ina219- Texas Instruments high-side current, voltage, and power monitor.ina226- Texas Instruments high- or low-side current, voltage, and power monitor with an alert pin.ads1115- Texas Instruments 16-bit I2C analog-to-digital converter.opt3001- Texas Instruments ambient light sensor with a human-eye response.scd4x- Sensirion SCD40 and SCD41 photoacoustic CO2 sensors with humidity and temperature, over I2C.sht3x- Sensirion humidity and temperature sensor, with CRC-checked words.tmp117- Texas Instruments ±0.1 °C digital temperature sensor with alert limits.
Modules§
- ads1115
- Texas Instruments ADS1115 16-bit I2C analog-to-digital converter.
- bme280
- Bosch BME280 temperature, pressure, and humidity sensor.
- bmp280
- Bosch BMP280 digital pressure sensor.
- ds18b20
- Maxim DS18B20 1-Wire digital thermometer.
- hdc1080
- Texas Instruments HDC1080 low-power humidity and temperature sensor.
- ina219
- Texas Instruments INA219 high-side current, voltage, and power monitor.
- ina226
- Texas Instruments INA226 high-side or low-side current, voltage, and power monitor.
- opt3001
- Texas Instruments OPT3001 ambient light sensor.
- scd4x
- Sensirion SCD40 and SCD41 CO2, temperature, and humidity sensor.
- sht3x
- Sensirion SHT3x-DIS humidity and temperature sensor (SHT30, SHT31, SHT35).
- tmp117
- Texas Instruments TMP117 high-accuracy digital temperature sensor.
Enums§
- Sensor
Error - What can go wrong turning a part’s raw bytes into a reading.