Apply all changes after 26.9

.github/workflows/arduinoLint.yml

@@ -0,0 +1,21 @@
+name: Arduino Lint
+
+on:
+  push:
+    branches: [ master ]
+  pull_request:
+    branches: [ master ]
+  workflow_dispatch:
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v3
+
+      - name: Arduino Lint
+        uses: arduino/arduino-lint-action@v1
+        with:
+          compliance: strict

.github/workflows/build.yml

@@ -32,10 +32,7 @@ jobs:
       - name: Checkout
         uses: actions/checkout@v3
 
-      - name: Arduino Lint
-        uses: arduino/arduino-lint-action@v1
-        with:
-          compliance: strict
+
 
       - name: Cache Arduino platform
         uses: actions/cache@v3
@@ -52,7 +49,10 @@ jobs:
         with:
           platforms: ${{ matrix.platforms }}
           fqbn: ${{ matrix.board.fqbn }}
-          libraries: ${{ env.LIBRARIES }}
+          libraries: |
+            - name: "Async TCP"
+            - name: "ESP Async WebServer"
+            - source-path: .
           enable-deltas-report: false
           sketch-paths: |
             - examples

.github/workflows/createRelease.yml

@@ -0,0 +1,56 @@
+name: Create Release
+
+on:
+  release:
+    types: [published]
+  workflow_dispatch:
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Extract version from release tag
+        id: version
+        run: |
+          TAG_NAME="${{ github.event.release.tag_name }}"
+          echo "tag_name=$TAG_NAME" >> $GITHUB_OUTPUT
+          echo "Version detected: $TAG_NAME"
+
+      - name: Validate library version
+        run: |
+          echo "Checking library.properties..."
+          grep -E '^version=' library.properties || { echo "Error: version missing"; exit 1; }
+
+          PROP_VERSION=$(grep -E '^version=' library.properties | cut -d'=' -f2)
+          TAG_NAME="${{ github.event.release.tag_name }}"
+          TAG_VERSION="${TAG_NAME#v}"  # Remove leading 'v' in Bash
+
+          if [ "$PROP_VERSION" != "$TAG_VERSION" ]; then
+            echo "Version mismatch: library.properties ($PROP_VERSION) vs tag ($TAG_NAME)"
+            exit 1
+          fi
+
+          echo "Version match confirmed"
+
+      - name: Package library
+        run: |
+          mkdir -p dist
+          ZIP_FILE="LD2410Async-${{ steps.version.outputs.tag_name }}.zip"
+          echo "Packaging library as $ZIP_FILE ..."
+          zip -r "dist/$ZIP_FILE" . -x "*.git*" "dist/*" ".github/*" "docs/*" "__MACOSX"
+
+      - name: Upload ZIP to existing GitHub Release
+        uses: softprops/action-gh-release@v2
+        with:
+          tag_name: ${{ steps.version.outputs.tag_name }}
+          name: "LD2410Async ${{ steps.version.outputs.tag_name }}"
+          files: dist/*.zip
+          append_body: false
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/generateDoxygenDocu.yml

@@ -0,0 +1,33 @@
+name: Generate Documentation
+
+on:
+  # Run when a release is created or published
+  release:
+    types: [published]
+
+  # Allow manual trigger from the Actions tab
+  workflow_dispatch:
+
+jobs:
+  doxygen:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0  # Ensures tags are available (useful for versioned docs)
+
+      - name: Generate Doxygen documentation
+        uses: mattnotmitt/doxygen-action@v1
+        with:
+          doxyfile-path: ./Doxyfile
+
+      - name: Deploy documentation to GitHub Pages
+        uses: peaceiris/actions-gh-pages@v3
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          publish_dir: ./docs/html
+          publish_branch: gh-pages
+          force_orphan: true
+          keep_files: false

Doxyfile

@@ -0,0 +1,74 @@
+# Doxyfile for LD2410Async C++ Library
+# Suitable for GitHub Actions workflow in .github/workflows/generateDoxygenDocu.yml
+
+# Project related configuration
+PROJECT_NAME           = "LD2410Async"
+PROJECT_BRIEF          = "Asynchronous Arduino ESP32 library for the LD2410 mmWave radar sensor"
+OUTPUT_DIRECTORY       = docs
+CREATE_SUBDIRS         = NO
+OUTPUT_LANGUAGE        = English
+EXTRACT_ALL            = YES
+EXTRACT_PRIVATE        = NO
+EXTRACT_STATIC         = NO
+EXTRACT_LOCAL_CLASSES  = YES
+EXTRACT_ANON_NSPACES   = YES
+SORT_MEMBER_DOCS = YES
+SORT_GROUP_NAMES = YES
+
+
+
+# Input
+INPUT                  = src examples dox
+FILE_PATTERNS          = *.h *.cpp *.ino *.dox *.md
+EXTENSION_MAPPING	   = ino=C++
+RECURSIVE              = YES
+IMAGE_PATH			   = gfx
+
+# Source code browsing
+SOURCE_BROWSER         = YES
+INLINE_SOURCES         = FALSE
+STRIP_CODE_COMMENTS    = NO
+
+# HTML output
+GENERATE_HTML          = YES
+HTML_OUTPUT            = html
+HTML_FILE_EXTENSION    = .html
+HTML_COLORSTYLE_HUE    = 220
+HTML_COLORSTYLE_SAT    = 100
+HTML_COLORSTYLE_GAMMA  = 80
+
+# LaTeX output (disabled)
+GENERATE_LATEX         = NO
+
+# Dot/Graphviz support
+HAVE_DOT           = NO
+CALL_GRAPH         = NO
+CALLER_GRAPH       = NO
+CLASS_DIAGRAMS     = NO
+COLLABORATION_GRAPH= NO
+INCLUDE_GRAPH      = NO
+INCLUDED_BY_GRAPH  = NO
+GRAPHICAL_HIERARCHY= NO
+DOT_MULTI_TARGETS  = NO
+
+# Warnings
+WARN_IF_UNDOCUMENTED   = YES
+WARN_IF_DOC_ERROR      = YES
+
+# Misc
+QUIET                  = NO
+GENERATE_TREEVIEW      = YES
+FULL_PATH_NAMES        = NO
+STRIP_FROM_PATH        = src examples
+
+# Repository link (optional, for GitHub integration)
+# Set to your repo if you want source browsing links
+# HTML_DYNAMIC_SECTIONS = YES
+# PROJECT_LOGO          =
+
+# If you want Markdown support
+MARKDOWN_SUPPORT       = YES
+
+# If you want to document private members, set EXTRACT_PRIVATE = YES
+
+# End of Doxyfile

LD2410Async.sln

@@ -1,7 +1,7 @@
 
 Microsoft Visual Studio Solution File, Format Version 12.00
 # Visual Studio Version 17
-VisualStudioVersion = 17.14.36511.14 d17.14
+VisualStudioVersion = 17.14.36511.14
 MinimumVisualStudioVersion = 10.0.40219.1
 Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "LD2410Async", "LD2410Async.vcxitems", "{76DB4135-DB0F-4430-958C-2109370DCD97}"
 EndProject

LD2410Async.vcxitems

@@ -22,10 +22,28 @@
     <!-- <ClInclude Include="$(MSBuildThisFileDirectory)LD2410Async.h" /> -->
     <None Include="$(MSBuildThisFileDirectory).gitattributes" />
     <None Include="$(MSBuildThisFileDirectory).github\workflows\build.yml" />
+    <None Include="$(MSBuildThisFileDirectory).github\workflows\arduinoLint.yml" />
+    <None Include="$(MSBuildThisFileDirectory).github\workflows\createRelease.yml" />
+    <None Include="$(MSBuildThisFileDirectory).github\workflows\generateDoxygenDocu.yml" />
     <None Include="$(MSBuildThisFileDirectory).gitignore" />
+    <None Include="$(MSBuildThisFileDirectory)Doxyfile" />
+    <None Include="$(MSBuildThisFileDirectory)dox\Async Commands And Processing.md" />
+    <None Include="$(MSBuildThisFileDirectory)dox\Data Structures.md" />
+    <None Include="$(MSBuildThisFileDirectory)dox\Examples.md" />
+    <None Include="$(MSBuildThisFileDirectory)dox\Inactivity Handling.md" />
+    <None Include="$(MSBuildThisFileDirectory)dox\Installation.md" />
+    <None Include="$(MSBuildThisFileDirectory)dox\mainPage.md" />
+    <None Include="$(MSBuildThisFileDirectory)dox\Notes And Best Practices.md" />
+    <None Include="$(MSBuildThisFileDirectory)dox\Operation Modes.md" />
+    <None Include="$(MSBuildThisFileDirectory)dox\Troubleshooting.md" />
+    <None Include="$(MSBuildThisFileDirectory)examples\basicPresenceDetection\basicPresenceDetection.ino" />
     <None Include="$(MSBuildThisFileDirectory)examples\changeConfig\changeConfig.ino" />
     <None Include="$(MSBuildThisFileDirectory)examples\changeDistanceResolution\changeDistanceResolution.ino" />
+    <None Include="$(MSBuildThisFileDirectory)examples\enableConfigModeTest\enableConfigModeTest.ino" />
     <None Include="$(MSBuildThisFileDirectory)examples\receiveData\receiveData.ino" />
+    <None Include="$(MSBuildThisFileDirectory)examples\simplePresenceDetectionWebservice\simplePresenceDetectionWebservice.ino" />
+    <None Include="$(MSBuildThisFileDirectory)examples\tortureTest\tortureTest.ino" />
+    <None Include="$(MSBuildThisFileDirectory)examples\unitTest\unitTest.ino" />
     <None Include="$(MSBuildThisFileDirectory)LICENSE" />
     <None Include="$(MSBuildThisFileDirectory)README.md" />
   </ItemGroup>
@@ -34,6 +52,11 @@
   </ItemGroup>
   <ItemGroup>
     <ClInclude Include="$(MSBuildThisFileDirectory)src\LD2410CommandBuilder.h" />
+    <ClInclude Include="$(MSBuildThisFileDirectory)src\LD2410Debug.h" />
     <ClInclude Include="$(MSBuildThisFileDirectory)src\LD2410Defs.h" />
+    <ClInclude Include="$(MSBuildThisFileDirectory)src\LD2410Types.h" />
+  </ItemGroup>
+  <ItemGroup>
+    <Image Include="$(MSBuildThisFileDirectory)gfx\LD2410.jpg" />
   </ItemGroup>
 </Project>

LD2410Async.vcxitems.filters

@@ -24,13 +24,31 @@
   </ItemGroup>
   <ItemGroup>
     <None Include="$(MSBuildThisFileDirectory)LICENSE" />
-    <None Include="$(MSBuildThisFileDirectory)README.md" />
     <None Include="$(MSBuildThisFileDirectory)examples\changeConfig\changeConfig.ino" />
     <None Include="$(MSBuildThisFileDirectory)examples\changeDistanceResolution\changeDistanceResolution.ino" />
     <None Include="$(MSBuildThisFileDirectory)examples\receiveData\receiveData.ino" />
     <None Include="$(MSBuildThisFileDirectory).gitattributes" />
     <None Include="$(MSBuildThisFileDirectory).gitignore" />
     <None Include="$(MSBuildThisFileDirectory).github\workflows\build.yml" />
+    <None Include="$(MSBuildThisFileDirectory).github\workflows\arduinoLint.yml" />
+    <None Include="$(MSBuildThisFileDirectory)examples\basicPresenceDetection\basicPresenceDetection.ino" />
+    <None Include="$(MSBuildThisFileDirectory).github\workflows\generateDoxygenDocu.yml" />
+    <None Include="$(MSBuildThisFileDirectory)Doxyfile" />
+    <None Include="$(MSBuildThisFileDirectory)examples\simplePresenceDetectionWebservice\simplePresenceDetectionWebservice.ino" />
+    <None Include="$(MSBuildThisFileDirectory)examples\unitTest\unitTest.ino" />
+    <None Include="$(MSBuildThisFileDirectory)examples\tortureTest\tortureTest.ino" />
+    <None Include="$(MSBuildThisFileDirectory)examples\enableConfigModeTest\enableConfigModeTest.ino" />
+    <None Include="$(MSBuildThisFileDirectory)dox\Async Commands And Processing.md" />
+    <None Include="$(MSBuildThisFileDirectory)dox\Data Structures.md" />
+    <None Include="$(MSBuildThisFileDirectory)dox\Inactivity Handling.md" />
+    <None Include="$(MSBuildThisFileDirectory)dox\Installation.md" />
+    <None Include="$(MSBuildThisFileDirectory)dox\mainPage.md" />
+    <None Include="$(MSBuildThisFileDirectory)dox\Notes And Best Practices.md" />
+    <None Include="$(MSBuildThisFileDirectory)dox\Operation Modes.md" />
+    <None Include="$(MSBuildThisFileDirectory)dox\Troubleshooting.md" />
+    <None Include="$(MSBuildThisFileDirectory)README.md" />
+    <None Include="$(MSBuildThisFileDirectory)dox\Examples.md" />
+    <None Include="$(MSBuildThisFileDirectory).github\workflows\createRelease.yml" />
   </ItemGroup>
   <ItemGroup>
     <ClInclude Include="$(MSBuildThisFileDirectory)src\LD2410CommandBuilder.h">
@@ -39,5 +57,14 @@
     <ClInclude Include="$(MSBuildThisFileDirectory)src\LD2410Defs.h">
       <Filter>Header Files</Filter>
     </ClInclude>
+    <ClInclude Include="$(MSBuildThisFileDirectory)src\LD2410Types.h">
+      <Filter>Header Files</Filter>
+    </ClInclude>
+    <ClInclude Include="$(MSBuildThisFileDirectory)src\LD2410Debug.h">
+      <Filter>Header Files</Filter>
+    </ClInclude>
+  </ItemGroup>
+  <ItemGroup>
+    <Image Include="$(MSBuildThisFileDirectory)gfx\LD2410.jpg" />
   </ItemGroup>
 </Project>