# CAN and DBC

This project uses a DBC-driven workflow to encode/decode CAN frames consistently across the RX and TX targets.

## Sources and generated code

- DBC source: `tools/Lecture.dbc`
- Generated C wrapper (do not edit): `lib/Generated/lib/lecture.{c,h}`
- Single include in the project: `src/generated_lecture_dbc.c` (pulls in the generated library)

Note: the generator produces a driver named `lecture` (that's the `-drvname` value used here). Include
`lib/Generated/lib/lecture.h` in your code to get the generated types and helper functions (for example
`Cluster_t`, `Pack_Cluster_lecture(...)`, `Unpack_Cluster_lecture(...)`). The project also provides
`src/generated_lecture_dbc.c` which includes the generated C file directly for the build.

Driver abstraction lives under `lib/CanDriver/` and supports the ESP32 internal CAN controller and common external controllers.

## Regenerating from DBC (Windows)

1. Ensure the DBC is saved at `tools/Lecture.dbc`.
2. Run the generator (Windows only, provided in repo):

   - Tool: `tools/c-coderdbc/build/coderdbc.exe`
   - Output folder (autodetected by script): `lib/Generated/` (subfolders are managed by the generator)

   - Example (Windows, run from the repository root):

     ```cmd
     tools\c-coderdbc\build\Debug\coderdbc.exe -dbc tools\Lecture.dbc -out lib\Generated -drvname lecture -rw
     ```

3. Commit the updated files under `lib/Generated/`.

The code should always use the generated types and pack/unpack helpers:

- Type: `Cluster_t`
- Pack: `Pack_Cluster_lecture(...)`
- Unpack: `Unpack_Cluster_lecture(...)`

## RX mailbox and topics

- RX config: mailbox filter listening to ID `0x65` via `CAN0.watchFor(0x65)`
- Data flow: ISR → EventQueue → SystemController → MessageRouter → UI/IOModule
- Router publishes `Cluster_t` with sticky last value and a millis() timestamp. Consumers subscribe to receive updates.

## TX specifics

- No LVGL; keep `CAN0.setDebuggingMode(true)` during development
- Send `Cluster_t` using `Pack_Cluster_lecture` on each cycle

See also `ARCHITECTURE.md` for the broader system overview and `include/TFTConfiguration.h` for display configuration (RX only).