meshO Manager

Appearance

Troubleshooting ​

Audience: Anyone hitting an error or unexpected behaviour in Manager.

Symptoms, likely causes, and fixes — ordered by how likely you are to hit each one.

Status: Stub — not yet written. Expect this page to grow as operators feed back real-world problems.

Starting Manager ​

macOS says meshO Manager "is damaged and can't be opened" ​

The app is not damaged. macOS shows this (or "…can't be opened because it is from an unidentified developer") the first time you launch Manager because it isn't notarised by Apple yet and your browser tagged the download with a quarantine flag. Don't move it to the Bin. Open Terminal and run:

bash
xattr -cr /Applications/meshO\ Manager.app

Then launch Manager normally from Applications. This is a one-time step. It is not caused by the browser you used (Safari, Chrome and Edge all behave the same), and on Apple Silicon Macs the "damaged" message is not cleared by right-click → Open — only the Terminal command above works. Full details, including the milder Intel-Mac path, are in Allowing the app on macOS.

Connecting hardware ​

The SportIdent station doesn't appear in the browser's device chooser (macOS) ​

On a Mac, the browser's serial-device chooser comes up empty (or lists only unrelated ports) even though the station is plugged in and powered. macOS doesn't recognise SportIdent's USB product ID, so it never creates a serial port for the station — and Web Serial can only offer up real ports. Install the Silicon Labs CP210x driver once per Mac, and approve it in System Settings (the installer stalls at "Installing new driver…" until you do). Full steps: SportIdent USB stations on macOS.

If the chooser does list the station but the download controls never appear at all, that's a different problem — Web Serial needs a secure connection off the server machine. See HTTPS and certificates.

Reaching the server ​

A laptop can't find the server by name — DNS_PROBE_FINISHED_NXDOMAIN ​

Chrome shows "This site can't be reached" with DNS_PROBE_FINISHED_NXDOMAIN for the name-based access link, while the same address opens fine in Safari, Firefox or on a phone. Chrome uses its own DNS resolver and frequently won't resolve the server's computer name, so it asks the router instead — which has no record for it.

Use the link tagged IP in Settings → Server → Access links on that laptop. This hits download and station-backup machines hardest, because those are the ones typically running Chrome for Web Serial. To use a name on them anyway, give the server a DHCP reservation and host name on the venue router, or run Firefox 151+ there — it also has Web Serial and looks names up through the operating system. Full detail: Reaching the server: name or IP.

If neither the name nor the IP works from another device, it isn't this — check Allow access from other devices on the network in Settings → Server, then the server machine's firewall.

What this page will cover ​

Starting Manager ​

  • [ ] Manager won't start / crashes on launch
  • [ ] Previous version not fully uninstalled

Connecting hardware ​

  • [ ] meshO Prime isn't detected on any COM port
  • [ ] COM port opens but no messages arrive
  • [ ] Connection keeps dropping
  • [ ] SI reader not detected (the macOS driver case is covered above)

Data ​

  • [ ] Imported event shows no competitors / classes
  • [ ] Duplicate competitors after a re-import
  • [ ] Can't find a specific event in the Events list
  • [ ] Unexpected statuses after an import

During the event ​

  • [ ] Punches arriving but not landing on competitors
  • [ ] Radio punches stopped suddenly
  • [ ] Screens are blank or stuck
  • [ ] Dashboard shows alerts I don't understand
  • [ ] Time on a radio / SI box is wrong

Logs and diagnostic data ​

  • [ ] Where Manager keeps its logs
  • [ ] How to grab a capture file for bug reports
  • [ ] Useful information to attach to a support request
  • [ ] Repairing a corrupted event — see Backup and restore