Repository navigation
Home
Disclaimer. This code is part of the IT/OT Academy, offered by The IT/OT Insider. It is a generated, vibe-coded system made only for demo purposes. It may not be used for anything other than demonstration or training: not in production, not connected to real equipment, and not as the basis for any real control, quality or maintenance decision.
Cromley Hydraulics (CH) is a fictional machine builder with 75 years of dam hydraulics experience and an engineering-first culture. Its turbines used to be delivered, integrated into the customer's control system and forgotten. CH now fits every major turbine with a modern PLC that speaks MQTT, to move from reactive to proactive maintenance and to explore a data-driven business model.
The environment is Copper Canyon Dam, a small fictional hydropower dam run by the fictional Desert River Water & Power Authority (DRWPA): one reservoir, one intake and penstock, three 40 MW CH Francis turbines, a spillway and a bottom outlet. Everything talks to one local Mosquitto broker, over MQTT only.

CH is the third ITOT.Academy environment. It teaches the machine-builder view of industrial data:
- the customer's own ISA-95 tree (
v1.0/DRWPA/CopperCanyon/...), published by the dam and used by the dam SCADA, which also sends its commands over MQTT; - next to it, on the same broker, the CH asset tree (
v1.0/CH/Fleet/...), organised by turbine serial number: 1 s process values with quality and sequence numbers, plus raw vibration and pressure waveform blocks; - hidden machine faults on slow and fast timescales, rich enough for edge and IIoT vendors to show predictive maintenance on the same data.
The environment stops at the broker. Edge devices, analytics, transport, buffering, security and device management are what the vendors bring: see the Edge vendor brief.
| You want to… | Read |
|---|---|
| Run it on your laptop | Getting started |
| Understand dams, turbines, governors, vibration | Dams and turbines in brief |
| Know the site and how it is operated | Copper Canyon Dam |
| See how the pieces fit | Architecture |
| Understand the core lesson | Customer data vs. machine-builder data |
| See both topic trees written out in full | Example Unified Namespace |
| Find a topic | Namespace, Interface reference |
| Use the screens | Dam SCADA, CH asset viewer, Instructor station |
| Show your edge platform on it | Edge vendor brief, Failure modes |
| Follow a failure from the control room to an AI-assisted RCA | RCA demo walkthrough |
| Do such an RCA yourself in Claude, from the documents and data | RCA with Claude: a guide for engineers |
| Discuss the business case | Business model |
| Change the code | Development |
| Aspect | Haltenberg (HCW) | Sweet Harmony (SHT) | Cromley Hydraulics (CH) |
|---|---|---|---|
| Story | Air separation unit run by a DCS | Industrial bakery, many PLCs/HMIs/SCADAs | Machine builder monitoring its turbines at a customer dam |
| Connectivity | Modbus TCP plant to DCS, OPC UA out | MQTT (Mosquitto) | MQTT only, one local Mosquitto |
| Namespace | OPC UA address space | ISA-95 v1.0/SHT/Munich/... + _RAW feed |
Customer ISA-95 tree + CH asset-centric tree on the same broker |
| Payload | OPC UA nodes | {value, unit, timestamp} |
Same; the CH tree adds quality and seq, plus waveform blocks |
| Training hook | Instructor station, hidden faults | Hidden anomaly injection | Instructor station, hidden machine faults on slow and fast timescales |
Plans and work in progress are in ROADMAP.md. The original brief is the design basis.
Start
Understand
- Copper Canyon Dam
- Architecture
- Customer data vs. machine-builder data
- Example Unified Namespace
- Failure modes
- RCA demo walkthrough
- RCA with Claude: a guide for engineers
Use
- Dam SCADA
- CH asset viewer
- Instructor station
- Node-RED and MQTT Explorer
- Namespace
- Interface reference
- Configuration
For vendors
Contribute