/* * mms_server.c * * Copyright 2013 - 2016 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 . * * See COPYING file for the complete license text. */ #include "libiec61850_platform_includes.h" #include "mms_server.h" #include "mms_server_connection.h" #include "mms_value_cache.h" #include "mms_server_internal.h" #include "iso_server_private.h" static Map createValueCaches(MmsDevice* device) { Map valueCaches = Map_create(); int i; for (i = 0; i < device->domainCount; i++) { MmsValueCache valueCache = MmsValueCache_create(device->domains[i]); Map_addEntry(valueCaches, device->domains[i], valueCache); } #if (CONFIG_MMS_SUPPORT_VMD_SCOPE_NAMED_VARIABLES == 1) MmsValueCache valueCache = MmsValueCache_create((MmsDomain*) device); Map_addEntry(valueCaches, (MmsDomain*) device, valueCache); #endif return valueCaches; } MmsServer MmsServer_create(MmsDevice* device, TLSConfiguration tlsConfiguration) { MmsServer self = (MmsServer) GLOBAL_CALLOC(1, sizeof(struct sMmsServer)); self->isoServer = IsoServer_create(tlsConfiguration); self->device = device; self->openConnections = Map_create(); self->valueCaches = createValueCaches(device); self->isLocked = false; self->transmitBuffer = ByteBuffer_create(NULL, CONFIG_MMS_MAXIMUM_PDU_SIZE); #if (CONFIG_MMS_THREADLESS_STACK != 1) self->modelMutex = Semaphore_create(1); self->transmitBufferMutex = Semaphore_create(1); IsoServer_setUserLock(self->isoServer, self->modelMutex); #endif #if (CONFIG_MMS_SERVER_CONFIG_SERVICES_AT_RUNTIME == 1) self->fileServiceEnabled = true; self->dynamicVariableListServiceEnabled = true; self->journalServiceEnabled = true; #endif /* (CONFIG_MMS_SERVER_CONFIG_SERVICES_AT_RUNTIME == 1) */ return self; } void MmsServer_setLocalIpAddress(MmsServer self, const char* localIpAddress) { IsoServer_setLocalIpAddress(self->isoServer, localIpAddress); } bool MmsServer_isRunning(MmsServer self) { if (IsoServer_getState(self->isoServer) == ISO_SVR_STATE_RUNNING) return true; else return false; } void MmsServer_setFilestoreBasepath(MmsServer self, const char* basepath) { #if (CONFIG_SET_FILESTORE_BASEPATH_AT_RUNTIME == 1) if (self->filestoreBasepath != NULL) { GLOBAL_FREEMEM(self->filestoreBasepath); self->filestoreBasepath = NULL; } if (basepath != NULL) self->filestoreBasepath = StringUtils_copyString(basepath); #endif /* (CONFIG_SET_FILESTORE_BASEPATH_AT_RUNTIME == 1) */ } #if (CONFIG_MMS_SERVER_CONFIG_SERVICES_AT_RUNTIME == 1) void MmsServer_setMaxConnections(MmsServer self, int maxConnections) { IsoServer_setMaxConnections(self->isoServer, maxConnections); } void MmsServer_enableFileService(MmsServer self, bool enable) { self->fileServiceEnabled = enable; } void MmsServer_enableDynamicNamedVariableListService(MmsServer self, bool enable) { self->dynamicVariableListServiceEnabled = enable; } void MmsServer_enableJournalService(MmsServer self, bool enable) { self->journalServiceEnabled = enable; } #endif /* (CONFIG_MMS_SERVER_CONFIG_SERVICES_AT_RUNTIME == 1) */ void MmsServer_lockModel(MmsServer self) { #if (CONFIG_MMS_THREADLESS_STACK != 1) Semaphore_wait(self->modelMutex); #endif } void MmsServer_unlockModel(MmsServer self) { #if (CONFIG_MMS_THREADLESS_STACK != 1) Semaphore_post(self->modelMutex); #endif } ByteBuffer* MmsServer_reserveTransmitBuffer(MmsServer self) { #if (CONFIG_MMS_THREADLESS_STACK != 1) Semaphore_wait(self->transmitBufferMutex); #endif return self->transmitBuffer; } void MmsServer_releaseTransmitBuffer(MmsServer self) { #if (CONFIG_MMS_THREADLESS_STACK != 1) Semaphore_post(self->transmitBufferMutex); #endif self->transmitBuffer->size = 0; } #if (MMS_OBTAIN_FILE_SERVICE == 1) MmsObtainFileTask MmsServer_getObtainFileTask(MmsServer self) { int i; for (i = 0; i < CONFIG_MMS_SERVER_MAX_GET_FILE_TASKS; i++) { if (self->fileUploadTasks[i].state == 0) { self->fileUploadTasks[i].state = 1; return &(self->fileUploadTasks[i]); } } return NULL; } #endif /* (MMS_OBTAIN_FILE_SERVICE == 1) */ void MmsServer_installReadHandler(MmsServer self, MmsReadVariableHandler readHandler, void* parameter) { self->readHandler = readHandler; self->readHandlerParameter = parameter; } void MmsServer_installReadAccessHandler(MmsServer self, MmsReadAccessHandler readAccessHandler, void* parameter) { self->readAccessHandler = readAccessHandler; self->readAccessHandlerParameter = parameter; } void MmsServer_installWriteHandler(MmsServer self, MmsWriteVariableHandler writeHandler, void* parameter) { self->writeHandler = writeHandler; self->writeHandlerParameter = parameter; } void MmsServer_installConnectionHandler(MmsServer self, MmsConnectionHandler connectionHandler, void* parameter) { self->connectionHandler = connectionHandler; self->connectionHandlerParameter = parameter; } void MmsServer_installVariableListChangedHandler(MmsServer self, MmsNamedVariableListChangedHandler handler, void* parameter) { self->variableListChangedHandler = handler; self->variableListChangedHandlerParameter = parameter; } void MmsServer_setClientAuthenticator(MmsServer self, AcseAuthenticator authenticator, void* authenticatorParameter) { IsoServer_setAuthenticator(self->isoServer, authenticator, authenticatorParameter); } #if (MMS_FILE_SERVICE == 1) void MmsServer_installFileAccessHandler(MmsServer self, MmsFileAccessHandler handler, void* parameter) { self->fileAccessHandler = handler; self->fileAccessHandlerParameter = parameter; } #endif /* (MMS_FILE_SERVICE == 1) */ #if (MMS_OBTAIN_FILE_SERVICE == 1) void MmsServer_installObtainFileHandler(MmsServer self, MmsObtainFileHandler handler, void* parameter) { self->obtainFileHandler = handler; self->obtainFileHandlerParameter = parameter; } void MmsServer_installGetFileCompleteHandler(MmsServer self, MmsGetFileCompleteHandler handler, void* parameter) { self->getFileCompleteHandler = handler; self->getFileCompleteHandlerParameter = parameter; } #endif /* (MMS_OBTAIN_FILE_SERVICE == 1) */ static void closeConnection(void* con) { MmsServerConnection connection = (MmsServerConnection) con; MmsServerConnection_destroy(connection); } static void deleteSingleCache(MmsValueCache cache) { MmsValueCache_destroy(cache); } void MmsServer_destroy(MmsServer self) { IsoServer_destroy(self->isoServer); Map_deleteDeep(self->openConnections, false, closeConnection); Map_deleteDeep(self->valueCaches, false, (void (*) (void*)) deleteSingleCache); #if (CONFIG_MMS_THREADLESS_STACK != 1) Semaphore_destroy(self->modelMutex); Semaphore_destroy(self->transmitBufferMutex); #endif ByteBuffer_destroy(self->transmitBuffer); #if (CONFIG_SET_FILESTORE_BASEPATH_AT_RUNTIME == 1) if (self->filestoreBasepath != NULL) GLOBAL_FREEMEM(self->filestoreBasepath); #endif GLOBAL_FREEMEM(self); } MmsValue* MmsServer_getValueFromCache(MmsServer self, MmsDomain* domain, const char* itemId) { MmsValueCache cache = (MmsValueCache) Map_getEntry(self->valueCaches, domain); if (cache != NULL) return MmsValueCache_lookupValue(cache, itemId); return NULL ; } void MmsServer_insertIntoCache(MmsServer self, MmsDomain* domain, char* itemId, MmsValue* value) { MmsValueCache cache = (MmsValueCache) Map_getEntry(self->valueCaches, domain); if (cache != NULL) { MmsValueCache_insertValue(cache, itemId, value); } } MmsDataAccessError mmsServer_setValue(MmsServer self, MmsDomain* domain, char* itemId, MmsValue* value, MmsServerConnection connection) { MmsDataAccessError indication; if (self->writeHandler != NULL) { indication = self->writeHandler(self->writeHandlerParameter, domain, itemId, value, connection); } else { MmsValue* cachedValue; if (domain == NULL) domain = (MmsDomain*) self->device; cachedValue = MmsServer_getValueFromCache(self, domain, itemId); if (cachedValue != NULL) { MmsValue_update(cachedValue, value); indication = DATA_ACCESS_ERROR_SUCCESS; } else indication = DATA_ACCESS_ERROR_OBJECT_VALUE_INVALID; } return indication; } MmsValue* mmsServer_getValue(MmsServer self, MmsDomain* domain, char* itemId, MmsServerConnection connection) { MmsValue* value = NULL; if (self->readAccessHandler != NULL) { MmsDataAccessError accessError = self->readAccessHandler(self->readAccessHandlerParameter, (domain == (MmsDomain*) self->device) ? NULL : domain, itemId, connection); if (accessError != DATA_ACCESS_ERROR_SUCCESS) { value = MmsValue_newDataAccessError(accessError); MmsValue_setDeletable(value); goto exit_function; } } value = MmsServer_getValueFromCache(self, domain, itemId); if (value == NULL) if (self->readHandler != NULL) value = self->readHandler(self->readHandlerParameter, (domain == (MmsDomain*) self->device) ? NULL : domain, itemId, connection); exit_function: return value; } MmsDevice* MmsServer_getDevice(MmsServer self) { return self->device; } static void /* will be called by ISO server stack */ isoConnectionIndicationHandler(IsoConnectionIndication indication, void* parameter, IsoConnection connection) { MmsServer mmsServer = (MmsServer) parameter; if (indication == ISO_CONNECTION_OPENED) { MmsServerConnection mmsCon = MmsServerConnection_init(0, mmsServer, connection); Map_addEntry(mmsServer->openConnections, connection, mmsCon); if (mmsServer->connectionHandler != NULL) mmsServer->connectionHandler(mmsServer->connectionHandlerParameter, mmsCon, MMS_SERVER_NEW_CONNECTION); } else if (indication == ISO_CONNECTION_CLOSED) { MmsServerConnection mmsCon = (MmsServerConnection) Map_removeEntry(mmsServer->openConnections, connection, false); if (mmsServer->connectionHandler != NULL) mmsServer->connectionHandler(mmsServer->connectionHandlerParameter, mmsCon, MMS_SERVER_CONNECTION_CLOSED); if (mmsCon != NULL) MmsServerConnection_destroy(mmsCon); } } #if (CONFIG_MMS_THREADLESS_STACK != 1) void MmsServer_startListening(MmsServer server, int tcpPort) { IsoServer_setConnectionHandler(server->isoServer, isoConnectionIndicationHandler, (void*) server); if (tcpPort != -1) IsoServer_setTcpPort(server->isoServer, tcpPort); IsoServer_startListening(server->isoServer); } void MmsServer_stopListening(MmsServer server) { IsoServer_stopListening(server->isoServer); } #endif /* (CONFIG_MMS_THREADLESS_STACK != 1)*/ void MmsServer_startListeningThreadless(MmsServer self, int tcpPort) { IsoServer_setConnectionHandler(self->isoServer, isoConnectionIndicationHandler, (void*) self); if (tcpPort != -1) IsoServer_setTcpPort(self->isoServer, tcpPort); IsoServer_startListeningThreadless(self->isoServer); } int MmsServer_waitReady(MmsServer self, unsigned int timeoutMs) { return IsoServer_waitReady(self->isoServer, timeoutMs); } void MmsServer_handleIncomingMessages(MmsServer self) { IsoServer_processIncomingMessages(self->isoServer); } void MmsServer_handleBackgroundTasks(MmsServer self) { #if (MMS_OBTAIN_FILE_SERVICE == 1) int i; for (i = 0; i < CONFIG_MMS_SERVER_MAX_GET_FILE_TASKS; i++) { if (self->fileUploadTasks[i].state != 0) mmsServer_fileUploadTask(self, &(self->fileUploadTasks[i])); } #endif /* (MMS_OBTAIN_FILE_SERVICE == 1) */ } void MmsServer_stopListeningThreadless(MmsServer self) { IsoServer_stopListeningThreadless(self->isoServer); }