Skip to content

Prepare your PC

Your PC is used to:

  • Configure tracelet parameters
  • Visualize vehicle positions
  • Monitor tracelet quality metrics

Demo kit PC architecture

Toolchain overview

  • Easyplan – Windows application that visualizes and records vehicle tracks on a map
  • Grafana – Web UI for visualizing tracelet quality metrics
  • Prometheus – Time-series database storing metrics published by the tracelet
  • redpanda-connect – Streams tracelet data to other systems; the demo kit split delivers positioning and quality metrics separately
  • io4edge-cli – Command-line utility for configuring tracelet parameters and firmware

Software installation

These instructions target Windows 11. Windows 10 may work but is untested.

Install the following software:

  1. Docker Desktop – follow the official installation guide. Note: Docker Desktop requires a paid license for some organizations.
  2. (Optional) Git – follow the installation guide if you prefer cloning repositories with Git.

Retrieve the demo kit docker composition

If Git is installed, pick a working directory for the composition files (for example C:\work) and run:

cd C:\work
git clone -b rev-0 https://github.com/ci4rail/lyve-demokit.git
cd lyve-demokit

Without Git, download the repository as a ZIP from GitHub (https://github.com/ci4rail/lyve-demokit, branch rev-0) and extract it to your working directory.

Start the services:

docker-compose up -d

Verify that the containers are running:

docker compose ps

You should see three running containers similar to:

NAME                        IMAGE                                 COMMAND                  SERVICE      CREATED          STATUS                  PORTS
lyve-demokit-benthos-1      ci4rail/redpanda-connect-kyt:v1.1.0   "./redpanda-connect-…"   benthos      13 seconds ago   Up 9 seconds            0.0.0.0:4195->4195/tcp, 0.0.0.0:11001->11001/udp
lyve-demokit-grafana-1      grafana/grafana-enterprise:11.3.1     "/run.sh"                grafana      13 seconds ago   Up 9 seconds            0.0.0.0:3000->3000/tcp
lyve-demokit-prometheus-1   prom/prometheus:v2.53.5               "/bin/prometheus --c…"   prometheus   13 seconds ago   Up Less than a second   0.0.0.0:9090->9090/tcp

Check Grafana by opening http://localhost:3000 in a browser. Log in with:

  • Username: lyve-demo
  • Password: lyve123

Then navigate to Dashboards → Single Tracelet Details.

Grafana dashboard

Install Easyplan

Easyplan is available through Pinpoint Cloud. Access credentials are provided with the demo kit.

Install io4edge-cli

Download and extract the command-line tool to configure the tracelet:

mkdir C:\work\io4edge-cli
Invoke-WebRequest -Uri https://github.com/ci4rail/io4edge-client-go/releases/download/v2.0.0-alpha.5/io4edge-cli-v2.0.0-alpha.5-windows-amd64.zip -OutFile io4edge-cli.zip
Expand-Archive .\io4edge-cli.zip -DestinationPath .

Verify the installation:

C:\work\io4edge-cli\io4edge-cli.exe --help