NLS DS1 - Player Configuration via XML File

Special Features for Libraries and Technicians Section 3
February 2010 Digital Talking-Book Player 42
Library Guide
3.3 Player Configuration and Operation with an XML file
It is possible to automate some configuration and service operations of the player by using an XML file containing
one or more text instructions. The player will examine this file, called options.xml, if present in top most (root)
directory of the cartridge or USB drive. The file has two parts. The first is the configuration section which contains
the commands that set non–volatile settings such as the language or verbosity. The other section contains one time
directives such as clearing the book profile or exporting the statistics to the USB drive.
Example of an ‘options.xml’ file used to setup a player prior to distribution to a patron
<?xml version="1.0" encoding="utf-8"?>
<dtbm xmlns="http://www.loc.gov/nls/DTBM">
<configuration>
<Language value="spanish" />
<Verbosity value="normal" />
</configuration>
<directive>
<ResetProfile value="all" />
<BatteryLife />
<ExportStatistics />
<Off />
</directive>
</dtbm>
Set the player to Spanish
Set the verbosity to normal
Clear the bookmarks, last marks & keys
Report the battery condition & software version
Save the accumulated player data to USB drive
Turn off the player
Configuration elements in ‘options.xml’
Tag Value Effect
Language
English, Spanish, Ingles,
Espaniol
Change the language setting of the player
if different from current configuration.
Verbosity Normal, Reduced
Change the verbosity setting of the player
if different from current configuration.
Directive elements in ‘options.xml’
Tag Value Effect
InitialMode Normal, Service2, Service3
Change the mode to the technician or
technician plus service level or leave in
normal mode.
ResetProfile Profile, Keys, All
Clear the bookmarks/lastmarks and/or the
user added PDTB1 and PDTB2 keys.
BatteryLife
Announce the current charge state,
number of charges for this battery and the
software version.
ExportStatistics
Save the accumulated statistical data on
the player to a file on the USB drive.
ExportKey
Save the player’s public instance key to
the USB drive.
Off
Turn the player off after acting on these
directives.