Skip to content

Commit

Permalink
Merge pull request #757 from kyonmiriam/main
Browse files Browse the repository at this point in the history
Add pages for tang mega console
  • Loading branch information
Zepan authored Feb 6, 2025
2 parents 5276fad + 430e724 commit cc1e339
Show file tree
Hide file tree
Showing 19 changed files with 2,401 additions and 1,721 deletions.
9 changes: 9 additions & 0 deletions docs/hardware/en/sidebar.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -362,6 +362,15 @@ items:
- label: Questions&Answers
file: tang/Tang-Nano-Doc/questions.md
target: _blank
- label: Tang Console
items:
- label: Introduction
file: tang/tang-console/mega-console.md
- label: Install IDE
file: tang/Tang-Nano-Doc/install-the-ide.md
- label: Questions&Answers
file: tang/Tang-Nano-Doc/questions.md
target: _blank
- label: Tang PMOD
file: tang/tang-PMOD/FPGA_PMOD.md
- label: MaixSense
Expand Down
1 change: 1 addition & 0 deletions docs/hardware/en/tang/common/update_debugger.md
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
TBD
4 changes: 2 additions & 2 deletions docs/hardware/en/tang/readme.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
title: Tang FPGA Board
---

Tang FPGA Board contains Tang Nano and Tang Primer.
Tang FPGA Board contains Tang Nano and Tang Primer, and Tang Mega

| Tang Nano | Tang Primer |
| --------------------------------------------------------------------- | ------------------------------------------------------------------------- |
Expand Down Expand Up @@ -37,7 +37,7 @@ So many different Tang Nano FPGA Boards are listed, there must be one fits you.
</thead>
<tbody>
<tr>
<td style="text-align:center"><a href="/nano20k"><img src="/hardware/assets/Tang/nano_20k/tang_nano_20k_3920_top.png" alt="Tang Nano 20K"></a></td>
<td style="text-align:center"><a href="/nano20k"><img src="./../../assets/Tang/Nano_20K/Nano_20K.png" alt="Tang Nano 20K"></a></td>
<td style="text-align:center"><a href="./Tang-Nano-9K/Nano-9K.html"><img src="./../../assets/Tang/Nano-9K/9K.png" alt="Tang Nano 9K"></a></td>
</tr>
</tbody>
Expand Down
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
191 changes: 191 additions & 0 deletions docs/hardware/en/tang/tang-console/mega-console.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,191 @@
---
title: Tang Mega Console
keywords: FPGA, Tang, Console, 60K, 138K
update:
- date: 2025-01-23
version: v0.1
author: Serika
content:
- Create document
---

## 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.

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.

- Date to Release: Late March , 2025

- Pre-sale link: [Click me](https://sipeed.com/tangconsole)

## Board Features

- 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
- PCIe 2.0 x 1
- USB3 x 2(5Gbps)
- HDMI TX x 1
- Soft-PHY USB2 x1(480Mbps)
- Onboard 3.7V Li-on battery(1-Series) charge/discharge management

## Product Appearance

<img src="./.assert/console_60k.png" width="45%">

## Block Diagram

TBD

## Hardware Parameters

### SOM Board Parameters

Please refer to the link below:
- **[Tang Mega 138k](./../tang-mega-138k/mega-138k.md#hardware-parameters) SOM**
- **[Tang Mega 60k](./../tang-mega-60k/mega-60k.md#hardware-parameters) SOM**


### Dock board Parameters

| Item | Quantity | Remarks |
| :------------------ | ---- | ------------------------------------------------- |
| LEDs | 2(3+3) | 3x Battery-Indicator + 3x User LED (2x RGB LED) |
| Buttons | 2+1 | 2x User-KEY + 1x Reconfig-KEY |
| PCIe | 1 | 1-lane @ 8/5Gbps (Depends on SOM) |
| USB3 | 2 | SERDES lane, SuperSpeed @ 5Gbps (Device mode) |
| USB2 | 1 | IO Soft-PHY, HighSpeed @ 480Mbps (Device mode) |
| DVI(HDMI) | 1 | Compatible with HDMI, supports TX, can also be modified to RX |
| PMOD | 2 | Multiplexed with the the DVP CONN. & 2x20P header at the top of the Dock board |
| ADC | 2 | 2x differential input channels (One is used to measure the battery voltage) |
| RGB Interface | 1 | Supports RGB888 screen |
| SD Slot | 1 | 4-bit SDIO/MMC or SPI mode |
| BATT CONN. | 1 | Supports 3.7V li-on battery, with built-in charge management |
| FAN CONN. | 1 | Supports a 5V fan |
| Speaker CONN. | 1 | Support mono output, 1x 2W Speaker |
| MS5351 | 1 | Provides RefClk for Serdes; control output via onboard UART |
| USB JTAG & UART | 1 | Supports FPGA programming and provides UART function |
| 2x20P headers | 2 | 2x20P header at the top of the Dock board multiplexed with the the PMOD & DVP CONN. |


## Hardware Resources

- ~~[Specification](https://dl.sipeed.com/shareURL/TANG/Console/01_Specification)~~
- [Schematics](https://dl.sipeed.com/shareURL/TANG/Console/02_Schematic)
- [PCB BOM](https://dl.sipeed.com/shareURL/TANG/Console/03_Designator_drawing)
- [Dimension Diagram](https://dl.sipeed.com/shareURL/TANG/Console/04_Mechanical_drawing)
- [3D Model](https://dl.sipeed.com/shareURL/TANG/Console/05_3D_file)
- [Some Chip Manuals](https://dl.sipeed.com/shareURL/TANG/Console/07_Datasheet)
- [All PIN Constraints](https://dl.sipeed.com/shareURL/TANG/Console/08_Misc)

## Getting Started

Note that **`Tang Mega 60k`** & **`Tang Mega 138k`** is currently not supported by the education version, and you need to download V1.9.11 or a newer version of the commercial IDE for use.
Lic can be applied on the Gowin official website, or you can use the online Lic service provided by Sipeed. In the IDE, select Float Lic and fill in the following information:

~~~
---Server 01---
ip: 45.33.107.56
port: 10559
---Server 02---
ip: 106.55.34.119
port: 10559
~~~

if the ip not work, try use "gowinlic.sipeed.com" domain's IP.

Install IDE [Click me](https://wiki.sipeed.com/hardware/zh/tang/Tang-Nano-Doc/get_started/install-the-ide.html)


Example code [github](https://github.com/sipeed/TangMega-60K-example)

- Other Learning Resources

- Free online tutorial: [Verilog Tutorial](https://www.runoob.com/w3cnote/verilog-tutorial.html) (Learn Verilog)
- Free online FPGA tutorial: [Verilog](https://www.asic-world.com/verilog/index.html) (English website)
- Verilog practice website: [HDLBits](https://hdlbits.01xz.net/wiki/Main_Page) (English website)
- Online Gowin Semiconductor reference video tutorials: [Click here](http://www.gowinsemi.com.cn/video_complex.aspx?FId=n15:15:26)

## Communication Methods

- **Reddit** : [reddit.com/r/GowinFPGA/](reddit.com/r/GowinFPGA/)
- **Telegram** : [t.me/sipeed](t.me/sipeed)
- Discussion forum: [maixhub.com/discussion](https://maixhub.com/discussion)
- QQ discussion group: [834585530](https://jq.qq.com/?_wv=1027&k=wBb8XUan)
- Leave a message directly below this page
- Goto**[GitHub project page](https://github.com/sipeed/TangMega-60K-example)**and submit issues
- Business email : [[email protected]]([email protected])

## Precautions

<table>
<tr>
<th>Item</th>
<th>Precautions</th>
</tr>
<tr>
<td>Chip Model</td>
<td>The specific model of the FPGA chip used by Tang Mega 60K is <b>GW5AT-LV60PG484A, and Tang Mega 138K is <b>GW5AST-LV138FPG676A</b>.</b> <br>Please select the package model <b>PBG484A</b> in the IDE.</td>
</tr>
<tr>
<td>Static Electricity</td>
<td>Please avoid static electricity hitting the PCBA; release the static electricity from your hands before touching the PCBA.</td>
</tr>
<tr>
<td>Tolerance Voltage</td>
<td>When using GPIO pin headers for external communication, ensure that the IO voltage is <b>3.3V</b>. Excessive voltage will permanently damage the PCBA.</td>
</tr>
<tr>
<td>FPC Socket</td>
<td>When connecting the FPC soft cable, please ensure that the cable is completely and correctly inserted into the socket without any deviation.</td>
</tr>
<tr>
<td>Plug and Unplug</td>
<td>Please completely power off before plugging and unplugging.</td>
</tr>
<tr>
<td>Avoid Short Circuit</td>
<td>Please avoid any liquid or metal touching the solder pads of the components on the PCBA during the power-on process, otherwise it may cause a short circuit and burn the PCBA.</td>
</tr>
</table>


## Contact

Tang Console can meet different needs of customers in various scenarios. For technical support and business cooperation, please contact [[email protected]]([email protected])


## Frequently Asked Questions (FAQs)

### How to update the firmware for the onboard debugger

- See [Update the debugger](./../common/update_debugger.md) for details.

### IDE cannot find the model

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);
<img src="../assets/questions/no_model_in_IDE.png" width="35%">

2. IDE version is too low to use, update the IDE version ≥ **1.9.9**.

### How to burn the bitstream to FLASH {#burn_flash}

1. Setting the **Programmer** as shown in the figure below:

<img src="./../assets/flash_mode_GAO.png" alt="flash_mode" width=35%>

2. Check the position of the DIP switch; the correct position is shown in the figure below:

<img src="./assets/dip-key_defualt.png" alt="dip-key_defualt" width=35%>

### No Response or Undesirable Pin Phenomenon After Burning

1. First, ensure that the IDE has selected the correct model **GW5AT-LV60PG484AC1/10**; every parameter in the figure below **MUST** be consistent.

<img src="./assets/partno_60K.png" alt="device_choose" width=35%>

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](./../Tang-Nano-Doc/questions.md) to view
11 changes: 10 additions & 1 deletion docs/hardware/en/tang/tang-mega-138k/mega-138k-pro.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,11 @@ update:
author: Serika
content:
- Update FAQs
- date: 2025-01-24
version: v0.3
author: Serika
content:
- Add Secondary lic server ip addr.
---

- Product Overview
Expand Down Expand Up @@ -183,7 +188,7 @@ update:

## Hardware Resources

[Board Specification](https://dl.sipeed.com/shareURL/TANG/Mega_138K_Pro/01_Specification)
~~[Board Specification](https://dl.sipeed.com/shareURL/TANG/Mega_138K_Pro/01_Specification)~~
[Board Schematic](https://dl.sipeed.com/shareURL/TANG/Mega_138K_Pro/02_Schematic)
[PCB BOM](https://dl.sipeed.com/shareURL/TANG/Mega_138K_Pro/03_Designator_drawing)
[Board Dimension Diagram](https://dl.sipeed.com/shareURL/TANG/Mega_138K_Pro/04_Mechanical_drawing)
Expand Down Expand Up @@ -276,6 +281,10 @@ Tang Mega 138K can meet different needs of customers in various scenarios. For t

## Frequently Asked Questions (FAQs)

### How to update the firmware for the onboard debugger

- See [Update the debugger](./../common/update_debugger.md) for details.

### The power light is not on after the board is powered on

1. Please check if the power switch of the board is turned on.
Expand Down
20 changes: 14 additions & 6 deletions docs/hardware/en/tang/tang-mega-138k/mega-138k.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,11 @@ update:
author: Serika
content:
- Corrected description of PCIe bus widths
- date: 2025-01-24
version: v0.3
author: Serika
content:
- Add Secondary lic server ip addr.
---

## Overview
Expand Down Expand Up @@ -160,13 +165,12 @@ TBD
| LEDs | 4+8 | 4x Battery-Indicator+ 8x PMOD_LED |
| WS2812 | 1 | The WS2812 & aRGB strip CONN. share the same pin |
| Buttons | 3+1 | 3x User-KEY + 1x Reconfig-KEY |
| PCIe | 1 | 4-lane @ 5Gbps,CH569 16bit HSPI |
| USB3 | 2 | SuperSpeed @ 5Gbps |
| GbE | 1 | 1000Mbps Ethernet |
| DVI | 1 | DVI supports both RX and TX |
| PCIe | 1 | 1-lane @ 5Gbps |
| USB3 | 1 | CH569 16bit HSPI, SuperSpeed @ 5Gbps |
| Ethernet | 1 | 1000Mbps Ethernet |
| DVI(HDMI) | 1 | DVI supports both RX and TX |
| PMOD | 2 | Multiplexed with the the DVP CONN. & 2x20P header at the top of the Dock board |
| ADC | 2 | 2x differential input channels |
| WS2812 | 1 | The aRGB strip CONN. & WS2812 share the same pin |
| DVP Interface | 1 | Multiplexed with the the PMOD & 2x20P header at the top of the Dock board |
| RGB Interface | 1 | Supports RGB888 screen |
| MIC ARRAY Interface | 1 | Supports Sipeed 6+1 microphone array |
Expand All @@ -183,7 +187,7 @@ TBD

## Hardware Resources

- [Specification](https://dl.sipeed.com/shareURL/TANG/Mega_138K_60K/01_Specification)
- ~~[Specification](https://dl.sipeed.com/shareURL/TANG/Mega_138K_60K/01_Specification)~~
- [Schematics](https://dl.sipeed.com/shareURL/TANG/Mega_138K_60K/02_Schematic)
- [PCB BOM](https://dl.sipeed.com/shareURL/TANG/Mega_138K_60K/03_Designator_drawing)
- [Dimension Diagram](https://dl.sipeed.com/shareURL/TANG/Mega_138K_60K/04_Mechanical_drawing)
Expand Down Expand Up @@ -274,6 +278,10 @@ Tang Mega 138K can meet different needs of customers in various scenarios. For t

## Frequently Asked Questions (FAQs)

### How to update the firmware for the onboard debugger

- See [Update the debugger](./../common/update_debugger.md) for details.

### After powering on the board, only four indicator lights on the dockboard are on, the SOM indicator light is not on

1. Please check if the board’s power has been turned on, press and hold the PWR button (next to the HDMI port) for 2 seconds to turn on the power.
Expand Down
Loading

0 comments on commit cc1e339

Please sign in to comment.