007b35ae52
This branch: * Adds information on modifying the systemd script provided in boot_scripts * Adds documentation for the newest options on the PiStorm gui * Fixes a memory leak and a potential crash on alloc failure for the gui * Minor text changes in the gui * Fixes minor compiler warnings for the PiSimple CLI (both for GCC and VBCC)
PiStorm on Pi Boot
Bootup script
For your convience a startup script for systemd in Linux is located in this directory. This script will start PiStorm before the network connections have started.
Installation
To start PiStorm on automatically on boot, copy pistorm.service into /etc/systemd/system/ in your Pi's filesystem. Then run:
sudo systemctl enable pistorm
Customisation
There are some things you may want to change in the systemd script. These instructions will help with that.
Custom config
If you wish to boot using a custom configuration file change ExecStart to:
ExecStart=/home/pi/pistorm/emulator --config-file myconfig.cfg
Where myconfig.cfg is your config file in the pistorm directory. If your config file is somewhere else you will need to put the full path for it there.
NOTE: do not put an '=' between --config-file and the file name, this will not work.
Different location
You may want to run your PiStorm from a different location than /home/pi/pistorm this is fine, but it is important that the files that come with the emulator stay together in the same directory structure. For example, if you moved pistorm to /opt/pistorm you will need to change the following two lines:
ExecStart=/opt/pistorm/emulator
WorkingDirectory=/opt/pistorm
It is important both lines are changed otherwise this can cause issues, particularly crashes.
Startup order
If, for example, your PiStorm configuration depends on something like Samba running for PiScsi you will want to change the startup order so the PiStorm waits for that to run. In the [Unit] second add something like the following example:
After=network.target samba.service
Please see the systemd documentation for more informatino on this.
Applying changes
If you have made any changes to the pistorm.service file after it has been copied over you will need to reload the systemd configuration for the changes to be seen. This can be done with:
sudo systemctl daemon-reload
Faster boot
The Pi does several things that aren't needed for PiStorm at bootup, the following steps will accelerate the boot time for you.
config.txt
Edit /boot/config.txt and add the following lines:
# Disable the rainbow splash screen
disable_splash=1
# Set the bootloader delay to 0 seconds. The default is 1s if not specified.
boot_delay=0
# Disable Bluetooth
dtoverlay=disable-bt
By default there is a 1 second boot delay and initialising bluetooth takes a couple of seconds.
cmdline.txt
Edit the /boot/cmdline.txt and add quiet near the end, as an example (do NOT copy/paste this line):
console=serial0,115200 console=tty1 root=PARTUUID=5f1219ae-02 rootfstype=ext4 elevator=deadline fsck.repair=yes quiet rootwait
This shaves a little time off spitting out boot logs to the screen.
fstab
Disable /boot remount on boot, this will mean you will need to do sudo mount /boot when you want to change files in that partition, but it shaves off half a second from boot. To do this add noauto to the options second for the /boot line, for example (do NOT copy/paste this line):
PARTUUID=5f1219ae-01 /boot vfat defaults,noauto 0 2
Disable swap
If we need swap something went wrong. This shaves about another second off the boot time:
sudo systemctl disable dphys-swapfile.service