No description
Find a file
Clio Liu 2b8f88d01f feat(env): hosts, access, ports and the PLC container
02-environment merges the old 02-env and 03-containers - both answered the
same question, 'where does this run and how do I reach it', and were split
for no reason.

  README.md              the two hosts, access, ports, secrets, health
                         checks, known issues
  YAU_Linux_Host_Onboarding.md  the Linux host's own brief, copied with a
                         provenance banner: owned by the host owner, not
                         maintained here, and its 'save this as CLAUDE.md'
                         instruction does not apply in this repo
  openplc-container.md   the container as read from the running host
  openplc-compose.yml    verbatim copy of the live file
  MIGRATION.md           moving the container - as-built plus runbook
  secrets.local.md.template  the shape of the git-ignored secrets file

The README leads with the fact that shapes every decision on that machine:
yau-sls-poc-lin001 is a SHARED, LIVE host running ~28 containers for
several projects behind Caddy and Authelia, and this project owns exactly
one of them. Never restart Caddy or Authelia, never publish on 0.0.0.0,
never put growing data on the 62 GB root disk.

Records four known issues rather than leaving them in anyone's head: the
100 ms scan overruns, the 354 MB migration tarballs still sitting on the
host with the JWT secret inside one of them, the runtime image existing in
no registry, and the missing Editor toolchain.

Not carried across: Host_Documentation.md. ~400 lines on ChirpStack,
Forgejo, EQP licensing and the Telegraf fleet - none of it WRPS, owned
elsewhere, and a stale copy here would be worse than a pointer.
2026-09-02 17:24:09 +10:00
01-design docs(design): design set, with its origin and the method that made it 2026-09-02 15:25:54 +10:00
02-environment feat(env): hosts, access, ports and the PLC container 2026-09-02 17:24:09 +10:00
03-plc docs(plc): architecture overview 2026-09-02 16:51:45 +10:00
04-scada fix(scada): PS_* placeholder tags out, CI Server item names in 2026-09-02 17:21:57 +10:00
99-reference chore: preserve reference files byte-for-byte 2026-09-02 15:17:49 +10:00
.gitattributes chore: preserve reference files byte-for-byte 2026-09-02 15:17:49 +10:00
.gitignore feat(scada): CI Server tag database, historian, displays 2026-09-02 17:16:18 +10:00
README.md chore: initialise wrps-demo-kit 2026-09-02 15:07:31 +10:00

wrps-demo-kit

A kit for building demo automation use cases on Yokogawa CI Server (SCADA) and OpenPLC Runtime (soft PLC, in Docker) — with the Waterloo Road Pump Station (WRPS) demo as its first worked example.

Note

This repository is being assembled. It is the successor to an earlier working repo, and material is being reviewed and moved across one folder at a time. Sections not yet present have not yet been audited.

The two systems

Role Host Address
SCADA — Yokogawa CI Server yau-poc-cicore1 10.0.0.21
PLC — OpenPLC Runtime container yau-sls-poc-lin001 10.0.0.17

Architecture invariant: OpenPLC Runtime is the Modbus TCP server (slave) on port 502. CI Server is the Modbus client (master) and polls it. The register map is the contract between the two sides.

Layout

To be filled in as each part is brought across.


Assembled from the WRPS working repo, 2026-09.