_________________________________________________________________________________________ DS3106DK
16
4.12
Configuration Scripts and Log File
4.12.1
Configuration Log File
Every write command issued by the software to the DS3106DK board is logged in file DS3106DKLog.mfg located
in the same directory as the software executable. This file can be viewed in Notepad by pressing the
Log File
button in the upper-right corner of the main window. Command line option "-l <filepath>" can be used to cause the
software to write to a file other than DS3106DKLog.mfg.
4.12.2
Configuration Scripts
All or part of the text in the configuration log file can be copied to a text file with a .mfg file extension for use as a
configuration script. Configuration scripts are useful for quickly configuring the DS3106 without having to remember
all the required settings.
Two types of configuration scripts are possible: full and partial. A full configuration script can start with the DS3106
in its power-on default state and configure every aspect of the device to bring it to a desired state. To make a full
configuration script, run the software, uncheck the
Demo Mode
checkbox, initialize the device, configure the device
using the DK software fields, press the
Log File
button, and use
File
→
Save As
in Notepad to save a copy of the
entire log file to a different file name.
A partial configuration file only affects a subset of the DS3106 device settings. To make a partial configuration
script, press the
Log File
button to view the log file, press
Ctrl-End
to jump to the end of the file, and add to the
end of the file a carriage return or comment line (starting with a semicolon) to delimit the start of the desired
configuration. Then save and exit the log file. Next, configure the device using the DK software fields. Finally, view
the log file again, jump to the end, and copy everything from the delimiter to the end of the file into a new .mfg file.
To run a configuration script, press the
Config Script
button in the upper-right corner of the main window. In the
script window, type the path to the file or press the
Browse
button to navigate to the file.
Note that when the
Demo Mode
checkbox is unchecked, during the
Initializing the DS3106
step, the software
runs configuration script startup.mfg located in the same directory as the software executable. The startup.mfg file
can be edited or replaced as needed to change the initial configuration of the device. Be aware, however, that the
section of the startup.mfg file labeled
Required Initialization
must be executed after device power-up or reset for
the DS3106 to operate correctly.
