TF4060 New Firmware and Update Tool

[terriblefire]

All,

I've released TF4060V2 firmware 0.8.0 along with the TF PI tool which now lets you track published releases and update them automatically. As well as get developer builds to test if you want.

Updating your TF4060 firmware with TF Pi

TF Pi is the software for the Raspberry Pi on your TF4060. It runs the A314 daemon, flashes the TF4060's FPGA and CPLD, and gives you a web page that shows when new firmware
is out and installs it. Once it's set up, updating is a couple of clicks.

1. Install TF Pi

New SD card:
1. In Raspberry Pi Imager, write Raspberry Pi OS Lite. In the OS customisation settings, set a hostname, a user and password, Wi-Fi if you need it, and turn on SSH.
2. Take the card out and put it back in. A drive called bootfs appears.
3. Download vendor-data from https://github.com/terriblefire/tfpi (in the bootfs folder) and copy it onto bootfs, next to config.txt.
- The file must be called exactly vendor-data, with no extension. Browsers often save it as vendor-data.txt, and Windows and macOS hide the .txt. Turn on file extensions
and rename it if needed, or nothing gets installed.
- If you used an older (Bookworm) image, Imager writes a firstrun.sh instead of user-data. In that case run tools/tfpi-hook.sh from the repo on the card instead.
4. Eject the card, put it in the Pi on the TF4060 and power up.

The first boot downloads and builds everything, which takes about 20–30 minutes on a Pi 3/4. Then the Pi reboots. You can watch progress in /var/log/tfpi-install.log.

Pi already running Raspberry Pi OS: just run

curl -fsSL https://terriblefire.github.io/tfpi/install.sh | sudo bash

2. Open the TF Pi page

Browse to http://<your-pi-hostname>.local/. The first visit asks you to choose a password. The page is meant for your home network only, so don't expose it to the internet.

3. Get the latest firmware

1. The Home page tells you when new firmware is available. TF Pi checks every 12 hours, or press Check for firmware.
2. Press Download and review. The review page shows which chips will be flashed (FPGA and/or CPLD), and skips any that are already up to date.
3. With the Amiga powered on, press Flash now and watch the log. Don't power off while it's flashing.

The page keeps your last three releases, so you can roll back if needed. Releases appear under their version name, for example v0.8.0.

What you'll see on the Amiga afterwards

The first boot after a firmware update installs the new TF4060 modules. You'll see a "TF4060 Modules Installing — Please wait, restarting…" screen, and the Amiga restarts
once or twice by itself. That's normal, not a boot loop. After that it boots as usual, and you may see a brief "TF4060 Checking Modules" screen at startup.

Keeping TF Pi itself up to date

The Updates tab shows TF Pi software updates. Check and Update now are at the top.