SourcePoint AMD Help

Using Help
- Welcome to On-Line Help
- How To - HTML Help
Contacting ASSET InterTech
- Contacting ASSET InterTech
Introduction to SourcePoint
- What's New in SourcePoint for AMD 1.0
SourcePoint Environment
- SourcePoint Overview
- How To -- SourcePoint Environment
Breakpoints Window
- Breakpoints Window Overview
- How To - Breakpoints
  - Set Breakpoints From Other SourcePoint Windows
Code Window
- Code Window Overview
- How To - Code Window
Command Window
- Command Window Overview
  - Introduction
Confidence Tests Window
- Confidence Tests Window Overview
Descriptors Tables Window
- Descriptors Tables Window Overview
  - Descriptors Window Introduction
  - Descriptors Window Menu
- How To - Descriptors
  - Replace a Descriptor Entry
Devices Window
- Devices Window Overview
- How To - Devices Window
  - Create Simple Devices Window
Log Window
- Log Window Overview
Memory Window
- Memory Window Overview
- How To - Memory Window
Page Translation Window
- Page Translation Windows Overview
  - Page Translation Windows Introduction
PCI Devices Window
- PCI Devices Window Overview
  - PCI Devices Window Introduction
  - PCI Devices Window Menu
- How To - PCI Devices Window
  - Open the Registers Window From the PCI Devices Window
  - Refresh a PCI Devices Dialog Box
Registers Window
- Registers Window Overview
  - Registers Window Introduction
- How To - Registers
  - Customize the Registers Window
  - Print a Register List
Symbols Windows
- Symbols Window Overview
- How To - Symbols Window
  - Change Values in the Symbols Window
Viewpoint Window
- Viewpoint Window Overview
  - Viewpoint Window Introduction
  - Viewpoint Window Menu
Watch Window
- Watch Window Overview
  - Watch Window Introduction
  - Watch Window Menu
- How To - Watch Window
  - Add and Expand Registers in a Watch View
  - Add Symbols to a Watch or Quick Watch View
Technical Notes
- Descriptor Cache: Revealing Hidden Registers
- UEFI Framework Debugging
- Memory Casting
- Microsoft PE Format Support in SourcePoint
- Registers Keyword Table
- SourcePoint Licensing
- Stepping
- Symbols Textsym Format
- Target Configuration
- Using Bookmarks
- Which Processor Is Which
SourcePoint Command Language
- Overview
- Commands and Control Variables

msgir

Add an IR scan into and existing JTAG message.

Syntax

[result =] msgir(msg-handle, ir-length, write-array, [irscan-option])

[result =] msgir(msg-handle, ir-length, write-value, [irscan-option])

Where irscan-option is:

[irscan-option] = [, readwrite, [scan-chain, [0, [stop-state, [0]]]]]

Where:

result	is a boolean variable that contains the return value of this command. TRUE indicates the IR scan was successfully added to the JTAG message. FALSE indicates an error occurred, such as the JTAG message was not found.
msg-handle	is the name of a previously defined debug variable of type handle. This is the variable that was passed in to msgopen when the JTAG message was created.
ir-length	is an ord4 that contains the number of bits to be scanned to an instruction register (IR).
write-array	is an array of type ord1, ord2, or ord4, of bits to scan to the instruction register. If no write-array is specified, then zeros are scanned.
write-value	is an ord1, ord2, or ord4 value to scan to the instruction register. If no write-value is specified, then zeros are scanned.
readwrite	is an ord1 that specifies the type of IR scan. See valid readwrite values below.
scan-chain	is an ord1 that specifies which scan chain to select on the debug port. This may only be either 0 or 1. If scan-chain is not specified, then scan chain 0 is used.
stop-state	is an ord1 that specifies the TAP state in which to stop at the end of the scan. If stop-state is not specified, then 0 (RTI) is used.

Discussion

Use the msgir command to add an instruction register (IR) scan to the open JTAG message. The IR length must be specified. The additional section of parameters, irscan-option, is optional. This command returns an error if the JTAG message has been closed.

The legal readwrite values for IR scans are:

0	write-only
1	readwrite

The legal stop-state values are:

0	RTI: default
1	CAPTURE-PAUSE: stop in the IR pause state, no data are shifted
2	PAUSE: stop in the IR pause state
3	CAPTURE-RTI: force through the IR capture state, no data are shifted and stop in RTI
4	RTI-DUAL: go to RTI from the IR PAUSE, clocks both time bases, no data are shifted
5	CAPTURE-PAUSE-DUAL: stop in the IR pause state, clocks both time bases, no data are shifted

Example

Command input:

// Read JTAG ID from processor
define handle h
define ord2 device = 0
msgopen(h)
msgir(h, 8, 2) // 8=ir length, 2=idcode
msgdr(h, 0n32, 2)

msgclose(h)
msgscan(h, device)
define ord4 count = 0
msgreturndatasize(h, count, device)
define ord1 data[count]
msgdata(h, data)
data
msgdelete(h)

SourcePoint AMD Help

Table of Contents

msgir

Syntax

Discussion

Example