cloud-services/pkg/dbc/README.md

DBC Package

CAN database (DBC) signal definitions and parsing utilities.

Structure

• models/ - Core types (DBCCollection, CANMessage, CANSignal)
• state/ - State tracking for CAN signals
• diagnostics/ - Diagnostic signal handling
• fm29_*/, n60/ - Generated packages from DBC files (stubs by default)

Generated Packages

The fm29_* and n60 packages contain CAN signal definitions generated from DBC files. By default, these are stubs that return empty collections.

To generate real definitions, you need:

1. DBC source files (from CEC-Common repo or equivalent)
2. The cantool from pkg/can-go

Generating DBC Code

# From cloud-services root
go run ./pkg/can-go/cmd/cantool generate /path/to/dbc/files ./pkg/dbc

Or use the generate script:

./scripts/generate-dbc.sh /path/to/dbc/files

When Do You Need Real DBC Packages?

• Gateway: Uses only dbc/models - stubs are fine
• Optimus: Needs real DBC for CAN signal parsing
• Ditto: Needs real DBC for digital twin state
• Beacon: Needs real DBC for diagnostic alerts

Adding New DBC Versions

1. Add DBC files to source directory
2. Run cantool generate
3. Update new_dbc_collection.go to include new version