TeenyGPSTestbed_C2 is an application for configuring and evaluating Ublox GPS modules. This application runs on the M5Stack Core2 ESP32 IoT Development Kit. The application was developed for Ublox M8 and M10 GPS modules connected to the Core2's Serial2 interface. The application also has a Ublox GPS emulation mode which can be used for testing navigation applications when no GPS signals can be acquired or when a fixed, repeatable GPS source is desired.
Menu Navigation: TeenyGPSTestbed_C2 utilizes the TeenyMenu library for menu/page navigation via a three button interface. The TeenyMenu library was derived from the GEM (Good Enough Menu) Arduino library in 2021.
Navigating the TeenyGPSTestbed_C2 menu pages on the Core2 utilizes the Core2's three touch buttons adjacent to the display as follows:
- The top button single touch is SCROLL_UP.
- The bottom button single touch is SCROLL_DOWN.
- The middle button single touch is SELECT.
- If the menu item you selected is a MENU LINK item (with '>' on the right), it switches to the linked menu page.
- Middle button double touch returns you to the previous menu page.
- If the menu item you selected is a PARAMETER ITEM (name:value) the item switches to edit mode (with ' /-' on the right).
- Use scroll up and down to change the value.
- Middle button single touch will save the selected value and exit edit mode.
- Middle button double touch will exit edit mode without saving.
- If the menu item you selected is a BOOLEAN ITEM, select will toggle the item's value.
- If the menu item you selected is an ACTION ITEM (with '>>' on the left side), the action (function call) is executed.
- Some menus also have an optional EXIT ITEM ('<exit') which returns to the previous menu page just like middle button double touch does.
- If the menu item you selected is a MENU LINK item (with '>' on the right), it switches to the linked menu page.
TeenyGPSTestbed_C2 offers five modes of operation:
GPSRCV: Basic GPS Receiver - Displays PVT packet info including date/time, lat/lon/alt, heading, and positional accuracy data.
GPSLOG: UBLOX Packet Logger - For logging Ublox NAV-PVT, NAV-STATUS, and NAV-SAT raw packets for analysis and/or emulation. Logger can also output GPX or KML files for mapping or animation.
NAVSAT: UBX-NAV-SAT Receiver - For testing satellite reception. Displays data for tracked satellites sorted by signal strength.
Satellite Constellation Map (via UBX-NAV-SAT Receiver) - View of satellite position data including individual satellite status - usedForNav (sat color blue=true,red=false) and signal strength (sat ring white>=35db,yellow>=20db,orange<20db).
SATCFG: Satellite Configuration Tool - View GNSS system configuration and enable/disable selected GNSS.
EMUM8 & EMUM10: GPS Emulation - EMUM8 emulates Beitian BN-880Q (Ublox M8) GPS module and EMUM10 emulates BE-880Q (Ublox M10) GPS module including replay of Ublox NAV-PVT, NAV-STATUS, and NAV-SAT packets from ROM or SDCARD with progressive date/time updates.