This section is dedicated to assisting developers in resolving issues encountered while working with the SidecarT board. It includes common troubleshooting steps, frequently asked questions, and resources for additional support, enabling developers to find solutions and get back to development swiftly.
Table of contents
- Common Issues and Resolutions
- Floppy emulation
I cannot stress enough how important it is to clean the cartridge connectors on the Atari ST, not only on the SidecarT. The vast majority of issues encountered are related to dirt, flux or poor connectivity due to rust on the connectors.
If your computer randomly crashes with different error messages when the SidecarT is connected, it is likely that the SidecarT is not properly connected to the computer. Please check the following:
- The SidecarT board is properly connected to the Pico W headers.
- The SidecarT board is properly connected to the computer cartridge connector. Please verify that the board is properly inserted and aligned with the cartridge connector.
- The SidecarT board is properly powered. Please verify that the power supply of your computer is working properly. A faulty power supply can cause random crashes and errors.
- The SidecarT board is cartridge connector is clean. Please clean the cartridge connector with isopropyl alcohol.
- The computer cartridge interface is dirty or rusty.
If the SidecarT board is not detected by the computer, please check the following:
- Connect the Pico WH to your PC/Mac/Linux using a USB data cable. Observe if the green LED blinks during boot-up. If it doesn’t, the issue could be with the Pico W.
- If the LED blinks upon booting, next connect the Pico W to the SidecarT headers and perform the same operation. The green LED should blink in this case too. If it doesn’t, there might be a short circuit on the SidecarT board.
- Lastly, try connecting the SidecarT to the computer. It is highly recommended cleaning the SidecarT cartridge connector with isopropyl alcohol before doing this. If the LED does not blink in this case, there might be a short circuit on the SidecarT board. If the LED blinks, the SidecarT board is working fine and the issue is with the cartridge connector on the computer.
If you cannot enter into the CONFIGURATOR mode, please check the following:
- Check that the SidecarT is properly connected to the computer cartridge connector and that the SidecarT is properly powered.
- Press the RESET button on the SidecarT board and keep it pressed.
- While keeping the RESET button pressed, press the SELECT button for more than 1 second.
- Release the RESET button.
- The SidecarT should now be in the CONFIGURATOR mode. The CONFIGURATOR mode is indicated by the green LED blinking a ‘C’ in Morse code.
The cartridge drive uses the letter
c in lowercase. If you can’t see the
Drive c: unit, please be sure you are in
- Press the
SELECTbutton to enter the
Configuratormode for more than 1 second.
- Power cycle your computer.
- After boot, you should see the
Drive c:unit. If you don’t see it, do as follows:
- Click on any other unit (e.g.
- Open the
Optionsmenu at the top of the screen.
- Click on
Install Disk Drive....
cin lower casee.
- You should also rename
Cartridge Driveto make it easier to identify.
- Finally, click on
Drive c:unit should now be visible. Open it and click twice on the application
SIDECART.TOSto run it.
- Click on any other unit (e.g.
This is a known and random issue with the WiFi module. After version v0.0.10 of the firmware, the SidecarT will try to connect to the WiFi network until it succeeds. If you get an error message, please try again. If the problem persists, press the
BUTTON of the SidecarT.
If the microSD card is not detected, please check the following:
- The microSD card is formated as Fat16 or exFAT. Please follow the instructions in the Format de microSD card section.
- Check that the microSD card has the correct folders created. Please follow the instructions to set the folder to host ROM files and set the folder to host the floppy disk images.
- Check that the microSD card is properly inserted in the microSD card slot. The microSD card should be inserted with the label facing up. The microSD card should be inserted until it clicks.
- Do not power on the SidecarT until the microSD card is properly inserted. If the microSD card is not properly inserted, the SidecarT will not be able to detect it.
- In the CONFIGURATOR mode, information about the microSD card is displayed at the bottom of the screen with the space available and the number of files in the folders. If the information is not displayed, the SidecarT is not able to detect the microSD card.
There are mostly two reasons why some floppy disk images are not working:
The floppy emulator “traps” the floppy disk access and redirects it to the microSD card. This is done by a combination of hardware and software. The hardware part is done by the SidecarT board and the software part is done by the firmware. The firmware is responsible for reading the floppy disk images from the microSD card and sending them to the Atari ST. Some applications -mostly games- are using a direct access to the floppy disk controller and bypass the operating system. In this case, the firmware is not able to redirect the floppy disk access to the microSD card. This is why some games/applications are not working. The only solution is to use another floppy disk image. As a workaround, I recommend to try a different version of the game/application from another collection or source.
The TOS version of your computer is not compatible with the application/game. In this case, you need to use a different TOS version, or find a version of the application/game compatible with your TOS version.