diff --git a/docs/hardware/en/tang/tang-console/mega-console.md b/docs/hardware/en/tang/tang-console/mega-console.md index 11e2de04..4c446dbd 100644 --- a/docs/hardware/en/tang/tang-console/mega-console.md +++ b/docs/hardware/en/tang/tang-console/mega-console.md @@ -16,7 +16,7 @@ update: ## Overview - **Tang Console** is an another dock board for **[Tang Mega 138k](./../tang-mega-138k/mega-138k.md) SOM** and **[Tang Mega 60k](./../tang-mega-60k/mega-60k.md) SOM**. It is designed to be small and compact, and is mechanically compatible with the **Raspberry Pi 5b** **`PCIe HAT`**. In addition, it also contains two 5Gbps USB3 device interfaces and two **2x20-pin header connectors**, two **PMOD connectors**. It can meet the needs of IO expansion and high-speed communication at the same time. + **Tang Console** is an another dock board for **[Tang Mega 138k](./../tang-mega-138k/mega-138k.md) SOM** and **[Tang Mega 60k](./../tang-mega-60k/mega-60k.md) SOM**. It is designed to be small and compact, and is mechanically compatible with the **Raspberry Pi 5** **`PCIe HAT`**. In addition, it also contains two 5Gbps USB3 device interfaces and two **2x20-pin header connectors**, two **PMOD connectors**. It can meet the needs of IO expansion and high-speed communication at the same time. At the same time, it is also specially designed for retro games. Maybe you can turn it into a retro game console, or even a handheld, whatever you like. @@ -28,9 +28,15 @@ update: ## Board Features + Note: This page mainly introduces the board from the perspective of the **development board**. + + For the **Retro Console**, please [**Click here**](./retro-console.md). + - Compatible with various SOMs (**[Mega 138k](./../tang-mega-138k/mega-138k.md)** & **[Mega 60k](./../tang-mega-60k/mega-60k.md)**) - More compact size, more budget choice - - Compatible with Raspberry Pi 5b PCIe HAT + - ~~Compatible with Raspberry Pi 5 PCIe HAT~~ + + (Due to compatibility issues between the PCIe hardcore and ARM's PCIe controller, this needs to be resolved in future software updates.) - PCIe 2.0 x 1 - USB3 x 2(5Gbps) - HDMI TX x 1 @@ -42,11 +48,17 @@ update: -## Block Diagram +## Hardware Parameters + +### Block Diagram + +
+ Click for details +
TBD -## Hardware Parameters +
### SOM Board Parameters @@ -143,7 +155,9 @@ Example code (Github): Chip Model - The specific model of the FPGA chip used by Tang Mega 60K is GW5AT-LV60PG484A, and Tang Mega 138K is GW5AST-LV138FPG676A.
Please select the package model PBG484A in the IDE. + The specific model of the FPGA chip used by Tang Console 60K is GW5AT-LV60PG484AC1/l0, +
and Tang Mega 138K is GW5AST-LV138FPG676AC1/l0. +
Please select the package model PBG484A & Device Version: B in the IDE. Static Electricity @@ -177,54 +191,94 @@ Tang Console can meet different needs of customers in various scenarios. For tec ### The system does not recognize the onboard debugger +
+ Click for details +
+ - Make sure the USB cable is connected to the port marked with ***MCU***. - Try connecting directly to the computer instead of through a USB HUB. - Try using a better quality USB cable. - Try another computer to rule out the computer being the problem. - Try [update to the latest firmware](#how-to-update-the-firmware-for-the-onboard-debugger) and try again. +
+ ### The UART of the onboard debugger cannot be used +
+ Click for details +
+ - Try reinstall FTDI drivers. - IF the actual baudrate is always four times the set baudrate or the UART continuously outputs garbled characters. try [update to the latest firmware](#how-to-update-the-firmware-for-the-onboard-debugger) and try again. +
+ ### OpenFPGAloader not work -- Try [update to the latest firmware](#how-to-update-the-firmware-for-the-onboard-debugger) and try again. +
+ Click for details +
+ + - Try [update to the latest firmware](#how-to-update-the-firmware-for-the-onboard-debugger) and try again. + +
### How to update the firmware for the onboard debugger -- See [Update the debugger](./../common/update_debugger.md) for details. +
+ Click for details +
-### IDE cannot find the model + - See [Update the debugger](./../common/update_debugger.md) for details. + +
+ +### IDE cannot find the model + +
+ Click for details +
1. The educational version does not support 60K and 138K, please switch to the commercial version. The following image shows the educational version (which does not support 60K); - - + 2. IDE version is too low to use, update the IDE version ≥ **1.9.9**. +
+ ### How to burn the bitstream to FLASH {#burn_flash} +
+ Click for details +
+ 1. Setting the **Programmer** as shown in the figure below: -flash_mode + flash_mode +
### No Response or Undesirable Pin Phenomenon After Burning +
+ Click for details +
+ 1. First, ensure that the IDE has selected the correct model -- For MEGA 60K, **GW5AT-LV60PG484AC1/10**; every parameter in the figure below **MUST** be consistent. + - For MEGA 60K, **GW5AT-LV60PG484AC1/10**; every parameter in the figure below **MUST** be consistent. -device_choose + device_choose -- For MEGA 138K, **GW5AST-LV138PG484AC1/10**; every parameter in the figure below **MUST** be consistent. + - For MEGA 138K, **GW5AST-LV138PG484AC1/10**; every parameter in the figure below **MUST** be consistent. -device_choose + device_choose 2. Then, check your code and the corresponding simulation waveforms to meet the requirements. The GAO tools in GOWIN IDE maybe helpful. For more information, please refer to the GOWIN document [SUG100](https://www.gowinsemi.com/upload/database_doc/1885/document/660bb2366d0b3.pdf)(require login). +
+ ### For more questions and solutions, go to [Related Questions](./../common-doc/questions.md) to view \ No newline at end of file diff --git a/docs/hardware/en/tang/tang-console/retro-console.md b/docs/hardware/en/tang/tang-console/retro-console.md index 51a20446..71322522 100644 --- a/docs/hardware/en/tang/tang-console/retro-console.md +++ b/docs/hardware/en/tang/tang-console/retro-console.md @@ -26,7 +26,7 @@ update: ## Product Appearance - + ## Block Diagram @@ -129,7 +129,7 @@ Example code (Github): Chip Model - The specific model of the FPGA chip used by Tang Mega 60K is GW5AT-LV60PG484A, and Tang Mega 138K is GW5AST-LV138FPG676A.
Please select the package model PBG484A in the IDE. + The specific model of the FPGA chip used by Tang Mega 60K is GW5AT-LV60PG484A, and Tang Mega 138K is GW5AST-LV138FPG676A.
Please select the package model PBG484A & Device Version: B in the IDE. Static Electricity diff --git a/docs/hardware/zh/sidebar.yaml b/docs/hardware/zh/sidebar.yaml index 502b6319..2d796ce6 100644 --- a/docs/hardware/zh/sidebar.yaml +++ b/docs/hardware/zh/sidebar.yaml @@ -397,6 +397,8 @@ items: target: _blank - label: Tang Console items: + - label: Retro Console + file: tang/tang-console/retro-console.md - label: 板卡介绍 file: tang/tang-console/mega-console.md - label: 安装 IDE diff --git a/docs/hardware/zh/tang/common-doc/update_debugger.md b/docs/hardware/zh/tang/common-doc/update_debugger.md index 3d0f63ce..c385853f 100644 --- a/docs/hardware/zh/tang/common-doc/update_debugger.md +++ b/docs/hardware/zh/tang/common-doc/update_debugger.md @@ -415,6 +415,26 @@ update: +*** + +### **Tang Core** 的额外说明 + +
+ 点击查看详情 +
+ + 对于支持[**Tang Core**](https://nand2mario.github.io/tangcore/)的开发板而言（如[Tang Console](../tang-console/mega-console.md)），其能正常执行[**Tang Core**](https://nand2mario.github.io/tangcore/)功能需要同时依赖[**调试器固件**](#最新固件)和二级启动的[**TangCore firmware for BL616**](https://github.com/nand2mario/firmware-bl616/) 共计两个固件。 + + [**调试器固件**](#最新固件)可以在本页面下方找到，而二级启动的[**TangCore firmware for BL616**](https://github.com/nand2mario/firmware-bl616/)目前由 **[nand2mario](https://github.com/nand2mario)** 负责维护，其最新版本可以在[**TangCore Release Package**](https://github.com/nand2mario/tangcore/releases)中找到。 + + [**调试器固件**](#最新固件)写入 **flash** 的起始地址为 `0x0`，而[**TangCore firmware for BL616**](https://github.com/nand2mario/firmware-bl616/)写入 **flash** 的地址为 `0x40000`。 + + 原始的安装文档可以在 [**这里**](https://nand2mario.github.io/tangcore/user-guide/installation/#firmware-installation) 找到。 + + 请注意：对于 **BL616** 而言，只有版本 **`2025030317`** 及之后的[**调试器固件**](#最新固件)支持二级启动功能。 + +
+ ### 最新固件 所有Tang系列板载调试器的最新固件序列号记录在这里： @@ -428,9 +448,9 @@ update: | | | | | | | nano 20K | BL616 | [点我](https://api.dl.sipeed.com/TANG/Debugger/onboard/BL616/2025030317/bl616_fpga_partner_20kNano.bin) |2025030317 |[bl616_fpga_partner_20kNano.sha256](https://api.dl.sipeed.com/TANG/Debugger/onboard/BL616/2025030317/bl616_fpga_partner_20kNano.sha256) | | Primer 25K | BL616 | [点我](https://api.dl.sipeed.com/TANG/Debugger/onboard/BL616/2025030317/bl616_fpga_partner_25kDock.bin) |2025030317 |[bl616_fpga_partner_25kDock.sha256](https://api.dl.sipeed.com/TANG/Debugger/onboard/BL616/2025030317/bl616_fpga_partner_25kDock.sha256) | - | Mega NEO | BL616 | [点我](https://api.dl.sipeed.com/TANG/Debugger/onboard/BL616/2025030317/bl616_fpga_partner_NeoDock.bin) |2025012315 |[bl616_fpga_partner_NeoDock.sha256](https://api.dl.sipeed.com/TANG/Debugger/onboard/BL616/2025030317/bl616_fpga_partner_NeoDock.sha256) | - | Mega 138K Pro | BL616 | [点我](https://api.dl.sipeed.com/TANG/Debugger/onboard/BL616/202501231x/bl616_fpga_partner_138kproDock.bin) |2025012315 |[bl616_fpga_partner_138kproDock.sha256](https://api.dl.sipeed.com/TANG/Debugger/onboard/BL616/202501231x/bl616_fpga_partner_138kproDock.sha256)| - | Console | BL616 | [点我](https://api.dl.sipeed.com/TANG/Debugger/onboard/BL616/2025030317/bl616_fpga_partner_Console.bin) |2025030317 |[bl616_fpga_partner_Console.sha256](https://api.dl.sipeed.com/TANG/Debugger/onboard/BL616/2025030317/bl616_fpga_partner_Console.sha256) | + | Mega NEO | BL616 | [点我](https://api.dl.sipeed.com/TANG/Debugger/onboard/BL616/2025030317/bl616_fpga_partner_NeoDock.bin) |2025030317 |[bl616_fpga_partner_NeoDock.sha256](https://api.dl.sipeed.com/TANG/Debugger/onboard/BL616/2025030317/bl616_fpga_partner_NeoDock.sha256) | + | Mega 138K Pro | BL616 | [点我](https://api.dl.sipeed.com/TANG/Debugger/onboard/BL616/2025030317/bl616_fpga_partner_138kproDock.bin) |2025030317 |[bl616_fpga_partner_138kproDock.sha256](https://api.dl.sipeed.com/TANG/Debugger/onboard/BL616/2025030317/bl616_fpga_partner_138kproDock.sha256)| + | Console | BL616 | [点我](https://api.dl.sipeed.com/TANG/Debugger/onboard/BL616/2025030317/bl616_fpga_partner_Console.bin) |2025041420 |[bl616_fpga_partner_Console.sha256](https://api.dl.sipeed.com/TANG/Debugger/onboard/BL616/2025030317/bl616_fpga_partner_Console.sha256) | ### 故障排除 如果您在使用过程中遇到任何问题，或者对文档有任何意见或建议，请随时向我们反馈。联系方式如下。 @@ -444,6 +464,11 @@ update: >在大多数情况下，对于MCU相关的问题 ***博流智能*** 的官方文档足以进行故障排除。[【点击这里】](https://dev.bouffalolab.com/document/)以访问相关文档。 -#### 常见问题 -- TBD，等待收集反馈后再添加。 +### 常见问题 + +#### 更新固件后，未出现 **`USB Converter A`** 和 **`USB Converter B`**，依旧显示一个 **`COM`** 端口 + + 可能 + + 1. diff --git a/docs/hardware/zh/tang/tang-console/assert/console_bdb.jpg b/docs/hardware/zh/tang/tang-console/assert/console_bdb.jpg new file mode 100644 index 00000000..09791e26 Binary files /dev/null and b/docs/hardware/zh/tang/tang-console/assert/console_bdb.jpg differ diff --git a/docs/hardware/zh/tang/tang-console/assert/console_bdt.jpg b/docs/hardware/zh/tang/tang-console/assert/console_bdt.jpg new file mode 100644 index 00000000..84a9328f Binary files /dev/null and b/docs/hardware/zh/tang/tang-console/assert/console_bdt.jpg differ diff --git a/docs/hardware/zh/tang/tang-console/assert/retro-console-p_60k.jpg b/docs/hardware/zh/tang/tang-console/assert/retro-console-p_60k.jpg new file mode 100644 index 00000000..72a44a59 Binary files /dev/null and b/docs/hardware/zh/tang/tang-console/assert/retro-console-p_60k.jpg differ diff --git a/docs/hardware/zh/tang/tang-console/assert/retro-console_60k.jpg b/docs/hardware/zh/tang/tang-console/assert/retro-console_60k.jpg new file mode 100644 index 00000000..64cc4e23 Binary files /dev/null and b/docs/hardware/zh/tang/tang-console/assert/retro-console_60k.jpg differ diff --git a/docs/hardware/zh/tang/tang-console/assert/retro-console_assembly-1.jpg b/docs/hardware/zh/tang/tang-console/assert/retro-console_assembly-1.jpg new file mode 100644 index 00000000..9f825ff1 Binary files /dev/null and b/docs/hardware/zh/tang/tang-console/assert/retro-console_assembly-1.jpg differ diff --git a/docs/hardware/zh/tang/tang-console/assert/retro-console_assembly-2.jpg b/docs/hardware/zh/tang/tang-console/assert/retro-console_assembly-2.jpg new file mode 100644 index 00000000..9500e011 Binary files /dev/null and b/docs/hardware/zh/tang/tang-console/assert/retro-console_assembly-2.jpg differ diff --git a/docs/hardware/zh/tang/tang-console/assert/retro-console_assembly-3.jpg b/docs/hardware/zh/tang/tang-console/assert/retro-console_assembly-3.jpg new file mode 100644 index 00000000..046eefea Binary files /dev/null and b/docs/hardware/zh/tang/tang-console/assert/retro-console_assembly-3.jpg differ diff --git a/docs/hardware/zh/tang/tang-console/assert/retro-console_game.jpg b/docs/hardware/zh/tang/tang-console/assert/retro-console_game.jpg new file mode 100644 index 00000000..94f0c2fb Binary files /dev/null and b/docs/hardware/zh/tang/tang-console/assert/retro-console_game.jpg differ diff --git a/docs/hardware/zh/tang/tang-console/assert/retro-console_menu.jpg b/docs/hardware/zh/tang/tang-console/assert/retro-console_menu.jpg new file mode 100644 index 00000000..edbb3b0e Binary files /dev/null and b/docs/hardware/zh/tang/tang-console/assert/retro-console_menu.jpg differ diff --git a/docs/hardware/zh/tang/tang-console/assert/retro-console_menu1.jpg b/docs/hardware/zh/tang/tang-console/assert/retro-console_menu1.jpg new file mode 100644 index 00000000..b138970d Binary files /dev/null and b/docs/hardware/zh/tang/tang-console/assert/retro-console_menu1.jpg differ diff --git a/docs/hardware/zh/tang/tang-console/assert/retro-console_menu2.jpg b/docs/hardware/zh/tang/tang-console/assert/retro-console_menu2.jpg new file mode 100644 index 00000000..f724ec86 Binary files /dev/null and b/docs/hardware/zh/tang/tang-console/assert/retro-console_menu2.jpg differ diff --git a/docs/hardware/zh/tang/tang-console/assert/retro-console_menu3.jpg b/docs/hardware/zh/tang/tang-console/assert/retro-console_menu3.jpg new file mode 100644 index 00000000..a9a3da53 Binary files /dev/null and b/docs/hardware/zh/tang/tang-console/assert/retro-console_menu3.jpg differ diff --git a/docs/hardware/zh/tang/tang-console/assert/retro-console_menu4.jpg b/docs/hardware/zh/tang/tang-console/assert/retro-console_menu4.jpg new file mode 100644 index 00000000..7e4b2138 Binary files /dev/null and b/docs/hardware/zh/tang/tang-console/assert/retro-console_menu4.jpg differ diff --git a/docs/hardware/zh/tang/tang-console/assert/retro-console_menu5.jpg b/docs/hardware/zh/tang/tang-console/assert/retro-console_menu5.jpg new file mode 100644 index 00000000..96933840 Binary files /dev/null and b/docs/hardware/zh/tang/tang-console/assert/retro-console_menu5.jpg differ diff --git a/docs/hardware/zh/tang/tang-console/assert/tangcores.drawio.svg b/docs/hardware/zh/tang/tang-console/assert/tangcores.drawio.svg new file mode 100644 index 00000000..cb9563d9 --- /dev/null +++ b/docs/hardware/zh/tang/tang-console/assert/tangcores.drawio.svg @@ -0,0 +1,4 @@ + + + +
BL616
GW5AT-60
UART
JTAG
USB host
UART for debug
JTAG for debug
 \ No newline at end of file diff --git a/docs/hardware/zh/tang/tang-console/mega-console.md b/docs/hardware/zh/tang/tang-console/mega-console.md index e0e056d5..29398949 100644 --- a/docs/hardware/zh/tang/tang-console/mega-console.md +++ b/docs/hardware/zh/tang/tang-console/mega-console.md @@ -27,7 +27,7 @@ update: - 兼容多种SOM (**[Mega 138k](./../tang-mega-138k/mega-138k.md)** & **[Mega 60k](./../*tang-mega-60k/mega-60k.md)**) - 更小更紧凑更经济 - - 兼容 **RPi 5 PCIe FPC** + - 兼容 **RPi 5 PCIe FPC**（然而由於PCIe硬核和arm的PCIe控制器存在兼容性问题，需要在未来的软体更新中解决。） - **PCIe Gen2/3 x 1** FPC连接器 - **USB3 x 2** (Type-A, Device, 5Gbps or 10Gbps) - **USB2 x 2** (Type-A, Host, 1.5Mbps or 12Mbps) @@ -43,11 +43,23 @@ update: ## 硬件参数 +### 硬件框图 + +
+ 点击此处查看 +
+ + + + + +
+ ### 核心板（SOM）参数 请根据实际安装的SOM，参考如下连接： - **[Tang Mega 138k](./../tang-mega-138k/mega-138k.md#核心板参数) 核心板** -- **[Tang Mega 60k](./../tang-mega-60k/mega-60k.md#核心板参数) 核心板** +- **[Tang Mega 60k](./../tang-mega-60k/mega-60k.md#核心板参数) 核心板** ### 底板参数 @@ -103,11 +115,8 @@ port: 10559 - [60K](https://github.com/sipeed/TangMega-60K-example) - [138K](https://github.com/sipeed/TangMega-138K-example) - [TangCores](https://github.com/nand2mario/tangcores) - - [snestang](https://github.com/nand2mario/snestang) - - [nestang](https://github.com/nand2mario/nestang) - - [gbatang](https://github.com/nand2mario/gbatang) - 特别鸣谢：**[nand2mario](https://github.com/nand2mario)** + - 特别鸣谢：**[nand2mario](https://github.com/nand2mario)** *** @@ -134,7 +143,9 @@ port: 10559 芯片型号 - Tang Mega 60K 使用的 FPGA 芯片具体型号是 GW5AT-LV60PG484A
在 IDE 中选择封装型号 PBG484A
+ Tang Console 60K 使用的 FPGA 芯片具体型号是 GW5AT-LV60PG484AC1/l0 +
Tang Console 138K 使用的 FPGA 芯片具体型号是 GW5AST-LV138PG484AC1/l0 +
在 IDE 中选择封装型号 PBG484A & Device Version: B 静电 @@ -146,15 +157,12 @@ port: 10559 FPC 座子 - 在连接 FPC 软排线的时候，请确保排线无偏侈地完整地插入到排线中 - - - PCIe 金手指 - 在测试 PCIe 金手指时候，确保是主机端与板卡都处于关机或者未通电的状态，否则可能会因为插入过程中的易位导致金手指短路。 + 在连接 FPC 软排线的时候，请确保排线无偏侈地完整地插入到排线中 +
在通电之前请仔细核对两端FPC 连接器的 1号PIN 的方向是否正确 插拔 - 请完全断电后才进行插拔操作 + 请完全断电后才进行配件的插拔操作 避免短路 @@ -164,47 +172,71 @@ port: 10559 ## 联系 -Tang Mega 60K 可以在多种场景实现客户不同方面的需要，技术支持和商业合作请联系邮箱 [support@sipeed.com](support@sipeed.com) +Tang Console 可以在多种场景实现客户不同方面的需要，技术支持和商业合作请联系邮箱 [support@sipeed.com](support@sipeed.com) ## 常见问题 ### 板子电源指示灯亮了，Programmer提示No USB Cable Connection +
+ 点击查看详情 +
+ 1. 请检查USB线是否正确接入标记为 **MCU** 的USB-C连接器 2. 尽量避免使用机箱前面板的USB连接器和没有独立供电的USB HUB 3. 检查自己是否正确安装FT2232的驱动：出现USB Serial Converter A/B -flash_mode + flash_mode 4. 通常情况下Windows会在联网后自动安装相应驱动。如果想要手动处理，请前往[相关问题](./../common-doc/questions.md)查看相关内容 5. 尝试更新板载下载器的固件，请参考这里 **[【点我跳转】](./../common-doc/update_debugger.md)** +
+ ### IDE找不到型号GW5AT-LV60PG484A 或 GW5AST-LV138PG484A +
+ 点击查看详情 +
+ 1. 教育版不支持60K和138K，请更换商业版。如下图所示即为教育版（不支持60K）； - + 2. IDE版本过老，必须更新IDE ≥ 1.9.10.01。 +
+ ### 如何下载到外部 FLASH（固化） {#burn_flash} +
+ 点击查看详情 +
+ 1. 进行如下选项设置： -flash_mode + flash_mode + +
### 烧录后没反应或者引脚现象不对 +
+ 点击查看详情 +
+ 1. 首先确定IDE选择了正确的型号 -- 对于60K，**GW5AT-LV60PG484AC1/10**，下图中的每一个参数都要求一致； + - 对于60K，**GW5AT-LV60PG484AC1/10**，下图中的每一个参数都要求一致； -device_choose + device_choose -- 对于138K，**GW5AST-LV138PG484AC1/10**，下图中的每一个参数都要求一致； + - 对于138K，**GW5AST-LV138PG484AC1/10**，下图中的每一个参数都要求一致； -device_choose + device_choose 2. 然后检查自己的代码和对应的仿真波形是否满足要求，使用云源软件（GOWIN IDE）的GAO工具可以进行片上仿真。更多详情请参考GOWIN文档[SUG100](https://cdn.gowinsemi.com.cn/SUG100-4.0_Gowin%E4%BA%91%E6%BA%90%E8%BD%AF%E4%BB%B6%E7%94%A8%E6%88%B7%E6%8C%87%E5%8D%97.pdf)中关于GAO工具的描述。 +
+ ### 更多问题及其解决办法前往[相关问题](./../common-doc/questions.md)查看 diff --git a/docs/hardware/zh/tang/tang-console/retro-console.md b/docs/hardware/zh/tang/tang-console/retro-console.md index 6a1bf4b1..b084ec4f 100644 --- a/docs/hardware/zh/tang/tang-console/retro-console.md +++ b/docs/hardware/zh/tang/tang-console/retro-console.md @@ -1,6 +1,6 @@ --- title: Tang Console -keywords: FPGA, Tang, Console, 60K, 138K +keywords: FPGA, Tang, Console, Retro, 60K, 138K update: - date: 2025-04-17 version: v0.1 @@ -12,92 +12,227 @@ update: ## 产品概述 - +- 发售日期：2025年4月中旬 +- ~~预购链接：[**点我**](https://sipeed.com/tangconsole)~~（预购已结束，敬请期待零售版本） +- **开发板关内容：**[**点我**](./mega-console.md) +- **Tang Core** 的开发者文档：[**点我**](https://nand2mario.github.io/tangcore/) ## 板卡特点 +
+ 点击查看详情 +
+- 兼容多种SOM (**[Mega 138k](./../tang-mega-138k/mega-138k.md)** & **[Mega 60k](./../*tang-mega-60k/mega-60k.md)**) +- 支持多种[**Tang Core**](https://github.com/nand2mario/tangcore)模拟器核心 + - **NESTang** - Nintendo Entertainment System + - **SNESTang** - Super Nintendo Entertainment System + - **GBATang** - Game Boy Advance + - **MDTang** - Sega Genesis/Mega Drive + - **SMSTang** - Sega Master System + - **更多核心仍在开发中，将会陆续上线** +- 板载BL616 MCU + - 运行[**TangCore firmware for BL616**](https://github.com/nand2mario/firmware-bl616/) + - 支持模拟器核心快速切换 + - ~~支持uSD卡存储~~(仍在调试中) + - **支持USB OTG**（目前需要带供电的OTG转接头或HUB） + - **USB OTG存储**（存放游戏ROM和模拟器核心，以及模拟器BIOS） + - **USB HID手柄** + - 可作为FPGA的调试器 +- 板载两个USB-A，可用于直接连接支持的USB手柄 + +- 支持DS2手柄（需要[**PMOD_DS2x2**](../tang-PMOD/FPGA_PMOD.md#pmod_ds2x2)） + +
## 产品外观 +
+ 点击查看详情 +
+ + - **Tang Retro Console Premium** (60k version) + + + - **Tang Retro Console** (60k version) + +
+ +## 架构框图 + +
+ 点击查看详情 +
+ + + +
## 硬件参数 -### 核心板（SOM）参数 +
+ 点击查看详情 -请根据实际安装的SOM，参考如下连接： -- **[Tang Mega 138k](./../tang-mega-138k/mega-138k.md#核心板参数) 核心板** -- **[Tang Mega 60k](./../tang-mega-60k/mega-60k.md#核心板参数) 核心板** + ### 核心板（SOM）参数 -### 底板参数 + 请根据实际安装的SOM，参考如下连接： + - **[Tang Mega 138k](./../tang-mega-138k/mega-138k.md#核心板参数) 核心板** + - **[Tang Mega 60k](./../tang-mega-60k/mega-60k.md#核心板参数) 核心板** -| 项目 | 数量 | 备注 | -| :------------------ | ---- | ------------------------------------------------ | -| LEDs | 2(3+3) | 电源指示灯x3 + 用户指示灯x3 (共计2颗RGB LED) | -| Buttons | 2+1 | 用户按键x2 + MODE（reconfig）按键x1 | -| PCIe | 1 | 1通道 8/5Gbps (取决于核心板) | -| USB3 | 2 | SERDES 通道，超速 @ 5Gbps (设备模式) | -| USB2 | 1 | IO Soft-PHY，高速 @ 480Mbps (设备模式) | -| DVI(HDMI) | 1 | 兼容HDMI， 支持TX， 可通过修改实现RX | -| PMOD | 2 | 标准间距（800mil），支持双PMOD模组 | -| ADC | 2 | 两组独立输入通道（其中一组用于锂电池电压测量） | -| RGB 接口 | 1 | 40P 0.5mm间距FPC，支持RGB88，支持RGB转VGA模组 | -| microSD 插槽 | 1 | 支持4-bit SDIO/MMC 或 SPI 模式 | -| 电池连接器 | 1 | 支持 3.7V 锂离子电池， 内置电池充放电管理 | -| 风扇连接器 | 1 | 支持5V直流风扇，最大功率1W | -| 扬声器连接器 | 1 | 支持2W扬声器，单声道输出 | -| MS5351 | 1 | 为 Serdes 提供 RefClk，通过板载调试器的 UART 控制 | -| USB JTAG & UART | 1 | 板载调试器支持FPGA编程，并提供UART功能 | -| 2x20P 排针连接器 | 2 | 独立的2x20P排针，最多提供2x38个IO，可通过修改兼容DE10-Nano Kit | + ### 底板参数 -## 硬件资料 + - 请参考**开发板关内容：**[**点我**](./mega-console.md#底板参数) -~~[板卡规格书](https://dl.sipeed.com/shareURL/TANG/Console/01_Specification)~~ -[板卡原理图](https://dl.sipeed.com/shareURL/TANG/Console/02_Schematic) -[PCB BOM](https://dl.sipeed.com/shareURL/TANG/Console/03_Designator_drawing) -[板卡尺寸图](https://dl.sipeed.com/shareURL/TANG/Console/04_Mechanical_drawing) -[板卡 3D 模型](https://dl.sipeed.com/shareURL/TANG/Console/05_3D_file) -[部分芯片手册](https://dl.sipeed.com/shareURL/TANG/Console/07_Datasheet) -[全引脚约束](https://dl.sipeed.com/shareURL/TANG/Console/08_Misc) - -## 上手使用 -注意60K目前未被教育版支持，需要下载 V1.9.10.01 或更新版本的商业版IDE使用。 -V1.9.10.02版本的Programmer存在严重问题，无法正常下载本产品。 -如需将码流下载到flash中固化，推荐使用 **exFlash Erase,Program thru GAO-Bridge 5A** 模式（需要≥V1.9.10.03）。 -Lic 可以在高云官网申请，或者使用Sipeed提供的在线Lic服务，在IDE中选择Float Lic，填写以下信息即可： -~~~ ----Server 01--- -ip: 45.33.107.56 -port: 10559 - ----Server 02--- -ip: 106.55.34.119 -port: 10559 -~~~ -如果上面的IP不能工作, 尝试使用 "gowinlic.sipeed.com" 域名对应的IP. - -安装 IDE [点我](https://wiki.sipeed.com/hardware/zh/tang/common-doc/get_started/install-the-ide.html) - - -例程代码（Github）： - - [60K](https://github.com/sipeed/TangMega-60K-example) - - [138K](https://github.com/sipeed/TangMega-138K-example) - - [TangCores](https://github.com/nand2mario/tangcores) - - [snestang](https://github.com/nand2mario/snestang) - - [nestang](https://github.com/nand2mario/nestang) - - [gbatang](https://github.com/nand2mario/gbatang) - - 特别鸣谢：**[nand2mario](https://github.com/nand2mario)** +
*** -### 其他学习资源 +## 上手使用 -- 在线免费教程：[Verilog 教程](https://www.runoob.com/w3cnote/verilog-tutorial.html)（学习Verilog） -- 在线免费 FPGA 教程：[Verilog](https://www.asic-world.com/verilog/index.html) （英文网站） -- Verilog 刷题网站：[HDLBits](https://hdlbits.01xz.net/wiki/Main_Page)（英文网站） -- 在线高云半导体可参考视频教程：[点击这里](http://www.gowinsemi.com.cn/video_complex.aspx?FId=n15:15:26) +此处以**Tang Retro Console**为例，讲解如使用Tang Console进行游玩 + +### 准备工作 + + 需要准备的东西如下： + + * [] Tang Console，138k或60k均可 + * [] USB 2.0驱动器，或者SD卡+读卡器（推荐格式FAT32/exFAT，≤32GB） + * [] USB-C OTG 转换器，带有电源传输（推荐使用套餐中的USB-C读卡器） + * [] 可用的GBA原机BIOS（gba_bios.bin） + * [] 最新的[**TangCore Release Package**](https://github.com/nand2mario/tangcore/releases) + * [] 想要游玩的游戏ROM（Tang Retro Console Premium套餐包含的uSD卡中已有演示游戏） + + ### 安装MCU固件 + + - 对于已购买任何套餐Tang Console的用户来说，这一步不是必须的，因为出厂时已经完成 + + - 后续如有固件更新，请参考此处进行更新：[**点我**](../common-doc/update_debugger.md#tang-core-的额外说明) + + ### 存储介质准备 + + 无论是采用SD卡还是USB驱动器，需要确保其容量≤32GB 同时格式化为FAT32/exFAT。 + 存储介质的内容如下方所示： + ``` + 📁 / + ├── 📁 cores/ # 来自Tang Core发布版本的 `cores` 目录 + │ ├── 📁 console60k/ + │ └── 📁 console138k/ + ├── 📁 nes/ # .nes rom 目录 + ├── 📁 snes/ # .smc/.sfc 目录 + ├── 📁 gba/ + │ └── 🗎 gba_bios.bin # GBA BIOS 档案 + ├── 📁 genesis/ # .bin/.md 目录 + └── 📁 sms/ # .sms 目录 + ``` + 存储介质的内容不区分 **138k console** 和 **60k console**。其中 **`gba_bios.bin`** 需要用户自行下载后放入。 + + 将想要游玩的游戏ROM放入对应的目录中即可。 + + ### 硬件组装 + + 1. **推荐的方式**（这种方式的全部配件都包含于 **Tang Console Retro Premium** 中） + + + + > 左侧：USB-OTG读卡器+USB-C电源 | 下方：USB手柄 **P1** | 上方： HDMI输出 + + - 这种方式的好处是简洁，缺点是USB手柄这样接不太稳定 + + - 如遇到USB手柄不识别（尤其是在切换完毕模拟器core的时候），需要用户手动多拔插USB手柄几次 + +
+ + 2. **nand2mario**的方式 +
+ 点击查看详情 +
+ + + > 左侧：OTG USB驱动器+USB-C供电 | 右侧： DS2 PMOD+DS2手柄 | 顶部: HDMI输出 + + - 这种方式的好处是稳定，缺点是太臃肿 + + - 如想要连接更加简洁，请尝试使用无线DS2手柄，并更换更小尺寸的USB驱动器 + +
+
+
+ + 3. USB OTG HUB的方式 {#USB_OTG_HUB} +
+ 点击查看详情 +
+ + + > 左侧：USB-C OTG HUB+USB驱动器+USB-C供电+USB手柄 **P1** | 顶部: HDMI输出 + + - 这种方式的好处比较稳定，缺点是十分臃肿 & USB HUB 可能有兼容性问题 + + - 已测试的USB HUB的兼容性列表：[点我](https://github.com/nand2mario/tangcore/wiki/Compatible-USB-Hubs) + +
+
+
+ + +### 上电开机 + +1. 先按照上一步中组装好机器，然后再接通电源； + +2. 等待一段时间，主菜单会出现； + +
+ 点击查看详情 +
+ +
+
+ +3. 使用游戏手柄进行导航，上下移动游标，左右进行翻页，`B`或`3`键确定，`A`或`2`键返回，在 `..`上按下`B`键可以返回上级菜单 + +
+ 点击查看详情 +
+ +
+
+ +4. 选中一个模拟器标题，如**SNES**，按`B`键进入二级菜单，选择要游玩的游戏ROM，再次按下`B`键进入游戏 + +
+ 点击查看详情 +
+ +
+
+ +5. HDMI输出会暂时消失，稍等片刻出现ROM加载画面，此时画面下方的标题会变成对应模拟器的名称（本例中为 **SnesTang**） + +
+ 点击查看详情 +
+ +
+
+ +6. 稍等片刻ROM加载完毕后就会进入游戏，通常此时按下 `start` 键就可以开始游戏 + +
+ 点击查看详情 +
+ +
+
+ +7. 在游戏中可以按 `→` + `select` 返回主菜单 + +8. 部分游戏ROM可能并不完全被模拟器兼容。如果遇到了问题，给Console重新上电即可 + +### 其他资源 + +- 安装文档原文： [**点我**](https://nand2mario.github.io/tangcore/user-guide/installation/) +- 特别鸣谢：**[nand2mario](https://github.com/nand2mario)** ## 交流方式 @@ -114,28 +249,35 @@ port: 10559 注意事项 - 芯片型号 - Tang Mega 60K 使用的 FPGA 芯片具体型号是 GW5AT-LV60PG484A
在 IDE 中选择封装型号 PBG484A
+ 供电电压 + Tang Console 使用的 电源电压是 DC +5V +
请避免供电电压超过+5.5V或低于+3.4V +
请使用输出能力至少为5V/2A的USB 适配器供电
静电 - 请避免静电打到 PCBA 上；接触 PCBA 之前请把手的静电释放掉 + 请避免静电打到 PCBA 上，如非必要请勿随意自行拆解装置的外壳 +
如需拆卸外壳，在接触 PCBA 之前请把手的静电释放掉，比如用自来水洗手 容忍电压 - 使用 GPIO 排针引脚进行外部通信时，要确保 IO 电压是 3.3V，过高的电压会永久损坏 PCBA + 使用 GPIO 排针引脚进行外部通信时，要确保 IO 电压是 3.3V，过高的电压会永久损坏 PCBA +
非专业用户请勿使用排针连接官方配件以外的任何设备或模组 FPC 座子 - 在连接 FPC 软排线的时候，请确保排线无偏侈地完整地插入到排线中 - - - PCIe 金手指 - 在测试 PCIe 金手指时候，确保是主机端与板卡都处于关机或者未通电的状态，否则可能会因为插入过程中的易位导致金手指短路。 + 在连接 FPC 软排线的时候，请确保排线无偏侈地完整地插入到排线中 +
在通电之前请仔细核对两端FPC 连接器的 1号PIN 的方向是否正确 插拔 - 请完全断电后才进行插拔操作 + 除了USB-A手柄和USB驱动器/读卡器 +
请完全断电后才进行配件的插拔操作 + + + USB手柄 + USB-A手柄连接到Console正面的USB-A时不太稳定 +
如遇USB手柄无法操作，请多插拔几次 避免短路 @@ -145,47 +287,61 @@ port: 10559 ## 联系 -Tang Mega 60K 可以在多种场景实现客户不同方面的需要，技术支持和商业合作请联系邮箱 [support@sipeed.com](support@sipeed.com) +技术支持和商业合作请联系邮箱 [support@sipeed.com](support@sipeed.com) ## 常见问题 -### 板子电源指示灯亮了，Programmer提示No USB Cable Connection +### USB手柄无法操作 -1. 请检查USB线是否正确接入标记为 **MCU** 的USB-C连接器 -2. 尽量避免使用机箱前面板的USB连接器和没有独立供电的USB HUB -3. 检查自己是否正确安装FT2232的驱动：出现USB Serial Converter A/B +
+点击查看详情 +
+ + 1. 请重新拔插USB手柄后再尝试操作； + 2. Console正面的USB-A手柄的稳定性会在之后的固件更新中解决； + 3. 目前最稳定连接方式为PMOD DS2手柄； +
-flash_mode +### 按下MODE键后UI消失 -4. 通常情况下Windows会在联网后自动安装相应驱动。如果想要手动处理，请前往[相关问题](./../common-doc/questions.md)查看相关内容 +
+点击查看详情 +
-5. 尝试更新板载下载器的固件，请参考这里 **[【点我跳转】](./../common-doc/update_debugger.md)** + 1. 目前是已知问题，会在未来的固件更新中解决； + 2. 如果画面中游标 `>` 还在，可以尝试用手柄操作翻页或返回上级等操作强迫UI刷新； -### IDE找不到型号GW5AT-LV60PG484A 或 GW5AST-LV138PG484A +
-1. 教育版不支持60K和138K，请更换商业版。如下图所示即为教育版（不支持60K）； +### 上电后显示 `Waiting for USB drive...` - +
+点击查看详情 +
-2. IDE版本过老，必须更新IDE ≥ 1.9.10.01。 + 1. 如果使用了USB HUB，这可能意味着HUB不兼容； + 2. 请确保正确连接了USB驱动器/读卡器； + 3. 请确保USB驱动器/读卡器的容量 **≤32GB**，且格式化为 **FAT32/exFAT**； -### 如何下载到外部 FLASH（固化） {#burn_flash} + -1. 进行如下选项设置： +
-flash_mode + ### GBATang提示 `Cannot find /gba_bios.bin...` -### 烧录后没反应或者引脚现象不对 +
+点击查看详情 +
-1. 首先确定IDE选择了正确的型号 -- 对于60K，**GW5AT-LV60PG484AC1/10**，下图中的每一个参数都要求一致； + 1. 这意味着 **USB驱动器/存储卡** 中的`/GBA`目录下缺失了GBA原始的BIOS，可能会引起一些ROM的兼容性问题； + 2. 因为版权问题，我们无法向您提供这份档案，您需要自行寻找`gba_bios.bin`并放入相应的位置； -device_choose - -- 对于138K，**GW5AST-LV138PG484AC1/10**，下图中的每一个参数都要求一致； + -device_choose +
-2. 然后检查自己的代码和对应的仿真波形是否满足要求，使用云源软件（GOWIN IDE）的GAO工具可以进行片上仿真。更多详情请参考GOWIN文档[SUG100](https://cdn.gowinsemi.com.cn/SUG100-4.0_Gowin%E4%BA%91%E6%BA%90%E8%BD%AF%E4%BB%B6%E7%94%A8%E6%88%B7%E6%8C%87%E5%8D%97.pdf)中关于GAO工具的描述。 +### 更多问题及其解决办法前往Tang Core的文档中的 [Troubleshooting](https://nand2mario.github.io/tangcore/user-guide/troubleshooting/) 页面查看 -### 更多问题及其解决办法前往[相关问题](./../common-doc/questions.md)查看 +如果你不幸遇到了一个全新的问题，欢迎向我们反馈。 + +反馈方式请参考 [**这里**](#交流方式)。 diff --git a/pages/index/zh/retroconsole.html b/pages/index/zh/retroconsole.html new file mode 100644 index 00000000..bb034589 --- /dev/null +++ b/pages/index/zh/retroconsole.html @@ -0,0 +1,16 @@ + \ No newline at end of file