source: rtems/c/src/lib/libbsp/m68k/mvme162/README @ c6fb8e90

4.104.114.84.95
Last change on this file since c6fb8e90 was c6fb8e90, checked in by Joel Sherrill <joel.sherrill@…>, on Aug 1, 1995 at 3:33:39 PM

updated mvme162 code from Misha (mms@…)

  • Property mode set to 100644
File size: 4.9 KB
Line 
1--
2--  EISCAT Scientific Association. M.Savitski
3--
4--  This material is a part of the MVME162 Board Support Package
5--  for the RTEMS executive. Its licensing policies are those of the
6--  RTEMS distribution.
7--
8--  Updated by Joel Sherrill (jsherril@redstone.army.mil) after
9--  inclusion in the standard release.
10--
11--  $Id$
12--
13
14This is a README file for the MVME162 port of RTEMS.
15
16Disclaimer
17----------
18This is my first attempt at porting RTEMS. The resulting code obviously
19contains bugs (know and unknown) and limitations. I assume no
20responsibility for quality and support of the software in question.
21
22Now on more optimistic note:
23
24I have run most of the standard RTEMS sptests, and neither of them
25failed. My present (short) experience of developing RTEMS applications
26is essentially positive and suggestive of a long-term commitment. In
27any case I am ready to answer questions regarding the port and intend
28to follow the future RTEMS versions. I will do my best to provide
29whatever support I can afford time-wise.
30
31Installation
32------------
33Nothing unique to the MVME162.  It has been incorporated into the
34standard release.
35
36Port Description
37----------------
38The port was done using already existing ports to the M68020 boards,
39DMV152 and MVME136.
40
41The host system was SUN/Solaris 2.3, and the cross-development
42environment consisted of Free Software Foundation (FSF)'s GNU C
43compiler (version 2.6), GNU Assembler (version 2.3) and GNU binary
44utilities binutils version 2.5.2, built with m68k as a target. The
45recent/latest versions of other GNU programs (flex, make, etc) were
46also used at the build stage.
47
48In all subdirectories of the RTEMS distribution tree, the directories
49mvme136 were duplicated as mvme162.
50
51Essential modifications are detailed below:
52
53- the MVME162-specific hardware registers were described in bsp.h
54
55- timer and clock routines were made to use the MVME162's Tick Timers 1
56and 2, respectively
57
58- shared memory support was replaced by stubs for the time being
59
60- console IO was lifted entirely from the DMV152 support code, thanks
61to the fact that Z8530 SCC used in DMV152 is upwards compatible with
62the Z85230 SCC of the MVME162. (Only the memory mapping of the SCC
63registers had to be changed.)
64
65- symbols in several *.s files were prepended with underscores to
66comply with the xgcc configuration used (it prepends underscores to all
67symbols defined in c code)
68
69- linkcmds file was modified to place the linked code into the memory
70configured for the board in use
71
72- bspstart.c was modified as follows:
73
74         monitors_vector_table = (m68k_isr *)0xFFE00000;
75
76was made to point to the power-up location of MVME162 interrupt vector
77table. 
78     
79- The shutdown is a temporary solution. To exit cleanly, it has to disable
80all enabled interrupts and restore the board to its power-up status.
81Presently this is not done satisfactorily, as a result, the board needs
82a hardware reset from the external VMEbus master or from the front
83panel to ensure correct operation for subsequent downloads.
84
85Host System
86-----------
87The VMEbus master used to externally control and download the MVME162
88is a FORCE CPU-2CE board running Solaris 2.3. A simple program to load
89s-records and start/reset the MVME162 was written. The code is in the
90file tools/sload.c
91
92This code depends on the external VMEbus master's vme driver and is
93provided as an example, without the Makefile. The bulk of the program
94which parses the s-records is courtesy of Kym Newbery,
95(8918927y@lux.levels.unisa.edu.au).
96
97In general, apart from x-gcc, the tools most often used while building
98RTEMS for MVME162 were: find, grep, diff, and, of course
99
100MVME162 Embedded Controller Programmer's Reference Guide,
101Motorola, MVME162PG/D1.
102
103Thanks
104------
105- to On-Line Applications Research Corporation (OAR) for developing
106RTEMS and making it available on a Technology Transfer basis;
107- to Joel Sherril, the leader of the RTEMS development group for
108stimulating and helpful discussions;
109- to Kym Newbery (8918927y@lux.levels.unisa.edu.au) for his s-record
110parser;
111- to Gerd Truschinski (gt@first.gmd.de) for creating and running the
112crossgcc mailing list
113- to FSF and Cygnus Support for great free software;
114
115What's new
116----------
117  - 28.07.95 BSP adjusted to rtems-3.2.0.
118  - Now console driver uses interrupts on receive (ring buffer
119    code lifted with thanks from the IDP BSP next door (../idp))
120  - both front-panel serial interfaces are supported
121  - serious bug in timer interrupts fixed
122  - interrupt test tm27 now supported
123 
124+----------------------------------+-------------------------------+
125|  Dr. Mikhail (Misha) Savitski    |  Voice : +46-980-79162        |
126|  Software Systems Engineer       |  Fax   : +46-980-79161        |
127|  EISCAT Svalbard Radar Project   |  E-mail: mms@eiscathq.irf.se  |
128|  EISCAT Scientific Association   |-----------  /\_/\  -----------|
129|  Box 812 S-98128 Kiruna, Sweden  |  EIS       { o o }       CAT  |
130+----------------------------------+-------oQQQ--(>I<)--QQQo-------+
131
132
Note: See TracBrowser for help on using the repository browser.