l5x2c is a transcompiler (a source-to-source compiler) written in Python that translates Rockwell's ladder programs exported to a .L5X file into a C program with the purpose of verification. It is a work-in-progress and, as of now, it supports complex rung structure, the most used ladder instructions (see the list), tag definitions, multiple programs and routines.
l5x2c uses PLY to build a single pass transcompiler that translates the original ladder program into a C code that implements an Accumulator Machine that models the behavior of the Rungs.
To run the Python Scripts, you are going to need PLY. If you intend to run the l5x2c test script, you are going to need CBMC. We are using CBMC version 5.11.
There are 5 python scripts available in the repository:
- l5x2c.py is the main script and is used to translate the
.L5Xfile into a C program - l5xparser.py is the script that parses the
.L5Xfile into a dictionary - runglex.py is the scanner for the ladder rung. It analyses the rung and issues a stream of tokens
- rungyacc.py is the parser and code generator that analyses the sintax of the ladder rung and translates it to the equivalent C code
- testgen.py is a script that generate a C file that can be used to verify the behavior of l5x2c. The script generates a file
tests/tests.cthat can be verified using CBMC using the commandcbmc tests/tests.c
To translate a .L5X file into C, just run:
python l5x2c.py examples/ex1.L5X examples/ex1.cThis will analyse the file in examples/ex1.L5X and create the file examples/ex1.c with the corresponding C code.
Single ladder's rung can be translated using rungyacc.py as bellow:
echo "XIC(A)XIO(B)OTE(C);" | python rungyacc.pyThis will print a list of commands that use the template functions available in plcmodel.template file.
The following instructions are supported by l5x2c:
- XIC
- XIO
- ONS
- EQU
- GEQ
- LEQ
- NEQ
- GRT
- LIM
- OTE
- OTU
- OTL
- RES
- MOV
- TON
- TOF
- CTU
- JSR
- ADD
- SUB
- DIV
- CLR