HELP
An object that logs the messages sent over an
I/O interface path (HP-IB, GPIO, VXI, or
RS-232).  This feature is available in HP
VEE-Test only.

USE
Use Bus I/O Monitor to record each byte
(command or data) transferred between HP VEE
and any instruments it is controlling by way
of a State Drivers, Component Drivers, Direct
I/O, and the Advanced I/O devices.  The
information that is recorded can optionally
be sent to a log file.

The display area of Bus I/O Monitor
contains five columns.  For HP-IB, GPIO and
RS-232 the columns indicate:

* Column 1 - Line number.

* Column 2 - HP-IB command (*), data output
(>), or data input (<).

* Column 3 - Hexadecimal value of the byte
transmitted.

* Column 4 - 7-bit ASCII character
corresponding to the byte transmitted.

* Column 5 - Bus command mnemonic (HP-IB bus
commands only).

Only columns 1 through 3 are used when
monitoring GPIO communications.

Only columns 1 through 4 are used when
monitoring RS-232 communications.
For VXI the columns indicate:

* Column 1 - Line number.

* Column 2 - VXI command (*), data output
(>), or data input (<).

* Column 3 - Memory space (A16, A24, or A32),
symbolic name for register or location,
offset from named location.

* Column 4 - Hexadecimal value of the byte
transmitted.

* Column 5 - Logical address of the VXI
instrument.

LOCATION
I/O ==> Bus I/O Monitor

OBJECT MENU

* Config - Determines the maximum number of
lines retained in the monitor.  Once the
monitor is full, lines at the beginning of
monitor are discarded to make room for
newly-logged lines.

* Clear - Clears the contents of the Bus I/O
Monitor.  Clear may be added as a control
input pin.

* Clear at PreRun - Clears the contents of
the Bus I/O Monitor at PreRun.  Note that if
the Bus Monitor is not connected to a thread
and Start is used (not Run), PreRun does not
happen on the object.  This is because only
the objects on the Start thread are PreRun.

* Clear at Activate - Clears the contents of
the Bus I/O Monitor at activate.

* Logging Enabled - Records activity in the
list area of the Bus I/O Monitor.  Log Enable
and Log Disable control input pins may be
added.

* Log To File - Sends data to the specified
file as it is recorded by the Bus I/O
Monitor.  Logging Enabled must also be
selected before any monitor data will be
saved to the file.  Monitor data is always
appended to the end of the specified file.
The Log File Name parameter can be added as a
control input.

* Clear Log File - Deletes the contents of
the specified log file.  This parameter can
be added as a control input.

NOTES
The Bus I/O Monitor allows execution to
proceed much faster when displayed as an icon
rather than an open view.

Each Bus I/O Monitor object is capable of
monitoring one physical bus.  For example, to
monitor HP VEE's activity on one HP-IB card
and one RS-232 card, the user would need two
Bus I/O Monitors.

Bus I/O Monitor is not a general purpose
hardware bus monitor since it only shows the
bytes input and output by HP VEE.  Any other
programs that input/output to the bus, for
example, HP BASIC/UX or shell escape programs
that perform I/O, do not log their I/O to the
HP VEE monitor.

SEE ALSO
Advanced I/O, Configure I/O, and Instrument.
