source: rtems/bsps/powerpc/beatnik/include/bsp/VMEConfig.h @ 762fa62

5
Last change on this file since 762fa62 was 2afb22b, checked in by Chris Johns <chrisj@…>, on 12/23/17 at 07:18:56

Remove make preinstall

A speciality of the RTEMS build system was the make preinstall step. It
copied header files from arbitrary locations into the build tree. The
header files were included via the -Bsome/build/tree/path GCC command
line option.

This has at least seven problems:

  • The make preinstall step itself needs time and disk space.
  • Errors in header files show up in the build tree copy. This makes it hard for editors to open the right file to fix the error.
  • There is no clear relationship between source and build tree header files. This makes an audit of the build process difficult.
  • The visibility of all header files in the build tree makes it difficult to enforce API barriers. For example it is discouraged to use BSP-specifics in the cpukit.
  • An introduction of a new build system is difficult.
  • Include paths specified by the -B option are system headers. This may suppress warnings.
  • The parallel build had sporadic failures on some hosts.

This patch removes the make preinstall step. All installed header
files are moved to dedicated include directories in the source tree.
Let @RTEMS_CPU@ be the target architecture, e.g. arm, powerpc, sparc,
etc. Let @RTEMS_BSP_FAMILIY@ be a BSP family base directory, e.g.
erc32, imx, qoriq, etc.

The new cpukit include directories are:

  • cpukit/include
  • cpukit/score/cpu/@RTEMS_CPU@/include
  • cpukit/libnetworking

The new BSP include directories are:

  • bsps/include
  • bsps/@RTEMS_CPU@/include
  • bsps/@RTEMS_CPU@/@RTEMS_BSP_FAMILIY@/include

There are build tree include directories for generated files.

The include directory order favours the most general header file, e.g.
it is not possible to override general header files via the include path
order.

The "bootstrap -p" option was removed. The new "bootstrap -H" option
should be used to regenerate the "headers.am" files.

Update #3254.

  • Property mode set to 100644
File size: 3.7 KB
Line 
1#ifndef RTEMS_BSP_VME_CONFIG_H
2#define RTEMS_BSP_VME_CONFIG_H
3
4/* BSP specific address space configuration parameters */
5
6/*
7 * Authorship
8 * ----------
9 * This software ('beatnik' RTEMS BSP for MVME6100 and MVME5500) was
10 *     created by Till Straumann <strauman@slac.stanford.edu>, 2005-2007,
11 *      Stanford Linear Accelerator Center, Stanford University.
12 *
13 * Acknowledgement of sponsorship
14 * ------------------------------
15 * The 'beatnik' BSP was produced by
16 *     the Stanford Linear Accelerator Center, Stanford University,
17 *      under Contract DE-AC03-76SFO0515 with the Department of Energy.
18 *
19 * Government disclaimer of liability
20 * ----------------------------------
21 * Neither the United States nor the United States Department of Energy,
22 * nor any of their employees, makes any warranty, express or implied, or
23 * assumes any legal liability or responsibility for the accuracy,
24 * completeness, or usefulness of any data, apparatus, product, or process
25 * disclosed, or represents that its use would not infringe privately owned
26 * rights.
27 *
28 * Stanford disclaimer of liability
29 * --------------------------------
30 * Stanford University makes no representations or warranties, express or
31 * implied, nor assumes any liability for the use of this software.
32 *
33 * Stanford disclaimer of copyright
34 * --------------------------------
35 * Stanford University, owner of the copyright, hereby disclaims its
36 * copyright and all other rights in this software.  Hence, anyone may
37 * freely use it for any purpose without restriction. 
38 *
39 * Maintenance of notices
40 * ----------------------
41 * In the interest of clarity regarding the origin and status of this
42 * SLAC software, this and all the preceding Stanford University notices
43 * are to remain affixed to any copy or derivative of this software made
44 * or distributed by the recipient and are to be affixed to any copy of
45 * software made or distributed by the recipient that contains a copy or
46 * derivative of this software.
47 *
48 * ------------------ SLAC Software Notices, Set 4 OTT.002a, 2004 FEB 03
49 */
50
51#define _VME_DRIVER_TSI148
52#define _VME_DRIVER_UNIVERSE
53
54/*
55 * NOTE: the BSP (startup/bspstart.c) uses
56 * hardcoded window lengths that match this
57 * layout when setting BATs:
58 */
59#define _VME_A32_WIN0_ON_PCI  0x90000000
60/* If _VME_CSR_ON_PCI is defined then the A32 window is reduced to accommodate
61 * CSR for space.
62 */
63#define _VME_CSR_ON_PCI      0x9e000000
64#define _VME_A24_ON_PCI      0x9f000000
65#define _VME_A16_ON_PCI      0x9fff0000
66
67/* start of the A32 window on the VME bus
68 * TODO: this should perhaps be a configuration option
69 */
70#define _VME_A32_WIN0_ON_VME  0x20000000
71
72/* if _VME_DRAM_OFFSET is defined, the BSP
73 * will map our RAM onto the VME bus, starting
74 * at _VME_DRAM_OFFSET
75 */
76#define _VME_DRAM_OFFSET    0x90000000
77
78extern int BSP_VMEInit(void);
79extern int BSP_VMEIrqMgrInstall(void);
80
81#define BSP_VME_INSTALL_IRQ_MGR(err)  \
82  do { \
83    err = -1; \
84    switch (BSP_getBoardType()) { \
85      case MVME6100: \
86        err = theOps->install_irq_mgr( \
87              VMETSI148_IRQ_MGR_FLAG_SHARED, \
88              0, BSP_IRQ_GPP_0 + 20, \
89              1, BSP_IRQ_GPP_0 + 21, \
90              2, BSP_IRQ_GPP_0 + 22, \
91              3, BSP_IRQ_GPP_0 + 23, \
92              -1); \
93        break; \
94\
95      case MVME5500: \
96        err = theOps->install_irq_mgr( \
97              VMEUNIVERSE_IRQ_MGR_FLAG_SHARED | \
98              VMEUNIVERSE_IRQ_MGR_FLAG_PW_WORKAROUND, \
99              0, BSP_IRQ_GPP_0 + 12, \
100              1, BSP_IRQ_GPP_0 + 13, \
101              2, BSP_IRQ_GPP_0 + 14, \
102              3, BSP_IRQ_GPP_0 + 15, \
103              -1); \
104        break; \
105\
106      default: \
107        printk("WARNING: unknown board; "); \
108        break; \
109    } \
110    if ( err ) \
111      printk("VME interrupt manager NOT INSTALLED (error: %i)\n", err); \
112  } while (0)
113
114#endif
Note: See TracBrowser for help on using the repository browser.