Skip to content

Commit

Permalink
Fix a few typos.
Browse files Browse the repository at this point in the history
  • Loading branch information
nseidle committed Jan 25, 2024
1 parent 59fcaa2 commit 966ef45
Show file tree
Hide file tree
Showing 3 changed files with 11 additions and 20 deletions.
8 changes: 3 additions & 5 deletions docs/firmware_update.md
Original file line number Diff line number Diff line change
@@ -1,13 +1,11 @@
From time to time, SparkFun will release new firmware for the BlueSMiRF V2 product line to add and improve functionality. For most users, firmware can be upgraded over a 2.4GHz WiFi network using the [OTA method](firmware_update.md#updating-firmware-over-the-air). Users can also update the firmware manually using a Command Line Interface (CLI)
From time to time, SparkFun will release new firmware for the BlueSMiRF v2 product line to add and improve functionality. For most users, firmware can be upgraded over a 2.4GHz WiFi network using the [OTA method](firmware_update.md#updating-firmware-over-the-air). Users can also update the firmware manually using a Command Line Interface (CLI)



### Updating Firmware Over-The-Air (OTA)

Once the `AT-WiFiSSID` and `AT-WiFiPassword` settings have been entered for your local WiFi network, the `ATC` command can be issued to check for new firmware. If new firmware is available, send the `ATU` command to begin an update.



# Manually Updating Firmware Over Serial

Because it's much easier to use, we recommend the OTA firmware update process. If that fails for some reason, the following CLI method can be used.
Expand All @@ -16,7 +14,7 @@ Because it's much easier to use, we recommend the OTA firmware update process. I

### Entering Bootloader Mode

Hold the **PAIR** button while powering the BlueSMiRF V2. This will cause the ESP32 to enter bootloader mode. Once the BlueSMiRF V2 is in bootloader mode, the **STATUS** LED will be dimly lit and the **CONNECT** LED will be off.
Hold the **PAIR** button while powering the BlueSMiRF v2. This will cause the ESP32 to enter bootloader mode. Once the BlueSMiRF v2 is in bootloader mode, the **STATUS** LED will be dimly lit and the **CONNECT** LED will be off.

We recommend using a [breadboard](https://www.sparkfun.com/products/12002) or [jumper wires](https://www.sparkfun.com/products/11026) to connect the BlueSMiRF to a [USB-to-Serial](https://www.sparkfun.com/products/15096) connection. At a minimum, you will need to connect the UART pins, power, and ground as stated in the hardware hookup. Remember, the TX and RX connections must be crossed over.

Expand Down Expand Up @@ -91,7 +89,7 @@ We recommend using a [breadboard](https://www.sparkfun.com/products/12002) or [j
</div>

!!! note
The connection also includes two additional connection for flow control: <span STYLE="text-decoration:overline">RTS</span> and CTS. These two connections are not needed for a basic serial UART connection. However, using all six wires can help make a tighter connection on the 1x6 header. The wire colors also connect TXO-to-RXI and RXI-to-RXO to indicate that it is not a direct connection between the two boards and the 1x6 header.
The connection also includes two additional connection for flow control: <span STYLE="text-decoration:overline">RTS</span> and <span STYLE="text-decoration:overline">CTS</span>. These two connections are not needed for a basic serial UART connection. However, using all six wires can help make a tighter connection on the 1x6 header. The wire colors also connect TXO-to-RXI and RXI-to-RXO to indicate that it is not a direct connection between the two boards and the 1x6 header.

<div style="text-align: center;">
<table>
Expand Down
18 changes: 6 additions & 12 deletions docs/hardware_overview.md
Original file line number Diff line number Diff line change
Expand Up @@ -115,13 +115,13 @@ The reset PTH labeled as <span STYLE="text-decoration:overline">RST</span> will
</div>


Both boards include a standard serial UART header seen on many USB-to-serial converters: <span STYLE="text-decoration:overline">RTS</span>/RXI/TXO/VCC/<span STYLE="text-decoration:overline">CTS</span>/GND . Depending on the version that you receive, one will be PTH while the other is includes right angle male headers. Due to spacing, the PTH version will also have a different silkscreen labels.
Both boards include a standard serial UART header seen on many USB-to-serial converters: <span STYLE="text-decoration:overline">RTS</span>/RXI/TXO/VCC/<span STYLE="text-decoration:overline">CTS</span>/GND. Depending on the version that you purchase, one will be PTH while the other includes right angle male headers. Due to spacing, the PTH version will also have slightly different silkscreen labels.

* <b><span STYLE="text-decoration:overline">RTS</span></b> / <b><span STYLE="text-decoration:overline">RT</b> &mdash; The Return to Send is an output and is used for hardware flow control in some serial interfaces. Unlike Tx and RX, this pin does not include logic level translation. This output is not critical for simple serial communication.
* <b><span STYLE="text-decoration:overline">RTS</span></b> / <b><span STYLE="text-decoration:overline">RT</b> &mdash; The Ready to Send is an output and is used for hardware flow control in some serial interfaces. This output is not critical for simple serial communication. If flow control is enabled, BlueSMiRF will drive its RTS low if its serial buffer is full (the radio is telling the host system to hold its horses).
* **RXI** / **RI** &mdash; The serial receive is an input. This input pin receives serial data from another serial device. Logic level circuitry is included on this pin. **It should be connected to the TX of the other device.**
* **TXO** / **TO** &mdash; The serial transmit is an output. This output pin sends serial data to another device. Logic level circuitry is included on this pin. **It should be connected to the RX of the other device.**
* **VCC**/ **V** / **3V3-5V** &mdash; This input voltage supply signal is routed through a AP2112K voltage regulator and brought down 3.3V for the ESP32. We will assume that it is attached to another device's standard serial port and it is providing power to the BlueSMiRF v2. As stated earlier, the recommended input voltage is between **3.3V to 5V**.
* <b><span STYLE="text-decoration:overline">CTS</span></b> / <b><span STYLE="text-decoration:overline">CT</span></b> &mdash; The Clear to Send is an input. CTS is another serial flow control signal. Unlike Tx and RX, this pin does not include logic level translation. Like RTS, it's not required for most, simple serial interfaces.
* <b><span STYLE="text-decoration:overline">CTS</span></b> / <b><span STYLE="text-decoration:overline">CT</span></b> &mdash; The Clear to Send is an input. CTS is another serial flow control signal. Like RTS, it's not required for most, simple serial interfaces. If flow control is enabled, BlueSMiRF will send data when its CTS pin is driven low (the host system is telling the radio that it's ready for more serial data).
* **GND** / **G** &mdash; The 0V reference voltage, common to any other device connected to the Bluetooth modem.

<div style="text-align: center;">
Expand Down Expand Up @@ -168,18 +168,12 @@ Both boards include a standard serial UART header seen on many USB-to-serial con
</table>
</div>


!!! warning
While the TX and RX pins have logic level circuitry, the <span style="text-decoration:overline">CTS</span> and <span style="text--decoration:overline">RTS</span> do not. Make sure to be careful when connecting the flow control pins to a 5V system.



### Button

The PAIR button is more than meets the eye. This button has more than one function depending on how long it is pushed down.

* **Short Push** &mdash; Press and hold the button down between **4 to 8 seconds** will initiate pairing with another Bluetooth device. During that period of time, the **Status** and **Connect** LEDs will slowly blink back and forth. When the BlueSMiRF V2 fails to discover any compatible devices, it will enter _Discoverable_ mode.
* **Long Push** &mdash; Press and hold the down for **more than 8 seconds** to set the ESP32 back to its factory default settings.
* **Short Push** &mdash; Press and hold the button down between **4 to 8 seconds** will initiate pairing with another Bluetooth device. During that period of time, the **Status** and **Connect** LEDs will slowly blink back and forth. When the BlueSMiRF v2 fails to discover any compatible devices, it will enter _Discoverable_ mode.
* **Long Push** &mdash; Press and hold the down for **more than 8 seconds** to set the ESP32 back to its factory default settings.

<div style="text-align: center;">
<table>
Expand All @@ -190,7 +184,7 @@ The PAIR button is more than meets the eye. This button has more than one functi
</div>

!!! note
Users can also set the BlueSMiRF v2 in bootloader mode. In this mode, you can update the firmware manually through serial using a command line interface. Users will need to hold down the PAIR button when the BlueSMiRF v2 is not powered. Applying power will set the microcontroller to bootloader mode.
Users can also set the BlueSMiRF v2 in bootloader mode. In this mode, you can update the firmware manually through serial using a command line interface. Users will need to hold down the PAIR button when the BlueSMiRF v2 is not powered. Applying power will put the microcontroller into bootloader mode.

For more information about using the button for each mode, check out the section about the [button control](../button/).

Expand Down
5 changes: 2 additions & 3 deletions docs/introduction.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@

The [SparkFun BlueSMiRF v2](https://www.sparkfun.com/products/24113) is a wireless Bluetooth&reg; serial link. This version of the popular BlueSMiRF uses the ESP32. 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 115200 baud can be passed seamlessly between two devices.
The [SparkFun BlueSMiRF v2](https://www.sparkfun.com/products/24113) is a wireless Bluetooth&reg; serial link. This version of the popular BlueSMiRF uses the ESP32. 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.

<center>
<div class="grid cards col-2" markdown>
Expand Down Expand Up @@ -338,11 +338,10 @@ For those using the PTH version, you will need to connect to the PTHs. You could

Depending on your setup or what you are doing, you may need the following as well.

* 2.5GHz WiFi Network for firmware updates
* 2.4GHz WiFi Network for firmware updates
* Smartphone with an Internet Service



### Suggested Reading

If you aren’t familiar with the following concepts, we also recommend checking out a few of these tutorials before continuing.
Expand Down

0 comments on commit 966ef45

Please sign in to comment.