Raspberry Pi Manual Setup


If your Raspberry Pi is not yet set up, we recommend installing Raspbian Buster. To complete these steps, you’ll need the following:

  • Your Raspberry Pi 3 or 4

  • Computer monitor

  • HDMI cable

  • USB mouse and keyboard

  • Micro SD card

  • Some kind of adapter to modify the micro SD card with your development machine


If you have all the equipment listed above, follow these steps to set up the board:

  1. Download the Raspbian Buster image to your development machine. Select the “Raspbian Buster with desktop and recommended software” download from the Raspbian download page.

  2. Flash the image on your SD card using a tool like balena Etcher.

  3. Attach the monitor, mouse, and keyboard to the Raspberry Pi, plug in the SD card, and boot the Pi. Go through the initial configuration.

  4. Update the installed packages: In a terminal run sudo apt-get update && sudo apt-get upgrade -y to ensure you have the latest packages installed.

  5. Enable SSH: Open a terminal and run the sudo raspi-config command to bring up the configuration tool. In the “Interfaces” tab, select the “SSH” line to enable SSH.

  6. Connect to Wi-Fi: Before you move over to your development machine, you should connect to Wi-Fi and note down the Pi’s IP address. In raspi-config go to the “Networking Options” and select the “Wi-Fi” option. Enter your Wi-Fi credentials to connect. Select Finish to exit raspi-config. In your terminal, enter ifconfig and note down the IP address in the wlan0 section. It will look like this:

     inet 192.168.1.75
    
  7. Test your SSH connection: From a terminal on your development machine, open an SSH connection to the Pi using the device credentials. If you left the Raspbian defaults your username will be pi, your hostname will be raspberrypi, and the password will be raspberry.

     $ ssh <username>@<hostname>
    

If the hostname is not found on your network, try the IP address. If the connection goes through, you’re ready to move on to installing Docker and other edgeIQ requirements.

Install Docker and Other Dependencies

Connect to your device

From your host machine, SSH to your device using the device credentials. If you left the Raspbian defaults, your username will be pi, your hostname will be raspberrypi, and the password will be raspberry.

    $ ssh <username>@<hostname>

If the hostname is not found on your network, try the IP address.

Enable the camera

If you’re using the Raspberry Pi ribbon camera, in a terminal run the sudo raspi-config command to bring up the configuration tool. In the “Interfaces” tab select the “Camera” line and choose it to enable the camera. You can reboot now or wait until after the Docker install.

If you’re using a USB webcam, you’ll need to add the USB webcam module. Open the /etc/modules file using nano:

        $ sudo nano /etc/modules

and add bcm2835-v4l2 to the end of the modules list.

Install Docker

Run the following commands in the SSH connection to install Docker on your Raspberry Pi:

    $ sudo curl -sL get.docker.com | sed 's/9)/10)/' | sh  
    $ sudo usermod -aG docker $USER  
    $ sudo reboot

Test

Once the Pi reboots, open a new SSH connection and test the Docker installation with the following command:

    $ docker run hello-world

Your Raspberry Pi is now ready to go!