[rtems-docs commit] Strip down BSP Introduction
sebh at rtems.org
Fri Dec 23 13:40:39 UTC 2016
Author: Sebastian Huber <sebastian.huber at embedded-brains.de>
Date: Wed Dec 21 08:51:28 2016 +0100
Strip down BSP Introduction
bsp-howto/preface.rst | 62 +++++++++++----------------------------------------
1 file changed, 13 insertions(+), 49 deletions(-)
diff --git a/bsp-howto/preface.rst b/bsp-howto/preface.rst
index 7ab34ab..9ce1128 100644
@@ -7,52 +7,16 @@
-Before reading this documentation, it is strongly advised to read the RTEMS
-Development Environment Guide to get acquainted with the RTEMS directory
-structure. This document describes how to do a RTEMS Board Support Package,
-i.e. how to port RTEMS on a new target board. Discussions are provided for the
-- RTEMS Board Support Package Organization
-- Makefiles and the Linker Command Script
-- Board Initialization Sequence
-- Device Drivers:
- - Console Driver
- - Clock Driver
- - Timer Driver
- - Real-Time Clock Driver
- - Non-Volatile Memory Driver
- - Networking Driver
- - Shared Memory Support Driver
- - Analog Driver
- - Discrete Driver
-The original version of this manual was written by Geoffroy Montel
-<g_montel at yahoo.com>. When he started development of the gen68340
-BSP, this manual did not exist. He wrote the initial version of
-this manual as the result of his experiences. At that time, this
-document was viewed internally as the most important "missing manual"
-in the RTEMS documentation set.
-The gen68340 BSP is a good example of the life of an RTEMS BSP. It is
-based upon a part not recommended for new designs and none of the core RTEMS
-Project team members have one of these boards. Thus we are unlikely to
-perform major updates on this BSP. So as long as it compiles and links all
-tests, it will be available.
-The RTEMS Project team members are always trying to identify common
-code across BSPs and refactoring the code into shared routines.
-As part of this effort, the we will enhance the common BSP Framework.
-Not surprisingly, not every BSP takes advantage of every feature in
-the framework. The gen68340 does not take advantage of as many features
-as the ERC32 BSP does. So in many ways, the ERC32 is a better example
-BSP at this point. But even the ERC32 BSP does not include examples
-of every driver template and framework available to the BSP author.
-So in this guide we will try to point out good examples from other BSPs.
-Our goal is for you to be able to reuse as much code as possible and
-write as little board specific code as possible.
+This document describes how to create or modify a Board Support Package (BSP)
+for RTEMS, i.e. how to port RTEMS on a new microcontroller, system on chip
+(SoC) or board. It is strongly recommended to notify the
+`RTEMS development mailing <https://lists.rtems.org/mailman/listinfo/devel>`_
+about any activity in this area and maybe also
+`add tickets <https://devel.rtems.org/newticket>`_
+for specific work packages.
+A basic BSP consists of the following components:
+- Low-level initialization
+- Console driver
+- Clock driver
More information about the vc