48 lines
1.9 KiB
Markdown
48 lines
1.9 KiB
Markdown
# Virtual Vehicle Simulator
|
|
|
|
A lightweight vehicle simulator that generates CAN telemetry and sends it to the cloud gateway.
|
|
|
|
## Background
|
|
|
|
This service replaces the older `project-ai/tools/k8s-socket-can` tool. We rewrote it because:
|
|
|
|
1. **Simpler deployment** - Pure Go service that runs in K8s without SocketCAN kernel dependencies
|
|
2. **No hardware requirements** - The original required a CAN interface or vcan setup; this generates synthetic frames
|
|
3. **Cloud-native** - Designed for K8s from the start, uses the shared cloud-services build/deploy pipeline
|
|
4. **Self-registering** - Automatically registers with manufacturer API and handles certificate provisioning
|
|
5. **Configurable** - VIN prefix, send interval, and endpoints all configurable via env vars
|
|
|
|
The original k8s-socket-can was designed for testing with real CAN hardware or Linux vcan interfaces. For demo/testing purposes where we just need telemetry flowing through the system, this lightweight simulator is more practical.
|
|
|
|
## Overview
|
|
|
|
This service simulates a connected vehicle (T.Rex) by:
|
|
1. Registering with the manufacturer API to get certificates
|
|
2. Connecting to the gateway via WebSocket with mTLS
|
|
3. Generating and sending CAN frames
|
|
|
|
## Configuration
|
|
|
|
| Env Var | Description | Default |
|
|
|---------|-------------|---------|
|
|
| MANUFACTURER_URL | URL for vehicle registration | http://gateway:8077/manufacture/manufacturer |
|
|
| GATEWAY_WS_URL | WebSocket URL for gateway | ws://gateway:8077/session |
|
|
| API_KEY | API key for manufacturer endpoint | - |
|
|
| VIN_PREFIX | Prefix for generated VIN | VIRTUAL |
|
|
| SEND_INTERVAL_MS | Telemetry interval in ms | 1000 |
|
|
|
|
## CAN Frame IDs
|
|
|
|
| CAN ID | Description |
|
|
|--------|-------------|
|
|
| 0x100 | Speed |
|
|
| 0x101 | RPM |
|
|
| 0x102 | Battery SOC |
|
|
| 0x103 | Battery voltage |
|
|
| 0x104 | Temperature |
|
|
| 0x105 | GPS latitude |
|
|
| 0x106 | GPS longitude |
|
|
| 0x200 | Door status |
|
|
| 0x201 | Light status |
|
|
| 0x300 | HVAC |
|