Client side data access (read/write) service functions

Functions
MmsValue *	IedConnection_readObject (IedConnection self, IedClientError *error, const char *dataAttributeReference, FunctionalConstraint fc)
	read a functional constrained data attribute (FCDA) or functional constrained data (FCD). More...
void	IedConnection_writeObject (IedConnection self, IedClientError *error, const char *dataAttributeReference, FunctionalConstraint fc, MmsValue *value)
	write a functional constrained data attribute (FCDA) or functional constrained data (FCD). More...
bool	IedConnection_readBooleanValue (IedConnection self, IedClientError *error, const char *objectReference, FunctionalConstraint fc)
	read a functional constrained data attribute (FCDA) of type boolean More...
float	IedConnection_readFloatValue (IedConnection self, IedClientError *error, const char *objectReference, FunctionalConstraint fc)
	read a functional constrained data attribute (FCDA) of type float More...
char *	IedConnection_readStringValue (IedConnection self, IedClientError *error, const char *objectReference, FunctionalConstraint fc)
	read a functional constrained data attribute (FCDA) of type VisibleString or MmsString More...
int32_t	IedConnection_readInt32Value (IedConnection self, IedClientError *error, const char *objectReference, FunctionalConstraint fc)
	read a functional constrained data attribute (FCDA) of type Integer or Unsigned and return the result as int32_t More...
int64_t	IedConnection_readInt64Value (IedConnection self, IedClientError *error, const char *objectReference, FunctionalConstraint fc)
	read a functional constrained data attribute (FCDA) of type Integer or Unsigned and return the result as int64_t More...
uint32_t	IedConnection_readUnsigned32Value (IedConnection self, IedClientError *error, const char *objectReference, FunctionalConstraint fc)
	read a functional constrained data attribute (FCDA) of type Integer or Unsigned and return the result as uint32_t More...
Timestamp *	IedConnection_readTimestampValue (IedConnection self, IedClientError *error, const char *objectReference, FunctionalConstraint fc, Timestamp *timeStamp)
	read a functional constrained data attribute (FCDA) of type Timestamp (UTC Time) More...
Quality	IedConnection_readQualityValue (IedConnection self, IedClientError *error, const char *objectReference, FunctionalConstraint fc)
	read a functional constrained data attribute (FCDA) of type Quality More...
void	IedConnection_writeBooleanValue (IedConnection self, IedClientError *error, const char *objectReference, FunctionalConstraint fc, bool value)
	write a functional constrained data attribute (FCDA) of type boolean More...
void	IedConnection_writeInt32Value (IedConnection self, IedClientError *error, const char *objectReference, FunctionalConstraint fc, int32_t value)
	write a functional constrained data attribute (FCDA) of type integer More...
void	IedConnection_writeUnsigned32Value (IedConnection self, IedClientError *error, const char *objectReference, FunctionalConstraint fc, uint32_t value)
	write a functional constrained data attribute (FCDA) of type unsigned (integer) More...
void	IedConnection_writeFloatValue (IedConnection self, IedClientError *error, const char *objectReference, FunctionalConstraint fc, float value)
	write a functional constrained data attribute (FCDA) of type float More...
void	IedConnection_writeVisibleStringValue (IedConnection self, IedClientError *error, const char *objectReference, FunctionalConstraint fc, char *value)
void	IedConnection_writeOctetString (IedConnection self, IedClientError *error, const char *objectReference, FunctionalConstraint fc, uint8_t *value, int valueLength)

Detailed Description

Function Documentation

bool IedConnection_readBooleanValue	(	IedConnection	self,
		IedClientError *	error,
		const char *	objectReference,
		FunctionalConstraint	fc
	)

read a functional constrained data attribute (FCDA) of type boolean

Parameters

self	the connection object to operate on
error	the error code if an error occurs
object	reference of the data attribute to read
fc	the functional constraint of the data attribute to read

float IedConnection_readFloatValue	(	IedConnection	self,
		IedClientError *	error,
		const char *	objectReference,
		FunctionalConstraint	fc
	)

read a functional constrained data attribute (FCDA) of type float

Parameters

self	the connection object to operate on
error	the error code if an error occurs
object	reference of the data attribute to read
fc	the functional constraint of the data attribute to read

int32_t IedConnection_readInt32Value	(	IedConnection	self,
		IedClientError *	error,
		const char *	objectReference,
		FunctionalConstraint	fc
	)

read a functional constrained data attribute (FCDA) of type Integer or Unsigned and return the result as int32_t

Parameters

self	the connection object to operate on
error	the error code if an error occurs
object	reference of the data attribute to read
fc	the functional constraint of the data attribute to read

Returns

an int32_t value of the read data attributes

int64_t IedConnection_readInt64Value	(	IedConnection	self,
		IedClientError *	error,
		const char *	objectReference,
		FunctionalConstraint	fc
	)

read a functional constrained data attribute (FCDA) of type Integer or Unsigned and return the result as int64_t

Parameters

self	the connection object to operate on
error	the error code if an error occurs
object	reference of the data attribute to read
fc	the functional constraint of the data attribute to read

Returns

an int64_t value of the read data attributes

MmsValue* IedConnection_readObject	(	IedConnection	self,
		IedClientError *	error,
		const char *	dataAttributeReference,
		FunctionalConstraint	fc
	)

read a functional constrained data attribute (FCDA) or functional constrained data (FCD).

Parameters

self	the connection object to operate on
error	the error code if an error occurs
object	reference of the object/attribute to read
fc	the functional constraint of the data attribute or data object to read

Returns

the MmsValue instance of the received value or NULL if the request failed

Quality IedConnection_readQualityValue	(	IedConnection	self,
		IedClientError *	error,
		const char *	objectReference,
		FunctionalConstraint	fc
	)

read a functional constrained data attribute (FCDA) of type Quality

Parameters

self	the connection object to operate on
error	the error code if an error occurs
object	reference of the data attribute to read
fc	the functional constraint of the data attribute to read

Returns

the timestamp value

char* IedConnection_readStringValue	(	IedConnection	self,
		IedClientError *	error,
		const char *	objectReference,
		FunctionalConstraint	fc
	)

read a functional constrained data attribute (FCDA) of type VisibleString or MmsString

NOTE: the returned char buffer is dynamically allocated and has to be freed by the caller!

Parameters

self	the connection object to operate on
error	the error code if an error occurs
object	reference of the data attribute to read
fc	the functional constraint of the data attribute to read

Returns

a C string representation of the value. Has to be freed by the caller!

Timestamp* IedConnection_readTimestampValue	(	IedConnection	self,
		IedClientError *	error,
		const char *	objectReference,
		FunctionalConstraint	fc,
		Timestamp *	timeStamp
	)

read a functional constrained data attribute (FCDA) of type Timestamp (UTC Time)

NOTE: If the timestamp parameter is set to NULL the function allocates a new timestamp instance. Otherwise the return value is a pointer to the user provided timestamp instance. The new timestamp instance has to be freed by the caller of the function.

Parameters

self	the connection object to operate on
error	the error code if an error occurs
object	reference of the data attribute to read
fc	the functional constraint of the data attribute to read
timestamp	a pointer to a user provided timestamp instance or NULL

Returns

the timestamp value

uint32_t IedConnection_readUnsigned32Value	(	IedConnection	self,
		IedClientError *	error,
		const char *	objectReference,
		FunctionalConstraint	fc
	)

read a functional constrained data attribute (FCDA) of type Integer or Unsigned and return the result as uint32_t

Parameters

self	the connection object to operate on
error	the error code if an error occurs
object	reference of the data attribute to read
fc	the functional constraint of the data attribute to read

Returns

an uint32_t value of the read data attributes

void IedConnection_writeBooleanValue	(	IedConnection	self,
		IedClientError *	error,
		const char *	objectReference,
		FunctionalConstraint	fc,
		bool	value
	)

write a functional constrained data attribute (FCDA) of type boolean

Parameters

self	the connection object to operate on
error	the error code if an error occurs
object	reference of the data attribute to read
fc	the functional constraint of the data attribute or data object to write
value	the boolean value to write

void IedConnection_writeFloatValue	(	IedConnection	self,
		IedClientError *	error,
		const char *	objectReference,
		FunctionalConstraint	fc,
		float	value
	)

write a functional constrained data attribute (FCDA) of type float

Parameters

self	the connection object to operate on
error	the error code if an error occurs
object	reference of the data attribute to read
fc	the functional constraint of the data attribute or data object to write
value	the float value to write

void IedConnection_writeInt32Value	(	IedConnection	self,
		IedClientError *	error,
		const char *	objectReference,
		FunctionalConstraint	fc,
		int32_t	value
	)

write a functional constrained data attribute (FCDA) of type integer

Parameters

self	the connection object to operate on
error	the error code if an error occurs
object	reference of the data attribute to read
fc	the functional constraint of the data attribute or data object to write
value	the int32_t value to write

void IedConnection_writeObject	(	IedConnection	self,
		IedClientError *	error,
		const char *	dataAttributeReference,
		FunctionalConstraint	fc,
		MmsValue *	value
	)

write a functional constrained data attribute (FCDA) or functional constrained data (FCD).

Parameters

self	the connection object to operate on
error	the error code if an error occurs
object	reference of the object/attribute to write
fc	the functional constraint of the data attribute or data object to write
value	the MmsValue to write (has to be of the correct type - MMS_STRUCTURE for FCD)

void IedConnection_writeOctetString	(	IedConnection	self,
		IedClientError *	error,
		const char *	objectReference,
		FunctionalConstraint	fc,
		uint8_t *	value,
		int	valueLength
	)

void IedConnection_writeUnsigned32Value	(	IedConnection	self,
		IedClientError *	error,
		const char *	objectReference,
		FunctionalConstraint	fc,
		uint32_t	value
	)

write a functional constrained data attribute (FCDA) of type unsigned (integer)

Parameters

self	the connection object to operate on
error	the error code if an error occurs
object	reference of the data attribute to read
fc	the functional constraint of the data attribute or data object to write
value	the uint32_t value to write

void IedConnection_writeVisibleStringValue	(	IedConnection	self,
		IedClientError *	error,
		const char *	objectReference,
		FunctionalConstraint	fc,
		char *	value
	)