Commit 4f1d5482 authored by Michael Büsch's avatar Michael Büsch

Add basic PiLC documentation

Signed-off-by: Michael Büsch's avatarMichael Buesch <>
parent 1f7f3af8
# PiLC - The Raspberry Pi PLC
[PiLC]( is a [Raspbian]( Operating System derivative that comes with Awlsim preinstalled and ready-to-go.
PiLC can be used to run a Raspberry Pi just like a "real" PLC.
## How to setup PiLC on the Raspberry Pi?
Just copy the PiLC image file onto an SD card. The process of installing PiLC is exactly the same as installing the standard Raspbian distribution.
Please see the [install instructions]( for more details.
There is no need to set up anything else. The PiLC image is pre-configured so that the Awlsim core will automatically start during bootup. The Awlsim core on the PiLC listens to SSH connections on the Ethernet port.
## How to connect to the PiLC?
1. Connect the Raspberry Pi's Ethernet port to your network and power up the Raspberry Pi. It will automatically fetch an IP address from your router.
1. Check your router information page to see which IP address the Raspberry Pi obtained.
1. Start the Awlsim GUI on your PC.
1. Load the example project `raspberrypi-gpio.awlpro` that is shipped with Awlsim into the Awlsim GUI by clicking `File` and then `Open project...`
1. Then connect to the PiLC by clicking `CPU` and then `Go online (Connect to a CPU)` in the menu bar.
1. Enter the IP address of your Raspberry Pi here:<br />
<a href="doc/pic/pilc/connection0.png"><img src="doc/pic/pilc/connection0.png" alt="awlsim-gui" /></a>
1. Then click `Accept`.
1. If Awlsim asks you to confirm the connection authentication, click `Yes`:<br />
<a href="doc/pic/pilc/connection1.png"><img src="doc/pic/pilc/connection1.png" alt="awlsim-gui" /></a>
1. Finally type in the Raspberry Pi login password. The default password is `raspberry`<br />
<a href="doc/pic/pilc/connection2.png"><img src="doc/pic/pilc/connection2.png" alt="awlsim-gui" /></a>
## How do I get my PLC program onto PiLC?
Just connect to PiLC (see previous chapter) and click the `download` button in the Awlsim GUI. This will transfer the program over to the PiLC.<br />
<a href="doc/pic/pilc/download.png"><img src="doc/pic/pilc/download.png" alt="awlsim-gui" /></a>
If the PiLC is not in RUN state, click the RUN button to start the program.
......@@ -24,6 +24,11 @@ See the [quick start tutorial](QUICK-START.html) for a simple example on how to
If you don't know where to start, you can find an example project in the `examples` directory as `EXAMPLE.awlpro`. You can easily run this example in simulation mode without the need for special hardware.
## PiLC - The Raspberry Pi PLC
If you want to use PiLC, please also see the [PiLC documentation](PILC.html).
## Git repository
The latest development version of Awlsim can be fetched with git:
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment