Bringing In A Rockbox Build - Rockbox Archos Jukebox Studio 5000 User Manual

C 8. A
HAPTER DVANCED
6. Connect the charger and make sure your batteries are also in good shape. That's
just for security reasons, it's not that flashing needs more power.
7. Run the firmware flash.rock plugin. It again tells you about your flash and
the file it's gonna program. After Minus it checks the file. Your hardware mask
value will be kept, it won't overwrite it. Hitting On gives you a big warning. If
we still didn't manage to scare you off, you can hitPlus to actually program and
verify. The programming takes just a few seconds. If the sanity check fails, you
have the wrong kind of boot ROM and are out of luck by now, sorry.
8. In the unlikely event that the programming should give you any error, don't
switch off the box! Otherwise you'll have seen it working for the last time. While
Rockbox is still in DRAM and operational, we could upgrade the plugin via USB
and try again. If you switch it off, it's gone.
Note: You may delete the .bin files now.

8.5.7. Bringing in a Rockbox build

Short version: very easy, just play an .ucl file like rockbox.ucl from a release or
build:
Make sure you are running the same version that you are trying to flash: play the
ajbrec.ajz file.
Enter the .rockbox directory in the file browser (you might need to set the F
V option to A
IEW
Play the rockbox.ucl file (or rombox.ucl if you want to flash ROMBox)
Long version:
The second image is the working copy, the rockbox flash.rock plugin from this
package reprograms it. The plugins needs to be consistant with the Rockbox plugin
API version, otherwise it will detect mismatch and won't run.
It requires an exotic input, a UCL-compressed image, because that's the internal for-
mat. UCL is a nice open-source compression library. The decompression is very fast
and less than a page of C-code. The efficiency is even better than Zip with maximum
compression, reduces file size to about 58% of the original size. For details on UCL, see
http://www.oberhumer.com/opensource/ucl/.
Rockbox developers using Linux will have to download it from there and compile
it. For Win32 and Cygwin the executables are next to the packages. The sample pro-
gram from that download is called uclpack. We'll use that to compress rockbox.bin
which is the result of the compilation. This is a part of the build process meanwhile.
If you compile Rockbox yourself, you should copy uclpack to a directory which is in
the path, we recommend placing it in the same dir as SH compiler.
Here are the steps:
T R
HE OCKBOX MANUAL
T
OPICS
F ).
LL ILES
A S /P
RCHOS TUDIO
57
ILE
LAYER