
DK101 Low-Cost Demo Kit Motherboard
9 of 13
Table 1. Definition File Fields
FIELD
DESCRIPTION
REM
Used for remarks to document the definition file. Cannot be used inside another field.
This field is not yet supported in the ChipView software.
DEVICE
The argument is a string of text that is displayed at the top of the Register View screen to help the user keep
track of which definition file is currently in use.
When located outside the REGISTER field, the argument specifies a global address offset for all registers in
the definition file. In some Dallas-made definition files OFFSET has two arguments. Older Dallas demo kit
software selects the first argument. The ChipView software selects the last argument.
OFFSET
When located inside the REGISTER field, the argument specifies a local address offset for all subsequent
register listings. All register addresses following the local OFFSET field are offset by both the global and local
offsets. The scope of the local offset is to the end of the REGISTER field or to the next local offset field.
Arguments are in four-digit hexadecimal format of the form “0x0000.”
Loads additional definition files. Used to accommodate more than one device on a piece of hardware or to split
a large register set into smaller subsets. The first argument is a number from 1 to 10 specifying the number of
definition files to link. Subsequent arguments are the filenames of the definition files being linked. Linked
definition files have all the functionality of the main definition file except that the LINKS field is ignored.
This field is not yet supported in the ChipView software.
LINKS
SETUP
Enables initialization register values. The argument must be either “on” or “off.” If the argument is “on,”
ChipView initializes all registers with a zero and then the initial value specified in the REGISTER field. When
SETUP is “on” the REG INI field is enabled.
This field is not yet supported in the ChipView software.
REG INI
Specifies an initialization file for initializing register values. REG INI is only enabled if the SETUP field is “on.”
The first argument must be either “on” or “off.” The second argument is a valid register initialization file (.INI
file). If the SETUP and REG INI fields are both “on,” registers are initialized by the values in the initialization
file.
This field is not yet supported in the ChipView software.
DEVICE ID
Defines how to determine if the device is present on the target hardware. The first argument must be either
“on”
or “off.” The second argument is a valid register description (see the REGISTER field for format). If the first
argument is “on” the ChipView software performs a device-check read/write sequence to the register specified
in the second argument. If the device check fails, a Device Not Present error is displayed.
Describes the registers of the target hardware. The first argument is the number of registers (1 to 255).
Subsequent arguments are comma-delimited strings with 14 subfields as follows:
REGISTER
address,rname,rtype,bus,ivalue,position,fullname,b7,b6,b5,b4,b3,b2,b1,b0
,
The number of strings must be equal to the number of registers specified in the first argument. See
Table 2
for
subfield definitions.
This field is not yet supported in the ChipView software. Currently, registers are displayed 14 per column in the
order listed in the REGISTER field.
DISPLAY
Specifies how to display the registers on screen. The first argument is a number from 1 to 20 that states the
number of columns to be displayed. Subsequent arguments are comma-delimited strings of numbers, where
each number specifies a register definition. The first register definition in the REGISTER field is 0, the second
is 1, and so on. The strings of numbers can be up to 14 numbers long. The number of strings must be equal to
the number of columns specified in the first argument.
END
Specifies the end of the definition file. This field has no arguments.