path: root/bsp-howto
diff options
authorSebastian Huber <>2016-12-21 08:51:28 +0100
committerSebastian Huber <>2016-12-21 11:34:14 +0100
commit3b42c96764c8aa49ce4e4ec381b1187d375d6e8f (patch)
treefb8d9f4554362c04239caaf7095fea2816f8bd4c /bsp-howto
parentc8aecf996c61a6f2d38e9c6914528ad60b44cc2d (diff)
Strip down BSP Introduction
Update #2852.
Diffstat (limited to 'bsp-howto')
1 files changed, 13 insertions, 49 deletions
diff --git a/bsp-howto/preface.rst b/bsp-howto/preface.rst
index 7ab34ab..9ce1128 100644
--- a/bsp-howto/preface.rst
+++ b/bsp-howto/preface.rst
@@ -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
-following topics:
-- 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
-<>. 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 <>`_
+about any activity in this area and maybe also
+`add tickets <>`_
+for specific work packages.
+A basic BSP consists of the following components:
+- Low-level initialization
+- Console driver
+- Clock driver