# Sensor Integration

> Integrate hardware sensors — I2C/SPI drivers, calibration, signal filtering, and sensor fusion algorithms

- Skill: `uitbreidenos/sensor-integration` (Agent Skill)
- Install (CLI): `npx skillmds@latest add uitbreidenos/sensor-integration`
- Raw SKILL.md: https://api.skillmd.com/api/skills/uitbreidenos/sensor-integration/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: UitbreidenOS (https://skillmd.com/u/uitbreidenos)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/uitbreidenos/sensor-integration

---


## When to activate

- Writing drivers for I2C/SPI sensors
- Implementing sensor calibration routines
- Designing signal filtering pipelines (Kalman, moving average, complementary)
- Building sensor fusion algorithms (IMU + magnetometer)
- Debugging noisy or unreliable sensor readings

## When NOT to use

- For camera/vision sensors (different pipeline)
- For analog-only sensor circuits
- For sensor hardware selection/procurement

## Instructions

1. **Interface selection.** I2C (simple, shared bus, slow), SPI (fast, full-duplex, more pins), UART (simple, point-to-point).
2. **Driver implementation.** Init sequence (from datasheet), read register, write register, data conversion (raw → engineering units).
3. **Calibration.** Factory calibration (read from sensor), user calibration (zero-offset, scale factor), temperature compensation.
4. **Filtering.** Moving average (simple), Low-pass IIR (efficient), Kalman filter (optimal for noisy + model), Complementary filter (IMU fusion).
5. **Sensor fusion.** Combine accelerometer + gyroscope (complementary/Kalman). Add magnetometer for absolute heading. Quaternion representation.
6. **Sampling strategy.** Oversampling + decimation for noise reduction. Match sample rate to signal bandwidth (Nyquist).
7. **Error handling.** I2C NACK detection, timeout, CRC validation, range checking, stuck-at detection.

## Example

```c
// BME280 temperature reading with calibration
float read_temperature(BME280 *dev) {
    uint8_t raw[3];
    i2c_read(dev->addr, 0xFA, raw, 3);  // temp registers
    
    int32_t adc_T = (raw[0] << 12) | (raw[1] << 4) | (raw[2] >> 4);
    
    // Compensation formula from datasheet
    int32_t var1 = ((((adc_T >> 3) - (dev->cal.dig_T1 << 1))) * dev->cal.dig_T2) >> 11;
    int32_t var2 = (((((adc_T >> 4) - dev->cal.dig_T1) * ((adc_T >> 4) - dev->cal.dig_T1)) >> 12) * dev->cal.dig_T3) >> 14;
    
    return ((var1 + var2) * 5 + 128) / 25600.0f;  // Temperature in °C
}

// Complementary filter for IMU orientation
float angle = 0.98f * (angle + gyro_rate * dt) + 0.02f * accel_angle;
```