Software Installation

Software installation for the Traffic Monitor.

Whether you Build Your Own Device (DIY) or buy a pre-built unit, these are the instructions to perform a fresh install.

Preparation

Raspberry Pi OS 64-bit Lite install is the recommended default; however, RPi OS 64-bit Full install will give you a desktop environment and other packages. Find it on RPi Imager by navigating to Operating System > Raspberry Pi OS (other) > Raspberry Pi OS Lite (64-bit).

1. Install Raspberry Pi OS (64-bit lite) using RPi Imager.

   • Recommended: OS customization to set up your WiFi credentials and username and password to access the device headless; i.e. SSH with no monitor or keyboard.

2. Insert the microSD card and boot up the Raspberry Pi device.

   • Note: The first boot may take a few minutes before it is fully online.

Install the Traffic Monitor software

An internet connection is required to install system dependencies, build the required Docker containers, download drivers, and more. After installation, the traffic monitor can run fully offline.

The Traffic Monitor software is installed via an Ansible deploy script. This allows you to perform a local installation or remote installation from a host computer to 1 or more devices simultaneously!

Local installation

1. Connect to your device and executing the following commands via a terminal:

   1. sudo apt update && sudo apt install -y git

   2. git clone https://github.com/glossyio/traffic-monitor

   3. bash traffic-monitor/script/tmsetup.sh

2. Follow instructions and restart when prompted.

Remote Installation

Install the TM software to 1 or more devices simultaneously using our Ansible deploy script. This allows you to deploy or update a whole fleet of Traffic Monitors with common configuration files in a single command!

Before you can perform remote installation, ensure the following:

1. Your host machine is able to run bash commands (Linux or Mac)

2. Raspberry Pi OS is installed on each device

3. the device is running and online

4. you have the device IP address or resolvable host name from your host to the device

1. On your host machine, download TM OSS software and set up any configurations you want to send:

   1. git clone https://github.com/glossyio/traffic-monitor

2. Run the install script from your host machine with your device IP address(es), enter username specified on OS setup (needs to be the same across all devices, and prompt for password):

   1. bash traffic-monitor/script/tmsetup.sh -H <ip_address> -l <ssh_username> -k

3. Continue to Deployment and Mounting Guide and Setup Guide for each device.

Next Steps

1. Deploy your device: See the Deployment and Mounting Guide.

2. Set up zones, location, and enable your sensors: See Setup Guide.

3. Start capturing roadway usage data!