Knowledge Base

Everything you need to know and understand to develop V2X applications.

Get started
denm-generator.py
msg = self.generate_denm()
future = self.send_request(msg)
future.add_done_callback(self.request_completed)

System Updates

The cube:evk supports secure over-the-air and local software updates using the SWUpdate framework. This mechanism ensures that firmware and software components can be safely upgraded in the field without user intervention through complex terminal commands.

1. Overview

System updates are distributed as .swu (Software Update) packages. Each file contains the necessary software components (e.g., OS image, application containers, configuration files) and metadata for version control and integrity verification.

Whenever a new software release is available, customers receive an email notification containing:

  • A short description of the release
  • The corresponding .swu update file download link
  • Instructions for performing the update

2. Performing an Update

To install an update, follow these steps:

Step 1: Download the Update File

Download the .swu file from the link provided in the update email and store it on your host computer.

Step 2: Connect to the EVK

Ensure your cube:evk is powered on and connected to the same network as your host computer. Find the EVK’s IP address (for example, via ip a or your router’s device list).

Step 3: Open the Update Interface

Open a web browser and navigate to:

http://<evk-ip>:8080

For example:

http://192.168.0.101:8080

The SWUpdate web interface will appear, showing the device information and update form. At the bottom right corner of the page, the current cube:os version installed on your EVK is displayed. You can use this to confirm the running version before starting an update.

Step 4: Upload the Update File

Follow the instructions and select the downloaded .swu package to start the installation process.

During this process:

  • The system verifies the integrity and signature of the update file.
  • The update is installed atomically, ensuring system safety in case of power loss or interruption.
  • Progress is shown in the browser window.

Step 5: Automatic Reboot

After the update completes, the EVK will automatically restart to activate the new firmware. This process usually takes less than two minutes.

3. Verifying Update Success

After the system reboots, reconnect via SSH or the web interface and check the software version:

cube:~$ lsb_release -a

The version information should match the release noted in the update email and the version previously shown in the web interface. If any issues occur during installation, SWUpdate automatically rolls back to the previous working image, ensuring continuous system operability.

4. Security and Integrity

All update packages are:

  • Digitally signed to prevent unauthorized or corrupted software installations
  • Checksum-verified during upload
  • Applied atomically to avoid partial updates or inconsistent states

These measures ensure that updates are reliable, authenticated, and safe to install.

Next
Build Tools