PN_API_IOD_removeExtDiagChannel()

uint32_t PN_API_IOD_removeExtDiagChannel	(	PN_API_IOD_Handle_t *const	pnHandle,
		const uint32_t	api,
		PN_API_IOD_DevAddr_t *const	addr,
		const uint16_t	channelNum,
		const uint16_t	errorNum,
		const PN_API_IOD_DiagChannelPropDirection_t	chanDir,
		const PN_API_IOD_DiagChannelPropType_t	chanTyp,
		const uint16_t	extChannelErrType,
		const uint32_t	extChannelAddValue,
		const uint16_t	diagTag,
		const uint16_t	alarmState
	)

Remove extended channel diagnostic alarm to PN stack.

Removal of a diagnostic record that was previously added using PN_API_IOD_addExtDiagChannel(). If the device owns this subslot within an AR, an extended 'Diagnostic alarm - outgoing' is automatically transmitted to the IO controller. The 'alarmState' parameter determines whether additional diagnostic entries are accessible for the same channel. If 'channelNum' equals 0x8000, the diagnostic entry remains applicable to the entire submodule, and the 'alarmState' value also applies to the complete submodule.

Parameters

[in]	pnHandle	Profinet API Handle.
[in]	api	Application Process Identifier.
[in]	addr	Geographical address (slot/subslot) of the module/submodule.
[in]	channelNum	Channel number.
[in]	errorNum	Error number, see PNIO specification coding of "ChannelErrorType".
[in]	chanDir	Channel direction (see PN_API_IOD_DiagChannelPropDirection_t).
[in]	chanTyp	Channel type (see PN_API_IOD_DiagChannelPropType_t).
[in]	extChannelErrType	Extended channel error type (see PNIO specification).
[in]	extChannelAddValue	Extended channel add. value (see PNIO specification).
[in]	diagTag	User defined diag tag != 0.
[in]	alarmState	PN_API_IOD_DiagChannelPropSpecErrDisappear or PN_API_IOD_DiagChannelPropSpecErrDisappearMore.

Returns

result of the operation as uint32_t.

Return values

PN_API_OK	Success.
PN_API_NOT_OK	Something went wrong.
PN_API_ERR_PARAM	Invalid parameter.

Example

#include "pn_api_iod_diagnostic.h"
#include "pn_api_iod_startup.h"
 
PN_API_IOD_Handle_t* pnHandle = NULL;
uint32_t status;
 
pnHandle = PN_API_IOD_new();
 
//Prepare and call PN_API_IOD_startup()
//add an extended diagnostic channel with PN_API_IOD_addExtDiagChannel()
...
 
uint32_t api = 0;
uint16_t channelNum = 1;
uint16_t errorNum;
uint16_t diagTag = 1;
PN_API_IOD_DevAddr_t addr;
PN_API_IOD_DiagChannelPropDirection_t chanDir = PN_API_IOD_DiagChannelPropDirectionIn;
PN_API_IOD_DiagChannelPropType_t chanTyp = PN_API_IOD_DiagChannelPropTypeByte;
uint16_t extChannelErrType = ..; // look at IEC61158-5-10/
uint32_t extChannelAddValue = ....; // look at IEC61158-5-10/
addr.type = PN_API_IOD_AddrGeo;
addr.address.geo.slot = 1;
addr.address.geo.subslot = 2;
uint16_t alarmState = PN_API_IOD_DiagChannelPropSpecErrDisappear;
 
status = PN_API_IOD_removeExtDiagChannel(pnHandle, api, &addr, channelNum
   errorNum, chanDir, chanTyp, extChannelErrType, extChannelAddValue, diagTag, alarmState);