AM62x MCU+ SDK  10.01.00
Sciclient Get Version

Introduction

This example demonstrates how to check the version of SYSFW running on the Cortex R5 (DM R5) at run time. Since this is frequently done by bootloaders as a sanity check, there is an API included in the Sciclient driver for checking the SYSFW version.

However, in this example this API is not used, instead the basic Sciclient_service API is used to send a "GET VERSION" request to the SYSFW and get a response back and print it out.

We also fetch the clock frequency of the current CPU using Sciclient and print that out as well, as additional sanity check.

Supported Combinations

Parameter Value
CPU + OS m4fss0-0 nortos
r5fss0-0 freertos
a53ss0-0 freertos
a53ss0-0 nortos
a53ss0-1 freertos
a53ss0-1 nortos
a53ss1-0 freertos
a53ss1-0 nortos
a53ss1-1 freertos
a53ss1-1 nortos
Toolchain ti-arm-clang
arm.gnu.aarch64-none
Board am62x-sk, am62x-sk-lp, am62x-sip-sk
Example folder examples/drivers/sciclient/sciclient_get_version

Steps to Run the Example

  • When using CCS projects to build, import the CCS project for the required combination and build it using the CCS project menu (see Using SDK with CCS Projects).
  • When using makefiles to build, note the required combination and build using make command (see Using SDK with Makefiles)
  • Launch a CCS debug session and run the executable, see CCS Launch, Load and Run
  • To run the example on a53ss0-0, a53ss0-1, a53ss1-0 and a53ss1-1 in FreeRTOS-AMP mode, run the sciclient_get_version_freertos-amp_sbl_uart_hs_fs.cfg file using SBL UART or load and run through CCS individually
    Attention
    As the wake-up R5 is the device manager, it needs to be started by the SBL. So it can not be loaded through CCS. It should be flashed and booted through SBL.
  • Refer Flash an example application for flashing the application.

See Also

SCICLIENT

Sample Output

Shown below is a sample output when the application is run,

SYSFW Version 8.6.0--v08.06.00 (Chill Capybar
Firmware revision 0x15
ABI revision 3.1
[SCICLIENT] CPU clock frequency = 400000000 Hz
All tests have passed!!

FreeRTOS-AMP Sample Output

Attention
Output from a53ss0-1, a53ss1-0 and a53ss1-1 cores are log to the Shared memory, can be viewed via a53ss0-0 on which log reader is enabled

Shown below is a sample output on UART0 console when the application is run,

NOTICE: BL31: v2.11.0(release):v2.11.0-906-g58b25570c
NOTICE: BL31: Built : 16:12:49, Dec 16 2024
SYSFW Firmware Version 10.1.8--v10.01.08 (Fiery Fox)
Firmware revision 0xa
ABI revision 4.0
[SCICLIENT] CPU clock frequency = 1400000000 Hz
All tests have passed on a53_core0 !!
[a530-1] 0.000140s : SYSFW Firmware Version 10.1.8--v10.01.08 (Fiery Fox)
[a530-1] 0.000156s : Firmware revision 0xa
[a530-1] 0.000159s : ABI revision 4.0
[a530-1] 0.000324s : [SCICLIENT] CPU clock frequency = 1400000000 Hz
[a530-1] 0.000328s : All tests have passed on a53_core1 !!
[a531-0] 0.000153s : SYSFW Firmware Version 10.1.8--v10.01.08 (Fiery Fox)
[a531-0] 0.000170s : Firmware revision 0xa
[a531-0] 0.000174s : ABI revision 4.0
[a531-0] 0.000264s : [SCICLIENT] CPU clock frequency = 1400000000 Hz
[a531-0] 0.000268s : All tests have passed on a53_core2 !!
[a531-1] 0.000205s : SYSFW Firmware Version 10.1.8--v10.01.08 (Fiery Fox)
[a531-1] 0.000220s : Firmware revision 0xa
[a531-1] 0.000224s : ABI revision 4.0
[a531-1] 0.000364s : [SCICLIENT] CPU clock frequency = 1400000000 Hz
[a531-1] 0.000368s : All tests have passed on a53_core3 !!