Note
This service originally lived in the main Mapache repository. It was split into this repository as an archival snapshot while Mapache undergoes a complete v4 rewrite.
Porsche 987 Mapache Ingest translates CAN telemetry relayed by the TCM-987 project into Mapache signals. It supports the Porsche 987 Cayman and Boxster platform.
- The service consumes MQTT messages addressed as
p987/{vehicle_id}/{bus}/{can_id}. - Each payload contains an 8-byte big-endian microsecond timestamp, a 2-byte upload key, and the raw CAN payload.
- The upload key is validated against Mapache's vehicle service.
- The physical bus and CAN arbitration ID select a Porsche-specific decoder for modules including the DME, gateway, climate control, PAS, PDK, PSM, SCCM, and TCM.
- Known frames are converted into Mapache signals. Unknown IDs and decode failures are retained as raw frames with status metadata and included in periodic decode reports.
- Decoded signals are written to ClickHouse and published to
query/live/{vehicle_id}/{signal_name}.
The MQTT subscription is shared so multiple service replicas can divide incoming frames without processing each frame more than once.
Decoded values use the Mapache v3 Signal schema in the shared ClickHouse signal table. Signal names are prefixed with the physical CAN bus and include the vehicle ID, numeric and raw values, microsecond timestamp, production time, and ingestion time.
Raw frames are stored in p987_can with the vehicle, bus, CAN ID, original bytes, upload key, timestamps, and JSON decode metadata. Ping data uses Mapache's shared ClickHouse ping schema.
go build ./...The service requires MQTT and can optionally connect to ClickHouse and Mapache's vehicle-authentication endpoint. See config/config.go for the accepted settings.