Tutorials¶
The tutorials are task-by-task walkthroughs: each page introduces one concept at a time, against a single fixed example server, so you can follow along by running the snippets as you read.
Start here: Set the Stage gets the example server running on your machine: save two files, run one command. Every tutorial talks to it, so it is worth the five minutes before anything else.
Beyond that, the tutorials are split by which side of the connection you are writing:
| Section | What it covers |
|---|---|
| Set the Stage | One-time setup: save server.py and sim.py side by side, then run the example server. |
| Client tutorials | Connecting to an existing server: browsing, reading and writing, calling methods, subscriptions, security, information modelling, async. |
| Server tutorials | Building your own server. The same distillery, built one concept at a time — the reverse direction of the client tutorials. |
The example server¶
Every tutorial on this site talks to the same example server: a small automated still driven by a background simulation. Wash goes in, gets heated to a setpoint, vapour turns into spirit on the way through the condenser, the spent wash drains out, and the still goes back to idle to wait for the next batch.
It is two Python files you save side by side and run — server.py for the OPC UA side and the sim.py it imports. Set the Stage has both, the address-space layout with every NodeId the tutorials use, and the handful of things worth knowing before you start poking at it.
Where to go next¶
- Set the Stage — get the example server running.
- Server tutorials — build the same server the client tutorials talk to, one concept at a time. Start with Creating a server.
- Client tutorials — or, if you already have a server to talk to, start with Connect / disconnect.