This is a page for downloading development builds of my project to improve the IAP support in Rockbox. IAP is the iPod Accessory Protocol, a protocol used by iPods to communicate with devices connected to the iPod multipin connector. These devices can be radio tuners, remote controls or, in the most common case, some kind of stereo system that wants to remote control the iPod (change tracks, change volume, start and stop playing). Even cars usually fall in the latter category.
If you don't know what Rockbox is then you probably are not interested in this.
Work is ongoing to improve the support for these devices in the Rockbox firmware. You most
probably came here because I or someone else in the
#rockbox IRC channel on
the freenode network gave you a link to a custom Rockbox build.
These builds are used to test and improve the new IAP code. There are some very important things to notice before downloading and using the files offered here.
- There are NO OFFICIAL ROCKBOX FIRMWARES on this site. There will be no support from the Rockbox developers via IRC, forum, mailing lists or any other channel for these files. Do not contact them if you have any problems with it.
- These firmwares are built from a modified version of the current rockbox development tree. There may be bugs and regressions unrelated to IAP in them.
- You are using these firmwares on your own risk. They might not do anything at all. They might render your iPod inaccessible. They might delete or otherwise modify files or other content on your iPod. You might have to factory reset your iPod to recover from failure. The Rockbox FAQ entries about losing your warranty and damaging your player also apply to these firmwares.
- You have to be familiar with the process of manually installing (and removing) Rockbox firmwares on your iPod.
- The device you connect your iPod to might not like the commands the iPod sends to it when using these firmwares. Although the code tries to mimic the behaviour of the original iPod firmware, there may be differences the device does not expect. This may lead to unexpected behaviour.
- The IAP support is a work in progress. Even if everything works as expected, there may be features missing that work in stable Rockbox firmwares. There is no timeframe on how long it will take to complete the work.
- Even when the work is complete, some devices will remain unsuported or only partially supported.
- There is no guarantee that any of this work ever ends up in an official Rockbox firmware.
- Please don't distribute these firmwares. They are experimental and unsuported, and might have been built with a specific testcase in mind. They are not for general consumption.
tl;dr: If it breaks you get to keep all the pieces.
That being said, I'm very grateful for any help in improving the IAP support. If you want to download these firmwares you most likely have a device that does not work or does not work as expected.
These firmwares are set up for extended logging of the IAP commands exchanged between the device and the iPod. These logs hopefully help to determine why exactly the device does not work, and what can be done to improve it.
In order to use these firmwares:
- Install as any other rockbox firmware. Follow the Rockbox install process for manual installs.
- Start the new firmware (hopefully it will) and check the version information under System->Rockbox info. These firmwares usually have "iap" somewehere in the version string.
- Connect the device to the iPod (or the iPod to the device, whatever the case may be) and try one or two of the actions that do not work. Note what you did. If your device does not recognize the iPod at all, just leave it connected for 10-20 seconds and then disconnect it again. Don't try too much at once.
- After disconnecting the iPod, look under System->Debug->Show log file. There should be some (or some more) lines starting with "R:" or "T:" in it. There may be other lines as well.
- Select System->Debug->Dump log file. This will create a file named
.rockboxdirectory on the player.
- Somehow get that file to me, with a description of what you did while the iPod was connected to the device. Also include the name of the device.
Having read all of the above (you have read it, right? Go back and read it again.): do you still want to try out these custom firmwares?
If you receive a "410 Gone" error when trying to download the firmware try to reload this page.
I can be found as
Lalufu on the freenode IRC network.
There is a GIT tree containing the current state of the work available at http://git.camperquake.de/rockbox.git, in the
None of this would be possible without the work of the original Rockbox developers. You guys rock.