Skip to content
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
43 changes: 5 additions & 38 deletions docs/01-overview.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,50 +3,17 @@ import TabItem from '@theme/TabItem';

# 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.

![The ssd1306 display mounted on the front of Rover 1](https://github.com/user-attachments/assets/038036e2-43dd-47f0-a785-140abefc9612)

:::warning[Important]

:::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.
`display` is known as a daemon service. You do not need to manage this service yourself. For more information, please visit the page about [`roverd`'s daemon services](https://ase.vu.nl/docs/tutorials/knowing-more/roverd-daemons).

:::

## Installation

To install this service, the latest release of [`roverctl`](https://ase.vu.nl/docs/framework/Software/rover/roverctl/installation) should be installed for your system and your Rover should be powered on.

<Tabs groupId="installation-method">
<TabItem value="roverctl" label="Using roverctl" default>

1. Install the service from your terminal
```bash
# 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
```

</TabItem>
<TabItem value="roverctl-web" label="Using roverctl-web">

1. Open `roverctl-web` for your Rover
```bash
# 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
```
## Purpose

</TabItem>
</Tabs>
The `display` service shows the Rover identity and resource utilization on the OLED ssd1306 display that is mounted on the front of each Rover.

Follow [this tutorial](https://ase.vu.nl/docs/tutorials/write-a-service/upload) to understand how to use an ASE service. You can find more useful `roverctl` commands [here](/docs/framework/Software/rover/roverctl/usage)
![The ssd1306 display mounted on the front of Rover 1](https://github.com/user-attachments/assets/038036e2-43dd-47f0-a785-140abefc9612)

## Requirements

Expand Down
Loading