Arduino
+This example assumes you are using the latest version of the Arduino IDE on your desktop. If this is your first time using the Arduino IDE, library, or board add-on, please review the following tutorials.
+ +Note
+If you've never connected an CH340 device to your computer before, you may need to install drivers for the USB-to-serial converter. Check out our section on "How to Install CH340 Drivers" for help with the installation.
+ +At the time of writing this tutorial, the RTK Everywhere Firmware currently does not support the u-blox LARA-R6 module. For users that are interested in taking advantage of cellular when Ethernet or WiFi is not available, you can check out the individual Arduino Example Sketches located in the SparkFun RTK EVK Example Sketches folder. Besides the 6x examples for the LARA-R6, you will also notice several other examples such as using the ZED-F9P, NEO-D9S, Qwiic OLED, LEDs, antenna open/short circuit detection, Ethernet, WiFi, and datalogging using the microSD card. Head to the SparkFun RTK EVK GitHub Repo to grab the files or download the .ZIP by clicking the button below.
+ + +For the scope of this tutorial, we will upload one of the examples to get started. After downloading the files, unzip the files and head to the following folder: SparkFun_RTK_EVK-main > Example Sketches. Let's test the connection between the ESP32-WROVER and LARA-R6 by clicking on the 8_1_LARA_UART_Test > 8_1_LARA_UART_Test.ino.
+Note
+Some examples may include additional header files. You'll need to click on the example that has the same title as the folder's title. Certain examples may also require an additional Arduino Library. Make sure to check the example to see if there is a #include with the Arduino Library name near the top before compiling. You may also need to update the examples to provide any secret keys, accounts, or passwords.
Then select the associated board definition (in this case the ESP32 Wrover Module) and COM port. With a USB C cable connected to the CONFIG ESP32 port, click on the upload button. Opening the Arduino Serial Terminal at 115200 baud, the output will provide the model and SIM card information.
+Note
+At the time of writing, we used the following:
+
+
Spot something wrong? Feel free to contribute our open-source design and documentation. 
All of this documentation can be modified by you! Please help us make it better.
+docs folder of the SparkFun RTK EVK repository.All of our designs are open-source! Please help us make it better.
+Hardware folder of the SparkFunRTK EVK Repository.Let's provided some recognition to the contributors for this project!
+
+
+
Spot something wrong? Please let us know. 
Attention
+This is not where customers should seek assistance on a product. If you require technical assistance or have questions about a product that is not working as expected, please head over to the SparkFun Technical Assistance page for some initial troubleshooting. +
If you can't find what you need there, you'll need a Forum Account to search product forums and post questions.
+All of this documentation can be modified by you! Please help us make it better.
+docs folder of the SparkFun RTK EVK repository.If a section of the documentation is incorrect, please open an issue and let us know.
+All of our designs are open-source! Please help us make it better.
+Hardware folder of the SparkFun RTK EVK repository.If part of the design is confusing, please open an issue and let us know.
+Need to download or print our hookup guide?
+*.pdf file, select the Printer or Destination labeled Save as PDF. (Instructions will vary based on the browser)In this section, we'll go over how to connect to the SparkFun RTK EVK.
+To take advantage of the LTE cellular network with the LARA-R6, you will need to connect to the two LTE antennas on the back panel. Insert the LTE Hinged External Antenna into the SMA connector labeled as Cell 1 and rotate the threaded connector until it is finger tight. Repeat for the other SMA connector labeled as Cell 2. You will need to adjust the antenna as necessary depending on where you mount the RTK EVK.
+ |
+  |
+
| LTE Cellular Antenna | +LTE Cellular Antenna Ports Highlighted | +
Of course, you will need to connect an active multi-band GNSS antenna to the RTK EVK. We recommend using the L1/L2/L5 Surveying Antenna (SPK6618H) that is included with the kit. This covers the L1 and L2 band for the ZED-F9P. This also includes a built-in ground plane to provide the best performance for GNSS. This antenna will also provide broad coverage of the L-Band for the correction signals. Insert the SMA connector from the interface cable to the SMA connector labeled as GNSS. Tighten the hex nut until it is finger tight. Connect the TNC connector side from the interface cable to the to the SPK6618H antenna. Tighten the threaded connector until it is finger tight.
+ |
+  |
+  |
+
| GNSS Antenna Port Highlighted | +Cable | +Survey Antenna | +
You will need to mount the antenna in an area where it gest the best view of the sky (we recommend the roof). There is mounting hardware where you can permanently mount the antenna to a structure or support. There is also a magnetic mount to attach to a metal structure as well. For the scope of this tutorial, we will not go over the details of installing the antenna.
+ |
+
| Cable Connected and Survey Antenna Mounted on Magnetic Stand | +
For WiFi and Bluetooth using the ESP32, you will need to connect the 2.4GHz Duck Antenna to the RPSMA connector labeled as ESP32. Insert the antenna into the RPSMA connector and tighten the threaded connector until it is finger tight.
+ |
+  |
+
| WiFi/Bluetooth Connector Highlighted | +WiFi/Bluetooth Antenna | +
Note
+For users that need an extension cable to mount the antenna to a location that is farther away from the RTK EVK, you could use the Interface Cable - RP-SMA Male to RP-SMA Female (10M, RG58).
+For users that are connecting Ethernet or using power from the PoE, you will need to connect the Ethernet cable between the RTK EVK and your PoE network switch. Insert the Ethernet cable to the RJ45 MagJack connector until you hear a click. Then insert the other end into the network switch.
+ |
+  |
+
| Ethernet Port Highlighted | +Ethernet Cable | +
You can connect to the ESP32 by inserting the USB-C connector into the port labeled as CONFIG ESP32 and inserting the other end of the cable to your computer's USB port. This will power the RTK EVK, allow you to upload custom code, manually update the firmware binaries, or connect to a serial terminal.
+ |
+  |
+
| USB CONFIG ESP32 Port Highlighted | +USB C Cable | +
You can connect to the ZED-F9P, NEO-D9S, or LARA-R6 by inserting the USB-C connector into the port labeled as CONFIG UBLOX and inserting the other end to your computer's USB port. This will power the RTK EVK and allow you to connect the modules to u-center or m-center (for the LARA-R6).
+ | |
+
| USB CONFIG ESP32 Port Highlighted | +USB C Cable | +
To insert a microSD card, slide the microSD card into the microSD socket until it clicks in place. Pushing the microSD card again will eject the memory card.
+ |
+  |
+
| MicroSD Card Port Highlighted | +MicroSD Card | +
Note
+If you're using a SIM card from Hologram, you'll need to follow a few quick steps to activate your SIM card. +
For more help activating your Hologram SIM card, check out their Connect Your Device documentation.
+To take advantage of the LARA-R6, insert the nano SIM card into the nano SIM socket until it clicks. In this case, we used a Hologram card. Insert the SIM with the contacts facing down, insert the edge with the chamfered corner first.
+ |
+  |
+
| Nano SIM Card Socket Highlighted | +Nano SIM Card | +
Note
+You will need to remove the nano SIM card from the 3-in-1 SIM card holder when you initially receive the Hologram card. Just "punch" out the pre-cut nano SIM card size out by pushing it out with your fingers. Make sure to avoid touching the gold contacts with your bare hands.
+To connect to a pin on the screw terminal block, insert a stripped wire of any length into the I/O screw terminal. Of course, you could use jumper wires with pins as well. Secure the wire by tightening the screw using a precision 2.5mm flathead screw driver. Test the connection by gently pulling the wires to ensure that they are secure.
+ |
+
| Wire Inserted into I/O and Screw Being Tightened | +
If necessary, users can remove the terminal block off by wiggling the connector or using a spudger. When ready, users can slide the I/O terminal block back into the socket.
+ |
+
| I/O Screw Terminal Block Removed | +
Tip
+Don't have spudger? A good substitute includes a flathead screw driver, plastic card, or the PCB ruler. Using a tool will make it easier to remove the I/O terminal block.
+Users can connect a radio transceiver to the ZED-F9P UART2 port for correction data. We recommend using a breadboard to JST-GHR-06V cable to connect the SiK Telemetry Radio. Note that the cable is included with the LoRaSerial Kit.
+For users with the using a telemetry radio, you will need to connect the UART pins and ground to the screw terminal block. Note that this connection is only for the serial UART connection. To power, we recommend using an external 5V voltage source since 5V is not broken out. While there is a 3V3 pin available, the voltage will not be enough to fully power the radio module. One method is connecting a micro-B USB cable and 5V USB wall adapter to the Telemetry Radio.
+| RTK EVK UART Pinout + |
+ Telemetry UART Pinout + |
+
|---|---|
| ZED TX2 + | +RX + | +
| ZED RX2 + | TX + | +
| GND + | +GND + | +
For users with the LoRaSerial, you will also be connecting the UART pins and ground to the screw terminal block. To power, we also recommend using an external 5V voltage source for power such as a USB C cable and 5V USB wall adapter.
+| RTK EVK UART Pinout + |
+ LoRaSerial UART Pinout + |
+
|---|---|
| ZED TX2 + | +RXI + | +
| ZED RX2 + | TXO + | +
| GND + | +GND + | +
There are various PTHs throughout the PCB. Most are used with the testbeds for quality control but they are available for you to connect! For temporary connections to the PTHs, you could use IC hooks to test out the pins. However, you'll need to solder headers or wires of your choice to the board for a secure connection. You can choose between header pins and jumper wires, or stripping wire and soldering the wire directly to the board.
+The electronics of the SparkFun RTK EVK is enclosed in a custom extruded aluminum case with machined end panels and slotted flanges.
+ |
+  |
+
| Front View | +Back View | +
The image below shows a top and bottom view of the populated PCB without the enclosure.
+ |
+  |
+
| PCB Top View | +PCB Bottom View | +
The SparkFun RTK EVK can be powered from the connectors on the front or the back of the board. There is no internal battery. Schottky protection diodes and a resettable fuse are included to prevent conflicting voltages and overvoltage protection. Voltage is then regulated down to 3.3V through the three voltage regulators.
+ |
+  |
+
| USB Connectors Highlighted in Front | +USB Connectors Highlighted PCB Top View | +
Power can also be provided from the I/O screw terminals or PoE.
+ |
+  |
+
| USB Connector, Ethernet POE, and Power Input on Screw Terminals Highlighted in Back | +Ethernet POE, and Power Input on Screw Terminals Highlighted on PCB | +
There is also an output power pin for 3.3V on the I/O screw terminal.
+ |
+  |
+
| 3.3V Input on Screw Terminals Highlighted in Back | +3.3V Input on Screw Terminals Highlighted on PCB | +
A CH340 USB-to-Serial converter is included between the USB-C connector and the ESP32. The chip can be used to send serial data between the RTK EVK and computer. You can view the output or configure the device through a serial terminal. You can also manually upload new firmware as well.
+ |
+
| CH340 USB-to-Serial Converter Highlighted | +
The driver should automatically install on most operating systems. However, there is a wide range of operating systems out there. You may need to install drivers the first time you connect the chip to your computer's USB port or when there are operating system updates. For more information, check out our How to Install CH340 Drivers Tutorial.
+
+
+  + + How to Install CH340 Drivers ++ + |
+
The RTK Everywhere firmware is pre-loaded with the RTK EVK and flashed to the ESPRESSIF ESP32-WROVER module (with 16MB flash and 8MB PSRAM). The ESP32 handles all the processes. You can configure the EVK as a RTK base and push corrections to an NTRIP Caster. You can also configure the EVK as a RTK Rover and use corrections delivered over WiFi or Bluetooth. You can even update firmware over-the-air. For more information, we recommend checking out the RTK Everywhere Product Manual.
+ |
+
| ESP32 Highlighted | +
Note
+The ESP32-WROVER module can only connect to a 2.4GHz WiFi network. Unfortunately, 5GHz is not supported on the ESP32-WROVER module.
+For users that want to configure the ESP32 using a serial terminal, you will simply need to connect the CONFIG ESP32 to your computer's USB port. Once connected, open a serial terminal set to 115200 baud and press any key to open the serial configuration menu. Of course, this is only one method of adjusting the settings. You can also change the settings through WiFi, Bluetooth, and a text file saved on a microSD card.
+The screw terminal on the back includes an I2C port. This is connected to the ESP32's primary I2C port and is shared by the ZED-F9P and NEO-D9S.
+Note
+3.3V and GND are also conveniently placed next to the SCL and SDA pins. These follow the same pinout as most of the SparkFun I2C breakout boards with PTHs.
+ |
+  |
+
| I2C Port Highlighted | +I2C Port Highlighted on PCB | +
The I2C peripherals connected to the primary I2C port and their address are listed below:
+Inside of the enclosure, there is a Qwiic vertical port available. This is connected to the Qwiic OLED via a Qwiic cable. This port is connected to the ESP32's secondary I2C port with SCL connected to pin 15 and SDA connected to pin 12. The logic level is also 3.3V. Currently, there are no pull-up resistors attached to this line. To attach the 2.2kΩ pull-up resistors to the port, you will just need to add a solder blob to the I2C jumper.
+ |
+
| I2C Port Highlighted | +
The I2C peripheral connected to the secondary I2C port and their address is listed below:
+The RTK EVK includes the SparkFun Qwiic OLED - (1.3in., 128x64). This is connected to the ESP32 via a Qwiic port contained within the enclosure. As stated earlier, the default address for the display is 0x3D. The display provides useful information about the RTK EVK without needing to connect to a serial terminal.
+ |
+
| OLED Display Highlighted | +
Below show some of the possible outputs from the RTK EVK. The icons are explained further in the RTK Everywhere Product Manual > Hardware > Displays.
+The image below shows the Bluetooth MAC address of the RTK EVK on the upper left hand corner of the screen. If there is a Bluetooth connection, the Blueooth symbol will display. To the right is the WiFi symbol. To the right of the WiFi symbol is the icon indicating the selected dynamic model, in this case it's the default portable icon. On the upper far right, is the Ethernet connection symbol. Below the Bluetooth MAC address is the RTK float solution symbol. The number to the right indicates the horizontal position accuracy. In this case, there is an RTK float since the value is between 0.400 meters to 0.200 meters. To the right is the satellites in view symbol and number of satellites. The additional antenna lines indicates that the RTK EVK that there is successful reception and decryptions of L-band corrections. Finally, the rotating semi-circle indicates the RTK EVK firmware is running. This changes to a logging icon when data is being logged to microSD card.
+ |
+
| OLED Display Output | +
The image below is similar to the previous display output. You'll notice a few differences. The arrow pointing down indicates that there are corrections being received. The Ethernet symbol is also not displaying since there was no Ethernet connection at that moment. The horizontal positional accuracy indicates that there is a RTK fixed solution with the double cross hairs since the value is below 0.200 meters. Finally, the display is showing 29 satellites in view and no L-band corrections.
+ |
+
| OLED Display with RTK Fixed Solution | +
The RTK EVK wouldn't be a an RTK without well... a high precision RTK. The RTK EVK includes a built-in u-blox ZED-F9P module for high precision GNSS. You will need to connect an active multiband antenna that is capable of receiving L1 and L2 signals. The ZED-F9P can be set as a base station or rover. There are several options to send or receive correction data depending on the mode: Ethernet, WiFi network, LTE cellular network, or the NEO-D9S. Note that the RTK Everywhere firmware does not currently support cellular, but there are separate code examples showing how to receive localized corrections from PointPerfect via cellular. As stated earlier, the ZED-F9P is connected to the primary I2C port and uses the default address of 0x42.
+ |
+
| ZED-F9P Highlighted | +
Below are a few specifications taken from the ZED-F9P's datasheet:
+The screw terminal on the back includes a UART port. This is connected to the ZED-F9P's secondary UART port (UART2) for users that want to connect to other high precision GNSS modules for correction data.
+ |
+  |
+
| ZED-F9P UART Correction Port Highlighted | +ZED-F9P UART Correction Port Highlighted on PCB | +
The screw terminal on the back includes an external interrupt for the ZED-F9P. The interrupt can either be an input/output pin. This can be configured using u-center to bring the module out of deep sleep or to output an interrupt for various module states. In the RTK Everywhere firmware, this terminal can be used to trigger and log a UBX-TIM-TM2 timing message. The logic level is 3.3V.
+ |
+  |
+
| ZED-F9P External Interrupt Highlighted | +ZED-F9P External Interrupt Highlighted on PCB | +
The screw terminal on the back labeled as TP includes ZED-F9Ps time pulse output (i.e. the pulse-per-second or PPS output). This pulses at 1Hz when the module gets basic GPS/GNSS position lock and can be configured using the u-center. The logic level is 3.3V.
+ |
+  |
+
| ZED-F9P Time Pulse Highlighted | +ZED-F9P Time Pulse Highlighted on PCB | +
The RTK EVK includes the built-in u-blox NEO-D9S for correction data. You will need to connect an antenna that is capable of receiving signals from the L-band to access u-blox PointPerfect correction service. The NEO-D9S is connected to the primary I2C port and uses the default address of 0x43. You will need a service provider to access the correction data.
+ |
+
| NEO-D9S Highlighted | +
Below are a few specifications taken from the NEO-D9S's datasheet:
+The front of the RTK EVK includes a microSD card socket. Insert a microSD card into the socket until it clicks in place. Pushing the microSD card again will eject the memory card. This is connected to the ESP32's SPI port. Power is provided by the secondary power source. Users can manually flash the firmware binaries using the microSD card as opposed to over-the-air updates. Typically, the microSD card is for datalogging. The microSD card can also hold the user preferences for anyone that is interested in deploying multiple RTK EVKs with the same settings out in the field.
+ |
+  |
+
| MicroSD Card Slot Highlighted | +MicroSD Card Slot Highlighted on PCB | +
The RTK EVK also includes the u-blox LARA-R6 cellular module for users that need to connect to a LTE cellular network. The module is connected to the ESP32 via UART.
+ |
+
| LARA-R6 Highlighted | +
Below are a few specifications taken from the LARA-R6's datasheet:
+Note
+Although the LARA supports GSM/GPRS, the RTK EVK does not due to the high current required.
+Note
+Currently, the RTK Everywhere firmware does not support cellular with the LARA-R6. However, we have written and tested extra code examples which will allow you to stream MQTT correction data from a u-blox PointPerfect Localized Distribution topic via the LARA-R6 cellular chip. This example demonstrates how easy it is to subscribe to PointPerfect and only receive the IP correction data you need for your location, minimizing your cellular data costs.
+To connect to an cellular network with the built-in u-blox LARA-R6 (specifically the LARA-R6001D), you will need a nano SIM card. The cellular module works with most major North American carriers (Verizon, T-Mobile, AT&T, etc.). Make sure to check with your network service provider for compatibility. You also may need approval with the service carrier before the service is activated. We recommend using the Hologram SIM Card. Insert the SIM with the contacts facing down, insert the edge with the chamfered corner first.
+ |
+  |
+
| Nano SIM Card Socket Highlighted | +Nano SIM Card Socket Highlighted on PCB | +
The RTK EVK includes a built-in Ethernet circuitry. You can connect an Ethernet cable to the back of the RTK EVK's RJ45 MagJack port. This connector includes status LEDs for Link and Activity. These LEDs can be disabled by cutting the jumpers on the back of the PCB. The port connects to the Power-over-Ethernet (PoE) module and WIZnet W5500 Ethernet transceiver. 10/100Mbps is supported with auto-negotiation. As stated earlier, the PoE module can be powered using the standard PoE voltages between +36V to +57V. Make sure to choose a PoE Ethernet Switch that meeds your needs. We have had good experience with the TP Link TL-SG1005P - available from many retailers including Amazon.
+ |
+  |
+
| Ethernet Jack Highlighted | WIZnet W5500 IC, Ethernet Jack, and PoE Module Highlighted | +
The back of the SparkFun RTK EVK includes a few connectors for cellular, GNSS, and WiFi antennas.
+GNSS — The SMA connector labeled as GNSS is for the u-blox ZED-F9P and NEO-D9S. This is connected to a GNSS splitter (Power Divider) and allows you to connect a single GNSS antenna for both modules. This is intended to connect an active multiband GNSS antenna using the SMA male to TNC male interface cable that is included in the kit. The RTK EVK provides 5V on this connector for an active multiband antenna instead of the usual 3.3V. Short-circuit and open-circuit detection is built into this connection as well. The following icons will flash whenever the RTK EVK does not detect an antenna (i.e. an open circuit) or if there is a short in the cable. Next to the icons will also indicate that there will be 0 satellites in view.
+ |
+  |
+
| Antenna Open Circuit Highlighted | +Antenna Short Circuit Highlighted | +
ESP32 — The RP-SMA connector labeled as ESP32 is for the ESP32-WROVER. This is intended to connect the 2.4GHz WiFi/BT antenna.
+ |
+  |
+
| Antenna Connectors Highlighted on Back | +Antenna Connectors Highlighted on PCB | +
There are two buttons located on the front of the SparkFun RTK EVK.
+ |
+  |
+
| Reset and Mode/Boot Buttons Highlighted | +Reset and Mode/Boot Buttons Highlighted on PCB | +
RTK Modes — The available modes for the RTK Everywhere firmware are listed below. A single press brings up the mode menu. Press the button again to step through the available modes listed below. Pause on the highlighted mode then double-click to select it and change to that mode. For more information on the modes, make sure to check out the RTK Everywhere Manual.
+ |
+
| OLED Display Cycling Through Modes | +
Bootloader Mode — The boot button usually allows users to force the ESP32 into bootloader mode to manually upload new code to the ESP32.
+There are three LEDs available:
+ |
+ |
+
| LED Highlighted | +LEDs on Ethernet Connector Highlighted | +
Note
+If this is your first time working with jumpers, check out the How to Work with Jumper Pads and PCB Traces tutorial for more information.
+The RTK EVK includes various jumpers on the back of the PCB.
+
+ 
+ 
+ 
+ 
+ I2C will connect to two pull-up resistors to the I2C data and clock lines when closed. For advanced users that do not have pull-up resistors attached to the I2C lines on their microcontroller, make sure to close the jumpers with a little solder blob. |
+
| Jumpers | +
The SparkFun RTK EVK is designed around the Metal Enclosure - Custom Aluminum Extrusion (6in. x 4in. PCB). You can find the dimensions of the enclosure below.
+ |
+
| Enclosure and Panel Dimensions | +
Within the enclosure is the RTK EVK PCB. You can find the board dimensions below.
+ |
+
| Board Dimensions | +
For users interested in the dimensions of the surveying antenna, it is also listed below from the SPK6618H datasheet.
+ |
+
| SPK6618H Surveying Antenna Dimensions | +
The SparkFun RTK EVK (Evaluation Kit) is the perfect development platform for your fixed or mobile high-precision positioning and navigation needs. In terms of connectivity, the SparkFun RTK EVK has the lot: WiFi / BT, Ethernet and LTE cellular! We called it the EVK (Evaluation Kit) as it truly covers all the options: L1 + L2 RTK GNSS, with L-Band correction built-in if needed, running on an agile processor with memory to spare!
+Note
+Currently, the RTK Everywhere firmware does not support cellular with the LARA-R6. However, we have written and tested extra code examples which will allow you to stream MQTT correction data from a u-blox PointPerfect Localized Distribution topic via the LARA-R6 cellular chip. This example demonstrates how easy it is to subscribe to PointPerfect and only receive the IP correction data you need for your location, minimizing your cellular data costs.
+In this tutorial we'll go over the hardware, assembly, and how get started with the SparkFun RTK.
+The SparkFun RTK EVK comes with everything you need to get up and running. Our kit includes:
+ |
+
| What's in the Box? + | +
Depending on where you are installing the SparkFun RTK EVK, you also might need some mounting accessories to mount the GNSS antenna. You will want to mount the antenna in a location with the best view to of the sky (i.e. a roof).
+The RTK EVK comes with a custom extruded aluminum enclosure. The slotted flanges make it easy to install and secure the enclosure in many locations. If you are going to permanently install it up on a roof, you're going to need a suitable weatherproof box too. We found that the Orbit 57095 - also available from Amazon - was a good one back when we put together our first DIY GNSS Reference Station.
+AC Not Required!
+The Orbit enclosure comes with a built-in power outlet, but you don't actually need it! The RTK EVK can be powered by Power-over-Ethernet (PoE), meaning all you really need to run up to the roof is a standard 8-core CAT-6 Ethernet cable. Choose a PoE Ethernet Switch that meets your needs. We have had good experiences with the TP-Link TL-SG1005P - available from many retailers including Amazon.
+The following interface cables are great if say you are mounting the SparkFun RTK EVK in your home on a desk or lab bench and installing the antenna outdoors.
+Finally, if you're going to be logging a lot of data, you might want to stock up on 32GB microSD cards too. The RTK EVK can log 'raw' GNSS data messages (RAWX and SFRBX) at 20Hz if desired. At that rate, you're logging about 50kB per second, 180MB per hour, or over 4GB per day!
+Below are a few tools and accessories that you may need when connecting to the I/O terminal block on the back of the RTK EVK.
+If you aren’t familiar with the following concepts, we also recommend checking out a few of these tutorials before continuing.
+You may also be interested in the following blog posts on GNSS technologies.
+ + + + + + + + + + + + + + + + + + + + + + + + +The SparkFun RTK EVK runs on universal firmware created by SparkFun called RTK Everywhere. You can find its source through the RTK Everywhere GitHub repo.
+ |
+
| Screenshot Firmware through Serial Terminal | +
Make sure to check out the Quick Start Guide for the RTK EVK for a summary of how to get it connected over Bluetooth. You will also find more information about navigating through the configuration menu, updating firmware, and more in the product manual!
+ + + + + + + + + + + + + + + + + + + + + + + + +Now that you've successfully got your SparkFun RTK EVK up and running, it's time to incorporate it into your own project! For more information, check out the resources below:
+For user that are taking advantage of the Zero-Touch RTK for correction services, make sure to click on the link below! This link will allow you to register, reactivate, or cancel your RTK EVK's correction service.
+ + + + + + + + + + + + + + + + + + + + + + + + +Placeholder file for index redirect functionality.
"},{"location":"arduino_examples/","title":"Arduino Examples","text":"Arduino
This example assumes you are using the latest version of the Arduino IDE on your desktop. If this is your first time using the Arduino IDE, library, or board add-on, please review the following tutorials.
Note
If you've never connected an CH340 device to your computer before, you may need to install drivers for the USB-to-serial converter. Check out our section on \"How to Install CH340 Drivers\" for help with the installation.
At the time of writing this tutorial, the RTK Everywhere Firmware currently does not support the u-blox LARA-R6 module. For users that are interested in taking advantage of cellular when Ethernet or WiFi is not available, you can check out the individual Arduino Example Sketches located in the SparkFun RTK EVK Example Sketches folder. Besides the 6x examples for the LARA-R6, you will also notice several other examples such as using the ZED-F9P, NEO-D9S, Qwiic OLED, LEDs, antenna open/short circuit detection, Ethernet, WiFi, and datalogging using the microSD card. Head to the SparkFun RTK EVK GitHub Repo to grab the files or download the .ZIP by clicking the button below.
GitHub SparkFun RTK EVK Repo: Arduino Example SketchesFor the scope of this tutorial, we will upload one of the examples to get started. After downloading the files, unzip the files and head to the following folder: SparkFun_RTK_EVK-main > Example Sketches. Let's test the connection between the ESP32-WROVER and LARA-R6 by clicking on the 8_1_LARA_UART_Test > 8_1_LARA_UART_Test.ino.
Note
Some examples may include additional header files. You'll need to click on the example that has the same title as the folder's title. Certain examples may also require an additional Arduino Library. Make sure to check the example to see if there is a #include with the Arduino Library name near the top before compiling. You may also need to update the examples to provide any secret keys, accounts, or passwords.
Then select the associated board definition (in this case the ESP32 Wrover Module) and COM port. With a USB C cable connected to the CONFIG ESP32 port, click on the upload button. Opening the Arduino Serial Terminal at 115200 baud, the output will provide the model and SIM card information.
Note
At the time of writing, we used the following:
Need to download or print our hookup guide?
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+ *.pdf file, select the Printer or Destination labeled Save as PDF. (Instructions will vary based on the browser)In this section, we'll go over how to connect to the SparkFun RTK EVK.
"},{"location":"hardware_hookup/#cellular-antenna","title":"Cellular Antenna","text":"To take advantage of the LTE cellular network with the LARA-R6, you will need to connect to the two LTE antennas on the back panel. Insert the LTE Hinged External Antenna into the SMA connector labeled as Cell 1 and rotate the threaded connector until it is finger tight. Repeat for the other SMA connector labeled as Cell 2. You will need to adjust the antenna as necessary depending on where you mount the RTK EVK.
LTE Cellular Antenna LTE Cellular Antenna Ports Highlighted"},{"location":"hardware_hookup/#multi-band-gnss-antenna","title":"Multi-Band GNSS Antenna","text":"Of course, you will need to connect an active multi-band GNSS antenna to the RTK EVK. We recommend using the L1/L2/L5 Surveying Antenna (SPK6618H) that is included with the kit. This covers the L1 and L2 band for the ZED-F9P. This also includes a built-in ground plane to provide the best performance for GNSS. This antenna will also provide broad coverage of the L-Band for the correction signals. Insert the SMA connector from the interface cable to the SMA connector labeled as GNSS. Tighten the hex nut until it is finger tight. Connect the TNC connector side from the interface cable to the to the SPK6618H antenna. Tighten the threaded connector until it is finger tight.
GNSS Antenna Port Highlighted Cable Survey AntennaYou will need to mount the antenna in an area where it gest the best view of the sky (we recommend the roof). There is mounting hardware where you can permanently mount the antenna to a structure or support. There is also a magnetic mount to attach to a metal structure as well. For the scope of this tutorial, we will not go over the details of installing the antenna.
Cable Connected and Survey Antenna Mounted on Magnetic Stand"},{"location":"hardware_hookup/#wifibluetooth-antenna","title":"WiFi/Bluetooth Antenna","text":"For WiFi and Bluetooth using the ESP32, you will need to connect the 2.4GHz Duck Antenna to the RPSMA connector labeled as ESP32. Insert the antenna into the RPSMA connector and tighten the threaded connector until it is finger tight.
WiFi/Bluetooth Connector Highlighted WiFi/Bluetooth AntennaNote
For users that need an extension cable to mount the antenna to a location that is farther away from the RTK EVK, you could use the Interface Cable - RP-SMA Male to RP-SMA Female (10M, RG58).
"},{"location":"hardware_hookup/#ethernet","title":"Ethernet","text":"For users that are connecting Ethernet or using power from the PoE, you will need to connect the Ethernet cable between the RTK EVK and your PoE network switch. Insert the Ethernet cable to the RJ45 MagJack connector until you hear a click. Then insert the other end into the network switch.
Ethernet Port Highlighted Ethernet Cable"},{"location":"hardware_hookup/#connecting-to-the-esp32","title":"Connecting to the ESP32","text":"You can connect to the ESP32 by inserting the USB-C connector into the port labeled as CONFIG ESP32 and inserting the other end of the cable to your computer's USB port. This will power the RTK EVK, allow you to upload custom code, manually update the firmware binaries, or connect to a serial terminal.
USB CONFIG ESP32 Port Highlighted USB C Cable"},{"location":"hardware_hookup/#connecting-to-the-u-blox-modules","title":"Connecting to the u-blox Modules","text":"You can connect to the ZED-F9P, NEO-D9S, or LARA-R6 by inserting the USB-C connector into the port labeled as CONFIG UBLOX and inserting the other end to your computer's USB port. This will power the RTK EVK and allow you to connect the modules to u-center or m-center (for the LARA-R6).
USB CONFIG ESP32 Port Highlighted USB C Cable"},{"location":"hardware_hookup/#inserting-a-microsd-card","title":"Inserting a MicroSD Card","text":"To insert a microSD card, slide the microSD card into the microSD socket until it clicks in place. Pushing the microSD card again will eject the memory card.
MicroSD Card Port Highlighted MicroSD Card"},{"location":"hardware_hookup/#inserting-a-nano-sim-card","title":"Inserting a Nano SIM Card","text":"Note
To take advantage of the LARA-R6, insert the nano SIM card into the nano SIM socket until it clicks. In this case, we used a Hologram card. Insert the SIM with the contacts facing down, insert the edge with the chamfered corner first.
Nano SIM Card Socket Highlighted Nano SIM CardNote
You will need to remove the nano SIM card from the 3-in-1 SIM card holder when you initially receive the Hologram card. Just \"punch\" out the pre-cut nano SIM card size out by pushing it out with your fingers. Make sure to avoid touching the gold contacts with your bare hands.
"},{"location":"hardware_hookup/#activate-your-hologram-sim","title":"Activate Your Hologram SIM","text":"If you're using a SIM card from Hologram, you'll need to follow a few quick steps to activate your SIM card.
For more help activating your Hologram SIM card, check out their Connect Your Device documentation.
"},{"location":"hardware_hookup/#inserting-a-wire-into-the-io-screw-terminal","title":"Inserting a Wire into the I/O Screw Terminal","text":"To connect to a pin on the screw terminal block, insert a stripped wire of any length into the I/O screw terminal. Of course, you could use jumper wires with pins as well. Secure the wire by tightening the screw using a precision 2.5mm flathead screw driver. Test the connection by gently pulling the wires to ensure that they are secure.
Wire Inserted into I/O and Screw Being TightenedIf necessary, users can remove the terminal block off by wiggling the connector or using a spudger. When ready, users can slide the I/O terminal block back into the socket.
I/O Screw Terminal Block RemovedTip
Don't have spudger? A good substitute includes a flathead screw driver, plastic card, or the PCB ruler. Using a tool will make it easier to remove the I/O terminal block.
"},{"location":"hardware_hookup/#connecting-a-radio-transceiver","title":"Connecting a Radio Transceiver","text":"Users can connect a radio transceiver to the ZED-F9P UART2 port for correction data. We recommend using a breadboard to JST-GHR-06V cable to connect the SiK Telemetry Radio. Note that the cable is included with the LoRaSerial Kit.
SiK Telemetry Radio V3 - 915MHz, 100mW WRL-19032
SparkFun LoRaSerial Kit - 915MHz (Enclosed) KIT-20029
Breadboard to JST-GHR-06V Cable - 6-Pin x 1.25mm Pitch (For LoRaSerial) CAB-23353
For users with the using a telemetry radio, you will need to connect the UART pins and ground to the screw terminal block. Note that this connection is only for the serial UART connection. To power, we recommend using an external 5V voltage source since 5V is not broken out. While there is a 3V3 pin available, the voltage will not be enough to fully power the radio module. One method is connecting a micro-B USB cable and 5V USB wall adapter to the Telemetry Radio.
RTK EVKUART Pinout TelemetryUART Pinout ZED TX2 RX ZED RX2 TX GND GNDFor users with the LoRaSerial, you will also be connecting the UART pins and ground to the screw terminal block. To power, we also recommend using an external 5V voltage source for power such as a USB C cable and 5V USB wall adapter.
RTK EVKUART Pinout LoRaSerialUART Pinout ZED TX2 RXI ZED RX2 TXO GND GND"},{"location":"hardware_hookup/#connecting-via-pth","title":"Connecting via PTH","text":"There are various PTHs throughout the PCB. Most are used with the testbeds for quality control but they are available for you to connect! For temporary connections to the PTHs, you could use IC hooks to test out the pins. However, you'll need to solder headers or wires of your choice to the board for a secure connection. You can choose between header pins and jumper wires, or stripping wire and soldering the wire directly to the board.
How to Solder: Through Hole Soldering
Working with Wire
The electronics of the SparkFun RTK EVK is enclosed in a custom extruded aluminum case with machined end panels and slotted flanges.
Front View Back ViewThe image below shows a top and bottom view of the populated PCB without the enclosure.
PCB Top View PCB Bottom View"},{"location":"hardware_overview/#power","title":"Power","text":"The SparkFun RTK EVK can be powered from the connectors on the front or the back of the board. There is no internal battery. Schottky protection diodes and a resettable fuse are included to prevent conflicting voltages and overvoltage protection. Voltage is then regulated down to 3.3V through the three voltage regulators.
Power can also be provided from the I/O screw terminals or PoE.
There is also an output power pin for 3.3V on the I/O screw terminal.
A CH340 USB-to-Serial converter is included between the USB-C connector and the ESP32. The chip can be used to send serial data between the RTK EVK and computer. You can view the output or configure the device through a serial terminal. You can also manually upload new firmware as well.
CH340 USB-to-Serial Converter HighlightedThe driver should automatically install on most operating systems. However, there is a wide range of operating systems out there. You may need to install drivers the first time you connect the chip to your computer's USB port or when there are operating system updates. For more information, check out our How to Install CH340 Drivers Tutorial.
"},{"location":"hardware_overview/#esp32-wrover-module","title":"ESP32-WROVER Module","text":"The RTK Everywhere firmware is pre-loaded with the RTK EVK and flashed to the ESPRESSIF ESP32-WROVER module (with 16MB flash and 8MB PSRAM). The ESP32 handles all the processes. You can configure the EVK as a RTK base and push corrections to an NTRIP Caster. You can also configure the EVK as a RTK Rover and use corrections delivered over WiFi or Bluetooth. You can even update firmware over-the-air. For more information, we recommend checking out the RTK Everywhere Product Manual.
ESP32 HighlightedNote
The ESP32-WROVER module can only connect to a 2.4GHz WiFi network. Unfortunately, 5GHz is not supported on the ESP32-WROVER module.
For users that want to configure the ESP32 using a serial terminal, you will simply need to connect the CONFIG ESP32 to your computer's USB port. Once connected, open a serial terminal set to 115200 baud and press any key to open the serial configuration menu. Of course, this is only one method of adjusting the settings. You can also change the settings through WiFi, Bluetooth, and a text file saved on a microSD card.
"},{"location":"hardware_overview/#esp32-primary-i2c-port","title":"ESP32 Primary I2C Port","text":"The screw terminal on the back includes an I2C port. This is connected to the ESP32's primary I2C port and is shared by the ZED-F9P and NEO-D9S.
Note
3.3V and GND are also conveniently placed next to the SCL and SDA pins. These follow the same pinout as most of the SparkFun I2C breakout boards with PTHs.
I2C Port Highlighted I2C Port Highlighted on PCBThe I2C peripherals connected to the primary I2C port and their address are listed below:
Inside of the enclosure, there is a Qwiic vertical port available. This is connected to the Qwiic OLED via a Qwiic cable. This port is connected to the ESP32's secondary I2C port with SCL connected to pin 15 and SDA connected to pin 12. The logic level is also 3.3V. Currently, there are no pull-up resistors attached to this line. To attach the 2.2k\u03a9 pull-up resistors to the port, you will just need to add a solder blob to the I2C jumper.
I2C Port HighlightedThe I2C peripheral connected to the secondary I2C port and their address is listed below:
The RTK EVK includes the SparkFun Qwiic OLED - (1.3in., 128x64). This is connected to the ESP32 via a Qwiic port contained within the enclosure. As stated earlier, the default address for the display is 0x3D. The display provides useful information about the RTK EVK without needing to connect to a serial terminal.
OLED Display HighlightedBelow show some of the possible outputs from the RTK EVK. The icons are explained further in the RTK Everywhere Product Manual > Hardware > Displays.
The image below shows the Bluetooth MAC address of the RTK EVK on the upper left hand corner of the screen. If there is a Bluetooth connection, the Blueooth symbol will display. To the right is the WiFi symbol. To the right of the WiFi symbol is the icon indicating the selected dynamic model, in this case it's the default portable icon. On the upper far right, is the Ethernet connection symbol. Below the Bluetooth MAC address is the RTK float solution symbol. The number to the right indicates the horizontal position accuracy. In this case, there is an RTK float since the value is between 0.400 meters to 0.200 meters. To the right is the satellites in view symbol and number of satellites. The additional antenna lines indicates that the RTK EVK that there is successful reception and decryptions of L-band corrections. Finally, the rotating semi-circle indicates the RTK EVK firmware is running. This changes to a logging icon when data is being logged to microSD card.
OLED Display OutputThe image below is similar to the previous display output. You'll notice a few differences. The arrow pointing down indicates that there are corrections being received. The Ethernet symbol is also not displaying since there was no Ethernet connection at that moment. The horizontal positional accuracy indicates that there is a RTK fixed solution with the double cross hairs since the value is below 0.200 meters. Finally, the display is showing 29 satellites in view and no L-band corrections.
OLED Display with RTK Fixed Solution"},{"location":"hardware_overview/#zed-f9p-module","title":"ZED-F9P Module","text":"The RTK EVK wouldn't be a an RTK without well... a high precision RTK. The RTK EVK includes a built-in u-blox ZED-F9P module for high precision GNSS. You will need to connect an active multiband antenna that is capable of receiving L1 and L2 signals. The ZED-F9P can be set as a base station or rover. There are several options to send or receive correction data depending on the mode: Ethernet, WiFi network, LTE cellular network, or the NEO-D9S. Note that the RTK Everywhere firmware does not currently support cellular, but there are separate code examples showing how to receive localized corrections from PointPerfect via cellular. As stated earlier, the ZED-F9P is connected to the primary I2C port and uses the default address of 0x42.
ZED-F9P HighlightedBelow are a few specifications taken from the ZED-F9P's datasheet:
The screw terminal on the back includes a UART port. This is connected to the ZED-F9P's secondary UART port (UART2) for users that want to connect to other high precision GNSS modules for correction data.
The screw terminal on the back includes an external interrupt for the ZED-F9P. The interrupt can either be an input/output pin. This can be configured using u-center to bring the module out of deep sleep or to output an interrupt for various module states. In the RTK Everywhere firmware, this terminal can be used to trigger and log a UBX-TIM-TM2 timing message. The logic level is 3.3V.
ZED-F9P External Interrupt Highlighted ZED-F9P External Interrupt Highlighted on PCB"},{"location":"hardware_overview/#zed-f9p-time-pulse","title":"ZED-F9P Time Pulse","text":"The screw terminal on the back labeled as TP includes ZED-F9Ps time pulse output (i.e. the pulse-per-second or PPS output). This pulses at 1Hz when the module gets basic GPS/GNSS position lock and can be configured using the u-center. The logic level is 3.3V.
ZED-F9P Time Pulse Highlighted ZED-F9P Time Pulse Highlighted on PCB"},{"location":"hardware_overview/#neo-d9s","title":"NEO-D9S","text":"The RTK EVK includes the built-in u-blox NEO-D9S for correction data. You will need to connect an antenna that is capable of receiving signals from the L-band to access u-blox PointPerfect correction service. The NEO-D9S is connected to the primary I2C port and uses the default address of 0x43. You will need a service provider to access the correction data.
NEO-D9S HighlightedBelow are a few specifications taken from the NEO-D9S's datasheet:
The front of the RTK EVK includes a microSD card socket. Insert a microSD card into the socket until it clicks in place. Pushing the microSD card again will eject the memory card. This is connected to the ESP32's SPI port. Power is provided by the secondary power source. Users can manually flash the firmware binaries using the microSD card as opposed to over-the-air updates. Typically, the microSD card is for datalogging. The microSD card can also hold the user preferences for anyone that is interested in deploying multiple RTK EVKs with the same settings out in the field.
MicroSD Card Slot Highlighted MicroSD Card Slot Highlighted on PCB"},{"location":"hardware_overview/#lara-r6-cellular-module","title":"LARA-R6 Cellular Module","text":"The RTK EVK also includes the u-blox LARA-R6 cellular module for users that need to connect to a LTE cellular network. The module is connected to the ESP32 via UART.
LARA-R6 HighlightedBelow are a few specifications taken from the LARA-R6's datasheet:
Note
Although the LARA supports GSM/GPRS, the RTK EVK does not due to the high current required.
Note
Currently, the RTK Everywhere firmware does not support cellular with the LARA-R6. However, we have written and tested extra code examples which will allow you to stream MQTT correction data from a u-blox PointPerfect Localized Distribution topic via the LARA-R6 cellular chip. This example demonstrates how easy it is to subscribe to PointPerfect and only receive the IP correction data you need for your location, minimizing your cellular data costs.
"},{"location":"hardware_overview/#nano-sim-card-socket","title":"Nano SIM Card Socket","text":"To connect to an cellular network with the built-in u-blox LARA-R6 (specifically the LARA-R6001D), you will need a nano SIM card. The cellular module works with most major North American carriers (Verizon, T-Mobile, AT&T, etc.). Make sure to check with your network service provider for compatibility. You also may need approval with the service carrier before the service is activated. We recommend using the Hologram SIM Card. Insert the SIM with the contacts facing down, insert the edge with the chamfered corner first.
Nano SIM Card Socket Highlighted Nano SIM Card Socket Highlighted on PCB"},{"location":"hardware_overview/#wiznet-w5500-ic-ethernet-jack-and-poe","title":"WIZnet W5500 IC, Ethernet Jack, and PoE","text":"The RTK EVK includes a built-in Ethernet circuitry. You can connect an Ethernet cable to the back of the RTK EVK's RJ45 MagJack port. This connector includes status LEDs for Link and Activity. These LEDs can be disabled by cutting the jumpers on the back of the PCB. The port connects to the Power-over-Ethernet (PoE) module and WIZnet W5500 Ethernet transceiver. 10/100Mbps is supported with auto-negotiation. As stated earlier, the PoE module can be powered using the standard PoE voltages between +36V to +57V. Make sure to choose a PoE Ethernet Switch that meeds your needs. We have had good experience with the TP Link TL-SG1005P - available from many retailers including Amazon.
Ethernet Jack HighlightedWIZnet W5500 IC, Ethernet Jack, and PoE Module Highlighted"},{"location":"hardware_overview/#antenna-connections","title":"Antenna Connections","text":"The back of the SparkFun RTK EVK includes a few connectors for cellular, GNSS, and WiFi antennas.
GNSS \u2014 The SMA connector labeled as GNSS is for the u-blox ZED-F9P and NEO-D9S. This is connected to a GNSS splitter (Power Divider) and allows you to connect a single GNSS antenna for both modules. This is intended to connect an active multiband GNSS antenna using the SMA male to TNC male interface cable that is included in the kit. The RTK EVK provides 5V on this connector for an active multiband antenna instead of the usual 3.3V. Short-circuit and open-circuit detection is built into this connection as well. The following icons will flash whenever the RTK EVK does not detect an antenna (i.e. an open circuit) or if there is a short in the cable. Next to the icons will also indicate that there will be 0 satellites in view.
Antenna Open Circuit Highlighted Antenna Short Circuit Highlighted
ESP32 \u2014 The RP-SMA connector labeled as ESP32 is for the ESP32-WROVER. This is intended to connect the 2.4GHz WiFi/BT antenna.
There are two buttons located on the front of the SparkFun RTK EVK.
RTK Modes \u2014 The available modes for the RTK Everywhere firmware are listed below. A single press brings up the mode menu. Press the button again to step through the available modes listed below. Pause on the highlighted mode then double-click to select it and change to that mode. For more information on the modes, make sure to check out the RTK Everywhere Manual.
OLED Display Cycling Through Modes
Bootloader Mode \u2014 The boot button usually allows users to force the ESP32 into bootloader mode to manually upload new code to the ESP32.
There are three LEDs available:
Note
If this is your first time working with jumpers, check out the How to Work with Jumper Pads and PCB Traces tutorial for more information.
The RTK EVK includes various jumpers on the back of the PCB.
I2C will connect to two pull-up resistors to the I2C data and clock lines when closed. For advanced users that do not have pull-up resistors attached to the I2C lines on their microcontroller, make sure to close the jumpers with a little solder blob.The SparkFun RTK EVK is designed around the Metal Enclosure - Custom Aluminum Extrusion (6in. x 4in. PCB). You can find the dimensions of the enclosure below.
Enclosure and Panel DimensionsWithin the enclosure is the RTK EVK PCB. You can find the board dimensions below.
Board DimensionsFor users interested in the dimensions of the surveying antenna, it is also listed below from the SPK6618H datasheet.
SPK6618H Surveying Antenna Dimensions"},{"location":"introduction/","title":"Introduction","text":"The SparkFun RTK EVK (Evaluation Kit) is the perfect development platform for your fixed or mobile high-precision positioning and navigation needs. In terms of connectivity, the SparkFun RTK EVK has the lot: WiFi / BT, Ethernet and LTE cellular! We called it the EVK (Evaluation Kit) as it truly covers all the options: L1 + L2 RTK GNSS, with L-Band correction built-in if needed, running on an agile processor with memory to spare!
SparkFun RTK EVK GPS-24342 Purchase from SparkFun
Note
Currently, the RTK Everywhere firmware does not support cellular with the LARA-R6. However, we have written and tested extra code examples which will allow you to stream MQTT correction data from a u-blox PointPerfect Localized Distribution topic via the LARA-R6 cellular chip. This example demonstrates how easy it is to subscribe to PointPerfect and only receive the IP correction data you need for your location, minimizing your cellular data costs.
In this tutorial we'll go over the hardware, assembly, and how get started with the SparkFun RTK.
"},{"location":"introduction/#kit-contents","title":"Kit Contents","text":"The SparkFun RTK EVK comes with everything you need to get up and running. Our kit includes:
Depending on where you are installing the SparkFun RTK EVK, you also might need some mounting accessories to mount the GNSS antenna. You will want to mount the antenna in a location with the best view to of the sky (i.e. a roof).
GNSS Magnetic Antenna Mount - 5/8\" 11-TPI GPS-21257
GNSS Antenna Mounting Hardware Kit KIT-22197
The RTK EVK comes with a custom extruded aluminum enclosure. The slotted flanges make it easy to install and secure the enclosure in many locations. If you are going to permanently install it up on a roof, you're going to need a suitable weatherproof box too. We found that the Orbit 57095 - also available from Amazon - was a good one back when we put together our first DIY GNSS Reference Station.
How to Build a DIY GNSS Reference Station
AC Not Required!
The Orbit enclosure comes with a built-in power outlet, but you don't actually need it! The RTK EVK can be powered by Power-over-Ethernet (PoE), meaning all you really need to run up to the roof is a standard 8-core CAT-6 Ethernet cable. Choose a PoE Ethernet Switch that meets your needs. We have had good experiences with the TP-Link TL-SG1005P - available from many retailers including Amazon.
"},{"location":"introduction/#gnss-interface-cable","title":"GNSS Interface Cable","text":"The following interface cables are great if say you are mounting the SparkFun RTK EVK in your home on a desk or lab bench and installing the antenna outdoors.
Interface Cable - SMA Female to SMA Male (10m, RG58) CAB-21281
Interface Cable - RP-SMA Male to RP-SMA Female (10M, RG58) CAB-22038
Finally, if you're going to be logging a lot of data, you might want to stock up on 32GB microSD cards too. The RTK EVK can log 'raw' GNSS data messages (RAWX and SFRBX) at 20Hz if desired. At that rate, you're logging about 50kB per second, 180MB per hour, or over 4GB per day!
microSD Card - 32GB (Class 10) COM-19041
Below are a few tools and accessories that you may need when connecting to the I/O terminal block on the back of the RTK EVK.
iFixit Moray Driver Kit TOL-25568
Wire Strippers - 30AWG (Hakko) TOL-12630
Hook-Up Wire - Assortment (Solid Core, 22 AWG) PRT-11367
If you aren\u2019t familiar with the following concepts, we also recommend checking out a few of these tutorials before continuing.
What is GPS RTK?
Getting Started with U-Center for u-blox
GPS-RTK2 Hookup Guide
Setting up a Rover Base RTK System
How to Build a DIY GNSS Reference Station
You may also be interested in the following blog posts on GNSS technologies.
GPS vs GNSS
What is Correction Data?
Real-Time Kinematics Explained
New Video: Unlocking High-Precision RTK Positioning
"},{"location":"product_manual/","title":"RTK Everywhere Firmware","text":"The SparkFun RTK EVK runs on universal firmware created by SparkFun called RTK Everywhere. You can find its source through the RTK Everywhere GitHub repo.
Screenshot Firmware through Serial TerminalMake sure to check out the Quick Start Guide for the RTK EVK for a summary of how to get it connected over Bluetooth. You will also find more information about navigating through the configuration menu, updating firmware, and more in the product manual!
RTK Everywhere Product Manual: Quickstart Guide"},{"location":"resources/","title":"Resources","text":"Now that you've successfully got your SparkFun RTK EVK up and running, it's time to incorporate it into your own project! For more information, check out the resources below:
For user that are taking advantage of the Zero-Touch RTK for correction services, make sure to click on the link below! This link will allow you to register, reactivate, or cancel your RTK EVK's correction service.
The SparkFun RTK EVK (Evaluation Kit) is the perfect development platform for your fixed or mobile high-precision positioning and navigation needs. In terms of connectivity, the SparkFun RTK EVK has the lot: WiFi / BT, Ethernet and LTE cellular! We called it the EVK (Evaluation Kit) as it truly covers all the options: L1 + L2 RTK GNSS, with L-Band correction built-in if needed, running on an agile processor with memory to spare!
SparkFun RTK EVK GPS-24342 Purchase from SparkFun
Note
Currently, the RTK Everywhere firmware does not support cellular with the LARA-R6. However, we have written and tested extra code examples which will allow you to stream MQTT correction data from a u-blox PointPerfect Localized Distribution topic via the LARA-R6 cellular chip. This example demonstrates how easy it is to subscribe to PointPerfect and only receive the IP correction data you need for your location, minimizing your cellular data costs.
In this tutorial we'll go over the hardware, assembly, and how get started with the SparkFun RTK.
"},{"location":"single_page/#kit-contents","title":"Kit Contents","text":"The SparkFun RTK EVK comes with everything you need to get up and running. Our kit includes:
Depending on where you are installing the SparkFun RTK EVK, you also might need some mounting accessories to mount the GNSS antenna. You will want to mount the antenna in a location with the best view to of the sky (i.e. a roof).
GNSS Magnetic Antenna Mount - 5/8\" 11-TPI GPS-21257
GNSS Antenna Mounting Hardware Kit KIT-22197
The RTK EVK comes with a custom extruded aluminum enclosure. The slotted flanges make it easy to install and secure the enclosure in many locations. If you are going to permanently install it up on a roof, you're going to need a suitable weatherproof box too. We found that the Orbit 57095 - also available from Amazon - was a good one back when we put together our first DIY GNSS Reference Station.
How to Build a DIY GNSS Reference Station
AC Not Required!
The Orbit enclosure comes with a built-in power outlet, but you don't actually need it! The RTK EVK can be powered by Power-over-Ethernet (PoE), meaning all you really need to run up to the roof is a standard 8-core CAT-6 Ethernet cable. Choose a PoE Ethernet Switch that meets your needs. We have had good experiences with the TP-Link TL-SG1005P - available from many retailers including Amazon.
"},{"location":"single_page/#gnss-interface-cable","title":"GNSS Interface Cable","text":"The following interface cables are great if say you are mounting the SparkFun RTK EVK in your home on a desk or lab bench and installing the antenna outdoors.
Interface Cable - SMA Female to SMA Male (10m, RG58) CAB-21281
Interface Cable - RP-SMA Male to RP-SMA Female (10M, RG58) CAB-22038
Finally, if you're going to be logging a lot of data, you might want to stock up on 32GB microSD cards too. The RTK EVK can log 'raw' GNSS data messages (RAWX and SFRBX) at 20Hz if desired. At that rate, you're logging about 50kB per second, 180MB per hour, or over 4GB per day!
microSD Card - 32GB (Class 10) COM-19041
Below are a few tools and accessories that you may need when connecting to the I/O terminal block on the back of the RTK EVK.
iFixit Moray Driver Kit TOL-25568
Wire Strippers - 30AWG (Hakko) TOL-12630
Hook-Up Wire - Assortment (Solid Core, 22 AWG) PRT-11367
If you aren\u2019t familiar with the following concepts, we also recommend checking out a few of these tutorials before continuing.
What is GPS RTK?
Getting Started with U-Center for u-blox
GPS-RTK2 Hookup Guide
Setting up a Rover Base RTK System
How to Build a DIY GNSS Reference Station
You may also be interested in the following blog posts on GNSS technologies.
GPS vs GNSS
What is Correction Data?
Real-Time Kinematics Explained
New Video: Unlocking High-Precision RTK Positioning
"},{"location":"single_page/#hardware-overview","title":"Hardware Overview","text":"The electronics of the SparkFun RTK EVK is enclosed in a custom extruded aluminum case with machined end panels and slotted flanges.
Front View Back ViewThe image below shows a top and bottom view of the populated PCB without the enclosure.
PCB Top View PCB Bottom View"},{"location":"single_page/#power","title":"Power","text":"The SparkFun RTK EVK can be powered from the connectors on the front or the back of the board. There is no internal battery. Schottky protection diodes and a resettable fuse are included to prevent conflicting voltages and overvoltage protection. Voltage is then regulated down to 3.3V through the three voltage regulators.
Power can also be provided from the I/O screw terminals or PoE.
There is also an output power pin for 3.3V on the I/O screw terminal.
A CH340 USB-to-Serial converter is included between the USB-C connector and the ESP32. The chip can be used to send serial data between the RTK EVK and computer. You can view the output or configure the device through a serial terminal. You can also manually upload new firmware as well.
CH340 USB-to-Serial Converter HighlightedThe driver should automatically install on most operating systems. However, there is a wide range of operating systems out there. You may need to install drivers the first time you connect the chip to your computer's USB port or when there are operating system updates. For more information, check out our How to Install CH340 Drivers Tutorial.
"},{"location":"single_page/#esp32-wrover-module","title":"ESP32-WROVER Module","text":"The RTK Everywhere firmware is pre-loaded with the RTK EVK and flashed to the ESPRESSIF ESP32-WROVER module (with 16MB flash and 8MB PSRAM). The ESP32 handles all the processes. You can configure the EVK as a RTK base and push corrections to an NTRIP Caster. You can also configure the EVK as a RTK Rover and use corrections delivered over WiFi or Bluetooth. You can even update firmware over-the-air. For more information, we recommend checking out the RTK Everywhere Product Manual.
ESP32 HighlightedNote
The ESP32-WROVER module can only connect to a 2.4GHz WiFi network. Unfortunately, 5GHz is not supported on the ESP32-WROVER module.
For users that want to configure the ESP32 using a serial terminal, you will simply need to connect the CONFIG ESP32 to your computer's USB port. Once connected, open a serial terminal set to 115200 baud and press any key to open the serial configuration menu. Of course, this is only one method of adjusting the settings. You can also change the settings through WiFi, Bluetooth, and a text file saved on a microSD card.
"},{"location":"single_page/#esp32-primary-i2c-port","title":"ESP32 Primary I2C Port","text":"The screw terminal on the back includes an I2C port. This is connected to the ESP32's primary I2C port and is shared by the ZED-F9P and NEO-D9S.
Note
3.3V and GND are also conveniently placed next to the SCL and SDA pins. These follow the same pinout as most of the SparkFun I2C breakout boards with PTHs.
I2C Port Highlighted I2C Port Highlighted on PCBThe I2C peripherals connected to the primary I2C port and their address are listed below:
Inside of the enclosure, there is a Qwiic vertical port available. This is connected to the Qwiic OLED via a Qwiic cable. This port is connected to the ESP32's secondary I2C port with SCL connected to pin 15 and SDA connected to pin 12. The logic level is also 3.3V. Currently, there are no pull-up resistors attached to this line. To attach the 2.2k\u03a9 pull-up resistors to the port, you will just need to add a solder blob to the I2C jumper.
I2C Port HighlightedThe I2C peripheral connected to the secondary I2C port and their address is listed below:
The RTK EVK includes the SparkFun Qwiic OLED - (1.3in., 128x64). This is connected to the ESP32 via a Qwiic port contained within the enclosure. As stated earlier, the default address for the display is 0x3D. The display provides useful information about the RTK EVK without needing to connect to a serial terminal.
OLED Display HighlightedBelow show some of the possible outputs from the RTK EVK. The icons are explained further in the RTK Everywhere Product Manual > Hardware > Displays.
The image below shows the Bluetooth MAC address of the RTK EVK on the upper left hand corner of the screen. If there is a Bluetooth connection, the Blueooth symbol will display. To the right is the WiFi symbol. To the right of the WiFi symbol is the icon indicating the selected dynamic model, in this case it's the default portable icon. On the upper far right, is the Ethernet connection symbol. Below the Bluetooth MAC address is the RTK float solution symbol. The number to the right indicates the horizontal position accuracy. In this case, there is an RTK float since the value is between 0.400 meters to 0.200 meters. To the right is the satellites in view symbol and number of satellites. The additional antenna lines indicates that the RTK EVK that there is successful reception and decryptions of L-band corrections. Finally, the rotating semi-circle indicates the RTK EVK firmware is running. This changes to a logging icon when data is being logged to microSD card.
OLED Display OutputThe image below is similar to the previous display output. You'll notice a few differences. The arrow pointing down indicates that there are corrections being received. The Ethernet symbol is also not displaying since there was no Ethernet connection at that moment. The horizontal positional accuracy indicates that there is a RTK fixed solution with the double cross hairs since the value is below 0.200 meters. Finally, the display is showing 29 satellites in view and no L-band corrections.
OLED Display with RTK Fixed Solution"},{"location":"single_page/#zed-f9p-module","title":"ZED-F9P Module","text":"The RTK EVK wouldn't be a an RTK without well... a high precision RTK. The RTK EVK includes a built-in u-blox ZED-F9P module for high precision GNSS. You will need to connect an active multiband antenna that is capable of receiving L1 and L2 signals. The ZED-F9P can be set as a base station or rover. There are several options to send or receive correction data depending on the mode: Ethernet, WiFi network, LTE cellular network, or the NEO-D9S. Note that the RTK Everywhere firmware does not currently support cellular, but there are separate code examples showing how to receive localized corrections from PointPerfect via cellular. As stated earlier, the ZED-F9P is connected to the primary I2C port and uses the default address of 0x42.
ZED-F9P HighlightedBelow are a few specifications taken from the ZED-F9P's datasheet:
The screw terminal on the back includes a UART port. This is connected to the ZED-F9P's secondary UART port (UART2) for users that want to connect to other high precision GNSS modules for correction data.
The screw terminal on the back includes an external interrupt for the ZED-F9P. The interrupt can either be an input/output pin. This can be configured using u-center to bring the module out of deep sleep or to output an interrupt for various module states. In the RTK Everywhere firmware, this terminal can be used to trigger and log a UBX-TIM-TM2 timing message. The logic level is 3.3V.
ZED-F9P External Interrupt Highlighted ZED-F9P External Interrupt Highlighted on PCB"},{"location":"single_page/#zed-f9p-time-pulse","title":"ZED-F9P Time Pulse","text":"The screw terminal on the back labeled as TP includes ZED-F9Ps time pulse output (i.e. the pulse-per-second or PPS output). This pulses at 1Hz when the module gets basic GPS/GNSS position lock and can be configured using the u-center. The logic level is 3.3V.
ZED-F9P Time Pulse Highlighted ZED-F9P Time Pulse Highlighted on PCB"},{"location":"single_page/#neo-d9s","title":"NEO-D9S","text":"The RTK EVK includes the built-in u-blox NEO-D9S for correction data. You will need to connect an antenna that is capable of receiving signals from the L-band to access u-blox PointPerfect correction service. The NEO-D9S is connected to the primary I2C port and uses the default address of 0x43. You will need a service provider to access the correction data.
NEO-D9S HighlightedBelow are a few specifications taken from the NEO-D9S's datasheet:
The front of the RTK EVK includes a microSD card socket. Insert a microSD card into the socket until it clicks in place. Pushing the microSD card again will eject the memory card. This is connected to the ESP32's SPI port. Power is provided by the secondary power source. Users can manually flash the firmware binaries using the microSD card as opposed to over-the-air updates. Typically, the microSD card is for datalogging. The microSD card can also hold the user preferences for anyone that is interested in deploying multiple RTK EVKs with the same settings out in the field.
MicroSD Card Slot Highlighted MicroSD Card Slot Highlighted on PCB"},{"location":"single_page/#lara-r6-cellular-module","title":"LARA-R6 Cellular Module","text":"The RTK EVK also includes the u-blox LARA-R6 cellular module for users that need to connect to a LTE cellular network. The module is connected to the ESP32 via UART.
LARA-R6 HighlightedBelow are a few specifications taken from the LARA-R6's datasheet:
Note
Although the LARA supports GSM/GPRS, the RTK EVK does not due to the high current required.
Note
Currently, the RTK Everywhere firmware does not support cellular with the LARA-R6. However, we have written and tested extra code examples which will allow you to stream MQTT correction data from a u-blox PointPerfect Localized Distribution topic via the LARA-R6 cellular chip. This example demonstrates how easy it is to subscribe to PointPerfect and only receive the IP correction data you need for your location, minimizing your cellular data costs.
"},{"location":"single_page/#nano-sim-card-socket","title":"Nano SIM Card Socket","text":"To connect to an cellular network with the built-in u-blox LARA-R6 (specifically the LARA-R6001D), you will need a nano SIM card. The cellular module works with most major North American carriers (Verizon, T-Mobile, AT&T, etc.). Make sure to check with your network service provider for compatibility. You also may need approval with the service carrier before the service is activated. We recommend using the Hologram SIM Card. Insert the SIM with the contacts facing down, insert the edge with the chamfered corner first.
Nano SIM Card Socket Highlighted Nano SIM Card Socket Highlighted on PCB"},{"location":"single_page/#wiznet-w5500-ic-ethernet-jack-and-poe","title":"WIZnet W5500 IC, Ethernet Jack, and PoE","text":"The RTK EVK includes a built-in Ethernet circuitry. You can connect an Ethernet cable to the back of the RTK EVK's RJ45 MagJack port. This connector includes status LEDs for Link and Activity. These LEDs can be disabled by cutting the jumpers on the back of the PCB. The port connects to the Power-over-Ethernet (PoE) module and WIZnet W5500 Ethernet transceiver. 10/100Mbps is supported with auto-negotiation. As stated earlier, the PoE module can be powered using the standard PoE voltages between +36V to +57V. Make sure to choose a PoE Ethernet Switch that meeds your needs. We have had good experience with the TP Link TL-SG1005P - available from many retailers including Amazon.
Ethernet Jack HighlightedWIZnet W5500 IC, Ethernet Jack, and PoE Module Highlighted"},{"location":"single_page/#antenna-connections","title":"Antenna Connections","text":"The back of the SparkFun RTK EVK includes a few connectors for cellular, GNSS, and WiFi antennas.
GNSS \u2014 The SMA connector labeled as GNSS is for the u-blox ZED-F9P and NEO-D9S. This is connected to a GNSS splitter (Power Divider) and allows you to connect a single GNSS antenna for both modules. This is intended to connect an active multiband GNSS antenna using the SMA male to TNC male interface cable that is included in the kit. The RTK EVK provides 5V on this connector for an active multiband antenna instead of the usual 3.3V. Short-circuit and open-circuit detection is built into this connection as well. The following icons will flash whenever the RTK EVK does not detect an antenna (i.e. an open circuit) or if there is a short in the cable. Next to the icons will also indicate that there will be 0 satellites in view.
Antenna Open Circuit Highlighted Antenna Short Circuit Highlighted
ESP32 \u2014 The RP-SMA connector labeled as ESP32 is for the ESP32-WROVER. This is intended to connect the 2.4GHz WiFi/BT antenna.
There are two buttons located on the front of the SparkFun RTK EVK.
RTK Modes \u2014 The available modes for the RTK Everywhere firmware are listed below. A single press brings up the mode menu. Press the button again to step through the available modes listed below. Pause on the highlighted mode then double-click to select it and change to that mode. For more information on the modes, make sure to check out the RTK Everywhere Manual.
OLED Display Cycling Through Modes
Bootloader Mode \u2014 The boot button usually allows users to force the ESP32 into bootloader mode to manually upload new code to the ESP32.
There are three LEDs available:
Note
If this is your first time working with jumpers, check out the How to Work with Jumper Pads and PCB Traces tutorial for more information.
The RTK EVK includes various jumpers on the back of the PCB.
I2C will connect to two pull-up resistors to the I2C data and clock lines when closed. For advanced users that do not have pull-up resistors attached to the I2C lines on their microcontroller, make sure to close the jumpers with a little solder blob.The SparkFun RTK EVK is designed around the Metal Enclosure - Custom Aluminum Extrusion (6in. x 4in. PCB). You can find the dimensions of the enclosure below.
Enclosure and Panel DimensionsWithin the enclosure is the RTK EVK PCB. You can find the board dimensions below.
Board DimensionsFor users interested in the dimensions of the surveying antenna, it is also listed below from the SPK6618H datasheet.
SPK6618H Surveying Antenna Dimensions"},{"location":"single_page/#hardware-hookup","title":"Hardware Hookup","text":"In this section, we'll go over how to connect to the SparkFun RTK EVK.
"},{"location":"single_page/#cellular-antenna","title":"Cellular Antenna","text":"To take advantage of the LTE cellular network with the LARA-R6, you will need to connect to the two LTE antennas on the back panel. Insert the LTE Hinged External Antenna into the SMA connector labeled as Cell 1 and rotate the threaded connector until it is finger tight. Repeat for the other SMA connector labeled as Cell 2. You will need to adjust the antenna as necessary depending on where you mount the RTK EVK.
LTE Cellular Antenna LTE Cellular Antenna Ports Highlighted"},{"location":"single_page/#multi-band-gnss-antenna","title":"Multi-Band GNSS Antenna","text":"Of course, you will need to connect an active multi-band GNSS antenna to the RTK EVK. We recommend using the L1/L2/L5 Surveying Antenna (SPK6618H) that is included with the kit. This covers the L1 and L2 band for the ZED-F9P. This also includes a built-in ground plane to provide the best performance for GNSS. This antenna will also provide broad coverage of the L-Band for the correction signals. Insert the SMA connector from the interface cable to the SMA connector labeled as GNSS. Tighten the hex nut until it is finger tight. Connect the TNC connector side from the interface cable to the to the SPK6618H antenna. Tighten the threaded connector until it is finger tight.
GNSS Antenna Port Highlighted Cable Survey AntennaYou will need to mount the antenna in an area where it gest the best view of the sky (we recommend the roof). There is mounting hardware where you can permanently mount the antenna to a structure or support. There is also a magnetic mount to attach to a metal structure as well. For the scope of this tutorial, we will not go over the details of installing the antenna.
Cable Connected and Survey Antenna Mounted on Magnetic Stand"},{"location":"single_page/#wifibluetooth-antenna","title":"WiFi/Bluetooth Antenna","text":"For WiFi and Bluetooth using the ESP32, you will need to connect the 2.4GHz Duck Antenna to the RPSMA connector labeled as ESP32. Insert the antenna into the RPSMA connector and tighten the threaded connector until it is finger tight.
WiFi/Bluetooth Connector Highlighted WiFi/Bluetooth AntennaNote
For users that need an extension cable to mount the antenna to a location that is farther away from the RTK EVK, you could use the Interface Cable - RP-SMA Male to RP-SMA Female (10M, RG58).
"},{"location":"single_page/#ethernet","title":"Ethernet","text":"For users that are connecting Ethernet or using power from the PoE, you will need to connect the Ethernet cable between the RTK EVK and your PoE network switch. Insert the Ethernet cable to the RJ45 MagJack connector until you hear a click. Then insert the other end into the network switch.
Ethernet Port Highlighted Ethernet Cable"},{"location":"single_page/#connecting-to-the-esp32","title":"Connecting to the ESP32","text":"You can connect to the ESP32 by inserting the USB-C connector into the port labeled as CONFIG ESP32 and inserting the other end of the cable to your computer's USB port. This will power the RTK EVK, allow you to upload custom code, manually update the firmware binaries, or connect to a serial terminal.
USB CONFIG ESP32 Port Highlighted USB C Cable"},{"location":"single_page/#connecting-to-the-u-blox-modules","title":"Connecting to the u-blox Modules","text":"You can connect to the ZED-F9P, NEO-D9S, or LARA-R6 by inserting the USB-C connector into the port labeled as CONFIG UBLOX and inserting the other end to your computer's USB port. This will power the RTK EVK and allow you to connect the modules to u-center or m-center (for the LARA-R6).
USB CONFIG ESP32 Port Highlighted USB C Cable"},{"location":"single_page/#inserting-a-microsd-card","title":"Inserting a MicroSD Card","text":"To insert a microSD card, slide the microSD card into the microSD socket until it clicks in place. Pushing the microSD card again will eject the memory card.
MicroSD Card Port Highlighted MicroSD Card"},{"location":"single_page/#inserting-a-nano-sim-card","title":"Inserting a Nano SIM Card","text":"Note
To take advantage of the LARA-R6, insert the nano SIM card into the nano SIM socket until it clicks. In this case, we used a Hologram card. Insert the SIM with the contacts facing down, insert the edge with the chamfered corner first.
Nano SIM Card Socket Highlighted Nano SIM CardNote
You will need to remove the nano SIM card from the 3-in-1 SIM card holder when you initially receive the Hologram card. Just \"punch\" out the pre-cut nano SIM card size out by pushing it out with your fingers. Make sure to avoid touching the gold contacts with your bare hands.
"},{"location":"single_page/#activate-your-hologram-sim","title":"Activate Your Hologram SIM","text":"If you're using a SIM card from Hologram, you'll need to follow a few quick steps to activate your SIM card.
For more help activating your Hologram SIM card, check out their Connect Your Device documentation.
"},{"location":"single_page/#inserting-a-wire-into-the-io-screw-terminal","title":"Inserting a Wire into the I/O Screw Terminal","text":"To connect to a pin on the screw terminal block, insert a stripped wire of any length into the I/O screw terminal. Of course, you could use jumper wires with pins as well. Secure the wire by tightening the screw using a precision 2.5mm flathead screw driver. Test the connection by gently pulling the wires to ensure that they are secure.
Wire Inserted into I/O and Screw Being TightenedIf necessary, users can remove the terminal block off by wiggling the connector or using a spudger. When ready, users can slide the I/O terminal block back into the socket.
I/O Screw Terminal Block RemovedTip
Don't have spudger? A good substitute includes a flathead screw driver, plastic card, or the PCB ruler. Using a tool will make it easier to remove the I/O terminal block.
"},{"location":"single_page/#connecting-a-radio-transceiver","title":"Connecting a Radio Transceiver","text":"Users can connect a radio transceiver to the ZED-F9P UART2 port for correction data. We recommend using a breadboard to JST-GHR-06V cable to connect the SiK Telemetry Radio. Note that the cable is included with the LoRaSerial Kit.
SiK Telemetry Radio V3 - 915MHz, 100mW WRL-19032
SparkFun LoRaSerial Kit - 915MHz (Enclosed) KIT-20029
Breadboard to JST-GHR-06V Cable - 6-Pin x 1.25mm Pitch (For LoRaSerial) CAB-23353
For users with the using a telemetry radio, you will need to connect the UART pins and ground to the screw terminal block. Note that this connection is only for the serial UART connection. To power, we recommend using an external 5V voltage source since 5V is not broken out. While there is a 3V3 pin available, the voltage will not be enough to fully power the radio module. One method is connecting a micro-B USB cable and 5V USB wall adapter to the Telemetry Radio.
RTK EVKUART Pinout TelemetryUART Pinout ZED TX2 RX ZED RX2 TX GND GNDFor users with the LoRaSerial, you will also be connecting the UART pins and ground to the screw terminal block. To power, we also recommend using an external 5V voltage source for power such as a USB C cable and 5V USB wall adapter.
RTK EVKUART Pinout LoRaSerialUART Pinout ZED TX2 RXI ZED RX2 TXO GND GND"},{"location":"single_page/#connecting-via-pth","title":"Connecting via PTH","text":"There are various PTHs throughout the PCB. Most are used with the testbeds for quality control but they are available for you to connect! For temporary connections to the PTHs, you could use IC hooks to test out the pins. However, you'll need to solder headers or wires of your choice to the board for a secure connection. You can choose between header pins and jumper wires, or stripping wire and soldering the wire directly to the board.
How to Solder: Through Hole Soldering
Working with Wire
The SparkFun RTK EVK runs on universal firmware created by SparkFun called RTK Everywhere. You can find its source through the RTK Everywhere GitHub repo.
Screenshot Firmware through Serial TerminalMake sure to check out the Quick Start Guide for the RTK EVK for a summary of how to get it connected over Bluetooth. You will also find more information about navigating through the configuration menu, updating firmware, and more in the product manual!
RTK Everywhere Product Manual: Quickstart Guide"},{"location":"single_page/#arduino-examples","title":"Arduino Examples","text":"Arduino
This example assumes you are using the latest version of the Arduino IDE on your desktop. If this is your first time using the Arduino IDE, library, or board add-on, please review the following tutorials.
Note
If you've never connected an CH340 device to your computer before, you may need to install drivers for the USB-to-serial converter. Check out our section on \"How to Install CH340 Drivers\" for help with the installation.
At the time of writing this tutorial, the RTK Everywhere Firmware currently does not support the u-blox LARA-R6 module. For users that are interested in taking advantage of cellular when Ethernet or WiFi is not available, you can check out the individual Arduino Example Sketches located in the SparkFun RTK EVK Example Sketches folder. Besides the 6x examples for the LARA-R6, you will also notice several other examples such as using the ZED-F9P, NEO-D9S, Qwiic OLED, LEDs, antenna open/short circuit detection, Ethernet, WiFi, and datalogging using the microSD card. Head to the SparkFun RTK EVK GitHub Repo to grab the files or download the .ZIP by clicking the button below.
GitHub SparkFun RTK EVK Repo: Arduino Example SketchesFor the scope of this tutorial, we will upload one of the examples to get started. After downloading the files, unzip the files and head to the following folder: SparkFun_RTK_EVK-main > Example Sketches. Let's test the connection between the ESP32-WROVER and LARA-R6 by clicking on the 8_1_LARA_UART_Test > 8_1_LARA_UART_Test.ino.
Note
Some examples may include additional header files. You'll need to click on the example that has the same title as the folder's title. Certain examples may also require an additional Arduino Library. Make sure to check the example to see if there is a #include with the Arduino Library name near the top before compiling. You may also need to update the examples to provide any secret keys, accounts, or passwords.
Then select the associated board definition (in this case the ESP32 Wrover Module) and COM port. With a USB C cable connected to the CONFIG ESP32 port, click on the upload button. Opening the Arduino Serial Terminal at 115200 baud, the output will provide the model and SIM card information.
Note
At the time of writing, we used the following:
Note
Not working as expected and need help?
If you need technical assistance and more information on a product that is not working as you expected, we recommend heading on over to the SparkFun Technical Assistance page for some initial troubleshooting.
SparkFun Technical Assistance Page
If you don't find what you need there, the SparkFun Forums are a great place to find and ask for help. If this is your first visit, you'll need to create a Forum Account to search product forums and post questions.
Create New Forum Account Log Into SparkFun Forums
"},{"location":"single_page/#resources","title":"Resources","text":"Now that you've successfully got your SparkFun RTK EVK up and running, it's time to incorporate it into your own project! For more information, check out the resources below:
For user that are taking advantage of the Zero-Touch RTK for correction services, make sure to click on the link below! This link will allow you to register, reactivate, or cancel your RTK EVK's correction service.
Note
Not working as expected and need help?
If you need technical assistance and more information on a product that is not working as you expected, we recommend heading on over to the SparkFun Technical Assistance page for some initial troubleshooting.
SparkFun Technical Assistance Page
If you don't find what you need there, the SparkFun Forums are a great place to find and ask for help. If this is your first visit, you'll need to create a Forum Account to search product forums and post questions.
Create New Forum Account Log Into SparkFun Forums
"},{"location":"github/contribute/","title":"Contribute: Help Fix our Mistake!","text":"Spot something wrong? Feel free to contribute our open-source design and documentation.
"},{"location":"github/contribute/#improve-our-documentation","title":"Improve our Documentation","text":"All of this documentation can be modified by you! Please help us make it better.
docs folder of the SparkFun RTK EVK repository.All of our designs are open-source! Please help us make it better.
Hardware folder of the SparkFunRTK EVK Repository.Let's provided some recognition to the contributors for this project!
"},{"location":"github/file_issue/","title":"Did we make a mistake?","text":"
Spot something wrong? Please let us know.
Attention
This is not where customers should seek assistance on a product. If you require technical assistance or have questions about a product that is not working as expected, please head over to the SparkFun Technical Assistance page for some initial troubleshooting. SparkFun Technical Assistance Page
If you can't find what you need there, you'll need a Forum Account to search product forums and post questions.
"},{"location":"github/file_issue/#discrepancies-in-the-documentation","title":"Discrepancies in the Documentation","text":"All of this documentation can be modified by you! Please help us make it better.
docs folder of the SparkFun RTK EVK repository.If a section of the documentation is incorrect, please open an issue and let us know.
"},{"location":"github/file_issue/#do-you-have-a-suggested-correction","title":"Do you have a suggested correction?","text":"All of our designs are open-source! Please help us make it better.
Hardware folder of the SparkFun RTK EVK repository.If part of the design is confusing, please open an issue and let us know.
"},{"location":"github/file_issue/#did-we-forget-to-include-an-important-function-of-the-board","title":"Did we forget to include an important function of the board?","text":"This folder should contain the files for the custom javascript that is enabled in the product documentation
"}]} \ No newline at end of file diff --git a/single_page/index.html b/single_page/index.html new file mode 100644 index 0000000..2329e04 --- /dev/null +++ b/single_page/index.html @@ -0,0 +1,2593 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + +The SparkFun RTK EVK (Evaluation Kit) is the perfect development platform for your fixed or mobile high-precision positioning and navigation needs. In terms of connectivity, the SparkFun RTK EVK has the lot: WiFi / BT, Ethernet and LTE cellular! We called it the EVK (Evaluation Kit) as it truly covers all the options: L1 + L2 RTK GNSS, with L-Band correction built-in if needed, running on an agile processor with memory to spare!
+Note
+Currently, the RTK Everywhere firmware does not support cellular with the LARA-R6. However, we have written and tested extra code examples which will allow you to stream MQTT correction data from a u-blox PointPerfect Localized Distribution topic via the LARA-R6 cellular chip. This example demonstrates how easy it is to subscribe to PointPerfect and only receive the IP correction data you need for your location, minimizing your cellular data costs.
+In this tutorial we'll go over the hardware, assembly, and how get started with the SparkFun RTK.
+The SparkFun RTK EVK comes with everything you need to get up and running. Our kit includes:
+ |
+
| What's in the Box? + | +
Depending on where you are installing the SparkFun RTK EVK, you also might need some mounting accessories to mount the GNSS antenna. You will want to mount the antenna in a location with the best view to of the sky (i.e. a roof).
+The RTK EVK comes with a custom extruded aluminum enclosure. The slotted flanges make it easy to install and secure the enclosure in many locations. If you are going to permanently install it up on a roof, you're going to need a suitable weatherproof box too. We found that the Orbit 57095 - also available from Amazon - was a good one back when we put together our first DIY GNSS Reference Station.
+AC Not Required!
+The Orbit enclosure comes with a built-in power outlet, but you don't actually need it! The RTK EVK can be powered by Power-over-Ethernet (PoE), meaning all you really need to run up to the roof is a standard 8-core CAT-6 Ethernet cable. Choose a PoE Ethernet Switch that meets your needs. We have had good experiences with the TP-Link TL-SG1005P - available from many retailers including Amazon.
+The following interface cables are great if say you are mounting the SparkFun RTK EVK in your home on a desk or lab bench and installing the antenna outdoors.
+Finally, if you're going to be logging a lot of data, you might want to stock up on 32GB microSD cards too. The RTK EVK can log 'raw' GNSS data messages (RAWX and SFRBX) at 20Hz if desired. At that rate, you're logging about 50kB per second, 180MB per hour, or over 4GB per day!
+Below are a few tools and accessories that you may need when connecting to the I/O terminal block on the back of the RTK EVK.
+If you aren’t familiar with the following concepts, we also recommend checking out a few of these tutorials before continuing.
+You may also be interested in the following blog posts on GNSS technologies.
+The electronics of the SparkFun RTK EVK is enclosed in a custom extruded aluminum case with machined end panels and slotted flanges.
+ |
+ |
+
| Front View | +Back View | +
The image below shows a top and bottom view of the populated PCB without the enclosure.
+ |
+ |
+
| PCB Top View | +PCB Bottom View | +
The SparkFun RTK EVK can be powered from the connectors on the front or the back of the board. There is no internal battery. Schottky protection diodes and a resettable fuse are included to prevent conflicting voltages and overvoltage protection. Voltage is then regulated down to 3.3V through the three voltage regulators.
+ |
+ |
+
| USB Connectors Highlighted in Front | +USB Connectors Highlighted PCB Top View | +
Power can also be provided from the I/O screw terminals or PoE.
+ |
+ |
+
| USB Connector, Ethernet POE, and Power Input on Screw Terminals Highlighted in Back | +Ethernet POE, and Power Input on Screw Terminals Highlighted on PCB | +
There is also an output power pin for 3.3V on the I/O screw terminal.
+ |
+ |
+
| 3.3V Input on Screw Terminals Highlighted in Back | +3.3V Input on Screw Terminals Highlighted on PCB | +
A CH340 USB-to-Serial converter is included between the USB-C connector and the ESP32. The chip can be used to send serial data between the RTK EVK and computer. You can view the output or configure the device through a serial terminal. You can also manually upload new firmware as well.
+ |
+
| CH340 USB-to-Serial Converter Highlighted | +
The driver should automatically install on most operating systems. However, there is a wide range of operating systems out there. You may need to install drivers the first time you connect the chip to your computer's USB port or when there are operating system updates. For more information, check out our How to Install CH340 Drivers Tutorial.
+|
+
+ + + How to Install CH340 Drivers ++ + |
+
The RTK Everywhere firmware is pre-loaded with the RTK EVK and flashed to the ESPRESSIF ESP32-WROVER module (with 16MB flash and 8MB PSRAM). The ESP32 handles all the processes. You can configure the EVK as a RTK base and push corrections to an NTRIP Caster. You can also configure the EVK as a RTK Rover and use corrections delivered over WiFi or Bluetooth. You can even update firmware over-the-air. For more information, we recommend checking out the RTK Everywhere Product Manual.
+ |
+
| ESP32 Highlighted | +
Note
+The ESP32-WROVER module can only connect to a 2.4GHz WiFi network. Unfortunately, 5GHz is not supported on the ESP32-WROVER module.
+For users that want to configure the ESP32 using a serial terminal, you will simply need to connect the CONFIG ESP32 to your computer's USB port. Once connected, open a serial terminal set to 115200 baud and press any key to open the serial configuration menu. Of course, this is only one method of adjusting the settings. You can also change the settings through WiFi, Bluetooth, and a text file saved on a microSD card.
+The screw terminal on the back includes an I2C port. This is connected to the ESP32's primary I2C port and is shared by the ZED-F9P and NEO-D9S.
+Note
+3.3V and GND are also conveniently placed next to the SCL and SDA pins. These follow the same pinout as most of the SparkFun I2C breakout boards with PTHs.
+ |
+ |
+
| I2C Port Highlighted | +I2C Port Highlighted on PCB | +
The I2C peripherals connected to the primary I2C port and their address are listed below:
+Inside of the enclosure, there is a Qwiic vertical port available. This is connected to the Qwiic OLED via a Qwiic cable. This port is connected to the ESP32's secondary I2C port with SCL connected to pin 15 and SDA connected to pin 12. The logic level is also 3.3V. Currently, there are no pull-up resistors attached to this line. To attach the 2.2kΩ pull-up resistors to the port, you will just need to add a solder blob to the I2C jumper.
+ |
+
| I2C Port Highlighted | +
The I2C peripheral connected to the secondary I2C port and their address is listed below:
+The RTK EVK includes the SparkFun Qwiic OLED - (1.3in., 128x64). This is connected to the ESP32 via a Qwiic port contained within the enclosure. As stated earlier, the default address for the display is 0x3D. The display provides useful information about the RTK EVK without needing to connect to a serial terminal.
+ |
+
| OLED Display Highlighted | +
Below show some of the possible outputs from the RTK EVK. The icons are explained further in the RTK Everywhere Product Manual > Hardware > Displays.
+The image below shows the Bluetooth MAC address of the RTK EVK on the upper left hand corner of the screen. If there is a Bluetooth connection, the Blueooth symbol will display. To the right is the WiFi symbol. To the right of the WiFi symbol is the icon indicating the selected dynamic model, in this case it's the default portable icon. On the upper far right, is the Ethernet connection symbol. Below the Bluetooth MAC address is the RTK float solution symbol. The number to the right indicates the horizontal position accuracy. In this case, there is an RTK float since the value is between 0.400 meters to 0.200 meters. To the right is the satellites in view symbol and number of satellites. The additional antenna lines indicates that the RTK EVK that there is successful reception and decryptions of L-band corrections. Finally, the rotating semi-circle indicates the RTK EVK firmware is running. This changes to a logging icon when data is being logged to microSD card.
+ |
+
| OLED Display Output | +
The image below is similar to the previous display output. You'll notice a few differences. The arrow pointing down indicates that there are corrections being received. The Ethernet symbol is also not displaying since there was no Ethernet connection at that moment. The horizontal positional accuracy indicates that there is a RTK fixed solution with the double cross hairs since the value is below 0.200 meters. Finally, the display is showing 29 satellites in view and no L-band corrections.
+ |
+
| OLED Display with RTK Fixed Solution | +
The RTK EVK wouldn't be a an RTK without well... a high precision RTK. The RTK EVK includes a built-in u-blox ZED-F9P module for high precision GNSS. You will need to connect an active multiband antenna that is capable of receiving L1 and L2 signals. The ZED-F9P can be set as a base station or rover. There are several options to send or receive correction data depending on the mode: Ethernet, WiFi network, LTE cellular network, or the NEO-D9S. Note that the RTK Everywhere firmware does not currently support cellular, but there are separate code examples showing how to receive localized corrections from PointPerfect via cellular. As stated earlier, the ZED-F9P is connected to the primary I2C port and uses the default address of 0x42.
+ |
+
| ZED-F9P Highlighted | +
Below are a few specifications taken from the ZED-F9P's datasheet:
+The screw terminal on the back includes a UART port. This is connected to the ZED-F9P's secondary UART port (UART2) for users that want to connect to other high precision GNSS modules for correction data.
+ |
+ |
+
| ZED-F9P UART Correction Port Highlighted | +ZED-F9P UART Correction Port Highlighted on PCB | +
The screw terminal on the back includes an external interrupt for the ZED-F9P. The interrupt can either be an input/output pin. This can be configured using u-center to bring the module out of deep sleep or to output an interrupt for various module states. In the RTK Everywhere firmware, this terminal can be used to trigger and log a UBX-TIM-TM2 timing message. The logic level is 3.3V.
+ |
+ |
+
| ZED-F9P External Interrupt Highlighted | +ZED-F9P External Interrupt Highlighted on PCB | +
The screw terminal on the back labeled as TP includes ZED-F9Ps time pulse output (i.e. the pulse-per-second or PPS output). This pulses at 1Hz when the module gets basic GPS/GNSS position lock and can be configured using the u-center. The logic level is 3.3V.
+ |
+ |
+
| ZED-F9P Time Pulse Highlighted | +ZED-F9P Time Pulse Highlighted on PCB | +
The RTK EVK includes the built-in u-blox NEO-D9S for correction data. You will need to connect an antenna that is capable of receiving signals from the L-band to access u-blox PointPerfect correction service. The NEO-D9S is connected to the primary I2C port and uses the default address of 0x43. You will need a service provider to access the correction data.
+ |
+
| NEO-D9S Highlighted | +
Below are a few specifications taken from the NEO-D9S's datasheet:
+The front of the RTK EVK includes a microSD card socket. Insert a microSD card into the socket until it clicks in place. Pushing the microSD card again will eject the memory card. This is connected to the ESP32's SPI port. Power is provided by the secondary power source. Users can manually flash the firmware binaries using the microSD card as opposed to over-the-air updates. Typically, the microSD card is for datalogging. The microSD card can also hold the user preferences for anyone that is interested in deploying multiple RTK EVKs with the same settings out in the field.
+ |
+ |
+
| MicroSD Card Slot Highlighted | +MicroSD Card Slot Highlighted on PCB | +
The RTK EVK also includes the u-blox LARA-R6 cellular module for users that need to connect to a LTE cellular network. The module is connected to the ESP32 via UART.
+ |
+
| LARA-R6 Highlighted | +
Below are a few specifications taken from the LARA-R6's datasheet:
+Note
+Although the LARA supports GSM/GPRS, the RTK EVK does not due to the high current required.
+Note
+Currently, the RTK Everywhere firmware does not support cellular with the LARA-R6. However, we have written and tested extra code examples which will allow you to stream MQTT correction data from a u-blox PointPerfect Localized Distribution topic via the LARA-R6 cellular chip. This example demonstrates how easy it is to subscribe to PointPerfect and only receive the IP correction data you need for your location, minimizing your cellular data costs.
+To connect to an cellular network with the built-in u-blox LARA-R6 (specifically the LARA-R6001D), you will need a nano SIM card. The cellular module works with most major North American carriers (Verizon, T-Mobile, AT&T, etc.). Make sure to check with your network service provider for compatibility. You also may need approval with the service carrier before the service is activated. We recommend using the Hologram SIM Card. Insert the SIM with the contacts facing down, insert the edge with the chamfered corner first.
+ |
+ |
+
| Nano SIM Card Socket Highlighted | +Nano SIM Card Socket Highlighted on PCB | +
The RTK EVK includes a built-in Ethernet circuitry. You can connect an Ethernet cable to the back of the RTK EVK's RJ45 MagJack port. This connector includes status LEDs for Link and Activity. These LEDs can be disabled by cutting the jumpers on the back of the PCB. The port connects to the Power-over-Ethernet (PoE) module and WIZnet W5500 Ethernet transceiver. 10/100Mbps is supported with auto-negotiation. As stated earlier, the PoE module can be powered using the standard PoE voltages between +36V to +57V. Make sure to choose a PoE Ethernet Switch that meeds your needs. We have had good experience with the TP Link TL-SG1005P - available from many retailers including Amazon.
+ |
+ |
+
| Ethernet Jack Highlighted | WIZnet W5500 IC, Ethernet Jack, and PoE Module Highlighted | +
The back of the SparkFun RTK EVK includes a few connectors for cellular, GNSS, and WiFi antennas.
+GNSS — The SMA connector labeled as GNSS is for the u-blox ZED-F9P and NEO-D9S. This is connected to a GNSS splitter (Power Divider) and allows you to connect a single GNSS antenna for both modules. This is intended to connect an active multiband GNSS antenna using the SMA male to TNC male interface cable that is included in the kit. The RTK EVK provides 5V on this connector for an active multiband antenna instead of the usual 3.3V. Short-circuit and open-circuit detection is built into this connection as well. The following icons will flash whenever the RTK EVK does not detect an antenna (i.e. an open circuit) or if there is a short in the cable. Next to the icons will also indicate that there will be 0 satellites in view.
+ |
+ |
+
| Antenna Open Circuit Highlighted | +Antenna Short Circuit Highlighted | +
ESP32 — The RP-SMA connector labeled as ESP32 is for the ESP32-WROVER. This is intended to connect the 2.4GHz WiFi/BT antenna.
+ |
+ |
+
| Antenna Connectors Highlighted on Back | +Antenna Connectors Highlighted on PCB | +
There are two buttons located on the front of the SparkFun RTK EVK.
+ |
+ |
+
| Reset and Mode/Boot Buttons Highlighted | +Reset and Mode/Boot Buttons Highlighted on PCB | +
RTK Modes — The available modes for the RTK Everywhere firmware are listed below. A single press brings up the mode menu. Press the button again to step through the available modes listed below. Pause on the highlighted mode then double-click to select it and change to that mode. For more information on the modes, make sure to check out the RTK Everywhere Manual.
+ |
+
| OLED Display Cycling Through Modes | +
Bootloader Mode — The boot button usually allows users to force the ESP32 into bootloader mode to manually upload new code to the ESP32.
+There are three LEDs available:
+ |
+ |
+
| LED Highlighted | +LEDs on Ethernet Connector Highlighted | +
Note
+If this is your first time working with jumpers, check out the How to Work with Jumper Pads and PCB Traces tutorial for more information.
+The RTK EVK includes various jumpers on the back of the PCB.
+I2C will connect to two pull-up resistors to the I2C data and clock lines when closed. For advanced users that do not have pull-up resistors attached to the I2C lines on their microcontroller, make sure to close the jumpers with a little solder blob. |
+
| Jumpers | +
The SparkFun RTK EVK is designed around the Metal Enclosure - Custom Aluminum Extrusion (6in. x 4in. PCB). You can find the dimensions of the enclosure below.
+ |
+
| Enclosure and Panel Dimensions | +
Within the enclosure is the RTK EVK PCB. You can find the board dimensions below.
+ |
+
| Board Dimensions | +
For users interested in the dimensions of the surveying antenna, it is also listed below from the SPK6618H datasheet.
+ |
+
| SPK6618H Surveying Antenna Dimensions | +
In this section, we'll go over how to connect to the SparkFun RTK EVK.
+To take advantage of the LTE cellular network with the LARA-R6, you will need to connect to the two LTE antennas on the back panel. Insert the LTE Hinged External Antenna into the SMA connector labeled as Cell 1 and rotate the threaded connector until it is finger tight. Repeat for the other SMA connector labeled as Cell 2. You will need to adjust the antenna as necessary depending on where you mount the RTK EVK.
+ |
+ |
+
| LTE Cellular Antenna | +LTE Cellular Antenna Ports Highlighted | +
Of course, you will need to connect an active multi-band GNSS antenna to the RTK EVK. We recommend using the L1/L2/L5 Surveying Antenna (SPK6618H) that is included with the kit. This covers the L1 and L2 band for the ZED-F9P. This also includes a built-in ground plane to provide the best performance for GNSS. This antenna will also provide broad coverage of the L-Band for the correction signals. Insert the SMA connector from the interface cable to the SMA connector labeled as GNSS. Tighten the hex nut until it is finger tight. Connect the TNC connector side from the interface cable to the to the SPK6618H antenna. Tighten the threaded connector until it is finger tight.
+ |
+ |
+ |
+
| GNSS Antenna Port Highlighted | +Cable | +Survey Antenna | +
You will need to mount the antenna in an area where it gest the best view of the sky (we recommend the roof). There is mounting hardware where you can permanently mount the antenna to a structure or support. There is also a magnetic mount to attach to a metal structure as well. For the scope of this tutorial, we will not go over the details of installing the antenna.
+ |
+
| Cable Connected and Survey Antenna Mounted on Magnetic Stand | +
For WiFi and Bluetooth using the ESP32, you will need to connect the 2.4GHz Duck Antenna to the RPSMA connector labeled as ESP32. Insert the antenna into the RPSMA connector and tighten the threaded connector until it is finger tight.
+ |
+ |
+
| WiFi/Bluetooth Connector Highlighted | +WiFi/Bluetooth Antenna | +
Note
+For users that need an extension cable to mount the antenna to a location that is farther away from the RTK EVK, you could use the Interface Cable - RP-SMA Male to RP-SMA Female (10M, RG58).
+For users that are connecting Ethernet or using power from the PoE, you will need to connect the Ethernet cable between the RTK EVK and your PoE network switch. Insert the Ethernet cable to the RJ45 MagJack connector until you hear a click. Then insert the other end into the network switch.
+ |
+ |
+
| Ethernet Port Highlighted | +Ethernet Cable | +
You can connect to the ESP32 by inserting the USB-C connector into the port labeled as CONFIG ESP32 and inserting the other end of the cable to your computer's USB port. This will power the RTK EVK, allow you to upload custom code, manually update the firmware binaries, or connect to a serial terminal.
+ |
+ |
+
| USB CONFIG ESP32 Port Highlighted | +USB C Cable | +
You can connect to the ZED-F9P, NEO-D9S, or LARA-R6 by inserting the USB-C connector into the port labeled as CONFIG UBLOX and inserting the other end to your computer's USB port. This will power the RTK EVK and allow you to connect the modules to u-center or m-center (for the LARA-R6).
+ | |
+
| USB CONFIG ESP32 Port Highlighted | +USB C Cable | +
To insert a microSD card, slide the microSD card into the microSD socket until it clicks in place. Pushing the microSD card again will eject the memory card.
+ |
+ |
+
| MicroSD Card Port Highlighted | +MicroSD Card | +
Note
+If you're using a SIM card from Hologram, you'll need to follow a few quick steps to activate your SIM card. +
For more help activating your Hologram SIM card, check out their Connect Your Device documentation.
+To take advantage of the LARA-R6, insert the nano SIM card into the nano SIM socket until it clicks. In this case, we used a Hologram card. Insert the SIM with the contacts facing down, insert the edge with the chamfered corner first.
+ |
+ |
+
| Nano SIM Card Socket Highlighted | +Nano SIM Card | +
Note
+You will need to remove the nano SIM card from the 3-in-1 SIM card holder when you initially receive the Hologram card. Just "punch" out the pre-cut nano SIM card size out by pushing it out with your fingers. Make sure to avoid touching the gold contacts with your bare hands.
+To connect to a pin on the screw terminal block, insert a stripped wire of any length into the I/O screw terminal. Of course, you could use jumper wires with pins as well. Secure the wire by tightening the screw using a precision 2.5mm flathead screw driver. Test the connection by gently pulling the wires to ensure that they are secure.
+ |
+
| Wire Inserted into I/O and Screw Being Tightened | +
If necessary, users can remove the terminal block off by wiggling the connector or using a spudger. When ready, users can slide the I/O terminal block back into the socket.
+ |
+
| I/O Screw Terminal Block Removed | +
Tip
+Don't have spudger? A good substitute includes a flathead screw driver, plastic card, or the PCB ruler. Using a tool will make it easier to remove the I/O terminal block.
+Users can connect a radio transceiver to the ZED-F9P UART2 port for correction data. We recommend using a breadboard to JST-GHR-06V cable to connect the SiK Telemetry Radio. Note that the cable is included with the LoRaSerial Kit.
+For users with the using a telemetry radio, you will need to connect the UART pins and ground to the screw terminal block. Note that this connection is only for the serial UART connection. To power, we recommend using an external 5V voltage source since 5V is not broken out. While there is a 3V3 pin available, the voltage will not be enough to fully power the radio module. One method is connecting a micro-B USB cable and 5V USB wall adapter to the Telemetry Radio.
+| RTK EVK UART Pinout + |
+ Telemetry UART Pinout + |
+
|---|---|
| ZED TX2 + | +RX + | +
| ZED RX2 + | TX + | +
| GND + | +GND + | +
For users with the LoRaSerial, you will also be connecting the UART pins and ground to the screw terminal block. To power, we also recommend using an external 5V voltage source for power such as a USB C cable and 5V USB wall adapter.
+| RTK EVK UART Pinout + |
+ LoRaSerial UART Pinout + |
+
|---|---|
| ZED TX2 + | +RXI + | +
| ZED RX2 + | TXO + | +
| GND + | +GND + | +
There are various PTHs throughout the PCB. Most are used with the testbeds for quality control but they are available for you to connect! For temporary connections to the PTHs, you could use IC hooks to test out the pins. However, you'll need to solder headers or wires of your choice to the board for a secure connection. You can choose between header pins and jumper wires, or stripping wire and soldering the wire directly to the board.
+The SparkFun RTK EVK runs on universal firmware created by SparkFun called RTK Everywhere. You can find its source through the RTK Everywhere GitHub repo.
+ |
+
| Screenshot Firmware through Serial Terminal | +
Make sure to check out the Quick Start Guide for the RTK EVK for a summary of how to get it connected over Bluetooth. You will also find more information about navigating through the configuration menu, updating firmware, and more in the product manual!
+ + +Arduino
+This example assumes you are using the latest version of the Arduino IDE on your desktop. If this is your first time using the Arduino IDE, library, or board add-on, please review the following tutorials.
+ +Note
+If you've never connected an CH340 device to your computer before, you may need to install drivers for the USB-to-serial converter. Check out our section on "How to Install CH340 Drivers" for help with the installation.
+ +At the time of writing this tutorial, the RTK Everywhere Firmware currently does not support the u-blox LARA-R6 module. For users that are interested in taking advantage of cellular when Ethernet or WiFi is not available, you can check out the individual Arduino Example Sketches located in the SparkFun RTK EVK Example Sketches folder. Besides the 6x examples for the LARA-R6, you will also notice several other examples such as using the ZED-F9P, NEO-D9S, Qwiic OLED, LEDs, antenna open/short circuit detection, Ethernet, WiFi, and datalogging using the microSD card. Head to the SparkFun RTK EVK GitHub Repo to grab the files or download the .ZIP by clicking the button below.
+ + +For the scope of this tutorial, we will upload one of the examples to get started. After downloading the files, unzip the files and head to the following folder: SparkFun_RTK_EVK-main > Example Sketches. Let's test the connection between the ESP32-WROVER and LARA-R6 by clicking on the 8_1_LARA_UART_Test > 8_1_LARA_UART_Test.ino.
+Note
+Some examples may include additional header files. You'll need to click on the example that has the same title as the folder's title. Certain examples may also require an additional Arduino Library. Make sure to check the example to see if there is a #include with the Arduino Library name near the top before compiling. You may also need to update the examples to provide any secret keys, accounts, or passwords.
Then select the associated board definition (in this case the ESP32 Wrover Module) and COM port. With a USB C cable connected to the CONFIG ESP32 port, click on the upload button. Opening the Arduino Serial Terminal at 115200 baud, the output will provide the model and SIM card information.
+Note
+At the time of writing, we used the following:
+
+
Note
+
+ Not working as expected and need help?
If you need technical assistance and more information on a product that is not working as you expected, we recommend heading on over to the SparkFun Technical Assistance page for some initial troubleshooting.
If you don't find what you need there, the SparkFun Forums are a great place to find and ask for help. If this is your first visit, you'll need to create a Forum Account to search product forums and post questions.
Now that you've successfully got your SparkFun RTK EVK up and running, it's time to incorporate it into your own project! For more information, check out the resources below:
+For user that are taking advantage of the Zero-Touch RTK for correction services, make sure to click on the link below! This link will allow you to register, reactivate, or cancel your RTK EVK's correction service.
+ + + + + + + + + + + + + + + + + + + + + + + + + + +Note
+
+ Not working as expected and need help?
If you need technical assistance and more information on a product that is not working as you expected, we recommend heading on over to the SparkFun Technical Assistance page for some initial troubleshooting.
If you don't find what you need there, the SparkFun Forums are a great place to find and ask for help. If this is your first visit, you'll need to create a Forum Account to search product forums and post questions.