diff options
| author | Sebastian Huber <sebastian.huber@embedded-brains.de> | 2022-05-19 11:40:51 +0200 |
|---|---|---|
| committer | Sebastian Huber <sebastian.huber@embedded-brains.de> | 2022-05-25 08:06:57 +0200 |
| commit | 31bd0d7047ba35720b22b8181e293343ed74d651 (patch) | |
| tree | c0827d90e44752eee3744772047bb0156ac3099a /CONTRIBUTING.rst | |
| parent | libbsd.txt: Move introduction content (diff) | |
| download | rtems-libbsd-31bd0d7047ba35720b22b8181e293343ed74d651.tar.bz2 | |
libbsd.txt: Move BSP related content
Diffstat (limited to 'CONTRIBUTING.rst')
| -rw-r--r-- | CONTRIBUTING.rst | 22 |
1 files changed, 22 insertions, 0 deletions
diff --git a/CONTRIBUTING.rst b/CONTRIBUTING.rst index 9b42561f..a1c711af 100644 --- a/CONTRIBUTING.rst +++ b/CONTRIBUTING.rst @@ -471,3 +471,25 @@ build process. The ``Makefile.todo`` file performs this manually. The should b included in ``freebsd-to-rtems.py`` script some time in the future. For details, see also `KOBJ(9) <http://www.freebsd.org/cgi/man.cgi?query=kobj&sektion=9&apropos=0>`_. + +Reference Board Support Package +=============================== + +The reference BSP for LibBSD development is ``arm/xilinx_zynq_a9_qemu``. All +patches shall be tested for this BSP. The BSP runs on the Qemu simulator which +has some benefits for development and test of the LibBSD + +* ``NULL`` pointer read and write protection, +* Qemu is a fast simulator, +* Qemu provides support for GDB watchpoints, +* Qemu provides support for virtual Ethernet networks, e.g. TUN and bridge + devices (you can run multiple test instances on one virtual network). + +Board Support Package Requirements +================================== + +In FreeBSD, interrupt handler may use mutexes. In RTEMS, using mutexes from +within interrupt context is not allowed, so the Board Support Package (BSP) +should support the +`Interrupt Manager <https://docs.rtems.org/branches/master/c-user/interrupt/directives.html#rtems-interrupt-server-handler-install>`_ +in general. |