Rockbox User Manual Make your box rock!
Open Source jukebox firmware for the Archos Jukebox 5000, 6000, Studio, Recorder, Recorder V2 and FM Recorder MP3 players Website: http://www.rockbox.org http://www.rockbox.org/ www.rockbox.org/ Rockbox version 2.4 Manual release date 2004-12-23 Copyright © 2004 Christi Alice Scarborough, 2003 José María García-Valdecasas Bernal & Peter Schlenker. Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.
Part 1: Getting Started............................................................................................. Started.............................................................................................7 .............................................................................................7 Part 2: The Rockbox Interface................................................................................ ................................................................................
1.12 Star (Recorder, Ondio)...................................................................................49 1.13 Wormlet (Recorder)........................................................................................49 2 Demos.......................................................................................................................52 2.1 Bounce (Recorder, Ondio)..............................................................................52 2.2 Cube (Recorder, Ondio).....................
7.6 Known Issues and Limitations...........................................................................83 7.7 ROMbox.............................................................................................................83 Appendices............................................................................................................. .............................................................................................................84 84 Appendices ..................................
Part 1: Getting Started
Welcome This is the manual for Rockbox. Rockbox is a replacement firmware for the Jukebox Studio, Recorder and Ondio players made by Archos. It is a complete rewrite of the software used to make the Jukeboxes play and record music, and contains many features and enhancements not available in the original firmware supplied by the manufacturer.
The model name is printed on the case. The hard drive size is listed on the serial number sticker on the back of the unit.
Downloading Rockbox The latest release of the Rockbox software will always be available from http://www.rockbox.org/download/. Windows users may wish to download the self-extracting Windows installer, which works for all Jukebox models, but those wishing to install manually or using a different operating system should choose the . zip archive containing the firmware for their model of the Jukebox.
Uninstalling Rockbox If you would like to go back to using the original Archos software, then connect the Jukebox up to your computer, and delete the archos.mod (players) or ajbrec.ajz (other models) file from the main folder of the Jukebox. If you wish to clean up your disk, you may also wish to delete the /.rockbox .rockbox folder and its contents. Turn the Jukebox off and on and the normal Archos software will load.
Part 2: The Rockbox Interface
1 Your Jukebox Jukebox Player Jukebox Recorder Ondio 128 Part 2: The Rockbox Interface 13
Throughout this manual, the buttons on the Jukebox are labelled according to the pictures above. There are minor cosmetic differences between Jukebox models, but the buttons are in approximately the same position as on the picture. To turn on a Jukebox containing Rockbox, hold down the ON key for 2-3 seconds. (Flashed Jukeboxes only require a tap of the ON key – see page 78 for more information about flashing Rockbox.
2.1 Controls Recorder KEY FUNCTION Go to previous/next item in list. If you are on the first/last entry, UP/DOWN the cursor will wrap to the last/first entry. ON+UP/DOWN Move one page up/down on the list. LEFT Go to the parent directory. Executes an action. Depending on the file type, that action PLAY/RIGHT may vary. (See page 15) If there is a MP3 playing, returns to the While Playing Screen ON (WPS) without stopping playback.
Open with: Runs a viewer plugin on the file. Normally the filetype of a file is detected and the appropriate plugin is run automatically when you press play on it. Use this menu if for some reason you want to override the default action and select a viewer by hand. See page 56 for more details on viewers.
You can insert a track, directory or playlist even if nothing is currently playing. In this case, a new playlist is created with only the selected tracks and then play is started. Note: The dynamic playlist is saved so resume will restore it exactly as before shutdown. Stopped playlists can be resumed from File Browser by pressing ON. 2.4 Virtual Keyboard Recorder keyboard Player Keyboard This is the virtual keyboard that is used when entering file names in Rockbox.
The function of the PLAY and STOP buttons depends on what the arrow is pointing to, as follows. SELECTED OPTION filename PLAY/STOP FUNCTION Moves the cursor left (STOP) or right (PLAY) within the filename Moves the character bar to the next (PLAY) or previous (STOP) character.
The peak meter is only visible if you turn off the status bar or if using a small font that gives 8 or more display lines. Player Playlist index/Playlist size: Artist - Title Current-time Progress-indicator Left See page 70 for details of customising your WPS (While Playing Screen). 3.
3.2 Peak Meter (Recorder, Ondio) The peak meter can be displayed on the While Playing Screen and consists of several indicators. For a picture of the peak meter, please see the While Recording Screen on page 24. The bar: This is the wide horizontal bar. It represents the current volume value. The peak indicator: This is a little vertical line at the right end of the bar. It indicates the peak volume value that occurred recently.
Rockbox handles function buttons in a different way to the Archos software. F1 is always bound to the menu function, while F2 and F3 enable two quick menus. F2 displays some browse and play settings which are likely to be changed frequently. This settings are Shuffle mode, Repeat mode and the Show files options Shuffle mode plays each track in the currently playing list in a random order rather than in the order shown in the browser.
Part 3: The Main Menu
1 Introducing the Main Menu Recorder main menu Player main menu This is the screen from which the rest of the Rockbox functions can be accessed. It is used for a variety of functions, which are detailed below. You can access the Rockbox main menu by pressing MENU (player/studio version) or F1 (recorder version) key. All options in Rockbox can be controlled via this menu. Some of them can also be found in the Quick Menus (recorder version only). All settings are persistently stored on the unit.
2 Recording (Recorder, Ondio FM) 2.1 While Recording Screen Recording Screen Recording F2 screen Recording F3 screen Entering the “Recording” option in the Main menu launches the recording application. The screen shows the time elapsed and the size of the file being recorded. A peak meter is present to allow you set Gain correctly. The frequency, channels and quality settings are shown on the last line.
Frequency Choose the recording frequency (sample rate) - 48kHz, 44.1kHz, 32kHz (MPEG version 1), and 24kHz, 22.05kHz, 16kHz (MPEG version 2) are available. Higher sample rates use up more disk space, but give better sound quality. This setting determines which frequency range can accurately be reproduced during playback. Lower frequencies produce smaller files, for two reasons. The amount of data to be compressed is smaller and the data is easier to compress, since higher frequencies are not present.
3 FM Radio ((FM FM recorder Ondio FM) FM radio screen This menu option switches to the radio screen. The keys are: BUTTON LEFT, RIGHT UP, DOWN PLAY ON OFF FUNCTION Change frequency in 0.1 MHz steps. For automatic station seek, hold LEFT/RIGHT for a little longer. Change volume (EXPERIMENTAL) freezes all screen updates, may enhance radio reception in some cases.
4 Bookmarks The bookmarks menu allows you to create and manage bookmark files. Create Bookmark While playing a track, use this option to save your current position within the track so that you can return to it at a later time. Bookmarks are saved on a per folder basis i.e. all of the files in the same folder have their bookmarks stored together. You can store multiple bookmarks for the same track.
Save Current Playlist Saves the current dynamic playlist, excluding queued tracks, to the specified file. If no path is provided then playlist is saved to current directory (see page 16). Recursively Insert Directories If set to ON then when you insert/queue a directory in Dynamic Playlist, all subdirectories will also be inserted. If set to ASK then you are prompted about recursive insertion when inserting a directory.
Debug (Keep Out!) This submenu is intended to be used only by Rockbox developers. It shows hardware, disk, battery status and a lot of other information. It is not recommended that users access this menu unless instructed to do so in the course of fixing a problem with Rockbox. In particular the “Dump ROM Contents”, “View/clear RTC RAM” and “Screenshot” and “Sound test” functions should be treated with care.
Part 4: Configuring Rockbox
1 Sound Settings Recorder sound settings Player sound settings This menu offers a selection of sound properties you may change to improve your sound experience. Volume The sound volume your music is played at. Although settable range is 0-100%, many units don't produce audible output below 40%. On Recorders, volume settings above 92% will cause distortion (clipping) and are not recommended. Bass This emphasises or suppresses the lower (bass) sounds in the track.
Karaoke: Removes all sound that is the same in both channels. Since most vocals are recorded in this way to make the artist sound central, this often (but not always) has the effect of removing the voice track from a song. Loudness (Recorder only) Loudness is an effect which emphasises bass and treble. This makes the track seem louder by amplifying the frequencies that the human ear finds hard to hear. Frequencies in the vocal range are unaffected, since the human ear picks these up very easily.
MDB Harmonics: Harmonics The percentage of the low notes that is converted into harmonics. If low notes are causing speaker distortion, this can be set to 100% to eliminate the fundamental completely and only produce harmonics in the signal. If set to 0% this is the same as turning the MDB feature off. MDB Centre Frequency: The cutoff frequency of your headphones or speakers. This is usually given in the specification for the headphones/speakers. MDB shape: It is recommended that this parameter be set to 1.
Repeat Repeat modes are Off/One/All. "Off" means no repeat. "One" means repeat one track over and over. "All" means repeat playlist/directory. Play Selected First This setting controls what happens when you press PLAY on a file in a directory and shuffle mode is on. If this setting is Yes, the file you selected will be played first. If this setting is No, a random file in the directory will be played first. Resume Sets whether Rockbox will resume playing at the point where you shut off.
2.2 File View This menu deals with options relating to how the file browser displays files Sort Case Sensitive If this option is enabled files that start with a lower case letter will appear after the files that start with an upper case letter have all been listed. If disabled, then case will be ignored when sorting files. Sort Directories This option controls how Rockbox sorts folders. The default is to sort them alphabetically. “By date” sorts them with the oldest folder first.
2.3 Display Options Browse fonts Browse the fonts that reside in your /.rockbox directory. Selecting one will activate it. See page 69 for further details about fonts. Browse WPS files Opens the file browser in the /.rockbox directory and displays all .wps files. Selecting one will activate it, stop will exit back to the menu. For further information about the WPS see page 18. For information about editing a .wps file see page 70.
Bidirectional Scroll Limit: Rockbox has two different scroll methods, always scrolling the text to the left, and when the line has ended, beginning again at the start, or moving to the left until you can read the end of the line, and scroll right until you see the beginning again. Rockbox chooses which method it should use, depending of how much it has to scroll left. This setting lets you tell Rockbox where that limit is, expressed in percentage of line length.
Scale: Scale Select whether the peak meter displays linear or logarithmic values. In “dB” (decibel) scale the volume values are scaled logarithmically. This very similar to the perception of loudness. The volume meters of digital audio devices usually are scaled this way. If you are interested in the power level that is applied to your headphones you should choose “linear” display. Unfortunately this value doesn't have real units like volts or watts since that depends on the phones.
Disk Poweroff: (non v2/FM-recorder only) Whether the disk is powered OFF or only set to “sleep” when spun down. Power off uses less power but takes longer to spin-up. Time and Date (Recorder Only) Time related menu options. Set Time/Date: Set current time and date. Time Format: Choose 12 or 24 Hour clock. Idle Poweroff Rockbox can be configured to turn off power after the unit has been idle for a defined number of minutes. The unit is idle when playback is stopped or paused.
When using the Jukebox in a car, car adapter mode automatically stops playback on the Jukebox when power (i.e. from cigarette lighter power adapter) to the external DC in jack is turned off. When the external power off condition is detected, the Car Adapter Mode function only pauses the playback. In order to shut down the Jukebox completely the Idle Poweroff function (see above) must also be set.
2.5 Bookmarking Bookmark on Stop Write a bookmark to the disk whenever the stop key is pressed. If playback is stopped it can be resumed easily at a later time. The Resume function remembers your position in the most recently accessed track regardless of this setting. Load Last Bookmark When this is on, Rockbox automatically returns to the position of the last bookmark within a file when it is played. If set to Ask, Rockbox will ask the user whether they want to start from the beginning or the bookmark.
Voice Directories This option turns on the speaking of directory names. The Jukebox is not powerful enough to produce these voices in real time, so a number of options are available. .talk mp3 clip: Use special pre-recorded MP3 files (_dirname.talk _dirname.talk) _dirname.talk in each directory. These must be generated in advance, and are typically produced synthetically using a text to speech engine on a PC. If no such file exists, the output is as for the “numbers” option below.
Part 5: Plugins
Plugins are little programs that Rockbox can load and run. Plugins have the file extension .rock. Most of them can be started from the main menu if you put them in the /.rockbox/rocks directory. Press PLAY on them to start them. Viewer plugins get started automatically by "playing" an associated file (i.e. text files, chip8 games), or from the “Open with” option on the File menu.
1.2 Jackpot (Player) Jackpot This is a jackpot slot machine game. At the beginning of the game you have 20$. Payouts are given when three matching symbols come up. KEY ACTION PLAY STOP Play Exit the game 1.3 Minesweeper (Recorder, Ondio) The classic game of minesweeper. Use the UP and DOWN keys to select the required percentage of mines to set the difficulty then press the MENU key to begin. The aim of the game is to uncover all of the squares on the board.
Rules of Nim: There are 21 matches. Two players (you and the Jukebox) alternately pick a certain number of matches and the one who takes the last match loses. You can take up to twice as many matches as the Jukebox selected, and vice versa. KEY MINUS PLUS PLAY STOP ACTION Decrease the number of matches Increase the number of matches Remove the number of matches you have selected Exit the game 1.5 Pong (Recorder, Ondio) Pong game The world's first arcade game comes to Rockbox.
KEY ACTION UP LEFT/RIGHT DOWN OFF Rotate piece Move piece to the left/right Move faster the piece downwards Exit Rockblox 1.7 Sliding Puzzle (Recorder, Ondio) Sliding puzzle The classic sliding puzzle game. Rearrange the pieces so that you can see the whole picture. Key controls: KEY UP/DOWN/LEFT/RIGHT F1 F2 OFF ACTION Moves Shuffle Change the picture Stop the game 1.8 Snake (Recorder, Ondio) This is the popular snake game.
The controls are: KEY ACTION UP/DOWN F1 F3 UP/DOWN/LEFT/RIGHT PLAY STOP (in menu) Set game speed (in menu) Change starting maze (in menu) Select game type (A or B) Steer the snake Pause the game Exit the game In game A, the maze stays the same, in Game B after an increasing number of apples eaten the maze is replaced by a new one. 1.10 Sokoban (Recorder, Ondio) Sokoban The object of the game is to push boxes into their correct position in a crowded warehouse with a minimal number of pushes and moves.
1.12 Star (Recorder, Ondio) Star game This is a puzzle game. It is actually a rewrite of Star, a game written by CDK designed for the hp48 calculator. Rules: Take all of the "o"s to go to the next level. The on key allows you to switch between the filled circle, which can take “o”s, and the filled square, which is used as a mobile wall to allow your filled circle to get to places on the screen it could not otherwise reach. The block cannot take "o"s.
Game controls: PLAYERS MODES 0 Out of control 1 2 3 PLAYER 1 PLAYER 2 PLAYER 3 With no player taking part in the game all worms are out of control and steered by artificial stupidity.
Walls Don't crash into the walls. Walls are not edible. Crashing a worm against a wall causes it a headache it doesn't survive. Game over The game is over when all worms are dead. The longest worm wins the game. Pause the game Press the PLAY key to pause the game. Hit PLAY again to resume the game. Stop the game There are two ways to stop a running game. If you want to quit Wormlet entirely simply hit the OFF button. The game will stop immediately and you will return to the game menu.
Argh: Argh : If the score board entry displays "Argh" it means the worm is dead because it tried to eat an “argh”. Until we can make the worm say "Argh!" it's your job to say "Argh!" aloud. Wormed: Wormed: The worm tried to eat another worm or even itself. That's why it's dead now. Making traps for other players with a worm is a good way to get them out of the game. Hints Initially you will be busy with controlling your worm. Try to avoid other worms and crawl far away from them.
Key controls for this demo are: KEY F1/F2/F3 UP/DOWN LEFT/RIGHT ON OFF ACTION Enters Bounce configuration options Moves to next/previous option Increases/decreases option value Changes to Scroll mode Exits bounce demo Available options are: Xdist/Ydist: The distance to X axis and Y axis respectively Xadd/Yadd: how fast the code moves on the sine curve on each axis Xsane/Ysane: Changes the appearance of the bouncing. 2.2 Cube (Recorder, Ondio) Cube This is a rotating cube screen saver in 3D.
This is a plugin demo for hackers. Every programmer's first program is the hello world-program which does nothing except displaying "Hello world!" on the screen. 2.5 Mandelbrot (Recorder, Ondio) Mandelbrot This is another demonstration using the grayscale engine. It draws fractal images from the Mandelbrot set. KEY ARROW KEYS PLAY OFF F1 F2 F3 ACTION Move about the image Zoom in Quit Increase iteration depth (more detail) Decrease iteration depth (less detail) Reset and return to the default image 2.
Key controls: KEY F1 F2 F3 UP DOWN PLAY OFF ACTION toggles whether to scroll or not toggles filled / curve / plot reset speed to 0 slow down scrolling Speeds up scrolling Pauses the demo Exits demo 2.8 Snow (Recorder, Ondio) Have you ever seen snow falling? This demo replicates snow falling on your screen. If you love winter, you will love this demo. Or maybe not. 2.9 VU meter (Recorder, Ondio) VU meter This is a VU meter, which displays the volume of the left and right audio channels.
3 Viewers Viewers are plugins which are associated with specific file extensions. They cannot be run directly but are started by “playing" the associated file. Viewers are stored in the /.rockbox/viewers/ directory. 3.1 Chip-8 Emulator (Recorder, Ondio) The Chip-8 Emulator allows you to play many old chip8 games found on the Net. It modifies Rockbox, so file extensions .ch8 will be recognised as chip8 games. Just press PLAY on a .ch8 file to start a game.
3.4 Rockbox_flash (Recorder, Ondio) Rockbox flash For "playing" .UCL files on flashed Jukeboxes. Reprograms the flash memory of the Jukebox unit (see page 78 for details). 3.5 Search This plugin can be used on playlists. It searches through the playlist that it is opened on looking for any occurrences of the string entered by the user. The results of this search are saved to a new playlist, search_results.m3u, within the same directory as the original playlist. 3.
F3 (Recorder) / ON-PLUS (Player): toggles View mode between Narrow and Wide: Narrow sets maximum column to the screen width. Wide sets maximum column to 114. Useful for navigating large files. (Currently, Wide and Join cannot be selected together.) ON-F1 (Recorder): toggles Page mode between Normal and Overlap: Normal sets page-down/page-up to one full screen. Overlap tells page-down/page-up to retain one line from previous screen. ON-F3 (Recorder): toggles Scrollbar mode, for the current View mode.
Compatibility Correctly reads plain text files in Unix, Win/DOS, or Macintosh format. Latinalphabet Unicode files are a l m o s t r e a d a b l e. Currently prefers fixed-width fonts. With proportional fonts, pretends all characters are the width of a lower-case 'o'. Currently messages are in English Does not currently support right-to-left languages. 3.8 VBRfix This function scans a VBR (Variable Bitrate) MP3 file and updates/creates the Xing VBR header.
4.2 Calculator (Recorder, Ondio) Calculator This is a simple scientific calculator for use on the Jukebox. It works like a standard calculator. Move using the arrow keys and press PLAY to press a button. Pressing the “1st” button will toggle between other available maths functions on the right hand side. 4.3 Calendar (Recorder, Ondio) Calendar This is a small and simple calendar application with memo saving function. Dots indicate dates with memos. To add a new memo press PLAY on the date.
Then the maximum round time is entered. For example, this could be used to play Scrabble for a maximum of 15 minutes each, with each round taking no longer than one minute. (press PLAY to continue). Done. Player 1 starts in paused mode. So press PLAY to start. While playing The number of the current player is displayed on the top line. The time below is the time remaining for that round (and possibly also the total time left if different).
Key configuration KEY F1 F2 F2 (HOLD) F3 PLAY UP DOWN RIGHT LEFT OFF ACTION Help Start / Stop stopwatch Reset stopwatch Options Select clock mode Enable idle power off Disable idle power off Enable backlight Disable backlight Save settings to disk and exit Backlight configuration If RIGHT or LEFT is not pressed during clock operation (with the exception of at the Help/Options/Mode Selector/Credit screens) then the backlight timeout will remain your Rockbox default setting (example, 15 seconds).
4.7 Favorites Favorites When listening to any song you can open it with this plugin and it will add the current song to a special playlist of all songs you selected in /favorites.m3u. /favorites.m3u 4.8 Firmware_flash (Recorder, Ondio) Firmware_flash Use when flashing Rockbox (see page 78). In the ideal case, you'll need this tool only once. For safety reasons you may wish to delete firmware_flash.rock from /. rockbox/rocks once flashing is complete. 4.
4.10 Split Editor (Recorder, Ondio) When recording an mp3 file, it is common practice to start the recording a little bit early and stop it a little bit late to ensure all the desired sound is recorded. This results in recordings that contain extra snippets of sound and the beginning and end. Unfortunately these snippets can not be deleted easily because they are stored in the same file as the desired recording.
(3)The split time At the top of the window a time value is displayed. This is the point in time within the song at which the split point indicator is positioned. (4)The locator Another vertical bar represents the position locator. It moves along as the song plays. In contrast to the split point indicator it has no triangles at the ends. (5)The time bar The time bar displays the current position within the song relative to the whole song. The entire length of the time bar represents the song length.
(8)Perform the split The icon directly above the F1 button indicates its function to execute the split. When split positioning is complete open the save dialogue with F1.
Scale The values in the waveform are scaled according to the settings of the peak meter. These can be altered in the menu "General General Settings -> Display -> Peak Meter". Meter If extreme minimum / maximum values are set the waveform might be cut off. A minimum setting of -60 dB and a maximum setting of 0 dB are recommended. These settings should be capable of producing useful waveforms for very soft sounds in logarithmic mode (dB).
Part 6: Advanced Topics / Reference
1 Customising the user interface 1.1 Getting Extras (Fonts, Languages) Rockbox supports custom fonts (for the Recorder and Ondio only) and a number of different languages. Rockbox 2.4 comes with 41 fonts and 24 languages already included. If new fonts and language files have been created, then they will be found at http://www.rockbox.org/fonts/ and http://www.rockbox.org/lang/. 1.2 Loading Fonts (Recorder, Ondio) Rockbox can load fonts dynamically. Simply copy the .
2 Configuring the WPS Description / General Info The Custom While Playing Screen (WPS) display is used on both the Player and Recorder as a means to customise the WPS to the user's likings. After editing the .wps file, "play" it to make it take effect. The file may be 2 lines long for the Player, and 13 lines for the Recorder. All characters not preceded by % are displayed as typed. Lines beginning with # are comments and will be ignored. File Location Custom WPS files may be located anywhere on the drive.
%fp : File Path %fs : File Size (In Kilobytes) %fv : "(vbr)" if variable bit rate or "" if constant bit rate %d1 : First directory from end of file path. %d2 : Second directory from end of file path. %d3 : Third directory from end of file path. Example for the the %dN commands: If the path is /Rock/Kent/Isola/11 -747. mp3, %d1 is "Isola", %d2 is "Kent", %d3 is 'Rock'. Playlist/Song Info Tags: %pb : Progress Bar Player: This will display a 1 character "cup" that empties as the song progresses.
If you use the upper-case versions of the three tags: F, I and D, they will instead refer to the next song instead of the current one. Example: %Ig is the genre name used in the next song and %Ff is the mp3 frequency. Take note that the next song information WILL NOT be available at all times, but will most likely be available at the end of a song.
Default If you haven't selected a .wps file in the /.rockbox directory, you get the hard coded WPS layout. The default WPS screen for Players is: %s%pp/%pe: %?it<%it|%fn> - %?ia<%ia|%d2> - %?id<%id|%d1> %pc%?ps<*|/>%pt And for the Recorder and Ondio: %s%?it<%?in<%in. |>%it|%fn> %s%?ia<%ia|%?d2<%d2|(root)>> %s%?id<%id|%?d1<%d1|(root)>> %?iy<(%iy)|> %pc/%pt [%pp:%pe] %fbkBit %?fv %?iv<(id3v%iv)|(no id3)> %pb %pm 3 Making your own settings file A .
repeat (off, all, one) play selected (on, off) resume (off, ask, ask once, on) scan min step (1, 2, 3, 4, 5, 6, 8, 10, 15, 20, 25, 30, 45, 60) [secs] scan accel (0 - 15) [double scan speed every X seconds] antiskip (0 - 7) [seconds] volume fade (on, off) sort case (on, off) show files (all, supported, music, playlists) follow playlist (on, off) playlist viewer icons (on, off) playlist viewer track display (on, off) recursive directory insert (on, off) scroll speed (0 - 15) scroll dela
idle poweroff (off, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 15, 30, 45, 60) [minutes] lang (/path/filename.lng) wps (/path/filename.wps) autocreate bookmarks (on, off) autoload bookmarks (on, off) use most-recent-bookmarks (on, off) talk dir (off, number, spell, hover) talk file (off, number, spell, hover) talk menu (off, on) Recorder-specific settings loudness (0 - 17) super bass (on, off) auto volume (off, 0.
45min, 90min) peak meter busy (on, off) peak meter dbfs (on, off) (on = dbfs, off = linear) peak meter min (0 - 89) [dB] or (0 - 100) [%] peak meter max (0 - 89) [dB] or (0 - 100) [%] statusbar (on, off) scrollbar (on, off) volume display (graphic, numeric) battery display (graphic, numeric) time format (12hour, 24hour) font (/path/filename.
FM recorder specific settings force fm mono (on,off) Example File volume: 70 bass: 11 treble: 12 balance: 0 time format: 12hour volume display: numeric show files: supported wps: /.rockbox/car.wps lang: /.rockbox/afrikaans.lng 4 Differences between binaries There are 3 different types of firmware binaries from Rockbox website. Current Version, Daily Builds and Bleeding Edge. The current version is the latest stable version developed by the Rockbox Team.
The V2 recorder is a recorder in an FM Recorder form factor, but without radio. The 8mb version requires a hardware hack, where the RAM chips are replaced. The Ondio builds come with and without radio support, for the Ondio FM and SP respectively. If in doubt as to which version to use, the table on page 9 may be of assistance. Note: All references in this manual to "Recorder" apply equally to the FM Recorder unless otherwise specified.
7.1 Introduction Flashing in the sense used here and elsewhere in regard to Rockbox means reprogramming the flash memory of the Jukebox unit. Flash memory (sometimes called "Flash ROM") is a type of non-volatile memory that can be erased and reprogrammed in circuit. It is a variation of electrically erasable programmable read-only memory (EEPROM). A from the factory Jukebox comes with the Archos firmware flashed. It is possible to replace the built-in software with Rockbox.
However, the code has been extensively tested and is known to work well. The new firmware file is completely read before it starts programming, there are a lot of sanity checks. If any fail, it will not program. There is no reason why such low level code should behave differently on your Jukebox. There's one ultimate safety net to bring back Jukeboxes with even completely garbled flash content: the UART boot mod, which in turn requires the serial mod.
7.5 Flashing Procedure Here are step-by-step instructions on how to flash and update to a current build. It is assumed that you can install and operate Rockbox the usual way. The flashing procedure has a lot of failsafes, and will check for correct model, file, etc. - if something is incompatible it just won't flash, that's all. Now here are the steps: Preparation Install (with all the files, not just the .ajz) and use the current daily build you'd like to have.
Install the Rockbox Bootloader (“formatting” the flash) This procedure is only necessary the first time you flash Rockbox. Unplug the USB cable again, then select Browse Plugins from the main menu (F1). Locate firmware_flash.rock, firmware_flash.rock and start it with PLAY. Rockbox now displays an info screen, press F1 to acknowledge it and start a file check.
It is possible that you could get an "Incompatible Version" error if the plugin interface has changed since you last flashed Rockbox. This means you are running an "old" copy of Rockbox, but are trying to execute a newer plugin, the one you just downloaded. The easiest solution is to ROLO into this new version, by playing the ajbrec.ajz file. Then you are consistent and can play rockbox.ucl. rockbox.ucl When done, you can restart the box and hopefully your new Rockbox image.
Appendices
1 Feature Comparison Chart FEATURE ID3v1 and ID3v2 support Background noise during playback Mid-track resume Mid-playlist resume Resumed playlist order Battery lifetime Battery time indicator Customizable font (Recorder) Customizable screen info when playing songs USB attach/detach without reboot Can load another firmware without rebooting Playlist load speed, songs/sec Max number of songs in a playlist Supports bad path prefixes in playlists Open source/development process Corrects reported bugs Automatic
FEATURE ROCKBOX Pre-Recording (Recorders) Video Playback with sound (Recorders) Boot Time from Flash (in seconds) Speaking Menus Support Yes Yes 4 Yes ARCHOS Yes No 12 No 2 Supported File Formats FILE TYPE Directory .mp3 .m3u .ajz/ .mod .wps .lng .txt .cfg .fnt .rock .ucl .ch8 .jpg .
All relevant data regarding the problem, such as playlists, MP3 files etc. (IMPORTANT!) 3. If you have a Sourceforge account, log in before you file the report. 4. If you don't have a SF account, sign the report with your email. 4 Feature Requests For open feature requests refer to http://www.rockbox.org/requests.shtml Rules for submitting a new feature request: 1. Check that the feature hasn't already been requested. Duplicates are really boring! 2. Check that the feature hasn't already been implemented.
Support MP3pro, WMA or other sound format playback! The mp3-decoding hardware can only play MP3. We cannot make it play other sound formats. Converting OGG-> OGG->MP3 The mp3-decoding hardware cannot decode OGG. It can be reprogrammed, but there is too little memory for OGG and we have no documentation on how to program the MAS' DSP. Doing the conversion with the CPU is impossible, since a 12MHz SH1 is far too slow for this daunting task.
Cool sound effects! Adding new sound effects requires reprogramming the MAS chip, and we can't do that. The MAS chip is programmable, but we have no access to the chip documentation. 6 What's new since 2.0? Changes in version 2.4 Improved shuffle Improved disk write performance Improved Ondio support Various bug fixes Added 74 and 80 minute recording time splits for convenient CD creation Changes in version 2.3 General changes since 2.
More detailed MDB (dynamic bass) settings ROMbox, optionally saving ~170KB RAM by running code from flash on Recorder v1 and Ondio SP Recording can pause Recorded files now get ID3 v2.3 tags instead of v2.4, since some tools have problems reading v2.4 tags Red LED behaviour changed during recording: On during recording and blinking when paused New font format. 2.3 requires new fonts, 2.2 fonts are not compatible.
.wps files now support comments Improved ID3v2 support Option of hiding icons in File Browser Player-specific changes since 2.0 Games: Jackpot and NIM Jump scroll: Scrolls the entire screen width each step The Line In port is enabled Recorder-specific changes since 2.
7 Credits People that have contributed to the project, one way or another.
8 GNU Free Documentation License Version 1.2, November 2002 Copyright © 2000,2001,2002 Free Software Foundation, Inc. 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed.
The Title Page means, for a printed book, the title page itself, plus such following pages as are needed to hold, legibly, the material this License requires to appear in the title page. For works in formats which do not have any title page as such, Title Page means the text near the most prominent appearance of the work's title, preceding the beginning of the body of the text.
E Add an appropriate copyright notice for your modifications adjacent to the other copyright notices. F Include, immediately after the copyright notices, a license notice giving the public permission to use the Modified Version under the terms of this License, in the form shown in the Addendum below. G Preserve in that license notice the full lists of Invariant Sections and required Cover Texts given in the Document's license notice. H Include an unaltered copy of this License.
You may extract a single document from such a collection, and distribute it individually under this License, provided you insert a copy of this License into the extracted document, and follow this License in all other respects regarding verbatim copying of that document. 17.