Skip to content
shuffle2 edited this page Dec 10, 2010 · 25 revisions

Supported Devices

A list of all devices which rockbox supports (and to what degree) can be found here. However, it is important to note that the only devices which are currently supported by this project are the ones which use the ARC USB controller (found in the PP502x chipset).

If you can confirm more platforms, feel free to edit this page.

Confirmed Working

  • ipodnano1g
  • ipodvideo
  • sansae200
  • ipod4g
  • ipodmini2g

Unconfirmed, Probably Working

  • gigabeats
  • gogearhdd1630
  • gogearhdd6330
  • gogearsa9200
  • ipodcolor
  • ipodmini1g
  • iriverh10
  • iriverh10_5gb
  • mrobe100
  • sansac200
  • vibe500

Unsupported Platforms

The following USB controllers are known not to meet the hardware requirements necessary, and all rockbox targets based on them will never work with this exploit:

  • AS3525
    • Lacking access to the USB Address register.

Porting to Other Rockbox Targets

Porting is fairly simple - the most challenging part is discovering if the platform in question has a capable USB controller. In order to qualify, the USB controller must support:

  • The ability for software to modify the "USB Address" register of the target USB controller.
  • A way to manually reset the Data Toggle on an arbitrary endpoint.

In addition, the USB driver must be augmented to provide the following features:

  • A blocking recv() function.
  • 8 byte packet size for in/out control endpoints.
  • USB Full Speed (not High Speed).

If the hardware meets the requirements, adding support should be easy: just try to mimic the changes introduced into ARC driver, and provide a suitable alternative for Endpoint_ResetDataToggle()

How to Build

Checkout the rockbox_psgroove repository

  git clone git://github.com/shuffle2/rockbox_psgroove.git

Build the toolchain for your device

  cd rockbox_psgroove
  sudo tools/rockboxdev.sh

Fetch the pl3 submodule

  git submodule init
  git submodule update

Build the ps3 toolchain

There are a few ps3 toolchains available, such as HACKERCHANNEL/ps3chain and ooPo/ps3toolchain. Clone the repo and follow the readme to install the toolchain of your choosing.

Compile the pl3 payloads and rockbox_psgroove

  cd firmware/usbstack/pl3
  make
  cd ..
  # now, edit firmware/usbstack/config.h.  
  cd ../..
  mkdir build_yourdevicenamehere
  cd build_yourdevicenamehere
  ../tools/configure
  make

Finished!

If you don't already have it installed, install the rockbox bootloader. Now, replace the firmware file on the device with the one you just compiled.

Note: you can install directly while compiling like so:

  make PREFIX=/path/to/device bininstall