nestang
说明： NESTang是一款用Sipeed Tang Nano 20K和Primer 20K板实现的FPGA任天堂娱乐系统
(NESTang is an FPGA Nintendo Entertainment System implemented with Sipeed Tang Nano 20K and Primer 20K boards)
(NESTang is an FPGA Nintendo Entertainment System implemented with Sipeed Tang Nano 20K and Primer 20K boards)
文件列表:
CHANGES.md (1740, 2023-06-04)
COPYING (35146, 2023-06-04)
doc (0, 2023-06-04)
doc\build.md (1048, 2023-06-04)
doc\images (0, 2023-06-04)
doc\images\SSPI_pins_as_GPIO.png (20187, 2023-06-04)
doc\images\linux_bottom.jpg (101383, 2023-06-04)
doc\images\linux_top.jpg (29782, 2023-06-04)
doc\images\nestang0.5.jpg (268904, 2023-06-04)
doc\images\setup.jpg (107929, 2023-06-04)
doc\images\verilog_language_selection.png (16595, 2023-06-04)
doc\images\wiring.jpg (73575, 2023-06-04)
doc\linux.md (1385, 2023-06-04)
doc\sdimage.md (2614, 2023-06-04)
doc\wiring.md (1331, 2023-06-04)
docs (0, 2023-06-04)
docs\index.html (131, 2023-06-04)
loader (0, 2023-06-04)
loader\Makefile (299, 2023-06-04)
loader\loader.sln (1401, 2023-06-04)
loader\loader.vcxproj (6945, 2023-06-04)
loader\nes_loader.cpp (6056, 2023-06-04)
loader\osd.cpp (6139, 2023-06-04)
loader\osd.h (174, 2023-06-04)
loader\stdafx.cpp (285, 2023-06-04)
loader\stdafx.h (305, 2023-06-04)
loader\targetver.h (306, 2023-06-04)
loader\util.cpp (30401, 2023-06-04)
loader\util.h (1185, 2023-06-04)
nes.gprj (3168, 2023-06-04)
src (0, 2023-06-04)
src\MicroCode.v (115367, 2023-06-04)
src\apu.v (25900, 2023-06-04)
src\autofire.v (686, 2023-06-04)
src\compat.v (562, 2023-06-04)
src\config.sv (1208, 2023-06-04)
src\cpu.v (11294, 2023-06-04)
... ...
COPYING (35146, 2023-06-04)
doc (0, 2023-06-04)
doc\build.md (1048, 2023-06-04)
doc\images (0, 2023-06-04)
doc\images\SSPI_pins_as_GPIO.png (20187, 2023-06-04)
doc\images\linux_bottom.jpg (101383, 2023-06-04)
doc\images\linux_top.jpg (29782, 2023-06-04)
doc\images\nestang0.5.jpg (268904, 2023-06-04)
doc\images\setup.jpg (107929, 2023-06-04)
doc\images\verilog_language_selection.png (16595, 2023-06-04)
doc\images\wiring.jpg (73575, 2023-06-04)
doc\linux.md (1385, 2023-06-04)
doc\sdimage.md (2614, 2023-06-04)
doc\wiring.md (1331, 2023-06-04)
docs (0, 2023-06-04)
docs\index.html (131, 2023-06-04)
loader (0, 2023-06-04)
loader\Makefile (299, 2023-06-04)
loader\loader.sln (1401, 2023-06-04)
loader\loader.vcxproj (6945, 2023-06-04)
loader\nes_loader.cpp (6056, 2023-06-04)
loader\osd.cpp (6139, 2023-06-04)
loader\osd.h (174, 2023-06-04)
loader\stdafx.cpp (285, 2023-06-04)
loader\stdafx.h (305, 2023-06-04)
loader\targetver.h (306, 2023-06-04)
loader\util.cpp (30401, 2023-06-04)
loader\util.h (1185, 2023-06-04)
nes.gprj (3168, 2023-06-04)
src (0, 2023-06-04)
src\MicroCode.v (115367, 2023-06-04)
src\apu.v (25900, 2023-06-04)
src\autofire.v (686, 2023-06-04)
src\compat.v (562, 2023-06-04)
src\config.sv (1208, 2023-06-04)
src\cpu.v (11294, 2023-06-04)
... ...
# NESTang - FPGA NES with Sipeed Tang Nano 20K and Primer 20K Boards
NESTang is an open source project to recreate the Nintendo Entertainment System (NES) with modern affordable FPGA boards including Sipeed [Tang Nano 20K](https://wiki.sipeed.com/hardware/en/tang/tang-nano-20k/nano-20k.html) and [Primer 20K](https://wiki.sipeed.com/hardware/en/tang/tang-primer-20k/primer-20k.html). The main logic comes from [fpganes](https://github.com/strigeus/fpganes), to which I have added SDRAM/DDR3 and HDMI interfaces, among other features.
Main features,
- HDMI output with a resolution of 720p and sound capabilities.
- Cycle accurate gameplay quality has been achieved since the NES circuits have been almost entirely replicated.
- Game loading via MicroSD cards (for Tang Nano 20K only) or Windows/Linux loader program.
- Playstation 2 controller interface (for Tang Nano 20K only) or interfacing with controllers connected through a PC.
## Setup for Tang Nano 20K
The best way to experience NESTang is with the Tang Nano 20K (Retro Game Kit version), which cost $38 last time I checked. The board features FPGA-friendly SDRAM memory. And the kit includes the necessary controller adapters and a pair of controllers. Here's what you need to run NESTang:
* The Tang Nano 20K board.
* Sipeed ps2 controller adapters connected to the board's pin 15-20 on both sides.
* Playstation controllers (wired or wireless) connected to the adapters.
* HDMI cable to connect the board to a monitor.
* NESTang 0.5 program downloaded from [github](https://github.com/nand2mario/nestang/releases) and transferred to the board using either [openFPGALoader](https://github.com/trabucayre/openFPGALoader) or Gowin programmer.
* A MicroSD card to hold ROMs. An 8GB cards should suffice. The `tools/nes2img.py` python program can be used to convert .nes ROM files to an .img file. Ensure that you have Python version 3.7 or higher, and then install the Pillow package using `pip3 install pillow`. You can then use an SD imaging tool such as [Balena Etcher](https://www.balena.io/etcher) to burn the newly created image onto the MicroSD card.
* Insert the MicroSD card and power up the board to start playing your favorite games!
## Setup for Tang Primer 20K
If you own a Tang Primer 20K board, you can also run NESTang. The following components are required:
* Sipeed Tang Primer 20K board
* Muse-Lab HDMI PMod if you got the "lite" version of Tang board. You can purchase it from [aliexpress](https://www.aliexpress.com/item/3256804122775243.html) or [taobao](https://item.taobao.com/item.htm?id=671021594308). The "dock" version of the board already has an HDMI port, so there is no need for this component. The wiring instructions for the "lite" version can be found in the [doc/wiring.md](doc/wiring.md) file.
Follow the instructions below:
* Download [NESTang 0.4](https://github.com/nand2mario/nestang/releases/tag/v0.4) since later versions only support Tang Nano 20K.
* Launch the **Gowin Programmer** application and program either the `nestang-lite.fs` or `nestang-dock.fs` file, depending on your specific board. If your setup is correctly configured, a colorful NES palette should be displayed.
* Connect your game controller/controllers to your PC. I use a pair of old Xbox 360 controllers.
* Use the command `loader.exe -c COM4 games\rom.nes` (replace COM4 with your port number) to load the game `rom.nes`. If the game does not load, install [Microsoft Visual C++ Redistributable package](https://aka.ms/vs/17/release/vc_redist.x***.exe) to resolve any missing DLL errors.
* Press the left button (LB) to open the in-game OSD menu, from where you can load other games located in the `games` directory.
* If the game does not load, run `loader.exe -r game.nes` to generate error messages from the core.
Congratulations! Now you can enjoy all your favorite NES games. For version 0.4, a Linux loader program is also available. See [Linux loader](doc/linux.md) for details.
## Development
If you want to generate the bitstream from source, see [Build Instructions](https://nand2mario.github.io/nestang-doc/dev/build_bitstream/).
Quite some time was spent on getting a low-latency (90ns) [DDR3 controller](https://github.com/nand2mario/ddr3-tang-primer-20k) to work for Tang Primer 20K. You may find that useful too.
## Next steps
See NESTang [changes.md](CHANGES.md).
Here are what I may work on when I get time. No promise though. Suggestions and pull requests are welcome!
* Support more games.
* An enclosure?
* Cheats support.
* Saves and loads.
## Special Thanks
* [fpganes](https://github.com/strigeus/fpganes) by Ludvig Strigeus.
* [hdl-util/hdmi](https://github.com/hdl-util/hdmi) by Sameer Puri.
nand2mario (`nand2mario at outlook.com`)
Since 2022.9
NESTang is an open source project to recreate the Nintendo Entertainment System (NES) with modern affordable FPGA boards including Sipeed [Tang Nano 20K](https://wiki.sipeed.com/hardware/en/tang/tang-nano-20k/nano-20k.html) and [Primer 20K](https://wiki.sipeed.com/hardware/en/tang/tang-primer-20k/primer-20k.html). The main logic comes from [fpganes](https://github.com/strigeus/fpganes), to which I have added SDRAM/DDR3 and HDMI interfaces, among other features.
Main features,
- HDMI output with a resolution of 720p and sound capabilities.
- Cycle accurate gameplay quality has been achieved since the NES circuits have been almost entirely replicated.
- Game loading via MicroSD cards (for Tang Nano 20K only) or Windows/Linux loader program.
- Playstation 2 controller interface (for Tang Nano 20K only) or interfacing with controllers connected through a PC.
## Setup for Tang Nano 20K
The best way to experience NESTang is with the Tang Nano 20K (Retro Game Kit version), which cost $38 last time I checked. The board features FPGA-friendly SDRAM memory. And the kit includes the necessary controller adapters and a pair of controllers. Here's what you need to run NESTang:
* The Tang Nano 20K board.
* Sipeed ps2 controller adapters connected to the board's pin 15-20 on both sides.
* Playstation controllers (wired or wireless) connected to the adapters.
* HDMI cable to connect the board to a monitor.
* NESTang 0.5 program downloaded from [github](https://github.com/nand2mario/nestang/releases) and transferred to the board using either [openFPGALoader](https://github.com/trabucayre/openFPGALoader) or Gowin programmer.
* A MicroSD card to hold ROMs. An 8GB cards should suffice. The `tools/nes2img.py` python program can be used to convert .nes ROM files to an .img file. Ensure that you have Python version 3.7 or higher, and then install the Pillow package using `pip3 install pillow`. You can then use an SD imaging tool such as [Balena Etcher](https://www.balena.io/etcher) to burn the newly created image onto the MicroSD card.
* Insert the MicroSD card and power up the board to start playing your favorite games!
## Setup for Tang Primer 20K
If you own a Tang Primer 20K board, you can also run NESTang. The following components are required:
* Sipeed Tang Primer 20K board
* Muse-Lab HDMI PMod if you got the "lite" version of Tang board. You can purchase it from [aliexpress](https://www.aliexpress.com/item/3256804122775243.html) or [taobao](https://item.taobao.com/item.htm?id=671021594308). The "dock" version of the board already has an HDMI port, so there is no need for this component. The wiring instructions for the "lite" version can be found in the [doc/wiring.md](doc/wiring.md) file.
Follow the instructions below:
* Download [NESTang 0.4](https://github.com/nand2mario/nestang/releases/tag/v0.4) since later versions only support Tang Nano 20K.
* Launch the **Gowin Programmer** application and program either the `nestang-lite.fs` or `nestang-dock.fs` file, depending on your specific board. If your setup is correctly configured, a colorful NES palette should be displayed.
* Connect your game controller/controllers to your PC. I use a pair of old Xbox 360 controllers.
* Use the command `loader.exe -c COM4 games\rom.nes` (replace COM4 with your port number) to load the game `rom.nes`. If the game does not load, install [Microsoft Visual C++ Redistributable package](https://aka.ms/vs/17/release/vc_redist.x***.exe) to resolve any missing DLL errors.
* Press the left button (LB) to open the in-game OSD menu, from where you can load other games located in the `games` directory.
* If the game does not load, run `loader.exe -r game.nes` to generate error messages from the core.
Congratulations! Now you can enjoy all your favorite NES games. For version 0.4, a Linux loader program is also available. See [Linux loader](doc/linux.md) for details.
## Development
If you want to generate the bitstream from source, see [Build Instructions](https://nand2mario.github.io/nestang-doc/dev/build_bitstream/).
Quite some time was spent on getting a low-latency (90ns) [DDR3 controller](https://github.com/nand2mario/ddr3-tang-primer-20k) to work for Tang Primer 20K. You may find that useful too.
## Next steps
See NESTang [changes.md](CHANGES.md).
Here are what I may work on when I get time. No promise though. Suggestions and pull requests are welcome!
* Support more games.
* An enclosure?
* Cheats support.
* Saves and loads.
## Special Thanks
* [fpganes](https://github.com/strigeus/fpganes) by Ludvig Strigeus.
* [hdl-util/hdmi](https://github.com/hdl-util/hdmi) by Sameer Puri.
nand2mario (`nand2mario at outlook.com`)
Since 2022.9
近期下载者：
相关文件：
收藏者：