[Feature] playback logging from core

people don't like having to remember to run the TSR plugin so
lets meet them halfway

all tracks are added with timestamp, elapsed, length, trackname

added buffering for ATA devices

still needed:
-Done -- a plugin that parses for duplicates and reads the track info
to create the actual scrobbler log
(log can be truncated once dumped)
this should allow you to run the plugin at leisure

later I'd like to expand this logging to allow
track culling based on skipped songs..

remove the TSR plugin as hard disk no longer need to use it

Change-Id: Ib0b74b4c868fecb3e4941a8f4b9de7bd8728fe3e

manual/configure_rockbox/playback_options.tex

@@ -325,3 +325,15 @@ you to configure settings related to audio playback.
     \setting{Prefer Image File}. The default behavior is to
     \setting{Prefer Embedded} album art.
 }
+
+\section{Logging}\index{Logging}
+  This option will record information about tracks played on the device
+  in the following format 'timestamp:elapsed(ms):length(ms):path'
+  Devices without a Real Time Clock will use current system tick.
+  Tracks played for a very short duration < 1 second will not be recorded
+  to minimize disk access while skipping quickly through songs.
+  You should periodically delete this log as excessive file sizes may cause
+  decreased device performace see \setting{LastFm Scrobbler} plugin.
+\begin{verbatim}
+  the log can be found under '/.rockbox/playback.log'
+\end{verbatim}

manual/plugins/lastfm_scrobbler.tex

@@ -0,0 +1,53 @@
+\subsection{LastFm Scrobbler}
+The \setting{LastFm Scrobbler} plugin enables you to parse the rockbox
+playback log for tracks you have played for your own logging or upload
+to scrobbling services, such as Last.fm, Libre.fm or ListenBrainz.
+
+\setting{Playback Logging} must be enabled to record the tracks played
+the plugin will ask you to enable logging if run with logging disabled.
+
+\subsubsection{Menu}
+\begin{itemize}
+\item Remove duplicates - Only keeps the same track with the most time elapsed.
+\item Delete playback log - Remove the current playback log once it has been read.
+\item Save threshold - Percentage of track played to be considered 'L'istened.
+\item Minimum elapsed (ms) - Tracks played less than this will not be recorded in log.
+\item View log - View the current playback log.
+\item Revert to Default - Default settings restored.
+\item Cancel - Exit, you will be asked to save any changes
+\item Export - Append scrobbler log and save any changes, not visible if no playback log exists.
+\end{itemize}
+
+After the plugin has exported the scrobbler log you can find it in the root
+of the drive '.scrobbler.log' open it in the file browser to view the log.
+
+Subsequent exports will be appended to .scrobbler.log thus Delete playback log is advised.
+
+\begin{verbatim}
+A copy of the log can be found in
+'/rockbox/playback.old'
+it will be overwritten with each export
+\end{verbatim}
+
+\subsubsection{Format}
+Data will be saved in Audioscrobbler spec at: (use wayback machine).
+\url{http://www.audioscrobbler.net/wiki/Portable_Player_Logging}.
+
+\begin{verbatim}
+The scrobbler format consists of the following data items
+tab '\t' separated followed by newline '\n'
+\end{verbatim}
+
+\begin{itemize}
+\item ARTIST
+\item ALBUM
+\item TITLE
+\item TRACKNUM
+\item LENGTH
+\item RATING
+\item TIMESTAMP
+\item MUSICBRAINZ-TRACKID
+\end{itemize}
+
+If track info is not available (due to missing file or format limitations)
+the track path will be used instead.

manual/plugins/main.tex

@@ -263,6 +263,8 @@ option from the \setting{Context Menu} (see \reference{ref:Contextmenu}).}
 
 \opt{HAVE_BACKLIGHT}{\input{plugins/lamp.tex}}
 
+\input{plugins/lastfm_scrobbler.tex}
+
 \input{plugins/lrcplayer.tex}
 
 \input{plugins/main_menu_config.tex}