Awlsim: S7 compatible Soft-PLC
Image preview of awlsimgui.png

Awlsim is a free Step 7 compatible AWL/STL Soft-PLC written in Python. Depending on the host machine and the Python interpreter used, it achieves good performance of several thousand to millions of AWL/STL instructions per second. German and English S7 AWL/STL mnemonics are supported.

Awlsim can emulate CPUs with two and four accumulator registers (S7-3xx and S7-4xx).
Compatibility to S7 hardware is a task taken seriously by the awlsim project. We want to be as close as possible to the real PLC hardware with our AWL/STL code execution. For this reason awlsim ships an extensive selftest suite. Missing features and differences between awlsim and Step 7 are documented in the COMPATIBILITY.txt and TODO.txt files. If you find any undocumented bugs and incompatibilities to a real PLC CPU, please contact me.

Awlsim is Open Source Free Software licensed under the GNU General Public License v2+. That means it's available in full source code and you are encouraged to improve it and contribute your changes back to the community. Awlsim is free of charge, too.

The preferred way to run awlsim on MS Windows is to use the standalone package:
awlsim-win-standalone-x.y.zip (See Download).

Just extract the standalone .zip package and run the file awlsim.bat.
There is no need to install anything. Windows will probably ask you (twice) to confirm that you trust the program being run.

Optional:

If you want to build and run awlsim from source .tar.gz package (you most likely don't), the following two software packages need to be installed:

Please install Python and PySide to their default install locations.

After the dependencies have been installed, the awlsim-X.X.tar.gz archive can be extracted. After extracting the tar.gz archive, simply run the awlsim-win.bat file. The graphical user interface of awlsim should appear. If you did not install a dependency correctly, or if there is any other problem, an error message will be printed to the console window that also appears.

Awlsim runs on any platform that supports Python and PySide, which includes Linux and Mac OS X.

Awlsim runs on Python 2.7 and Python 3.2 or later (CPython).

The awlsim core and thus the command line interface 'awlsim-cli' and the core server 'awlsim-server' also run on these alternative Python interpreters:

It is possible to compile the awlsim core and coreserver with Cython. Cython is an optimizing static compiler for the Python language.
If Cython is installed, the ./setup.py build run will also build the optimized awlsim package in addition to the standard Python modules. The package will be called awlsim_cython, so both the optimized build and the original Python-code can be installed simultaneously.
To use the awlsim_cython core, set the AWLSIMCYTHON environment variable to 1 before running awlsim. For example run awlsim-cli like this:
AWLSIMCYTHON=1 awlsim-cli EXAMPLE.awl
This will also work with awlsimgui.
Using the compiled awlsim_cython core will result in a performance gain of about 50 percent, compared to the pure Python core.

Awlsim includes an experimental hardware access layer for connecting the awlsim S7-CPU to real PROFIBUS-DP slave hardware. It does this by providing an interface to the Raspberry Pi PROFIBUS module.

The hardware access layer module is loaded and executed with the new -H command to awlsim-cli.
For example: awlsim-cli -D -H pyprofibus program.awl
The pyprofibus module has some module options. See the --help and --hardware-info pyprofibus options to awlsim-cli for details.

The pyprofibus module is highly experimental at this time. It lacks a lot of flexibility, but it does work.

Needless to say, the Raspberry Pi PROFIBUS module must be installed before the awlsim pyprofibus hardware access layer can be used. Otherwise to following error will occur:

  [PyProfibus hardware module] Failed to import PROFIBUS protocol stack module 'pyprofibus':
    No module named 'pyprofibus'

A LinuxCNC HAL module is included in awlsim. With this module it is possible to use awlsim as a non-realtime S7-compatible PLC backend.

To use awlsim in LinuxCNC, a HAL configuration file has to be added to your LinuxCNC configuration. See the LinuxCNC Integrators Manual on how to add HAL-files. An example HAL-file is included in the awlsim package as awlsimhw_linuxcnc/awlsim.hal
See this .hal file for additional information.

Latest bleeding edge awlsim can be downloaded using the Git version control system as follows:

git clone git://git.bues.ch/awlsim.git

or by downloading the awlsim snapshot archive.
To browse the Git repository online, go to the gitweb interface.
A mirror of the repository is available on Github.

Awlsim is a complex piece of software. The following diagram shows the basic connections and interactions between the basic parts of the software package. (Click to enlarge).

Image preview of awlsim-architecture.png

Thanks to everybody testing awlsim and reporting bugs and differences between awlsim and the original Step 7 AWL/STL language implementation. Also thanks to everybody providing example AWL/STL code and test cases for the testing suite.

Thanks to the lecturers at Balthasar Neumann Technikum Trier for their fine lectures in PLC automation. Those in particular are Mr. Etringer, Mr. Kronenburg, Mr. Laub et al., in lexicographical order.

Copyright (C) Michael Büsch et al.
Licensed under the terms of the GNU General Public License version 2 or (at your option) any later version. See the sourcecode for details.

Updated: Thursday 04 December 2014 15:55 (UTC)
https (SSL) encrypted
xhtml / css