Revision History
CDX Runtime Revision History
This file lists the changes in each CDX Runtime release, newest first.
One release version covers the runtime library, public API, cdx command-line
tool, MATLAB helpers, CMake helpers and example projects. The ZIP filename,
cdx --version and version in release-manifest.json show the installed
release. Version numbers not listed here were not released.
- Major relates to the core dash generation (e.g. CD5x / CD6x).
- Minor More general changes that may cause incompatibilities.
- Revision General fixes and small improvements.
- Patch Minor fixes and improvements. Omitted if zero.
To upgrade, replace the complete cdx-runtime folder as described in
Updating the Runtime.
6.3.0 - 2026-11-12
Compatibility
- Dash Design version 2.4.15+ required for –dash-process
fix.
New
- Added the Simulink Bench example. It shows Model IPC, a 1 ms model step, persistent XCP calibration, fast ADC inputs and urgent physical CAN transmit. It includes a model creation script, a basic Dash Design setup and adapter tests.
- Added the Simulink Projects guide. It covers the initialization script, CDX signals and building from Dash Design CDX Project Tools.
- Added
install-tools.cmdandinstall-tools.ps1to install the required build tools, including Arm GNU Toolchain 15.3.rel2. - CDX CLI: Added
--dash-process <PID>to select a specific running Dash Design instance for embedding, deployment and device listing. CDX Project Tools supplies its own process automatically.
Changed
- Application builds no longer need the exact compiler version recorded in
release-manifest.json. That version now only records which compiler built the bundled libraries. Applications still need anarm-none-eabiGNU compiler (GCC 10.3 or newer) with the Cortex-M4 hard-float settings. cdx.generatenow reads the model’s configuredFixedStep, including model-workspace expressions, to find the model period. It no longer inspects individual block sample times; Simulink checks them during code generation.autois still rejected.- Empty,
nullor whitespace-only tool paths incdx-project.jsonandcdx-project.local.jsonare now treated as not set, including fields written by Dash Design. - Documentation readability improvements.
6.2.4 - 2026-11-10
New
- Project paths, including tool paths in
cdx-project.json, can use Windows%VAR%environment variable references. An undefined variable is reported as a configuration error.
Fixed
- The error for an empty tool path now names the tool concerned.
6.2.3 - 2026-11-06
New
- Added per-channel ADC getter signals for Simulink:
CDX_adc_1_rawtoCDX_adc_8_raw,CDX_adc_1_voltagetoCDX_adc_8_voltageandCDX_adc_1_validtoCDX_adc_8_valid. Callcdx.inputsin your initialization script to define them. MatchingCDX_get_adc_*functions are available incdx_fast_io.h. - Added the XCP station name (
GET_ID ASCII). It defaults to the model target name and can be set withSTATION_NAMEinCDX_RT_configure_model. Named images need display firmware and packaging tools that support image descriptor versions 3 and 4. Older model images still load and reportCD6. - Added
cdxpipelines that combine stages, for examplecompile+embed,build+deployandmatlab+compile+deploy. Pipelines validate every stage before starting and stop on the first failure. - Added incremental MATLAB generation:
cdx buildskips Simulink generation and staging when the recorded inputs and outputs are unchanged. Declare extra dependencies withcodegen_inputs. - Added
cdx compileto build and package already staged sources without starting MATLAB.cdx embedreplacescdx embed-setupto prepare a setup without uploading. - Added
--current-setupto embed into the setup currently open in Dash Design, including unsaved edits. A separate deployment copy is written; the open setup is not saved or renamed. cdx doctor --operation deploynow checks that Dash Design supports the model image formats used by this release.cdx.cliin MATLAB can run anycdxpipeline and option.
Changed
- Migration:
cdx buildnow decides whether Simulink generation is needed before compiling. Scripts that build without MATLAB must usecdx compile. Older command names remain available as aliases. - Updated the offline manual and API reference.
6.2.0 - 2026-10-29
New
- Added low-latency fast I/O for Simulink models (
cdx_fast_io.h):- ADC snapshots refreshed once before each model step, with raw values, validity, sequence and timestamp data stores.
- Urgent physical CAN transmit on CAN1 or CAN2, configured with
urgent_txin Ginmake. Messages can send every step, periodically or when triggered, with per-message status and counters. CDX_RT_configure_simulinkCMake helper to connect a generated model’s initialize and step functions.cdx.adcSampleto supply ADC test data in a Simulink harness.
- Fast I/O needs CD6 firmware with CDX fast I/O support and a Ginmake release
that supports
urgent_tx.
6.1.5 - 2026-10-27
New
- Added
cdx configure --freshto reset the CMake cache, for example after changing compiler. Requires CMake 3.24 or newer.
Changed
cdx cleanwith no options now removes the selected preset’s build outputs while keeping its CMake cache.
6.1.4 - 2026-10-23
Changed
--allow-display-mismatchnow uses the standard Dash Design unattended upload interface. A Dash Design without unattended upload is rejected before uploading.
6.1.3 - 2026-10-23
New
- Added
--allow-display-mismatchtodeployandfull-build-deployfor bench transfer tests on a display that differs from the setup’s display type. It requires an explicit--serial. The setup may not function on that hardware; do not use it for normal deployment.
6.1.2 - 2026-10-23
New
- New quickstart guide covering project creation, tool installation, building, programming a CD6 and updating the runtime.
- Added
setup-cdx.cmdandsetup-cdx.ps1to putcdxon the terminal’sPATH. - Added
cdx embed-setupto prepare a separate deployment copy of a setup, andcdx full-build-embedandcdx full-build-deployto generate, build, embed and optionally upload in one command. - Without
--serial, deployment now selects the first USB display. - Added automatic output filenames using date, time and build number tokens,
such as
{utc:yyyy-MM-dd}and{build}. - The runtime image now provides newlib file, console and process hooks.
These operations report “not supported” (
ENOSYS) instead of causing linker warnings.
Fixed
- Uploading with the 6.1.0 CLI could fail with
Cannot implicitly convert type 'int' to 'bool'.
6.1.0 - 2026-10-23
New
- Added the
cdxcommand-line tool (bin\cdx.exe) to verify the release, check tools, generate, build, package, list devices and deploy models. It is self-contained and needs no separate .NET or PowerShell installation. - Added MATLAB helpers (
cdx.workflow,cdx.generate,cdx.cli) to generate Simulink code, build and runcdxcommands from MATLAB. - Added a Windows simulator DLL build (
CDX_RT_BUILD_SIMULATOR) so models can run and be debugged in the CD6 display simulator. - Added the optional
CDX_USER_HEADERclient header, included by every publiccdx_*.hheader to share your own type definitions.
6.0.2 - 2026-10-16
New
- Added the
bool8_ttype tocdx_utils.h.
6.0.1 - 2026-10-15
New
- Added options to skip release manifest file hash checks when intentionally
using modified runtime files:
-SkipManifestHashesforverify-release.ps1andCDX_RT_VERIFY_MANIFEST_HASHES=OFFfor CMake. A missingrelease-manifest.jsonalso skips manifest checks, with a warning.
Changed
- Minimum Ginmake version is now 2.83. Generated code checks the version directly, so PowerShell is no longer needed for this check.
- Bundled PowerShell scripts are now digitally signed.
6.0.0 - 2026-10-15
First CDX Runtime release.
- Prebuilt Cortex-M4 runtime libraries (Release and Debug) and public
cdx_*.hAPI headers for CAN, DBC packing/unpacking, calibration, memory, time and status reporting. - Model IPC between the CD6 display and the model using DBC files and Ginmake.
- Persistent XCP calibration.
- CMake helpers to build the model and package it as a
.cdxmodelfor import into Dash Design. project-templateandechoexample projects.- Release manifest and verification of the runtime files.
- Offline manual and API reference.