NOTE We have just gone through project-wide refactoring changing the name from IX to AX# (AXSharp). Some links and documentation may still be using the IX and some links are still broken at this point. We are working hard on fixing those issues. Should any of these block you please feel free to reach out to the team.
The AX# is a series of tools that extend SIMATIC AX (Automation Xpansion) with a flexible and powerful connection with .NET ecosystem. AX# includes a compiler (ixc
) that translates PLC data structures into C# (PLC .NET Twin), which makes the PLC data available in a structured way for any .NET application. Furthermore, presentation libraries provide additional features for the automated rendering of PLC data in the UI/HMI.
This project is under development; however, we are releasing versions that you can play with before the release of the full version. This project follows semantic versioning.
All versions released with a major version number 0
(e.g. 0.10.0) can have breaking changes to the previous version at any moment. Stable versions will be released with a major version number greater than 0
(e.g. 1.2.1).
We plan to have production-ready libraries and tools in early spring 2024, that will cover:
Documentation is a work in progress should you find missing, unclear, or misleading content please feel free to add an issue or to create a pull request with the fix you find appropriate.
There are some known issues that we are looking into in the development process. The list of known issues is here.
AX# is the underlying technology for the AXOpen that will be rendered public in this organization and will provide a series of libraries and components for building automation projects.
It is necessary to have a valid license for SIMATIC AX in order to use AX#!
SIMATIC AX is currently in a limited sales release in selected European countries only. You will need to request access from the AX team which will check if your use case is suitable for the current state of the product. The first step to getting the approval is contacting your local SIEMENS sales representative or writing an email to simatic-ax@siemens.com.
In simple terms, the AX# takes the PLC program and translates the data structured into .NET classes.
{S7.extern=ReadWrite}
{#ix-attr:[Container(Layout.Stack)]}
{#ix-attr:[Group(Layout.GroupBox)]}
{#ix-set:AttributeName = "Location"}
CLASS GeoLocation
VAR PUBLIC
{#ix-set:AttributeName = "Latitude [°]"}
{#ix-set:AttributeMinimum = -90.0f}
{#ix-set:AttributeMaximum = 90.0f}
Latitude : REAL;
{#ix-set:AttributeName = "Logitude [°]"}
{#ix-set:AttributeMinimum = 0.0f}
{#ix-set:AttributeMaximum = 180.0f}
Longitude : REAL;
{#ix-set:AttributeName = "Altitude [m]"}
Altitude : REAL;
{#ix-set:AttributeName = "Short descriptor"}
Description : STRING[10];
{#ix-set:AttributeName = "Long descriptor"}
LongDescription : STRING[254];
END_VAR
END_CLASS
using System;
using AXSharp.Connector;
using AXSharp.Connector.ValueTypes;
using System.Collections.Generic;
[Container(Layout.Stack)]
[Group(Layout.GroupBox)]
public partial class GeoLocation : AXSharp.Connector.ITwinObject
{
public OnlinerReal Latitude { get; }
public OnlinerReal Longitude { get; }
public OnlinerReal Altitude { get; }
public OnlinerString Description { get; }
public OnlinerString LongDescription { get; }
--- truncated ----
You can then access the data in your .NET application
// Write
await Entry.Plc.weather.GeoLocation.Longitude.SetAsync(10);
// Read
var longitude = await Entry.Plc.weather.GeoLocation.Longitude.GetAsync();
// Bulk read
Entry.Plc.weather.GeoLocation.Read();
// Bulk write
Entry.Plc.weather.GeoLocation.Write();
To get started, visit the documentation here.
Examples can be found here
Contributions are welcomed. Have a look at contributing document.