Repository navigation
Releases
Releases · mitre/hvac-sim
v5.0.0
Breaking
- The combined hvac-simulator-facts.yml is removed; each scenario has its own fact source in docs/sources/
Fixed
- Every scenario runs as its doc describes: each adversary profile has its own fact source with one value per fact
Added
WIRESHARK_PORTsets the capture sidecar's port
Changed
- Scenarios list T1692.001, which replaces T0855 in ATT&CK for ICS
v4.0.0
Breaking
- The Docker Compose services
hvac-simandweb-hmiare renamedplcandhmi - 47808/udp is no longer published to the host; reach the PLC from the Docker network
- The PLC binds to its interface address by default instead of 127.0.0.1/24
Added
- Shared
--config,--hostand--portflags;--ini,--addressand--device-ipstill work and print a deprecation warning - A directed Who-Is when the broadcast gets no answer, so
--portworks on any port - The PLC logs each value a client changes
- HMI screenshots in the scenarios
Changed
- Same layout,
run.pylauncher, log format and Docker kit as the other simulators - The HMI and Caldera wait for the PLC to answer before starting
- The lab's ports are published on 127.0.0.1 only; 8443 is no longer published
- The HMI assumes a /24 mask when it cannot read the interface mask
- bacpypes3 is pinned; the unused pyasyncore and pyyaml are dropped
Removed
- The
temperature_unitsetting; use the HMI's--fahrenheit
Fixed
- Exit status 1 when the BACnet device fails to start
- The HMI ignored
--device-id - The device object answered as "BAC0" instead of HVACSim
- Temperature objects reported percent instead of degrees Celsius
- Caldera facts for Read Property and Object Collection, the missing analog-input type, and the Collection tactic
- The bacrp and bacwp examples
v3.0.0
Breaking
python3 hvac_sim.pyis replaced bypython3 -m simulator.plcandpython3 -m simulator.hmi- The simulator's own dashboard is removed. The web HMI polls the simulator over BACnet.
Changed
- Split hvac_sim.py into a simulator package: process model, BACnet PLC, address handling, HMI client, and desktop window
Added
- Unit tests for the process model, run in CI
v2.0.0
Added
- Caldera scenarios, fact source, and adversary profiles
- Docker support with Caldera, a Sandcat agent, and an optional Wireshark capture sidecar
- Web HMI
- Headless mode
- Temperature unit setting and text box controls
- CI that builds the containers and runs the smoke test
- NOTICE
Changed
- Moved from BACpypes to BAC0
- Standard BACnet object types
v1.0.0
Overview
Initial release of HVACSim by University of Hawaii at Manoa students Elijah Saloma and Jake Dickinson, part of MITRE Caldera™ for OT.