oddWires IOT-Bus JTAG

This IoT-Bus module provides JTAG debugging for the oddWires IoT-Bus Io and oddWires 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. Official reference can be found here.

Configuration

You can configure debugging tool using debug_tool option in “platformio.ini” (Project Configuration File):

[env:myenv]
platform = ...
board = ...
debug_tool = iot-bus-jtag

If you would like to use this tool for firmware uploading, please change upload protocol:

[env:myenv]
platform = ...
board = ...
debug_tool = iot-bus-jtag
upload_protocol = iot-bus-jtag

More options:

• Debugging options

• Upload options

Drivers

Windows

• Step-by-step guide: Drivers, Zadig, Wiring

• Video tutorial

Mac

macOS contains default FTDIUSBSerialDriver driver which conflicts with debug tools which are based on this chip. FTDI Chip company recommends removing this default driver from a system. Everything should work after system rebooting. See detailed instruction in official application note (Page 16, Section 4: Uninstalling FTDI Drivers on OS X) AN134: FTDI Drivers Installation guide for MAC OS X

Linux

Please install “udev” rules 99-platformio-udev.rules. If you already installed them before, please check that your rules are up-to-date or repeat steps.

Wiring Connections

IOT-Bus JTAG Pin	Board JTAG Pin	Description
3V3	VCC	Positive Supply Voltage — Power supply for JTAG interface drivers
GND	GND	Digital ground
12	TDI	Test Data In pin
14	TMS	Test Mode State pin
13	TCK	JTAG Return Test Clock
15	TDO	Test Data Out pin
EN	RESET	Connect this pin to the (active low) reset input of the target CPU (EN for ESP32)

Platforms

Name	Description
Espressif	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

Name	Description
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
ESP-IDF	ESP-IDF is the official development framework for the ESP32 and ESP32-S Series SoCs.

Boards

Note

For more detailed board information please scroll tables below by horizontal.

Name	Platform	Debug	MCU	Frequency	Flash	RAM
AI Thinker ESP32-CAM	Espressif	External	ESP32	240MHz	4MB	320KB
ALKS ESP32	Espressif	External	ESP32	240MHz	4MB	320KB
AZ-Delivery ESP-32 Dev Kit C V4	Espressif	External	ESP32	240MHz	4MB	520KB
Adafruit ESP32 Feather	Espressif	External	ESP32	240MHz	4MB	320KB
Adafruit ESP32-S2 Feather Development Board	Espressif	External	ESP32S2	240MHz	4MB	320KB
Adafruit Feather ESP32 V2	Espressif	External	ESP32	240MHz	8MB	320KB
Adafruit Feather ESP32-S2 TFT	Espressif	External	ESP32S2	240MHz	4MB	320KB
Adafruit Feather ESP32-S3 2MB PSRAM	Espressif	External	ESP32S3	240MHz	4MB	320KB
Adafruit Feather ESP32-S3 No PSRAM	Espressif	External	ESP32S3	240MHz	8MB	320KB
Adafruit Feather ESP32-S3 TFT	Espressif	External	ESP32S3	240MHz	4MB	320KB
Adafruit FunHouse	Espressif	External	ESP32S2	240MHz	4MB	320KB
Adafruit ItsyBitsy ESP32	Espressif	External	ESP32	240MHz	8MB	320KB
Adafruit MagTag 2.9	Espressif	External	ESP32S2	240MHz	4MB	320KB
Adafruit Metro ESP32-S2	Espressif	External	ESP32S2	240MHz	4MB	320KB
Adafruit QT Py ESP32	Espressif	External	ESP32	240MHz	8MB	320KB
Adafruit QT Py ESP32-C3	Espressif	External	ESP32C3	160MHz	4MB	320KB
Adafruit QT Py ESP32-S2	Espressif	External	ESP32S2	240MHz	4MB	320KB
Adafruit QT Py ESP32-S3 No PSRAM	Espressif	External	ESP32S3	240MHz	8MB	320KB
Ai-Thinker ESP-C3-M1-I-Kit	Espressif	External	ESP32C3	160MHz	4MB	320KB
Ai-Thinker NodeMCU-32S2 (ESP-12K)	Espressif	External	ESP32S2	240MHz	4MB	320KB
AirM2M CORE ESP32C3	Espressif	External	ESP32C3	160MHz	4MB	320KB
BPI-Leaf-S3	Espressif	External	ESP32S3	240MHz	8MB	320KB
Blinker WiFiduino32S3	Espressif	External	ESP32S3	240MHz	8MB	320KB
Blinker WiFiduinoV2 (ESP32-C3)	Espressif	External	ESP32C3	160MHz	4MB	320KB
Briki ABC (MBC-WB) - ESP32	Espressif	External	ESP32	240MHz	3.25MB	320KB
Briki MBC-WB - ESP32	Espressif	External	ESP32	240MHz	3.25MB	320KB
Connaxio’s Espoir	Espressif	External	ESP32	240MHz	4MB	320KB
Cytron Maker Feather AIoT S3	Espressif	External	ESP32S3	240MHz	8MB	320KB
D-duino-32	Espressif	External	ESP32	240MHz	4MB	320KB
DFRobot Beetle ESP32-C3	Espressif	External	ESP32C3	160MHz	4MB	320KB
DFRobot Firebeetle 2 ESP32-S3	Espressif	External	ESP32S3	240MHz	4MB	320KB
DOIT ESP32 DEVKIT V1	Espressif	External	ESP32	240MHz	4MB	320KB
DOIT ESPduino32	Espressif	External	ESP32	240MHz	4MB	320KB
Deneyap Kart	Espressif	External	ESP32	240MHz	4MB	320KB
Deneyap Kart 1A	Espressif	External	ESP32	240MHz	4MB	320KB
Deneyap Kart 1A v2	Espressif	External	ESP32S3	240MHz	4MB	320KB
Deneyap Kart G	Espressif	External	ESP32C3	160MHz	4MB	320KB
Deneyap Mini	Espressif	External	ESP32S2	240MHz	4MB	320KB
Deneyap Mini v2	Espressif	External	ESP32S2	240MHz	4MB	320KB
Deparment of Alchemy MiniMain ESP32-S2	Espressif	External	ESP32S2	240MHz	4MB	320KB
Dongsen Tech Pocket 32	Espressif	External	ESP32	240MHz	4MB	320KB
ESP32 FM DevKit	Espressif	External	ESP32	240MHz	4MB	320KB
ESP32 Pico Kit	Espressif	External	ESP32	240MHz	4MB	320KB
ESP32S3 CAM LCD	Espressif	External	ESP32S3	240MHz	16MB	320KB
ESP32vn IoT Uno	Espressif	External	ESP32	240MHz	4MB	320KB
ESPectro32	Espressif	External	ESP32	240MHz	4MB	320KB
ESPino32	Espressif	External	ESP32	240MHz	4MB	320KB
EspinalLab ATMegaZero ESP32-S2	Espressif	External	ESP32S2	240MHz	16MB	320KB
Espressif ESP-WROVER-KIT	Espressif	On-board	ESP32	240MHz	4MB	320KB
Espressif ESP32 Dev Module	Espressif	External	ESP32	240MHz	4MB	320KB
Espressif ESP32-C3-DevKitM-1	Espressif	External	ESP32C3	160MHz	4MB	320KB
Espressif ESP32-S2-Kaluga-1 Kit	Espressif	External	ESP32S2	240MHz	4MB	320KB
Espressif ESP32-S2-Saola-1	Espressif	External	ESP32S2	240MHz	4MB	320KB
Espressif ESP32-S3-Box	Espressif	External	ESP32S3	240MHz	16MB	320KB
Espressif ESP32-S3-DevKitC-1-N8 (8 MB QD, No PSRAM)	Espressif	On-board	ESP32S3	240MHz	8MB	320KB
FireBeetle-ESP32	Espressif	External	ESP32	240MHz	16MB	520KB
Franzininho WiFi	Espressif	External	ESP32S2	240MHz	4MB	320KB
Franzininho WiFi Board	Espressif	External	ESP32S2	240MHz	4MB	320KB
Franzininho WiFi MSC	Espressif	External	ESP32S2	240MHz	4MB	320KB
Frog Board ESP32	Espressif	External	ESP32	240MHz	4MB	320KB
HONEYLemon	Espressif	External	ESP32	240MHz	4MB	320KB
Heltec WiFi LoRa 32	Espressif	External	ESP32	240MHz	4MB	320KB
Heltec WiFi LoRa 32 (V2)	Espressif	External	ESP32	240MHz	8MB	320KB
Heltec Wireless Stick	Espressif	External	ESP32	240MHz	8MB	320KB
Hornbill ESP32 Dev	Espressif	External	ESP32	240MHz	4MB	320KB
Hornbill ESP32 Minima	Espressif	External	ESP32	240MHz	4MB	320KB
IoTaaP Magnolia	Espressif	External	ESP32	240MHz	4MB	320KB
LOGISENSES Senses Weizen	Espressif	External	ESP32	240MHz	4MB	320KB
Lion:Bit Dev Board	Espressif	External	ESP32	240MHz	4MB	320KB
MH ET LIVE ESP32DevKIT	Espressif	External	ESP32	240MHz	4MB	320KB
MH ET LIVE ESP32MiniKit	Espressif	External	ESP32	240MHz	4MB	320KB
MakerAsia KB32-FT	Espressif	External	ESP32	240MHz	4MB	320KB
Munich Labs RedPill ESP32-S3	Espressif	External	ESP32S3	240MHz	8MB	320KB
Node32s	Espressif	External	ESP32	240MHz	4MB	320KB
NodeMCU-32S	Espressif	External	ESP32	240MHz	4MB	320KB
OLIMEX ESP32-DevKit-LiPo	Espressif	External	ESP32	240MHz	4MB	320KB
OLIMEX ESP32-EVB	Espressif	External	ESP32	240MHz	4MB	320KB
OLIMEX ESP32-GATEWAY	Espressif	External	ESP32	240MHz	4MB	320KB
Pycom LoPy	Espressif	External	ESP32	240MHz	4MB	320KB
Pycom LoPy4	Espressif	External	ESP32	240MHz	4MB	1.25MB
Pycom WiPy3	Espressif	External	ESP32	240MHz	4MB	1.25MB
SG-O AirMon	Espressif	External	ESP32	240MHz	4MB	320KB
SQFMI Watchy v2.0	Espressif	External	ESP32	240MHz	4MB	320KB
Seeed Studio XIAO ESP32C3	Espressif	External	ESP32C3	160MHz	4MB	320KB
Silicognition wESP32	Espressif	External	ESP32	240MHz	4MB	320KB
Smart Bee Motion	Espressif	External	ESP32S2	240MHz	4MB	320KB
Smart Bee Motion Mini	Espressif	External	ESP32C3	160MHz	4MB	320KB
Smart Bee Motion S3	Espressif	External	ESP32S3	240MHz	8MB	320KB
Smart Bee S3	Espressif	External	ESP32S3	240MHz	8MB	320KB
SparkFun ESP32 IoT RedBoard	Espressif	External	ESP32	240MHz	4MB	320KB
SparkFun ESP32 Thing	Espressif	External	ESP32	240MHz	4MB	320KB
SparkFun ESP32 Thing Plus	Espressif	External	ESP32	240MHz	16MB	320KB
SparkFun ESP32 Thing Plus C	Espressif	External	ESP32	240MHz	16MB	320KB
SparkFun ESP32-S2 Thing Plus	Espressif	External	ESP32S2	240MHz	4MB	320KB
SparkFun LoRa Gateway 1-Channel	Espressif	External	ESP32	240MHz	4MB	320KB
TAMC DPU ESP32	Espressif	External	ESP32	240MHz	8MB	320KB
TAMC Termod S3	Espressif	External	ESP32S3	240MHz	8MB	320KB
TTGO LoRa32-OLED V1	Espressif	External	ESP32	240MHz	4MB	320KB
TTGO LoRa32-OLED V2	Espressif	External	ESP32	240MHz	4MB	320KB
TTGO LoRa32-OLED v2.1.6	Espressif	External	ESP32	240MHz	4MB	320KB
TTGO T-Beam	Espressif	External	ESP32	240MHz	4MB	1.25MB
TTGO T-OI PLUS RISC-V ESP32-C3	Espressif	External	ESP32C3	160MHz	4MB	320KB
TTGO T1	Espressif	External	ESP32	240MHz	4MB	320KB
TTGO T7 V1.4 Mini32	Espressif	External	ESP32	240MHz	4MB	1.25MB
Trueverit ESP32 Universal IoT Driver	Espressif	External	ESP32	240MHz	4MB	320KB
Trueverit ESP32 Universal IoT Driver MK II	Espressif	External	ESP32	240MHz	4MB	320KB
Trueverit ESP32 Universal IoT Driver MK III	Espressif	External	ESP32	240MHz	4MB	320KB
Unexpected Maker FeatherS2	Espressif	External	ESP32S2	240MHz	16MB	320KB
Unexpected Maker FeatherS2 Neo	Espressif	External	ESP32S2	240MHz	4MB	320KB
Unexpected Maker FeatherS3	Espressif	External	ESP32S3	240MHz	16MB	320KB
Unexpected Maker PROS3	Espressif	External	ESP32S3	240MHz	16MB	320KB
Unexpected Maker RMP	Espressif	External	ESP32S2	240MHz	4MB	320KB
Unexpected Maker TinyS2	Espressif	External	ESP32S2	240MHz	4MB	320KB
Unexpected Maker TinyS3	Espressif	External	ESP32S3	240MHz	8MB	320KB
VintLabs ESP32 Devkit	Espressif	External	ESP32	240MHz	4MB	320KB
WEMOS D1 MINI ESP32	Espressif	External	ESP32	240MHz	4MB	320KB
WEMOS D1 R32	Espressif	External	ESP32	240MHz	4MB	320KB
WEMOS LOLIN C3 Mini	Espressif	External	ESP32C3	160MHz	4MB	320KB
WEMOS LOLIN D32	Espressif	External	ESP32	240MHz	4MB	320KB
WEMOS LOLIN D32 PRO	Espressif	External	ESP32	240MHz	4MB	320KB
WEMOS LOLIN S2 Mini	Espressif	External	ESP32S2	240MHz	4MB	320KB
WEMOS LOLIN S2 PICO	Espressif	External	ESP32S2	240MHz	4MB	320KB
WEMOS LOLIN S3	Espressif	External	ESP32S3	240MHz	16MB	320KB
WEMOS LOLIN32	Espressif	External	ESP32	240MHz	4MB	320KB
WeMos WiFi and Bluetooth Battery	Espressif	External	ESP32	240MHz	4MB	320KB
Wireless-Tag WT32-ETH01 Ethernet Module	Espressif	External	ESP32	240MHz	4MB	320KB
XinaBox CW02	Espressif	External	ESP32	240MHz	4MB	320KB
microS2	Espressif	External	ESP32S2	240MHz	16MB	320KB
oddWires IoT-Bus Io	Espressif	External	ESP32	240MHz	4MB	320KB
oddWires IoT-Bus Proteus	Espressif	External	ESP32	240MHz	4MB	320KB
uPesy ESP32 Wroom DevKit	Espressif	External	ESP32	240MHz	4MB	320KB
uPesy ESP32 Wrover DevKit	Espressif	External	ESP32	240MHz	4MB	320KB
unPhone 7	Espressif	External	ESP32	240MHz	4MB	320KB
unPhone 8	Espressif	External	ESP32S3	240MHz	7.94MB	2.31MB
unPhone 9	Espressif	External	ESP32S3	240MHz	7.94MB	8.31MB