IOT-GATE-RPi: Raspbian: Manual Installation

From Compulab Mediawiki
Revision as of 11:12, 7 February 2018 by Rinata (talk) (Preparation steps)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

Introduction

This article provides an introduction on how to install the Raspbian Linux operating system on the CompuLab IOT-GATE-RPi internal storage. The article describes the process using a workstation with a Debian-based operating system. For Windows users instructions can be found on the Raspberry Pi website documentation.

Admolition note.png The devices that arrive from Compulab have an image burned to the internal storage (eMMC) and all packages are installed so there is no need to follow this guide.

Preparation steps

  • Obtain a Debian-based workstation with a free USB port.
  • Download the latest Raspbian package from the Raspbian images repository.
  • Unzip the package to a directory on the host workstation.
  • Install the packages build-essential and libusb by using the command
sudo apt-get install build-essential libusb-1.0-0-dev
  • Ensure Git is installed on the workstation:
sudo apt-get install git
  • Clone the usbboot git repository by using the command
git clone --depth=1 https://github.com/raspberrypi/usbboot
  • Change directories to the usbboot directory
cd usbboot
  • Build the usbboot tool
make
  • Run the usbboot tool
sudo ./rpiboot
The tool will wait for the connection.
  • Plug the USB cable to the workstation on one end and into the micro USB port on the IOT-GATE-RPi on the other end.
  • Power on the IOT-GATE-RPi. The rpiboot tool will recognize the IOT-GATE-RPi and allow access to its internal storage (eMMC).
Admolition note.png If rpiboot doesn't recognize the IOT-GATE-RPi and stays in its waiting mode, make sure the internal SW4 switch is set to the OFF position. For more information see the section Troubleshooting

Writing the image to the Internal Storage (eMMC)

  • When rpiboot completes, a new device, /dev/sdX (X being the lower case letter indicating the device drive letter), will appear. Check /dev/ or run lsblk before and after running rpiboot to see which new device has appeared.
  • Unmount the devices that appeared (in case it is mounted automatically)
umount /dev/sdX[1-9]
  • Write the operating system image to the device by using the command
sudo dd if=/path/to/img/2017-11-29-raspbian-stretch.img of=/dev/sdX bs=1M conv=fsync
  • After writing is complete, unplug and re-plug the USB. Two partitions will appear: /dev/sdX1 a FAT partition, and /dev/sdX2 an ext4 Linux filesystem partition.

After Installation

First boot

  • Boot the IOT-GATE-RPi computer and connect to the Internet.
  • Download the zip file from the link IOT-GATE-RPi Raspbian package.
  • Unpack the zip file containing the packages
unzip iot-gate-rpi_raspbian_2018-01-24.zip
  • Change directories to the iot-gate-rpi-raspbian directory which will appear after the unzip completes
cd iot-gate-rpi-raspbian
  • Make sure the Internet is still connected and run the install-script.sh as root.
sudo ./install-script.sh
  • After the script completes reboot the system.
sudo reboot
Admolition note.png CompuLab provided packages for IOT-GATE-RPi were tested with Raspbian 29.11.2017 release Raspbian images archive. The packages might work properly with other versions as well.

Troubleshooting

  1. rpiboot utility does not recognize the IOT-GATE-RPi
    • Cable is not plugged in properly.
    Check if the cable is plugged in properly.
    • SW4 switch is in ON position
    SW4 is an internal switch which enables or disables the USB boot using the rpiboot utility. The switch is OFF by default. If the IOT-GATE-RPi is not recognized by the usbboot tool, it is possible that the switch was moved to the ON position. In order to check the state of the switch, the bottom service cover of the IOT-GATE-RPi should be opened. SW4 is located near the power and Ethernet connectors.
    Make sure the switch is at the OFF position.

See also