Writes a set of control registers to a TX board (for board types that include control registers).
#include txcpi.h
S16 cpi_write_control ( TX_HANDLE handle, U16 basereg, U16 numreg, U32 *regarray, U16 *actcnt)
Argument |
Description |
handle |
TX handle number. |
basereg |
Number of the base register to write (0 through max-1). |
numreg |
Count of registers to write. |
regarray |
Pointer to an array holding the register values to be written. |
actcnt |
Pointer to the location to store the number of registers written. |
Return value |
Description |
CPI_SUCCESS |
Provided set of registers successfully written to the TX board. |
CPI_ERROR |
Call cpi_get_last_error to obtain the error code. |
In addition to the dual-ported RAM shared between the host processor and the TX board, a set of registers is used for communication control for certain TX board types (such as PCI and CompactPCI boards).Certain low-level diagnostics on the TX board use the control registers to control low-level, on-board diagnostics.
All control register access should be restricted to diagnostic applications. Do not use this function for normal data transfer situations.