Programming the Spartan Edge Board

Chrome-Based browser Setup

Step 1:

Connect the SEA Board via USB-C to your PC and open https://gbahd.github.io/ in an Chrome based browser.

Step 2:

Click on "connect"

Select you SEA Board and click "connect" - if no device is shown head over to Tips when you have problems uploading the firmware onto the Spartan Edge

After the SEA Board is connected click on "Install GBAHD"

Click "next" - optionally you can toggle the "Erase device" button"

Click "INSTALL"

If you get this error message click "back", hold your boot-button on your SEA Board and repeat the steps from clicking "install"

The installation starts and will take about two minutes.

Congratulations! your SEA Board is programmed - head over to Prepare your SD Card

Windows Setup

Step 1:

Create an empty folder on your desktop e.g. for all the following files. Download the newest release of the SEA Firmware from here gbaHD-Shield Releases

Download the following files and put it into the folder you've just created on your desktop:

gbaHD-avr.bin
gbaHD-esp32-bootloader.bin
gbaHD-esp32.bin
gbaHD-partition-table.bin
gbaHD-spiffs.bin

Step 2:

Download the newest esptool from: esptool releases

and choose the correct operatingsystem for your needs. Extract it into the same folder on your desktop

Step 3:

Connect your SEA Board over USB-C with your computer

Step 4:

Check your DeviceManager and look for the COMPort the SEA-Board has occupied:

If the SEA Board is not recognized correctly you'll need to install the CP2102-Driver: Troubleshooting

Step 5:

open a CMD-Shell in that folder:

Step 6:

Now we need to upload the firmware to the SEA Board with the esptool.exe - this string is an example to do that. Turn the SEA Board on (either with its normal power switch or your case-switch and execute the command.

esptool.exe --chip esp32 -p <<COM4 e.g.>> -b 460800 --before=default_reset --after=hard_reset write_flash --flash_mode dio --flash_freq 40m --flash_size 4MB 0x1000 gbaHD-esp32-bootloader.bin 0x10000 gbaHD-esp32.bin 0x8000 gbaHD-partition-table.bin 0x290000 gbaHD-spiffs.bin

The ESP is now programmed - at this point every new firmware updates comes via OTA - you can disconnect the SEA Board from your computer.

# Mac-Setup

It's also possible for our Mac Users to perform this ;)

To findout which port the SEA Board will occupy start a Terminal with the SEA Board disconnected and type

ls /dev

after that connect the SEA Board and execute the same command again. The device that wasn't there before is the SEA Board. If the esptool is not yet installed you can to that with

brew install esptool

esptool.py esp32 -p <<PORT>>> -b 460800 --before=default_reset --after=hard_reset write_flash --flash_mode dio --flash_freq 40m --flash_size 4MB 0x1000 gbaHD-esp32-bootloader.bin 0x10000 gbaHD-esp32.bin 0x8000 gbaHD-partition-table.bin 0x290000 gbaHD-spiffs.bin

Preparing the SD-Card

Take an empty micro-SD Card and format it FAT32

In the root-directory of the sd card we need to create a config file called "wifi.cfg". Make sure the file extension is .cfg and not .cfg.txt or something like this.