GSPro¶

OpenFlight streams shots into GSPro using the OpenConnect V1 API — the de-facto open standard for launch-monitor → sim integrations.

See the connector architecture in README.md. This page covers requirements and setup specific to GSPro.

Requirements¶

• A GSPro license. GSPro is paid software (subscription). The OpenConnect API is included with a standard license — there is no separate add-on.
• An OpenAPI / OpenConnect license type. GSPro ties each license to a launch-monitor type, and OpenFlight connects as a generic OpenConnect device. If your license is set to a specific monitor (Foresight, Uneekor, etc.), you must convert it to the OpenAPI type using GSPro's license conversion tool. After converting, install the latest GSPro and clear your GSPro Connect settings so the OpenAPI option is selectable (see How To Clear GSPro Connect Settings).
• The GSPro Connect window. GSPro exposes the API through its built-in "GSPro Connect" / OpenAPI interface, which listens on TCP port 921.
• Network reachability + an open port 921. OpenFlight (the Raspberry Pi) and the PC running GSPro should be on the same LAN; you need the GSPro PC's IP address. TCP port 921 must be reachable on the GSPro PC — allow it as an inbound rule through the PC's firewall (Windows Defender Firewall by default). If OpenFlight and GSPro are on different networks, you'd have to forward 921 to the GSPro PC on the router — but OpenConnect has no authentication (below), so never expose 921 to the public internet; keep both on the same trusted LAN.
• No account/credentials are sent by OpenFlight — OpenConnect V1 has no auth.

Setup¶

1. Convert your license to OpenAPI (one-time). Open the GSPro license conversion tool, enter your GSPro license key, and select the OpenAPI / OpenConnect option. Then install the latest GSPro and clear your GSPro Connect settings so the OpenAPI interface is selected (how to clear Connect settings). Skip this if your license is already the OpenAPI type.

2. Find the GSPro PC's IP address and open port 921.

3. Windows: ipconfig → IPv4 Address (e.g. 192.168.1.50).

4. Allow inbound TCP 921 through the GSPro PC's firewall. The GSPro installer can add this rule for you; if OpenFlight's connection is refused, add it manually in Windows Defender Firewall (Inbound Rules → New Rule → Port → TCP → 921 → Allow).

5. Configure OpenFlight. Copy the example config if you haven't already:

   cp config/sim.example.json config/sim.json
   

   Set the GSPro connector:

   {
     "connectors": [
       {
         "type": "gspro",
         "enabled": true,
         "host": "192.168.1.50",
         "port": 921,
         "device_id": "OpenFlight",
         "units": "Yards",
         "heartbeat_interval_s": 5
       }
     ]
   }
   

   Then enable simulator connectors at launch with --sim (off by default):

   scripts/start-kiosk.sh --sim
   

6. Open GSPro and start a round, then open the GSPro Connect window (the OpenAPI interface). It should report "Waiting for connection".

7. Start OpenFlight. The header GSPro pill should turn green (connected). GSPro Connect should show the device connected.

8. Hit a shot. It appears in GSPro within a few milliseconds, and the "Sent to GSPro" panel in OpenFlight shows the values sent with measured/estimated badges.

What gets sent¶

Club selection¶

When you change clubs in GSPro, it sends a player update (code 201). OpenFlight applies it: the current club used for shot tagging and the carry/spin model follows GSPro. Putts (PT) are out of scope and ignored.

Troubleshooting¶

• Pill stays amber (connecting / reconnecting): OpenFlight can't reach host:port. Check the IP, that GSPro Connect is open, and that inbound TCP 921 is allowed through the GSPro PC's firewall. "Connecting" means it has never connected yet (often a wrong IP or a blocked port); "reconnecting" means it was connected and the link dropped. OpenFlight retries automatically with backoff (1→2→4→…→30s).
• Can't select OpenAPI in GSPro Connect, or shots are rejected: your license is likely set to another monitor type. Convert it to OpenAPI (conversion tool) and clear your Connect settings, then restart GSPro.
• Pill red (error): GSPro returned an error code; hover the pill for the message. The connection stays up.
• Shots don't appear in GSPro: confirm a round is active and the Connect window shows the device connected. Check sim_send entries in the session log to confirm OpenFlight is sending.

References¶

• GSPro OpenConnect V1 spec
• GSPro license conversion tool (convert to OpenAPI)
• GSPro Knowledge Base: clear GSPro Connect settings
• GSPro Knowledge Base