Skip to content

Commit

Permalink
Refer to FPGA Companion
Browse files Browse the repository at this point in the history
  • Loading branch information
harbaum committed Sep 6, 2024
1 parent 61a636d commit dec2013
Show file tree
Hide file tree
Showing 3 changed files with 22 additions and 5 deletions.
14 changes: 10 additions & 4 deletions INSTALLATION_LINUX.md
Original file line number Diff line number Diff line change
Expand Up @@ -89,12 +89,18 @@ in the OSD. The addresses for all TOS are:

### Step 3: Installation of the MCU firmware

MiSTeryNano now uses the [FPGA Companion](https://github.com/harbaum/FPGA-Companion)
for the external MCU. This still supports the BL616/M0S initially used for the
MiSTeryNano but also the RP2040 or ESP32. The following instructions assume that
a M0S Dock is being used. Please refer to the [FPGA Companion](https://github.com/harbaum/FPGA-Companion) for
the other MCUs.

Releases V1.2.0 and later of MiSTeryNano expects a [M0S
Dock](https://wiki.sipeed.com/hardware/en/maixzero/m0s/m0s.html) to be
used for USB connectivity and system control. The
```misterynano_fw_bl616_cfg.ini``` and ```misterynano_fw_bl616.bin```
```fpga_companion_bl616_cfg.ini``` and ```fpga_companion_bl616.bin```
files from the [release
page](https://github.com/harbaum/MiSTeryNano/releases) contain the
page](https://github.com/harbaum/FPGA-Companion/releases) contain the
firmware for the M0S Dock.

Use the graphical [BLFlashCube
Expand All @@ -106,7 +112,7 @@ to flash the firmware onto the M0S Dock using these steps:
* Connect the M0S to the PCs USB
* Release the boot button (the M0S/BL616 will now be in "update" mode)
* Open the bouffalo_flash_cube
* Select ```misterynano_fw_bl616_cfg.ini``` as the config file using the Browse button
* Select ```fpga_companion_bl616_cfg.ini``` as the config file using the Browse button
* Select the correct COM port under "Port/SN"
* Hit download, wait for completion
* Unplug the M0S from USB and connect it to the Tang Nano 20k as depicted below
Expand All @@ -120,7 +126,7 @@ At this point mouse and keyboard should be working and you should be
able to use the F12 key to open the on-screen-display (OSD) to control
the core.

Look [here](firmware) for more info about the firmware.
Look [here](https://github.com/harbaum/FPGA-Companion) for more info about the firmware.

### Step 4: Installation of a floppy disk image

Expand Down
8 changes: 7 additions & 1 deletion INSTALLATION_WINDOWS.md
Original file line number Diff line number Diff line change
Expand Up @@ -86,6 +86,12 @@ Their use and installation is optional.

## Flashing the M0S-Dock/BL616

MiSTeryNano now uses the [FPGA Companion](https://github.com/harbaum/FPGA-Companion)
for the external MCU. This still supports the BL616/M0S initially used for the
MiSTeryNano but also the RP2040 or ESP32. The following instructions assume that
a M0S Dock is being used. Please refer to the [FPGA Companion](https://github.com/harbaum/FPGA-Companion) for
the other MCUs.

For the BL616 you have to extract and start the BuffaloLabDevCube.

Using the internal BL616 of the Tang Nano 20k is currently not supported
Expand All @@ -106,7 +112,7 @@ or otherwise flashing will fail.**
device with a COM port. If not take a look in the device manager to check for
the correct device detection.
- On the top click on MCU and browse to the firmware image file named
```misterynano_fw_bl616.bin```
```fpga_companion_bl616.bin```
- Choose “Open Uart” and than press “Create & Download”. The firmware should now be
flashed

Expand Down
5 changes: 5 additions & 0 deletions firmware/README.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,8 @@
# Old firmware

This directory contains an old version of the firmware. The firmware is now developed as a seperate project in the
[FPGA Companion repository](https://github.com/harbaum/FPGA-Companion).

# BL616

The [Bouffalow Lab BL616](https://en.bouffalolab.com/product/?type=detail&id=25) is a Risc V microcontroller. It's comparable with the ESP32 and comes with integrated WiFi, Bluetooth, USB device, USB host and various other peripherals. In combination with a FPGA the BL616 can perform sopport tasks like handling SD card and their file systems or dealing with USB peripherals.
Expand Down

0 comments on commit dec2013

Please sign in to comment.