mms_value.h

Go to the documentation of this file.

/*
 *  mms_value.h
 *
 *  Copyright 2013-2018 Michael Zillgith
 *
 *  This file is part of libIEC61850.
 *
 *  libIEC61850 is free software: you can redistribute it and/or modify
 *  it under the terms of the GNU General Public License as published by
 *  the Free Software Foundation, either version 3 of the License, or
 *  (at your option) any later version.
 *
 *  libIEC61850 is distributed in the hope that it will be useful,
 *  but WITHOUT ANY WARRANTY; without even the implied warranty of
 *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 *  GNU General Public License for more details.
 *
 *  You should have received a copy of the GNU General Public License
 *  along with libIEC61850.  If not, see <http://www.gnu.org/licenses/>.
 *
 *  See COPYING file for the complete license text.
 */
 
#ifndef MMS_VALUE_H_
#define MMS_VALUE_H_
 
#ifdef __cplusplus
extern "C" {
#endif
 
#include "libiec61850_common_api.h"
#include "mms_common.h"
#include "mms_types.h"
 
typedef enum {
    DATA_ACCESS_ERROR_SUCCESS_NO_UPDATE = -3,
    DATA_ACCESS_ERROR_NO_RESPONSE = -2, /* for server internal purposes only! */
    DATA_ACCESS_ERROR_SUCCESS = -1,
    DATA_ACCESS_ERROR_OBJECT_INVALIDATED = 0,
    DATA_ACCESS_ERROR_HARDWARE_FAULT = 1,
    DATA_ACCESS_ERROR_TEMPORARILY_UNAVAILABLE = 2,
    DATA_ACCESS_ERROR_OBJECT_ACCESS_DENIED = 3,
    DATA_ACCESS_ERROR_OBJECT_UNDEFINED = 4,
    DATA_ACCESS_ERROR_INVALID_ADDRESS = 5,
    DATA_ACCESS_ERROR_TYPE_UNSUPPORTED = 6,
    DATA_ACCESS_ERROR_TYPE_INCONSISTENT = 7,
    DATA_ACCESS_ERROR_OBJECT_ATTRIBUTE_INCONSISTENT = 8,
    DATA_ACCESS_ERROR_OBJECT_ACCESS_UNSUPPORTED = 9,
    DATA_ACCESS_ERROR_OBJECT_NONE_EXISTENT = 10,
    DATA_ACCESS_ERROR_OBJECT_VALUE_INVALID = 11,
    DATA_ACCESS_ERROR_UNKNOWN = 12
} MmsDataAccessError;
 
typedef struct sMmsValue MmsValue;
 
/*************************************************************************************
 *  Array functions
 *************************************************************************************/
 
LIB61850_API MmsValue*
MmsValue_createArray(const MmsVariableSpecification* elementType, int size);
 
LIB61850_API uint32_t
MmsValue_getArraySize(const MmsValue* self);
 
LIB61850_API MmsValue*
MmsValue_getElement(const MmsValue* array, int index);
 
LIB61850_API MmsValue*
MmsValue_createEmptyArray(int size);
 
LIB61850_API void
MmsValue_setElement(MmsValue* complexValue, int index, MmsValue* elementValue);
 
 
/*************************************************************************************
 * Basic type functions
 *************************************************************************************/
 
LIB61850_API MmsDataAccessError
MmsValue_getDataAccessError(const MmsValue* self);
 
LIB61850_API int64_t
MmsValue_toInt64(const MmsValue* self);
 
LIB61850_API int32_t
MmsValue_toInt32(const MmsValue* value);
 
LIB61850_API uint32_t
MmsValue_toUint32(const MmsValue* value);
 
LIB61850_API double
MmsValue_toDouble(const MmsValue* self);
 
LIB61850_API float
MmsValue_toFloat(const MmsValue* self);
 
LIB61850_API uint32_t
MmsValue_toUnixTimestamp(const MmsValue* self);
 
LIB61850_API void
MmsValue_setFloat(MmsValue* self, float newFloatValue);
 
LIB61850_API void
MmsValue_setDouble(MmsValue* self, double newFloatValue);
 
LIB61850_API void
MmsValue_setInt8(MmsValue* value, int8_t integer);
 
LIB61850_API void
MmsValue_setInt16(MmsValue* value, int16_t integer);
 
LIB61850_API void
MmsValue_setInt32(MmsValue* self, int32_t integer);
 
LIB61850_API void
MmsValue_setInt64(MmsValue* value, int64_t integer);
 
LIB61850_API void
MmsValue_setUint8(MmsValue* value, uint8_t integer);
 
LIB61850_API void
MmsValue_setUint16(MmsValue* value, uint16_t integer);
 
LIB61850_API void
MmsValue_setUint32(MmsValue* value, uint32_t integer);
 
 
LIB61850_API void
MmsValue_setBoolean(MmsValue* value, bool boolValue);
 
LIB61850_API bool
MmsValue_getBoolean(const MmsValue* value);
 
LIB61850_API const char*
MmsValue_toString(MmsValue* self);
 
LIB61850_API int
MmsValue_getStringSize(MmsValue* self);
 
LIB61850_API void
MmsValue_setVisibleString(MmsValue* self, const char* string);
 
 
LIB61850_API void
MmsValue_setBitStringBit(MmsValue* self, int bitPos, bool value);
 
LIB61850_API bool
MmsValue_getBitStringBit(const MmsValue* self, int bitPos);
 
LIB61850_API void
MmsValue_deleteAllBitStringBits(MmsValue* self);
 
 
LIB61850_API int
MmsValue_getBitStringSize(const MmsValue* self);
 
LIB61850_API int
MmsValue_getBitStringByteSize(const MmsValue* self);
 
LIB61850_API int
MmsValue_getNumberOfSetBits(const MmsValue* self);
 
LIB61850_API void
MmsValue_setAllBitStringBits(MmsValue* self);
 
LIB61850_API uint32_t
MmsValue_getBitStringAsInteger(const MmsValue* self);
 
LIB61850_API void
MmsValue_setBitStringFromInteger(MmsValue* self, uint32_t intValue);
 
LIB61850_API uint32_t
MmsValue_getBitStringAsIntegerBigEndian(const MmsValue* self);
 
LIB61850_API void
MmsValue_setBitStringFromIntegerBigEndian(MmsValue* self, uint32_t intValue);
 
LIB61850_API MmsValue*
MmsValue_setUtcTime(MmsValue* self, uint32_t timeval);
 
LIB61850_API MmsValue*
MmsValue_setUtcTimeMs(MmsValue* self, uint64_t timeval);
 
LIB61850_API void
MmsValue_setUtcTimeByBuffer(MmsValue* self, const uint8_t* buffer);
 
LIB61850_API uint8_t*
MmsValue_getUtcTimeBuffer(MmsValue* self);
 
LIB61850_API uint64_t
MmsValue_getUtcTimeInMs(const MmsValue* value);
 
LIB61850_API uint64_t
MmsValue_getUtcTimeInMsWithUs(const MmsValue* self, uint32_t* usec);
 
LIB61850_API void
MmsValue_setUtcTimeQuality(MmsValue* self, uint8_t timeQuality);
 
LIB61850_API MmsValue*
MmsValue_setUtcTimeMsEx(MmsValue* self, uint64_t timeval, uint8_t timeQuality);
 
LIB61850_API uint8_t
MmsValue_getUtcTimeQuality(const MmsValue* self);
 
LIB61850_API void
MmsValue_setBinaryTime(MmsValue* self, uint64_t timestamp);
 
LIB61850_API uint64_t
MmsValue_getBinaryTimeAsUtcMs(const MmsValue* self);
 
LIB61850_API void
MmsValue_setOctetString(MmsValue* self, const uint8_t* buf, int size);
 
LIB61850_API void
MmsValue_setOctetStringOctet(MmsValue* self, int octetPos, uint8_t value);
 
LIB61850_API uint16_t
MmsValue_getOctetStringSize(const MmsValue* self);
 
LIB61850_API uint16_t
MmsValue_getOctetStringMaxSize(MmsValue* self);
 
LIB61850_API uint8_t*
MmsValue_getOctetStringBuffer(MmsValue* self);
 
LIB61850_API uint8_t
MmsValue_getOctetStringOctet(MmsValue* self, int octetPos);
 
LIB61850_API bool
MmsValue_update(MmsValue* self, const MmsValue* source);
 
LIB61850_API bool
MmsValue_equals(const MmsValue* self, const MmsValue* otherValue);
 
LIB61850_API bool
MmsValue_equalTypes(const MmsValue* self, const MmsValue* otherValue);
 
/*************************************************************************************
 * Constructors and destructors
 *************************************************************************************/
 
 
LIB61850_API MmsValue*
MmsValue_newDataAccessError(MmsDataAccessError accessError);
 
LIB61850_API MmsValue*
MmsValue_newInteger(int size);
 
LIB61850_API MmsValue*
MmsValue_newUnsigned(int size);
 
LIB61850_API MmsValue*
MmsValue_newBoolean(bool boolean);
 
LIB61850_API MmsValue*
MmsValue_newBitString(int bitSize);
 
LIB61850_API MmsValue*
MmsValue_newOctetString(int size, int maxSize);
 
LIB61850_API MmsValue*
MmsValue_newStructure(const MmsVariableSpecification* typeSpec);
 
LIB61850_API MmsValue*
MmsValue_createEmptyStructure(int size);
 
LIB61850_API MmsValue*
MmsValue_newDefaultValue(const MmsVariableSpecification* typeSpec);
 
LIB61850_API MmsValue*
MmsValue_newIntegerFromInt8(int8_t integer);
 
LIB61850_API MmsValue*
MmsValue_newIntegerFromInt16(int16_t integer);
 
LIB61850_API MmsValue*
MmsValue_newIntegerFromInt32(int32_t integer);
 
LIB61850_API MmsValue*
MmsValue_newIntegerFromInt64(int64_t integer);
 
LIB61850_API MmsValue*
MmsValue_newUnsignedFromUint32(uint32_t integer);
 
LIB61850_API MmsValue*
MmsValue_newFloat(float value);
 
LIB61850_API MmsValue*
MmsValue_newDouble(double value);
 
LIB61850_API MmsValue*
MmsValue_clone(const MmsValue* self);
 
LIB61850_API uint8_t*
MmsValue_cloneToBuffer(const MmsValue* self, uint8_t* destinationAddress);
 
LIB61850_API int
MmsValue_getSizeInMemory(const MmsValue* self);
 
LIB61850_API void
MmsValue_delete(MmsValue* self);
 
LIB61850_API void
MmsValue_deleteConditional(MmsValue* value);
 
LIB61850_API MmsValue*
MmsValue_newVisibleString(const char* string);
 
LIB61850_API MmsValue*
MmsValue_newVisibleStringWithSize(int size);
 
LIB61850_API MmsValue*
MmsValue_newMmsStringWithSize(int size);
 
LIB61850_API MmsValue*
MmsValue_newBinaryTime(bool timeOfDay);
 
LIB61850_API MmsValue*
MmsValue_newVisibleStringFromByteArray(const uint8_t* byteArray, int size);
 
LIB61850_API MmsValue*
MmsValue_newMmsStringFromByteArray(const uint8_t* byteArray, int size);
 
LIB61850_API MmsValue*
MmsValue_newMmsString(const char* string);
 
LIB61850_API void
MmsValue_setMmsString(MmsValue* value, const char* string);
 
LIB61850_API MmsValue*
MmsValue_newUtcTime(uint32_t timeval);
 
LIB61850_API MmsValue*
MmsValue_newUtcTimeByMsTime(uint64_t timeval);
 
 
LIB61850_API void
MmsValue_setDeletable(MmsValue* self);
 
LIB61850_API void
MmsValue_setDeletableRecursive(MmsValue* value);
 
LIB61850_API int
MmsValue_isDeletable(MmsValue* self);
 
LIB61850_API MmsType
MmsValue_getType(const MmsValue* self);
 
LIB61850_API MmsValue*
MmsValue_getSubElement(MmsValue* self, MmsVariableSpecification* varSpec, char* mmsPath);
 
LIB61850_API char*
MmsValue_getTypeString(MmsValue* self);
 
LIB61850_API const char*
MmsValue_printToBuffer(const MmsValue* self, char* buffer, int bufferSize);
 
LIB61850_API MmsValue*
MmsValue_decodeMmsData(uint8_t* buffer, int bufPos, int bufferLength, int* endBufPos);
 
LIB61850_API MmsValue*
MmsValue_decodeMmsDataMaxRecursion(uint8_t* buffer, int bufPos, int bufferLength, int* endBufPos, int maxDepth);
 
LIB61850_API int
MmsValue_encodeMmsData(MmsValue* self, uint8_t* buffer, int bufPos, bool encode);
 
LIB61850_API int
MmsValue_getMaxEncodedSize(MmsValue* self);
 
LIB61850_API int
MmsVariableSpecification_getMaxEncodedSize(MmsVariableSpecification* self);
 
#ifdef __cplusplus
}
#endif
 
#endif /* MMS_VALUE_H_ */