From d2827cbcb497aeb28e7f5597bb1c94a22bc88c24 Mon Sep 17 00:00:00 2001 From: Sebastian Huber Date: Wed, 23 Jan 2019 14:29:04 +0100 Subject: user: Add "Test a Board Support Package (BSP)" --- user/start/bsp-test.rst | 66 +++++++++++++++++++++++++++++++++++++++++++++++++ user/start/index.rst | 1 + user/testing/index.rst | 2 ++ 3 files changed, 69 insertions(+) create mode 100644 user/start/bsp-test.rst (limited to 'user') diff --git a/user/start/bsp-test.rst b/user/start/bsp-test.rst new file mode 100644 index 0000000..5278375 --- /dev/null +++ b/user/start/bsp-test.rst @@ -0,0 +1,66 @@ +.. SPDX-License-Identifier: CC-BY-SA-4.0 + +.. Copyright (C) 2019 embedded brains GmbH +.. Copyright (C) 2019 Sebastian Huber + +.. _QuickStartBSPTest: + +Test a Board Support Package (BSP) +================================== + +You built a BSP with tests in the previous section. We built the ``erc32`` BSP +in :file:`$HOME/quick-start/build/b-erc32`. + +You should run the RTEMS test suite on your target hardware. The RTEMS Project +provides some support to do this, see the :ref:`Testing ` chapter for +the details. + +On the ``erc32`` BSP we selected for this quick start chapter this is easy. +Just run this command: + +.. code-block:: none + + cd $HOME/quick-start/build/b-erc32 + rtems-test --rtems-bsp=erc32 --rtems-tools=$HOME/quick-start/rtems/5 . + +This command should output something like this (omitted lines are denoted by +...). In this output the base directory :file:`$HOME/quick-start` was replaced +by ``$BASE``. + +.. code-block:: none + + RTEMS Testing - Tester, 5.0.not_released + Command Line: $BASE/rtems/5/bin/rtems-test --rtems-bsp=erc32 --rtems-tools=$BASE/rtems/5 . + Python: 2.7.15 (default, Jan 10 2019, 01:14:47) [GCC 4.2.1 Compatible FreeBSD Clang 6.0.1 (tags/RELEASE_601/final 335540)] + Host: FreeBSD-12.0-RELEASE-p2-amd64-64bit-ELF (FreeBSD Build_FreeBSD12 12.0-RELEASE-p2 FreeBSD 12.0-RELEASE-p2 GENERIC amd64 amd64) + [ 1/589] p:0 f:0 u:0 e:0 I:0 B:0 t:0 i:0 W:0 | sparc/erc32: dhrystone.exe + ... + [589/589] p:574 f:0 u:5 e:0 I:0 B:3 t:0 i:0 W:0 | sparc/erc32: tmtimer01.exe + + Passed: 580 + Failed: 0 + User Input: 5 + Expected Fail: 0 + Indeterminate: 0 + Benchmark: 3 + Timeout: 1 + Invalid: 0 + Wrong Version: 0 + Wrong Build: 0 + Wrong Tools: 0 + ------------------ + Total: 589 + User Input: + monitor.exe + termios.exe + top.exe + fileio.exe + capture.exe + Benchmark: + whetstone.exe + linpack.exe + dhrystone.exe + Timeouts: + pppd.exe + Average test time: 0:00:00.437773 + Testing time : 0:04:17.848557 diff --git a/user/start/index.rst b/user/start/index.rst index 00a3644..a9c9a6a 100644 --- a/user/start/index.rst +++ b/user/start/index.rst @@ -22,6 +22,7 @@ applications on top of RTEMS. tools bootstrap bsp-build + bsp-test The following is a quick start guide that provides a basic set of commands to build the RTEMS Tools and Kernel. The quick start guide provides links to the diff --git a/user/testing/index.rst b/user/testing/index.rst index 4596339..7eefff1 100644 --- a/user/testing/index.rst +++ b/user/testing/index.rst @@ -2,6 +2,8 @@ .. Copyright (C) 2018 Chris Johns +.. _Testing: + Testing ******* -- cgit v1.2.3