Skip to content
Melbourne University RacingMelbourne University RacingMUR Autonomous WikiAutonomous Wiki

mur-voir is the team’s telemetry dashboard. It shows live data from the car and opens recorded logs. It’s a fork of AdvantageScope, the FRC log viewer.

Download the installer for your computer from the latest release:

ComputerFile
Mac with Apple siliconmur-voir-<version>-mac-arm64.dmg
Mac with Intelmur-voir-<version>-mac-x64.dmg
Windowsmur-voir-<version>-win-x64.exe, or win-arm64 on ARM laptops
Linuxmur-voir-<version>-linux-x86_64.AppImage, or linux-arm64

The apps aren’t signed, so your computer warns you the first time you open one. On a Mac, drag mur-voir into Applications. If macOS refuses to open it, run this and try again:

Terminal window
xattr -cr /Applications/mur-voir.app

On Windows, if SmartScreen blocks the installer, choose More info, then Run anyway.

You can also skip the install and use the browser version.

The live data is only reachable from inside the MUR tailnet. That’s a private network run on Headscale, an open-source server for Tailscale clients. You join it with the normal Tailscale app, logged in to MUR’s server at https://vpn.melbourneuniracing.com instead of Tailscale’s own.

  1. Install Tailscale from tailscale.com/download.
  2. Log in to MUR’s server:
    • Mac: hold Option and click the Tailscale icon in the menu bar. Go to Debug → Custom Login Server → Add Account…, enter https://vpn.melbourneuniracing.com, and click Add Account.
    • Windows: in PowerShell, run tailscale login --login-server https://vpn.melbourneuniracing.com.
    • Linux: run sudo tailscale up --login-server https://vpn.melbourneuniracing.com.
    • iPhone or iPad: tap the account icon, then Log in…. Open the options menu at the top right, choose Use custom coordination server, and enter https://vpn.melbourneuniracing.com.
  3. Your browser opens a page with a command for registering your device. Send it to the MUR Headscale admin, who runs it to let you in.
  4. Keep Tailscale’s DNS setting turned on, which is the default. The dashboard addresses only work through it.

To check you’re in, open http://mur-base.tailnet.internal:8080/healthz. It should load rather than time out.

The Headscale setup is written up in Headscale’s client guides.

  1. Join the tailnet.
  2. In mur-voir, open File → Connect, or press Cmd/Ctrl+K.
  3. Choose MUR Telemetry and enter http://mur-base.tailnet.internal:8080.
  4. Expand the signal tree and drag a signal onto a Line Graph axis. The graph loads up to five minutes of history, then follows the live data.

The window title shows the connection state:

TitleMeaning
address (Searching)mur-voir is connecting.
addressConnected and receiving data from the car.
address (No car data)Connected to the backend, but the car isn’t sending. Check the Pi.
address (Error)The connection failed. See troubleshooting.

If the connection drops, mur-voir reconnects by itself and fills in whatever history the backend still has. Anything the car couldn’t send stays a gap.

Live signals are named vehicles/<car>/<bus>/<message>/<signal>, all in lower case. For example, motor speed is vehicles/mur27/can0/inv_motorposition/inv_motorspeedrpm. BMS values are under vehicles/mur27/bms/.

can0 is bus 0, the Control bus, and can1 is bus 1, the Telemetry bus. These are bus numbers, not the Pi’s interface names, which are swapped: the Pi reads the Control bus on its can1 interface.

Live values arrive in SI units. Motor speed is in rad/s rather than rpm, temperatures are in kelvin, speeds are in m/s, voltages are in volts and pressures are in pascals. Recorded logs use the DBC’s units instead. BMS values have no units attached.

There’s a hosted copy at voir.melbourneuniracing.com, so you don’t need to install anything.

  1. Join the tailnet.
  2. Open https://voir.melbourneuniracing.com/.
  3. Connect with MUR Telemetry and the address https://voir.melbourneuniracing.com. This is the default.

The page loads without the tailnet, but live data doesn’t. If it won’t connect after you join, reconnect Tailscale and restart your browser so it picks up the tailnet’s DNS. Trackside and Video only work in the desktop app.

Open logs with File → Open Log(s). mur-voir reads MF4, candump .log, CSV, JSONL and WPILOG files, and you can select several at once.

The Pi writes one MF4 file per minute of running. Telemetry Pi covers how to get them and merge them into longer files. They hold raw CAN frames, which mur-voir decodes with the DBC files bundled from mur-msgs. To use other DBCs, choose a DBC folder in Preferences.

TabUse it for
Line GraphSignals over time. It has its own time axis, and can plot against lap time or distance instead (both experimental).
TracksideBig readouts for the pit wall, an optional graph of the last 30 seconds, and alarm limits. Always shows the latest data. Desktop only.
Track and lapsThe GPS track, lap times and lap comparisons, in Map, Laps and Split views.
Driver InputsSteering, throttle and front and rear brake pressure as bars.
Car DynamicsFront wheel angles and speeds, yaw, acceleration and damper positions on a drawing of the car.
PointsA plain 2D plot of one signal against another.
Table, Statistics, Console, Video, MetadataInherited from AdvantageScope. Video is desktop only.

Every tab except Line Graph and Trackside shares one timeline. Driver Inputs and Car Dynamics draw the car at the timeline cursor, which follows your mouse.

A layout is your set of tabs and the signals in them. Save it with File → Export Layout to reuse it. Layouts match signals by their DBC name, so a layout built on live data also works on a recorded MF4.

  • Trackside. Drag signals into Tiles. Click a tile’s graph icon to plot it. Click its type icon to set a critical minimum or maximum, and leave it blank for no limit. Active DBC faults show above every tab, even without a tile.
  • Track and laps. Assign the lap setup signals, choose the event, and set the start/finish line if needed.
  • Driver Inputs and Car Dynamics. These start empty. Drag signals into Sources, then right-click a source to choose what it is. Set the scales for the car: Steering Ratio (default 3.827:1), Wheel Radius (0.203 m), Brake Full Scale (1000 psi), Damper Range (50 mm), Wheelbase, Track and Max Speed.

The SBG IMU is mounted with +X pointing right and +Y pointing back, so three signals need flipping in Car Dynamics. Right-click each source and choose Inverted:

Car Dynamics sourceSBG signalSetting
Longitudinal AccelAccelYInverted
Lateral AccelAccelXInverted
Yaw RateGyroZInverted

mur-voir only asks the backend for signals that are on screen, which keeps the dashboard’s traffic down. It doesn’t change how much the car sends over cellular.

mur-voir comes with a mock backend that sends made-up car data. You need Node.js 22.18 or newer.

Terminal window
git clone https://github.com/Melbourne-University-Motorsports/mur-voir.git
cd mur-voir
npm ci
npm run compile
npm run mock-backend -- --lap-counter --speed 1

Then connect mur-voir to http://localhost:8090. Keep --speed 1 if you want laps: at higher speeds every lap is marked invalid.

To run mur-voir from this checkout instead of the installed app, open a second terminal and run:

Terminal window
unset ELECTRON_RUN_AS_NODE
npm start
ProblemWhat to check
Stuck on Searching, or ErrorThat you’re on the tailnet, that the address is right, and that the backend is running.
No car dataThe dashboard reached the backend, so the problem is on the car. Check the Pi’s services and its cellular connection.
Empty graphThat a signal is on an axis, and that it’s available. A signal can be listed while the car isn’t sending it.
No recent historyThe backend may have restarted, which clears its history. Live data still shows.
A signal in a saved layout stays missingThe signal needs the same DBC name. Signals you’ve derived yourself need assigning again.
Browser version won’t connectReconnect Tailscale, then restart the browser.

Report bugs and feature requests on the mur-voir issues page.