util-WebController

The util-WebController receives debug information through the util-ForwardingServer. It parses the debug information and charts quantifiable data where applicable. It can also show live camera feeds or use bandwidth-efficient canvas drawings.

Runs on user's laptop

Fully containerized using Docker, images available here

Adheres to Makefile spec

Source code is confidentially available using your Github token

Does not use service.yaml

Does not register with SystemManager

Functionalities

• Automatically parses incoming debug information and charts quantifiable data where applicable
• Visualizes dependency graphs and shows all running services with their configurations
• Lists available (OTA) tuning parameters and configurations and enables OTA tuning where
• Uses the Gamepad API to allow Rover1 steering and acceleration using a PS4, PS5 or xbox controller

Running this utility

tip

If you are running this utility on an ARM device (such as M1 macs), we recommend running this utility through Docker compose for improved performance.

Through Docker with Dockerhub

1. Download and run the latest docker image.

docker run --rm -p 5173:5173 --pull=always --name web-ui aselabsvu/web-ui:latest

Instead of using :latest, you can use a version tag as listed here.

Through Docker using Docker compose

1. Clone the source code using your private ASE token. Make sure to replace <YOUR_TOKEN> with the token you received by email.

git clone https://<YOUR-TOKEN>@github.com/VU-ASE/util-WebController.git
# optional, but recommended
git pull

2. Enter the source code directory

cd util-WebController

3. Build using Docker compose

docker compose build

4. Run using Docker compose

docker compose up

From source

1. Clone the source code using your private ASE token. Make sure to replace <YOUR_TOKEN> with the token you received by email.

git clone https://<YOUR-TOKEN>@github.com/VU-ASE/util-WebController.git
# optional, but recommended
git pull

2. Enter the source code directory

cd util-WebController

3. Install all dependencies through npm

npm install --legacy-peer-deps

4. Build from source

npm run build

5. Start from build

npm run start

Finally, access the WebController at localhost:5173 to confirm that it is running and start using it.