DK2000 High-Performance Demo Kit Motherboard
9 of 19
Table 1. Definition File Fields
FIELD DESCRIPTION
REM Used for remarks to document the definition file. Cannot be used inside another field.
DEVICE
This field is not yet supported in the ChipView software.
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.
OFFSET
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.
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.”
LINKS
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.
The number of filenames must be equal to the number specified in the first argument. Linked definition files
have all the functionality of the main definition file except that the LINKS field is ignored.
SETUP
This field is not yet supported in the ChipView software.
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.
REG INI
This field is not yet supported in the ChipView software.
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.
DEVICE ID
This field is not yet supported in the ChipView software.
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.
REGISTER
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:
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.
DISPLAY
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.
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.
