Determine Image Version and Hardware Key

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

Motorcortex consists out of an application and libraries that each have a version associated with them. Sometimes it is necessary to determine the version of these components in a running system to check if updates are available or if dependencies are met.

Each host system generates its own unique hardware key. The hardware key is required when validating licenses.

Following steps are performed in the terminal after logged in to the controller.

1. Check Image Version:

   cat /etc/issue
   

   Information similar to the following will be shown:

   Motorcortex 2022.09-0-g7adb1a0 \n \l
   

2. Check Hardware Key, Application and Library versions via log:

   mcx-lastlog
   

   Scroll up until you find information similar to the following:

   Motorcortex-core version: 2.8.3-0-gb17d29f9_release
   Robot-app version: 1.5.2-0-ge6e70edc_release
   Motorcortex-math version: 2.1.0-2-g7828ea9_release
   Motorcortex-control version: 2.2.0-0-g16974cd_release
   Motorcortex-motion version: 2.5.3-0-g2cc2fc9_release
   Hardware key: 17680423976042648958
   List of components: mcx-core2 mcx-io2 mcx-math2 mcx-motion2 mcx-control2 mcx-robot-app1 
   License is valid.
   

3. Or check Hardware Key via license check:

   mcx-license-check
   

   Information similar to the following will be shown:

   The license does match the hardware.
   The license does contain the required components.
   
   License information:
   File: /etc/motorcortex/config/17680423976042648958.lic
   Hardware key: 1768 0423 9760 4264 8958 
   Components: mcx-control2, mcx-core2, mcx-io2, mcx-math2, mcx-motion2, mcx-robot-app1
   
   Application information:
   File: /usr/local/bin/motorcortex-robot
   Hardware key: 1768 0423 9760 4264 8958 
   Components: mcx-core2, mcx-io2, mcx-math2, mcx-motion2, mcx-control2, mcx-robot-app1
   

Older Versions