Ethernet Module Interface (EMI)
– API Description
Copyright IXXAT Automation GmbH
67
IEM Manual, 1.5
COM_t_REQUEST_REF *ptd_reqRef);
Description
This function opens a communication channel to a remote device for the ex-
change of acyclic data. The application will receive the response not before
the connection to the remote device could be established or failed. The re-
sponse contains a connection reference if the connection establishment is
successful. This response will be generated by the BPW if it receives the re-
sponse from the remote device. The application has to request for the re-
sponse by means of EMI_srvrespRespQuery. The SD channel is used for the
transmission of the Open service. Every connection reference refers to a spe-
cific target device that is specified by its target address (e.g. IP address). This
target address is part of the request structure.
Parameter
Dir.
Description
td_brdRef
IN
unique IEM reference
ps_request
IN
pointer to the service request
ptd_reqRef
OUT
pointer to the variable receiving the reference of the request
Return Value
Description
COM_k_OK
request to open the connection with remote node issued suc-
cessfully
COM_k_INVALID_BOARD
invalid IEM reference
COM_k_INVALID_STATE
routine called in invalid state
COM_k_INVALID_PARAM
request parameter missed
COM_k_ERROR
request to open the connection cannot be sent
4.1.2.28 EMI_srvRemoteConnClose()
COM_e_ERROR EMI_srvRemoteConnClose(COM_t_BOARD_REF td_brdRef,
COM_t_CONNECTION_REF td_conRef,
COM_t_REQUEST_REF *ptd_reqRef,
COM_t_SERVICE_DATA *ps_request);
Description
This function closes a previously opened communication channel to the re-
mote device. Only the successful close of the local channel is supervised be-
cause some protocols may not send any confirmation. Thus the application will
immediately receive a response. The application is responsible to allocate a
service data command structure (COM_t_REMOTE_CLOSE) and free them
after transmission. The application has to request for the response by means