From dec2013377c6b39e0331dca9adba83192df3460f Mon Sep 17 00:00:00 2001 From: Till Harbaum Date: Fri, 6 Sep 2024 12:07:59 +0200 Subject: [PATCH] Refer to FPGA Companion --- INSTALLATION_LINUX.md | 14 ++++++++++---- INSTALLATION_WINDOWS.md | 8 +++++++- firmware/README.md | 5 +++++ 3 files changed, 22 insertions(+), 5 deletions(-) diff --git a/INSTALLATION_LINUX.md b/INSTALLATION_LINUX.md index 22ebb2e..55e3dde 100644 --- a/INSTALLATION_LINUX.md +++ b/INSTALLATION_LINUX.md @@ -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 @@ -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 @@ -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 diff --git a/INSTALLATION_WINDOWS.md b/INSTALLATION_WINDOWS.md index 52d2b29..1c70d05 100644 --- a/INSTALLATION_WINDOWS.md +++ b/INSTALLATION_WINDOWS.md @@ -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 @@ -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 diff --git a/firmware/README.md b/firmware/README.md index fc021df..6091f05 100644 --- a/firmware/README.md +++ b/firmware/README.md @@ -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.