Add notes and extra details

bboyho · bboyho · commit 59fcaa28184b · 2024-01-24T01:57:37.000-07:00
diff --git a/docs/bluesmirf-v2_to_smartphone.md b/docs/bluesmirf-v2_to_smartphone.md
@@ -1,4 +1,7 @@
-In this example, we will connect a BlueSMiRF v2 to a smartphone.
+!!! note
+    Bluetooth classic (Serial Port Profile or SPP) is primarily supported. This Bluetooth protocol is supported on Android phones, most desktops, and laptops. The BlueSMiRF v2 also supports the BLE protocol, available on all Apple phones.
+
+In this example, we will connect a BlueSMiRF v2 to a smartphone and send serial data using the Bluetooth classic protocol (also known as Serial Port Profile or SPP).
 
 The image below shows the Serial Basic (CH340, USB-C) connected to the BlueSMiRF v2 Header using M/F jumper wires. Headers were used to easily remove and reconnect the BlueSMiRF v2 with headers.
 
@@ -16,7 +19,7 @@ The image below shows the Serial Basic (CH340, USB-C) connected to the BlueSMiRF
 
 ### Download the Serial Bluetooth Terminal App
 
-Head to your smartphone's app store. In this case, we were on an Android smartphone and used Google Play Store to download the [**Serial Bluetooth Terminal** app](https://play.google.com/store/apps/details?id=de.kai_morich.serial_bluetooth_terminal&hl=en_US&gl=US&pli=1).
+Head to your smartphone's app store. In this case, we were on an Android smartphone and used Google Play Store to download the [**Serial Bluetooth Terminal** app](https://play.google.com/store/apps/details?id=de.kai_morich.serial_bluetooth_terminal&hl=en_US&gl=US&pli=1). This app is great for development, debugging, and general use when using the BlueSMiRF's SPP and BLE protocols.
 
 <div style="text-align: center"><a href="https://play.google.com/store/apps/details?id=de.kai_morich.serial_bluetooth_terminal&hl=en_US&gl=US&pli=1" class="md-button">Google Play: Serial Bluetooth Terminal</a></div>
 
diff --git a/docs/hardware_hookup.md b/docs/hardware_hookup.md
@@ -260,3 +260,17 @@ For boards that already include the footprint for a standard serial UART port, y
     </tr>
   </table>
 </div>
+
+!!! note
+    There are older boards that may have a serial port labeled as BlueSMiRF. You will need to wire the connection manually with jumper wires. One example is the SparkFun Arduino ProtoShield where the board uses the older BlueSMiRF pinout. There are jumpers that you can cut on the board and additional PTHs to rewire the pins if you decide to connect directly to the 1x6 header.
+
+    <div style="text-align: center;">
+    <table>
+      <tr style="vertical-align:middle;">
+       <td style="text-align: center; vertical-align: middle; border: solid 1px #cccccc;""><a href="https://cdn.sparkfun.com/assets/learn_tutorials/7/6/7/SparkFun_ProtoShield-TopView_SoftwareSerialUART.jpg"><img src="https://cdn.sparkfun.com/assets/learn_tutorials/7/6/7/SparkFun_ProtoShield-TopView_SoftwareSerialUART.jpg" width="300px" height="300px" alt="SparkFun Arduino ProtoShield Serial Port Highlighted"></a></td>
+      </tr>
+      <tr style="vertical-align:middle;">
+       <td style="text-align: center; vertical-align: middle; border: solid 1px #cccccc;"><i>SparkFun Arduino ProtoShield Serial Port Highlighted</i></td>
+      </tr>
+    </table>
+    </div>
diff --git a/docs/hardware_overview.md b/docs/hardware_overview.md
@@ -36,7 +36,7 @@ There is also a version with PTHs out in the wild and it is essentially the same
 
 ### ESP32-PICO-MINI-02
 
-The board includes the smaller ESP32-PICO-MINI-02 module from Espressif. The SparkFun BlueSMiRF v2 is perfect for short range applications that require point-to-point communication. We've written some firmware to allow serial UART data to be sent between two Bluetooth devices. The supported protocols include SPP and BLE. Testing a pair of BlueSMiRF V2s and we got about ~110 feet (~33m) in the SparkFun building. The included firmware also includes a set of AT commands to configure the ESP32. This includes the baud rate, flow control, LED mode, and Over-The-Air (OTA) updates over a 2.4GHz WiFi network to name a few. You can also manually reprogram the ESP32 module using the command line interface as well! Just make sure to connect Tx and Rx between the BlueSMiRF and a USB-to-serial converter.
+The board includes the smaller ESP32-PICO-MINI-02 module from Espressif. The SparkFun BlueSMiRF v2 is perfect for short range applications that require point-to-point communication. We've written some firmware to allow serial UART data to be sent between two Bluetooth devices. The supported protocols include SPP and BLE. Testing a pair of BlueSMiRF V2s and we got about ~110 feet (~33m) in the SparkFun building. The TX (10k) and RX (50k) buffers are also very large to allow for radio delays. The included firmware also includes a set of AT commands to configure the ESP32. This includes the baud rate, flow control, LED mode, and Over-The-Air (OTA) updates over a 2.4GHz WiFi network to name a few. You can also manually reprogram the ESP32 module using the command line interface as well! Just make sure to connect Tx and Rx between the BlueSMiRF and a USB-to-serial converter.
 
 <div style="text-align: center;">
   <table>
@@ -68,7 +68,7 @@ Power is broken out on the 1x6 header through the VCC and GND pins. The recommen
   </table>
 </div>
 
-The current and power consumption depends on what it's doing at the time. Here are some of our results after measuring the current and power consumption at 3.3V. The module can get warm to the touch when pushing serial traffic through.
+The current and power consumption depends on what it's doing at the time. Here are some of our results after measuring the current and power consumption at 3.3V. The module can get toasty when pushing serial traffic through but not scary-burn-you-hot.
 
 * Idle: 72mA / 238mW
 * Connected with no Serial Traffic: 75mA / 248mW
@@ -153,7 +153,24 @@ Both boards include a standard serial UART header seen on many USB-to-serial con
 
 
 !!! tip
-    For those that are connecting to the old school RS232 serial port, you will need a [RS232 to TTL converter](https://www.sparkfun.com/products/449) for higher voltages. The RS232 to TTL converter can handle the larger voltages designed for RS232.
+    For those that are connecting to the old school RS232 serial port, you will need a [RS232 to TTL converter](https://www.sparkfun.com/products/449) for higher voltages. The RS232 to TTL converter can handle larger voltages designed for RS232.
+
+    <div style="text-align: center;">
+      <table>
+        <tr style="vertical-align:middle;">
+         <td style="text-align: center; vertical-align: middle; border: solid 1px #cccccc;"><a href="https://www.sparkfun.com/products/449"><img src="https://cdn.sparkfun.com//assets/parts/1/4/9/00449-01a.jpg" width="200px" height="200px" alt="SparkFun RS232 Shifter - SMD"></a></td>
+        </tr>
+        <tr style="vertical-align:middle;">
+         <td style="text-align: left; vertical-align: middle; border: solid 1px #cccccc;"><a href="https://www.sparkfun.com/products/449"><b>SparkFun RS232 Shifter - SMD</b>
+         <br />
+         PRT-00449</a></td>
+        </tr>
+      </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.
 
 
 
@@ -245,15 +262,3 @@ Each version of the board is 38.1mm x 15.2mm. Note that the version with the hea
     </tr>
   </table>
 </div>
-
-
-
-
-
-<!-- -----------
-
-!!! note "What is a BlueSMiRF?"
-    The BlueSMiRF was a Bluetooth device that was included in SparkFun's catalog. The footprint consists of a 1x6 header for the serial UART and power pins. Note that the arrangement of the header pins can be different from USB-to-serial converters (i.e. FTDI Serial Breakout Boards and CH340 Serial Basic Boards).
-
-
--->
diff --git a/docs/introduction.md b/docs/introduction.md
@@ -397,5 +397,16 @@ If you aren’t familiar with the following concepts, we also recommend checking
       <b>How to Solder: Through-Hole Soldering</b>
     </a>
 
-    <!-- ----------WHITE SPACE BETWEEN GRID CARDS---------- -->
+<!-- ----------WHITE SPACE BETWEEN GRID CARDS---------- -->
+-   <a href="https://learn.sparkfun.com/tutorials/logic-levels">
+      <figure markdown>
+        <img src="https://cdn.sparkfun.com/assets/learn_tutorials/6/2/Input_Output_Logic_Level_Tolerances_v3.png?_gl=1*647ace*_ga*MTYwMjY5MTgyMy4xNzAwMjQzOTQx*_ga_T369JS7J9N*MTcwNjA3Njc2Ni4xODEuMS4xNzA2MDc5MDc2LjMzLjAuMA.."style="width:264px; height:148px; object-fit:contain;" alt="Logic Levels">
+      </figure>
+    </a>
+
+    ---
+
+    <a href="https://learn.sparkfun.com/tutorials/logic-levels">
+      <b>Logic Levels</b>
+    </a>
 </div>
