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.cmd and install-tools.ps1 to 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 an arm-none-eabi GNU compiler (GCC 10.3 or newer) with the Cortex-M4 hard-float settings.
  • cdx.generate now reads the model’s configured FixedStep, including model-workspace expressions, to find the model period. It no longer inspects individual block sample times; Simulink checks them during code generation. auto is still rejected.
  • Empty, null or whitespace-only tool paths in cdx-project.json and cdx-project.local.json are 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_raw to CDX_adc_8_raw, CDX_adc_1_voltage to CDX_adc_8_voltage and CDX_adc_1_valid to CDX_adc_8_valid. Call cdx.inputs in your initialization script to define them. Matching CDX_get_adc_* functions are available in cdx_fast_io.h.
  • Added the XCP station name (GET_ID ASCII). It defaults to the model target name and can be set with STATION_NAME in CDX_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 report CD6.
  • Added cdx pipelines that combine stages, for example compile+embed, build+deploy and matlab+compile+deploy. Pipelines validate every stage before starting and stop on the first failure.
  • Added incremental MATLAB generation: cdx build skips Simulink generation and staging when the recorded inputs and outputs are unchanged. Declare extra dependencies with codegen_inputs.
  • Added cdx compile to build and package already staged sources without starting MATLAB. cdx embed replaces cdx embed-setup to prepare a setup without uploading.
  • Added --current-setup to 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 deploy now checks that Dash Design supports the model image formats used by this release.
  • cdx.cli in MATLAB can run any cdx pipeline and option.

Changed

  • Migration: cdx build now decides whether Simulink generation is needed before compiling. Scripts that build without MATLAB must use cdx 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_tx in Ginmake. Messages can send every step, periodically or when triggered, with per-message status and counters.
    • CDX_RT_configure_simulink CMake helper to connect a generated model’s initialize and step functions.
    • cdx.adcSample to 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 --fresh to reset the CMake cache, for example after changing compiler. Requires CMake 3.24 or newer.

Changed

  • cdx clean with no options now removes the selected preset’s build outputs while keeping its CMake cache.

6.1.4 - 2026-10-23

Changed

  • --allow-display-mismatch now 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-mismatch to deploy and full-build-deploy for 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.cmd and setup-cdx.ps1 to put cdx on the terminal’s PATH.
  • Added cdx embed-setup to prepare a separate deployment copy of a setup, and cdx full-build-embed and cdx full-build-deploy to 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 cdx command-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 run cdx commands 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_HEADER client header, included by every public cdx_*.h header to share your own type definitions.

6.0.2 - 2026-10-16

New

  • Added the bool8_t type to cdx_utils.h.

6.0.1 - 2026-10-15

New

  • Added options to skip release manifest file hash checks when intentionally using modified runtime files: -SkipManifestHashes for verify-release.ps1 and CDX_RT_VERIFY_MANIFEST_HASHES=OFF for CMake. A missing release-manifest.json also 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_*.h API 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 .cdxmodel for import into Dash Design.
  • project-template and echo example projects.
  • Release manifest and verification of the runtime files.
  • Offline manual and API reference.