How chinmayim-bhise/ics-laboratory works
ICS Laboratory is a hardware-based mini-power-plant SCADA and OT-security testbed. Its main workflow runs a physical process through an ESP8266 PLC, exposes supervisory control through an HMI, and monitors protocol traffic for alerts sent to Wazuh and supported by incident-response playbooks. A separate threat injector demonstrates Modbus, MQTT, and UDP attack scenarios. Firmware and attack-tool details are sampled; HMI, Wazuh configuration, and playbook relationships are represented at the level documented in the README, so their internal implementation is not inferred.
Main entry points: PLC_Node.ino PLC Field Node · HMI_Node.ino HMI Dashboard · ot_soc_sensor.py OT SOC Sensor · ot_threat_injector.py Threat Injector
Components 11
Plant Control
- Sensors and Actuators
- PLC Field Node
PLC_Node/PLC_Node.ino - HMI Dashboard
HMI_Node/HMI_Node.ino
OT Monitoring
- OT SOC Sensor
soc_engine/ot_soc_sensor.py
Threat Simulation
- Threat Injector
tools/ot_threat_injector.py
SOC Response
- Wazuh SIEM
- OT Decoders
wazuh/decoders/ot_ics_decoders.xml - OT Correlation Rules
wazuh/rules/ot_ics_rules.xml - Incident Playbooks
playbooks
Other components
- MQTT Broker
- Operator / Attacker
Connections 15
- Sensors and Actuators → PLC Field Node: provides GPIO inputs
README.md - PLC Field Node → Sensors and Actuators: drives actuators
README.md - PLC Field Node → HMI Dashboard: exchanges Modbus/MQTT
README.md - HMI Dashboard → PLC Field Node: sends supervisory control
README.md - PLC Field Node → MQTT Broker: publishes and subscribes
README.md - HMI Dashboard → MQTT Broker: bridges supervisory topics
README.md - MQTT Broker → OT SOC Sensor: delivers monitored traffic
soc_engine/ot_soc_sensor.py - OT SOC Sensor → PLC Field Node: polls Modbus registers
soc_engine/ot_soc_sensor.py - OT SOC Sensor → Wazuh SIEM: sends JSON Syslog alerts
soc_engine/ot_soc_sensor.py - Operator / Attacker → Threat Injector: selects attack scenario
tools/ot_threat_injector.py - Threat Injector → PLC Field Node: injects Modbus and UDP commands
tools/ot_threat_injector.py - Threat Injector → MQTT Broker: publishes attack messages
tools/ot_threat_injector.py - OT Decoders → Wazuh SIEM: configures event decoding
README.md - OT Correlation Rules → Wazuh SIEM: configures alert rules
README.md - Wazuh SIEM → Incident Playbooks: supports incident response
README.md