Skip to content

Commit

Permalink
update doc 0.6
Browse files Browse the repository at this point in the history
  • Loading branch information
nand2mario committed Mar 19, 2024
1 parent 76542f8 commit 1d1efa6
Show file tree
Hide file tree
Showing 2 changed files with 11 additions and 14 deletions.
24 changes: 11 additions & 13 deletions doc/installation.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,15 +12,15 @@ You also need a Windows computer, Dualshock 2 controllers and a MicroSD card.

For Tang Primer 25K, plug in the modules as follows.

![](images/primer25k_setup.jpg){ width=400px }
<img src="images/primer25k_setup.jpg" width=400>

For Tang Nano 20K, connect the controllers adapters as follows,

![](images/nano20k_setup.jpg){ width=400px }
<img src="images/nano20k_setup.jpg" width=400>

For Tang Mega 138K Pro,

![](images/mega138k_pro_setup.jpg){ width=400px }
<img src="images/mega138k_pro_setup.jpg" width=400>

## 2. Download SNESTang and Install Gowin IDE

Expand All @@ -30,47 +30,45 @@ In order to transfer these files to the board, you need the Gowin IDE from the F

Once the Gowin IDE installer finishes downloading, extract, run and install everything, including the "programmer" and device drivers.

![](images/install_programmer.png){ width=400px }

![](images/install_drivers.png){ width=400px }
<img src="images/install_programmer.png" width=400> <img src="images/install_drivers.png" width=400>

## 3. Install the bitstream (snestang_*.fs)

Now plug the FPGA board to your computer using the USB cable that comes with it. Then launch the "Gowin Programmer" application.

![](images/programmer_init.png){width=400px}
<img src="images/programmer_init.png" width=400>

Just press SAVE. Then choose the right Series and Device for your board. Tang Primer 25K is GW5A and GW5A-25A. Tang Nano 20K is GW2AR and GW2AR-18. Tang Mega 138K Pro is GW5AST and GWS5AST-138B.

![](images/programmer_series.png){width=400px}
<img src="images/programmer_series.png" width=400>

Now double click "Bypass" in Operation. In the window that pops up, choose "External Flash Mode" for Access Mode. For Operation, choose "exFlash Erase, Program 5AT" (for Tang Primer 25K and Tang Mega 138K Pro) or "exFlash Erase, Program thru GAO-bridge" (for Tang Nano 20K). Then for File Name, choose the `snestang_*.fs` file for your board. Then press "Save" to dispose of the window.

![](images/programmer_flash.png){width=300px}
<img src="images/programmer_flash.png" width=300>

Now press the button with a play icon on the toolbar to actually start the transfer.

![](images/programmer_doit.png){width=400px}
<img src="images/programmer_doit.png" width=400>

It will take about 30 seconds. Now the FPGA bitstream is ready.

## 4. Install the firmware (firmware.bin)

The final step is to transfer the firmware to the board. The firmware is also stored in the on-board SPI flash chip, albeit at a different address than the bitstream. So we also use the Gowin programmer for that. Double click "exFlash Erase, Program 5AT" (for Tang Primer 25K and Mega 138K Pro), or "exFlash Erase, Program thru GAO-bridge" (for Tang Nano 20K) in the Operation field. In the popup window, press the "..." beside the filename to choose the SNESTang "firmware.bin". In the pop-up, you probably need to change the file type filter to `*.*` to be able to choose the `.bin` file. Then set Start Address to `0x500000`, which is the address for the firmware. Then press "Save" to close the window.

![](images/programmer_firmware.png" width=300>
<img src="images/programmer_firmware.png" width=300>

Now press the button with a play icon on the toolbar again to start the transfer.

![](images/programmer_doit.png){width=400px}
<img src="images/programmer_doit.png" width=400>

**That is all!** SNESTang installation is now finished.

## Finished

Plug in the controller, HDMI cable and a SD card loaded with ROM files. FAT16, FAT32 or exFAT file systems are supported. Connect the USB cable. You should see this main screen on your monitor/tv, from where you can load your games.

![](images/mainscreen.jpg){width=400px}
<img src="images/mainscreen.jpg" width=400>

When a game is running, press SELECT-RB (right button) to call out the menu again and load other games.

Expand Down
1 change: 0 additions & 1 deletion doc/installation.sh

This file was deleted.

0 comments on commit 1d1efa6

Please sign in to comment.