rtems/rtems-libbsd
1
0
Fork 0
mirror of https://git.rtems.org/rtems-libbsd/ synced 2025-05-13 04:14:32 +08:00
Code Issues Packages Projects Releases Wiki Activity

libbsd.txt: Move BSP related content

Browse Source
This commit is contained in:
Sebastian Huber 2022-05-19 11:40:51 +02:00
parent 5c4cf1f708
commit dcdf571c45
2 changed files with 22 additions and 19 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

22
CONTRIBUTING.rst
View File

@ -394,3 +394,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.

19
libbsd.txt
View File

@ -7,7 +7,6 @@ RTEMS BSD Library Guide
== Getting Started
=== Tool Chain ===
You need a tool chain for RTEMS based on the latest RTEMS Source Builder (RSB).
@ -33,14 +32,6 @@ status' says `rtems_waf` need updating run the submodule update command:
$ git submodule sync
$ git submodule rtems_waf update
=== Board Support Package Requirements ===
You need the latest RTEMS version to build the libbsd master. The Board
Support Package (BSP) must support the
http://www.rtems.org/onlinedocs/doxygen/cpukit/html/group\__rtems\__interrupt__extension.html[Interrupt Manager Extension]
// The first underscores have to be masked to stop asciidoc interpreting them
to make use of generic FreeBSD based drivers.
=== Board Support Package Configuration and Build ===
You need to configure RTEMS for the desired BSP and install it. The BSP must
@ -66,16 +57,6 @@ ${HOME}/git-rtems/configure \
make && \
make install
-------------------------------------------------------------------------------
The `arm/xilinx_zynq_a9_qemu` BSP running on the Qemu simulator has some
benefits for development and test of the BSD library
* it offers a 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).
=== BSD Library Configuration and Build ===
The build system based on the Waf build system. To build with Waf please refer