Page Table of Contents
You can put your games in folders on the SD card so you can have different categories. For example, you could separate your games by company name, game genres, or put all paddle games in one folder if you want.
Remember that you don't just have to play classic games the way they were created. There are a lot of hacks at AtariAge that you can try. Some are great, some are horrible, and the rest are somewhere in the middle. Below are some related links:
About This Page
This page is based on a post by atarigal at AtariAge.
This page is also based on the official Harmony cartridge PDF manual at AtariAge.
Here is my (Duane Alan Hahn's) first experience with the Development Tab.
ROM File was self-explanatory.
ARM Dir was a mystery until I found this post by batari:
"It is located wherever the software is installed. On Windows, that will probably be:
After setting up those two things, I could click the Download button to send a work in progress to the Harmony cart. After I tried a few works in progress, I wanted to use the SD card to play classic games, but I didn't know how to make the Harmony cart switch over to the SD card. I went searching the AtariAge Harmony cart forum and found this post by batari:
"If you program a single image to Harmony, it replaces the firmware with the game, so you need to reprogram firmware to get back to multicart mode."
After downloading harmony_105.zip and unzipping it, I downloaded eeloader_104e_NTSC.bin to the Harmony cart, but there was an error and the menu wouldn't come up. Based on what I read in the Harmony Cart Software thread, I renamed eeloader_104e_NTSC.bin to eeloader.bin then downloaded that to the Harmony cartridge and it worked.
So that means I can download a work in progress to the Harmony cartridge and when I want to use the SD card again to play games from the menu, all I have to do is download eeloader.bin to the cartridge. Now I can easily flip back and forth any time I want between my works in progress and multicart mode (with the SD card).
Oh yeah, I almost forgot to mention the Quick Pick buttons. They are useful if the file name isn't going to change. Right click a Quick Pick button to select a .bin file, then any time you left click that button in the future, the information for that .bin file will be displayed and you can left click the Download button to download the file to your Harmony cart.
To save me a little time and energy, I put eeloader.bin in the bottom right Quick Pick button so I can quickly download it to the Harmony cart whenever I want to go back to multicart mode.
The Harmony cartridge is a simple, affordable, time-saving, space-saving, hassle-free way to play hundreds of games on your Atari 2600 console. Emulators are handy, but computers have other things running in the background, so games can slow down at times and that can ruin the experience. Now thanks to the Harmony cartridge, you can have the convenience of an emulator with the rock-solid quality of a real console.
Instead of dragging out all of your favorite cartridges, you can keep them safely stored away. Your cartridges will also be protected from the possible damage, grease, and grime of rowdy guests or unruly children.
Using a Harmony cartridge is easy. Put your favorite game ROMs on an SD card, pop it into the Harmony cartridge, then insert the Harmony cartridge into your console slot the same way you would with any ordinary Atari game cartridge and you're ready to go. Turn on the console, select the game you want to play from the list and enjoy the magic of Atari in a brand-new way.
What is a ROM file?
ROM is an acronym for Read-Only Memory. As it says at Wikipedia, a ROM file contains a copy of the data from a read-only memory chip, often from a video game cartridge. In other words, an Atari 2600 ROM file is a copy of an Atari 2600 game. See Inside Your Atari VCS Game Cartridge to learn more about the guts of an Atari cartridge.
Will the Harmony cart play Atari 7800 games?
No. The Harmony cart only uses Atari 2600 files.
Will the Harmony cart work on my Atari 7800?
Yes. The Harmony cart works with Atari 2600-compatible consoles, including the Atari 7800.
Will the Harmony cart work on my ColecoVision using the Atari Expansion Module?
Yes. The Harmony cart works with Atari 2600-compatible consoles and expansion modules such as the ColecoVision Expansion Module #1 and the Atari 5200 VCS Cartridge Adapter.
Will the Harmony cart work on my Atari 5200 using the VCS Cartridge Adapter?
Yes. The Harmony cart works with Atari 2600-compatible consoles and expansion modules such as the ColecoVision Expansion Module #1 and the Atari 5200 VCS Cartridge Adapter.
How much is the Harmony cart?
The price has increased over time and could change at any moment. Click here to check on the current price.
What if I have more questions about the Harmony cart?
You can post your questions in the Harmony Cart Forum at AtariAge.
People who bought the Harmony cart talk about how it surpassed their wildest expectations.
"The most genuine and best documented Atari 2600 ROM collection in the world."
The Harmony cart isn't just for players. Programmers can use it to quickly and easily test their works in progress.
This Harmony Cartridge HTML Manual is based on the official Harmony cartridge PDF manual at AtariAge. It was created for people who are allergic to PDF files.
The Harmony cartridge is a programmable add-on for the Atari 2600 console that allows you to load an entire library of games into a single cartridge and then select which title you want to play from a friendly, on-screen menu interface. It features an SD card interface, making it simple to access the large library of Atari 2600 software. The Harmony cartridge supports almost all of the titles that have been produced for the Atari 2600. It can also be used to run your own Atari 2600 game creations on a real console. The Harmony cartridge is flash-upgradeable, and will be updated to support future Atari 2600 developments.
This guide tells you how to make the most of your Harmony cartridge. It should be read thoroughly before the cartridge is used for the first time. Your Harmony cartridge will provide you with many years of Atari 2600 enjoyment. The following equipment is required to use the Harmony cartridge:
This section is a quick guide to using your Harmony cartridge. By following the steps below, you can use your Harmony cartridge to enjoy thousands of titles in the Atari 2600 software library:
Harmony cartridges ship with the latest firmware (internal software), but new versions of the Harmony firmware may be released to improve the compatibility of the cartridge and to fix any issues that are discovered. It is a good idea to make sure that your Harmony cartridge is always using the latest firmware release.
To check your firmware version, select the [.] entry on the first page of the Harmony menu, then visit the Harmony cartridge website at http://harmony.atariage.com to see if a newer version of firmware is available. If the firmware is current, there is no need to upgrade the firmware unless you are having trouble with your Harmony cartridge, either due to firmware corruption or use of firmware for an incompatible television format. Harmony cartridges ship with firmware for the NTSC television format as this usually works worldwide, but sometimes it may not.
The Harmony firmware is too large to be loaded directly onto the Harmony cartridge. Therefore, a small loader program must first be downloaded onto the Harmony cartridge using a Mini-B USB cable, and then the actual firmware will be loaded from an SD card. To simplify this process, a Harmony Programming Tool has been developed for Windows, Macintosh, and Linux-based computers.
To upgrade the Harmony firmware using this tool, you should perform the following steps:
Step 1:Select the EEPROM loader to download onto the Harmony cartridge. This is done by clicking on the EEPROM "..." button. You should select a loader that is suitable for your console (either NTSC, PAL50, or PAL60). If you are unsure, use the NTSC version (eeloader_xxx_ntsc.bin) if you are in Northern America, and the PAL50 version (eeloader_xxx_pal50.bin) otherwise, where xxx is the firmware version. Once you have selected the correct version, click on the "Download EEPROM" button. The download to the Harmony cartridge should complete after a few seconds.
Step 2:Select the firmware image to be copied onto the SD card by clicking on the HBIOS "..." button. Your choice (NTSC, PAL50, or PAL60) should match your choice in Step 1. For example, if you used the eeloader_xxx_ntsc.bin file in Step 1, you should select the hbios_xxx_ntsc.bin image here, where xxx is the firmware version. Once you have chosen the correct image, click on the SD Card "..." button and select the root directory of your SD card. Finally, click on the "Copy HBIOS" button and the firmware image will be copied onto the SD card.
Step 3:Close the Harmony Programming Tool and disconnect the Harmony cartridge from your computer by unplugging the USB cable. You should also safely eject the SD card from your computer (do not just pull it out of the SD card reader). Insert the SD card into the Harmony cartridge, and then insert the Harmony cartridge into your Atari console before turning on the power to the console. If everything has worked correctly you should see a spinning symbol on the screen, followed a few seconds later by a message saying that the BIOS update has been successful. If weird patterns (garbage) appear on the screen, turn off the console power for a few seconds and then back on again.
I am having a problem with my Harmony Cartridge—where can I get help?
The AtariAge Harmony cartridge forum is the official place to ask questions about the Harmony cartridge. However, it is a good idea to check if your question has already been answered before posting a query.
Why are my files all jumbled up in the Harmony menu?
The files are shown unsorted, in the order that they appear on the SD card. If you are using a Macintosh computer, make sure to use copy and paste, rather than simply dragging the files onto the SD card. There are also utilities (e.g. DriveSort) that can reorder the files on an SD card.
My Harmony cartridge just displays a spinning logo on the screen, and nothing else happens—what am I doing wrong?
This means that the SD card is not supported, or has not been properly FAT formatted. Try reformatting the card (make sure to backup the contents first). If this does not work, then you will need to use another SD card. Unfortunately, not all SD cards are created equally—there are many counterfeit branded cards out there, and many do not support the full SD card protocol.
My Harmony cartridge has stopped working—it used to work fine, but now it just shows weird patterns on the screen—what do I do?
Try cleaning the cartridge edge connector, and re-seating the cartridge. If this does not help then the firmware probably needs to be reprogrammed using the Mini-B USB port.
How do I clean the edge connector on my Harmony cartridge?
Open the cartridge dust flap by gently inserting a screwdriver into one of the holes on the bottom of the cartridge and pressing lightly on the flap. The contacts can be then be cleaned with a contact cleaning solution or rubbing alcohol, and a Q-tip. Conductive liquids, such as water, must never be used to clean the cartridge contacts.
Why does my computer say that the SD card is full, even though there appears to be plenty of free space on the card?
Your SD card is probably formatted with FAT12 or FAT16. You can solve this by reformatting your card as FAT32 (make sure to backup the contents first), or by splitting the contents into more sub-directories.
What games do not work with the Harmony cartridge?
All of the original Atari 2600 titles should work, apart from the 64KB MegaBoy cartridge. There are also some homebrew titles over 32KB that will not work, e.g. Stella's Stocking.
Why does a ROM that does not work with the Harmony cartridge, work fine with the Stella emulator?
If the ROM is over 32KB then it will not work. If it is 32KB or smaller, you can try forcing the file type by changing the file extension. The supported file types are listed at the end of this document. If the ROM still does not work, please let us know.
My Supercharger multiload game crashes after the first part—is there any way to make it work properly?
Supercharger multiloads are supported on the Harmony cartridge, but only if they are made into a single binary file. You need to join all of the separate parts together using a utility, or obtain a file that has already been joined together.
Why does my TV screen roll after loading certain games, or the picture appear in black and white?
You are probably trying to play an NTSC game on a PAL console, or a PAL game on an NTSC console. Try to find a version of the game that matches your console type.
Will my Harmony cartridge be "bricked" (permanently damaged) if I switch it off during loading, or if a firmware update fails?
The Harmony cartridge cannot be "bricked" as the firmware loader for the Harmony is permanently stored in ROM. If the Harmony firmware gets corrupted then it can simply be reprogrammed using the Mini-B USB port.
How do I check which version of the firmware is on my Harmony cartridge?
The firmware version is displayed at the top of the "credits" screen on the Harmony cartridge. Simply start the Harmony cartridge with an SD card inserted and select the [.] entry on the first page.
Why can the Harmony Programming Tool not find my Harmony cartridge?
You probably need to install the Virtual COM port drivers for the FT232R device available from: ftdichip.com/Drivers/VCP.htm. You should reboot your computer after these drivers have been installed.
Also make sure you are using a proper Mini-B USB cable. Some cables are designed for power-only, such as those for USB speakers, lights, chargers, or other passive devices. Other cables might have a poor connection or sensitivity to RF interference, so it is best to use a quality cable with a ferrite bead attached.
How do I use the Harmony Programming Tool with Linux?
The USB FTDI Single Port Serial Driver module (ftdi_sio) needs to be loaded into your kernel. This module has been included with the Linux kernel since 2.4.30 (and all 2.6.x kernels). You should also make sure that the qt4 library (libqt4) has been installed from your Linux distribution.
Should I use the NTSC, PAL50, or PAL60 version of the firmware?
The choice depends on the kind of Atari console that you have, and your TV set. If you are in an NTSC region (USA, Canada, Mexico, Japan, etc.) you should use the NTSC version. If you are in a PAL region (Europe, Africa, Russia, Australia, etc.) then you should use the PAL50 version. If you are in a PAL-M region such as Brazil, or in a PAL region but have a TV that can display a 60Hz picture, then you can try the PAL60 version. You can always update the firmware to a different version if necessary. If you select the wrong version, the colors in the Harmony menu will be wrong, and the TV picture may "roll" on the screen.
What if my Harmony cartridge starts acting weirdly after upgrading the firmware?
If your Harmony cartridge does not work properly after the firmware upgrade then you should repeat the upgrade process. If it still does not work, then you should ensure you are installing a compatible firmware image. Some Harmony carts will not work properly with firmware versions before v1.03. If you are sure that you are installing a compatible firmware version, and it still does not work, consult the AtariAge Harmony cartridge forum for known issues.
When I connect my Harmony Cartridge to my computer, why doesn't it appear as a drive letter or volume like my camera or MP3 player?
The Harmony Cartridge is not designed to do that. The USB port on the Harmony is intended for firmware upgrades or game development only. Use a separate card reader to manage the contents of your SD card.
The Harmony menu is very difficult to read on my TV set—how can I fix it?
The Harmony menu is optimized for CRT TVs and may not display perfectly on newer LCD TVs. You may find the picture is clearer if you disable color cycling (set the Color/B&W switch to Color). It is also important to properly calibrate your TV so that darker colors are clearly visible. There are a number of home theater calibration DVDs and Blu-Ray discs that can help with this. Lastly, installing a video mod into your Atari console that provides composite or S-video output may display a clearer picture.
The Harmony cartridge supports many different types of Atari 2600 software. The type of the software is automatically detected when the file is loaded. However, this auto-detection process can sometimes fail, resulting in weird patterns (garbage) being displayed on the screen. This is completely harmless, but can often be avoided by telling the Harmony cartridge explicitly what is the type of the file. In technical terms, the type of the file is the kind of bankswitching that was originally used by the cartridge.
It is possible to tell the Harmony cartridge directly what type of file is used by renaming the file extension. Atari 2600 software normally has a binary (.bin) file extension. This extension can be changed to one of the following to tell the Harmony what kind of bankswitching to use:
For example, to tell the Harmony cartridge to use F4 bankswitching with Superchip support, you would rename the file cavein.bin to cavein.f4s (the extension is not case-sensitive).
* Custom bankswitching is not a specific format, but rather a stub that allows new bankswitching schemes to be added to the .bin files themselves, so future BIOS updates are not necessary to support them.
NXP 70MHz ARM7TDMI-S microcontroller
8KB SRAM, 32KB Flash, and 512KB EEPROM
SD Card Interface:
7MHz SPI bus controller
FTD232 serial interface
FAT32/16/12 with Windows Long Filenames (LFN)
Bankswitching types supported:
2K, 4K, F8, F8SC, F6, F6SC, F4, F4SC, FA, FE, 3E, 3F, E0, E7, CV, UA, Supercharger, DPC, 0840, Custom
The Harmony cartridge was created by the following people on AtariAge:
Fred Quimby (batari)
Chris Walton (cd-w)
Stephen Anthony (stephena)
John Payson (supercat)
View this page and any external web sites at your own risk. I am not responsible for any possible spiritual, emotional, physical, financial or any other damage to you, your friends, family, ancestors, or descendants in the past, present, or future, living or dead, in this dimension or any other.
Use the Harmony cart at your own risk. I am not responsible if it blows up your Atari or runs away with your wife.