Overview

Purpose

The display service shows the Rover identity and resource utilization on the OLED ssd1306 display that is mounted on the front of each Rover.

tip

We do not recommend installing this service manually, as roverd will automatically check for updates and install it as a daemon service every time the Rover boots.

Installation

To install this service, the latest release of roverctl should be installed for your system and your Rover should be powered on.

Using roverctl

1. Install the service from your terminal

# Replace ROVER_NUMBER with your the number label on your Rover (e.g. 7)
roverctl service install -r <ROVER_NUMBER> https://github.com/VU-ASE/display/releases/latest/download/display.zip 

Using roverctl-web

1. Open roverctl-web for your Rover

# Replace ROVER_NUMBER with your the number label on your Rover (e.g. 7)
roverctl -r <ROVER_NUMBER>

2. Click on "install a service" button on the bottom left, and click "install from URL"
3. Enter the URL of the latest release:

https://github.com/VU-ASE/display/releases/latest/download/display.zip 

Follow this tutorial to understand how to use an ASE service. You can find more useful roverctl commands here

Requirements

• The ssd1306 display should be connected to the Rover

Inputs

As defined in the service.yaml, this service does not depend on any other services.

Outputs

As defined in the service.yaml, this service does not expose any write streams.