software-esp32.md

icon
fontawesome/solid/microchip

CH342 USB Driver

The USB drivers for the CH342 USB-to-Serial converter can be downloaded from the manufacturer's website.

• :material-microsoft-windows: Windows

  ---

  :octicons-download-16:{ .heart } Download Page for CH343SER.EXE{ .md-button .md-button--primary target="blank" }

• :material-apple: MacOS

  ---

  :octicons-download-16:{ .heart } Download Page for CH341SER_MAC.ZIP{ .md-button .md-button--primary target="blank" }

!!! info "Linux" A USB driver is not required for Linux based operating systems.

RTK Everywhere Firmware

The RTK Postcard comes preloaded with our latest RTK Everywhere firmware. Our firmware is completely open-source; therefore, users can view the code to troubleshoot issues, contribute new features or updates, and file issues for any bugs they discover. In addition, we also users with pre-compiled binaries in our SparkFun RTK Everywhere Firmware binaries GitHub repository and a RTK Firmware Uploader tool to upload the pre-compiled binaries to the RTK Postcard. For more information, users can reference the user manual for the RTK Everywhere firmware and associated links below:

• Compile the firmware
• Update the firmware
• RTK Firmware Uploader

RTK_Everywhere_Firmware_RC-XXX_XX_XXXX.binRTK_Everywhere_Firmware_RC-*.bin

Arduino IDE

Most users may already be familiar with the Arduino IDE and its use. However, for those of you who have never heard the name Arduino before, feel free to check out the Arduino website. In order to program the RTK Postcard, users will need to install the ESP32 Arduino Core through the Board Manager. Additionally, we also recommend installing the SparkFun LG290P Quadband RTK GNSS Arduino Library to interface with the LG290P GNSS receiver.

Espressif ESP32 Arduino Core

The ESP32 Arduino Core can be installed from the board manager in the Arduino IDE by searching for:

esp32 by Espressif Systems 

[{ width="325" }](./assets/img/hookup_guide/arduino-preferences.png) Preference settings for the Arduino IDE.

[{ width="400" }](./assets/img/hookup_guide/arduino-board_manager.png) The Espressif ESP32 Arduino core in the library manager of the Arduino IDE.

!!! tip "Arduino Board Manager URL" In order to install Espressif's ESP32 Arduino core, users must provide the Arduino Board Manager URL in the preferences settings (File > Preferences) for the Arduino IDE:

``` https://raw.githubusercontent.com/espressif/arduino-esp32/gh-pages/package_esp32_index.json ``` 

Board Selection

In order to program the ESP32 Pico-Mini module on the RTK Postcard, users should select the ESP32 Dev Module from the Tools > Board: > esp32 drop-down menu.

[{ width="400" }](./assets/img/hookup_guide/arduino-select_board.png) Selecting the **ESP32 Dev Module** board for the RTK Postcard in the Arduino IDE.

SparkFun LG290P Quadband RTK GNSS Arduino Library

The SparkFun LG290P Quadband RTK GNSS Arduino Library can be installed from the library manager in the Arduino IDE by searching for:

SparkFun LG290P Quadband RTK GNSS Arduino Library 

[{ width="400" }](./assets/img/hookup_guide/arduino-library_manager.png) SparkFun LG290P Quadband RTK GNSS Arduino Library in the library manager of the Arduino IDE.

!!! tip "Manually Download the Arduino Library" For users who would like to manually download and install the library, the *.zip file can be accessed from the GitHub repository or downloaded by clicking the button below.

<center> [:octicons-download-16:{ .heart } Download the Arduino Library](https://github.com/sparkfun/SparkFun_LG290P_GNSS_Arduino_Library/archive/refs/heads/main.zip){ .md-button .md-button--primary } </center>