Standard

PNST 984-2024 and PNST 1044-2025: the extended hierarchical state machine language and the CyberiadaML-GraphML document format.

Cyberiada diagrams follow the preliminary national standards (PNST) of Russia of the series “Cyber-physical systems. National cyber-physical platform”. The standards were developed by the Kruzhok Association and submitted by the Technical Committee for Standardization TC 194 “Cyber-physical systems”.

PartStandardSubject
1PNST 982-2024General provisions
2PNST 983-2024Terms and definitions
3PNST 984-2024Extended hierarchical state machine programming
4PNST 1044-2025Document format for extended hierarchical state machine diagrams

PNST 984-2024

“Cyber-physical systems. National cyber-physical platform. Part 3. Extended hierarchical state machine programming”. Approved by the order of Rosstandart of 27 December 2024 No. 124-pnst, valid from 1 February 2025.

The standard defines the graphical language of extended hierarchical state machine (HSM) diagrams: the states and their nesting, the pseudostates, the transitions, the events, the actions, the comments and how they are drawn. The language is based on Harel statecharts as formalised by UML (ISO/IEC 19505-2) and extended with the events and the actions of the target platform. A diagram can be run by a machine or translated into a program in C/C++, Python and other languages.

The text of the standard in Markdown (in Russian): PNST_984-2024.md.

PNST 1044-2025

“Cyber-physical systems. National cyber-physical platform. Part 4. Extended hierarchical state machine programming. Document format for extended hierarchical state machine diagrams”.

The standard describes the CyberiadaML-GraphML (CGML) format — an XML document based on GraphML and independent of the target platform. A document can be edited, shown, run or translated into other languages.

The text of the standard in Markdown (in Russian): PNST_1044-2025.md.

The FA extension

ПРИМС:КА (in Russian) is a project document that extends PNST 984 and PNST 1044 to deterministic finite automata, Mealy and Moore machines included. An automaton is a subset of HSM: simple and composite states, the initial and the final states, external transitions and comments; the input and the output alphabets are declared in the document. Automata are drawn in the finite automaton mode of CyberiadaPro and run by fa-dispatcher-py.

Conformance

The cyberiadaml-compat-tests suite checks that a document conforms to PNST 1044-2025, and that a library reads and writes documents correctly and rejects the wrong ones.

ProfileWhat it checks
COREthe base of the format (sections 5–7), mandatory
EXT-COMPLETENESSthe “HSM completeness” extension (section 8)
EXT-DISPLAYthe “display” extension (section 9)
EXT-PLATFORMthe “target platforms” extension (section 10)
EXT-FAthe FA extension