BenchPod Sim

A simulated EmbeddedCI BenchPod wired to a simulated target board, so software that drives a pod can be developed and tested with no hardware.

• benchsim answers the pod's LAN line protocol: power, UART console, logic and ADC captures, the DAC and control loop, emulated sensors from definitions, CAN and SPI flash. Its board is a simulated NUCLEO-F446RE process node, which reads a BMP280 on I2C.
• sensorengine runs the pod's sensor definition engine (the firmware's C, built as WebAssembly) with wazero.
• podsim connects to an EmbeddedCI server over the pod's cloud link, with benchsim behind it.

Try it

go run ./cmd/benchsim -addr 127.0.0.1:18080 -wiring /tmp/wiring.json

Point the BenchPod MCP server or the Python SDK at it:

BENCHPOD_TLS=off BENCHPOD_WIRING=/tmp/wiring.json embeddedci-mcp --connection 127.0.0.1:18080 --la-voltage 3.3

Emulated sensors

sensor_define, sensor_start, sensor_set, sensor_stop, sensor_status, sensor_regs, sensor_la, sensor_fault, sensor_fault_clear and the sensor_stimulus commands take the definitions of the sensor library, or your own, and answer as firmware 3.10.3 does. The register images, UART messages and analog values come from the same engine the pod compiles definitions with, so the node reads what it would read from a real pod. Try bmp280 on LA2 (SDA) and LA1 (SCL) and power-cycle the node.

sensorengine/sensor_def.wasm is a vendored build of benchpod-firmware stm32h563/wasm; its sha256 and the firmware commit are in sensor_def.wasm.sha256. Refresh it with scripts/update-sensor-engine.sh ../benchpod-firmware (needs Homebrew LLVM and LLD, and Node for the engine's own tests).

The simulator models the I2C target (8- and 16-bit register addresses, word registers, commands, the conversion busy flag), UART messages on the sensor's TX pin and analog sensors on the DAC output. It does not model the sensor FIFO, data-ready pins, on_write rules beyond storing the byte, UART requests from the DUT, the SPI bus on the wire or the 4-20 mA output.

What it is not

It is a model of the firmware, not proof of it. Analog is idealized, firmware signatures are not checked, and some commands answer that they are not modeled. Test on a real pod before you rely on timing or electrical behavior.

Tests

go test ./...

TestMCPEndToEnd also runs when BENCHPOD_MCP_COMMAND points at embeddedci-mcp.

License

Apache License 2.0. See LICENSE.