From 1e849d55bdb5743e60a3274d2e94c23d09454516 Mon Sep 17 00:00:00 2001 From: github-actions Date: Fri, 9 Aug 2024 12:20:04 +0000 Subject: [PATCH] Update main documentation --- main/examples/html/footer.js | 2 +- main/infrastructure/html/footer.js | 2 +- main/overview/html/footer.js | 2 +- main/simulation/html/Hints.html | 6 +++--- main/simulation/html/footer.js | 2 +- 5 files changed, 7 insertions(+), 7 deletions(-) diff --git a/main/examples/html/footer.js b/main/examples/html/footer.js index 8f63adf..d8482af 100644 --- a/main/examples/html/footer.js +++ b/main/examples/html/footer.js @@ -1,3 +1,3 @@ function writeFooter() { - document.write('Generated on Fri Aug 9 2024 08:50:17 for Examples Version 2.0.0 by Arm Ltd. All rights reserved.'); + document.write('Generated on Fri Aug 9 2024 12:18:51 for Examples Version 2.0.0 by Arm Ltd. All rights reserved.'); }; diff --git a/main/infrastructure/html/footer.js b/main/infrastructure/html/footer.js index 4c66743..61cade2 100644 --- a/main/infrastructure/html/footer.js +++ b/main/infrastructure/html/footer.js @@ -1,3 +1,3 @@ function writeFooter() { - document.write('Generated on Fri Aug 9 2024 08:50:17 for Infrastructure Version 2.0.0 by Arm Ltd. All rights reserved.'); + document.write('Generated on Fri Aug 9 2024 12:18:51 for Infrastructure Version 2.0.0 by Arm Ltd. All rights reserved.'); }; diff --git a/main/overview/html/footer.js b/main/overview/html/footer.js index 466cf32..213577e 100644 --- a/main/overview/html/footer.js +++ b/main/overview/html/footer.js @@ -1,3 +1,3 @@ function writeFooter() { - document.write('Generated on Fri Aug 9 2024 08:50:17 for Overview Version 2.0.0 by Arm Ltd. All rights reserved.'); + document.write('Generated on Fri Aug 9 2024 12:18:52 for Overview Version 2.0.0 by Arm Ltd. All rights reserved.'); }; diff --git a/main/simulation/html/Hints.html b/main/simulation/html/Hints.html index 00270be..1ad0c35 100644 --- a/main/simulation/html/Hints.html +++ b/main/simulation/html/Hints.html @@ -210,7 +210,7 @@

Performance index : 0.43
cpu_core.cpu0 : 68.40 MIPS ( 65196784 Inst)
-------------------------------------------------------------------------------
- Also see corresponding section in the Fast Models User Guide. + Also see section Displaying the total execution time in the Fast Models User Guide.
  • CMSIS-View utility can be used to measure and analyze timing between events in the program, including statistical data. To store the log files on FVPs, semihosting shall be enabled. CMSIS-View annotations can also be reused for event analysis and time measurement on real hardware.
  • Model Configuration parameters can be used to control and impact the execution timing:
    • With Cycle Per Instruction (CPI) settings cpi_div and cpi_mul.
      • @@ -219,11 +219,11 @@

    Chapter Timing Annotations in the Fast Models User Guide explains the performance estimation concept as implemented in the underlying FastModels technology. Note that the FVPs are built with Timing Annotations enabled (FASTSIM_DISABLE_TA set to 0).
    • -

    For interaction with external world such as via [virtual interfaces] or Semihosting I/O the timing differences need to be taken into account as explain in Timing-considerations-for-FVPs.

    +

    For interaction with external world such as via Virtual Streaming Interface (VSI) or Semihosting I/O the timing differences need to be taken into account as explain in Timing-considerations-for-FVPs.

    Execution stop

    Embedded applications typically run with an infinite loop that ensures continuous program execution. But for executing regression tests as part of Continuous Integration (CI) workflows it is often required that program execution is stopped after a test is completed, so that the next test can be started.

    -

    FVP command line option --simlimit can be used to stop execution after specified amount of seconds, for example, for 20 seconds, use --simlimit 20.

    +

    FVP command line options --cpulimit, --cyclelimit, --timelimit and --simlimit can be used to stop execution after specified activity time, for example, for 20 wall-clock seconds, use --timelimit 20. See FVP command line options for more details.

    FVP models have shutdown_on_eot parameter that enables simple implementation of program exit. The parameter should be set in the Model Configuration, for example for FPV_Corstone_SSE-300:

    mps3_board.uart0.shutdown_on_eot=1 # (bool, init-time) default = '0' : Shutdown simulation when a EOT (ASCII 4) char is transmitted (useful for regression tests when semihosting is not available)

    And then to trigger the shutdown, a EOT (ASCII 4) symbol can be transmitted to the corresponding serial interface from the program. The code below demonstrates an example, where the execution is stopped after target execution count is achieved. In this implementation the STDIO is assumed to be retargeted to the UART0:

    diff --git a/main/simulation/html/footer.js b/main/simulation/html/footer.js index 52052e2..bdb16aa 100644 --- a/main/simulation/html/footer.js +++ b/main/simulation/html/footer.js @@ -1,3 +1,3 @@ function writeFooter() { - document.write('Generated on Fri Aug 9 2024 08:50:21 for AVH FVP models Version 2.0.0 by Arm Ltd. All rights reserved.'); + document.write('Generated on Fri Aug 9 2024 12:18:58 for AVH FVP models Version 2.0.0 by Arm Ltd. All rights reserved.'); };