Skip to content

README.md

Latest commit

 

History

History
81 lines (51 loc) · 3.59 KB

README.md

File metadata and controls

81 lines (51 loc) · 3.59 KB
Raw

ARCH

Trace and Core Engine Monitoring Abstraction Layers for SystemView

Overview

MicroEJ C module: LLTRACE SystemView and LLMJVM_MONITOR SystemView.

This module implements the LLTRACE and LLMJVM_MONITOR Low Level APIs for a MicroEJ VEE Port with SystemView integrated.

LLTRACE and LLMJVM_MONITOR implementations are required to use the Event Tracing with the Trace API, see the related documentation:

See also the MicroEJ documentation for a description of the LLTRACE and LLMJVM_MONITOR functions:

This implementation has a configuration file, LLTRACE_sysview_configuration.h.

Usage

  1. These sources can be included in the VEE Port with the method you prefer, by using this repository as a submodule or by doing a copy of the sources in the VEE Port repository.

  2. The configuration file LLTRACE_sysview_configuration.h stores default values of the abstraction layer configuration. If you want to update a configuration, please edit or create the file veeport_configuration.h and set the desired value. This setting overwrites the content of LLTRACE_sysview_configuration.h. If your VEE Port does not print logs using printf, the trace redirection macro LLTRACE_SYSVIEW_LOG can be updated in veeport_configuration.h.

Requirements

N/A

Validation

Here is a non exhaustive list of tested environments:

  • Hardware
    • STMicroelectronics STM32U5G9 custom board.
  • Compilers / Integrated Development Environments:
    • IAR Embedded Workbench 9.60.4
  • SEGGER SystemView versions:
    • V3.58
    • V3.60e

MISRA Compliance

This implementation is MISRA-compliant (MISRA C:2012) with some noted exception. It has been verified with Cppcheck v2.13. Here is the list of deviations from MISRA standard:

Deviation Category Justification
Rule 8.4 Required A compatible declaration is defined in headers provided by the VEE Port.
Rule 8.7 Advisory API function, external linkage mandatory.
Rule 8.9 Advisory Define here for code readability even if it called once in this file.
Rule 17.7 Required The use of returned values of debug traces is not necessary
Rule 21.6 Required The Standard Library input/output is only used for debug purpose by default.

Dependencies

  • MicroEJ Architecture 8.x or higher.
  • SEGGER SystemView V3.58 or higher.
  • C module com.microej.clibrary.thirdparty.systemview 2.0.0 or higher.

Source

N/A

Restrictions

None.

Copyright 2017-2025 MicroEJ Corp. All rights reserved. Use of this source code is governed by a BSD-style license that can be found with this software.