ZCOM Tables and Data Structures

Interface Table

IFFLDT, IFFMNM - Download file link time and module name

These two fields contain the time (since Epoch) when the download firmware file is linked (by zlink program) and its module name. These are set up by zlink and stored in the download file. When ZMON loads the file to the Mux interface card, it extracts them from the file and puts them into these two fields. The MX command in zmntr displays these fields.

IFRUDT, IFRMNM, IFRREV - ROM update time, module name and revision code

The ZCOM subsystem ROM contains its module name, revision code and update time in byte locations 40~5D hex. ZMON reads these bytes from the Mux interface card when it loads the firmware file, and stores them in these fields. The MX command in zmntr displays these fields. The time is translated from the ROM ASCII time stamp and stored in Epoch format.

IFWINFO - Firmware run-time information word

This is a 16-bit field refreshed by the DAM once every 10 seconds with the runtime information word from the Mux firmware. It contains the average percentage activity of the Mux interface for the previous 10 seconds and the type code of the Mux front panel connected.

IFBOFF - Buffer pointer adjusted offset

Contained with the interface table are buffers that are used for DMA transfers between the driver and the Mux card. These buffers are a multiple of 64 bytes and must be aligned on a 64-byte address boundary. This field contains the byte offset needed to cause the buffers to start on a 64-byte boundary. TTGEN initializes this field with the byte offset value.

INTFCQ - Interface control queue (zqhd_type)

This queue contains pending port requests from application programs. The operation of this queue is described in the section on the DAM. This format of the queue header structure (zqhd_type) is described later in this chapter.

IFDMAQ - DMA receive buffer queue (zqhd_type)

Holds the current receive buffer during an $RXDT DMA transfer. This format of the queue header structure (zqhd_type) is described later in this chapter.

Chapter 3

81