2009-07-28 Joel Sherrill <joel.sherrill@oarcorp.com>

* bsp_howto/.cvsignore, bsp_howto/Makefile.am,
	bsp_howto/bsp_howto.texi: Add Frame Buffer Device Driver shell.
	* bsp_howto/framebuffer.t: New file.
	* user/conf.t: Add CONFIGURE_APPLICATION_NEEDS_FRAME_BUFFER_DRIVER.

doc/ChangeLog

@@ -1,3 +1,10 @@
+2009-07-28	Joel Sherrill <joel.sherrill@oarcorp.com>
+
+	* bsp_howto/.cvsignore, bsp_howto/Makefile.am,
+	bsp_howto/bsp_howto.texi: Add Frame Buffer Device Driver shell.
+	* bsp_howto/framebuffer.t: New file.
+	* user/conf.t: Add CONFIGURE_APPLICATION_NEEDS_FRAME_BUFFER_DRIVER.
+
 2009-07-02	Joel Sherrill <joel.sherrill@OARcorp.com>
 
 	* user/region.t: Fix typos where semaphore referenced instead of region

doc/bsp_howto/.cvsignore

@@ -21,6 +21,7 @@ bsp_howto.vr
 clock.texi
 console.texi
 discrete.texi
+framebuffer.texi
 ide-ctrl.texi
 index.html
 init.texi

doc/bsp_howto/Makefile.am

@@ -15,7 +15,7 @@ include $(top_srcdir)/main.am
 GENERATED_FILES = intro.texi target.texi makefiles.texi linkcmds.texi \
     support.texi adaintr.texi init.texi console.texi clock.texi timer.texi \
     rtc.texi ata.texi ide-ctrl.texi nvmem.texi network.texi shmsupp.texi \
-    analog.texi discrete.texi
+    framebuffer.texi analog.texi discrete.texi
 
 COMMON_FILES += $(top_srcdir)/common/cpright.texi
 
@@ -117,6 +117,11 @@ shmsupp.texi: shmsupp.t
 	    -u "Top" \
 	    -n "" < $< > $@
 
+framebuffer.texi: framebuffer.t
+	$(BMENU2) -p "" \
+	    -u "Top" \
+	    -n "" < $< > $@
+
 analog.texi: analog.t
 	$(BMENU2) -p "" \
 	    -u "Top" \

doc/bsp_howto/bsp_howto.texi

@@ -8,7 +8,7 @@
 @c %**end of header
 
 @c
-@c  COPYRIGHT (c) 1988-2007.
+@c  COPYRIGHT (c) 1988-2009.
 @c  On-Line Applications Research Corporation (OAR).
 @c  All rights reserved.
 @c
@@ -74,6 +74,7 @@
 @include nvmem.texi
 @include network.texi
 @include shmsupp.texi
+@include framebuffer.texi
 @include analog.texi
 @include discrete.texi
 
@@ -100,6 +101,7 @@ This is the online version of the RTEMS BSP and Device Driver Development Guide.
 * Networking Driver::
 * Non-Volatile Memory Driver::
 * Shared Memory Support Driver::
+* Frame Buffer Driver::
 * Analog Driver::
 * Discrete Driver::
 * Command and Variable Index::

doc/bsp_howto/framebuffer.t

@@ -0,0 +1,24 @@
+@c
+@c  COPYRIGHT (c) 1988-2009.
+@c  On-Line Applications Research Corporation (OAR).
+@c  All rights reserved.
+@c
+@c  $Id$
+@c
+
+@chapter Frame Buffer Driver
+
+@section Introduction
+
+The purpose of the frame buffer driver is to provide a ...
+
+The clock driver is usually located in the @code{XXX} directory of the BSP. 
+
+@section Initialization
+
+The initialization routine is responsible for programming the hardware ....
+
+@section IO Control
+
+TBD
+

doc/user/conf.t

@@ -462,6 +462,15 @@ By default, this is not defined.
 is defined if the application wishes to include the Watchdog Driver.
 By default, this is not defined.
 
+@findex CONFIGURE_APPLICATION_NEEDS_FRAME_BUFFER_DRIVER
+@item @code{CONFIGURE_APPLICATION_NEEDS_FRAME_BUFFER_DRIVER}
+is defined
+if the application wishes to include the BSP's Frame Buffer Device Driver.
+Most BSPs do not provide a Frame Buffer Device Driver.  If this is
+defined and the BSP does not have this device driver, then the user
+will get a link time error for an undefined symbol.
+By default, this is not defined.
+
 @findex CONFIGURE_APPLICATION_NEEDS_STUB_DRIVER
 @item @code{CONFIGURE_APPLICATION_NEEDS_STUB_DRIVER}
 is defined if the application wishes to include the Stub Device Driver.