Skip to content

Latest commit

 

History

History

harrylaptimer

Connecting to Harry's LapTimer

More info at https://www.gps-laptimer.de/, where you can also find a very good user and developer forum. It offers the largest set of customizable options to build your own external device and it is the only supported platform for iOS phones via Bluetooth Low Energy.

Example

Features

  • NMEA parsing offered by HLT directly: GxRMC+GxGGA+GxGBS messages
  • Enable or Disable GxGSV+GxGSA as needed, with a lower update frequency selectable for 1, 2, or 5 sec (as instructed by Harry)
  • tested with v24
  • from v1.2 of BonoGPS, battery information on certain ESP32 boards (for example LOLIN D32 PRO) is available so that HLT can provide it back to you while using the app

Connections

  • iOS and Android: TCP/IP port 8118. This is the easier option, yet it prevents connecting other devices to your mobile phone (e.g. an action camera or an ODBII device) so it's not recommended
  • iOS: BLE tested on iPhone (tested with 7). BLE nicely handles up to 10Hz GPS update rates when GSV/GSA streaming is disabled or polled at low frequencies (e.g. every few seconds)
  • Android: BT-SPP tested on Android, 10Hz and GSV/GSA at higher polling frequency (streaming saturates the UART connection on the GPS itself)

After configuring the connection, your unit shows up in the Sensors List as 'Custom [BTLE/TCP-IP] GNSS' device

Configured

now you can open the 'GPS' page and check that you are receiving valid GPS data

Running

with a paid add-on, you can also see the satellites constellation map

GPS Map

iOS Bluetooth Low Energy setup

Go to Administration > Settings > Expert Settings and

  • within 'accessory tweaks', turn on 'Use Bluetooth LE Sensors'
  • within 'custom btle gps adapter', set 'Peripheral Name' to BonoGPS-XXXX where XXXX is the id of your device as shown in the title of the configuration page
  • within 'custom btle gps adapter', set 'Service UUID' to 1819 (standard for SERVICE_LOCATION_AND_NAVIGATION_UUID)
  • within 'custom btle gps adapter', set 'Read Characteristic UUID' 2A67 (standard for CHARACTERISTIC_LOCATION_AND_SPEED_CHARACTERISTIC_UUID)

BLE

Click on the (i) to see more information about what HLT collects BLE with battery

If your ESP32 board has a battery and you have enabled the SHOWBATTERY feature, it will be reported as battery %.

iOS and Android TCP/IP setup

Go to Administration > Settings > Expert Settings and

  • within 'accessory tweaks', turn on 'Use Wi-Fi Sensors'
  • within 'custom wifi gps adapter', set Connection Type TCP/IP, 'Device IP Address' to 10.0.0.1, TCP Port to 1818

WiFi

Android BT-SPP Setup

Go to Sensor List and

  • Pair your bluetooth device as any BT device on your phone
  • Click on the Bluetooth + icon at the top of the page
  • Select your newly paired BonoGPS device
  • Specify use as GPS

Configuration panel

Use the (i) icon to check the messages being exchanged

List of received messages

Now head to GPS to verify it is correctly working

GPS page showing status and information received

GPS Configuration for NMEA messages

According to this good reference message on the forum

I recommend to enable RMC+GGA+GSA+GSV, with RMC+GGA at 10 Hz and GSA+GSV at 1 Hz or lower.

  • GxGSA and GxGSV are polled every 5 seconds (2.5 seconds each) with $EIGNQ,GSA*2D and $EIGNQ,GSV*3A respectively
  • GxGGA, GxRMC, and GxGBS are streaming

HLT is the only app that easily works with the GN talker id, so no translation of Talker ID was necessary.