Original repository at: https://git.bues.ch/git/pilc.git

Michael Buesch a0df2c07d0 Update bootloader config 3 weeks ago
deb 216a7f7f8a pilc-system: Update compat to 10 3 weeks ago
doc bcfcf67a8e Fixes for build without awlsim.git repo contents 1 month ago
keys bcfcf67a8e Fixes for build without awlsim.git repo contents 1 month ago
maintenance c6fbd25fd0 Add cleantree.sh 3 weeks ago
templates a0df2c07d0 Update bootloader config 3 weeks ago
.gitignore 6341efed57 Move from https://git.bues.ch/git/awlsim.git b2047a2f7ed1f6e26620b8561917300e14409195 1 month ago
README.md 0ac77e9089 readme: Add download link 1 month ago
pilc-bootstrap.sh 5f30db7c5c Reduce non-rt prio 1 month ago

README.md

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.

Download PiLC SD card image

Download the latest ready to use PiLC SD card image for the Rasperry Pi from the PiLC download page.

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.

  2. Check your router information page to see which IP address the Raspberry Pi obtained.

  3. Start the Awlsim GUI on your PC.

  4. Load the example project raspberrypi-gpio.awlpro that is shipped with Awlsim into the Awlsim GUI by clicking File and then Open project...

  5. Then connect to the PiLC by clicking CPU and then Go online (Connect to a CPU) in the menu bar.

  6. Enter the IP address of your Raspberry Pi here:
    awlsim-gui

  7. Then click Accept.

  8. If Awlsim asks you to confirm the connection authentication, click Yes:
    awlsim-gui

  9. Finally type in the Raspberry Pi login password. The default password is raspberry
    awlsim-gui

Connection failure

If the connection fails with the following error message, it might be due to a failed SSH authentication:
awlsim-gui

This will happen, if you re-install PiLC on the Raspberry Pi.
Re-installing PiLC generates new SSH keys and therefore causes subsequent authentications to fail.

To fix this delete the SSH authentication (known_hosts entry) on the PC (not on the Raspberry Pi). If you are using OpenSSH/Linux on the PC, enter the following command into a command prompt:

ssh-keygen -R 192.168.0.10

Replace 192.168.0.10 with the IP address of your Raspberry Pi.

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.
awlsim-gui

If the PiLC is not in RUN state, click the RUN button to start the program.

Where does Awlsim store its state on the Raspberry Pi?

The Awlsim working directory is /etc/awlsim/
The loaded project and other configuration files are stored there.