% $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}{}}
  \begin{longtable}{@{}>{\raggedright}p{.35\textwidth}@{}>{\raggedright}p{.4\textwidth}@{}p{.25\textwidth}@{}}
    \toprule
    \textbf{Setting} & \textbf{Allowed Values} & \textbf{Unit}\\
    \midrule\localendhead % endhead breaks with htlatex
    volume      & \opt{player}{-78 to +18}%
                  \opt{recorder,recorderv2fm,ondiosp,ondiofm}{-100 -to +12}%
                  \opt{h1xx,h300}{-84 to 0}%
                  \opt{ipodnano}{-72 to +6}%
                  \opt{ipodvideo}{-57 to +6}%
                  \opt{x5}{-73 to +6}
                  \opt{ipodcolor}{-\fixme{??} to +\fixme{??}}%
                                        & dB\\
    \nopt{x5}{%
      bass      & \opt{MASCODEC}{-15 to +15}%
                  \opt{h1xx,h300}{0 to +24}%
                  \opt{ipod}{-6 to +9}%
                                        & dB\\
      treble    & \opt{MASCODEC}{-15 to +15}%
                  \opt{h1xx,h300}{0 to +6}%
                  \opt{ipod}{-6 to +9}%
                                        & dB\\
    }%
    balance         & -100 to +100      & \%\\
    channels        & stereo, mono, custom, mono left, mono right, karaoke
                                        & N/A\\
    shuffle         & on, off               & N/A\\
    repeat          & off, all, one, shuffle, ab
                                        & N/A\\
    play selected   & on, off           & N/A\\
    resume          & on, off           & N/A\\
    scan min step   & 1, 2, 3, 4, 5, 6, 8, 10, 15, 20, 25, 30, 45, 60
                                        & seconds\\
    scan accel      & 0 to 15           & seconds\\
    antiskip        & 0 to 7            & seconds\\
    volume fade     & on, off           & N/A\\
    id3 tag priority & v2-v1, v1-v2     & N/A\\
    sort case       & on, off           & N/A\\
    show files  & all, supported, music, playlists
                                        & 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           & N/A\\
    scroll speed    & 1 to 25           & Hz\\
    scroll delay    & 0 to 250          & 1/10s\\
    scroll step     & 1 to 112          & pixels\\
    bidir limit     & 0 to 200          & \% screen\\
    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        & seconds\\
    backlight timeout plugged
                    & off, on, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 15, 20, 25, 30,
                      45, 60, 90        & seconds\\
    disk spindown   & 3 to 254          & seconds\\
    battery capacity
                    & 1500 - 3200      & mAh\\
    idle poweroff   & off, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 15, 30, 45, 60
                                        & minutes\\
    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\\
    talk dir        & off, number, spell, enter, hover
                                        & N/A\\
    talk file       & off, number, spell& N/A\\
    talk menu       & off, on           & N/A\\
    tagcache\_autoupdate
                    & on, off           & N/A\\
    warn when erasing dynamic playlist
                    & on, off           & N/A\\
    cuesheet support
                    & on, off           & N/A\\
%
    \opt{SWCODEC}{
      replaygain    & on, off           & N/A\\
      replaygain type
                    & track, album, track shuffle
                                        & N/A\\
      replaygain noclip
                    & on, off           & N/A\\
      replaygain preamp
                    & -120 to 120       & 0.1dB\\
%
      crossfade     & off, shuffle, track skip, always
                                        & N/A\\
      crossfade fade in delay
                    & 0 to 7            & seconds\\
      crossfade fade out delay
                    & 0 to 7            & seconds\\
      crossfade fade in duration
                    & 0 to 15           & seconds\\
      crossfade fade out duration
                    & 0 to 15           & seconds\\
      crossfade fade out mode
                    & crossfade, mix    & N/A\\
%
      crossfeed     & on, off           & N/A\\
      crossfeed direct gain
                    & 0 to 60           & 0.1dB\\
      crossfeed cross gain
                    & 30 to 120         & 0.1dB\\
      crossfeed hf attenuation
                    & 60 to 240         & 0.1dB\\
      crossfeed hf cutoff
                    & 500 to 2000       & Hz\\
%
      eq enabled    & on, off           & N/A\\
      eq precut     & 0 to 240          & 0.1dB\\
      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.1dB\\
      eq band 1 gain & -240 to 240      & 0.1dB\\
      eq band 2 gain & -240 to 240      & 0.1dB\\
      eq band 3 gain & -240 to 240      & 0.1dB\\
      eq band 4 gain & -240 to 240      & 0.1dB\\
%
      beep          & off, weak, moderate, strong
                                        & N/A\\
      dircache      & on, off           & N/A\\
      tagcache\_ram & on, off           & N/A\\
    }%

    \opt{recorder,recorderv2fm}{
      loudness      & 0 to 17           & N/A\\
      superbass     & on, off           & N/A\\
      auto volume   & off, 20ms, 2s, 4s, 8s
                                        & seconds\\
      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{HAVE_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     & on, off           & N/A\\
      scrollbar     & on, off           & N/A\\
      volume display
                    & graphic, numeric  & N/A\\
      battery display
                    & graphic, numeric  & N/A\\
      font          & /path/filename.fnt & N/A\\
      invert        & on, off           & 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{HAVE_LCD_COLOR}{
      foreground color & 000000 to FFFFFF   & RRGGBB\\
      background color & 000000 to FFFFFF   & RRGGBB\\
    }

    \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        & seconds\\
      remote backlight timeout plugged
                & off, on, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 15, 20, 25,
                  30, 45, 60, 90        & seconds\\
      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 250              & N/A\\ 
      remote bidir limit
                & 0 to 200              & N/A\\
      backlight filters first remote keypress
                & on, off               & N/A\\
      \opt{h1xx,h300}{
        remote reduce ticking
                & on, off               & N/A\\
      }%
    }
    \opt{CONFIG_RTC}{
      time format & 12hour, 24hour      & N/A\\
    }%
    \opt{HAVE_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          & seconds\\
     rec directory
                & /recordings,current   & N/A\\
    }%
    \opt{CONFIG_TUNER}{
      force fm mono
                & off, on               & N/A\\
    }%
    \opt{player}{
      jump scroll
                & 0 to 5                & N/A\\
      jump scroll delay
                & 0 to 250              & 0.01s\\
    }%

    \bottomrule
  \end{longtable}
\end{center}
