# DALI ESP-IDF Component

This component provides a DALI (IEC 62386) protocol stack and ESP-IDF HAL implementation that can be used directly in native FreeRTOS/ESP-IDF projects.

## Features

- DALI forward and backward frame support.
- Multi-bus support (`DALI_PHY_COUNT`, default 16).
- Runtime baudrate control (`400..2400`, default `1200`).
- ESP-IDF GPTimer + GPIO interrupt driven HAL.

## Public Headers

- `dali.h`: high-level DALI helpers.
- `dali_hal.h`: HAL API and queue access.
- `dali_define.h`: DALI command definitions.

## Quick Start

1. Add this component to your project.
2. Configure TX/RX pins and initialize at least one bus.
3. Send a DALI frame.

```c
#include "dali.h"
#include "dali_define.h"
#include "dali_hal.h"

void app_main(void) {
    ESP_ERROR_CHECK(dali_hal_set_baudrate(1200));
    ESP_ERROR_CHECK(dali_hal_init(0, 4, 5));

    Dali_msg_t msg = dali_msg_new(0xFF, DALI_CMD_ON); // broadcast ON command
    msg.id = 0;
    dali_send(&msg);
}
```

## Kconfig Options

Use `menuconfig` under `DALI Component` to configure:

- Bus count and default baudrate.
- Native timing values for development, including timer resolution, half-bit period,
    TX/RX stop conditions, query response timeout, double-send delay, and TX queue
    arbitration waits.
- TX/RX active polarity. The native gateway default is TX active low and RX active high.
- Native bus power-down polling, first bus-fail event delay, legacy `FF FD`
    bus-abnormal raw-frame repeat interval, and physical bus reset pulse duration.
- Native DALI HAL log level for the `dali_hal` ESP-IDF log tag.
- Queue sizes.
- Task stack sizes and priorities.
- Optional debug task.

The native bus monitor uses `CONFIG_DALI_BUS_POWER_CHECK_INTERVAL_MS` to resample RX while
power-down, `CONFIG_DALI_BUS_FAIL_EVENT_DELAY_MS` to publish the first legacy `FF FD`
raw frame after a continuous low-bus failure, and
`CONFIG_DALI_BUS_ABNORMAL_REPORT_INTERVAL_MS` for repeat reports while the bus remains
failed. The first delay defaults to 45 ms and the repeat interval defaults to 3000 ms;
set the repeat interval to 0 to disable the compatibility report. USB setup command
`01 00 00` uses `CONFIG_DALI_BUS_RESET_PULSE_MS` to drive the bus low intentionally for
a physical reset pulse, defaulting to 10 ms.

Native timing defaults target standard 1200 bps DALI: a 416.67 us half-bit period is
generated by the default 3.636363 MHz timer. `CONFIG_DALI_CUSTOM_HALF_BIT_TIME_X100_US`
can override the half-bit period for development; keep it at 0 for baudrate-derived timing.
Query no-response timeout defaults to 30 ms, which covers the 5.5-10.5 ms backward-frame
start window plus the approximately 9.95 ms backward frame duration.

Native TX queue arbitration uses frame length as the frame type signal. Two- to four-byte
forward frames wait up to `CONFIG_DALI_FORWARD_MAX_WAIT_MS` for a valid send window,
using `CONFIG_DALI_FORWARD_ACTIVITY_WAIT_MS` after normal bus activity and
`CONFIG_DALI_FORWARD_AFTER_BACKWARD_WAIT_MS` after a valid backward frame. One-byte
backward frames wait up to `CONFIG_DALI_BACKWARD_IDLE_TIMEOUT_MS` for idle, then are
sent without echo verification because addressing-phase collisions are valid.

## API Note

The global TX response queue symbol was renamed:

- old: `dali_send_replay_queue`
- new: `dali_send_reply_queue`

See `MIGRATION.md` for compatibility notes.

## Examples

- `examples/dali_basic`
- `examples/dali_multi_bus`