The Xentara Pickering PXI Driver v1.2
User Manual
Sub-Unit Handlers
See also
I/O Transactions in the Xentara user manual

Sub-unit handlers are a type of Xentara I/O transaction.

Xentara reads and writes the values of the different sub-units of a card using a sub-unit handler object. Each handler object reads and writes the values of the sub-units attached to it in the configuration. The handler has two tasks named read and write that must be inserted into a Xentara execution pipeline. If you fail to schedule the read task, the values of the associated sub-units will not be updated. If you fail to schedule the write task, modified values for the associated sub-units will not be written back to the PXI module. Each sub-unit handler object must be a child element of the card whose sub-units it handles.

Often, a single handler is sufficient per card. It is possible, however, to define multiple handlers for the same card. This allows you to schedule the handlers differently, reading and/or writing some values at higher intervals than others.

Accessing Sub-Unit Handlers

Pickering PXI sub-unit handlers have the following members:

Attributes
keyThe handler’s primary key.
nameThe handler’s name. The name is the last component of the primary key.
UUIDThe unique UUID of the handler.
typeThe handler’s element type. For sub-unit handlers, this is always “Pickering PXI sub-unit handler”.
categoryThe handler’s category. For sub-unit handlers, this is always “transaction”.
Tasks
readReads the values of the attached sub-units from the physical PXI module.
writeWrites any pending modified values of the attached sub-units back to the physical PXI module.

Scheduling Handler Tasks

See also
Scheduling Tasks in the Xentara user manual

All tasks for all sub-unit handlers belonging to a single card card must be scheduled within the same execution track. Additionally, none of these tasks must be scheduled in parallel pipeline segments within their pipeline.