dev builds
themes manual
device status forums
mailing lists
IRC bugs
dev guide

Search | Go
Wiki > Main > SummerOfCode > SummerOfCode2011 > StandaloneAudioLibrary (r4)
This project is part of the Google Summer of Code 2011 project.

Project name Student Mentor Backup mentor
Standalone audio library Sean Bartell Michael Giacomelli  


My project is to separate out Rockbox's codecs, metadata parsing, and DSP code into a separate library. I'll add an automated testing suite, make the library usable by other embedded software, and perform some other improvements. My project will make codec development easier, and hopefully external projects will use and make contributions to the library.

In progress

Remove dependencies on other Rockbox code

The library currently has various dependencies on other Rockbox code, especially headers. These need to be removed so that external users need not build the whole of Rockbox in order to use the library. This is complicated by embedded devices' need for efficiency, which means it's best to avoid layers of wrapper functions.

I plan to remove dependencies on Rockbox by having a user‐provided header file (rbcodecconfig.h, say) that provides a #define for every function needed by the library. If a portable implementation of the function is possible (e.g. for strlcpy), and it isn't defined in the header file, a default implementation will be compiled.

Future work

Write test suite

This will be my project's most direct benefit to Rockbox. I plan to write a Python driver that will decode each test file and do an exact comparison against known correct output. For new test files, where there's no known output, I'll use fuzzy comparisons (e.g. PSNR) against other libraries and tools. The driver will also check the results of seeking, and test the other library features.

It may be possible to test platform-dependent assembly code with qemu or another emulator. I'm also interested in checking coverage and using other techniques, like Valgrind.

Clean up the API

The initial focus will be on getting the library working, not on a nice API. In order to appeal to software other than Rockbox, I'll change the API to make it cleaner and more flexible. I'll examine other codec software (both proprietary and open), talk to interested projects (if any), and make a big list of features the ideal library would have. This includes anything from documentation (essential) to reading lyrics files (feature creep). We can then figure out which items are feasible and important enough to implement this summer.

If there's still time left, further work may include performance optimization and bughunting.

Completed work

Write test program

I have written a codec test program (FS#12190, requires FS#12189) that can play files with SDL, convert them to WAV, and apply some DSP effects. This program will become the basis for the test suite. I've already found one bug (FS#12164) with this program and Valgrind.

Compile audio code as a library

The library includes the decoders, encoders, metadata parsers, and DSP code (resampling, equalization, and timestretching). The library has its own makefile, which can be used either by a normal Rockbox build or by a separate application such as the test program. However, building it separately is very complicated, requiring many #defines and makefile rulesócleaning this up is the next step. The code is not yet available.


As a warmup task, I removed or commented unused codec code, and made other parts static: FS#12140, FS#12141, FS#12142, FS#12143.


Codec bugs found and fixed: FS#12130 (ADX), FS#12146 (Cook), FS#12163 (AIFF), FS#12164 (Cook, ATRAC-3 RM).

Other fixes not related to codecs: FS#12121, FS#12188.

-- SeanBartell
r4 - 13 Jul 2011 - 07:30:24 - SeanBartell

Copyright © by the contributing authors.