summaryrefslogtreecommitdiffstats
path: root/c/src/lib/libbsp/bare/README
diff options
context:
space:
mode:
authorRalf Corsepius <ralf.corsepius@rtems.org>2009-10-16 14:15:29 +0000
committerRalf Corsepius <ralf.corsepius@rtems.org>2009-10-16 14:15:29 +0000
commit61a69a567c4ab2a1b36eaec9019df91d641b8486 (patch)
treef983cd6958bce2b41d2acec0157e703fcaa5a3d1 /c/src/lib/libbsp/bare/README
parent2009-10-16 Ralf Corsépius <ralf.corsepius@rtems.org> (diff)
downloadrtems-61a69a567c4ab2a1b36eaec9019df91d641b8486.tar.bz2
Remove (Abandoned).
Diffstat (limited to '')
-rw-r--r--c/src/lib/libbsp/bare/README117
1 files changed, 0 insertions, 117 deletions
diff --git a/c/src/lib/libbsp/bare/README b/c/src/lib/libbsp/bare/README
deleted file mode 100644
index f2d43f974d..0000000000
--- a/c/src/lib/libbsp/bare/README
+++ /dev/null
@@ -1,117 +0,0 @@
-#
-# $Id$
-#
-
-#
-# Please send any comments, improvements, or bug reports to:
-# Chris Johns
-# Objective Design Systems
-# 35 Cairo Street
-# Cammeray
-# Sydney, NSW 2062
-# ccj@acm.org
-#
-
-#
-# Overview
-# ~~~~~~~~
-# This board support package is not a board support package at all, but
-# a means to build the RTEMS kernel without using a specific BSP.
-#
-# You should be able to build to build this BSP for any cpu type.
-#
-# You must provide the standard BSP type functions and support yourself
-# externally to RTEMS.
-#
-# This BSP is intended to be used by people who fit one or more of the
-# categories below :
-#
-# 1) using custom hardware of little use or interest to others. If you
-# intend to use hardware available to others, please create a BSP
-# and send to OARCorp.
-#
-# 2) production code cannot depend on software which can change. BSP code
-# can change with-out notice, while RTEMS has very tightly defined
-# interfaces which do not change.
-#
-# 3) the need to extend or change an existing BSP in ways which are not
-# of interest to others or the BSP maintainer.
-#
-# I fit all the above.
-#
-# Issues
-# ~~~~~~
-# I do not consider the bare BSP as a starting point for RTEMS. The
-# BSP code integrated into the RTEMS build tree has the advantage of
-# building all the test and sample code. The sample and test code is
-# important for validatation of your tools, and getting your BSP
-# working correctly.
-#
-# Once you gain experience with RTEM and your application matures the
-# need to break the BSP code out from the kernel becomes important. It
-# is at this point in time that the bare BSP becomes useful.
-#
-# Once free you are able to upgrade without the worry of makefile or
-# build tree changes which can break your BSP.
-#
-# How To Configure
-# ~~~~~~~~~~~~~~~~
-# RTEMS requires you to select a BSP inorder to build the kernel.
-# If you take a close look at a BSP which is closest to your
-# needs you will find somewhere the CPU model and CPU compile
-# flags are specified. This is the only piece of information
-# required by the kernel inorder for it to build.
-#
-# This highlights the clean design of the kernel and its
-# independence from the particulars of target hardware.
-#
-# The CPU model is the RTEMS model and usually tries to match with
-# the GCC model. There are variations on some processors. If you are
-# unsure please ask on the RTEMS list. Someone will know (I hope).
-#
-# The CPU flags allow you to select specific operating modes for
-# GCC. For example the PowerPC has specific flags to control various
-# cache resouces. Another example is the 68000 family of embedded
-# processor do not have FPU hardware and require software emulation.
-#
-# An example configuration command line is:
-#
-# ../rtems-4.0/configure --target=m68k-rtems \
-# --prefix=/ods/egcs/test \
-# --enable-cxx \
-# --enable-gmake-print-directory \
-# --disable-tests \
-# --disable-posix \
-# --enable-networking \
-# --enable-bare-cpu-cflags=-mcpu32 \
-# --enable-bare-cpu-model=mcpu32 \
-# --enable-rtemsbsp=bare
-#
-# Building RTEMS
-# ~~~~~~~~~~~~~~
-# You are required to do nothing special here. Just follow the documented
-# steps. The samples are built but no linking occurs. The link command
-# is stubbed out to produce a Unix shell script.
-#
-# After installation you will find a directory called 'bare'. The nature
-# of the RTEMS build system means the bare BSP will only install into the
-# the bare directory under the specifed configuration prefix.
-#
-# I therefore suggest you move the directory to another name. This allows
-# you to make and install another bare BSP for a different variant of
-# CPU without over writing the last installed variant.
-#
-# I have provided a script file I use to configure and build RTEMS
-# from the arcihve. Take a copy and use it if you find it useful.
-#
-# Creating an Application.
-# ~~~~~~~~~~~~~~~~~~~~~~~~
-# This is something which is usually specific to your local environment.
-# The bare BSP does not lock you into any specific makefile or build
-# system. A couple of suggestions are:
-#
-# o Get the sample bare BSP application, or
-# o Watch RTEMS build a BSP which is closest to yours and copy
-# the command lines used.
-#
-