.clang-format

@@ -0,0 +1,192 @@
+---
+Language:        Cpp
+# BasedOnStyle:  Microsoft
+AccessModifierOffset: -2
+AlignAfterOpenBracket: Align
+AlignArrayOfStructures: None
+AlignConsecutiveMacros: None
+AlignConsecutiveAssignments: None
+AlignConsecutiveBitFields: None
+AlignConsecutiveDeclarations: None
+AlignEscapedNewlines: Right
+AlignOperands:   Align
+AlignTrailingComments: true
+AllowAllArgumentsOnNextLine: true
+AllowAllParametersOfDeclarationOnNextLine: true
+AllowShortEnumsOnASingleLine: false
+AllowShortBlocksOnASingleLine: Never
+AllowShortCaseLabelsOnASingleLine: false
+AllowShortFunctionsOnASingleLine: None
+AllowShortLambdasOnASingleLine: All
+AllowShortIfStatementsOnASingleLine: Never
+AllowShortLoopsOnASingleLine: false
+AlwaysBreakAfterDefinitionReturnType: None
+AlwaysBreakAfterReturnType: All
+AlwaysBreakBeforeMultilineStrings: false
+AlwaysBreakTemplateDeclarations: MultiLine
+AttributeMacros:
+  - __capability
+BinPackArguments: true
+BinPackParameters: true
+BraceWrapping:
+  AfterCaseLabel:  false
+  AfterClass:      true
+  AfterControlStatement: Always
+  AfterEnum:       true
+  AfterFunction:   true
+  AfterNamespace:  true
+  AfterObjCDeclaration: true
+  AfterStruct:     true
+  AfterUnion:      false
+  AfterExternBlock: true
+  BeforeCatch:     true
+  BeforeElse:      true
+  BeforeLambdaBody: false
+  BeforeWhile:     false
+  IndentBraces:    false
+  SplitEmptyFunction: true
+  SplitEmptyRecord: true
+  SplitEmptyNamespace: true
+BreakBeforeBinaryOperators: None
+BreakBeforeConceptDeclarations: true
+BreakBeforeBraces: Custom
+BreakBeforeInheritanceComma: false
+BreakInheritanceList: BeforeColon
+BreakBeforeTernaryOperators: true
+BreakConstructorInitializersBeforeComma: false
+BreakConstructorInitializers: BeforeColon
+BreakAfterJavaFieldAnnotations: false
+BreakStringLiterals: true
+ColumnLimit:     120
+CommentPragmas:  '^ IWYU pragma:'
+QualifierAlignment: Leave
+CompactNamespaces: false
+ConstructorInitializerIndentWidth: 4
+ContinuationIndentWidth: 4
+Cpp11BracedListStyle: true
+DeriveLineEnding: true
+DerivePointerAlignment: false
+DisableFormat:   false
+EmptyLineAfterAccessModifier: Never
+EmptyLineBeforeAccessModifier: LogicalBlock
+ExperimentalAutoDetectBinPacking: false
+PackConstructorInitializers: BinPack
+BasedOnStyle:    ''
+ConstructorInitializerAllOnOneLineOrOnePerLine: false
+AllowAllConstructorInitializersOnNextLine: true
+FixNamespaceComments: true
+ForEachMacros:
+  - foreach
+  - Q_FOREACH
+  - BOOST_FOREACH
+IfMacros:
+  - KJ_IF_MAYBE
+IncludeBlocks:   Preserve
+IncludeCategories:
+  - Regex:           '^"(llvm|llvm-c|clang|clang-c)/'
+    Priority:        2
+    SortPriority:    0
+    CaseSensitive:   false
+  - Regex:           '^(<|"(gtest|gmock|isl|json)/)'
+    Priority:        3
+    SortPriority:    0
+    CaseSensitive:   false
+  - Regex:           '.*'
+    Priority:        1
+    SortPriority:    0
+    CaseSensitive:   false
+IncludeIsMainRegex: '(Test)?$'
+IncludeIsMainSourceRegex: ''
+IndentAccessModifiers: false
+IndentCaseLabels: false
+IndentCaseBlocks: false
+IndentGotoLabels: true
+IndentPPDirectives: None
+IndentExternBlock: NoIndent
+IndentRequires:  false
+IndentWidth:     4
+IndentWrappedFunctionNames: false
+InsertTrailingCommas: None
+JavaScriptQuotes: Leave
+JavaScriptWrapImports: true
+KeepEmptyLinesAtTheStartOfBlocks: true
+LambdaBodyIndentation: Signature
+MacroBlockBegin: ''
+MacroBlockEnd:   ''
+MaxEmptyLinesToKeep: 1
+NamespaceIndentation: None
+ObjCBinPackProtocolList: Auto
+ObjCBlockIndentWidth: 2
+ObjCBreakBeforeNestedBlockParam: true
+ObjCSpaceAfterProperty: false
+ObjCSpaceBeforeProtocolList: true
+PenaltyBreakAssignment: 2
+PenaltyBreakBeforeFirstCallParameter: 19
+PenaltyBreakComment: 300
+PenaltyBreakFirstLessLess: 120
+PenaltyBreakOpenParenthesis: 0
+PenaltyBreakString: 1000
+PenaltyBreakTemplateDeclaration: 10
+PenaltyExcessCharacter: 1000000
+PenaltyReturnTypeOnItsOwnLine: 1000
+PenaltyIndentedWhitespace: 0
+PointerAlignment: Left
+PPIndentWidth:   -1
+ReferenceAlignment: Pointer
+ReflowComments:  true
+RemoveBracesLLVM: false
+SeparateDefinitionBlocks: Leave
+ShortNamespaceLines: 1
+SortIncludes:    CaseSensitive
+SortJavaStaticImport: Before
+SortUsingDeclarations: true
+SpaceAfterCStyleCast: false
+SpaceAfterLogicalNot: false
+SpaceAfterTemplateKeyword: true
+SpaceBeforeAssignmentOperators: true
+SpaceBeforeCaseColon: false
+SpaceBeforeCpp11BracedList: false
+SpaceBeforeCtorInitializerColon: true
+SpaceBeforeInheritanceColon: true
+SpaceBeforeParens: ControlStatements
+SpaceBeforeParensOptions:
+  AfterControlStatements: true
+  AfterForeachMacros: true
+  AfterFunctionDefinitionName: false
+  AfterFunctionDeclarationName: false
+  AfterIfMacros:   true
+  AfterOverloadedOperator: false
+  BeforeNonEmptyParentheses: false
+SpaceAroundPointerQualifiers: Default
+SpaceBeforeRangeBasedForLoopColon: true
+SpaceInEmptyBlock: false
+SpaceInEmptyParentheses: false
+SpacesBeforeTrailingComments: 1
+SpacesInAngles:  Never
+SpacesInConditionalStatement: false
+SpacesInContainerLiterals: true
+SpacesInCStyleCastParentheses: false
+SpacesInLineCommentPrefix:
+  Minimum:         1
+  Maximum:         -1
+SpacesInParentheses: false
+SpacesInSquareBrackets: false
+SpaceBeforeSquareBrackets: false
+BitFieldColonSpacing: Both
+Standard:        Latest
+StatementAttributeLikeMacros:
+  - Q_EMIT
+StatementMacros:
+  - Q_UNUSED
+  - QT_REQUIRE_VERSION
+TabWidth:        4
+UseCRLF:         false
+UseTab:          Never
+WhitespaceSensitiveMacros:
+  - STRINGIZE
+  - PP_STRINGIZE
+  - BOOST_PP_STRINGIZE
+  - NS_SWIFT_NAME
+  - CF_SWIFT_NAME
+...
+

.github/workflows/main.yml

@@ -0,0 +1,51 @@
+name: Build
+on:
+  push:
+    branches:
+      - master
+  pull_request:
+    types: [opened, synchronize, reopened]
+jobs:
+  build:
+    name: Build
+    runs-on: ubuntu-latest
+    env:
+      SONAR_SCANNER_VERSION: 4.7.0.2747
+      SONAR_SERVER_URL: "https://sonarcloud.io"
+      BUILD_WRAPPER_OUT_DIR: build_wrapper_output_directory # Directory where build-wrapper output will be placed
+    steps:
+      - uses: actions/checkout@v2
+        with:
+          fetch-depth: 0  # Shallow clones should be disabled for a better relevancy of analysis
+      - name: Set up JDK 11
+        uses: actions/setup-java@v1
+        with:
+          java-version: 11
+      - name: Download and set up sonar-scanner
+        env:
+          SONAR_SCANNER_DOWNLOAD_URL: https://binaries.sonarsource.com/Distribution/sonar-scanner-cli/sonar-scanner-cli-${{ env.SONAR_SCANNER_VERSION }}-linux.zip
+        run: |
+          mkdir -p $HOME/.sonar
+          curl -sSLo $HOME/.sonar/sonar-scanner.zip ${{ env.SONAR_SCANNER_DOWNLOAD_URL }} 
+          unzip -o $HOME/.sonar/sonar-scanner.zip -d $HOME/.sonar/
+          echo "$HOME/.sonar/sonar-scanner-${{ env.SONAR_SCANNER_VERSION }}-linux/bin" >> $GITHUB_PATH
+      - name: Download and set up build-wrapper
+        env:
+          BUILD_WRAPPER_DOWNLOAD_URL: ${{ env.SONAR_SERVER_URL }}/static/cpp/build-wrapper-linux-x86.zip
+        run: |
+          curl -sSLo $HOME/.sonar/build-wrapper-linux-x86.zip ${{ env.BUILD_WRAPPER_DOWNLOAD_URL }}
+          unzip -o $HOME/.sonar/build-wrapper-linux-x86.zip -d $HOME/.sonar/
+          echo "$HOME/.sonar/build-wrapper-linux-x86" >> $GITHUB_PATH
+      - name: Run build-wrapper
+        run: |
+          cd lib60870-C
+          mkdir build
+          cmake -S . -B build
+          build-wrapper-linux-x86-64 --out-dir ${{ env.BUILD_WRAPPER_OUT_DIR }} cmake --build build/
+      - name: Run sonar-scanner
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          SONAR_TOKEN: ${{ secrets.SONAR_TOKEN }}
+        run: |
+          sonar-scanner --define sonar.host.url="${{ env.SONAR_SERVER_URL }}" --define sonar.cfamily.build-wrapper-output="${{ env.BUILD_WRAPPER_OUT_DIR }}"
+

CHANGELOG

@@ -1,3 +1,119 @@
+Changes to version 2.3.4
+------------------------
+
+- removed internal calls to CS101_ASDU_createFromBuffer to avoid dynamic memory allocation while handling received ASDUs
+- added CS101_ASDU_createFromBuffer to API
+- added ability to change config defines from make command (#169)
+- Time(Linux): always use clock_gettime; cleanup cmake files to remove checks for clock_gettime (#162)
+- Time(windows): fixed - Hal_getMonotonicTimeInMs() doesn't call GetTickCount64 correctly (#163)
+
+Changes to version 2.3.3
+------------------------
+
+- TLS: support for TLS 1.3 (when using mbedtls 3.6)
+- TLS: support to select TLS cipher suites 
+- CS104 slave: check IOA of received commands where IOA is fixed to 0 (LIB8705-101)
+- CS 104 slave: only send S message after receiving STOPDT-ACT when there are unconfirmed outstanding I messages to be compliant with test case IEC 60870-5-604:2016-5.3.2.70 (LIB8705-97)
+- fixed bug in test pattern for TestCommand (I651CL-25)
+- fixed initialization problem in StepCommand_create (I651CL-22)
+- disable support for C_TS_NA_1 for CS104 by default
+- use monotonic time for timers when supported by platform (LIB8705-87)
+- CS101 slave: updated behavior in unbalanced mode when FCB bit did not change (LIB8705-104)
+- fixed - k parameter from user configuration is not used
+- added handling of pending unconfirmed stopped state (LIB8705-83)
+- CS104_Connection: call connection handler only outside of connection lock to avoid deadlocks in user code (LIB8705-62)
+- CS104 connection: fixed potential race condition when connection is closed by peer (#147)
+- CS104 slave: fixed - lock not released in error case (#138)
+- fixed - CS 104 server: invalid read - when MasterConnection_deactivate is called after MasterConnection_deinit (LIB8705-54)
+- fixed - CS 104 server: connection is closed by server when receiving S message in inactive state (LIB8705-55)
+- fixed - CS104_Connection deadlock when sending commands/ASDUs (#134)(LIB8705-52)
+
+
+Changes to version 2.3.2
+------------------------
+
+- TLS support now requires mbedtls 2.28
+- updated HAL layer
+- Added new IEC 62351-3 related TLS features (session resumption, alarms, ...)
+- CS101 balanced link layer: Send request-status-of-link before calling reset-of-remote-link
+- CS101 unbalanced master: Send request-status-of-link before calling reset-of-remote-link, added delay before repeating request-status-of-link
+- added function CS101_ASDU_clone
+- fixed - TLS: configured CRL are ignored (#117)
+- integrated code to serve files
+- other small bug fixes and improvements
+- CS104 client: added connection event when connect failed
+
+
+Changes to version 2.3.1
+------------------------
+
+- TLS support now requires mbedtls 2.16.12
+- CS104 client/master: add support to specify local interface/IP address
+- Macos HAL layer: replaced semaphores by mutex
+- updated HAL layer
+- fix - Possible buffer overflow when formatting IPv6 addresses (#96)
+- fixed - write to queueEntry is not protected (#99)
+- fixed bug in CS101_ASDU_setNumberOfElements (#91)
+- CS104 slave: fixed problem in TEST-FR con timeout handling
+- CS101 master: fixed problem not sending broadcast messages (#88)
+- CS101 slave: fixed potential crash when application layer parameters don't match
+- CS104 server: fixed - receiving I or S frame while in STOPDT should close connection
+
+
+Changes to version 2.3.0
+------------------------
+- CS104 slave: send time sync response only to requesting client (#87)
+- fixed a bug in StatusAndStatusChangeDetection type decoding
+- fixed problem in TLS integration layer
+- fixed wrong type in return value of TestCommandWithCP56Time2a_getCounter
+- CS104 slave: close all open connections when server is stopped in non-treaded mode
+- added QueryLog (F_SC_NB_1) information object type
+- CS 101 slave: release plugin list in destroy function (#80)
+- CS104 client: Added function CS104_Connection_sendTestCommandWithTimestamp to send C_TS_TA_1 test command
+- CS104 slave: added support to handle test command C_TS_TA_1
+- added missing value for IEC60870_QCC_FRZ_COUNTER_RESET (#78)
+- CS104 slave: remove message from queue when confirmation received (see #77)
+- CS104 master: confirm all received I messages before sending STOPDT ACT or closing the connection
+- CS 104 slave: fixed bugs when TLS connection initilization fails (#75)
+- fixed potential memory leak in CS104_Connection_connectAsync
+- fixed wrong argument type of StepCommandWithCP56Time2a_destroy (#74)
+- single point and double point information objects ignore invalid quality flags (#72)
+
+Changes to version 2.2.1
+------------------------
+- CS104 slave: fixed problems in queue handling (#67)
+- added missing return statement in CS101_ASDU_addPayload(#68)
+- CS101_ASDU_addInformationObject now checks for correct object type
+- windows socket driver: fixed - fail to detect peer close when read from socket
+- fixed bug in BitString32 encoding (see #65)
+- fixed - null pointer access when calling CS104_Slave_destroy without server running before (issue #64)
+- added Bitstring32X_createEx functions to keep API backward compatible and allow setting of quality (issue #63)
+
+Changes to version 2.2.0
+------------------------
+- CS 101/104 slave: improved stability when receiving corrupted messages
+- CS 101/104 slave: added plugin interface
+- CS101 master: fixed setting of own address in balanced mode (#51)
+- CS101 slave: fixed bug in queue size initialization
+- Socket HAL (linux/bsd): set default backlog to 2 (see #50)
+- Socket HAL (linux/bsd): Socket_read detects closed socket
+- fixed bugs in file handling messages
+- fixed bug in OA decoding
+- add support to create and handle private or not supported ASDU types
+- CS104 master/slave: improved socket handling
+- CS104 slave: improved memory handling and memory consumption
+- removed CONFIG_CS104_SLAVE_POOL (and related) configuration option
+
+
+Changes to version 2.1.1
+------------------------
+- CS 104 slave: added functions IMasterConnection_getPeerAddress and IMasterConnection_close
+- CS 101/CS 104 slave: set P/N=1 (negative) when sending COT=44 or COT=45
+- improved compatibility with VxWorks
+- CS 104 slave: fixed bug in counter interrogation command handling - free stack allocated memory
+- fixed some include file problems
+
+
 Changes to version 2.1.0
 ------------------------
 - CS104 slave: added support for multiple redundancy groups
@@ -10,6 +126,7 @@ Changes to version 2.1.0
 - CS101 unbalanced master: fixed state machine problem with multiple slaves (some responses don't change state and master keeps locked on the slave)
 - optionally compile library without HAL to simply using together with libiec61850
 
+
 Changes to version 2.0.2
 ------------------------
 - CS104 slave: added new CS104_ConnectionEventHandler to track connection events