Added schematics to boards

docs/source/boards/iot-bus-canbus.rst

@@ -15,25 +15,36 @@ CAN Bus
     <p style="clear: both;">  
 
 
-This IoT-Bus module provides CAN Bus capability.
+  The IoT-Bus CAN Bus module offers a transceiver that enables you to use the onboard ESP32 CAN controller. You can
+  connect the terminals to any required connection.
 
-`See it in the oddWires store... <http://www.oddwires.com/iot-bus-esp32-can-bus/>`__
-
-.. contents:: Contents
-    :local:
+`Buy it in the oddWires store... <http://www.oddwires.com/iot-bus-esp32-can-bus/>`__
 
 Pins Used
 ---------
 
 .. list-table::
   :header-rows:  1
-
+
+  * - IOT-Bus Pin
+    - Description
   * - 4
-    - CAN BUs TX
+    - CAN Bus RXD
   * - 5
-    - CAN Bus RX
+    - CAN Bus TXD
+
+.. note:: CAN Bus cannot be used at the same time as LoRa. 
+
+Schematic
+---------
+
+.. image:: ../_static/iot-bus-esp32-can-bus-schematic.png
+    :align: left
+    :alt: IoT-Bus Io Schematic
+    :scale: 10%
+    :target: ../_static/iot-bus-esp32-can-bus-schematic.png
 
-.. begin_platforms
+Click image to enlarge.
 
 Platforms
 ---------

docs/source/boards/iot-bus-display.rst

@@ -13,12 +13,12 @@
 
     <p style="clear: both;">  
 
-This IoT-Bus is the display modules...
+This a nice 2.4" 320x240 QVGA TFT Touch Display offering plug and play display output and 
+touch sensing together with a 4-bit SDMMC SD Card. We picked 2.4" over 2.8" as it has a crisper 
+display at 320 x 240 resolution and its slightly smaller size helps in IoT applications. Designed primarily for 
+development use it has an IoT-Bus socket at the side for easy access.  
 
-`See it in the oddWires store... <http://www.oddwires.com/iot-bus-qvga-2-4-tft-touch-display/>`__
-
-.. contents:: Contents
-    :local:
+`Buy it in the oddWires store... <http://www.oddwires.com/iot-bus-qvga-2-4-tft-touch-display/>`__
 
 Pins Used
 ---------
@@ -28,13 +28,80 @@ Pins Used
 
   * - IOT-Bus Pin
     - Description
-  * - X
-    - TBD
+  * - 2
+    - DAT0 (SD Card)
+  * - 4
+    - DAT1 (SD Card)  
+  * - 5
+    - SS (TFT) 
+  * - 12
+    - DAT2 (SD Card)  
+  * - 13
+    - DAT2 (SD Card)   
+  * - 14
+    - CLK (SD Card)  
+  * - 15
+    - CMD (SD)  
+  * - 16
+    - SS (Touch Screen) 
+  * - 17
+    - IRQ (Touch Screen) 
+  * - 18
+    - SCK (TFT)               
+  * - 19
+    - MISO (TFT) 
+  * - 23
+    - MOSI (TFT) 
+  * - 27
+    - DC (TFT) 
+  * - 33
+    - Backlight (TFT) - you will not see anything if you do not turn on the backlight!
+  * - EN
+    - RESET (TFT)
+  * - 3V3
+    - Power
+  * - GND
+    - Ground
+
+.. note:: 
+  This board uses a lot of pins if you are using everything. 
+  If you are not using the SDCard then those pins may be freely used. 
+  You can also use the SCard in one pin mode freeing up DAT1, DAT2 and DAT3. 
+  If you are not using the touch capabilities of the module then you can utilize those pins. 
+  IRQ is not used by the forked version of the XPT2046 library freeing up pin 17.
+  The current versions of the IoT-Bus CAN Bus and LoRa modules cannot be used with this display.  
+
+Schematic
+---------
+
+.. image:: ../_static/iot-bus-tft-display-v1.0-schematic.png
+    :align: left
+    :alt: IoT-Bus Display Schematic
+    :scale: 10%
+    :target: ../_static/iot-bus-tft-display-v1.0-schematic.png
+
+Libraries
+---------
+
+.. list-table::
+    :header-rows:  1
+
+    * - Name
+      - Description
+      - Github Repository
+
+    * - TFTeSPI
+      - Bodmer's TFT library has been forked to setup correct user defaults.
+      - `TFTeSPI <https://github.com/iot-bus/TFT_eSPI>`_
+
+    * - XPT2046_Touchscreen
+      - Paul Stoffgren's XPT2046_Touchscreen library has been forked to disable interrupts and map raw points to 320 x 240.
+      - `XPT2046_Touchscreen <https://github.com/iot-bus/XPT2046_Touchscreen>`_     
 
-.. begin_platforms
 
 Platforms
 ---------
+
 .. list-table::
     :header-rows:  1
 
@@ -46,6 +113,7 @@ Platforms
 
 Frameworks
 ----------
+
 .. list-table::
     :header-rows:  1
 

docs/source/boards/iot-bus-io.rst

@@ -13,13 +13,14 @@ Io
 
     <p style="clear: both;">
 
-This IoT-Bus module is the foundation of the IoT-Bus system.
-`See it in the oddWires store... <https://www.oddwires.com/io/>`__
-
-.. contents:: Contents
-    :local:
+Very small and breadboard-friendly with option of male, female or both (stackable headers). Includes a dual-core 240 MHz ESP32 with 
+WiFi and Bluetooth. You can use the WiFi both in station (device) mode and access point mode. It includes traditional Bluetooth as well as BLE 4.0. 
 
+On-board is a 3.3V regulator and a battery charging device that enabled you to switch between using USB or battery power. The battery
+is automatically charged in the USB is plugged in. A status light shows if it is charging or fully charged. All ESP32 pins bar the flash pins are exposed 
+and available for your use.
 
+`Buy it in the oddWires store... <https://www.oddwires.com/io/>`__
 
 Pins Used
 ---------
@@ -32,7 +33,21 @@ Pins Used
   * - 5
     - On-board LED
 
-.. begin_platforms
+.. note:: Pin 5 is the default SS for the vSPI interface and provided you are not using them at the same time it will work just fine for either purpose.
+
+Schematic
+---------
+
+.. image:: ../_static/iot-bus-io-v1.0d-schematic.png
+    :align: left
+    :alt: IoT-Bus Io Schematic
+    :scale: 10%
+    :target: ../_static/iot-bus-io-v1.0d-schematic.png
+
+.. raw:: html
+
+    <p style="clear: both;">     
+
 
 Platforms
 ---------

docs/source/boards/iot-bus-jtag.rst

@@ -16,13 +16,16 @@ JTAG
 This IoT-Bus module provides JTAG debugging for the
 :ref:`iot-bus-io` and :ref:`iot-bus-proteus`
 boards (can be used with other boards too, see wiring connections below).
-The board uses the FT232H to provide a USB controller with JTAG
-support. Both debugging and flashing is possible using this port.
 
-`See it in the oddWires store... <http://www.oddwires.com/iot-bus-esp32-jtag/>`__
+Both the Io and Proteus processor boards can accept a specially designed JTAG board offering 
+hardware debugging. Our JTAG board is based on the FT232H and it enables comprehensive JTAG debugging support. 
+You can use OpenOCD and GDB in combination to use it but our recommendation is to use PlatformIO. 
+PlatformIO has taken away all the hard work of configuring OpenOCD and GDB. You simply select it is your debugging choice as described 
+`here <https://docs.platformio.org/en/latest/plus/debug-tools/iot-bus-jtag.html>`_. 
+Take a look at how easy it is to use with `PlatformIO's Unified Debugger <https://docs.platformio.org/en/latest/plus/debugging.html>`_. 
+Just plug it in and start debugging! No more printing to the terminal!
 
-.. contents:: Contents
-    :local:
+`Buy it in the oddWires store... <http://www.oddwires.com/iot-bus-esp32-jtag/>`__
 
 PlatformIO Configuration
 ------------------------
@@ -40,37 +43,37 @@ platformio.ini:
 Pins Used
 ---------
 
-You only need to make any connections if you are using the JTAG modules outside of the IoT-BUs system.
-
 .. list-table::
   :header-rows:  1
 
   * - IOT-Bus JTAG Pin
     - Board JTAG Pin
-    - Description
-  * - 2
-    - VCC
+  * - 3V3
     - Positive Supply Voltage — Power supply for JTAG interface drivers
-  * - 1
-    - GND
-    - Digital ground
+  * - GND
+    - GND - Digital Ground    
   * - 12
-    - TDI
-    - Test Data In pin
+    - TDI - Test Data In pin   
   * - 14
-    - TMS
-    - Test Mode State pin
+    - TMS - Test Mode State pin  
   * - 15
-    - TCK
-    - JTAG Return Test ClocK
+    - TCK - JTAG Return Test Clock    
   * - 13
-    - TDO
-    - Test Data Out pin
-  * - 3
+    - TDO - Test Data Out pin   
+  * - EN
     - RESET
-    - Connect this pin to the (active low) reset input of the target CPU
 
-.. begin_platforms
+
+Schematic
+---------
+
+.. image:: ../_static/iot-bus-jtag-v1.0-schematic.png
+    :align: left
+    :alt: IoT-Bus Io Schematic
+    :scale: 10%
+    :target: ../_static/iot-bus-jtag-v1.0-schematic.png
+
+Click image to enlarge.
 
 Platforms
 ---------

docs/source/boards/iot-bus-lora.rst

@@ -14,11 +14,20 @@ LoRa
     <p style="clear: both;">  
 
 
-This IoT-Bus module utilizes the Hope RFM95 to offer low-cost, LoRa radio transmission and a Wi-Fi/LoRa gateway.
-The RFM95W transceivers  feature  the  LoRaTM  long range modem that provides ultra-long range spread spectrum communication and high interference immunity whilst minimizing current consumption.
-
-Using Hope RF’s patented LoRaTM modulation technique RFM95W can achieve a sensitivity of over -148dBm using a low cost crystal and bill of materials. The high sensitivity combined with the integrated +20 dBm power amplifier yields  industry  leading  link  budget  making  it optimal for any application requiring range or robustness. LoRaTM also provides significant advantages in both blocking and selectivity over conventional modulation techniques, solving the traditional design compromise between range, interference immunity and energy consumption.
-These devices also support high performance (G)FSK modes for systems including WMBus, IEEE802.15.4g. The RFM95W deliver exceptional phase noise, selectivity, receiver linearity  and  IIP3  for  significantly lower  current consumption than competing devices.
+This IoT-Bus module utilizes the Hope RFM95 to offer low-cost, LoRa radio transmission and a Wi-Fi/LoRa gateway. 
+It uses the correct 915 MHz rather than the 433 MHz european standard often found.
+The RFM95W transceivers feature the LoRa long range modem that provides ultra-long range spread spectrum 
+communication and high interference immunity whilst minimizing current consumption.
+
+Using Hope RF’s patented LoRa modulation technique RFM95W can achieve a sensitivity of over -148dBm using a 
+low cost crystal and bill of materials. The high sensitivity combined with the integrated +20 dBm power 
+amplifier yields industry-leading link budget  making it optimal for any application requiring range or robustnes. 
+
+LoRa™ also provides significant advantages in both blocking and selectivity over conventional modulation techniques, 
+solving the traditional design compromise between range, interference immunity and energy consumption.
+These devices also support high performance (G)FSK modes for systems including WMBus, IEEE802.15.4g. 
+The RFM95W deliver exceptional phase noise, selectivity, receiver linearity and IIP3 
+for significantly lower  current consumption than competing devices.
 
 Features of RF Transceiver LoRa Module RFM95W:
 
@@ -50,10 +59,7 @@ Potential Applications of the RF Transceiver Module RFM95W:
 * Industrial Monitoring and Control
 * Long range Irrigation Systems
 
-`See it in the oddWires store... <http://www.oddwires.com/iot-bus-lora/>`__
-
-.. contents:: Contents
-    :local:
+`Buy it in the oddWires store... <http://www.oddwires.com/iot-bus-lora/>`__
 
 Pins Used
 ---------
@@ -62,35 +68,72 @@ Pins Used
   :header-rows:  1
 
   *  - IOT-Bus Pin
-    - Description
-  *  - X
-    - TBD
+     - Description 
+  *  - 4
+     - DIO2
+  *  - 5
+     - SS
+  *  - 16
+     - DIO1
+  *  - 17
+     - LoRa RESET
+  *  - 18
+     - SCK
+  *  - 19
+     - MISO
+  *  - 23
+     - MOSI
+  *  - 32
+     - DIO5(J)
+  *  - 33
+     - DIO4(J)
+  *  - 34
+     - DIO3(J)
+  *  - 35
+     - DIO0(J)
+  *  - 3V3
+     - Power   
+  *  - GND
+     - Digital Ground
+
+.. note:: LoRa cannot be used at the same time as CAN Bus.     
+
+Schematic
+---------
 
-.. begin_platforms
+.. image:: ../_static/iot-bus-lora-v1.0-schematic.png
+    :align: left
+    :alt: IoT-Bus Io Schematic
+    :scale: 10%
+    :target: ../_static/iot-bus-lora-v1.0-schematic.png
+
+.. raw:: html
+
+    <p style="clear: both;">     
 
 Platforms
 ---------
 .. list-table::
     :header-rows:  1
 
     *  - Name
-      - Description
+       - Description
 
     *  - :ref:`platform_espressif32`
-      - Espressif Systems is a privately held fabless semiconductor company. They provide wireless communications and Wi-Fi chips which are widely used in mobile devices and the Internet of Things applications.
+       - Espressif Systems is a privately held fabless semiconductor company. They provide wireless communications and Wi-Fi chips which are widely used in mobile devices and the Internet of Things applications.
 
 Frameworks
 ----------
 .. list-table::
     :header-rows:  1
 
     *  - Name
-      - Description
+       - Description
 
     *  - :ref:`framework_arduino`
-      - Arduino Wiring-based Framework allows writing cross-platform software to control devices attached to a wide range of Arduino boards to create all kinds of creative coding, interactive objects, spaces or physical experiences.
+       - Arduino Wiring-based Framework allows writing cross-platform software to control devices attached to a wide range of Arduino boards to create all kinds of creative coding, interactive objects, spaces or physical experiences.
 
     *  - :ref:`framework_espidf`
-      - Espressif IoT Development Framework. Official development framework for ESP32.
+       - Espressif IoT Development Framework. Official development framework for ESP32.