A robot from a blank microSD card
No screen, no keyboard, nothing to type on the robot. This page makes the card's setup files: on its first boot your Raspberry Pi joins your Wi-Fi, turns on SSH, installs OpenVibe and adds itself to your robots.
What you need
- The robot's Raspberry Pi (3B+, 4, 5 or Zero 2 W)
- A microSD card, 16 GB or more: everything on it is erased
- A computer with a card reader
- Your Wi-Fi name and password (2.4 GHz works on every Pi)
Describe the robot and your Wi-Fi
Sign in to make your card's files: they add the robot to your account.
Write Raspberry Pi OS to the card
- Install Raspberry Pi Imager on your computer (version 2.0 or newer) and put the card in.
- Device: your Pi (e.g. Raspberry Pi 4). Operating system: Raspberry Pi OS (other) → Raspberry Pi OS Lite (64-bit). Storage: your microSD card.
- When Imager offers to customise the OS, skip it (choose No): your two files do that.
- Write, and wait until Imager says it is done and verified.
Add your two files to the card
Download user-data Download network-config
Made a mistake? Reload this page and make new files. Files that are never used stop working after 7 days.
- Take the card out of the computer and put it back in. A drive called bootfs opens.
- Copy
user-dataandnetwork-configthere, replacing the files with the same names. - The names must be exactly
user-dataandnetwork-config, with no.txt(on Windows, turn on File name extensions to check). - Eject the card.
Switch the robot on
Put the card in the robot's Pi and switch it on. The first start takes 3 to 10 minutes: it sets itself up, restarts once, joins your Wi-Fi and installs OpenVibe and the robot's driver.
Sign in and make your card files: this shows your robot arriving. Open the panel
If it does not arrive
- Check the Wi-Fi name and password. Both are exact (capitals matter). Some older Pis see only 2.4 GHz networks.
- Log in and look. From a computer on the same Wi-Fi:
ssh robot@your-hostname.localwith the login you chose, thenjournalctl -u openvibe-setupshows what it did. With a screen and keyboard on the Pi, log in there. - Each set of files adds one robot and works for 7 days. To start again, make new files here.
- Raspberry Pi OS already running on it? Skip the card: run
curl -fsSL https://openvibe.bot/install | shon it and approve its code at openvibe.bot/link.