Tang Nano 20K MisteryNano - Maverick-Shark/retroGuru GitHub Wiki

Tang Nano 20K - MisteryNano

Linux Debian procedure - Till Harbaum Shield - MiSTERY, NanoMIG. - Stefan Voß - C64, VIC-20...

Source: https://www.reddit.com/r/fpgagaming/comments/1dveezs/tang_nano_20k_linux_debian_procedure_till_harbaum/?rdt=63539

Thanks to all the people involved in the Tang Nano 20K!

The purpose of MisteryNANO, NanoMig, C64, VIC-20, etc is to be able to order it yourself, without having to solder and without waiting. I agree with vanfanel.

First Step:

We ordered the "motherboard" board at JLCPCB. (About 100 euros for a pack of 5 plates: the minimum order is that, 5 plates).

For it:

• We are going to ORDER NOW.

• We click on "Add Gerber File", and upload this ZIP with the Gerbers: https://github.com/harbaum/MiSTeryNano/blob/main/board/misteryshield20k/jlcpcb/gerber_m0s.zip

• We activate "PCB Assembly", and in "ADVANCED OPTIONS" we activate "Board Cleaning", "Bake Components" and "Depanel boards"

• We press "NEXT"

• On the next screen, which is simply a render/preview of the board, click "NEXT"

• On the next screen:

• In "Add BOM File" we upload this: https://github.com/harbaum/MiSTeryNano/blob/main/board/misteryshield20k/jlcpcb/bom_m0s.csv

• In "Add CPL File" we upload this: https://github.com/harbaum/MiSTeryNano/blob/main/board/misteryshield20k/jlcpcb/positions_m0s.csv

• In the next two screens we also click on "NEXT", in "Product Description" we choose "Audio Equipment" and at the end we click on "SAVE TO CART".

• When paying for what we have in the cart, in the shipping method, we use IOSS, which is supposed to already include taxes at the time of making the card payment.

Second Step:

On Aliexpress we ordered the TangNano 20k and the M0S Dock: (About 35 euros each TangNano 20k and about 7.5 euros each M0S Dock)

• We ordered the TangNano 20K from its official store: https://es.aliexpress.com/item/1005005581148230.html

• NOTE: We choose the "TangNano 20K with soldered pin header" option, which is the second from the right. Do not order the TangNano 20k without soldered pins!! Careful!!

• We ordered the M0S Dock from its official store: https://es.aliexpress.com/item/1005005298084680.html

NOTE: We choose the "M0S Dock" option, which is the one on the right. DO NOT ask for the loose chip!! Careful!!

Third Step:

We could order the casing. (About 29 euros if it is printed with "high quality", that is, it does not look like that rough shit full of threads that 3D printed things usually are).

You can colsut the price at: https://innova3d.es/presupuesto-online-impresion-3d/ - spanish -

We have to upload these two models:

https://github.com/harbaum/MiSTeryNano/blob/main/board/misteryshield20k/housing3D/MiSTeryNano-lid.stl https://github.com/harbaum/MiSTeryNano/blob/main/board/misteryshield20k/housing3D/MiSTeryNano-bottom.stl

I printed it in Gray PLA, with the High Quality option and with infill at 50-60%, and it looks great.

Finally:

When we receive everything, we flash:

To flash the M0S Dock:

• We download this firmware file: https://github.com/vossstef/tang_nano_20k_c64/releases/download/v1.2.2/misterynano_fw_bl616.bin

• We downloaded Bouffalo Lab Dev Cube 1.9.0 from https://dev.bouffalolab.com/download

• By holding down the small "BOOT" button on the M0S Dock, we connect it to the computer via USB. Once connected, we can release the button.

• We open the Bouffalo Lab Dev Cube, select "BL616/618" as the chip, click "Open UART", go to the "MCU" tab and in "Image File" we select the firmware file that we just downloaded.

• We click on "Create & Download" and it should flash it without problems.

To flash the TangNano 20k:

We install the OpenFPGALoader. On Debian:

sudo apt-get install openfpgaloader

I only use Debian 12.

If we want the Atari ST core, we download this bitstream:

https://github.com/harbaum/MiSTeryNano/releases/download/v1.2.4/atarist.fs

If we want the C64 core, we download this bitstream:

https://github.com/vossstef/tang_nano_20k_c64/releases/download/v1.2.3/tang_nano_20k_c64.fs

Now we flash the bitstream we want. To do this, we connect the Tang Nano20k via USB and do:

openFPGALoader -f <CORE_FILE.FS>

In the case of the AtariST core, we also have to flash the TOS:

openFPGALoader --external-flash -o 0x100000 tos104us.img
openFPGALoader --external-flash -o 0x140000 tos206us.img
openFPGALoader --external-flash -o 0x180000 tos104es.img
openFPGALoader --external-flash -o 0x1c0000 tos206es.img

Finally you have this:

Case with Shield

• Thanks to vanfanel to recopile the linux procedure -