manual/appendix/config_file_options.tex

   1 % $Id$ %
   2 \chapter{\label{ref:config_file_options}Config file options}
   3 \begin{center}
   4 % define a local version of endhead, as using the output distinction adds
   5 % an unwanted newline. endhead breaks with htlatex so we need to remove it
   6 % for the html output.
   7 \ifpdfoutput{\newcommand{\localendhead}{\endhead}}%
   8     {\newcommand{\localendhead}{}}
   9   \begin{longtable}{@{}>{\raggedright}p{.35\textwidth}@{}>{\raggedright}p{.4\textwidth}@{}p{.25\textwidth}@{}}
  10     \toprule
  11     \textbf{Setting} & \textbf{Allowed Values} & \textbf{Unit}\\
  12     \midrule\localendhead % endhead breaks with htlatex
  13     volume      & \opt{player}{-78 to +18}%
  14                   \opt{recorder,recorderv2fm,ondiosp,ondiofm}{-100 -to +12}%
  15                   \opt{h100,h300}{-84 to 0}%
  16                   \opt{ipodnano}{-72 to +6}%
  17                   \opt{ipodvideo}{-57 to +6}%
  18                   \opt{x5}{-73 to +6}
  19                   \opt{e200}{-74 to +6}
  20                   \opt{ipodcolor}{-\fixme{??} to +\fixme{??}}%
  21                                         & dB\\
  22     \nopt{x5}{%
  23       bass      & \opt{MASCODEC}{-15 to +15}%
  24                   \opt{h100,h300}{0 to +24}%
  25                   \opt{ipod}{-6 to +9}%
  26                   \opt{e200}{-24 to +24}%
  27                                         & dB\\
  28       treble    & \opt{MASCODEC}{-15 to +15}%
  29                   \opt{h100,h300}{0 to +6}%
  30                   \opt{ipod}{-6 to +9}%
  31                   \opt{e200}{-24 to +24}%
  32                                         & dB\\
  33     }%
  34     balance         & -100 to +100      & \%\\
  35     channels        & stereo, mono, custom, mono left, mono right, karaoke
  36                                         & N/A\\
  37     stereo\_width   & 0 to 250          & \%\\
  38     shuffle         & on, off               & N/A\\
  39     repeat          & off, all, one, shuffle, ab
  40                                         & N/A\\
  41     play selected   & on, off           & N/A\\
  42     party mode      & on, off           & N/A\\
  43     scan min step   & 1, 2, 3, 4, 5, 6, 8, 10, 15, 20, 25, 30, 45, 60
  44                                         & seconds\\
  45     seek acceleration & very fast, fast, normal, slow, very slow & N/A\\
  46     antiskip        & 5s, 15s, 30s, 1min, 2min, 3min, 5min, 10min & N/A\\
  47     volume fade     & on, off           & N/A\\
  48     id3 tag priority & v2-v1, v1-v2     & N/A\\
  49     sort case       & on, off           & N/A\\
  50     show files      & all, supported, music, playlists & N/A\\
  51     show filename exts & off, on, unknown, view\_all & N/A\\
  52     follow playlist & on, off           & N/A\\
  53     playlist viewer icons
  54                     & on, off           & N/A\\
  55     playlist viewer indices
  56                     & on, off           & N/A\\
  57     playlist viewer track display
  58                     & track name,full path
  59                                         & N/A\\
  60     recursive directory insert
  61                     & on, off, ask      & N/A\\
  62     scroll speed    & 1 to 25           & Hz\\
  63     scroll delay    & 0 to 2500         & ms\\
  64     scroll step     & \fixme{device a way to get ranges from config-*.h} & pixels\\
  65     screen scroll step & \fixme{device a way to get ranges from config-*.h} & pixels\\
  66     Screen Scrolls Out Of View & on, off & N/A\\
  67     bidir limit     & 0 to 200          & \% screen\\
  68     scroll paginated & on, off & N/A\\
  69     hold\_lr\_for\_scroll\_in\_list & on, off & N/A\\
  70     \opt{lcd_bitmap}{
  71       show path in browser & off, current directory, full path & N/A\\
  72     }
  73     contrast        & 0 to 63           & N/A\\
  74     backlight timeout
  75                     & off, on, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 15, 20, 25, 30,
  76                       45, 60, 90, 120        & seconds\\
  77     backlight timeout plugged
  78                     & off, on, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 15, 20, 25, 30,
  79                       45, 60, 90, 120        & seconds\\
  80     backlight filters first keypress & on, off & N/A\\
  81     backlight on button hold & normal, off, on & N/A\\
  82     caption backlight & on, off & N/A\\
  83     brightness      & \fixme{device a way to get ranges from config-*.h} & N/A\\
  84     disk spindown   & 3 to 254          & seconds\\
  85     battery capacity & \fixme{device a way to get ranges from config-*.h} & mAh\\
  86     \opt{battery_types}{
  87       battery type  & alkaline, nimh    & N/A\\
  88     }
  89     \opt{HAVE_CAR_ADAPTER_MODE}{
  90       car adapter mode & on, off & N/A\\
  91     }
  92     idle poweroff   & off, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 15, 30, 45, 60
  93                                         & minutes\\
  94     max files in playlist & 1000 - 32000 & N/A\\
  95     max files in dir & 50 - 10000       & N/A\\
  96     lang            & /path/filename.lng & N/A\\
  97     wps             & /path/filename.wps & N/A\\
  98     autocreate bookmarks
  99                     & off, on           & N/A\\
 100     autoload bookmarks
 101                     & off, on           & N/A\\
 102     use most-recent-bookmarks
 103                     & off, on           & N/A\\
 104     pause on headphone unplug & off, pause, pause and resume & N/A\\
 105     rewind duration on pause & 0 to 15  & seconds\\
 106     disable autoresume if phones not present & off, on & N/A\\
 107     Last.fm Logging & off, on           & N/A\\
 108     talk dir        & off, number, spell& N/A\\
 109     talk dir clip   & off, on           & N/A\\
 110     talk file       & off, number, spell& N/A\\
 111     talk file clip  & off, on           & N/A\\
 112     talk filetype   & off, on           & N/A\\
 113     talk menu       & off, on           & N/A\\
 114     Announce Battery Level & off, on    & N/A\\
 115     sort files      & alpha, oldest, newest, type & N/A\\
 116     sort dirs       & alpha, oldest, newest & N/A\\
 117     tagcache\_autoupdate
 118                     & on, off           & N/A\\
 119     warn when erasing dynamic playlist
 120                     & on, off           & N/A\\
 121     cuesheet support
 122                     & on, off           & N/A\\
 123     folder navigation & off, on, random & N/A\\
 124     gather runtime data & off, on       & N/A\\
 125     \opt{usb_charging}{
 126       usb charging  & on, off           & N/A\\
 127     }
 128     skip length     & track, 1, 2, 3, 4, 5, 10, 15 & minutes\\
 129     start in screen & previous, root, files, db, wps, menu,
 130       \opt{recording}{recording, }
 131       \opt{radio}{radio, }
 132       bookmarks                         & N/A\\
 133     playlist catalog directory & /path/to/dir & N/A\\
 134     \opt{scrollwheel}{
 135       list\_accel\_start\_delay & 0 to 10  & ms\\
 136       list\_accel\_wait        & 1 to 10  & seconds\\
 137     }
 138 %
 139     \opt{swcodec}{
 140       replaygain    & on, off           & N/A\\
 141       replaygain type
 142                     & track, album, track shuffle
 143                                         & N/A\\
 144       replaygain noclip
 145                     & on, off           & N/A\\
 146       replaygain preamp
 147                     & -120 to 120       & 0.1dB\\
 148 %
 149       crossfade     & off, shuffle, track skip, always
 150                                         & N/A\\
 151       crossfade fade in delay
 152                     & 0 to 7            & seconds\\
 153       crossfade fade out delay
 154                     & 0 to 7            & seconds\\
 155       crossfade fade in duration
 156                     & 0 to 15           & seconds\\
 157       crossfade fade out duration
 158                     & 0 to 15           & seconds\\
 159       crossfade fade out mode
 160                     & crossfade, mix    & N/A\\
 161 %
 162       crossfeed     & on, off           & N/A\\
 163       crossfeed direct gain
 164                     & 0 to 60           & 0.1dB\\
 165       crossfeed cross gain
 166                     & 30 to 120         & 0.1dB\\
 167       crossfeed hf attenuation
 168                     & 60 to 240         & 0.1dB\\
 169       crossfeed hf cutoff
 170                     & 500 to 2000       & Hz\\
 171 %
 172       eq enabled    & on, off           & N/A\\
 173       eq precut     & 0 to 240          & 0.1dB\\
 174       eq band 0 cutoff & 0 to 32768     & Hz\\
 175       eq band 1 cutoff & 0 to 32768     & Hz\\
 176       eq band 2 cutoff & 0 to 32768     & Hz\\
 177       eq band 3 cutoff & 0 to 32768     & Hz\\
 178       eq band 4 cutoff & 0 to 32768     & Hz\\
 179       eq band 0 q   & 0 to 64           & N/A\\
 180       eq band 1 q   & 0 to 64           & N/A\\
 181       eq band 2 q   & 0 to 64           & N/A\\
 182       eq band 3 q   & 0 to 64           & N/A\\
 183       eq band 4 q   & 0 to 64           & N/A\\
 184       eq band 0 gain & -240 to 240      & 0.1dB\\
 185       eq band 1 gain & -240 to 240      & 0.1dB\\
 186       eq band 2 gain & -240 to 240      & 0.1dB\\
 187       eq band 3 gain & -240 to 240      & 0.1dB\\
 188       eq band 4 gain & -240 to 240      & 0.1dB\\
 189 %
 190       dithering enabled & on, off       & N/A\\
 191       beep          & off, weak, moderate, strong & N/A\\
 192       keyclick      & off, weak, moderate, strong & N/A\\
 193       keyclick repeats & on, off        & N/A\\
 194       dircache      & on, off           & N/A\\
 195       tagcache\_ram & on, off           & N/A\\
 196     }%
 197
 198     \opt{recorder,recorderv2fm}{
 199       loudness      & 0 to 17           & N/A\\
 200       superbass     & on, off           & N/A\\
 201       auto volume   & off, 20ms, 2s, 4s, 8s
 202                                         & seconds\\
 203       mdb enable    & on,off            & N/A\\
 204       mdb strength  & 0 to 127          & dB\\
 205       mdb harmonics & 0 to 100          & \%\\
 206       mdb center    & 20 to 300         & Hz\\
 207       mdb shape     & 50 to 300         & Hz\\
 208     }%
 209
 210     \opt{lcd_bitmap}{
 211       peak meter release
 212                     & 1 to 126          & ?\\
 213       peak meter hold
 214                     & off, 200ms, 300ms, 500ms, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10,
 215                       15, 20, 30, 1min  & N/A \\
 216       peak meter clip hold
 217                     & on, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 15, 20, 25, 30, 45,
 218                       60, 90, 2min, 3min, 5min, 10min, 20min, 45min, 90min
 219                                         & N/A \\
 220       peak meter busy & on, off         & N/A\\
 221       peak meter dbfs & on, off         & on:~dbfs, off:~linear\\
 222       peak meter min  & 0 to 89 (dB) or 0 to 100 (\%)
 223                                         & dB or \%\\
 224       peak meter max  & 0 to 89 /(dB) or 0 to 100 (\%)
 225                                         & dB or \%\\
 226       statusbar     & on, off           & N/A\\
 227       scrollbar     & on, off           & N/A\\
 228       volume display
 229                     & graphic, numeric  & N/A\\
 230       battery display
 231                     & graphic, numeric  & N/A\\
 232       font          & /path/filename.fnt & N/A\\
 233       kbd           & /path/filename.kbd & N/A\\
 234       \opt{lcd_invert}{
 235         invert        & on, off           & N/A\\
 236       }
 237       \opt{lcd_flip}{
 238         flip display  & on, off           & N/A\\
 239       }
 240       selector type   & pointer, bar (inverse)
 241         \opt{lcd_color}{, bar (color), bar (gradient)} & N/A\\
 242       show icons    & on, off           & N/A\\
 243       iconset       & /path/filename.bmp & N/A\\
 244       viewers iconset & /path/filename.bmp & N/A\\
 245     }%
 246
 247     \opt{swcodec}{% This doesn't depend on swcodec but using a \nopt here
 248                   % causes ondiosp not to build for mysterious reasons.
 249       backdrop      & /path/filename.bmp    & N/A\\
 250     }%
 251
 252     \opt{lcd_color}{
 253       foreground colour & 000000 to FFFFFF   & RRGGBB\\
 254       background colour & 000000 to FFFFFF   & RRGGBB\\
 255       line selector start colour & 000000 to FFFFFF  & RRGGBB\\
 256       line selector end colour   & 000000 to FFFFFF  & RRGGBB\\
 257       line selector text colour  & 000000 to FFFFFF  & RRGGBB\\
 258       filetype colours & /path/filename.colours & N/A\\
 259     }
 260
 261     \opt{HAVE_REMOTE_LCD}{
 262       rwps      & /path/filename.rwps   & N/A\\
 263       remote contrast
 264                 & 5 to 63               & N/A\\
 265       remote invert
 266                 & on, off               & N/A\\
 267       remote flip display
 268                 & on, off               & N/A\\
 269       remote backlight timeout
 270                 & off, on, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 15, 20, 25,
 271                   30, 45, 60, 90        & seconds\\
 272       remote backlight timeout plugged
 273                 & off, on, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 15, 20, 25,
 274                   30, 45, 60, 90        & seconds\\
 275       remote caption backlight
 276                 & on, off               & N/A\\
 277       remote scroll speed
 278                 & 0 to 15               & N/A\\
 279       remote scroll step
 280                 & 1 to 160              & N/A\\
 281       remote scroll delay
 282                 & 0 to 2500             & ms\\
 283       remote bidir limit
 284                 & 0 to 200              & N/A\\
 285       backlight filters first remote keypress
 286                 & on, off               & N/A\\
 287       remote iconset & /path/filename.bmp & N/A\\
 288       remote viewers iconset & /path/filename.bmp & N/A\\
 289       \opt{h100,h300}{
 290         remote reduce ticking
 291                 & on, off               & N/A\\
 292       }%
 293     }
 294     \opt{rtc}{
 295       time format & 12hour, 24hour      & N/A\\
 296     }%
 297     \opt{recording}{
 298      rec quality & 0 to 7               & 0: small size, 7: high quality\\
 299      rec frequency
 300                 & 48, 44, 32, 24, 22, 16 & kHz\\
 301      rec source & mic, line, spdif      & N/A\\
 302      rec channels & mono, stereo        & N/A\\
 303      rec mic gain & 0 to 15             & N/A\\
 304      rec left gain & 0 to 15            & N/A\\
 305      rec right gain
 306                 & 0 to 15               & N/A\\
 307      editable recordings
 308                 & off,on                & N/A\\
 309      rec timesplit
 310                 & off, 0:05, 0:10, 0:15, 0:30, 1:00, 2:00, 4:00, 6:00,
 311                   8:00, 16:00, 24:00    & h:mm\\
 312      pre-recording time
 313                 & off, 1 to 30          & seconds\\
 314      rec directory & /path/to/dir       & N/A\\
 315     }%
 316     \opt{spdif_power}{
 317       spdif enable & off, on            & N/A\\
 318     }%
 319     \opt{radio}{
 320       force fm mono
 321                 & off, on               & N/A\\
 322     }%
 323     \opt{player}{
 324       jump scroll
 325                 & 0 to 5                & N/A\\
 326       jump scroll delay
 327                 & 0 to 250              & 0.01s\\
 328     }%
 329
 330     \bottomrule
 331   \end{longtable}
 332 \end{center}