Preparing the POP Kiosk Software

From CLIO

Revision as of 19:38, 30 October 2022 by Metaphoraccoon (talk | contribs)

Overview

After the hardware is put together, we can install the software we need to get up and running. This will involve using software on another computer to copy files to an SD card.

Downloading the Image

Using a web browser, navigate to the POP GitLab. This is where you can download the latest version of the POP Kiosk Quick-Start image. On the POP GitLab website, click the 'Download' button beside the blue Clone button. This will open a pop-up that will allow you to download the repository in different formats. We recommend the 'zip' file format because it is cross-platform compatible by default on most systems.

GitLab POP Kiosk Download.png

Once downloaded, extract the file 'pop-kiosk-main.zip'. Within this file, there will be another zip file named 'POP-v*.*.zip'. Extract this file, as well. Please note, the expanded file will be approximately 32gb, so you may need to ensure you have adequate disk space.

Flashing an SD Card

First, we will need to download the software required to write the image to the SD card.  Using a web browser, navigate to https://www.balena.io/etcher/ and download the latest version available for your current operating system.  BalenaEtcher supports Microsoft Windows, Apple MacOS and Linux.  Once Balena Etcher is downloaded, open the program. When BalenaEtcher is open, you will be presented with the main menu. 

BalenaEtcher Home Screen

To flash an image to an SD card, we must first direct BalenaEtcher to it.  Click on ‘Flash from File’ and navigate to the appropriate image downloaded from our website.  Select the image file and hit open.

BalenaEtcher Image Selected

Next, we will need to plug our desired SD card into the computer.  Using a MicroSD to USB adapter, plug in the SD card to your computer.  Click on ‘Select target’. Search through the list of devices and find your SD card, using the name and size.  By default, BalenaEtcher will only show externally connected devices, such as USB flash drives or hard drives.  All system drives and internal hard drives are hidden, decreasing the risk of flashing the wrong drive.

BalenaEtcher Selecting a Drive

Once you’ve selected the SD card, you can hit flash to begin copying over the image.  In order to do this, you will need to enter the password of a computer administrator.  Operating systems, such as MacOS, may require you to allow different access rights.  After permission has been granted, the data will begin to transfer and should not require user interaction.

BalenaEtcher Target Selected
BalenaEtcher Flashing

BalenaEtcher will verify all of the data written to the SD card before finishing.  Once it is completed, you will be presented with the success screen.  If you are making additional kiosks, you have the option to begin flashing another SD card.

BalenaEtcher Complete

Installing the SD Card

After your SD card has been flashed, you can install it into a Raspberry Pi. The SD card slot is located on the underside of the Raspberry Pi computer, on the side opposite from the USB ports. After it is installed, you can plug in the USB power cord into the kiosk to test it.