############################################################################
# Technovision MP3sa -  Example configuration file.
#
# General notes:
# - Comments start with # and go to the end of line. 
# - Blank lines are ignored.
# - Commands/variables are case insensitive.
#
# For additional information contact Technovision at (905) 420 - 5153
#
# Sales...............sales@technovision.com
# Technical support...support@technovision.com
# Service.............service@technovision.com
#
############################################################################

############################################################################
#SYSTEM VARIABLES:
#---------------------------------------------------------------------------
# Here you can set the system variables to their initial values. If there
# is no key mapped to change these values, then they will not change
# from these initial values. For example, to fix volume at 50%, set
# the default to 50 and then omit the volume-up and volume-down commands.
# 
# Initial values that are omitted are given their default value.
############################################################################

#***************************************************************************
# Output volume:
#
# This is the initial start-up value (0..100%). The vol+ and vol-
# keys (if enabled) will adjust the volume from this value. 
# Default = minvol (see below)
#---------------------------------------------------------------------------
volume = 100
#***************************************************************************

#***************************************************************************
# Volume Min & Max:
#
# This is the definition of the upper and lower limits of the volume.
# Default value for minvol = 0
# Default value for maxvol = 100
#---------------------------------------------------------------------------
minvol = 0
maxvol = 100
#***************************************************************************

#***************************************************************************
# Fade Time:
#
# This causes the volume to fade up from a mute condition to either the
# default volume level or the user selected volume level after the specified
# number of milliseconds (1000mS = 1 Second). 
#
# This command is important since the system audio is muted on each search.
# Default = 0
#---------------------------------------------------------------------------
fadetime = 500
#***************************************************************************

#***************************************************************************
# Repeat/Continue mode. Legal values are:
#	0	= Repeat off - stops at the end of each song.
#	1	= play all songs once and stop at the end of the last song
#	2	= repeat all; always play next song, and wrap around at end
#	3	= repeat one; keep playing the same song over, and over.
#	4	= repeat disc: keep playing within the same virtual CD
# Default = 0
#---------------------------------------------------------------------------
repeat = 2
#***************************************************************************

#***************************************************************************
# Autostart. On system reset, should we start playing something (1=yes)
# Default = 0
#---------------------------------------------------------------------------
autostart = 1
#***************************************************************************

#***************************************************************************
# Idle. When there is no activity from a user (i.e.: no button presses) the
# system will go into a STOP mode after this number of seconds. If it is
# defined as idle = 0 then this feature is disabled.
#
# Default = 0, maximum value is 10000
#---------------------------------------------------------------------------
idle = 0		# (s) how long after last keypress before stopping
#***************************************************************************

#***************************************************************************
# Disc Lock.
#
# If set to 1, then this flag will force next/prev track to stay within
# the same virtual disc. To get to the next disc, you must use
# "disc+" action. If you just want it to repeat within the disk, see repeat
# mode 4 above.
#
# "Disc mode" is enabled whenever your MP3 filenames have 4 numeric
# digits at the start of their name. The first two digits are the disk
# number, and the other 2 digits are the track number. Filenames that aren't
# in the right format will be put into disc zero. Examples:
#
#	0101.mp3		// disc one (first), track one (first)
#	0105.mp3		// disc one (first), track 5
#	1020.mp3		// disc ten, track 20.
#
# The disc numbers are used verbatim, so if you object to having a "disc zero"
# then start counting at one. The track number can be shown to user, see above.
# Default = 0
#---------------------------------------------------------------------------
disclock = 0
#***************************************************************************

#***************************************************************************
# Option attraction song. If defined (and non-zero) then this value specifies
# a disc and track to play to attract attention. Whenever the unit is powered
# on, it will play this song over and over. If a key is pressed, then the
# selected song is played. Once the song ends, the attract song is played
# continuously. If "idle" is defined, then it must be longer than the longest
# song on the system, otherwise playback will be interrupted.
#
# First two digits is the disc number, second two digits is the track number.
#
# attract = 0103 	# disc 1, track 3
# Default = 0000
#---------------------------------------------------------------------------
attract = 0000		# disable
#***************************************************************************

#***************************************************************************
# Screen layout. 4 lines x 20 characters per line
#---------------------------------------------------------------------------
# What to draw where, on the screen. The lines of the screen are numbered from
# top to bottom (1 to 4). Each line is completely independent of the others.
# A typical application will have status information on the top line (line1)
# and song information (title, track, artist, etc) on the other lines. However,
# this display is completely free-form. 
#
# Each line is defined as a string to display. The dollar sign character
# introduces an escape sequence of program-supplied information. Other
# characters are passed without changes. Use a double $ to get a single 
# dollar sign. 
#
# Immediately after the dollar sign, a number may be used to specify a set
# number of characters (right justified) that the data will occupy. 
# If the width is negative, the data will be left justified. 
#
# Here is the list of all codes:
#
#     Code	Meaning             	Width:	Min   Max	Example text
#     ----	-----------------		---   ---	--------------
#	T	ID3 Title			0	?	Thriller
#	A	ID3 Artist			0	?	Michael Jackson
#	C	ID3 Comment			0	?	Classic from 80's
#	G	ID3 Genre			0	?	Pop
#	S	Song number of track		1	3	23
#	F	Filename			5	12	0101.MP3
#	H	Sample rate			7	7	44100Hz
#	B	Bit rate			9	10	160kbits/s
#	K	Show which key is pressed	2	2	34 (key 34)
#	d	Disc number			1	2	2
#	t	Track number			1	2	1
#	s	Song number (playing now)	1	3	23
#	r	Repeat mode (graphics)		3	3	R->,R-*,R-0,R-D,R-T
#	R	Repeat mode (text)		2	2	R4
#	p	Transport (graphical)		1	1	> (graphics symbols)
#	P	Transport (text)		5	5	PAUSE,STOP,PLAY
#	x	Current time in song		5	5	01:59
#	v	Volume (as bar graph)		6	6	]|||  [ (bargraph)
#	V	Text volume (100% or MUTE)	4	4	50%
#---------------------------------------------------------------------------
#				 LCD DISPLAY (20 characters)
#				 12345678901234567890
# Examples:        		 ....................
# "$-12T $p $x"   ->		"Title of Tra > 00:12"
# "$T $p $x"      ->      	"Title of Track > 00:" (cut off)
# "$10T $p$p  $x" ->      	"     title >>  00:12" (title right justified)
#
# Default is a blank line
#---------------------------------------------------------------------------
line1 = "$-5P   $x   $V"
line2 = "$T"
line3 = "$A"
line4 = "Disc: $2d   Track: $2t"
#***************************************************************************

#***************************************************************************
# Operation Mode
#
# 0 = 	Normal mode; press a button for a song
# 1 = 	Browse mode; lists 3 songs at a time on lines 2, 3 & 4. The
#	top line is can be used for other information. 
#	Use the browse keys to browse up, down, and select choice.
#	brup		- browse up list
#	brdn		- browse down list
#	brsel		- browse select (choose this song to play)
#
# For browse mode, the display will show three versions of the line2 text.
# If line2 is defined as showing the title information ($T) then the PREVIOUS,
# CURRENT and NEXT titles will be shown. This is illustrated below:
#
#	|--------------------|
#	|PLAY   00:26  ]||| [|
#	|  Previous Title    |
#	|->Current Title     |
#	|  Next Title        |
#	|--------------------|
#
# Default = 0
#---------------------------------------------------------------------------
mode = 0
#***************************************************************************

#***************************************************************************
# Keyboard/switch control functions
#
# (ms) = milliseconds
# (s) = seconds
#---------------------------------------------------------------------------
keyhold = 500		# (ms) hold a key this long for key-repeat (0=disable)
keyrepeat = 100		# (ms) how fast held key is repeated
seeksize = 5		# (s) how far each press of FF or REW goes into song
volhold = 500		# (ms) hold vol+/i this long for key-repeat (0=disable)
volrepeat = 100		# (ms) how fast held volume key is repeated
lockout = 0		# button lockout while playing a track (0 = disable)
baud = 9600		# baud rate: 115200,57600,38400,19200,9600,2400,1200
#***************************************************************************

#***************************************************************************
# End of defaults section.
#
############################################################################


############################################################################
############################################################################
# 
# Key-mapping section.
#
############################################################################
############################################################################
# Every input key must be assigned a function. Any key without a function
# will do nothing (by default). Any function that is not mapped to a key will
# be inaccessible, but will have a initial value (volume for example) 
#
# Each key has a unique two-digit number. 
# The two-digit key number represents the placement of the key in the keypad
# matrix, where the first number is the column (0..7) and the second number
# is the row (0..7). For example, key 34 is the button connected between COL3
# and ROW4 of the keypad port on the back of the MP3sa.
#
# To assign the play function to key 34, the command is: "key 34 play"
#
# To determine the key numbers for your keyboard, set one line of the LCD
# to "show key pressed" mode (line1 = "$K") and press the attached key - 
# this will display the key value. 
#
# Here are all possible function codes, and what they do.
#
############################################################################
# Play mode key functions
############################################################################
#	pause		- pause playback
#	stop		- stop playing (does the same thing as pause)
#	play		- starting playing (current song) from current position
############################################################################
# Song Selection & Position key functions
############################################################################
#	next		- next track or song
#	prev		- previous song
#	disc+		- next "disc"
#	disc-		- previous "disc"
#	songX		- go to song (X) and start playing it
#	discX		- On first press, play the first track on disc (X)
#			- On subsequent presses, go to next track on disc
#	track1		- go to first track on current disc
#	last		- start to play last track on system
#	replay		- starting playing current song at the beginning
#	ff		- fast forward a bit (hold down for more)
#	rew		- rewind a bit (hold down for more)
############################################################################
# Volume Control key functions
############################################################################
#	vol+		- increase volume 
#	vol-		- decrease volume
#	max		- set volume to max (un-mute)
#	min		- set volume to min (which might not be zero)
#	mute		- set volume to zero
#	mute2		- toggle between mute(zero) and default volume level
############################################################################
# Browse Mode key functions
############################################################################
#	brup		- browse up down list (for browse mode only)
#	brdn		- browse down list (for browse mode)
#	brsel		- browse select (choose this song to play)
#	brtoggle	- switch in and out of browse mode (optional)
############################################################################
# Other Control key functions
############################################################################
#	repeat	- change repeat modes (cycles through all values)
#	reset		- return everything to normal state; like a warm reset
############################################################################
# Assign "next" as the default function for all keys. If used, this
# command must come BEFORE all other key mappings. The default is to
# do nothing with undefined keys.
############################################################################
defaultkey = next

############################################################################
# Here are some example key mappings.
############################################################################
key 00 prev
key 10 next
key 20 stop
key 30 play
key 40 pause
key 50 rew
key 60 ff
key 70 replay
key 01 vol-
key 11 vol+
key 21 max
key 31 min
key 41 mute
key 51 mute2
key 61 last
key 71 brtoggle
key 02 brup
key 12 brdn
key 22 brsel
key 32 disc+
key 42 disc-
key 52 track1
key 62 repeat
key 72 reset
key 03 disc1
key 13 disc2
key 23 disc3
key 33 disc4
key 43 disc5
key 53 disc6
key 63 disc7
key 73 disc8
key 04 disc9
key 14 disc10
key 24 disc11
key 34 disc12
key 44 disc13
key 54 disc14
key 64 disc15
key 74 disc16
key 05 song1
key 15 song2
key 25 song3
key 35 song4
key 45 song5
key 55 song6
key 65 song7
key 75 song8
key 06 song9
key 16 song10
key 26 song11
key 36 song12
key 46 song13
key 56 song14
key 66 song15
key 76 song16
key 07 song17
key 17 song18
key 27 song19
key 37 song20
key 47 song21
key 57 song22
key 67 song23
key 77 song24

# End