Release 2026-01-06

Author: arobenko

.github/workflows/actions_build.yml

@@ -1,10 +1,15 @@
 name: Github Actions Build
 
-on: [push]
+on:
+  push:
+    branches:
+      - '**'
+    tags-ignore:
+      - '**'
 
 env:
-  COMMS_TAG: v5.4.2
-  COMMSDSL_TAG: v7.1
+  COMMS_TAG: v5.5
+  COMMSDSL_TAG: v8.0
   WIN_BOOST_VERSION: "1.87.0"
   WIN_BOOST_DIR: "C:/local/boost_1_87_0"
 
@@ -19,22 +24,22 @@ jobs:
         cpp: [11, 14, 17, 20, 23]
         exclude:
           - cc_ver: 9
-            cpp: 23    
+            cpp: 23
           - cc_ver: 10
-            cpp: 23   
+            cpp: 23
           - cc_ver: 11
-            cpp: 23   
+            cpp: 23
           - cc_ver: 12
-            cpp: 23                             
+            cpp: 23
           - cc_ver: 13
-            cpp: 23  
+            cpp: 23
 
     steps:
     - uses: actions/checkout@v2
 
     - name: Prepare Install
-      run: sudo apt-get update --fix-missing    
-      
+      run: sudo apt-get update --fix-missing
+
     - name: Install Packages
       run: sudo apt install libqt5gui5 libboost-all-dev libxml2-dev gcc-${{matrix.cc_ver}} g++-${{matrix.cc_ver}}
 
@@ -53,7 +58,7 @@ jobs:
         COMMON_BUILD_TYPE: ${{matrix.type}}
         COMMON_CXX_STANDARD: ${{matrix.cpp}}
         COMMS_TAG: ${{env.COMMS_TAG}}
-        COMMSDSL_TAG: ${{env.COMMSDSL_TAG}}   
+        COMMSDSL_TAG: ${{env.COMMSDSL_TAG}}
 
     - name: Configure CMake
       shell: bash
@@ -70,7 +75,7 @@ jobs:
       shell: bash
       run: cmake --build . --config ${{matrix.type}} --target install
       env:
-        VERBOSE: 1 
+        VERBOSE: 1
 
   build_clang_ubuntu_22_04:
     runs-on: ubuntu-22.04
@@ -85,8 +90,8 @@ jobs:
     - uses: actions/checkout@v2
 
     - name: Prepare Install
-      run: sudo apt-get update --fix-missing    
-      
+      run: sudo apt-get update --fix-missing
+
     - name: Install Packages
       run: sudo apt install libqt5gui5 libboost-all-dev libxml2-dev clang-${{matrix.cc_ver}}
 
@@ -122,7 +127,7 @@ jobs:
       shell: bash
       run: cmake --build . --config ${{matrix.type}} --target install
       env:
-        VERBOSE: 1   
+        VERBOSE: 1
 
   build_clang_ubuntu_24_04:
     runs-on: ubuntu-24.04
@@ -134,24 +139,24 @@ jobs:
         cpp: [11, 14, 17, 20, 23]
         exclude:
           - cc_ver: 14
-            cpp: 20  
+            cpp: 20
           - cc_ver: 14
-            cpp: 23   
+            cpp: 23
           - cc_ver: 15
-            cpp: 20              
+            cpp: 20
           - cc_ver: 15
-            cpp: 23                                
+            cpp: 23
           - cc_ver: 16
             cpp: 23
           - cc_ver: 17
-            cpp: 23  
+            cpp: 23
 
     steps:
     - uses: actions/checkout@v2
 
     - name: Prepare Install
-      run: sudo apt-get update --fix-missing    
-      
+      run: sudo apt-get update --fix-missing
+
     - name: Install Packages
       run: sudo apt install libqt5gui5 libboost-all-dev libxml2-dev clang-${{matrix.cc_ver}}
 
@@ -187,28 +192,29 @@ jobs:
       shell: bash
       run: cmake --build . --config ${{matrix.type}} --target install
       env:
-        VERBOSE: 1                 
+        VERBOSE: 1
 
-  build_msvc_2019:
-    runs-on: windows-2019
+  build_msvc_2022:
+    runs-on: windows-2022
     strategy:
       fail-fast: false
       matrix:
         type: [Debug, Release]
         arch: [x64]
-        cpp: [11, 14, 17]
+        cpp: [11, 14, 17, 20]
 
     steps:
     - uses: actions/checkout@v4
 
     - name: Create Build Environment
-      run: cmake -E make_directory ${{runner.workspace}}/build   
+      run: cmake -E make_directory ${{runner.workspace}}/build
 
     - name: Install Boost
+      if: matrix.arch == 'x64'
       shell: cmd
       run: |
-        choco install boost-msvc-14.2 --version=${{env.WIN_BOOST_VERSION}}
-        echo BOOST_DIR=${{env.WIN_BOOST_DIR}}/lib64-msvc-14.2/cmake >>%GITHUB_ENV%       
+        choco install boost-msvc-14.3 --version=${{env.WIN_BOOST_VERSION}}
+        echo BOOST_DIR=${{env.WIN_BOOST_DIR}}/lib64-msvc-14.3/cmake >>%GITHUB_ENV%
 
     - name: Prepare externals
       shell: cmd
@@ -234,27 +240,27 @@ jobs:
           -DCMAKE_POLICY_DEFAULT_CMP0167=NEW ^
           -DCMAKE_CXX_STANDARD=${{matrix.cpp}} -DOPT_FORCE_EXTRA_BOOST_LIBS=ON
 
-    - name: Build Target 
+    - name: Build Target
       working-directory: ${{runner.workspace}}/build
       shell: cmd
       run: cmake --build . --config ${{matrix.type}} --target install
       env:
-        VERBOSE: 1 
+        VERBOSE: 1
 
-  build_msvc_2022:
-    runs-on: windows-2022
+  build_msvc_2025:
+    runs-on: windows-2025
     strategy:
       fail-fast: false
       matrix:
         type: [Debug, Release]
         arch: [x64]
-        cpp: [11, 14, 17, 20]
+        cpp: [11, 14, 17, 20, 23]
 
     steps:
     - uses: actions/checkout@v4
 
     - name: Create Build Environment
-      run: cmake -E make_directory ${{runner.workspace}}/build   
+      run: cmake -E make_directory ${{runner.workspace}}/build
 
     - name: Install Boost
       if: matrix.arch == 'x64'
@@ -285,11 +291,11 @@ jobs:
         cmake %GITHUB_WORKSPACE% -A ${{matrix.arch}} -DCMAKE_BUILD_TYPE=${{matrix.type}} -DCMAKE_INSTALL_PREFIX=install ^
           -DCMAKE_PREFIX_PATH="${{runner.workspace}}/build/install;${{env.BOOST_DIR}}" ^
           -DCMAKE_POLICY_DEFAULT_CMP0167=NEW ^
-          -DCMAKE_CXX_STANDARD=${{matrix.cpp}} -DOPT_FORCE_EXTRA_BOOST_LIBS=ON 
+          -DCMAKE_CXX_STANDARD=${{matrix.cpp}} -DOPT_FORCE_EXTRA_BOOST_LIBS=ON
 
-    - name: Build Target 
+    - name: Build Target
       working-directory: ${{runner.workspace}}/build
       shell: cmd
       run: cmake --build . --config ${{matrix.type}} --target install
       env:
-        VERBOSE: 1
+        VERBOSE: 1        

CMakeLists.txt

@@ -11,7 +11,7 @@ option (OPT_USE_SANITIZERS "Compile with sanitizers." OFF)
 
 #####################################################
 
-set (MIN_COMMSDSL_VERSION "7.1")
+set (MIN_COMMSDSL_VERSION "8.0")
 
 if ("${CMAKE_CXX_STANDARD}" STREQUAL "")
     set(CMAKE_CXX_STANDARD 11)

cmake/CC_Prefetch.cmake

@@ -1,4 +1,4 @@
-# This file contains contains a function that prefetches comms library project. 
+# This file contains contains a function that prefetches comms library project.
 
 # ******************************************************
 #     cc_prefetch(
@@ -24,11 +24,11 @@ function (cc_prefetch)
 
     if (NOT CC_FETCH_SRC_DIR)
         message (FATAL_ERROR "The SRC_DIR parameter is not provided")
-    endif ()     
+    endif ()
 
     if (NOT CC_FETCH_REPO)
         set (CC_FETCH_REPO ${CC_FETCH_DEFAULT_REPO})
-    endif ()  
+    endif ()
 
     if (NOT CC_FETCH_TAG)
         set (CC_FETCH_TAG ${CC_FETCH_DEFAULT_TAG})
@@ -40,24 +40,24 @@ function (cc_prefetch)
 
     if (EXISTS "${CC_FETCH_SRC_DIR}/cmake/CC_CommsExternal.cmake")
         return ()
-    endif()    
+    endif()
 
     execute_process (
         COMMAND ${CMAKE_COMMAND} -E remove_directory "${CC_FETCH_SRC_DIR}"
     )
-    
+
     execute_process (
         COMMAND ${CMAKE_COMMAND} -E make_directory "${CC_FETCH_SRC_DIR}"
-    )        
-    
+    )
+
     execute_process (
-        COMMAND 
+        COMMAND
             ${GIT_EXECUTABLE} clone -b ${CC_FETCH_TAG} ${CC_FETCH_REPO} ${CC_FETCH_SRC_DIR}
         RESULT_VARIABLE git_result
     )
 
     if (NOT "${git_result}" STREQUAL "0")
         message (WARNING "git clone/checkout failed")
-    endif ()    
+    endif ()
 
 endfunction()

howtos/howto1/README.md

@@ -2,26 +2,26 @@
 Custom remaining size framing information preceding `<id>`.
 
 This howto demonstrates having remaining size information in message framing sharing its 2 bytes with
-extra flags which influence the way message payload is read. 
+extra flags which influence the way message payload is read.
 
-Having values (flags) in the message framing which influence how message payload is read and/or how 
+Having values (flags) in the message framing which influence how message payload is read and/or how
 message is processed requires definition of common message interface:
 ```xml
 <fields>
     <set name="InterfaceFlags" length="1">
         <bit name="B0" idx="0" />
         <bit name="B1" idx="1" />
-    </set>        
-    
+    </set>
+
 </fields>
 
 <interface name="Interface" description="Common Interface for all the messages.">
     <ref field="InterfaceFlags" name="Flags" />
-</interface>    
+</interface>
 ```
 
 When remaining message length information in the message framing is split into multiple
-values, the default `<size>` cannot be used, the `<custom>` one needs to be used 
+values, the default `<size>` cannot be used, the `<custom>` one needs to be used
 instead:
 ```xml
     <frame name="Frame">
@@ -30,26 +30,26 @@ instead:
                 <int name="Size" type="uint16" bitLength="12"/>
                 <ref field="InterfaceFlags" name="Flags" bitLength="4" />
             </bitfield>
-        </custom>        
+        </custom>
         <id name="Id" field="MsgId" />
         <value name="Flags" interfaceFieldName="Flags" pseudo="true" field="InterfaceFlags" />
         <payload name="Data" />
     </frame>
 ```
-When _size_ layer precedes `<id>` it is not possible to assign flags to message object 
-(because the latter is not allocated yet) and then forward the `read()` operation to the next 
-layer. In order to solve the problem the **pseudo** (marked with **pseudo="true"** property) 
+When _size_ layer precedes `<id>` it is not possible to assign flags to message object
+(because the latter is not allocated yet) and then forward the `read()` operation to the next
+layer. In order to solve the problem the **pseudo** (marked with **pseudo="true"** property)
 `<value>` layer is added right before the `<payload>`.
 
 ---
 
-**REMINDER**: The **pseudo** `<value>` layer does not produce any output or consumes any input, it just 
-contains its field as a private data member (value of which can be assigned externally) and 
+**REMINDER**: The **pseudo** `<value>` layer does not produce any output or consumes any input, it just
+contains its field as a private data member (value of which can be assigned externally) and
 pretends to read the value when its `read()` member function is invoked.
 
 ---
 
-When the `SizeWithFlags` reads its value it needs to access the `Flags` `<value>` layer and 
+When the `SizeWithFlags` reads its value it needs to access the `Flags` `<value>` layer and
 assign the pseudo field value, see [dsl_src/include/howto1/frame/layer/SizeWithFlags.h](dsl_src/include/howto1/frame/layer/SizeWithFlags.h)
 for details:
 ```cpp
@@ -60,22 +60,22 @@ class SizeWithFlags : public
 
 public:
     // Repeat some types from the base class
-    using Field = typename Base::Field;    
+    using Field = typename Base::Field;
 
-    template<typename TMsg> 
+    template<typename TMsg>
     void beforeRead(const Field& field, TMsg* msg)
     {
         static_cast<void>(msg);
         COMMS_ASSERT(msg == nullptr); // The message object is not created yet
         Base::nextLayer().nextLayer().pseudoField().value() = field.field_flags().value();
-    } 
+    }
 
     ...
 };
 ```
-**Note** that `nextLayer()` function is called twice: first time gives an access to the `Id` layer 
-that follows, and second time gives an access to the `Flags` one. After that the 
-`<value>` layer will do its job of re-assigning its field to the `<interface>` the 
+**Note** that `nextLayer()` function is called twice: first time gives an access to the `Id` layer
+that follows, and second time gives an access to the `Flags` one. After that the
+`<value>` layer will do its job of re-assigning its field to the `<interface>` the
 normal way it's designed to do.
 
 Also for more details please read [Defining Custom Message Size Frame Layer](https://commschamp.github.io/comms_doc/page_custom_size_layer.html)