Overview

Purpose

The battery service uses the ADS1015 voltage sensor to track the battery charging level. If the voltage drops below a warning threshold it will send a warning to active SSH users. If the voltage drops below a critical threshold it will shut off the Debix to prevent undercharging in order to improve battery aging.

NB: the warning and shutdown thresholds are based on the battery properties (cell count and nominal voltage.)

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/battery/releases/latest/download/battery.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/battery/releases/latest/download/battery.zip 

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

Requirements

• The ADS1015 voltage sensor 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.