user: Add "Test a Board Support Package (BSP)"

This commit is contained in:
Sebastian Huber 2019-01-23 14:29:04 +01:00
parent fa12cab2b9
commit d2827cbcb4
3 changed files with 69 additions and 0 deletions

66
user/start/bsp-test.rst Normal file
View File

@ -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 <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

View File

@ -22,6 +22,7 @@ applications on top of RTEMS.
tools tools
bootstrap bootstrap
bsp-build bsp-build
bsp-test
The following is a quick start guide that provides a basic set of commands to 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 build the RTEMS Tools and Kernel. The quick start guide provides links to the

View File

@ -2,6 +2,8 @@
.. Copyright (C) 2018 Chris Johns <chrisj@rtems.org> .. Copyright (C) 2018 Chris Johns <chrisj@rtems.org>
.. _Testing:
Testing Testing
******* *******