From 90d02e997376428c895cd0e8b87ef94d1e6fea52 Mon Sep 17 00:00:00 2001 From: Joel Sherrill Date: Mon, 25 Oct 1999 16:32:13 +0000 Subject: Enabled Ada95 interrupt support chapter and reformatted a bunch of stuff to avoid line wrappings. --- doc/bsp_howto/Makefile | 11 ++++++++--- doc/bsp_howto/bsp_howto.texi | 18 ++++++++++-------- doc/bsp_howto/console.t | 3 ++- doc/bsp_howto/linkcmds.t | 29 ++++++++++++++++------------- doc/bsp_howto/makefiles.t | 16 +++++++++------- doc/bsp_howto/shmsupp.t | 6 +++--- 6 files changed, 48 insertions(+), 35 deletions(-) (limited to 'doc') diff --git a/doc/bsp_howto/Makefile b/doc/bsp_howto/Makefile index 4d3d374009..4a233550ac 100644 --- a/doc/bsp_howto/Makefile +++ b/doc/bsp_howto/Makefile @@ -19,8 +19,8 @@ COMMON_FILES=../common/cpright.texi ../common/setup.texi GENERATED_FILES= \ intro.texi target.texi makefiles.texi linkcmds.texi support.texi \ - init.texi console.texi clock.texi timer.texi rtc.texi nvmem.texi \ - network.texi shmsupp.texi analog.texi discrete.texi + adaintr.texi init.texi console.texi clock.texi timer.texi rtc.texi \ + nvmem.texi network.texi shmsupp.texi analog.texi discrete.texi FILES=$(PROJECT).texi $(GENERATED_FILES) @@ -88,11 +88,16 @@ makefiles.texi: makefiles.t Makefile linkcmds.texi: linkcmds.t Makefile $(BMENU) -p "Makefiles Creating a New BSP Make Customization File" \ + -u "Top" \ + -n "Ada95 Interrupt Support" ${*}.t + +adaintr.texi: adaintr.t Makefile + $(BMENU) -p "Linker Script Initialized Data" \ -u "Top" \ -n "Miscellaneous Support Files" ${*}.t support.texi: support.t Makefile - $(BMENU) -p "Linker Script Initialized Data" \ + $(BMENU) -p "Ada95 Interrupt Support Version Requirements" \ -u "Top" \ -n "" ${*}.t diff --git a/doc/bsp_howto/bsp_howto.texi b/doc/bsp_howto/bsp_howto.texi index c3d17ca33a..9be5ec0e0c 100644 --- a/doc/bsp_howto/bsp_howto.texi +++ b/doc/bsp_howto/bsp_howto.texi @@ -67,6 +67,7 @@ END-INFO-DIR-ENTRY @include makefiles.texi @include linkcmds.texi @include support.texi +@include adaintr.texi @include init.texi @include console.texi @include clock.texi @@ -90,6 +91,7 @@ This is the online version of the RTEMS BSP and Device Driver Development Guide. * Makefiles:: * Linker Script:: * Miscellaneous Support Files:: +* Ada95 Interrupt Support:: * Initialization Code:: * Console Driver:: * Clock Driver:: @@ -100,27 +102,27 @@ This is the online version of the RTEMS BSP and Device Driver Development Guide. * Shared Memory Support Driver:: * Analog Driver:: * Discrete Driver:: +* Command and Variable Index:: +* Concept Index:: @end menu -@c * Command and Variable Index:: -@c * Concept Index:: @end ifinfo @c @c @c Need to copy the emacs stuff and "trailer stuff" (index, toc) into here @c -@c @node Command and Variable Index, Concept Index, Installing EGCS AND NEWLIB, Top -@c @unnumbered Command and Variable Index +@node Command and Variable Index, Concept Index, , Top +@unnumbered Command and Variable Index -@c There are currently no Command and Variable Index entries. +There are currently no Command and Variable Index entries. @c @printindex fn -@c @node Concept Index, , Command and Variable Index, Top -@c @unnumbered Concept Index +@node Concept Index, , Command and Variable Index, Top +@unnumbered Concept Index -@c There are currently no Concept Index entries. +There are currently no Concept Index entries. @c @printindex cp @contents diff --git a/doc/bsp_howto/console.t b/doc/bsp_howto/console.t index 12e2dadc6d..1480580e60 100644 --- a/doc/bsp_howto/console.t +++ b/doc/bsp_howto/console.t @@ -268,7 +268,8 @@ usually consists of: @item If interrupt driven, register the console interrupt routine to RTEMS: @example - rtems_interrupt_catch (InterruptHandler,CONSOLE_VECTOR,&old_handler); +rtems_interrupt_catch( + InterruptHandler, CONSOLE_VECTOR, &old_handler); @end example @item enable the UART channels. diff --git a/doc/bsp_howto/linkcmds.t b/doc/bsp_howto/linkcmds.t index 22744dbadd..f184b0b978 100644 --- a/doc/bsp_howto/linkcmds.t +++ b/doc/bsp_howto/linkcmds.t @@ -129,17 +129,18 @@ RamSize = DEFINED(RamSize) ? RamSize : 4M; /* * Set the amount of RAM to be used for the application heap. Objects - * allocated using malloc() come from this area. Having a tight heap size - * is somewhat difficult and multiple attempts to squeeze it may be needed - * reducing memory usage is important. If all objects are allocated from - * the heap at system initialization time, this eases the sizing of the - * application heap. + * allocated using malloc() come from this area. Having a tight heap + * size is somewhat difficult and multiple attempts to squeeze it may + * be needed reducing memory usage is important. If all objects are + * allocated from the heap at system initialization time, this eases + * the sizing of the application heap. * * NOTE 1: The default may be overridden by passing an argument to ld. * * NOTE 2: The TCP/IP stack requires additional memory in the Heap. * - * NOTE 3: The GNAT/RTEMS run-time requires additional memory in the Heap. + * NOTE 3: The GNAT/RTEMS run-time requires additional memory in + * the Heap. */ HeapSize = DEFINED(HeapSize) ? HeapSize : 0x10000; @@ -157,8 +158,9 @@ StackSize = DEFINED(StackSize) ? StackSize : 0x1000; /* * Starting addresses and length of RAM and ROM. * - * The addresses must be valid addresses on the board. The Chip Selects - * should be initialized such that the code addresses are valid. + * The addresses must be valid addresses on the board. The + * Chip Selects should be initialized such that the code addresses + * are valid. */ MEMORY @{ @@ -171,17 +173,18 @@ MEMORY @{ * for more details. */ -ETHERNET_ADDRESS = DEFINED(ETHERNET_ADDRESS) ? ETHERNET_ADDRESS : 0xDEAD12; +ETHERNET_ADDRESS = + DEFINED(ETHERNET_ADDRESS) ? ETHERNET_ADDRESS : 0xDEAD12; /* * The following defines the order in which the sections should go. * It also defines a number of variables which can be used by the * application program. * - * NOTE: Each variable appears with 1 or 2 leading underscores to insure - * that the variable is accessible from C code with a single - * underscore. Some object formats automatically add a leading - * underscore to all C global symbols. + * NOTE: Each variable appears with 1 or 2 leading underscores to + * ensure that the variable is accessible from C code with a + * single underscore. Some object formats automatically add + * a leading underscore to all C global symbols. */ SECTIONS @{ diff --git a/doc/bsp_howto/makefiles.t b/doc/bsp_howto/makefiles.t index c607a0fbb5..f562e16e18 100644 --- a/doc/bsp_howto/makefiles.t +++ b/doc/bsp_howto/makefiles.t @@ -121,13 +121,15 @@ BSP_PIECES=startup clock console timer CPU_PIECES= GENERIC_PIECES= -# bummer; have to use $foreach since % pattern subst rules only replace 1x -OBJS=$(foreach piece, $(BSP_PIECES), ../$(piece)/$(ARCH)/$(piece).rel) \ - $(foreach piece, $(CPU_PIECES), \ - ../../../../libcpu/$(RTEMS_CPU)/$(piece)/$(ARCH)/$(piece).rel) \ - $(wildcard \ - ../../../../libcpu/$(RTEMS_CPU)/$(RTEMS_CPU_MODEL)/fpsp/$(ARCH)/fpsp.rel) \ - $(foreach piece, $(GENERIC_PIECES), ../../../$(piece)/$(ARCH)/$(piece).rel) +# bummer; have to use $foreach since % pattern subst +# rules only replace 1x +OBJS=$(foreach piece, $(BSP_PIECES), ../$(piece)/$(ARCH)/$(piece).o) \ + $(foreach piece, $(CPU_PIECES), \ + ../../../../libcpu/$(RTEMS_CPU)/$(piece)/$(ARCH)/$(piece).o) \ + $(wildcard \ + ../../../../libcpu/$(RTEMS_CPU)/$(RTEMS_CPU_MODEL)/fpsp/$(ARCH)/fpsp.rel) \ + $(foreach piece, \ + $(GENERIC_PIECES), ../../../$(piece)/$(ARCH)/$(piece).o) @end example The variable @code{OBJS} is the list of "pieces" expanded to include diff --git a/doc/bsp_howto/shmsupp.t b/doc/bsp_howto/shmsupp.t index 1e619ae2dc..3ae09ce88c 100644 --- a/doc/bsp_howto/shmsupp.t +++ b/doc/bsp_howto/shmsupp.t @@ -39,10 +39,10 @@ struct shm_config_info @{ vol_u32 *base; /* base address of SHM */ vol_u32 length; /* length (in bytes) of SHM */ vol_u32 format; /* SHM is big or little endian */ - vol_u32 (*convert)(); /* neutral conversion routine */ - vol_u32 poll_intr; /* POLLED or INTR driven mode */ + vol_u32 (*convert)(); /* neutral conversion routine */ + vol_u32 poll_intr; /* POLLED or INTR driven mode */ void (*cause_intr)( rtems_unsigned32 ); - Shm_Interrupt_information Intr; /* cause intr information */ + Shm_Interrupt_information Intr; /* cause intr information */ @}; typedef struct shm_config_info shm_config_table; -- cgit v1.2.3