matlab/matlab-agentic-toolkit / skills-catalog/test-and-measurement/matlab-build-industrial-hmi
matlab-build-industrial-hmi
VerifiedBuild industrial-grade SCADA/HMI dashboards in MATLAB following industrial-HMI conventions (ISA-101-aligned): gray-field philosophy, alarms at source, write safeguards, fixed-range trends, drill-down layout. Produces a real App Designer app (.mlapp, or plain-text .m+.xml on R2026b+) by handing serialization to the matlab-build-app skill when available, and falls back to a programmatic .m app otherwise. Use when wrapping OPC UA / Modbus / MQTT / OSI PI / PI AF monitoring scripts into a live operator app, building plant overviews, designing operator dashboards, or any time a user asks for a "SCADA dashboard", "HMI", "plant dashboard", "operator screen", or "industrial monitoring app" in MATLAB. Trigger on: SCADA, HMI, industrial dashboard, plant overview, operator screen, uigauge, uilamp, alarm banner, gray-field, ISA-101, OPC UA dashboard, setpoint, write safeguards, alarm visualization, OSIsoft PI, AVEVA PI, PI Server, PI Data Archive, PI AF, PI Asset Framework, piclient, afclient.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 21.6 KB |
| assets/design-report-schema.json | config | 9.9 KB |
| assets/designReportReadback.m | other | 12.5 KB |
| assets/hmi-spec-template.md | markdown | 18.4 KB |
| manifest.yaml | config | 1.7 KB |
| references/alarm-patterns.md | markdown | 10.9 KB |
| references/app-designer-gotchas.md | markdown | 9.0 KB |
| references/app-designer-handoff.md | markdown | 17.7 KB |
| references/color-and-layout-rules.md | markdown | 16.3 KB |
| references/common-mistakes.md | markdown | 49.6 KB |
| references/key-functions.md | markdown | 4.1 KB |
| references/known-schema-patterns.md | markdown | 4.1 KB |
| references/pi-af-cheatsheet.md | markdown | 16.7 KB |
| references/protocol-cheatsheet.md | markdown | 19.1 KB |
| references/server-agnostic-discovery.md | markdown | 8.4 KB |
| references/trend-config-reference.md | markdown | 10.9 KB |
| references/widget-selection-flowchart.md | markdown | 6.6 KB |
| references/write-safeguards-reference.md | markdown | 9.2 KB |
references/key-functions.md
View on GitHub# Key Functions
Every function an HMI built by this skill calls, with the toolbox that ships it and the release it
became available. Look up the release **before** writing a call: the four bold entries are the ones
that fail on an older install, and they fail differently — a missing toolbox errors at the call,
while a too-old release reports `Unrecognized function or variable`, which reads like a typo.
The skill's floor is **R2023b** (`manifest.yaml`), set by OPC UA `subscribe()`. Verify an unknown
install with `mcp__matlab__detect_matlab_toolboxes`.
## Widgets and graphics — core MATLAB
| Function | Purpose | Available From |
|---|---|---|
| `uigauge('linear'\|'circular'\|'semicircular'\|'ninetydegree')` | Single value, known range | R2016a |
| `uigauge.ScaleColors` / `.ScaleColorLimits` | Alarm bands at source — all four gauge styles; bands outside `Limits` are silently clipped (`common-mistakes.md` #23) | R2018a |
| `uilamp` | Binary state indicator | R2016a |
| `animatedline` with `MaximumNumPoints` | Rolling trend buffer | R2014b |
| `addpoints` / `clearpoints` | Trend update / reset | R2014b |
| `yline` | Threshold or setpoint line on trend | R2018b |
| `uiconfirm` | Modal write confirmation | R2017b |
| `uispinner` with `Limits` | Bounded numeric input | R2016a |
| `uieditfield('numeric','Editable',false)` | Precise read-only numeric display | R2016a |
| `uitable` | Tabular display for >8 nodes | R2017b |
| `uitree` + `uitreenode` | OPC UA namespace navigation | R2017b |
| `timer` (`BusyMode='drop'`, `ExecutionMode='fixedSpacing'`) | Modbus / PI / PI AF poll loop, or non-OPC periodic UI work | base |
## Protocol clients — Industrial Communication Toolbox
| Function | Purpose | Available From |
|---|---|---|
| `opcua` / `connect` | Open OPC UA client | R2022a |
| `findNodeByName` / `readValue` / `writeValue` | Browse and read/write nodes | R2022a |
| `subscribe(uaClient, nodeList, dataChangeFcn, PublishInterval=...)` | Live node updates — preferred over `timer` at any node count | **R2023b** |
| `modbus('tcpip', host, port)` / `read` / `write` | Modbus client and register R/W | R2022a |
| `mqttclient(brokerAddr)` / `subscribe(c, topic, Callback=...)` / `write` | MQTT publish/subscribe | R2022a |
| `piclient(server, ...)` | OSI / AVEVA PI Data Archive client | **R2022a** |
| `tags(piClient, Name=q)` / `read(piClient, tag, DateRange=, Interval=, AggregateFcn=)` | PI tag search, current and archive/aggregated reads (returns `table`/`timetable`) | R2022a |
| `write(piClient, tag, value, TimeInstance=...)` | PI setpoint write | **R2024a** |
| `afclient(server, Database=...)` | PI Asset Framework client | **R2026a** |
| `getRootElements` / `getChildren` / `getAttributes` / `findElementByName` / `findElementByPath` / `findElementByTemplate` | AF tree browse → drill-down layout | R2026a |
| `read(attr, Unit=...)` / `readHistory(attr, t0, t1, ...)` / `listSupportedUnits` | AF attribute current value, history, units | R2026a |
Calling conventions, argument order, and callback shapes for all of these are in
`references/protocol-cheatsheet.md` (OPC UA / Modbus / MQTT) and `references/pi-af-cheatsheet.md`
(PI Data Archive / PI AF) — this file answers *whether* a function exists, those answer *how to
call it*.
## Release gates that change the design, not just the call
- **Below R2023b** there is no OPC UA `subscribe()`. A polling `timer` is then the only option, and
the skill's "subscribe is the default" rule does not apply — say so rather than emitting a call
that errors.
- **PI writes need R2024a.** On R2022a–R2023b `piclient` reads but cannot write, so a PI setpoint
panel cannot be built; raise it as an open question in the spec instead of shipping a dead
control.
- **PI AF needs R2026a**, and even there **AF current-value writes are not exposed** — route them
through `Attribute.PITag` and the PI client (`references/pi-af-cheatsheet.md`).
- **Real App Designer output** (`.mlapp`) needs R2025a+ via `matlab-build-app`; plain-text `.m`+`.xml`
needs R2026b+. Below that, the programmatic `.m` fallback is the only path.
----
Copyright 2026 The MathWorks, Inc.
----
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation). | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK). | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |