Setting Up Your Raspberry PI
There are two parts to setting up your Raspberry Pi:
- install the software on the SD card, then
- make sure that your Raspberry Pi can connect to the network.
Download our ready made HappyBrackets PI Disk Image. If you want to install a different version of Linux, see Setting up your Pi via a script.
Note. If you are using the Mini HifiBerry or one of the UNSW PiHats, you can download HappyBrackets Pi Image for Mini HifiBerry image. There are also instructions on how to configure HifiBerry manually at this link. Configuring-the-HifiBerry.
There is no need to unzip the file. Etcher works best with the zip file.
Download Etcher and install onto your computer
Insert your SD Card into your computer, select the image file that you downloaded, and press Flash
WARNING! Make sure you are flashing the SD Card and not a hard drive on your computer
Your network settings will be automatically set to SSID: 'PINet' and password 'happybrackets'. See Configuring-Wifi for instructions on how to configure your Pi for your WiFi network. Otherwise, you will not be able to edit these settings until you connect to the raspberry pi over ethernet or plug in a keyboard and monitor.
Alternatively, you could just create this network configuration on your phone (personal hotspot) or on a regular WiFi router by changing the WiFi network settings. The devices will then all connect to this network automatically if the SSID is "PINet" with password "happybrackets".
NOTE ABOUT PHONES: If you are using an Android phone to connect to your Pi using a personal hotspot most of them will allow you to set both the SSID and password (some will give more options than others). If you are using an iOS phone with a personal hotspot, however, you can change the password, but will not be allowed to edit the SSID on the phone itself. You will need to change the whole name of the phone using iTunes. Once you do this, however, you should be able to use your iOS phone to act as a WiFi router to connect to your Pi.
-
The disk image we share comes with the default RaspberryPi login details (user=pi, password=raspberry) and with ssh login enabled. This means that someone could log into your device and control it. You are strongly encouraged to change the Raspberry Pi user password from its default. To do this, when logged into your Pi type
sudo raspi-configand select the option to change your password. -
Once set up on a Raspberry Pi, HappyBrackets runs a program that listens for incoming code commands. This exposes your Raspberry Pi to being hacked from anyone on the same local network, if they wished to do so, using the HappyBrackets library (you are sending code to the device, so they can too). As a simple measure, you should ensure that you operate on a closed network for which only you have access. However, as a security measure, the code being sent can also be encrypted, and you have the option to set your own matching passwords on the device and in the IntelliJ Plugin so that only your code can be sent (see Configuring HappyBrackets). There is also an option in the HappyBrackets run.sh script that allows you to set the device not to listen for commands (useful if you have set a HappyBrackets action to autorun and don't need to live code the device), or to listen only to commands coming from localhost (useful when you are running the HappyBrackets client on your host computer).
See also