docs(tang): update 20K Dock DIP1/S4 for V3714

On Dock V3714 and later, DIP1 is no longer used for reconfigure; reconfigure and S4 have swapped roles, so reconfigure is triggered by the S4 button and DIP1 does not need to be switched down. Keep the pre-V3714 instructions with a version note.

Updated the enable-core-board section, hardware revision notes, Primer 20K Q&A, DIP switch example section, and the two example pages (zh/en).
This commit is contained in:
liangziyue
2026-10-30 18:25:06 +08:00
committed by Guoguo
parent db71168c78
commit 3baeb0bd48
10 changed files with 43 additions and 7 deletions

View File

@@ -143,6 +143,8 @@ For Nano 9K, hold S2 key to solve the trouble caused by JTAGSEL_N and JTAG pins
For 20K Dock kits, it's necessary to enable the core board before using debugger debug the chip, just put the 1 switch on the dip switch down, otherwise this error occurs.
> **Note**: Dock V3714 and later do not need DIP1 switched down; reconfigure is triggered by the S4 button.
| Enable Core Board | Disable state | Additional comments |
| --- | --- | --- |
|<img src="./../../../zh/tang/tang-primer-20k/assets/start/switch_1_on.png" alt="switch_1_on" width=100%>|<img src="./../../../zh/tang/tang-primer-20k/assets/start/reset_led_on.png" alt="reset_led_on" width=100%> | When disabled, the LDE0 and LED1 is on, and core board doesn't work.|

View File

@@ -252,7 +252,7 @@ There is onboard programmer for downloading bitstream, and drivers have been ins
### Scan device
Make sure you have enabled the core board first, put the 1 switch on the dip switch down.
Make sure you have enabled the core board first, put the 1 switch on the DIP switch down. Dock V3714 and later do not need DIP1 switched down.
![Enable_core_board](./../../../../../hardware/zh/tang/tang-primer-20k/assets/start/switch_1_on.png)

View File

@@ -307,6 +307,8 @@ And the corresponding golden finger on core board are as following:
For 20K Dock kits, it's necessary to enable the core board before using debugger debug the chip, just put the 1 switch on the dip switch down, otherwise LED0 and LED1 are on and core board dose not work.
> **Note**: This applies only to Dock boards earlier than V3714. Dock V3714 and later do not need DIP1 switched down; reconfigure is triggered by the S4 button.
| Enable Core Board | Disable state | Additional comments |
| --- | --- | --- |
|<img src="./../../../zh/tang/tang-primer-20k/assets/start/switch_1_on.png" alt="switch_1_on" width=100%>|<img src="./../../../zh/tang/tang-primer-20k/assets/start/reset_led_on.png" alt="reset_led_on" width=100%> | When disabled, the LDE0 and LED1 is on, and core board doesn't work.|
@@ -337,6 +339,8 @@ Besides, if you have dock ext-board, this can be solved by the enable pin of dip
Firstlt, enable the core board, put the 1 switch on the dip switch down, then do something (like burning fpga or erasing FPGA) in Programmer application, when the progress bar shows, switch the 1 switch on the dip switch up and down, after which you will find the progress bar works and finish your operations on fpga.
> **Note**: This method relies on the DIP1 enable function and applies only to Dock boards earlier than V3714.
<table>
<tr>
<td><img src="../../../zh/tang/tang-primer-20k/assets/start/switch_1_on.png" alt="switch_1_on"></td>

View File

@@ -2,6 +2,11 @@
title: Tang Primer 20K
keywords: FPGA, Primer, Tang, 20K
update:
- date: 2026-10-30
version: v0.2
author: Ziue
content:
- Document the DIP1 / S4 change on Dock V3714
- date: 2022-11-08
version: v0.1
author: wonder
@@ -23,9 +28,11 @@ Here are matters need attention, to avoid spending much time dealing with troubl
#### Enable Core Board
For 20K Dock kits, it's necessary to enable the core board before using debugger debug the chip, just put the 1 switch on the dip switch down, otherwise LED0 and LED1 are on and core board dose not work.
For Dock boards **earlier than V3714**, it's necessary to enable the core board before using the debugger, just put the 1 switch on the DIP switch down; otherwise LED0 and LED1 stay on and the core board does not work.
| Enable Core Board | Disable state | Additional comments |
> **Dock V3714 and later**: DIP1 is no longer used for reconfigure and does not need to be switched down. Reconfigure and S4 have swapped roles, so reconfigure is now triggered by the **S4** button.
| Enable Core Board (before V3714) | Disable state | Additional comments |
| --- | --- | --- |
|<img src="./../../../zh/tang/tang-primer-20k/assets/start/switch_1_on.png" alt="switch_1_on" width=100%>|<img src="./../../../zh/tang/tang-primer-20k/assets/start/reset_led_on.png" alt="reset_led_on" width=100%> | When disabled, the LDE0 and LED1 is on, and core board doesn't work.|
@@ -56,6 +63,10 @@ From the figure we can know the version of this board is V3708.
Here are their errors.
##### V3714
DIP1 and S4 have swapped roles: DIP1 is no longer used for reconfigure, and reconfigure is triggered by the S4 button. As a result, Dock V3714 and later do not need DIP1 switched down.
##### V3708
LED2 and LED3 are marked wrong, thay should be:

View File

@@ -242,6 +242,8 @@ Nano 9K 在设计的时候将 JTAG_SEL 引脚连接到了 S2 按键上,根据
20K Dock 套件要注意拨动拨码开关使能核心板后,下载软件才可以通过底板识别到底板所插入的核心板。
> **注意**:V3714 及以后版本的 Dock 不需要拨下 DIP1,reconfigure 改由 S4 按键触发。
<details>
<summary><font color="#4F84FF">点开查看图片详情</font></summary>
<table>

View File

@@ -163,7 +163,7 @@ Dock 板载了下载器,在 [安装IDE](https://wiki.sipeed.com/hardware/zh/ta
### 扫描设备
在使用 Dock 底板的时候不要忘记使能核心板,按下 1 号拨码开关即可。
在使用 Dock 底板的时候不要忘记使能核心板,按下 1 号拨码开关即可;V3714 及以后版本不需要拨下 DIP1。
![Enable_core_board](./../assets/start/switch_1_on.png)

View File

@@ -269,7 +269,7 @@ Dock 板载了下载器,在 [安装IDE](https://wiki.sipeed.com/hardware/zh/ta
### 扫描设备
在使用 Dock 底板的时候不要忘记使能核心板,按下 1 号拨码开关即可。
在使用 Dock 底板的时候不要忘记使能核心板,按下 1 号拨码开关即可;V3714 及以后版本不需要拨下 DIP1。
![Enable_core_board](./../assets/start/switch_1_on.png)

View File

@@ -87,6 +87,8 @@ $$E = A\oplus B\oplus C\oplus D = A\wedge B \wedge C\wedge D= (((A\wedge B )\wed
Tang Primer 20K DOCK 底板配备有一个 5P 的拨码开关。其中一号拨码开关被设计成核心板卡使能位;剩下四个拨码开关用于用户自定义编程功能。
> **注意**:V3714 及以后版本的 Dock,DIP1 不再用于 reconfigure,不需要拨下 DIP1;reconfigure 改由 S4 按键触发。下文关于 1 号拨码开关的说明仅适用于 V3714 之前的 Dock。
| 拨码开关原理图 | 拨码开关与 FPGA 连接引脚图 |
|---|---|
| ![dip_switch](./assets/xor_led_on/dip_switch.png) | ![dip_switch_pin](./assets/xor_led_on/dip_switch_pin.png) |

View File

@@ -326,6 +326,8 @@ github 链接: https://github.com/sipeed/TangPrimer-20K-example
拨下 1 号拨码开关以使能核心板,不然底板会不工作且 LED0 和 LED1 常亮。
> **注意**:本节仅适用于 V3714 之前的 Dock 板。V3714 及以后版本不需要拨下 DIP1,reconfigure 改由 S4 按键触发。
| 使能核心板 | 未使能核心板 |
| --- | --- |
| ![switch_1_on](./assets/start/switch_1_on.png) | ![reset_led_on](./assets/start/reset_led_on.png) |
@@ -358,6 +360,8 @@ github 链接: https://github.com/sipeed/TangPrimer-20K-example
首先正常使能核心板,将拨码开关一号位拨下。然后在 Programmer 软件中,选择一个操作(烧写、擦除都可以),当 Programmer 软件中进度条出现的时候,快速将一号拨码开关拉高,然后再拉低重新使能核心板,这样就会发现 Programmer 可以正常烧录 FPGA 板卡了。
> **注意**:该方法依赖 DIP1 的使能功能,仅适用于 V3714 之前的 Dock 板。
<table>
<tr>
<td><img src="./assets/start/switch_1_on.png" alt="switch_1_on"></td>

View File

@@ -2,6 +2,11 @@
title: Tang Primer 20K 开箱指南
keywords: FPGA, Primer, Tang, 20K
update:
- date: 2026-10-30
version: v0.2
author: Ziue
content:
- 补充 Dock V3714 的 DIP1 / S4 改动说明
- date: 2022-09-16
version: v0.1
author: wonder
@@ -23,9 +28,11 @@ Primer 20K 底板有 Lite 和 Dock 两款,这里分开说明一下
#### 使能核心板
对于 Dock 板,使用的时候需要注意将拨码开关 1 号位开启,以此来使能核心板。
对于 **V3714 之前**的 Dock 板,使用的时候需要将拨码开关 1 号位开启,以此来使能核心板。
| 使能核心板 | 未使能状态 | 补充说明 |
> **V3714 及以后版本**:DIP1 不再用于 reconfigure,不需要拨下 DIP1;reconfigure 与 S4 对调,改由 **S4** 按键触发。
| 使能核心板(V3714 之前) | 未使能状态 | 补充说明 |
| --- | --- | --- |
|<img src="./assets/start/switch_1_on.png" alt="switch_1_on" width=100%>|<img src="./assets/start/reset_led_on.png" alt="reset_led_on" width=100%> | 未使能核心板的话板子上的 0、1 号 LED 会一直亮着,且核心板不会正常启动。|
@@ -57,6 +64,10 @@ Primer 20K 底板有 Lite 和 Dock 两款,这里分开说明一下
下面是有问题的版本修正:
##### V3714
DIP1 与 S4 的功能对调:DIP1 不再用于 reconfigure,reconfigure 改由 S4 按键触发。因此 V3714 及以后版本的 Dock 不需要拨下 DIP1。
##### V3708
LED2 与 LED3 的丝印错误,应当为: