Skip to content

Troubleshooting Tips

Need Help?

If you need technical assistance or more information on a product that is not working as you expected, we recommend heading over to the SparkFun Technical Assistance page for some initial troubleshooting.

SparkFun Technical Assistance Page

If you can't find what you need there, the SparkFun GNSS Forum is a great place to ask questions.

Account Registration Required

If this is your first visit to our forum, you'll need to create a Forum Account to post questions.

What is in the Box?

Kit contents

Everything that is included in the GNSSDO kit.

The GNSSDO comes packaged as a complete kit, with all the accessories you'd need to set it up. Inside the box, users will find the GNSS antenna, GNSSDO in its aluminum enclosure, CAT-6 Ethernet cable, USB-C cable, and another box containing additional accessories. Inside the accessory box, users will find the SMA to TNC cable, SMA to BNC cable, USB PD wall adapter, WiFi antenna, silicone bumpers, and 32GB SD card.

If you are missing any of these items, please reach out to us in our forum.

SparkFun logo SparkFun Forum - GNSS Topic

OLED Dead Pixels

Got a few dead pixels on your OLED display? Please reach out to us in our forum.

SparkFun logo SparkFun Forum - GNSS Topic

Data Logging

For data logging issues, here are some simple troubleshooting tips:

  • Make sure that your SD card is formatted to a FAT32 file system.
    • The FAT32 file system also limits the maximum capacity of the card to less than 32GB (i.e. a 256GB SD card will not work).
  • Make sure that the mosaic-T module has a configured data stream output.
  • Use the mosaic-T web page to verify that the SD card is mounted as a storage drive.

L5 Band

By default, the L5 band is enabled on the mosaic-T. To disable or re-enable reception of the L5 band on the mosaic-T, we have provided instructions on the Enable the L5 Band page.

Reprogramming the ESP32

In case users accidentally reprogram or corrupt the flash memory on the ESP32, the /Firmware/Binaries folder contains the firmware binaries.

You can update or reload the firmware using the SparkFun RTK Firmware Uploader.

The full firmware source code is available in our GitHub repository

Enclosure Disassembly

Due to the ESD sensitivity of the mosaic-T module, we don't recommend disassembling the GNSSDO. However, if users must access the PCB to troubleshoot an issue, make a modification, or repair a component, we highly recommend that they take the necessary ESD precautions to avoid damaging the mosaic-T module.

Read Before Disassembly!

ESD Sensitivity

The mosaic-T module is sensitive to ESD. Use a proper grounding system to make sure that the working surface and the components are at the same electric potential.

ESD Precaution

As recommended by the manufacturer, we highly encourage users to take the necessary precautions to avoid damaging their module.

  • The GNSSDO features ESD protection on the USB-C connectors, ethernet jack, I/O terminals and SMA antenna connections.

Before disassembling the enclosure, users should disconnect the power and all cables from the GNSSDO. This will prevent users from creating any shorts and will facilitate the teardown process further on.

The GNSSDO PCB is held in place by the front and rear panels of the enclosure. While users can remove the panels first, we recommend that users disconnect the screw terminal blocks first. Users may find it more difficult to separate the terminal block from the connector later in the disassembly process.

Remove the Screw Terminal Block First

Users may find it easiest to remove the screw terminal blocks first; as opposed to later in the teardown process.

Prying the Terminal Block
Using a soft/rigid object to carefully pry the terminal block off.

Users can wiggle or use a soft/rigid object to carefully pry the terminal block off. In the picture above, a plastic name tag (~1.5mm thick) is used to carefully pry the terminal block up. We have also found the edge of a PCB ruler works great too.

Once the terminal blocks have been removed, users can remove the front and rear panels of the enclosure. They are held in place with four, M3, Phillips head screws on the corners of each panel.

Remove Front Panel First

We recommend removing the front panel first to prevent the Qwiic cable from being yanked off the OLED display or main PCB. Once the front panel is free, carefully lift the panel and disconnect the Qwiic cable from the top connector on the OLED display.

At this point, if users have previously disconnected all the cables and the terminal blocks from the back, the GNSSDO PCB should slide out of the enclosure. Users can then, remove the rear panel from the enclosure to complete the teardown process.

QR code to the hookup guide