Skip to content

poppy-project/raspoppy

Repository files navigation

Raspoppy: Utility tools to setup a Raspberry Pi for Poppy robots

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.

Update

Manual install

Install Raspberry Pi OS

Download the latest Raspberry Pi OS (32-bit) with desktop and follow the installing guide. We used 2021-05-07-raspios-buster-armhf.img.

Setup the OS for our needs

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

Shrink the image

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).

About

Utility tools to setup a Raspberry Pi board for a Poppy Creature

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages