Documentation

Simulators and test utilities

Verified Modbus simulator behavior and supporting infrastructure tests.

Status: VerifiedSources: 3

The unified simulator generates approximately 1000 petroleum variables across 5 wells, writes a CSV matching the backend Modbus TCP import contract, serves an HTTP dashboard, and can run a Modbus TCP server when the supported pymodbus version is installed.

ContractVerified value
Modbus port5020
HTTP dashboard port8085
Supported pymodbus version3.6.9
Generated rows1000 variables across UnitId 1..5

Pending validation

  • End-to-end ingestion from simulator CSV through backend import and agent deployment should be validated separately.
  • MQTT auth tests exist under infrastructure/tests, but production broker policy should be checked against deployed go-auth configuration.

Source basis

  • tests/simulators/unified_simulator.py
  • tests/simulators/test_unified_simulator_contract.py
  • infrastructure/tests/test_mqtt_auth.py