🔋 AiRISTA Flow RTLS - BatteryHistory

BatteryHistory is a simple application that displays an interactive view of a battery discharge curve. Specifically, the battery history of any active RTLS tag can be viewed.

The following images show the main views of the application.

⚙️ How it works

The application determines the data points for the curve by addressing the XML API of the RTLS controller. The MAC address of a tag is used as a filter. The API returns the entire battery history of the tag after authentication and request. The data is then plotted on a line graph.

🎯 Project goals

• Display battery history of any tag
• Provide data in web frontend
• Interactive selection of the period to be viewed
• Screenshot function for the adjusted display
• Import all MAC addresses for easy selection
• Provide Windows installer

📜 Installation guide

Build from source

From the root of the source tree, run:

go build cmd/main.go

Deploy with Docker

It is recommended to use docker-compose as it is very convenient. The following example shows a simple deployment without a proxy.

version: '3.9'

services:
  battery-history:
    image: plaenkler/battery-history:latest
    container_name: battery-history
    restart: unless-stopped
    ports:
      - 9000:9000
    volumes:
      - ./battery-history:/app/config

Configuration

At first startup, the program creates a config directory relative to the executable file and a config.yaml file in it. In this document all settings of the application are stored.

• The first four parameters must be set according to the RTLS server configuration.
• The last parameter is the Port on which the web server of BatteryHistory listens.

serverAddress: 127.0.0.1
serverPort: "8550"
serverUser: user
serverPassword: password
Port: "9000"