Installing the Software

There ist no need to flash the Arduino which is located on the FabScan PI HAT. It will be flashed automatically with the current firmware version after the server is started.

Installing from deb packages (Start with Raspbian Lite)

This description assumes that you have a SD card with a fresh Raspbian image on it. Keep in mind that the ready to use image is made out of Raspbian Lite. The following instructions might cause in errors. Think twice about not using the image. The following steps are more for users with linux experience.

The following guide assumes that you have activated the raspberry pi camera module and that the file system is already expanded to the maximum of your sd-card. You can use the tool raspi-config to archive that.

You need to do some tweaks on boot.txt .. code:: bash

echo “start_x=1” >> /boot/config.txt # more gpu memory echo “gpu_mem=192” >> /boot/config.txt #disable camera led echo “disable_camera_led=1” >> /boot/config.txt

# max usb power #echo “max_usb_current=1” >> /boot/config.txt

# disabale bt on raspberry pi3 to prevent serial port problems.. echo “dtoverlay=pi3-disable-bt” >> /boot/config.txt

echo "deb http://archive.fabscan.org/ stable main" > /etc/apt/sources.list.d/fabscanpi.list

Then add the FabScan PI repository key to your key chain.

wget http://archive.fabscan.org/fabscan.public.key -O - | sudo apt-key add -

Update the package list.

apt-get update

Finish the installation with the needed packages.

apt-get install fabscanpi-server python3-opencv, python3-funcsigs, python3-apscheduler, python3-tornado, libtbb2, python3-pil, python3-serial, python3-pykka, python3-picamera, python3-requests, python3-rpi.gpio, python3-semver, xvfb, strace, avrdude, python3-scipy
echo "KERNEL==\"ttyACM0\", MODE=\"0666\" " > ${ROOTFS_DIR}/etc/udev/rules.d/20-serial-device-permissions.rules
echo "KERNEL==\"ttyAMA0\", MODE=\"0666\" " >> ${ROOTFS_DIR}/etc/udev/rules.d/20-serial-device-permissions.rules

Set the user permissions.

usermod -a -G tty ${FIRST_USER_NAME}

The FabScan PI server can be started with

sudo systemctl start fabscanpi-server

Congratulations you did the basic setup. If you need more you should have a look to the repository of the [image build scrip](https://github.com/mariolukas/FabScanPi-Build-Raspbian). It provides a lot more tweaks like a proxy server which forwards the port to 80 and 443 etc.

Read [Usage](https://github.com/mariolukas/FabScanPi-Server/blob/master/README.md#useage) section for the next steps.

Building a custom image

The image can be build with the FabScanPi Image build script. You will find more

information [here](developing.md#Building FabScanPi Images)