Skip to content

Commit 2257c43

Browse files
authored
Update circuit, fix issue #29 (#30)
* Update circuit, Fix issue #29 * Update README_CN, Translate from README.
1 parent 40dfbb7 commit 2257c43

File tree

4 files changed

+1290
-507
lines changed

4 files changed

+1290
-507
lines changed

README_CN.md

Lines changed: 102 additions & 26 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,6 @@
22

33
![image](https://user-images.githubusercontent.com/17078589/107857220-05ecef00-6e68-11eb-9fa0-506b32052dba.png)
44

5-
65
[![Build Status](https://github.com/windowsair/wireless-esp8266-dap/workflows/build/badge.svg?branch=master)](https://github.com/windowsair/wireless-esp8266-dap/actions?query=branch%3Amaster) master 
76
[![Build Status](https://github.com/windowsair/wireless-esp8266-dap/workflows/build/badge.svg?branch=develop)](https://github.com/windowsair/wireless-esp8266-dap/actions?query=branch%3Adevelop) develop
87

@@ -22,15 +21,11 @@
2221
- [x] SWD(SW-DP)
2322
- [x] JTAG(JTAG-DP)
2423
- [x] SWJ-DP
25-
2624
2. 支持的USB通信协议:
2725
- [x] USB-HID
28-
- [x] WCID & WinUSB (Default)
29-
26+
- [x] WCID & WinUSB (默认)
3027
3. 支持的调试跟踪器:
31-
- [ ] UART Serial Wire Output(SWO)
32-
- [ ] SWO Streaming Trace
33-
28+
- [ ] UART TCP桥
3429
4. 其它
3530
- [x] 通过SPI接口加速的SWD协议
3631
- [x] ...
@@ -42,31 +37,41 @@
4237

4338
![WIFI](https://user-images.githubusercontent.com/17078589/118365659-517e7880-b5d0-11eb-9a5b-afe43348c2ba.png)
4439

40+
ESP8266具有一个内置的mDNS服务(仅ipv4). 你可以通过 `dap.local` 操作设备。
41+
42+
![mDNS](https://user-images.githubusercontent.com/17078589/149659052-7b29533f-9660-4811-8125-f8f50490d762.png)
43+
4544
### 调试接口连接
4645

4746
| SWD接口 | ESP8266引脚 |
4847
|----------------|--------|
4948
| SWCLK | GPIO14 |
5049
| SWDIO | GPIO13 |
51-
| LED\_CONNECTED | GPIO2 |
52-
| LED\_RUNNING | GPIO15 |
5350
| TVCC | 3V3 |
5451
| GND | GND |
5552

5653
--------------
5754

5855
| JTAG接口 | ESP8266引脚 |
5956
| :----------------: | :---------: |
60-
| TCK | GPIO14 |
61-
| TMS | GPIO13 |
62-
| TDI | GPIO4 |
63-
| TDO | GPIO16 |
64-
| nTRST \(optional\) | GPIO0\* |
65-
| nRESET | GPIO5 |
66-
| LED\_CONNECTED | GPIO2 |
67-
| LED\_RUNNING | GPIO15 |
68-
| TVCC | 3V3 |
69-
| GND | GND |
57+
| TCK | GPIO14 |
58+
| TMS | GPIO13 |
59+
| TDI | GPIO4 |
60+
| TDO | GPIO16 |
61+
| nTRST \(optional\) | GPIO0\* |
62+
| nRESET | GPIO5 |
63+
| TVCC | 3V3 |
64+
| GND | GND |
65+
66+
--------------
67+
68+
| 其它 | ESP8266引脚 |
69+
|:------------------:|:-------------:|
70+
| LED\_WIFI\_STATUS | GPIO15 |
71+
| Tx | GPIO2 |
72+
| Rx | GPIO3 (U0RXD) |
73+
74+
> Rx 和 Tx 被用于UART TCP桥,默然不开启此功能。
7075
7176
----
7277

@@ -77,8 +82,6 @@
7782

7883
***除此之外,你也可以像我们一开始给出的那张图片直接用杜邦线连接开发板,这就不需要额外的电路。***
7984

80-
> 如果你想修改接口的引脚或者是LED的引脚,请小心地参考指示在[DAP_config.h](components/DAP/config/DAP_config.h)文件中修改。
81-
8285
此外,你还可以从贡献者那里获得一个完整的硬件参考电路,详见 [circuit](circuit)文件夹。
8386

8487
------
@@ -147,7 +150,9 @@
147150

148151
------
149152

150-
## 速度性能
153+
## 文档
154+
155+
### 速度性能
151156

152157
单独使用ESP8266通用IO时的最大翻转速率只有大概2MHz。当你选择最大时钟时,我们需要采取以下操作:
153158

@@ -157,13 +162,84 @@
157162

158163
> 请注意,这个项目最重要的速度制约因素仍然是TCP连接速度。
159164
165+
### 对于OpenOCD用户
166+
167+
这个项目最初是为在Keil上运行而设计的,但现在你也可以在OpenOCD上通过它来烧录程序。
168+
注意,如果你想使用40MHz的SPI加速器,你需要在连接目标设备后指定速度,否则会在开始时失败。
169+
170+
```bash
171+
# 在使用flash指令前需要先运行:
172+
> adapter speed 10000
173+
174+
> halt
175+
> flash write_image [erase] [unlock] filename [offset] [type]
176+
```
177+
178+
> Keil的操作时序与OpenOCD的有些不同。例如,OpenOCD在读取 "IDCODE "寄存器之前缺少SWD线复位序列。
179+
180+
### 系统 OTA
181+
182+
当这个项目被更新时,你可以通过无线方式更新固件。
183+
184+
请访问以下网站了解OTA操作。[在线OTA](http://corsacota.surge.sh/?address=dap.local:3241)
185+
186+
对于大多数ESP8266设备,你不需要关心闪存的大小。然而,闪存大小设置不当可能会导致OTA失败。在这种情况下,请用`idf.py menuconfig`改变闪存大小,或者修改`sdkconfig`
187+
188+
```
189+
# 选择一个flash大小
190+
CONFIG_ESPTOOLPY_FLASHSIZE_1MB=y
191+
CONFIG_ESPTOOLPY_FLASHSIZE_2MB=y
192+
CONFIG_ESPTOOLPY_FLASHSIZE_4MB=y
193+
CONFIG_ESPTOOLPY_FLASHSIZE_8MB=y
194+
CONFIG_ESPTOOLPY_FLASHSIZE_16MB=y
195+
196+
# 然后设置flash大小
197+
CONFIG_ESPTOOLPY_FLASHSIZE="2MB"
198+
```
199+
200+
如果闪存大小为2MB,sdkconfig文件会看起来像这样:
201+
202+
```
203+
CONFIG_ESPTOOLPY_FLASHSIZE_2MB=y
204+
CONFIG_ESPTOOLPY_FLASHSIZE="2MB"
205+
```
206+
207+
对于闪存大小为1MB的设备,如ESP8285,必须做以下修改。
208+
209+
```
210+
CONFIG_PARTITION_TABLE_FILENAME="partitions_two_ota.1MB.csv"
211+
CONFIG_ESPTOOLPY_FLASHSIZE_1MB=y
212+
CONFIG_ESPTOOLPY_FLASHSIZE="1MB"
213+
CONFIG_ESP8266_BOOT_COPY_APP=y
214+
```
215+
216+
可以用esptool.py工具检查你使用的ESP8266的闪存大小:
217+
218+
```bash
219+
esptool.py -p (PORT) flash_id
220+
```
221+
222+
### Uart TCP桥
223+
224+
该功能在TCP和Uart之间提供了一个桥梁:
225+
```
226+
发送数据 -> TCP -> Uart TX -> 外部设备
227+
228+
接收数据 <- TCP <- Uart Rx <- 外部设备
229+
```
230+
231+
![uart_tcp_bridge](https://user-images.githubusercontent.com/17078589/150290065-05173965-8849-4452-ab7e-ec7649f46620.jpg)
232+
233+
当TCP连接建立后,网桥将尝试解决首次发送的文本。当文本是一个有效的波特率时,bridge 将切换到它。例如,发送ASCII文本`115200`会将波特率切换为115200。
234+
由于性能原因,该功能默认不启用。你可以修改 [wifi_configuration.h](main/wifi_configuration.h) 来打开它。
235+
236+
----
237+
160238
## 开发
161239

162-
1. 检查其他分支以了解最新的开发进展。
163-
2. 使用WinUSB模式(默认启用)。
164-
[dap_configuration.h](main/dap_configuration.h)修改 `USE_WINUSB` 宏。
240+
请查看其他分支以了解最新的开发进展。我们欢迎任何形式的贡献,包括但不限于新功能、关于电路的想法和文档。
165241

166-
目前TCP传输速度还需要进一步提高,如果你有什么想法,欢迎在下面提出:
242+
如果你有什么想法,欢迎在下面提出:
167243
- [新的Issues](https://github.com/windowsair/wireless-esp8266-dap/issues)
168244
- [新的pull request](https://github.com/windowsair/wireless-esp8266-dap/pulls)
169245

0 commit comments

Comments
 (0)