Ethernet Module Interface (EMI)
– API Description
Copyright IXXAT Automation GmbH
81
IEM Manual, 1.5
COM_k_INVALID_STATE
routine called in invalid state
COM_k_ERROR
parameter error
4.1.2.46 EMI_ioAcyclDataWrite()
COM_e_ERROR EMI_ioAcyclDataWrite( COM_t_BOARD_REF td_brdRef,
const VOID *pv_source,
UINT16 w_offset,
UINT16 w_length);
Description
This function copies data to an address (specified by Offset) of the shared
memory area of acyclic data. The access to data is protected by means of a
hardware semaphore. The semaphore is implemented on the IEM. If "1" is
written to the semaphore register and a subsequent read also returns "1" then
the access was successful. Otherwise the semaphore is busy. The write ac-
cess to the semaphore is repeated several times. If the maximum number of
retries is exceeded the function returns COM_k_BUSY. This limitation avoids a
deadlock in case of a system crash on the IEM. The application has to convert
the protocol specific format of complex data structures to the local format.
Remarks
-
Parameter
Dir.
Description
td_brdRef
IN
unique IEM reference
pv_source
IN
source address
w_offset
IN
offset to the data in shared memory
w_length
IN
length of data
Return Value
Description
COM_k_OK
data copy OK.
COM_k_BUSY
no access to shared memory possible. Retry limit was hit.
COM_k_INVALID_BOARD
invalid IEM reference
COM_k_INVALID_STATE
routine called in invalid state
COM_k_ERROR
parameter error
4.1.2.47 EMI_ioCyclWriteImageSizeGet()
UINT32 EMI_ioCyclWriteImageSizeGet(COM_t_BOARD_REF td_brdRef);