V1.0.0

.gitignore

@@ -1,25 +1,41 @@
 
-/build
-/build-*
+build
+build-*
 
 
 # CANape artefacts
 *.hex 
 *.mf4
 *.cnaxml
 *.tmp
+CANapeTmpMea.ini
 
-# Examples A2L files
-*.a2l
+
+# Examples .a2l and .bin files
+/*.a2l
 *.bin
 
 # Temporary files
+test_bintool
 conversions.a2l
 groups.a2l
 typedefs.a2l
 *.bak
+*.log
+*.txt
 
 
+# Other
 /run_remote.sh
 /run.sh
-/examples/bpf_demo/CANape/CANapeTmpMea.ini
+pi
+dwarf
+.vscode
+.DS_Store
+test_bpf_demo_pi.sh
+test_bin2hex_pi.sh
+CANape.aml
+tools/gimli_demo/
+tools/dwarf_reader/
+tools/bintool/USAGE_EXAMPLES.md
+/examples/hello_xcp/CANape/vCDMstudioUiConfiguration.xml

.vscode/launch.json

@@ -1,6 +1,26 @@
 {
     "version": "0.2.0",
     "configurations": [
+        {
+            "name": "Debug hello_xcp_cpp",
+            "type": "cppdbg",
+            "request": "launch",
+            "program": "${workspaceFolder}/build/hello_xcp_cpp.out",
+            "args": [],
+            "stopAtEntry": false,
+            "cwd": "${workspaceFolder}",
+            "environment": [],
+            "externalConsole": false,
+            "MIMode": "lldb",
+            "setupCommands": [
+                {
+                    "description": "Enable pretty-printing for gdb",
+                    "text": "-enable-pretty-printing",
+                    "ignoreFailures": true
+                }
+            ],
+            "preLaunchTask": "XCPlite: build hello_xcp_cpp"
+        },
         {
             "name": "Debug cpp_demo",
             "type": "cppdbg",

.vscode/tasks.json

@@ -96,6 +96,29 @@
             "detail": "Build hello_xcp target using CMake",
             "dependsOn": "cmake configure"
         },
+        {
+            "type": "shell",
+            "label": "XCPlite: build hello_xcp_cpp",
+            "command": "cmake",
+            "args": [
+                "--build",
+                "build",
+                "--target",
+                "hello_xcp_cpp"
+            ],
+            "options": {
+                "cwd": "${workspaceFolder}"
+            },
+            "group": {
+                "kind": "build",
+                "isDefault": false
+            },
+            "problemMatcher": [
+                "$gcc"
+            ],
+            "detail": "Build hello_xcp_cpp target using CMake",
+            "dependsOn": "cmake configure"
+        },
         {
             "type": "shell",
             "label": "XCPlite: build c_demo",
@@ -314,10 +337,10 @@
             "args": [
                 "-avz",
                 "--include=\"*.out\"",
-                "--include=\"*.a\"",
+                "--include=\"*.a2l\"",
                 "--exclude=\"*\"",
                 "[email protected]:~/XCPlite-RainerZ/build/",
-                "./build/"
+                "./pi/"
             ],
             "options": {
                 "cwd": "${workspaceFolder}"

CANape.aml

@@ -1,5 +1,5 @@
 
-// /begin A2ML
+/begin A2ML
 
 block "IF_DATA" taggedunion if_data {
 
@@ -166,4 +166,4 @@ block "IF_DATA" taggedunion if_data {
 
 }; // block "IF_DATA"
 
-// /end A2ML
+/end A2ML

CHANGELOG.md

@@ -0,0 +1,96 @@
+# Changelog
+
+All notable changes to XCPlite are documented in this file.
+
+## [V1.0.0]
+
+### Breaking API Changes
+
+
+- XcpInit signature changed to
+```c
+void XcpInit(const char *name, const char *epk, bool activate);
+```
+
+- A2lInit signature changed to
+```c
+    bool A2lInit(const uint8_t addr[4], uint16_t port, bool use_tcp, uint32_t mode);
+```
+
+- CalSeg constructor signature changed, takes a pointer to the default parameters 
+```c
+    CalSeg(const char *name, const T *default_params)
+```
+
+- A2lTypedefBegin gets a pointer to any instance of the type.  
+- A2lTypedefParameterComponent does not need the typename parameter anymore
+- A2lTypedefMeasurementComponent does not need the typename parameter anymore and has a comment parameter
+```c
+{
+    A2lTypedefBegin(ParametersT, &kParameters, "A2L Typedef for ParametersT");
+    A2lTypedefParameterComponent(min, "Minimum random number value", "Volt", -100.0, 100.0);
+    A2lTypedefParameterComponent(max, "Maximum random number value", "Volt", -100.0, 100.0);
+    A2lTypedefEnd();
+} 
+
+- DaqCreateEventInstance does not return the event id anymore, new function DaqGetEventInstanceId to get the event id from the name
+```c
+    DaqCreateEventInstance("task");
+    tXcpEventId task_event_id = DaqGetEventInstanceId("task");
+```
+
+- BIN format changes to enable future feature extensions, old BIN files are not compatible anymore
+
+
+### Added
+- Absolute or relative calibration parameter segment addressing (`OPTION_CAL_SEGMENTS_ABS` in `main_cfg.h`)
+- More flexible addressing scheme configuration (see `xcp_cfg.h`)
+- Generated A2L file uses the `project_no` identifier to indicate the configured addressing schema (currently ACSDD or CASDD)
+- Support for more than one base address in relative address mode, variadic function to trigger event with multiple base addresses
+- Optional async event with 1ms cycle time and prescaler support (`OPTION_DAQ_ASYNC_EVENT` in `main_cfg.h`)
+- Different options to control the behavior of calibration segment persistence and freeze
+- Memory optimization for event/daq-list mapping
+- XCP_ENABLE_COPY_CAL_PAGE_WORKAROUND to enable workaround for CANape init calibration segments bug
+- Variadic macro to create, trigger, and register local and member variables in one call with automatic addressing mode deduction (see hello_xcp_cpp example)
+```c
+    XcpDaqEventExt(avg_calc1, this,                                               //
+                   (input, "Input value for floating average", "V", 0.0, 1000.0), //
+                   (average, "Current calculated average"),                       //
+                   (current_index_, "Current position in ring buffer"),           //
+                   (sample_count_, "Number of samples collected"),                //
+                   (sum_, "Running sum of all samples")
+
+    );
+```
+
+### Changed
+- Signature of `xcplib::CreateCalSeg` changed, pointer to reference page
+- Automatic EPK segment is now optional (`OPTION_CAL_SEGMENT_EPK` in `main_cfg.h`)
+
+### Experimental
+- Tool `bintool` to convert XCPlite-specific BIN files to Intel-HEX format and apply Intel-HEX files to BIN files
+- New demo `no_a2l_demo` to demonstrate workflows without runtime A2L generation (using a XCPlite-specific A2L creator, see README.md of `no_a2l_demo`)
+- New demo 'bpf_demo' to demonstrate usage of XCPlite together with eBPF programs for Linux kernel tracing (see README.md of `bpf_demo`)
+- Internal naming convention refactored to support A2L creation for dynamic objects from ELF/DWARF binaries
+- Rust xcp-lite V1.0.0 uses the calibration segment management of XCPlite instead of implementing its own
+
+### Fixed
+- Various bug fixes
+
+
+
+## [V0.9.2]
+
+### Breaking Changes
+- Breaking changes from V0.6
+
+### Added
+- Lockless transmit queue (works on x86-64 strong and ARM-64 weak memory models)
+- Measurement and read access to variables on stack
+- Calibration segments for lock-free and thread-safe calibration parameter access, consistent calibration changes, and page switches
+- Support for multiple segments with working and reference page and independent page switching
+- Build as a library
+- Used as FFI library for the Rust xcp-lite version
+
+### Changed
+- Refactored A2L generation macros

CMakeLists.txt

@@ -93,9 +93,32 @@ elseif(CMAKE_C_COMPILER_ID STREQUAL "MSVC")
     set(COMMON_WARNING_FLAGS /W3)
 endif()
 
+# Custom build type configurations for debug symbols in release builds
+if(CMAKE_C_COMPILER_ID MATCHES "GNU|Clang")
+    # For Release builds: use -O2 optimization and remove debug symbols and assertions
+    set(CMAKE_C_FLAGS_RELEASE "-O2  -DNDEBUG")
+    set(CMAKE_CXX_FLAGS_RELEASE "-O2  -DNDEBUG")
+    # For RelWithDebInfo builds: release build with moderate optimization and with debug symbols, preserve stack frames
+    # -fno-omit-frame-pointer: Always generate frame pointer for better stack traces
+    # -fno-optimize-sibling-calls: Prevent tail call optimization that can confuse debuggers
+    set(CMAKE_C_FLAGS_RELWITHDEBINFO "-O1 -g -fno-omit-frame-pointer -fno-optimize-sibling-calls -DNDEBUG")
+    set(CMAKE_CXX_FLAGS_RELWITHDEBINFO "-O1 -g -fno-omit-frame-pointer -fno-optimize-sibling-calls -DNDEBUG")
+    # For Debug builds: no optimization, full debug symbols
+    set(CMAKE_C_FLAGS_DEBUG "-O0 -g")
+    set(CMAKE_CXX_FLAGS_DEBUG "-O0 -g")
+    message(STATUS "Custom compiler flags set")
+elseif(CMAKE_C_COMPILER_ID STREQUAL "MSVC")
+    # MSVC equivalent settings
+    set(CMAKE_C_FLAGS_RELEASE "/O2 /Zi /DNDEBUG")
+    set(CMAKE_CXX_FLAGS_RELEASE "/O2 /Zi /DNDEBUG")
+    # /Oy- disables frame pointer omission (equivalent to -fno-omit-frame-pointer)
+    set(CMAKE_C_FLAGS_RELWITHDEBINFO "/O2 /Zi /Oy- /DNDEBUG")
+    set(CMAKE_CXX_FLAGS_RELWITHDEBINFO "/O2 /Zi /Oy- /DNDEBUG")
+    message(STATUS "Custom MSVC flags set")
+endif()
 
 # xcplib sources
-set(xcplib_SOURCES src/xcpAppl.c src/xcpLite.c src/xcpEthServer.c src/xcpEthTl.c src/xcpQueue32.c src/xcpQueue64.c src/a2l.c src/persistency.c src/platform.c)   
+set(xcplib_SOURCES src/xcpAppl.c src/xcpLite.c src/xcpEthServer.c src/xcpEthTl.c src/xcpQueue32.c src/xcpQueue64.c src/a2l.c src/persistence.c src/platform.c)   
 
 set(PROJECT_ROOT ${CMAKE_CURRENT_LIST_DIR})
 message(STATUS "PROJECT_ROOT is: ${PROJECT_ROOT}")
@@ -134,6 +157,13 @@ add_executable(hello_xcp ${hello_xcp_SOURCES})
 target_include_directories(hello_xcp PUBLIC "${PROJECT_ROOT}/inc")
 target_link_libraries(hello_xcp PRIVATE xcplib)
 
+# Example no_a2l_demo
+set(no_a2l_demo_SOURCES examples/no_a2l_demo/src/main.c)   
+set_source_files_properties(${no_a2l_demo_SOURCES} PROPERTIES LANGUAGE C)
+add_executable(no_a2l_demo ${no_a2l_demo_SOURCES})
+target_include_directories(no_a2l_demo PUBLIC "${PROJECT_ROOT}/inc")
+target_link_libraries(no_a2l_demo PRIVATE xcplib)
+
 # Example hello_xcp_cpp
 add_executable(hello_xcp_cpp examples/hello_xcp_cpp/src/main.cpp )
 target_include_directories(hello_xcp_cpp PUBLIC "${PROJECT_ROOT}/inc")
@@ -204,6 +234,11 @@ if(BUILD_TEST)
     add_executable(cal_test test/cal_test/src/main.cpp)
     target_include_directories(cal_test PUBLIC "${PROJECT_ROOT}/inc")
     target_link_libraries(cal_test PRIVATE xcplib)
+
+    # Data acquisition multi-threading test (C version)
+    add_executable(daq_test test/daq_test/src/main.c)
+    target_include_directories(daq_test PUBLIC "${PROJECT_ROOT}/inc")
+    target_link_libraries(daq_test PRIVATE xcplib)
 endif()
 
 
@@ -219,6 +254,7 @@ else()
 
     # Set .out suffix for executables on non-Windows platforms
     set_target_properties(hello_xcp PROPERTIES SUFFIX ".out")
+    set_target_properties(no_a2l_demo PROPERTIES SUFFIX ".out")
     set_target_properties(hello_xcp_cpp PROPERTIES SUFFIX ".out")
     set_target_properties(c_demo PROPERTIES SUFFIX ".out")
     set_target_properties(cpp_demo PROPERTIES SUFFIX ".out")
@@ -231,6 +267,7 @@ else()
         set_target_properties(type_detection_test_cpp PROPERTIES SUFFIX ".out")
         set_target_properties(a2l_test PROPERTIES SUFFIX ".out")
         set_target_properties(cal_test PROPERTIES SUFFIX ".out")
+        set_target_properties(daq_test PROPERTIES SUFFIX ".out")
     endif()
 endif()