Skip to main content
Version Badge

What is Kinematrix?

Kinematrix Beta is a sophisticated, modular Arduino library framework designed to dramatically simplify IoT and embedded systems development. It provides a unified, abstracted API for managing sensors, communication protocols, displays, control algorithms, file systems, and hardware components across multiple microcontroller platforms. With 156+ modules and a dual sensor framework supporting 40+ sensors, Kinematrix bridges the gap between simple Arduino sketches and professional embedded systems development.

Core Philosophy

Modular Architecture

Conditional compilation system allowing selective inclusion of only required components. Optimize memory from 50KB to 500KB+ based on your needs.

Platform Agnostic

Unified API supporting ESP32, ESP8266, and AVR-based Arduino boards with automatic platform detection and optimization.

Educational Focus

Designed for both beginners and professionals with 254+ comprehensive examples organized by complexity level.

Production Ready

Advanced features like calibration, filtering, alerts, data persistence, and cloud integration ready for deployment.

Key Features

Dual Sensor Framework

SensorModuleV1

Traditional callback-based system supporting 40+ sensors including DHT, BME280/680, DS18B20, GPS, RFID, and more.

SensorModuleV2

Modern type-safe framework with real-time filtering, alerts, calibration, and advanced features for 14+ sensors.

Communication Modules (15+)

  • I2C Expansion: PCF8574 I/O expanders with dynamic distribution
  • Modbus: RTU and ASCII protocols for industrial automation
  • Serial: Enhanced, Hardware, Software, NEMA, and Swap variants
  • SPI: High-speed communication and dot matrix control

Control Algorithms (7+)

PID Controllers

Auto-tuning with Ziegler-Nichols and Cohen-Coon methods, EEPROM persistence, integral windup protection.

Fuzzy Logic

Three implementations: Mamdani, Sugeno, and Tsukamoto for different control scenarios.

Machine Learning

KNN classification and Decision Trees with cross-validation and model persistence.

AutoLight Ecosystem

Revolutionary LED control system with four generations of evolution:
  • AutoLight V3: Dynamic PCF8574 distribution, multi-modal buttons, REST API integration
  • JavaScript Simulator: Microsecond-accurate browser-based LED pattern development
  • Pattern Builder: Desktop tool with 4 simulation modes (Visual, Expression, C++, JavaScript)
  • WebClient: Next.js 15 + React 19 interface with real-time preview

Platform Support

ESP32

Primary TargetFull feature set with WiFi/Bluetooth, 240MHz dual-core, 520KB SRAM. Advanced features: Firebase, MQTT, cloud integrations.

ESP8266

SecondaryWiFi capabilities optimized for 80KB SRAM. Internet connectivity with memory optimization.

AVR

LimitedArduino Uno/Nano/Mega compatibility. Basic I/O and sensor operations for resource-constrained environments.

Memory Optimization

Kinematrix’s modular architecture allows you to include only what you need:
1

Minimal Setup (~50KB)

Basic sensors and I/O operations for simple projects on AVR platforms.
2

Standard Setup (~200KB)

Sensors plus communication modules for typical IoT applications on ESP8266.
3

Full-Featured (~500KB+)

All modules enabled including cloud services, ML algorithms, and advanced features on ESP32.

Quick Example

// Enable only the modules you need
#define ENABLE_SENSOR_MODULE_V2
#define ENABLE_SENSOR_BME680_V2
#define ENABLE_MODULE_MQTT_MANAGER
#include "Kinematrix.h"

BME680SensV2 environmental;
MQTTManager mqtt;

void setup() {
    Serial.begin(115200);
    
    // Initialize sensor with 5-second update interval
    environmental.setUpdateInterval(5000);
    environmental.init();
    
    // Connect to MQTT broker
    mqtt.begin("mqtt.example.com", 1883);
}

void loop() {
    environmental.update();
    
    // Publish sensor data
    mqtt.publish("sensors/temp", String(environmental.getTemperature()));
    mqtt.publish("sensors/humidity", String(environmental.getHumidity()));
    
    delay(1000);
}

What’s Next?

Installation

Get started by installing Kinematrix in your development environment

Quick Start

Build your first IoT project with a complete working example

Architecture

Understand the framework’s modular design and compilation system

Examples

Explore 254+ examples from basic to advanced implementations

Open Source & Community

Kinematrix is licensed under the MIT License, making it free to use for both personal and commercial projects. Contributions and feedback are welcome!

Kinematrix Beta v0.0.28 - Built with ❤️ for the IoT community

Build docs developers (and LLMs) love