AutoLight V3 Firmware

Firmware/
├── Core/                          # Core system components
│   ├── Channel/                   # LED control system
│   │   ├── BaseChannel/           # Main LED controller
│   │   │   ├── BaseChannel.h/.cpp      # LED management (33KB)
│   │   │   └── BaseChannelSequence.cpp # 16 sequences (107KB)
│   │   └── Indicator.h/.cpp       # Status indicators
│   ├── Config/                    # Configuration management
│   │   ├── BaseConfig.h/.cpp      # Dynamic PCF distribution
│   │   ├── ConfigManager.h/.cpp   # Singleton manager
│   │   └── ConfigData.h           # Data structures
│   ├── Interaction/               # User interaction
│   │   ├── ButtonInterrupt.h/.cpp # Multi-modal buttons
│   │   └── SerialCommander.h/.cpp # CLI interface
│   ├── Cores/                     # System services
│   │   └── Task.h/.cpp            # FreeRTOS wrapper
│   └── Common/
│       └── Constants.h            # System constants
└── API/                           # REST API server
    └── APIServerManager.h/.cpp    # Web server (port 8000)

#define ENABLE_ADDONS_AUTOLIGHT_V3
#include "Kinematrix.h"
using namespace AutoLight;

BaseChannel led;
BaseConfig config;

void setup() {
    Serial.begin(115200);

    // Dynamic PCF configuration
    config.setDynamicConfig(12, 2);  // 12 channels, 2 PCF8574s
    led.attachConfig(config.getConfigData());
    led.initialize();

    // Enable integrated systems
    led.enableWebServer(true);       // REST API on port 8000
    led.setButtonMode(BUTTON_MODE_1BUTTON);
}

void loop() {
    led.runAutoLight();
    delay(10);
}

void setup() {
    // Enable web server with automatic FreeRTOS task
    led.enableWebServer(true);
    
    // Or manual mode
    led.enableWebServerManual();
}

SerialCommander cmd;

void setup() {
    Serial.begin(115200);
    cmd.init(led, config, button);
}

void loop() {
    cmd.process();  // Handle serial commands
    led.runAutoLight();
    delay(10);
}

struct PCFDistribution {
    uint8_t address;         // I2C address (0x20-0x27)
    uint8_t used_pins;       // Allocated pins (1-8)
    uint8_t start_channel;   // Starting channel number
    uint8_t pin_offset;      // Pin offset within PCF
    bool is_active;          // PCF status
};

typedef enum {
    DISTRIBUTE_BALANCED = 0,    // Even distribution across PCFs
    DISTRIBUTE_SEQUENTIAL = 1,  // Fill PCFs sequentially
    DISTRIBUTE_OPTIMIZED = 2,   // Minimize PCF usage
    DISTRIBUTE_CUSTOM = 3       // Manual configuration
} distribution_strategy_t;

typedef enum {
    BUTTON_MODE_4BUTTON = 0,  // ON/OFF/NEXT/PREV (legacy)
    BUTTON_MODE_1BUTTON = 1,  // Single cycle: OFF→ON→Mode2-15→OFF
    BUTTON_MODE_2BUTTON = 2,  // Toggle + Next
    BUTTON_MODE_3BUTTON = 3,  // Separate ON/OFF/Next
    BUTTON_MODE_CUSTOM = 99   // User-defined handlers
} button_mode_t;

typedef struct {
    ConfigHeader header;     // Channel count, pin pointers, I2C addresses
    ConfigTable table;       // Address and version tables
} ConfigData;

// Enable sequence mapping
led.enableSequenceMapping(true);

// Set active sequences (only modes 2, 5, 7, 10, 12 accessible)
led.setActiveSequences(5, 2, 5, 7, 10, 12);

// Reorder active sequences
uint8_t new_order[] = {12, 10, 7, 5, 2};
led.reorderActiveSequences(new_order, 5);

// Debug output
led.printSequenceMapping();

wifi ap <ssid> <password>     # Start access point mode
wifi sta <ssid> <password>    # Connect to WiFi network
wifi scan                     # Scan available networks
wifi status                   # Show connection status
wifi restart                  # Restart WiFi AP
wifi reset                    # Reset to default credentials
wifi clients                  # Show connected clients

led on                        # Turn all LEDs on
led off                       # Turn all LEDs off
led test <channel>            # Test specific channel
led status                    # Show all channel states
led next                      # Next sequence mode
led prev                      # Previous sequence mode

sequence set <mode>           # Set LED sequence (0-15)
sequence map enable           # Enable sequence filtering
sequence map set 2,5,7,10     # Set active sequences
sequence map show             # Display current mapping
sequence delay <ms>           # Set timing delay (30-300ms)

pcf scan                      # Scan I2C bus for devices
pcf test <address>            # Test PCF at hex address (e.g., 0x27)
pcf status                    # Show all PCF states
pcf reset <address>           # Reset specific PCF
pcf write <address> <data>    # Write byte to PCF
pcf read <address>            # Read byte from PCF

button mode <0-3>             # Set button mode
button test <index>           # Test button action
button config                 # Show current config

const int RGB_LED_RED = 14;
const int RGB_LED_GREEN = 12;
const int RGB_LED_BLUE = 13;
const int BUZZER_PIN = 15;

const int MAXNUM_CHANNEL = 64;              // Maximum LED channels
const int MAXNUM_IO_EXPANDER = 8;           // Maximum PCF8574 units
const int MAXNUM_TOTAL_TASK_SEQUENCE = 16;  // Total sequence modes
const int DEFAULT_DELAY_TIME = 50;          // Default timing (ms)

#define ENABLE_ADDONS_AUTOLIGHT_V3
#include "Kinematrix.h"
using namespace AutoLight;

BaseChannel led;
BaseConfig config;
SerialCommander cmd;

void setup() {
    Serial.begin(115200);

    // SerialCommander for CLI debugging
    cmd.init(led, config, button);

    // Advanced PCF configuration
    config.setDistributionStrategy(DISTRIBUTE_OPTIMIZED);
    config.setDynamicConfig(24, 3);  // 24 channels across 3 PCFs

    // Sequence mapping (filter available modes)
    led.enableSequenceMapping(true);
    led.setActiveSequences(5, 2, 5, 7, 10, 12);  // Only modes 2,5,7,10,12

    // Multi-modal button
    led.setButtonMode(BUTTON_MODE_1BUTTON);

    led.initialize();
    led.enableWebServer(true);
}

void loop() {
    led.runAutoLight();
    cmd.process();  // Handle serial commands
    delay(10);
}