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.

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. 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.