Merge of development branch in master

.clang-format

@@ -0,0 +1,7 @@
+---
+BasedOnStyle: Google
+IndentWidth: 2
+---
+Language: Cpp
+ColumnLimit: 120
+UseTab: Never

.clang-tidy

@@ -0,0 +1,51 @@
+---
+Checks: >
+  -*,
+  bugprone-*,
+  clang-diagnostic-*,
+  -clang-diagnostic-unused-command-line-argument,
+  google-*,
+  misc-*,
+  -misc-noexcept*,
+  modernize-*,
+  -modernize-deprecated-headers,
+  -modernize-raw-string-literal,
+  -modernize-return-braced-init-list,
+  -modernize-use-equals-delete,
+  -modernize-use-trailing-return-type,
+  performance-*,
+  readability-*,
+  -readability-implicit-bool-conversion,
+  -readability-isolate-declaration,
+  -readability-uppercase-literal-suffix
+WarningsAsErrors: false
+HeaderFilterRegex: '\.\./.*/([^t].*|t[^h].*|th[^i].*)'
+AnalyzeTemporaryDtors: false
+FormatStyle:     file
+CheckOptions:
+  - key:             bugprone-assert-side-effect.AssertMacros
+    value:           'FXL_DCHECK'
+  - key:             google-readability-braces-around-statements.ShortStatementLines
+    value:           '2'
+  - key:             google-readability-function-size.StatementThreshold
+    value:           '800'
+  - key:             google-readability-namespace-comments.ShortNamespaceLines
+    value:           '10'
+  - key:             google-readability-namespace-comments.SpacesBeforeComments
+    value:           '2'
+  - key:             modernize-loop-convert.MaxCopySize
+    value:           '16'
+  - key:             modernize-loop-convert.MinConfidence
+    value:           reasonable
+  - key:             modernize-loop-convert.NamingStyle
+    value:           CamelCase
+  - key:             modernize-pass-by-value.IncludeStyle
+    value:           llvm
+  - key:             modernize-replace-auto-ptr.IncludeStyle
+    value:           llvm
+  - key:             modernize-use-default-member-init.UseAssignment
+    value:           '1'
+  - key:             modernize-use-nullptr.NullMacros
+    value:           'NULL'
+  - key:             readability-braces-around-statements.ShortStatementLines
+    value:           '2'

.devcontainer/Dockerfile

@@ -0,0 +1,2 @@
+ARG VARIANT="latest"
+FROM bausma/mbed-dev-env:${VARIANT}

.devcontainer/devcontainer.json

@@ -0,0 +1,44 @@
+// For format details, see https://aka.ms/devcontainer.json. For config options, see the README at:
+// https://github.com/microsoft/vscode-dev-containers/tree/v0.231.6/containers/ubuntu
+{
+	"name": "EduArt Bootloader Dev Container",
+	"build": {
+		"dockerfile": "Dockerfile",
+		"args": { "VARIANT": "latest" },
+	},
+	"runArgs": [
+		"-it",
+		"--rm",
+		"--privileged",
+		"--net=host",
+		"--pid=host",
+		"--device=/dev/stlinkv2_2"
+	  ],
+	"workspaceMount": "source=${localWorkspaceFolder},target=/home/user/${localWorkspaceFolderBasename},type=bind",
+	"workspaceFolder": "/home/user/${localWorkspaceFolderBasename}",
+	"remoteUser": "user",
+	"extensions": [
+	  //"ms-vscode.cpptools",
+	  //"ms-vscode.cpptools-linux",
+	  "shd101wyy.markdown-preview-enhanced",
+	  "2gua.rainbow-brackets",
+	  "ms-vscode.cmake-tools",
+	  "ms-vscode.cpptools-extension-pack",
+	  "llvm-vs-code-extensions.vscode-clangd", 
+	  "xaver.clang-format",
+	  "ms-python.python",
+	  "ms-azuretools.vscode-docker",
+	  "ms-vscode-remote.remote-containers",
+	  "vscode-icons-team.vscode-icons",
+	  "editorconfig.editorconfig",
+	  "eamodio.gitlens",
+	  "xaver.clang-format",
+	  "llvm-vs-code-extensions.vscode-clangd",
+	  "streetsidesoftware.code-spell-checker",
+	  "cschlosser.doxdocgen",
+	  "yzhang.markdown-all-in-one",
+	  "rust-lang.rust-analyzer",
+	  "notskm.clang-tidy"
+	]
+}
+

.github/workflows/deploy-docs.yaml

@@ -0,0 +1,46 @@
+name: Deploy Documentation
+
+on:
+  # Trigger when documentation files are updated on master
+  push:
+    branches: [ master ]
+    paths:
+      - 'docs/**'
+      - 'README.md'
+  # Manual trigger
+  workflow_dispatch:
+
+jobs:
+  deploy-docs:
+    name: Deploy Documentation to GitHub Pages
+    runs-on: ubuntu-latest
+
+    # Grant GITHUB_TOKEN the permissions required to make a Pages deployment
+    permissions:
+      pages: write      # to deploy to Pages
+      id-token: write   # to verify the deployment originates from an appropriate source
+
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Setup Pages
+        uses: actions/configure-pages@v4
+
+      - name: Upload documentation artifacts
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: './docs'
+
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v3
+
+      - name: Output deployment URL
+        run: |
+          echo "Documentation deployed successfully!"
+          echo "Available at: ${{ steps.deployment.outputs.page_url }}"

.github/workflows/main.yaml

@@ -0,0 +1,98 @@
+name: CI/CD Pipeline
+
+on:
+  push:
+    branches: [ master, devel ]
+    paths:
+      # Trigger on code changes
+      - 'include/**'
+      - 'src/**'
+      - 'tests/**'
+      - 'utils/**'
+      - 'CMakeLists.txt'
+      - '.github/workflows/**'
+  pull_request:
+    branches: [ master, devel ]
+    paths:
+      - 'include/**'
+      - 'src/**'
+      - 'tests/**'
+      - 'utils/**'
+      - 'CMakeLists.txt'
+      - '.github/workflows/**'
+
+jobs:
+  # Test and build the library
+  test-build:
+    name: Test and Build Library
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Install dependencies
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y cmake build-essential libgtest-dev
+
+      - name: Build Google Test
+        run: |
+          cd /usr/src/gtest
+          sudo cmake CMakeLists.txt
+          sudo make
+          sudo cp lib/*.a /usr/lib
+
+      - name: Create build directory
+        run: mkdir -p build
+
+      - name: Configure CMake
+        run: |
+          cd build
+          cmake .. -DCMAKE_BUILD_TYPE=Release
+
+      - name: Build project
+        run: |
+          cd build
+          make -j$(nproc)
+
+      - name: Run tests
+        run: |
+          cd build
+          CTEST_OUTPUT_ON_FAILURE=1 ctest --verbose
+
+  # Deploy documentation to GitHub Pages (only on master branch after successful tests)
+  deploy-docs:
+    name: Deploy Documentation
+    runs-on: ubuntu-latest
+    needs: test-build
+    if: github.ref == 'refs/heads/master' && github.event_name == 'push'
+
+    # Grant GITHUB_TOKEN the permissions required to make a Pages deployment
+    permissions:
+      pages: write      # to deploy to Pages
+      id-token: write   # to verify the deployment originates from an appropriate source
+
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Setup Pages
+        uses: actions/configure-pages@v4
+
+      - name: Upload documentation artifacts
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: './docs'
+
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v3
+
+      - name: Output deployment info
+        run: |
+          echo "Documentation deployment completed!"
+          echo "Available at: ${{ steps.deployment.outputs.page_url }}"

.github/workflows/test_build.yaml

@@ -0,0 +1,51 @@
+name: Build library and run tests
+on:
+  # Manual trigger only - main workflow handles automatic triggers
+  workflow_dispatch:
+  # Also trigger on pull requests for testing
+  pull_request:
+    branches: [ master, devel ]
+    paths:
+    - '.github/workflows/**'
+    - 'include/**'
+    - 'src/**'
+    - 'tests/**'
+    - 'utils/**'
+    - 'CMakeLists.txt'
+
+jobs:
+  build-and-test:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Install dependencies
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y cmake build-essential libgtest-dev
+
+      - name: Build Google Test
+        run: |
+          cd /usr/src/gtest
+          sudo cmake CMakeLists.txt
+          sudo make
+          sudo cp lib/*.a /usr/lib
+
+      - name: Create build directory
+        run: mkdir -p build
+
+      - name: Configure CMake
+        run: |
+          cd build
+          cmake .. -DCMAKE_BUILD_TYPE=Release
+
+      - name: Build project
+        run: |
+          cd build
+          make -j$(nproc)
+
+      - name: Run tests
+        run: |
+          cd build
+          CTEST_OUTPUT_ON_FAILURE=1 ctest --verbose

.gitignore

@@ -0,0 +1,3 @@
+build/*
+compile_commands.json
+.cache

.vscode/c_cpp_properties.json

@@ -0,0 +1,22 @@
+{
+    "configurations": [
+      {
+        "name": "Linux",
+        "intelliSenseMode": "${default}",
+        "includePath": [
+            "${workspaceFolder}/include"
+        ],
+        "defines": [],
+        "compilerPath": "/usr/bin/clang",
+        "cStandard": "c11",
+        "cppStandard": "c++17",
+        "compileCommands": "${workspaceFolder}/compile_commands.json",
+        "browse": {
+          "path": ["${workspaceFolder}"],
+          "limitSymbolsToIncludedHeaders": true,
+          "databaseFilename": ""
+        }
+      }
+    ],
+    "version": 4
+  }

.vscode/settings.json

@@ -0,0 +1,13 @@
+{
+    "clangd.arguments": [
+        "--header-insertion=never"
+    ],
+    "C_Cpp.intelliSenseEngine": "Disabled",
+    "editor.defaultFormatter": "xaver.clang-format",
+    "editor.formatOnSave": true,
+    "cSpell.diagnosticLevel": "Hint",
+    "cSpell.ignoreRegExpList": [
+        ".*"
+      ]
+
+}

.vscode/tasks.json

@@ -0,0 +1,27 @@
+{
+    // See https://go.microsoft.com/fwlink/?LinkId=733558
+    // for the documentation about the tasks.json format
+    "version": "2.0.0",
+    "tasks": [
+        {
+            "label": "Build",
+            "type": "shell",
+            "command": "cmake .. && make && CTEST_OUTPUT_ON_FAILURE=TRUE make test && cp compile_commands.json ${workspaceFolder}",
+            "group": {
+                "kind": "build",
+                "isDefault": true
+            },
+            "problemMatcher":"$gcc",
+            "options": {"cwd": "${workspaceFolder}/build"}
+        },
+        {
+            "label": "Cleanup",
+            "type": "shell",
+            "command": "rm compile_commands.json; rm -r build/*",
+            "group": {
+                "kind": "build",
+                "isDefault": false
+            },
+        }
+    ]
+}