Getting Started

v4.0.0

This guide sets up a SidecarTridge Kickstart board with firmware v4.0.0: what you need, the ROMEMUL drive the board shows on your computer, how to copy Kickstart and other ROM images to it, and how to install the firmware.

Is your board already running firmware v3.x? Read Upgrading to v4.0.0: it keeps your ROM images.

Table of contents

1. Prerequisites
   1. The SidecarTridge Kickstart Emulator kit
   2. Tools and equipment
   3. Software and files
2. Unboxing and inspecting the kit
3. The ROMEMUL drive
   1. Connecting the board to your computer
   2. What is on the drive
   3. ROM image size: exactly 512 KB
   4. Copying ROM images
   5. The default and the rescue image
   6. Magic file names
4. Firmware installation
   1. Which file
   2. The installed version
   3. BOOTSEL mode
   4. Installing from your browser
   5. Installing by copying the file

Prerequisites

The SidecarTridge Kickstart Emulator kit

The kit includes:

1. The SidecarTridge ROM Emulator board, soldered onto the carrier board for your Amiga motherboard.
2. The RESCUE cable and push button, to start the rescue ROM when you need it.

Check in Before You Buy that the kit matches your Amiga motherboard.

Tools and equipment

• A USB-C cable that carries data, to connect the board to your computer. Many cables only charge; with one of those the board never shows its drive.
• Phillips head screwdriver: to open the Amiga case.
• Anti-static wrist strap: to avoid static discharges that could damage the electronics.
• Small container: for the screws and small parts.
• IC extractor tool: to lift the Kickstart ROM out of its socket without damaging it or the motherboard. A small flat-head screwdriver works too, used with care.
• Insulating tape (recommended): to avoid short circuits between the board and the motherboard.
• A computer with a USB port: Windows, macOS or Linux, to copy ROM images and to update the firmware.

Software and files

• ROM images: the board comes with DiagROM 1.3 ready to boot, but no Kickstart: Kickstart images are copyrighted, so you bring your own, for example from Amiga Forever. The Kickstart conversion guide helps you prepare them. Other ROMs, such as DiagROM or EmuTOS, work too. The Compatibility page lists the ones tested.
• The SWITCHER 4.0.0: the program that lists, selects, uploads, renames and deletes ROM images from the Amiga. It is in the AMIGA folder of the board’s ROMEMUL drive, and on the downloads page. Firmware v4.0.0 needs SWITCHER 4.0.0: older SWITCHER versions do not work with it.

Unboxing and inspecting the kit

Check that the items listed above are in the box and in good condition. The board and the sticker on the box have a QR code that links to this documentation.

The board has three LEDs: red for power, green while it serves a ROM to the Amiga, and orange while its drive is open on your computer. The User Guide explains every combination.

The ROMEMUL drive

As a rule of thumb, ALWAYS eject the ROMEMUL drive after changing anything on it. The board reads your changes when the drive is ejected, not before.

Connecting the board to your computer

The board has two jobs: it serves a ROM image to the Amiga, or it shows its storage to your computer as a USB drive called ROMEMUL. It decides when it is powered on:

• If a computer talks to it on the USB cable during its first 2 seconds, it opens the ROMEMUL drive and lights the orange LED. The Amiga does not start while the drive is open.
• Otherwise it serves the default ROM image to the Amiga and lights the green LED.

So, to open the drive: with the Amiga switched off, plug the board into your computer with the USB-C cable. A phone charger or a cable that only charges is not enough: the board then starts as it would inside the Amiga.

If the ROMEMUL drive does not appear, press the RESET button on the board with the cable plugged in: it starts again and looks for your computer. If it still does not appear, try another cable and read Troubleshooting.

What is on the drive

A new board, or one installed from a full firmware file, has these files:

• INDEX.HTM: opens this documentation.
• INFO.TXT: the firmware installed on the board. The board writes it the first time it is connected to a computer.
• AMIGA: a folder with the SWITCHER in three forms. The User Guide explains which one to use:
  • SWITCHER.ADF: a bootable floppy disk image that starts the SWITCHER, for Kickstart 1.3 and later;
  • SWITCHER: the same program, to copy to a hard disk or a Workbench disk;
  • SWITCHER.ST: an Atari-format floppy image, for an Amiga that boots EmuTOS from the board.
• DEFAULT.TXT: the name of the ROM image the board starts with.
• RESCUE.TXT: the name of the rescue image, which starts when you hold the RESCUE button.
• DiagROM-1.3.img: the default ROM image, DiagROM 1.3, a diagnostic ROM for the Amiga. See Diagnosing your Amiga with DIAGROM.
• RESCUE_SWITCHER_v4.0.0_512KB.img: the rescue switcher, the rescue image. When you start it, it lets you choose any ROM image on the board. Read ROM Rescue Switcher.
• CONFIG.TXT: the board’s settings. You rarely need to change them; see Advanced Settings.

This is an example of INFO.TXT:

SidecarTridge ROM emulator. (C) 2024-26 GOODDATA LABS SL
Version: v4.0.0
Date: 2026-10-10 20:43:15
Mode: RELEASE
Microcontroller: RP2350-A2
Board variant: RP2350A
Board ID: e46358c8071c0c29
Flash size: 16777216 bytes
PSRAM: NO PSRAM found

The Version line is the firmware installed. Board variant: RP2350A is the board you have: the firmware files for it have rp2350a in their name.

Your computer may add hidden files and folders to the drive, with names starting with a dot (.). The board ignores them, and it never takes a file whose name starts with a dot or an underscore (_), or a folder, for a ROM image. The drive also rounds file sizes up to the next 4 KB.

ROM image size: exactly 512 KB

The board presents a 512 KB ROM to the Amiga, so every ROM image you use must be exactly 524288 bytes (512 KB).

• Kickstart 2.04 and later, DiagROM, EmuTOS and most modern ROMs are already 512 KB: copy them as they are.
• Kickstart 1.1, 1.2, 1.3 and other early 256 KB Kickstarts must be doubled to 512 KB first. A real Amiga mirrors a 256 KB Kickstart in its 512 KB socket by itself; the board does not. If your Kickstart is an Amiga Forever encrypted image, the web converter doubles it for you; for a plain 256 KB dump, follow Already-decoded Kickstart ROMs.

Copying ROM images

The drive has about 13 MB free on a new board, room for 25 more images of 512 KB. Keep a copy of your images in a folder on your computer, so you can always copy them again.

1. Collect your ROM images in a folder, for example ROM Images on your desktop.

   

2. (Optional) Give them names you can read, such as Kickstart 1.3 r34.005.img. The SWITCHER shows these names, sorted alphabetically, and names of up to 63 characters fit.

   

3. Copy them to the ROMEMUL drive. Dragging them works on Windows, macOS and Linux. On macOS the Finder also copies hidden ._ files, which the board ignores; to avoid them, copy from the Terminal:

   cp -R /path/to/ROM\ Images/* /Volumes/ROMEMUL/
   

   On Linux the drive is usually mounted at /media/<your user>/ROMEMUL/.

4. Wait for the copy to finish, then eject the drive. Copying is slow by design: every block is written to the board’s memory before your computer is told it is done, about 25 KB per second, so a 512 KB image takes about 20 seconds.

When you eject the drive, the board rebuilds its list of ROM images. Then it waits, with the green and orange LEDs off, until you unplug it.

The default and the rescue image

The board knows two of your ROM images by name:

• The default image starts when you switch the Amiga on. A new board starts DiagROM.
• The rescue image starts when you hold the RESCUE button while switching the Amiga on. A new board has the rescue switcher here, and it is the best choice: from it you can start any of your images, even when the default one does not boot.

To change the default image, use the SWITCHER on the Amiga: it is the easy way. You can also write the image’s name in DEFAULT.TXT on the drive, exactly as the file is called, extension included, and eject the drive. For example:

Kickstart 1.3 r34.005.img

The rescue image can only be changed in RESCUE.TXT, the same way. Keep the rescue switcher there unless you have a reason not to.

If DEFAULT.TXT or RESCUE.TXT names a file that is not on the drive, the board uses the first image of the list instead, in alphabetical order. If DEFAULT.TXT or RESCUE.TXT is missing, the board writes a new one naming that image.

Magic file names

Two file (or folder) names make the board do something when you eject the drive. The board deletes the file once it has acted on it.

• REBOOT: after the eject, the board starts serving the default ROM image straight away, with the USB cable still plugged in. Use it when the board stays connected to your computer: create REBOOT, eject, then switch the Amiga on.
• RESET: after the eject, the board enters BOOTSEL mode, ready for a new firmware (see below).

v4.0.0

Before firmware v4.0.0, REBOOT opened the drive again instead.

Firmware installation

Your board came with its firmware installed. New versions are published on the downloads page.

Which file

There are two kinds of firmware file for the SidecarTridge Kickstart board:

File	What it does
sidecartridge-kickstart-rp2350a-update-v4.0.0.uf2	Replaces the firmware only. Your ROM images, DEFAULT.TXT, RESCUE.TXT, CONFIG.TXT and the rest of the drive stay as they are.
sidecartridge-kickstart-rp2350a-diagrom-full-v4.0.0.uf2	Replaces everything: the firmware and a new drive with DiagROM 1.3, the rescue switcher, the SWITCHER and the default settings.

The full file erases every ROM image on the board. Copy them to your computer first.

Use the files with rp2350a in their name. The ones with rp2350b are for a different board: if one is installed by mistake, the Amiga gets no ROM and the green and orange LEDs blink together. Install the right file the same way and the board is back.

Coming from firmware v3.x, follow Upgrading to v4.0.0: after the update file, a few files on the drive must be replaced too.

The installed version

Open INFO.TXT on the drive: its Version line is the firmware installed.

The board writes INFO.TXT only when the drive has none. After an update it still shows the old version: delete INFO.TXT, eject the drive, and plug the board in again to get a new one.

BOOTSEL mode

To install a firmware, the board must be in BOOTSEL mode, where it shows a drive called RP2350 instead of ROMEMUL. There are three ways in:

• With the board connected to your computer: hold the BOOT button, press and release RESET, then release BOOT.
• With the board unplugged: hold the BOOT button, plug in the USB cable, then release BOOT.
• From the ROMEMUL drive: create a file called RESET on it and eject the drive.

Installing from your browser

With Chrome, Edge or another Chromium-based browser, you can install the firmware from webflash.sidecartridge.com, with nothing else to install. Connect the board, put it in BOOTSEL mode and follow the page, choosing the SidecarTridge Kickstart file for your board from the list above.

Installing by copying the file

1. Download the file from the downloads page.
2. Put the board in BOOTSEL mode: the RP2350 drive appears.
3. Copy the .uf2 file onto the RP2350 drive.

When the copy is complete, the RP2350 drive disappears and the board starts with the new firmware. A full file is much larger than an update file and takes longer to copy. If the board does not start once the copy has finished, press RESET on it.

Previous: Before You Buy Main Next: Upgrading to v4.0.0