BSP test doesn't work

RTEMS6.1 user manual, ch 2.6:

cd $HOME/quick-start/src/rtems
2 rtems-test --rtems-bsp=erc32-sis build/sparc/erc32
  1. This won’t work.
    rtems-test lives in $HOME/quick-start/rtems/6/bin
    Is the base folder above correct and should the path to rtems-test be included?

  2. What is the ‘-sis’ suffix? Any guidance for other architectures?

  3. Must the path at the end (build/sparc/erc32) exist? In my case (trying to build for aarch64), all I see under the base path above is build/tmp/sb-1000

(1) I agree that rtems-test lives in the directory you cite. That directory needs to be in your PATH or you need to invoke it with a fully qualified filename. If that’s not clear from the documentation file an issue and patch appreciated.

(2) The erc32 and leon* BSPs are interesting in that they can run on multiple simulators. Depending on the BSP, it may run on sis, qemu, and tsim in addition to real hardware. The “-sis” suffix tells rtems-test to use the erc32 configuration erc32-sis which runs on sis. sis is the SPARC Instruction Simulator which now supports both SPARC and RISC-V.

(3) Yes. That’s the default output directory when you build RTEMS for sparc/erc32. In your case, it would be something like build/aarch64/WHATEVER_BSP_YOU_CONFIGURED_FOR. The temporary directory being there likely indicates something went wrong. Do a *find . -name "exe" from the top of the RTEMS tree. If you built for sparc/erc32 and then built for aarch64/SOME_BSP, then it is possible the build got confused. Doing waf distclean between the builds of different BSPs should avoid that.

This brings up a naming conflict with rtems-test versus waf and other usages of --rtems-bsp or --rtems-bsps. Really, rtems-test takes a test configuration as the argument to the --rtems-bsp option and not a RTEMS BSP identifier. These two things aren’t even necessarily related naming-wise.