Read here how to use the GRAFCET Engine on the Revolution Pi and then download and run a Grafcet chart.
You need GRAFCET-Studio version 22.214.171.124 or newer! Available from: 07.12.2018
The company Kunbus offers a modular control system based on industrial Raspberry Pi hardware on DIN rail: Revolution Pi (RevPi). More information about the hardware can be found here.
With Grafcet-Studio this control system can be programmed by a Grafcet-Chart (DIN EN 60848) visually. This is made possible by porting the Grafcet Engine into the scripting language Python (V3). The Grafcet Engine is the Runtime module, which processes the Grafcet logic. The runtime is free of charge for the device. With a Grafcet Studio full version (e.g. 99€ plus VAT for the IoT edition), any number of Raspberry Pi's can be visually programmed. In order to enable Grafcet-Studio to program the RevPi, a Python script (the Grafcet-Engine) has to be started on the device.
The Python script has the following tasks:
The following figure shows Grafcet Studio in monitoring mode (debugging). Here a permanent data exchange between RevPi and Grafcet-Studio takes place. On the left side of the drawing area you can see a small step chain that generates a moving light. To the right a variable (symbol) is incremented, with a rising edge of I0.
|1||Drawing area (canvas) of Grafcet Studio.|
|2||Symbol table. (Symbol names can be changed.)|
|3||View of the Grafcet Engine (Runtime). Here you can see, for example, the current cycle time, which in this case is 1ms.|
|4||IO-Panel with current states of all variables including inputs and outputs|
Connect the desired modules via the backplane bus (PiBridge) and do a hardware configuration with PICtory. PICtory is the web-based hardware configurator of the RevPi. It is started via the browser. All necessary information can be found in the Documentation section on the Kunbus website. To make your work easier, we recommend that you connect a monitor, mouse and keyboard to the RevPi.
In order for the Grafcet logic to know the states of the input signals (digital or analog), the input states must be written into the Grafcet Engine. The states of the outputs of the Grafcet Engine must be written into the output modules of the hardware. The Grafcet Engine provides the necessary read and write functions for this purpose. In the following Python example, the digital inputs and outputs of a DIO module are published to the Grafcet engine.
The following table shows the start addresses of the individual operand ranges of the Grafcet engine. In the following Python example only digital inputs and outputs are used. The states of the digital inputs must be written from address 0 (see table) and the digital outputs are read from address 25 (see table).
|Operand||Symbol area in Grafcet Studio||Address||Sufficient for ...|
|DI - Digital Inputs||Sensor||0||200 Inputs|
|DO - Digital outputs||Actuator||25||200 Outputs|
|AI - Analog input||Sensor||50||25 analog inputs (for 2-byte)|
|AO - Analog output||Actuator||100||25 analog outputs (for 2 byte)|
|Data - Bool Variables||Data||150||200 Boolean variables|
|Data - Analog Variables||Data||175||50 (e.g. 50 Int16 Variables)|
Note: If an area is too small, it can be extended via the device settings in Grafcet-Studio. In this case the start addresses would shift.
In order to read/write the hardware inputs/outputs in the Python program their addresses (offset) must be known in the process image of the RevPi. These offset addresses can be determined by exporting the symbols in PICtory. In PICtory, select the menu item File->Export. In the dialog select Export 02 Offset list and select Show only:
|Offset list, select 'Show only'.||The Offset list is displayed|
You will see the start address of the inputs and outputs and (indirect) their length in bytes. This information is needed for the Python script.
Download the following ZIP file:
In the ZIP file you will find these files:
Below the Python script grafcet_RevolutionPi.py, which manages a DIO assembly:
|1||The Grafcet engine (runtime) is imported.|
|2||The offset addresses of the RevPi hardware (DIO module) are defined.|
|3||The offset addresses of the DI,DO in the Grafcet engine are defined. (See symbol table column DB address in Grafcet Studio).|
|4||An instance of the Grafcet engine is created.|
|5||The MQTT communication is set up. The specifications must match the specifications in Grafcet Studio. Otherwise no communication can take place.|
|6||The process image of the RevPi can then be read and written after 'f=open(...)'|
|7||With a while loop a PLC cycle is generated|
|8||Read all inputs of the DIO module and write them to the Grafcet Engine Runtime|
|9||Execute 1 cyclic of the Grafcet Engine Runtime|
|10||Read outputs of the Grafcet Engine and write them to the outputs of the DIO module|
This example uses a DIO module. If you are using other modules, you must adjust points 8 and 10 in the Python script.
The Grafcet input symbols must therefore be written with the current values of the hardware inputs. and the states of the graphcet outputs are written to the hardware outputs of the R-Pi.
The following read functions are available for Grafcet operands (symbols):
|read_bit(addr, bit)||Returns true or false (1 bit) as function result|
|read_uint8(addr)||Returns a byte value (8 bit) as the function result|
|read_uint16(addr)||Returns an unsigned 16-bit integer value as a function result|
|read_uint32(addr)||Returns an unsigned 32-bit integer value as a function result|
|read_int16(addr)||Returns a signed 16-bit integer value as function result|
|read_int32(addr)||Returns a signed 32-bit integer value as a function result|
|read_float(addr)||Returns a float value (32 bit) as function result|
The following write functions are available for Grafcet operands (symbols):
|write_bit(addr, bit, bitvalue)||The given value is written at the given address|
|write_uint8(addr, bytevalue)||The given value is written at the given address|
|write_uint16(addr, uint16value)||The specified value is written at the given address|
|write_uint32(addr, uint32value)||The specified value is written at the given address|
|write_int16(addr, int16value)||The specified value is written at the given address|
|write_int32(addr, int32value)||The specified value is written at the given address|
|write_float(addr, floatvalue)||The specified value is written at the given address|
The Grafcet Engine uses the MQTT protocol for communication with Grafcet Studio (on the PC). For this reason, a Mqtt client must be installed on the RevPi. This can be done with the following command: Enter the following command via the terminal:
pip3 install paho-mqtt
The Python script uses a public broker: broker.mqttdashboard.com Therefore the RevPi and the PC need internet access. You can also install a local MQTT broker on the RevPi or on the PC. These are available free of charge on the Internet. Then no internet connection would be necessary anymore.
Here you can download a free MQTT Broker for your PC: https://mosquitto.org/download/
In the Python script you then have to enter the IP address of the PC in the 1st parameter of InitMqtt. In the settings of Grafcet-Studio enter the LocalHost address '127.0.0.1' (if the broker and Grafcet-Studio is installed on the same PC)
After the Python script has started, you can now create a Grafcet chart with Grafcet-Studio and transfer it very easily, very quickly and very comfortably to the device.
In the next section you will read how to program and debug the RevPi with Grafcet-Studio.
Display the Grafcet Engine window and add a Device for the RevPi:
|1||Press the plus button.|
|2||Select as device type Grafcet Engine MQTT.|
|3||Assign a name for the new Device.|
|4||Set MQTT parameters. Topic1 and Topic2 must match the Python script. Do not use the same parameters for Topic1 and Topic2 as in the picture.|
|6||Select the new Device from the list.|
|7||Press connect button|
If the Python script is started and if the MQTT parameters are correct, then a connection should be established.
If there is a connection, the counters (see picture) are incremented.
In the symbol table you can rename the symbols (variables) according to your needs:
For each symbol you can also set the data type (Bool, Int16, Int32, ...). Via the symbols you can use the inputs and outputs of the RevPi. The prerequisite is, of course, that you have written the inputs and outputs in the Python script into the Grafcet Engine. In the column DB address you can see the offset address of the symbol. This offset address cannot be set manually. It is calculated from top to bottom.
Each symbol can be set to "Sensor", "Actuator" or "Data". Each of these ranges uses a different start offset address in the Grafcet Engine. Inputs should always be set to "Sensor" and outputs should always be set to "Actuator". The "Data" area contains neither inputs nor outputs. Symbols for intermediate results or similar should be stored in this area. Using the Python script, you can access all symbols with read and write operations.
Idea : For example, you can pass the time (hours, minutes, seconds) via the Python script to an input or data symbol. This allows you to evaluate the current time in the Grafcet chart.
A short tutorial can be found here
Or here you find short videos showing how to draw a Grafcet chart with Grafcet-Studio.
If the connection between RevPi and Grafcet-Studio is established, the Grafcet can be transferred to the Device via the "Write" button:
The button is located in the "Grafcet Engine" window.
After the Grafcet logic has been written into the device, you can switch on the watch mode by pressing the button with the glasses:
In this way you can start the Python script after booting the RevPi automatically and independently from a user login:
Open the editor 'nano':
sudo nano /etc/rc.local
Insert the following code before the line with exit0:
python3 /home/pi/Documents/grafcet_RevolutionPi.py &
The path incl. file name may have to be changed if you have saved the file in another folder.
Note: The & sign at the end of the line is important! Otherwise the RevPi will not boot completely.
Tip: For example, to see if the Python script is running, you can switch on the A1-Led on the Rev-Pi mmodule in the Python script:
This code can be used in the script grafcet_RevolutionPi.py.
See also Website of the Kunbus company.
You should only set up the autostart if your RevPi is to be used continuously. If a script runs in the background, this leads to problems if you start a second script, which also writes to the outputs. Tip: With the terminal command top you can display all processes. With kill you can remove a process.
In case of connection problems, please check the following:
All pictures of the RevPi come from the website https://www.kunbus.de