CMSIS-DAP_compatible_wireless_debugger_for_various_wireless-

<p align="center"><img src="https://user-images.githubusercontent.com/17078589/120061980-49274280-c092-11eb-9916-4965f6c48388.png"/></p>  [](https://github.com/windowsair/wireless-esp8266-dap/actions?query=branch%3Amaster) master　 [](https://github.com/windowsair/wireless-esp8266-dap/actions?query=branch%3Adevelop) develop [](https://github.com/windowsair/wireless-esp8266-dap/LICENSE)　[](https://github.com/windowsair/wireless-esp8266-dap/pulls)　[](https://github.com/windowsair/wireless-esp8266-dap) [中文](README_CN.md) ## Introduce Wireless debugging with ***only one ESP Chip*** ! Realized by USBIP and CMSIS-DAP protocol stack. > 👉 5m range, 100kb size firmware(Hex) earse and download test: <p align="center"><img src="https://user-images.githubusercontent.com/17078589/120925694-4bca0d80-c70c-11eb-91b7-ffa54770faea.gif"/></p> ---- For Keil users, we now also support [elaphureLink](https://github.com/windowsair/elaphureLink). No need for usbip to start your wireless debugging! ## Feature 1. SoC Compatibility - [x] ESP8266/8285 - [x] ESP32 - [x] ESP32C3 - [x] ESP32S3 2. Debug Communication Mode - [x] SWD - [x] JTAG 3. USB Communication Mode - [x] USB-HID - [x] WCID & WinUSB (Default) 4. Debug Trace (Uart) - [x] Uart TCP Bridge 5. More.. - [x] SWD protocol based on SPI acceleration (Up to 40MHz) - [x] Support for [elaphureLink](https://github.com/windowsair/elaphureLink), fast Keil debug without drivers - [x] Support for [elaphure-dap.js](https://github.com/windowsair/elaphure-dap.js), online ARM Cortex-M firmware flash - [x] Support for OpenOCD/pyOCD - [x] ... ## Link your board ### WIFI The default connected WIFI SSID is `DAP` or `OTA` , password `12345678` Support for specifying multiple possible WAP. It can be added here: [wifi_configuration.h](main/wifi_configuration.h) You can also specify your IP in the above file (We recommend using the static address binding feature of the router).  There is built-in ipv4 only mDNS server. You can access the device using `dap.local`. > The mDNS in ESP8266 only supports ipv4.  ### Debugger <details> <summary>ESP8266</summary> | SWD | | |----------------|--------| | SWCLK | GPIO14 | | SWDIO | GPIO13 | | TVCC | 3V3 | | GND | GND | -------------- | JTAG | | |--------------------|---------| | TCK | GPIO14 | | TMS | GPIO13 | | TDI | GPIO4 | | TDO | GPIO16 | | nTRST \(optional\) | GPIO0\* | | nRESET | GPIO5 | | TVCC | 3V3 | | GND | GND | -------------- | Other | | |--------------------|---------------| | LED\_WIFI\_STATUS | GPIO15 | | Tx | GPIO2 | | Rx | GPIO3 (U0RXD) | > Rx and Tx is used for uart bridge, not enabled by default. </details> <details> <summary>ESP32</summary> | SWD | | |----------------|--------| | SWCLK | GPIO14 | | SWDIO | GPIO13 | | TVCC | 3V3 | | GND | GND | -------------- | JTAG | | |--------------------|---------| | TCK | GPIO14 | | TMS | GPIO13 | | TDI | GPIO18 | | TDO | GPIO19 | | nTRST \(optional\) | GPIO25 | | nRESET | GPIO26 | | TVCC | 3V3 | | GND | GND | -------------- | Other | | |--------------------|---------------| | LED\_WIFI\_STATUS | GPIO27 | | Tx | GPIO23 | | Rx | GPIO22 | > Rx and Tx is used for uart bridge, not enabled by default. </details> <details> <summary>ESP32C3</summary> | SWD | | |----------------|--------| | SWCLK | GPIO6 | | SWDIO | GPIO7 | | TVCC | 3V3 | | GND | GND | -------------- | JTAG | | |--------------------|---------| | TCK | GPIO6 | | TMS | GPIO7 | | TDI | GPIO9 | | TDO | GPIO8 | | nTRST \(optional\) | GPIO4 | | nRESET | GPIO5 | | TVCC | 3V3 | | GND | GND | -------------- | Other | | |--------------------|---------------| | LED\_WIFI\_STATUS | GPIO10 | | Tx | GPIO19 | | Rx | GPIO18 | > Rx and Tx is used for uart bridge, not enabled by default. </details> <details> <summary>ESP32S3</summary> | SWD | | |----------------|--------| | SWCLK | GPIO12 | | SWDIO | GPIO11 | | TVCC | 3V3 | | GND | GND | -------------- | JTAG | | |--------------------|--------| | TCK | GPIO12 | | TMS | GPIO11 | | TDI | GPIO10 | | TDO | GPIO9 | | nTRST \(optional\) | GPIO14 | | nRESET | GPIO13 | | TVCC | 3V3 | | GND | GND | </details> ---- ## Hardware Reference Only a hardware reference for the ESP8266 is currently available. Here we provide a simple example for reference:  ***Alternatively, you can connect directly with wires as we gave at the beginning, without additional circuits.*** In addition, a complete hardware reference design is available from contributors, see [circuit](circuit) ------ ## Build And Flash You can build locally or use Github Action to build online and then download firmware to flash. ### Build with Github Action Online See: [Build with Github Action](https://github.com/windowsair/wireless-esp8266-dap/wiki/Build-with-Github-Action) ### General build and Flash <details> <summary>ESP8266</summary> 1. Get ESP8266 RTOS Software Development Kit The SDK is already included in the project. Please don't use other versions of the SDK. 2. Build & Flash Build with ESP-IDF build system. More information can be found at the following link: [Build System](https://docs.espressif.com/projects/esp-idf/en/latest/api-guides/build-system.html "Build System") The following example shows a possible way to build on Windows: ```bash # Build python ./idf.py build # Flash python ./idf.py -p /dev/ttyS5 flash ``` </details> <details> <summary>ESP32/ESP32C3</summary> 1. Get esp-idf For now, please use esp-idf v4.4.2 : https://github.com/espressif/esp-idf/releases/tag/v4.4.2 2. Build & Flash Build with ESP-IDF build system. More information can be found at the following link: [Build System](https://docs.espressif.com/projects/esp-idf/en/latest/api-guides/build-system.html "Build System") The following example shows a possible way to build: ```bash # Set build target idf.py set-target esp32 # Build idf.py build # Flash idf.py -p /dev/ttyS5 flash ``` > The `idf.py` in the project root direct