9e0ab22262
git-svn-id: svn://svn.rockbox.org/rockbox/trunk@30879 a1c6a512-1295-4272-9138-f99709370657
376 lines
15 KiB
TeX
376 lines
15 KiB
TeX
% $Id$ %
|
|
\chapter{\label{ref:config_file_options}Config file options}
|
|
\begin{center}
|
|
% define a local version of endhead, as using the output distinction adds
|
|
% an unwanted newline. endhead breaks with htlatex so we need to remove it
|
|
% for the html output.
|
|
\ifpdfoutput{\newcommand{\localendhead}{\endhead}}%
|
|
{\newcommand{\localendhead}{}}
|
|
\rowcolors{2}{tbloddrowbgcolor}{tblevenrowbgcolor}
|
|
\begin{longtable}{>{\raggedright}p{.3\textwidth}>{\raggedright}p{.4\textwidth}p{.2\textwidth}}
|
|
\toprule
|
|
\rowcolor{tblhdrbgcolor}\tblhdrstrut\textbf{Setting} & \textbf{Allowed Values} & \textbf{Unit}\\
|
|
\midrule\localendhead % endhead breaks with htlatex
|
|
volume & \opt{masd}{-78 to +18}%
|
|
\opt{masf}{-100 -to +12}%
|
|
\opt{iriverh100,iriverh300}{-84 to 0}%
|
|
\opt{ipodnano}{-72 to +6}%
|
|
\opt{ipodvideo,cowond2}{-89 to +6}%
|
|
\opt{iaudiom3,iaudiom5,iaudiox5}{-73 to +6}
|
|
\opt{e200,e200v2,ipodcolor,vibe500,ipodnano2g}{-74 to +6}%
|
|
& dB\\
|
|
bass & \opt{masd}{-15 to +15}%
|
|
\opt{masf}{-12 to +12}%
|
|
\opt{iriverh100,iriverh300}{0 to +24}%
|
|
\opt{ipod}{-6 to +9}%
|
|
\opt{iaudiom3,iaudiom5,iaudiox5,e200,e200v2,vibe500}{%
|
|
-24 to +24}%
|
|
& dB\\
|
|
treble & \opt{masd}{-15 to +15}%
|
|
\opt{masf}{-12 to +12}%
|
|
\opt{iriverh100,iriverh300}{0 to +6}%
|
|
\opt{ipod}{-6 to +9}%
|
|
\opt{iaudiom3,iaudiom5,iaudiox5,e200,e200v2,vibe500}{%
|
|
-24 to +24}%
|
|
& dB\\
|
|
balance & -100 to +100 & \%\\
|
|
channels & stereo, mono, custom, mono left, mono right, karaoke
|
|
& N/A\\
|
|
stereo\_width & 0 to 250 & \%\\
|
|
shuffle & on, off & N/A\\
|
|
repeat & off, all, one, shuffle, ab
|
|
& N/A\\
|
|
play selected & on, off & N/A\\
|
|
party mode & on, off & N/A\\
|
|
scan min step & 1, 2, 3, 4, 5, 6, 8, 10, 15, 20, 25, 30, 45, 60
|
|
& s\\
|
|
seek acceleration & very fast, fast, normal, slow, very slow & N/A\\
|
|
antiskip & 5s, 15s, 30s, 1min, 2min, 3min, 5min, 10min & N/A\\
|
|
volume fade & on, off & N/A\\
|
|
sort case & on, off & N/A\\
|
|
show files & all, supported, music, playlists & N/A\\
|
|
show filename exts & off, on, unknown, view\_all & N/A\\
|
|
follow playlist & on, off & N/A\\
|
|
playlist viewer icons
|
|
& on, off & N/A\\
|
|
playlist viewer indices
|
|
& on, off & N/A\\
|
|
playlist viewer track display
|
|
& track name,full path
|
|
& N/A\\
|
|
recursive directory insert
|
|
& on, off, ask & N/A\\
|
|
scroll speed & 1 to 25 & Hz\\
|
|
scroll delay & 0 to 2500 & ms\\
|
|
scroll step & \fixme{devise a way to get ranges from config-*.h} & pixels\\
|
|
screen scroll step & \fixme{devise a way to get ranges from config-*.h} & pixels\\
|
|
Screen Scrolls Out Of View & on, off & N/A\\
|
|
bidir limit & 0 to 200 & \% screen\\
|
|
scroll paginated & on, off & N/A\\
|
|
hold\_lr\_for\_scroll\_in\_list & on, off & N/A\\
|
|
\opt{lcd_bitmap}{
|
|
show path in browser & off, current directory, full path & N/A\\
|
|
}
|
|
contrast & 0 to 63 & N/A\\
|
|
backlight timeout
|
|
& off, on, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 15, 20, 25, 30,
|
|
45, 60, 90, 120 & s\\
|
|
backlight timeout plugged
|
|
& off, on, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 15, 20, 25, 30,
|
|
45, 60, 90, 120 & s\\
|
|
backlight filters first keypress & on, off & N/A\\
|
|
backlight on button hold & normal, off, on & N/A\\
|
|
caption backlight & on, off & N/A\\
|
|
brightness & \fixme{devise a way to get ranges from config-*.h} & N/A\\
|
|
disk spindown & 3 to 254 & s\\
|
|
battery capacity & \fixme{devise a way to get ranges from config-*.h} & mAh\\
|
|
\opt{battery_types}{
|
|
battery type & alkaline, nimh & N/A\\
|
|
}
|
|
\opt{HAVE_CAR_ADAPTER_MODE}{
|
|
car adapter mode & on, off & N/A\\
|
|
}
|
|
\opt{accessory_supply}{
|
|
accessory power supply & on, off & N/A\\
|
|
}
|
|
\opt{usb_hid}{
|
|
usb hid & on, off & N/A\\
|
|
usb keypad mode
|
|
& multimedia, presentation, browser\opt{usb_hid_mouse}{, mouse}& N/A\\
|
|
}
|
|
\opt{multidrive_usb}{
|
|
usb skip first drive & on, off & N/A\\
|
|
}
|
|
|
|
idle poweroff & off, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 15, 30, 45, 60
|
|
& min\\
|
|
sleeptimer duration & 5 to 300 (in steps of 5)
|
|
& min\\
|
|
sleeptimer on startup & off, on & N/A\\
|
|
max files in playlist & 1000 - 32000 & N/A\\
|
|
max files in dir & 50 - 10000 & N/A\\
|
|
lang & /path/filename.lng & N/A\\
|
|
wps & /path/filename.wps & N/A\\
|
|
autocreate bookmarks
|
|
& off, on & N/A\\
|
|
autoload bookmarks
|
|
& off, on & N/A\\
|
|
use most-recent-bookmarks
|
|
& off, on & N/A\\
|
|
pause on headphone unplug & off, pause, pause and resume & N/A\\
|
|
rewind duration on pause & 0 to 15 & s\\
|
|
disable autoresume if phones not present & off, on & N/A\\
|
|
Last.fm Logging & off, on & N/A\\
|
|
talk dir & off, number, spell& N/A\\
|
|
talk dir clip & off, on & N/A\\
|
|
talk file & off, number, spell& N/A\\
|
|
talk file clip & off, on & N/A\\
|
|
talk filetype & off, on & N/A\\
|
|
talk menu & off, on & N/A\\
|
|
Announce Battery Level & off, on & N/A\\
|
|
\opt{hotkey}{
|
|
hotkey wps & off, view playlist, show track info,
|
|
pitchscreen, open with, delete & N/A\\
|
|
\nopt{touchscreen}{hotkey tree & off, open with, delete, insert,
|
|
insert shuffled & N/A\\}
|
|
}
|
|
sort files & alpha, oldest, newest, type & N/A\\
|
|
sort dirs & alpha, oldest, newest & N/A\\
|
|
sort interpret number & digits, numbers & N/A\\
|
|
tagcache\_autoupdate
|
|
& on, off & N/A\\
|
|
warn when erasing dynamic playlist
|
|
& on, off & N/A\\
|
|
cuesheet support
|
|
& on, off & N/A\\
|
|
folder navigation & off, on, random & N/A\\
|
|
gather runtime data & off, on & N/A\\
|
|
\opt{usb_charging_enable}{
|
|
usb charging & on, off, force & N/A\\
|
|
}
|
|
skip length & outro, track, 1s, 2s, 3s, 5s, 7s, 10s, 15s, 20s, 1min,
|
|
90s, 2min, 3min, 5min, 10min, 15min & N/A\\
|
|
prevent track skip
|
|
& on, off & N/A\\
|
|
start in screen & previous, root, files, dB, wps, menu,
|
|
\opt{recording}{recording, }
|
|
\opt{radio}{radio, }
|
|
bookmarks & N/A\\
|
|
playlist catalog directory & /path/to/dir & N/A\\
|
|
\nopt{wheel_acceleration}{
|
|
list\_accel\_start\_delay & 0 to 10 & ms\\
|
|
list\_accel\_wait & 1 to 10 & s\\
|
|
}
|
|
%
|
|
\opt{swcodec}{
|
|
replaygain type
|
|
& track, album, track shuffle, off
|
|
& N/A\\
|
|
replaygain noclip
|
|
& on, off & N/A\\
|
|
replaygain preamp
|
|
& -120 to 120 & 0.1~dB\\
|
|
%
|
|
\opt{crossfade}{
|
|
crossfade & off, auto track change, man track skip, shuffle,
|
|
shuffle or man track skip, always
|
|
& N/A\\
|
|
crossfade fade in delay
|
|
& 0 to 7 & s\\
|
|
crossfade fade out delay
|
|
& 0 to 7 & s\\
|
|
crossfade fade in duration
|
|
& 0 to 15 & s\\
|
|
crossfade fade out duration
|
|
& 0 to 15 & s\\
|
|
crossfade fade out mode
|
|
& crossfade, mix & N/A\\
|
|
}
|
|
%
|
|
crossfeed & on, off & N/A\\
|
|
crossfeed direct gain
|
|
& 0 to 60 & 0.1~dB\\
|
|
crossfeed cross gain
|
|
& 30 to 120 & 0.1~dB\\
|
|
crossfeed hf attenuation
|
|
& 60 to 240 & 0.1~dB\\
|
|
crossfeed hf cutoff
|
|
& 500 to 2000 & Hz\\
|
|
%
|
|
eq enabled & on, off & N/A\\
|
|
eq precut & 0 to 240 & 0.1~dB\\
|
|
eq band 0 cutoff & 0 to 32768 & Hz\\
|
|
eq band 1 cutoff & 0 to 32768 & Hz\\
|
|
eq band 2 cutoff & 0 to 32768 & Hz\\
|
|
eq band 3 cutoff & 0 to 32768 & Hz\\
|
|
eq band 4 cutoff & 0 to 32768 & Hz\\
|
|
eq band 0 q & 0 to 64 & N/A\\
|
|
eq band 1 q & 0 to 64 & N/A\\
|
|
eq band 2 q & 0 to 64 & N/A\\
|
|
eq band 3 q & 0 to 64 & N/A\\
|
|
eq band 4 q & 0 to 64 & N/A\\
|
|
eq band 0 gain & -240 to 240 & 0.1~dB\\
|
|
eq band 1 gain & -240 to 240 & 0.1~dB\\
|
|
eq band 2 gain & -240 to 240 & 0.1~dB\\
|
|
eq band 3 gain & -240 to 240 & 0.1~dB\\
|
|
eq band 4 gain & -240 to 240 & 0.1~dB\\
|
|
%
|
|
dithering enabled & on, off & N/A\\
|
|
%
|
|
timestretch enabled & on, off & N/A\\
|
|
%
|
|
compressor threshold & 0 to -24 & -3~dB\\
|
|
compressor makeup gain & off, auto & N/A\\
|
|
compressor ratio & 2:1, 4:1, 6:1, 10:1, limit
|
|
& N/A\\
|
|
compressor knee & hard knee, soft knee
|
|
& N/A\\
|
|
compressor release time & 100 to 1000 & 100~ms\\
|
|
%
|
|
beep & off, weak, moderate, strong & N/A\\
|
|
keyclick & off, weak, moderate, strong & N/A\\
|
|
keyclick repeats & on, off & N/A\\
|
|
dircache & on, off & N/A\\
|
|
tagcache\_ram & on, off & N/A\\
|
|
}%
|
|
|
|
\opt{masf}{
|
|
loudness & 0 to 17 & N/A\\
|
|
superbass & on, off & N/A\\
|
|
auto volume & off, 20ms, 2s, 4s, 8s
|
|
& N/A\\
|
|
mdb enable & on,off & N/A\\
|
|
mdb strength & 0 to 127 & dB\\
|
|
mdb harmonics & 0 to 100 & \%\\
|
|
mdb center & 20 to 300 & Hz\\
|
|
mdb shape & 50 to 300 & Hz\\
|
|
}%
|
|
|
|
\opt{lcd_bitmap}{
|
|
peak meter release
|
|
& 1 to 126 & ?\\
|
|
peak meter hold
|
|
& off, 200ms, 300ms, 500ms, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10,
|
|
15, 20, 30, 1min & N/A \\
|
|
peak meter clip hold
|
|
& on, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 15, 20, 25, 30, 45,
|
|
60, 90, 2min, 3min, 5min, 10min, 20min, 45min, 90min
|
|
& N/A \\
|
|
peak meter busy & on, off & N/A\\
|
|
peak meter dbfs & on, off & on:~dbfs, off:~linear\\
|
|
peak meter min & 0 to 89 (dB) or 0 to 100 (\%)
|
|
& dB or \%\\
|
|
peak meter max & 0 to 89 /(dB) or 0 to 100 (\%)
|
|
& dB or \%\\
|
|
statusbar & off, top, bottom & N/A\\
|
|
\opt{remote}{
|
|
remote statusbar & off, top, bottom & N/A\\
|
|
}
|
|
scrollbar & off, left, right & N/A\\
|
|
scrollbar width & 3 to LCD width / 10 (\fixme{devise a way
|
|
to get ranges from config-*.h})& pixels\\
|
|
volume display
|
|
& graphic, numeric & N/A\\
|
|
battery display
|
|
& graphic, numeric & N/A\\
|
|
font & /path/filename.fnt & N/A\\
|
|
kbd & /path/filename.kbd & N/A\\
|
|
\opt{lcd_invert}{
|
|
invert & on, off & N/A\\
|
|
}
|
|
\opt{lcd_flip}{
|
|
flip display & on, off & N/A\\
|
|
}
|
|
selector type & pointer, bar (inverse)
|
|
\opt{lcd_color}{, bar (color), bar (gradient)} & N/A\\
|
|
show icons & on, off & N/A\\
|
|
iconset & /path/filename.bmp & N/A\\
|
|
viewers iconset & /path/filename.bmp & N/A\\
|
|
}%
|
|
|
|
\opt{swcodec}{% This doesn't depend on swcodec but using a \nopt here
|
|
% causes ondiosp not to build for mysterious reasons.
|
|
backdrop & /path/filename.bmp & N/A\\
|
|
}%
|
|
|
|
\opt{lcd_color}{
|
|
foreground colour & 000000 to FFFFFF & RRGGBB\\
|
|
background colour & 000000 to FFFFFF & RRGGBB\\
|
|
line selector start colour & 000000 to FFFFFF & RRGGBB\\
|
|
line selector end colour & 000000 to FFFFFF & RRGGBB\\
|
|
line selector text colour & 000000 to FFFFFF & RRGGBB\\
|
|
filetype colours & /path/filename.colours & N/A\\
|
|
}
|
|
|
|
\opt{HAVE_REMOTE_LCD}{
|
|
rwps & /path/filename.rwps & N/A\\
|
|
remote contrast
|
|
& 5 to 63 & N/A\\
|
|
remote invert
|
|
& on, off & N/A\\
|
|
remote flip display
|
|
& on, off & N/A\\
|
|
remote backlight timeout
|
|
& off, on, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 15, 20, 25,
|
|
30, 45, 60, 90 & s\\
|
|
remote backlight timeout plugged
|
|
& off, on, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 15, 20, 25,
|
|
30, 45, 60, 90 & s\\
|
|
remote caption backlight
|
|
& on, off & N/A\\
|
|
remote scroll speed
|
|
& 0 to 15 & N/A\\
|
|
remote scroll step
|
|
& 1 to 160 & N/A\\
|
|
remote scroll delay
|
|
& 0 to 2500 & ms\\
|
|
remote bidir limit
|
|
& 0 to 200 & N/A\\
|
|
backlight filters first remote keypress
|
|
& on, off & N/A\\
|
|
remote iconset & /path/filename.bmp & N/A\\
|
|
remote viewers iconset & /path/filename.bmp & N/A\\
|
|
\opt{iriverh100,iriverh300}{
|
|
remote reduce ticking
|
|
& on, off & N/A\\
|
|
}%
|
|
}
|
|
\opt{rtc}{
|
|
time format & 12hour, 24hour & N/A\\
|
|
}%
|
|
\opt{recording}{
|
|
rec quality & 0 to 7 & 0: small size, 7: high quality\\
|
|
rec frequency
|
|
& 48, 44, 32, 24, 22, 16 & kHz\\
|
|
rec source & mic, line, spdif & N/A\\
|
|
rec channels & mono, stereo & N/A\\
|
|
rec mic gain & 0 to 15 & N/A\\
|
|
rec left gain & 0 to 15 & N/A\\
|
|
rec right gain
|
|
& 0 to 15 & N/A\\
|
|
editable recordings
|
|
& off,on & N/A\\
|
|
rec timesplit
|
|
& off, 0:05, 0:10, 0:15, 0:30, 1:00, 2:00, 4:00, 6:00,
|
|
8:00, 16:00, 24:00 & h:mm\\
|
|
pre-recording time
|
|
& off, 1 to 30 & s\\
|
|
rec directory & /path/to/dir & N/A\\
|
|
}%
|
|
\opt{spdif_power}{
|
|
spdif enable & off, on & N/A\\
|
|
}%
|
|
\opt{radio}{
|
|
force fm mono
|
|
& off, on & N/A\\
|
|
}%
|
|
\opt{player}{
|
|
jump scroll
|
|
& 0 to 5 & N/A\\
|
|
jump scroll delay
|
|
& 0 to 250 & 0.01~s\\
|
|
}%
|
|
|
|
\bottomrule
|
|
\end{longtable}
|
|
\end{center}
|