Accessing Devices Window Cells in the Command Window

Often times the Devices window is used to display memory-mapped I/O locations containing the register definitions for the internal peripherals inside a device. Column 0 typically contains text cells with register names and column 1 contains memory cells with register values. (See C:\Program Files\American Arium\ARM\Samples\Device for examples of these kinds of device files.)

SourcePoint can optionally make these register names available in the command language. This allows you to access individual registers via the Command window or manipulate registers within a command script (include file).

To enable this feature for all devices in a device file, add the following entry to the file:

[Group]
AddSymbols=1

Device files often contain definitions for a group of devices. To enable this feature for a single device (e.g., Device3), add the following entry to that devices section:

[Device3]
AddSymbols=1

Note: To speed up the processing of device files, the cells for a particular device are processed only when that device is displayed in the Devices window.  Devices whose memory-mapped registers are to be added to the command language must be processed when the device file is loaded, so device file load times may rise.

Note: Memory cells are only added to the command language if the preceding cell (same row, previous column) is a text cell.

Example:

The following two cell definitions are part of the definition of the memory-mapped registers used to configure a DMA controller:

[Device0]
Name=DMA Controller
 

AddSymbols=1

cell2=1,0,text,"DCSR0",text=blue,tooltip="DMA Control/Status Register"  
cell3=1,1,mem,0x40000000,4,access=rw,

Adding the ”AddSymbols=1” entry will result in the following alias being defined in the command language:

#define DCSR0 0x40000000

It thus types the following in the Command window:

word DCSR0

This causes the command interpreter to replace DCSR0 with 0x4000000 and display 4 bytes of memory read from address 0x40000000.