This repository regroups the set of tools we use to setup a Raspberry Pi board for a Poppy robot.
While we try to keep this procedure as simple as possible, it still requires a good knowledge of Linux OS and of Python. For those who are not interested in digging into those details, we provide ready-to-use SD-card images which can be directly downloaded and copy into your Raspberry.
Download the latest Raspberry Pi OS (32-bit) with desktop and follow the installing guide. We used 2021-05-07-raspios-buster-armhf.img.
Boot your system and temporarily connect a HDMI monitor, and an Ethernet cable to your router. In order to raspoppyfy your Raspberry Pi, it is needed that the Raspberry Pi has an internet access.
Then open the terminal and type these commands:
curl -L https://raw.githubusercontent.com/poppy-project/raspoppy/master/raspoppyfication.sh -o /tmp/raspoppyfication.sh
chmod +x /tmp/raspoppyfication.sh
sudo /tmp/raspoppyfication.sh --branch=master They will install all the software detailed above, and set up the control interface. When it's done, reboot the Raspberry Pi and connect to http://poppy.local.
The installation script defaults will set the board for a Poppy Ergo Jr, but it can be slightly tailored to suit your needs. ./raspoppyfication.sh --help displays available options.
Options are:
--creature: Set the robot type (default:poppy-ergo-jr)--username: Set the Poppy user name (default:poppy)--password: Set password for the Poppy user (default:poppy)--hostname: Set the robot hostname (default:poppy)--branch: Install from a given git branch (default:master)--shutdown: Shutdowns the system after installation-?|--help: Shows help
Assuming that you have raspoppyfied your SD card, dump it to an image file, e.g 2020-04-06-poppy-ergo-jr.img.zip and use pishrink to make it as small as possible. Since the image after shrinking is still a large file, we split it in several zip files of 1500MB:
sudo dd if=/dev/mmcblk0 of=$(date +%F)-poppy-ergo-jr.img bs=1M status=progress
wget https://raw.githubusercontent.com/Drewsif/PiShrink/master/pishrink.sh -O /tmp/pishrink.sh
chmod +x /tmp/pishrink.sh
sudo /tmp/pishrink.sh $(date +%F)-poppy-ergo-jr.img.zip
zip $(date +%F)-poppy-ergo-jr.img.zip $(date +%F)-poppy-ergo-jr.img -s 1500M
Then you can distribute your own image including the zip file and all the z01, z02 ... file extension(s).