Introduction
Kinematrix provides a comprehensive dual-sensor framework supporting both legacy (V1) and modern (V2) sensor implementations. The framework enables unified sensor data collection, processing, and management across 50+ sensor types with advanced features including real-time filtering, alert systems, and calibration management.Architecture
The sensor framework consists of two parallel implementations:Key Features
Type Safety
Template-based type-safe data retrieval with compile-time checking (V2)
Real-Time Filtering
Moving Average, Kalman, Median, and Exponential filters for signal processing
Alert System
Threshold-based monitoring with customizable callbacks and debouncing
Calibration
Interactive calibration with EEPROM persistence and multi-point support
Framework Comparison
| Feature | V1 (Legacy) | V2 (Modern) |
|---|---|---|
| Sensors | 40+ sensors | 14+ sensors (expanding) |
| Data Access | Direct getters | Template-based |
| Type Safety | Runtime | Compile-time |
| Filtering | Basic filtering | Advanced multi-algorithm |
| Alerts | Manual implementation | Built-in alert system |
| Calibration | EEPROM-based | Interactive + EEPROM |
| Memory | Moderate | Optimized |
| API | Function-based | Template + callback |
Supported Sensor Categories
Environmental Monitoring
- Temperature/Humidity: DHT11/22, AHT20, BME280, BME680, SCD30
- Pressure: BME280, BME680 barometric sensors
- Air Quality: Dust sensors, gas sensors (MQ series), CO2 sensors
- Light: Analog light sensors, color sensors (TCS3200)
Industrial Sensors
- Flow Measurement: Flow meters (V1/V2/V3 variants), water flow
- Weight/Load: HX711 load cell sensors
- Power Monitoring: INA219, PZEM004T energy meters
- Temperature: DS18B20, MAX31865 (RTD), MAX6675, MLX90614 (IR)
Position & Motion
- Distance: Ultrasonic sensors
- GPS: NEO-6M/7M/8M GPS modules with TinyGPS++
- RPM: Hall effect and optical RPM sensors
- Orientation: Compass and tilt sensors
Identification & Input
- RFID: MFRC522 card readers
- Barcode: GM67 barcode scanners
- Input: I2C keypads, rotary encoders
- Time: RTC modules (DS1307, DS3231, PCF8523, PCF8563)
Analog & Digital I/O
- Analog Sensors: Voltage, pH, TDS, turbidity, soil moisture
- Digital Sensors: General digital input/output
Biometric
- Pulse Oximeter: MAX30100, MAX3010x heart rate and SpO2
Quick Start
V1 Basic Usage
V2 Basic Usage
Core Classes
BaseSens (V1)
Base class for all V1 sensors:BaseSensV2 (V2)
Modern base class with type safety:Platform Support
ESP32
Full feature support with WiFi/BLE
ESP8266
Complete support with optimization
Arduino
Uno, Nano, Mega compatibility
Migration Guide
From V1 to V2
While V1 remains fully supported, V2 offers enhanced features: V1 Code:Advanced Features
Real-Time Filtering (V2)
Alert System (V2)
Calibration (V2)
Next Steps
Sensor Module V1
Explore the legacy sensor framework with 40+ sensors
Sensor Module V2
Learn about the modern sensor framework
Calibration
Interactive sensor calibration with EEPROM
Filtering
Real-time signal processing algorithms
Best Practices
Coexistence: Both V1 and V2 frameworks can coexist in the same project, allowing gradual migration.