Skip to content

Enable Logging

Overview

Logs can be recorded from the Arm Cortex-M33 core and accessed in Linux (running on the Arm Cortex-A55 core). These logs contain debug information outputted by the firmware during inference execution. This includes pure inference timings recorded by TFLite Micro that provides an execution breakdown for each operator.

Warning

The logs are disabled by default as it impacts inference performance.

Environment Setup

Note

The procedure documented in this page is executed in a Windows environment. If using a different OS (e.g. Linux) to run e2 studio, the appearance may look slightly different from the following screenshots but the same steps still apply.

  1. Download e2studio installer on the Host PC from Renesas RZ FSP GitHub releases page.

  2. After opening the page, locate the installer named setup_rzfsp_v4_1_0_e2s_* in the Assets section.

    1. Windows: file ending in .exe.
    2. Linux: file ending in .run.

  3. Once the installer has been downloaded, run the file on the Host PC.

    1. On the setup page, please select GNU ARM Embedded 13.3-Rel1 for GCC Toolchains && Utilities.

    e2studio Setup Page
    e2studio Setup Page

  4. Once the installation is completed, open e2studio.

  5. Go to File -> Import, then select Existing Projects into Workspace and click Next.

    e2studio Import Page
    e2studio Import Page

  6. Check the Select archive file option and enter the path to e2studio_rzg3e-ethos-u-firmware_cm33_project.zip file ensuring the project is selected in the Projects window, then click Finish.

    1. The project should now be visible in the Project Explorer located on the left side of the e2studio GUI.

    Importing Ethos-U Firmware Project In e2studio
    Importing Ethos-U Firmware Project In e2studio

Modifications To Firmware

  1. Double-click the configurations.xml file located in the Project Explorer view.

  2. In the Stacks Configuration window, go to the Stacks tab.

    Opening Stacks Configuration In e2studio
    Opening Stacks Configuration In e2studio

  3. Locate and click the Arm Ethos-U Core Driver Wrapper (rm_ethosu) module.

  4. In the Properties window, adjust the log verbosity level by clicking the value next to Debug log level.

    1. Change from RM_ETHOS_LOG_LEVEL_OFF to the preferred log level (e.g. RM_ETHOS_LOGL_LEVEL_DEBUG).
    2. Once the preferred log level is selected, click Generate Project Content.

    Changing Debug Log Level In e2studio
    Changing Debug Log Level In e2studio

Build Procedure

  1. Right-click the project in the Project Explorer view and select Build Project.

  2. Once the build is completed, messages like the ones seen in the image below will appear in the console window.

    Build Firmware In e2studio
    Build Firmware In e2studio

  3. The built firmware file rzg3e-ethos-u-firmware.elf is generated in the Debug folder.

Deploying Firmware

To deploy the built Ethos-U firmware onto the Linux rootfs, follow the steps below.

  1. Power OFF the board if it is currently on.

  2. Remove the SD Card from the board and connect it to Linux Host PC.

  3. Copy the rzg3e-ethos-u-firmware.elf file from Windows PC to the home directory on the Linux Host PC.

  4. On the Linux Host PC, navigate to the SD Card's root directory.

  5. Copy the firmware file to the /lib/firmware/ directory on the SD Card.

    sudo cp rzg3e-ethos-u-firmware.elf /media/user/root/lib/firmware/

  6. Make sure all of the data has been written to the SD Card.

    sync

  7. Eject and remove the SD Card from Linux Host PC.

  8. Connect the formatted SD Card to the uSD0 slot on the RZ/G3E.

  9. Finally, power ON on the board to load the updated firmware.

  1. Power OFF the board if it is currently on.

  2. Copy the rzg3e-ethos-u-firmware.elf file from Windows PC to the home directory on the Linux Host PC.

  3. On Linux Host PC, navigate to the TFTP or NFS root directory.

  4. Copy the firmware file to the /lib/firmware directory with that path.

    sudo cp rzg3e-ethos-u-firmware.elf /tftpboot/rzg3e/lib/firmware/

  5. Finally, power ON on the board to load the updated firmware.

Viewing Logs

Once the updated firmware is deployed, the logs can be viewed from the boards serial console using the following command:

cat /sys/kernel/debug/remoteproc/remoteproc0/trace0

This will print the logs stored in the remoteproc buffer. Example log after boot-up:

[0.000] Info: Starting the Ethos-U firmware...
[0.002] Info: Initializing NPU: base_address=0x49c80000, fast_memory=0x0, fast_memory_size=0, secure=1, privileged=1
[0.003] Info: Soft reset NPU
[0.005] Info: New NPU driver registered (handle: 0x0x80089248, NPU: 0x0x49c80000)
[0.005] Info: Initializing the Ethos-U remoteproc...
[0.007] Debug [remoteproc.cpp:init:124]:
[0.008] Debug [remoteproc.cpp:RProc:66]: setting up resource table
[0.010] Debug [remoteproc.cpp:RProc:67]: rsc_addr=0x80087B90, tableSize=233
[0.012] Debug [remoteproc.cpp:RProc:74]: setting up vdev
[0.013] Debug [remoteproc.cpp:RProc:81]: creating notify task
[0.015] Debug [remoteproc.cpp:notifyTask:110]: Starting message notify task
[0.016] Info: Initializing the Ethos-U Message Handler...
[0.018] Debug [remoteproc.cpp:notify:158]: