To build a fresh install of piccolo3 OS from a laptop terminal image  the latest raspian lite to an SD card then use piccolo3/rpi3 terminal to  set a new password; enable and start ssh; then build the Piccolo3 OS as below:

#this section rewritten 2023/11/13 to build piccolo3 OS from debs provided by TeamPiccolo. Note users should be familiar with Raspberry Pi operation 
# and set up and use of Linux terminal commands. 

# Memory stick attached to piccolo3 needs to be formatted and in the form of a generic example of piccolo.config. This can be seem at #https://github.com/TeamPiccolo/piccolo3-server/blob/master/pdata/piccolo.config
# and piccolo.config needs to be in dir piccolo3_data on that stick

# To build piccolo3 with desktop functionally to control and visualise from monitor attached tp RPi3 or from remote location from TeamPiccolo supplied *.debs
# Download 2022-09-22-raspios-buster-armhf-lite.img from 
# https://downloads.raspberrypi.org/raspios_oldstable_lite_armhf/images/raspios_oldstable_lite_armhf-2022-09-26/2022-09-22-raspios-buster-armhf-lite.img.xz download and unpack.
# image buster lite OS to a new or reformatted 8gb SD (industrial grade is best) N.B. This process will wipe all previous data from SD card
sudo dd bs=4M if=/your location/2022-09-22-raspios-buster-armhf-lite.img of=/dev/mmcblk0 

# create dir on SD for piccolo3 package
sudo mkdir /your RPi/home/pi/packages

# copy piccolo3 *.debs (provided by TeamPiccolo) to SD card
sudo scp -r /your location/piccolo3-server-bundle_0.2-4_armhf.deb /media/amacarth/rootfs/home/pi/packages/

# insert SD card into RPi3 with piccolo control board attached, correctly formatted memory stick attached, combined keyboard&mouse attached and appropriate spectrometers attached and running.
# log onto RPi3 using standard Raspberry PI user and password
#open RPi3 config interface
sudo raspi-config

# configure wi-fi to your own settings for country, SSID (network wi-fi id) & password (passphrase), change RPi password and hostname to your own choice. Note user name will remanin pi and on reboot you should see pi@your hostname: at the command line prompt.
# reboot
# update & upgrade RPi OS then reboot
sudo apt update
sudo apt upgrade
sudo apt dist-upgrade
sudo reboot

# install lite weight desktop environment with chromium browser so that piccolo3 can be controlled & visualised via an HDMI monitor attached to RPi3
sudo apt install xserver-xorg
sudo apt install mate-desktop-environment-core
sudo apt install lightdm

# reboot to desktop Input username (pi) and your password
sudo reboot

#install chromium browser
Applications>system tools> Mate terminal
sudo apt install chromium-browser

# check and note ip address
hostname -I
sudo reboot

# install python3 dependencies
sudo apt install python3-numpy python3-psutil python3-configobj python3-daemon python3-tz python3-gpiozero python3-dateutil python3-lockfile python3-bitarray python3-scipy python3-sqlalchemy python python3-usb

# install piccolo3 debs
cd packages/
sudo dpkg -i piccolo3-server-bundle_0.2-4_armhf.deb

# set up ssh for remote connection
sudo systemctl enable ssh
sudo systemctl start ssh
#edit piccolo.cfg note /etc/ is a dir in the OS root. If you are in /home/pi then
sudo nano ../../etc/piccolo.cfg

# the contents should show the following
[coap]
address = ::
port = 5683
[daemon]
daemon = False
[datadir]
mount = True
datadir = piccolo3_data
device = /dev/sda1

#exit and save
# activte and start piccolo3 server; web, trigger and reboot architecture and 
sudo systemctl enable piccolo3-server piccolo3-web piccolo3-triggered piccolo3-reboot
sudo systemctl start piccolo3-server
sudo systemctl start piccolo3-web

# check piccolo system operating
tail -f /var/log/piccolo.log

# restart
sudo reboot
#open chromium browser and input RPi3/piccolo ip address 
ip address:8000

#or
hostname:8000

#browser should connect to piccolo3 control interface
#check operation by taking measurement
# observe operation
tail -f /var/log/piccolo.log

# note to access from terminal remotely use
ssh pi@ip address

# or
ssh pi@hostname

# to turn off piccolo3 use either terminal and power down
sudo poweroff

127.0.0.1 localhost
::1 localhost ip6-localhost ip6-loopback
ff02::1 ip6-allnodes
ff02::2 ip6-allrouters

127.0.1.1 piccolo3-your id

————————————————————————————————————————————————————————————————————————————

Note a script to build the Piccolo3 OS, after raspian base has been installed, can be downloaded from Github. See TeamPiccolo/piccolo3-build-scripts. There are also scripts to enable system time from a GPS attached to the Piccolo3/RPi GPIO and to build Kiosk. N.B. these scripts  still have to be tested by AM

————————————————————————————————————————————————————————————————————————————–

The Piccolo systems sometimes hangs when writing data to the memory stick. This ‘hang’ may be due to corrupted sectors on the stick caused by not unmounting the stick correctly (other possible causes are being investigated 20180815). Not using sudo poweroff to shut down the Piccolo, or general ware and tear. It may be possible to repair sectors using sudo fsck.msdos -aw /dev/sda1 (if /dev/sda1 is the mount point of the stick). N.B health warning This may irretrievably corrupt the stick and cause all data on it to be lost!! Back up first!! Memory sticks are a ‘consumable’ and should be replaced periodically.