# Release notes

CODESYS

---

## 3.5.21.20-10

2025-11-14

### Supported Platform(s)

- V700 (v700)
- V510, V705, V710 (vx10)
- V1000, V1200 (v1x00)
- V1090, V1290 (v1x90)

### Distribution Format

**RAUC Bundles** - Starting with this release, CODESYS Runtime is distributed as RAUC (Robust Auto-Update Controller) bundles for CCLinux OS 4.2.0 and later.

### Included components

RAUC bundles per device type:
- codesys-ccl4_novisu_V3.5.21.20-X_\<device\>.raucb
- codesys-ccl4_visu_V3.5.21.20-X_\<device\>.raucb
- codesys-ccl4_webvisu_V3.5.21.20-X_\<device\>.raucb
- codesys-ccl4_visuwebvisu_V3.5.21.20-X_\<device\>.raucb
- codesys-ccl4_V3.5.21.20-X_\<device\>.devdesc.xml

Each bundle includes:
- CODESYS Runtime V3.5.21.20
- Qt 5.15.9 runtime libraries
- CodeMeter licensing framework
- CCAux.library (latest version)
- CCSap.library (latest version)
- libCCAux.so
- libCCSap.so
- libCCCamera.so
- systemd service files for automatic startup

### Dependencies

- CCLinux OS 4.2.0 or later
- RAUC update framework
- libcc-aux2.so v.3.1.0+
- libsapcore.so v.3.1.4+

### Changes/Included features

- **RAUC Bundle Distribution**: Packages now delivered as signed RAUC bundles with atomic updates and rollback capability
- **Multi-Device Support**: Separate builds for V700, V1X00, VX10, V1X90 device families
- **Secure Updates**: dm-verity filesystem verification and cryptographic signatures
- **Automatic Configuration**: Post-installation handler automatically configures CodeMeter and CODESYS settings
- **systemd Integration**: CODESYS and CodeMeter services configured for automatic startup
- **Improved Packaging**: Device-specific bundles optimized for each hardware platform
- **CCAux API**: CODESYS CCAux Component updated to match v3.1.0.0+
- New [CODESYS RT Version 3.5.21.20](https://www.codesys.com/)

### Installation

RAUC bundles are installed via the RAUC command:
```sh
rauc install /path/to/codesys-ccl4_<variant>_V3.5.21.20-X_<device>.raucb
```

See [RAUC Bundle Installation Guide](RAUC-Bundles.md) for detailed instructions.

### Migration from Previous Versions

- Previous IPK-based installations are **not** automatically upgraded
- Manual migration required for existing CCLinux 3.x systems
- Recommended: Fresh installation on CCLinux OS 4.2.0 or later

### Known issues/Deviations

- RAUC bundles require CCLinux OS 4.2.0 minimum
- Not compatible with CCLinux OS 3.x (use IPK packages for older systems)

---

## 3.5.19.20-1.3

2024-05-06

### Supported Platform(s)

- V700, V510, V710, V1000, V1200

### Included components

- codesys-novisu_V3.5.19.20-1.3_aarch64.ipk
- codesys-visu_V3.5.19.20-1.3_aarch64.ipk
- codesys-webvisu_V3.5.19.20-1.3_aarch64.ipk
- codesys-visuwebvisu_V3.5.19.20-1.3_aarch64.ipk
- CODESYS_V3.5.19.20-1.3_imx8.devdesc.xml
- CCAux.library v.3.5.8.0
- CCSap.library v.3.5.11.0
- libCCAux.so v.1.0.8  
- libCCSap.so v.1.1.0
- libCCCamera.so v.1.0.0  
- RELEASENOTES.pdf

### Dependencies

- libcc-aux2.so v.2.19.0
- libsapcore.so v.3.1.4

### Changes/Included features

- New [CODESYS RT Version 3.5.19.20](https://www.codesys.com/news-events/news/article/release-codesys-v35-sp19.html)
- CodeMeter, soft license support
- Webengine/Webbrowser support
- Improved SVG-full image support
- Updated CCAux component and library to API version 2.19.0 (softbutton and I/O functions improved)

### Known issues/Deviations

---

## 3.5.17.30-1.1

2022-06-30

### Supported Platform(s)

- V700, V1000, V1200

### Included components

- codesys-novisu_V3.5.17.30-1.1_aarch64.ipk
- codesys-visu_V3.5.17.30-1.1_aarch64.ipk
- codesys-webvisu_V3.5.17.30-1.1_aarch64.ipk
- codesys-visuwebvisu_V3.5.17.30-1.1_aarch64.ipk
- CODESYS_V3.5.17.30-1.1_imx8.devdesc.xml
- CCAux.library v.3.5.7.0
- CCSap.library v.3.5.11.0
- libCCAux.so v.1.0.7  
- libCCSap.so v.1.1.0
- libCCCamera.so v.1.0.0  
- RELEASENOTES.pdf

### Dependencies

- libcc-aux2.so v.2.18.6
- libsapcore.so v.3.1.4

### Changes/Included features

- New [CODESYS RT Version 3.5.17.30](https://www.codesys.com/news-events/news/article/release-codesys-v35-sp17-2.html)
- New CCCamera component with Eth camera support. Read the docs for more info.
- Example project "CameraViewExample" showing CCCamera integration.
- Updated CCAux component and library to API version 2.18.6
- Changed frame-buffer backend from eglfs_kms to eglfs_viv
- Added SVG image support
- Fixed issue [CODESYS-117] Wait for CANdriver to load during boot

### Known issues/Deviations

- CodeMeter (soft license container) fails initialization

---

## 3.5.16.40

2021-03-04

### Supported Platform(s)

- XA/XS, VI2/VS, VA/VC, V700, X900

### Included components

- CoDeSys_novisu_ARM_iMX8_device_V3.5.16.40.run
- CoDeSys_visu_ARM_iMX8_device_V3.5.16.40.run
- CoDeSys_webvisu_ARM_iMX8_device_V3.5.16.40.run
- CoDeSys_visuwebvisu_ARM_iMX8_device_V3.5.16.40.run
- CCpilot_iMX8.devdesc.xml
- CCAux.library v.3.5.6.0
- CCSap.library v.3.5.11.0
- libCCAux.so v.1.0.6  
- libCCSap.so v.1.1.0  
- CODESYS-imx8-Release-notes.pdf

### Dependencies

- libcc-aux2.so v.2.17.5
- libsapcore.so v.3.1.3

### Changes/Included features

- New CODESYS RT Version 3.5.16.40
- EdgeGateway now included in RT
- Configuration file updated with following additions
- [CmpSchedule] DisableOmittedCycleWatchdog=1
  - [SysMem] Linux.Memlock=0            Required for VISU display
  - [SysCom] Linux.Devicefile=/dev/tty0 Serial comm settings
  - [SysProcess] Command=AllowAll       SysProcess calls allowed
  - [SysCpuHandling] Linux.DisableCpuDmaLatency=1
  - [CmpEdgeGateway] MaintenanceMode=1  EdgeGateway allowed config
- Fixed 64 bit support in libCCSap for Data Engine connection
- Fixed local gateway issue
- Fixed update of VISU when deploying updated application
- Fixed 16-bit colour depth on VISU graphics

### Known issues/Deviations

- None

---
