@simatic-ax/lpmlv2022

Description

The LPMLV2022 library provides a user-friendly basis for the implementation of an OMAC PackML compliant mode and state manager including PackTags for the machine data interface for SIMATIC controllers.

The library is a direct conversion of the functionally identical library LPMLV2022 for use inside the TIA Portal

Key Features

• OMAC PackML V2022 Compliance: Full implementation of ANSI/ISA-TR88.00.02-2022 standard for machine and unit state management
• Multi-Mode Operation: Support for Production, Maintenance, Manual, and up to 28 user-defined modes
• Complete State Machine: 17 standardized states including Execute, Stopped, Starting, Holding, Suspending, and more
• Flexible Configuration: Configurable enabled modes, disabled states, mode transitions, and command handling
• Boolean Wrapper Support: Simplified boolean interface for unit state manager integration
• Stacklight Integration: Built-in stacklight status management according to PackML standards
• Comprehensive Diagnostics: Built-in diagnostics and status reporting functionality

Requirements

• SIMATIC AX
• S7-1500T CPU with firmware version 2.9 or higher

Getting started

Install with Apax:

If not yet done login to the GitHub registry first. More information you'll find here

apax add @simatic-ax/lpmlv2022

Add the namespace in your ST code:

USING Simatic.Ax.LPMLV2022;

More details on how to use the library can be found on the dedicated Getting Started page.

Source Code Integration

Compiled package vs. source code

When installed via apax add, the library is delivered as a compiled binary package.

However, certain customizations require modifying the library source code directly. This includes:

• Adjusting array sizes defined in LimitConstants (e.g. diagnostics buffer depth, number of tracked modes/states)
• Extending or modifying the state machine behavior

For these cases, the full source code is available in this GitHub repository.

Library functionality

Comprehensive documentation is available in the docs directory:

Contribution

Thanks for your interest in contributing. Anybody is free to report bugs, unclear documentation, and other problems regarding this repository in the Issues section.

License and Legal information

Please read the Legal information