Determine Image Version and Hardware Key

How to determine your Software version and Hardware key

  2 minute read  

This page is applicable for the latest image version mcx-rtos-v.2025.03. For other mcx-rtos-images checkout: Older versions.

Motorcortex applications can be deployed, to a controller with a mcx-rtos installed. An application is composed of modules, each with its own version, and a configuration that allows you to enable or disable specific features. By default, without a license, you can use the Motorcortex application for up to 30 minutes for testing purposes. After this period, the application will stop and must be restarted to continue use. For production environments, a valid license is required to operate beyond this time limit.

Each mcx-rtos system generates its own unique hardware key. The hardware key, modules and features are required when validating licenses.

Determine Image version:

The following steps are performed in the Cockpit web interface.

  1. Log in to Cockpit.

  2. Check Image Version, the Cockpit Overview tab displays the running mcx-rtos version.

    For example:

    Motorcortex-RTOS 2025.03-0-g0e9d0e9 (kirkstone)

  3. Check Hardware Key, Application and Library versions via terminal:

    Use the following command:

    mcx-lastlog | less

    Scroll up until you find information similar to the following:

    Motorcortex-core version: 2.17.11-0-g9751a37_release
Robot-app version: 3.9.0-0-g314e8a9_release
Motorcortex-core version: 2.17.11-0-g9751a37_release
Motorcortex-math version: 2.9.4-0-g47f81d2_release
Motorcortex-control version: 3.11.0-0-g64b85bc_release
Motorcortex-udp version: 1.4.1-0-g56a4383_release
Motorcortex-agv version: 1.8.0-0-g8a68165_release
Hardware key: 17404989201435172437
List of components: mcx-core2 mcx-io2 mcx-math2 mcx-control33 mcx-mechanics1 mcx-udp1 mcx-robot-app3 mcx-agv1 
List of features: AxesControl#9 Bartending#1 Joystick#3 MachineControl#6 ManipulatorControl#1 SafetyChannelSelector#4 SetpointGenerator#3 SignalGenerator#4 Tool6DofAdmittance#1 UdpComm#1 UserFrame#3 WeavingMotion#1
License is valid.

Older Versions