 |
 |
| SparkFun BlueSMiRF v2 (WRL-24113) | SparkFun BlueSMiRF v2 - Headers (WRL-23287) |
The SparkFun BlueSMiRF v2 and SparkFun BlueSMiRF v2 - Headers are wireless Bluetooth® serial links. These boards work as a wireless serial UART pipe and are a great wireless replacement for serial cables. Simply pair, connect, and transmit serial data between your TX/RX lines! Any serial stream from 2400 to 921600 baud can be passed seamlessly between two devices.
Duplex transmissions up to 921600bps are supported. What does this mean? You can throw a book at each BlueSMiRF, which will correctly buffer, transmit, and deliver the data streams, byte perfect, to both radios.
BlueSMiRF v2 has a multitude of exciting improvements over the original. The BlueSMiRF pinout is the same as previous Bluetooth Mates and USB-to-serial converters (i.e., FTDI, CH340, etc.), making it extremely easy to hook up to many common Arduino development boards and GNSS breakout boards. The board can be connected directly with an Arduino Pro, Pro Mini, or any board with a standard 6-pin serial connector. We broke out the pins to the 1x6 header for this version of the board. You'll need to either solder a 1x6 female header or striped wires to the PTHs before being able to connect to another device. The SparkFun BlueSMiRF v2 is perfect for short-range applications up to 100ft (33m) indoors that require easy to setup, point-to-point communication.
A BlueSMiRF can be connected to a phone or computer to view data or remote control easily. Two BlueSMiRFs can also be easily connected using the onboard PAIR button. If needed, this button can be disabled by cutting the jumper on the back of the board.
We've designed the BlueSMiRF to be remotely configured from a phone using a serial terminal app. Changing the settings, such as the baud rate, flow control, and LED mode, is easily done using the simple AT command set. Additionally, Over The Air (OTA) updates using WiFi allow easy in-field firmware updates as new features are released.
The BlueSMiRF v2 has an on-board voltage regulator to power between 3.3V and 5V. Logic level shifting circuitry is included on all pins to be 3.3V to 5V tolerant. Note that you will need an RS232 to TTL converter for higher voltages. A jumper on the top of the board is also included to bypass the voltage regulator. Two built-in LEDs indicate when the BlueSMiRF is connected and when there is serial UART traffic.
Note: Bluetooth® classic (Serial Port Profile or SPP) is primarily supported. This Bluetooth protocol is supported on Android phones, most desktops, and laptops. BlueSMiRF also supports the BLE protocol, available on all Apple phones.
This repo houses the BlueSMiRF v2 Hookup Guide and the firmware that runs on the SparkFun BlueSMiRF v2 product line including:
For compiled binaries of the firmware, please see SparkFun BlueSMiRF ESP32 Firmware Binaries.
- .github/workflows - YAML files used for GitHub Actions and GitHub Pages/mkdocs
- /Firmware - Source code for SparkFun BlueSMiRF firmware as well as various feature unit tests
- /Hardware - KiCad design files (.kicad_pcb, .kicad_sch)
- /Production - Production panel files (.kicad_pcb)
- /docs - Online documentation files
- /assets - Folder containing all the file assets used for product documentation
- /3d_model - Exported 3D models from KiCad
- /board_files - Copy of design files used for product documentation
- /component_documentation - Datasheets and manuals for hardware components
- /img - Images for product documentation
- /github - Files stating how to contribute and filing issues for product
- /javascript - Folder containing custom javascript used for product documentation
- /stylesheet - Folder containing CSS files used forproduct documentation
- /assets - Folder containing all the file assets used for product documentation
- /overrides - Customization files used for product documentation
- /.icons - Icons used for product documentation
- ./partials - Used for product documentation
- Firmware Binaries - Compiled binaries of the firmware.
- Hookup Guide - Basic hookup guide for the BlueSMiRF v2 PTH and header versions.
This repository has two long-term branches: main and release_candidate.
With respect to the firmware, main is a branch where only changes that are appropriate for all users are applied. Thus, following main means updating to normal releases, and perhaps bugfixes to those releases.
In contrast, release_candidate is where new code is added as it is developed.
The documentation source code is in docs/ on main. It is built automatically on push and stored in the branch gh-pages, from which it is served at the above URL. Documentation changes are pushed directly to main.
A release is made by merging release_candidate back to main, and then applying a tag to that commit on main.
A pre-release is often created using the latest stable release candidate. These binaries will have extra debug statements turned on that will not be present in a formal release, but should not affect the behavior of the firmware.
The command-line interface is also available. You’ll need to download the RTK Firmware Binaries repo. This repo contains the binaries but also various supporting tools including esptool.exe and the three binaries required along with the firmware (bootloader, partitions, and app0).
Because it's much easier to use, we recommend the OTA firmware update process. If that fails for some reason, you can use the CLI method. For more information, check out the tutorial under the section Firmware Update.
This product is open source! Please feel free to contribute to both the firmware and documentation.
Various bits of the code have different licenses applied. Anything SparkFun wrote is beerware; if you see me (or any other SparkFun employee) at the local, and you've found our code helpful, please buy us a round!
Please use, reuse, and modify these files as you see fit. Please maintain attribution to SparkFun Electronics and release anything derivative under the same license.
Distributed as-is; no warranty is given.
- Your friends at SparkFun.