This page walks you through the steps necessary to choose hardware for your Pi and set up the Pi on Horizon. Both Raspberry Pi 2 and 3 are supported. We recommend R Pi 3 for performance advantages, internal WiFi, availability, and cost.
The steps to set up and register your Raspberry Pi device with Horizon are:
All hardware supported on Horizon for the Raspberry Pi and experiments is listed in our hardware section. Set up the Pi in a good location to receive WiFi signal, or connectivity via Ethernet. Connect all your dongles / sensors to the Raspberry Pi. Refrain from powering the Pi or inserting the SD Card, as you'll do those tasks in the following steps.
Download the SD Card image to a computer on which you can decompress the image and write it to a MicroSD card (in steps 3 & 4).
If your computer has not automatically decompressed the zipped image archive, then you will need to manually unzip it. The uncompressed image will be named horizon-rpi[n]-[date]_[rev].img (where "[date]" is the publication date and [rev] is the unique revision of that Horizon image).
Now you need to write this image file onto your MicroSD card so your Pi can use it to boot up Linux.
PLEASE NOTE: If you have anything important on the MicroSD card, then you will want to save those files before doing this step. This step will completely erase the MicroSD card and write this new disc image onto the card. Anything previously stored on the MicroSD card will be lost.
For help with this step, please consult Raspberry Pi's installing-images doc:
Flashing the MicroSD card may take 50 seconds to many minutes to complete.
The quick & easy way: To use WiFi, you will need to set it up in the image on the MicroSD card. For home networks with WPA2 (common) authentication, use these instructions:
Alternatively, if you wish to use the full capability of wpa_supplicant via the wpa_supplicant.conf file, follow these instructions. This method supports MSCHAPV2 and other enterprise authentication methods. Horizon will use this config file preferentially if it exists.
ssid="your wifi ssid" psk="your wifi password"
Once your MicroSD card has been flashed, insert it into your device. Attach any additional hardware to your device at this time (USB SDR dongle, keyboard, console cable, etc.) Also make sure to connect the WiFi adapter or an Ethernet cable for network access.
When you are ready, power on the device.
Default account login: "root", password: "horizon".
PLEASE NOTE: We recommend you change this password as soon as you login to the Pi. (You can use the standard Linux command passwd. The passwd command will prompt you for the details.)
The entire boot process takes about 3 minutes. You'll observe from the console the OS booting, running firstboot to configure itself, and then rebooting once more. The Pi is ready when the login screen host name is horizon-[number], where [number] is the CPU serial number of your device.
Boot process video, including WiFi setup using the console. (This video is slightly out-of-date and will be updated soon to reflect changes in our new software image. The overall setup process is similar. Our written setup instructions here are up-to-date.)
Once your Pi has booted, you'll be able to connect to the Pi via a web browser and register for Horizon experiments. You'll discover the Pi's IP address, and visit its self-hosted registration webpage. Click here for registration instructions.
If you have any difficulties with any of these steps, please contact the Horizon community for help by clicking on the Forum tab at the top of this page. You can also report Horizon bugs in the forum.