How to Install 1FPGA on an existing MiSTer

This is a tutorial on how to install the 1FPGA frontend on your MiSTer device.

Requirements

The first thing that you need is a DE10-Nano with a functioning MiSTer install.

The easier way to do this is to follow the instructions for the Mr. Fusion installation.

Installing the 1FPGA MiSTer Script

Open a Terminal, SSH to your MiSTer device (or use the Linux terminal by pressing F9), and execute the following line:

curl https://public.1fpga.cloud/db/Scripts/1fpga.sh --output /media/fat/Scripts/1fpga.sh --insecure

This will put a 1fpga script in your Scripts folder.

Starting 1FPGA

From the MiSTer menu, go to the Scripts menu and execute the 1fpga script. It will download any necessary binary, then start 1FPGA.

Going back to MiSTer

You can simply exit 1FPGA, restart or turn off and on your MiSTer. 1FPGA does not change files related to MiSTer, but instead keep a separated install containing everything 1FPGA needs (including cores and core-related files).

Deleting 1FPGA

To delete all 1FPGA files, remove the /media/fat/1fpga folder that contains everything. 1FPGA itself does not write files outside of that folder.

The one_fpga binary located in /media/fat can also be deleted, as well as the 1fpga.sh file in the Scripts folder.

Hi! I tried finding it here, but I can’t seem to find the same issue I am having - the script downloads fine, and the mister restarts - but then I only get a black screen (monitor says no signal) - I assume something is wrong, is this a known issue or am I doing something wrong?

This might be a new issue. What monitor do you have and how are you connecting to it? We only officially support HDMI as of now.

I am using HDMI and it works for all other MiSter things? Is there some config file that you can use to control resolution or similar? is it out of range or something like that? Monitor seems to think there is no signal at all

I think the problem is there is no folder named 1fpga made when the script runs, it does download something, but I can’t see any files?

That folder should be created when running 1fpga. If you have access to the SD card, could you check if you have a /media/fat/one_fpga executable?

It seems that you don’t even get to start the executable.

If you have ssh access, try running the following from an SSH session:

# Kill the MiSTer process to make sure it doesn't compete with 1FPGA.
killall -9 MiSTer

# Start one_fpga with extra verbose logging
/media/fat/one_fpga -vv

Copy the log here, please. Then you can reboot using reboot or just turning on and off the de10 nano.