iec61850_client.h

Go to the documentation of this file.

/*
 *  iec61850_client.h
 *
 *  Copyright 2013, 2014, 2015 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 IEC61850_CLIENT_H_
#define IEC61850_CLIENT_H_

#ifdef __cplusplus
extern "C" {
#endif

#include "libiec61850_common_api.h"
#include "iec61850_common.h"
#include "mms_value.h"
#include "mms_client_connection.h"
#include "linked_list.h"

#ifndef DEPRECATED
#if defined(__GNUC__) || defined(__clang__)
  #define DEPRECATED __attribute__((deprecated))
#else
  #define DEPRECATED
#endif
#endif

typedef struct sClientDataSet* ClientDataSet;

typedef struct sClientReport* ClientReport;

typedef struct sClientReportControlBlock* ClientReportControlBlock;

typedef struct sClientGooseControlBlock* ClientGooseControlBlock;

typedef struct sIedConnection* IedConnection;

typedef struct
{
    int ctlNum;
    int error;
    ControlAddCause addCause;
} LastApplError;

typedef enum
{
    IED_STATE_IDLE,
    IED_STATE_CONNECTED,
    IED_STATE_CLOSED
} IedConnectionState;

typedef enum {
    /* general errors */

    IED_ERROR_OK = 0,

    IED_ERROR_NOT_CONNECTED = 1,

    IED_ERROR_ALREADY_CONNECTED = 2,

    IED_ERROR_CONNECTION_LOST = 3,

    IED_ERROR_SERVICE_NOT_SUPPORTED = 4,

    IED_ERROR_CONNECTION_REJECTED = 5,

    /* client side errors */

    IED_ERROR_USER_PROVIDED_INVALID_ARGUMENT = 10,

    IED_ERROR_ENABLE_REPORT_FAILED_DATASET_MISMATCH = 11,

    IED_ERROR_OBJECT_REFERENCE_INVALID = 12,

    IED_ERROR_UNEXPECTED_VALUE_RECEIVED = 13,

    /* service error - error reported by server */

    IED_ERROR_TIMEOUT = 20,

    IED_ERROR_ACCESS_DENIED = 21,

    IED_ERROR_OBJECT_DOES_NOT_EXIST = 22,

    IED_ERROR_OBJECT_EXISTS = 23,

    IED_ERROR_OBJECT_ACCESS_UNSUPPORTED = 24,

    IED_ERROR_TYPE_INCONSISTENT = 25,

    IED_ERROR_TEMPORARILY_UNAVAILABLE = 26,

    IED_ERROR_OBJECT_UNDEFINED = 27,

    IED_ERROR_INVALID_ADDRESS = 28,

    IED_ERROR_HARDWARE_FAULT = 29,

    IED_ERROR_TYPE_UNSUPPORTED = 30,

    IED_ERROR_OBJECT_ATTRIBUTE_INCONSISTENT = 31,

    IED_ERROR_OBJECT_VALUE_INVALID = 32,

    IED_ERROR_OBJECT_INVALIDATED = 33,

    IED_ERROR_SERVICE_NOT_IMPLEMENTED = 98,

    IED_ERROR_UNKNOWN = 99
} IedClientError;

/**************************************************
 * Connection creation and destruction
 **************************************************/

IedConnection
IedConnection_create(void);

IedConnection
IedConnection_createWithTlsSupport(TLSConfiguration tlsConfig);

void
IedConnection_destroy(IedConnection self);


void
IedConnection_setConnectTimeout(IedConnection self, uint32_t timeoutInMs);

/**************************************************
 * Association service
 **************************************************/

void
IedConnection_connect(IedConnection self, IedClientError* error, const char* hostname, int tcpPort);

void
IedConnection_abort(IedConnection self, IedClientError* error);

void
IedConnection_release(IedConnection self, IedClientError* error);

void
IedConnection_close(IedConnection self);

IedConnectionState
IedConnection_getState(IedConnection self);

LastApplError
IedConnection_getLastApplError(IedConnection self);


typedef void (*IedConnectionClosedHandler) (void* parameter, IedConnection connection);

void
IedConnection_installConnectionClosedHandler(IedConnection self, IedConnectionClosedHandler handler,
        void* parameter);

MmsConnection
IedConnection_getMmsConnection(IedConnection self);

#define IEC61850_SV_OPT_REFRESH_TIME 1

#define IEC61850_SV_OPT_SAMPLE_SYNC 2

#define IEC61850_SV_OPT_SAMPLE_RATE 4

#define IEC61850_SV_OPT_DATA_SET 8

#define IEC61850_SV_OPT_SECURITY 16

#define IEC61850_SV_SMPMOD_SAMPLES_PER_PERIOD 0

#define IEC61850_SV_SMPMOD_SAMPLES_PER_SECOND 1

#define IEC61850_SV_SMPMOD_SECONDS_PER_SAMPLE 2


typedef struct sClientSVControlBlock* ClientSVControlBlock;

ClientSVControlBlock
ClientSVControlBlock_create(IedConnection connection, const char* reference);

void
ClientSVControlBlock_destroy(ClientSVControlBlock self);

bool
ClientSVControlBlock_isMulticast(ClientSVControlBlock self);

IedClientError
ClientSVControlBlock_getLastComError(ClientSVControlBlock self);


bool
ClientSVControlBlock_setSvEna(ClientSVControlBlock self, bool value);

bool
ClientSVControlBlock_getSvEna(ClientSVControlBlock self);

bool
ClientSVControlBlock_setResv(ClientSVControlBlock self, bool value);

bool
ClientSVControlBlock_getResv(ClientSVControlBlock self);

char*
ClientSVControlBlock_getMsvID(ClientSVControlBlock self);

char*
ClientSVControlBlock_getDatSet(ClientSVControlBlock self);

uint32_t
ClientSVControlBlock_getConfRev(ClientSVControlBlock self);

uint16_t
ClientSVControlBlock_getSmpRate(ClientSVControlBlock self);


PhyComAddress
ClientSVControlBlock_getDstAddress(ClientSVControlBlock self);

int
ClientSVControlBlock_getOptFlds(ClientSVControlBlock self);

uint8_t
ClientSVControlBlock_getSmpMod(ClientSVControlBlock self);

int
ClientSVControlBlock_getNoASDU(ClientSVControlBlock self);


/*********************************************************
 * GOOSE services handling (MMS part)
 ********************************************************/

#define GOCB_ELEMENT_GO_ENA       1

#define GOCB_ELEMENT_GO_ID        2

#define GOCB_ELEMENT_DATSET       4

#define GOCB_ELEMENT_CONF_REV     8

#define GOCB_ELEMENT_NDS_COMM    16

#define GOCB_ELEMENT_DST_ADDRESS 32

#define GOCB_ELEMENT_MIN_TIME    64

#define GOCB_ELEMENT_MAX_TIME   128

#define GOCB_ELEMENT_FIXED_OFFS 256

#define GOCB_ELEMENT_ALL        511


/**************************************************
 * ClientGooseControlBlock class
 **************************************************/

ClientGooseControlBlock
ClientGooseControlBlock_create(const char* dataAttributeReference);

void
ClientGooseControlBlock_destroy(ClientGooseControlBlock self);

bool
ClientGooseControlBlock_getGoEna(ClientGooseControlBlock self);

void
ClientGooseControlBlock_setGoEna(ClientGooseControlBlock self, bool goEna);

const char*
ClientGooseControlBlock_getGoID(ClientGooseControlBlock self);

void
ClientGooseControlBlock_setGoID(ClientGooseControlBlock self, const char* goID);

const char*
ClientGooseControlBlock_getDatSet(ClientGooseControlBlock self);

void
ClientGooseControlBlock_setDatSet(ClientGooseControlBlock self, const char* datSet);

uint32_t
ClientGooseControlBlock_getConfRev(ClientGooseControlBlock self);

bool
ClientGooseControlBlock_getNdsComm(ClientGooseControlBlock self);

uint32_t
ClientGooseControlBlock_getMinTime(ClientGooseControlBlock self);

uint32_t
ClientGooseControlBlock_getMaxTime(ClientGooseControlBlock self);

bool
ClientGooseControlBlock_getFixedOffs(ClientGooseControlBlock self);

PhyComAddress
ClientGooseControlBlock_getDstAddress(ClientGooseControlBlock self);

void
ClientGooseControlBlock_setDstAddress(ClientGooseControlBlock self, PhyComAddress value);

DEPRECATED MmsValue* /* MMS_OCTET_STRING */
ClientGooseControlBlock_getDstAddress_addr(ClientGooseControlBlock self);

DEPRECATED void
ClientGooseControlBlock_setDstAddress_addr(ClientGooseControlBlock self, MmsValue* macAddr);

DEPRECATED uint8_t
ClientGooseControlBlock_getDstAddress_priority(ClientGooseControlBlock self);

DEPRECATED void
ClientGooseControlBlock_setDstAddress_priority(ClientGooseControlBlock self, uint8_t priorityValue);

DEPRECATED uint16_t
ClientGooseControlBlock_getDstAddress_vid(ClientGooseControlBlock self);

DEPRECATED void
ClientGooseControlBlock_setDstAddress_vid(ClientGooseControlBlock self, uint16_t vidValue);

DEPRECATED uint16_t
ClientGooseControlBlock_getDstAddress_appid(ClientGooseControlBlock self);

DEPRECATED void
ClientGooseControlBlock_setDstAddress_appid(ClientGooseControlBlock self, uint16_t appidValue);


/*********************************************************
 * GOOSE services (access to GOOSE Control Blocks (GoCB))
 ********************************************************/

ClientGooseControlBlock
IedConnection_getGoCBValues(IedConnection self, IedClientError* error, const char* goCBReference, ClientGooseControlBlock updateGoCB);

void
IedConnection_setGoCBValues(IedConnection self, IedClientError* error, ClientGooseControlBlock goCB,
        uint32_t parametersMask, bool singleRequest);

/********************************************
 * Reporting services
 ********************************************/

ClientReportControlBlock
IedConnection_getRCBValues(IedConnection self, IedClientError* error, const char* rcbReference,
        ClientReportControlBlock updateRcb);

typedef enum {
    IEC61850_REASON_NOT_INCLUDED = 0,

    IEC61850_REASON_DATA_CHANGE = 1,

    IEC61850_REASON_QUALITY_CHANGE = 2,

    IEC61850_REASON_DATA_UPDATE = 3,

    IEC61850_REASON_INTEGRITY = 4,

    IEC61850_REASON_GI = 5,

    IEC61850_REASON_UNKNOWN = 6
} ReasonForInclusion;

#define REASON_NOT_INCLUDED IEC61850_REASON_NOT_INCLUDED
#define REASON_DATA_CHANGE IEC61850_REASON_DATA_CHANGE
#define REASON_QUALITY_CHANGE IEC61850_REASON_QUALITY_CHANGE
#define REASON_DATA_UPDATE IEC61850_REASON_DATA_UPDATE
#define REASON_INTEGRITY IEC61850_REASON_INTEGRITY
#define REASON_GI IEC61850_REASON_GI
#define REASON_UNKNOWN IEC61850_REASON_UNKNOWN


/* Element encoding mask values for ClientReportControlBlock */

#define RCB_ELEMENT_RPT_ID            1

#define RCB_ELEMENT_RPT_ENA           2

#define RCB_ELEMENT_RESV              4

#define RCB_ELEMENT_DATSET            8

#define RCB_ELEMENT_CONF_REV         16

#define RCB_ELEMENT_OPT_FLDS         32

#define RCB_ELEMENT_BUF_TM           64

#define RCB_ELEMENT_SQ_NUM          128

#define RCB_ELEMENT_TRG_OPS         256

#define RCB_ELEMENT_INTG_PD         512

#define RCB_ELEMENT_GI             1024

#define RCB_ELEMENT_PURGE_BUF      2048

#define RCB_ELEMENT_ENTRY_ID       4096

#define RCB_ELEMENT_TIME_OF_ENTRY  8192

#define RCB_ELEMENT_RESV_TMS      16384

#define RCB_ELEMENT_OWNER         32768

void
IedConnection_setRCBValues(IedConnection self, IedClientError* error, ClientReportControlBlock rcb,
        uint32_t parametersMask, bool singleRequest);

typedef void (*ReportCallbackFunction) (void* parameter, ClientReport report);

void
IedConnection_installReportHandler(IedConnection self, const char* rcbReference, const char* rptId, ReportCallbackFunction handler,
        void* handlerParameter);

void
IedConnection_uninstallReportHandler(IedConnection self, const char* rcbReference);

void
IedConnection_triggerGIReport(IedConnection self, IedClientError* error, const char* rcbReference);

/****************************************
 * Access to received reports
 ****************************************/

const char*
ClientReport_getDataSetName(ClientReport self);

MmsValue*
ClientReport_getDataSetValues(ClientReport self);

char*
ClientReport_getRcbReference(ClientReport self);

char*
ClientReport_getRptId(ClientReport self);

ReasonForInclusion
ClientReport_getReasonForInclusion(ClientReport self, int elementIndex);

MmsValue*
ClientReport_getEntryId(ClientReport self);

bool
ClientReport_hasTimestamp(ClientReport self);

bool
ClientReport_hasSeqNum(ClientReport self);

uint16_t
ClientReport_getSeqNum(ClientReport self);

bool
ClientReport_hasDataSetName(ClientReport self);

bool
ClientReport_hasReasonForInclusion(ClientReport self);

bool
ClientReport_hasConfRev(ClientReport self);

uint32_t
ClientReport_getConfRev(ClientReport self);

bool
ClientReport_hasBufOvfl(ClientReport self);

bool
ClientReport_getBufOvfl(ClientReport self);

bool
ClientReport_hasDataReference(ClientReport self);

const char*
ClientReport_getDataReference(ClientReport self, int elementIndex);


uint64_t
ClientReport_getTimestamp(ClientReport self);

char*
ReasonForInclusion_getValueAsString(ReasonForInclusion reasonCode);

/**************************************************
 * ClientReportControlBlock access class
 **************************************************/

ClientReportControlBlock
ClientReportControlBlock_create(const char* rcbReference);

void
ClientReportControlBlock_destroy(ClientReportControlBlock self);

char*
ClientReportControlBlock_getObjectReference(ClientReportControlBlock self);

bool
ClientReportControlBlock_isBuffered(ClientReportControlBlock self);

const char*
ClientReportControlBlock_getRptId(ClientReportControlBlock self);

void
ClientReportControlBlock_setRptId(ClientReportControlBlock self, const char* rptId);

bool
ClientReportControlBlock_getRptEna(ClientReportControlBlock self);

void
ClientReportControlBlock_setRptEna(ClientReportControlBlock self, bool rptEna);

bool
ClientReportControlBlock_getResv(ClientReportControlBlock self);

void
ClientReportControlBlock_setResv(ClientReportControlBlock self, bool resv);

const char*
ClientReportControlBlock_getDataSetReference(ClientReportControlBlock self);

void
ClientReportControlBlock_setDataSetReference(ClientReportControlBlock self, const char* dataSetReference);

uint32_t
ClientReportControlBlock_getConfRev(ClientReportControlBlock self);

int
ClientReportControlBlock_getOptFlds(ClientReportControlBlock self);

void
ClientReportControlBlock_setOptFlds(ClientReportControlBlock self, int optFlds);

uint32_t
ClientReportControlBlock_getBufTm(ClientReportControlBlock self);

void
ClientReportControlBlock_setBufTm(ClientReportControlBlock self, uint32_t bufTm);

uint16_t
ClientReportControlBlock_getSqNum(ClientReportControlBlock self);

int
ClientReportControlBlock_getTrgOps(ClientReportControlBlock self);

void
ClientReportControlBlock_setTrgOps(ClientReportControlBlock self, int trgOps);

uint32_t
ClientReportControlBlock_getIntgPd(ClientReportControlBlock self);

void
ClientReportControlBlock_setIntgPd(ClientReportControlBlock self, uint32_t intgPd);

bool
ClientReportControlBlock_getGI(ClientReportControlBlock self);

void
ClientReportControlBlock_setGI(ClientReportControlBlock self, bool gi);

bool
ClientReportControlBlock_getPurgeBuf(ClientReportControlBlock self);

void
ClientReportControlBlock_setPurgeBuf(ClientReportControlBlock self, bool purgeBuf);

int16_t
ClientReportControlBlock_getResvTms(ClientReportControlBlock self);

void
ClientReportControlBlock_setResvTms(ClientReportControlBlock self, int16_t resvTms);

MmsValue* /* <MMS_OCTET_STRING> */
ClientReportControlBlock_getEntryId(ClientReportControlBlock self);

void
ClientReportControlBlock_setEntryId(ClientReportControlBlock self, MmsValue* entryId);

uint64_t
ClientReportControlBlock_getEntryTime(ClientReportControlBlock self);

MmsValue* /* <MMS_OCTET_STRING> */
ClientReportControlBlock_getOwner(ClientReportControlBlock self);


/****************************************
 * Data model access services
 ****************************************/

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

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


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

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

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

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

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

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

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

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

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

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

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

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

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);

/****************************************
 * Data set handling
 ****************************************/

ClientDataSet
IedConnection_readDataSetValues(IedConnection self, IedClientError* error, const char* dataSetReference, ClientDataSet dataSet);

void
IedConnection_createDataSet(IedConnection self, IedClientError* error, const char* dataSetReference, LinkedList /* char* */ dataSetElements);

bool
IedConnection_deleteDataSet(IedConnection self, IedClientError* error, const char* dataSetReference);


LinkedList /* <char*> */
IedConnection_getDataSetDirectory(IedConnection self, IedClientError* error, const char* dataSetReference, bool* isDeletable);

void
IedConnection_writeDataSetValues(IedConnection self, IedClientError* error, const char* dataSetReference,
        LinkedList/*<MmsValue*>*/ values, /* OUTPUT */LinkedList* /* <MmsValue*> */accessResults);


/********************************************************
 * Data set object (local representation of a data set)
 *******************************************************/

void
ClientDataSet_destroy(ClientDataSet self);

MmsValue*
ClientDataSet_getValues(ClientDataSet self);

char*
ClientDataSet_getReference(ClientDataSet self);

int
ClientDataSet_getDataSetSize(ClientDataSet self);

/************************************
 *  Control service functions
 ************************************/

typedef struct sControlObjectClient* ControlObjectClient;

typedef enum {
        CONTROL_MODEL_STATUS_ONLY,
        CONTROL_MODEL_DIRECT_NORMAL,
        CONTROL_MODEL_SBO_NORMAL,
        CONTROL_MODEL_DIRECT_ENHANCED,
        CONTROL_MODEL_SBO_ENHANCED
} ControlModel;


ControlObjectClient
ControlObjectClient_create(const char* objectReference, IedConnection connection);

void
ControlObjectClient_destroy(ControlObjectClient self);

char*
ControlObjectClient_getObjectReference(ControlObjectClient self);

ControlModel
ControlObjectClient_getControlModel(ControlObjectClient self);

bool
ControlObjectClient_operate(ControlObjectClient self, MmsValue* ctlVal, uint64_t operTime);

bool
ControlObjectClient_select(ControlObjectClient self);

bool
ControlObjectClient_selectWithValue(ControlObjectClient self, MmsValue* ctlVal);

bool
ControlObjectClient_cancel(ControlObjectClient self);

void
ControlObjectClient_setLastApplError(ControlObjectClient self, LastApplError lastAppIError);

LastApplError
ControlObjectClient_getLastApplError(ControlObjectClient self);

void
ControlObjectClient_setTestMode(ControlObjectClient self, bool value);

void
ControlObjectClient_setOrigin(ControlObjectClient self, const char* orIdent, int orCat);

void
ControlObjectClient_useConstantT(ControlObjectClient self, bool useConstantT);

void
ControlObjectClient_enableInterlockCheck(ControlObjectClient self);

void
ControlObjectClient_enableSynchroCheck(ControlObjectClient self);

void
ControlObjectClient_setInterlockCheck(ControlObjectClient self, bool value);

void
ControlObjectClient_setSynchroCheck(ControlObjectClient self, bool value);


typedef void (*CommandTerminationHandler) (void* parameter, ControlObjectClient controlClient);

void
ControlObjectClient_setCommandTerminationHandler(ControlObjectClient self, CommandTerminationHandler handler,
        void* handlerParameter);

/*************************************
 * Model discovery services
 ************************************/

void
IedConnection_getDeviceModelFromServer(IedConnection self, IedClientError* error);

LinkedList /*<char*>*/
IedConnection_getLogicalDeviceList(IedConnection self, IedClientError* error);

LinkedList /*<char*>*/
IedConnection_getServerDirectory(IedConnection self, IedClientError* error, bool getFileNames);

LinkedList /*<char*>*/
IedConnection_getLogicalDeviceDirectory(IedConnection self, IedClientError* error, const char* logicalDeviceName);

typedef enum {
    ACSI_CLASS_DATA_OBJECT,
    ACSI_CLASS_DATA_SET,
    ACSI_CLASS_BRCB,
    ACSI_CLASS_URCB,
    ACSI_CLASS_LCB,
    ACSI_CLASS_LOG,
    ACSI_CLASS_SGCB,
    ACSI_CLASS_GoCB,
    ACSI_CLASS_GsCB,
    ACSI_CLASS_MSVCB,
    ACSI_CLASS_USVCB
} ACSIClass;

LinkedList /*<char*>*/
IedConnection_getLogicalNodeVariables(IedConnection self, IedClientError* error,
                const char* logicalNodeReference);

LinkedList /*<char*>*/
IedConnection_getLogicalNodeDirectory(IedConnection self, IedClientError* error,
                const char* logicalNodeReference, ACSIClass acsiClass);

LinkedList /*<char*>*/
IedConnection_getDataDirectory(IedConnection self, IedClientError* error, const char* dataReference);

LinkedList /*<char*>*/
IedConnection_getDataDirectoryFC(IedConnection self, IedClientError* error, const char* dataReference);

LinkedList
IedConnection_getDataDirectoryByFC(IedConnection self, IedClientError* error, const char* dataReference, FunctionalConstraint fc);

MmsVariableSpecification*
IedConnection_getVariableSpecification(IedConnection self, IedClientError* error, const char* dataAttributeReference,
        FunctionalConstraint fc);

LinkedList /* <MmsJournalEntry> */
IedConnection_queryLogByTime(IedConnection self, IedClientError* error, const char* logReference,
        uint64_t startTime, uint64_t endTime, bool* moreFollows);

LinkedList /* <MmsJournalEntry> */
IedConnection_queryLogAfter(IedConnection self, IedClientError* error, const char* logReference,
        MmsValue* entryID, uint64_t timeStamp, bool* moreFollows);



typedef struct sFileDirectoryEntry* FileDirectoryEntry;

FileDirectoryEntry
FileDirectoryEntry_create(const char* fileName, uint32_t fileSize, uint64_t lastModified);

void
FileDirectoryEntry_destroy(FileDirectoryEntry self);

char*
FileDirectoryEntry_getFileName(FileDirectoryEntry self);

uint32_t
FileDirectoryEntry_getFileSize(FileDirectoryEntry self);

uint64_t
FileDirectoryEntry_getLastModified(FileDirectoryEntry self);


LinkedList /*<FileDirectoryEntry>*/
IedConnection_getFileDirectory(IedConnection self, IedClientError* error, const char* directoryName);


LinkedList /*<FileDirectoryEntry>*/
IedConnection_getFileDirectoryEx(IedConnection self, IedClientError* error, const char* directoryName, const char* continueAfter,
        bool* moreFollows);

typedef bool
(*IedClientGetFileHandler) (void* parameter, uint8_t* buffer, uint32_t bytesRead);

uint32_t
IedConnection_getFile(IedConnection self, IedClientError* error, const char* fileName, IedClientGetFileHandler handler,
        void* handlerParameter);

void
IedConnection_setFilestoreBasepath(IedConnection, const char* basepath);

void
IedConnection_setFile(IedConnection self, IedClientError* error, const char* sourceFilename, const char* destinationFilename);


void
IedConnection_deleteFile(IedConnection self, IedClientError* error, const char* fileName);


#ifdef __cplusplus
}
#endif


#endif /* IEC61850_CLIENT_H_ */