In this post I show you how to set the development environment for the Rockbox firmware.

In questo post vi mostro come impostare l'ambiente di sviluppo per il firmware Rockbox.

Installation of the Rockbox development environment

Hello world, and welcome to this new post.
I'm going to talk about Rockbox again, this time I will show you how to set the development environment for it.
As for the previous post, I'm assuming you are under a GNU/Linux distribution, and that you want to make programs on an iPod 5G (that is, iPod Video, 30 Gb model).

  1. Be sure you have installed build-essential and texinfo, if not, you can use the following command:
    sudo apt-get install build-essential texinfo
    As the official tutorial says, be sure these utilities are installed too:
    • gcc
    • make
    • patch
    • perl
    • zip
    • gawk
    • bison
    • flex
    • automake
    • libtool
    • curl
  2. Download the Rockbox source code from here.
    In order to proceed, we need a cross-compiler that compiles for the iPod architecture. Fortunately, the Rockbox source comes with a simple script that simplifies the process.
    Unpack the source code somewhere, access the directory "tools" from a terminal window, and in the end type:
    chmod +x rockboxdev.sh
    ./rockboxdev.sh
    The program will ask you what kind of architecture you want the cross-compiler to compile.
    In our case it's an iPod, that means, we need to type "a" (without quotes).
  3. Wait until everything is downloaded and configured.
    It may take some time, so I suggest you to have a look at the process every once in a while and do something else.
    Once everything has been completed, you have to change the permissions to some files.
    If you don't, errors will be raised during the build.
    These are the exact commands I needed to perform:
    chmod +x *.pl
    chmod +x *.sh
    chmod +x *.py
    chmod +x genlang
    chmod +x configure
    chmod +x ../apps/plugins/lua/*.pl
  4. Go to the root directory of the source code, and in there, make a directory called "build". Now go into it and type:
    ../tools/configure
    You're going to see a list of devices (and related number), search for the Apple iPod section, iPod Video is represented by the number 22, so type 22 and press Enter.
    After that, the program will ask you for the type of configuration, here, type "N" (without quotes).
    Now, if you look at the build directory, you're going to see a makefile.
  5. Ok, we're done, let's test and see if everything went correctly, try to compile by typing:
    make
    (To have a zip version of the compiled system, you must type "make zip" or "make fullzip").
    If everything went ok, then you succeeded, that is, you can compile the Rockbox firmware!

Now, as a test, try to create a new program, maybe by copying an existent one.
In order to compile your single "plugin" (that's how programs are named in Rockbox), you have to make different things according to the program technical structure:

  • If your program has one single source file, then, just add the file in the directory "apps/plugins" and add the filename into the "apps/plugins/CATEGORIES" and "apps/plugins/SOURCES" text files.
  • If your program is composed by two or more source files, then make a directory with the name you want to give to the program, put all the sources in it, create a makefile there, and then move it in the "apps/plugins" directory.
    In the end, add the directory name into the "apps/plugins/CATEGORIES" and "apps/plugins/SUBDIRS" text files.

then compile again as you did before.

Ok guys, that's all for today, I hope you find this tutorial useful, and that you enjoy making programs on your iPod.
If you're interested in the project, visit the Rockbox official website in order to find more documentation and examples about it, even in relation to other devices.
As usual, see you another time, in another post!

Go back to the top, Share, Look at the comments or Comment yourself!

Installazione dell'ambiente di sviluppo di Rockbox

Salve mondo, e benvenuti in questo nuovo post.
Oggi parlerò di nuovo di Rockbox, questa volta vi mostrerò come impostarne l'ambiente di sviluppo.
Come per il precedente post, assumerò che utilizziate una distribuzione GNU/Linux, e che vogliate fare programmi su un iPod 5G (ovvero, iPod Video, modello da 30 Gb).

  1. Assicuratevi che build-essential e texinfo siano installati, se no, potete usare il comando seguente:
    sudo apt-get install build-essential texinfo
    Come dice il tutorial ufficiale, assicuratevi che siano installati anche i seguenti programmi:
    • gcc
    • make
    • patch
    • perl
    • zip
    • gawk
    • bison
    • flex
    • automake
    • libtool
    • curl
  2. Scaricate il codice sorgente di Rockbox da qui.
    Per procedere, abbiamo bisogno di un cross-compilatore che compili per l'architettura dell'iPod. Fortunatamente, il sorgente di Rockbox viene fornito con un semplice script che semplifica il processo.
    Scompattate il codice sorgente da qualche parte, accedete alla cartella "tools" da una finestra di terminale e digitate:
    chmod +x rockboxdev.sh
    ./rockboxdev.sh
    Il programma vi chiederà che tipo di architettura volete che il cross-compilatore compili.
    Nel nostro caso è un iPod, ciò significa che dobbiamo digitare "a" (senza virgolette).
  3. Attendete finché tutto non venga scaricato e configurato.
    Potrebbe volerci del tempo, pertanto vi suggerisco di dare un'occhiata al processo di tanto in tanto e fare qualcos'altro.
    Una volta che tutto è stato completato, dovete cambiare i permessi ad alcuni file.
    Se non lo fate, verranno sollevati degli errori durante la compilazione.
    Questi sono gli esatti comandi che ho dovuto effettuare:
    chmod +x *.pl
    chmod +x *.sh
    chmod +x *.py
    chmod +x genlang
    chmod +x configure
    chmod +x ../apps/plugins/lua/*.pl
  4. Andate nella cartella del codice sorgente, e lì, create una cartella chiamata "build". Ora andateci e digitate:
    ../tools/configure
    Vedrete una lista di dispositivi (e numero correlato), cercate la sezione dell'Apple iPod, l'iPod Video è rappresentato dal numero 22, quindi digitate 22 e premete Invio.
    Dopodiché, il programma vi chiederà il tipo di configurazione, qui, digitate "N" (senza virgolette).
    Ora, se guardate la cartella build, vedrete un makefile.
  5. Ok, abbiamo finito, testiamo e vediamo se tutto è andato bene, provate a compilare digitando:
    make
    (Per avere una versione zip del sistema compilato, dovete digitare "make zip" o "make fullzip").
    Se tutto è andato bene, ce l'avete fatta, ovvero, potete compilare il firmware Rockbox!

Ora, per testare, provate a fare un nuovo programma, magari copiandone uno già esistente.
Per compilare il vostro "plugin" (è così che vengono chiamati i programmi in Rockbox), dovete fare cose diverse in base alla struttura tecnica del programma:

  • Se il programma ha un singolo file sorgente allora aggiungete il file alla cartella "apps/plugins" e aggiungetene il nome nei file di testo "apps/plugins/CATEGORIES" e "apps/plugins/SOURCES".
  • Se il programma è composto da due o più file sorgenti, allora create una cartella col nome che volete dare al programma, metteteci tutti i sorgenti, create anche il makefile, e spostate tutto nella cartella "apps/plugins".
    Alla fine, aggiungete il nome della cartella ai file di testo "apps/plugins/CATEGORIES" e "apps/plugins/SUBDIRS".

poi compilate come avete fatto prima.

Ok ragazzi, è tutto per oggi, spero che troviate questo tutorial utile, e che vi divertiate a fare programmi sull'iPod.
Se siete interessati al progetto, visitate il sito ufficiale di Rockbox per trovare più documentazione ed esempi, anche in relazione ad altri dispositivi.
Come al solito, ci si vede un'altra volta, in un altro post!

Torna in cima, Condividi, Guarda i commenti o Commenta tu stesso!