annotate packages/hal/powerpc/fads/current/README @ 66:bf00f99aec69 ecos-sw-2000-02-02

Merge from eCos master repository on 2000-02-02-19:16:44-GMT
author jlarmour
date Wed, 02 Feb 2000 19:57:02 +0000
parents c38311975d4f
children e0c0827131d1
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
2
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents:
diff changeset
1 The FADS MPC860 board port for eCos was contributed by Kevin Hester
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents:
diff changeset
2 <khester@opticworks.com> and is partly based on the files from Motorola's
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents:
diff changeset
3 "Example Software Initializing the SMC as a UART" package (smc2.zip)
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents:
diff changeset
4 available at:
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents:
diff changeset
5 http://www.mot.com/SPS/RISC/netcomm/tools/index.html#MPC860_table
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents:
diff changeset
6
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents:
diff changeset
7 The eCos FADS board port is provided on an "as is" basis as unsupported code.
64
c38311975d4f Merge from eCos master repository on 2000-01-28-04:28:11-GMT
jlarmour
parents: 2
diff changeset
8 Red Hat does not maintain this code and does not guarantee its functionality
2
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents:
diff changeset
9 in any way.
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents:
diff changeset
10
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents:
diff changeset
11 All inquiries about this port should be directed to the 'ecos-discuss'
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents:
diff changeset
12 mailing list (see http://sourceware.cygnus.com/ecos/intouch.html for
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents:
diff changeset
13 details).
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents:
diff changeset
14
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents:
diff changeset
15
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents:
diff changeset
16 A few comments from Kevin:
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents:
diff changeset
17 ----------------------------------------------------------------------------
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents:
diff changeset
18
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents:
diff changeset
19 GDB support is untested and I didn't include the GDB 'interrupt' via
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents:
diff changeset
20 the serial port support. It would be straightforward for someone to
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents:
diff changeset
21 add this.
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents:
diff changeset
22
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents:
diff changeset
23 You can also pass on that is was very easy to write this HAL - it only
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents:
diff changeset
24 took a day starting from the Cogent PPC HAL.
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents:
diff changeset
25
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents:
diff changeset
26 I can't promise support, but I will occasionally download from the CVS
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents:
diff changeset
27 database and run it on our card.
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents:
diff changeset
28
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents:
diff changeset
29 Usage notes:
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents:
diff changeset
30
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents:
diff changeset
31 - The startup code in fads.S assumes that the build has been downloaded by
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents:
diff changeset
32 the mpc8bug tool included with the FADS board. An example usage would be:
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents:
diff changeset
33 - build a FADS build (RAM build, GDB support off)
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents:
diff changeset
34 - link your application with the kernel you previously built
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents:
diff changeset
35 - run the Motorola mpc8bug tool.
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents:
diff changeset
36 - issue a mcp8bug "LOAD foo.elf" command where foo is the application you
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents:
diff changeset
37 have linked
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents:
diff changeset
38 - issue a mpc8bug "GO" command
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents:
diff changeset
39 - your program should now be running, the diag port is the upper serial
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents:
diff changeset
40 port (SMC2)
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents:
diff changeset
41
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents:
diff changeset
42 - I haven't tried to run a "ROM" build. The "RAM" build works great. The
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents:
diff changeset
43 ROM build will need to have fads.S setup more of the memory controller.
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents:
diff changeset
44
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents:
diff changeset
45 - I haven't tested the GDB interface - I have successfully run using the
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents:
diff changeset
46 diag serial port and the example programs (such as "hello world"). GDB
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents:
diff changeset
47 support should work, with the exception of interrupt support.
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents:
diff changeset
48
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents:
diff changeset
49 - The basic serial driver I added is based on the free Motorolla sample code
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents:
diff changeset
50 included with the MPC860 board. It assumes the link to the development
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents:
diff changeset
51 station is via the SMC 2 port (the top serial port on the FADS board). This
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents:
diff changeset
52 code in quicc_smc.c should be generalized to support any SMC port.
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents:
diff changeset
53
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents:
diff changeset
54 ----------------------------------------------------------------------------
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents:
diff changeset
55
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents:
diff changeset
56 //===========================================================================
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents:
diff changeset
57 //####COPYRIGHTBEGIN####
64
c38311975d4f Merge from eCos master repository on 2000-01-28-04:28:11-GMT
jlarmour
parents: 2
diff changeset
58 //
c38311975d4f Merge from eCos master repository on 2000-01-28-04:28:11-GMT
jlarmour
parents: 2
diff changeset
59 // -------------------------------------------
c38311975d4f Merge from eCos master repository on 2000-01-28-04:28:11-GMT
jlarmour
parents: 2
diff changeset
60 // The contents of this file are subject to the Red Hat eCos Public License
66
bf00f99aec69 Merge from eCos master repository on 2000-02-02-19:16:44-GMT
jlarmour
parents: 64
diff changeset
61 // Version 1.1 (the "License"); you may not use this file except in
64
c38311975d4f Merge from eCos master repository on 2000-01-28-04:28:11-GMT
jlarmour
parents: 2
diff changeset
62 // compliance with the License. You may obtain a copy of the License at
66
bf00f99aec69 Merge from eCos master repository on 2000-02-02-19:16:44-GMT
jlarmour
parents: 64
diff changeset
63 // http://www.redhat.com/
64
c38311975d4f Merge from eCos master repository on 2000-01-28-04:28:11-GMT
jlarmour
parents: 2
diff changeset
64 //
66
bf00f99aec69 Merge from eCos master repository on 2000-02-02-19:16:44-GMT
jlarmour
parents: 64
diff changeset
65 // Software distributed under the License is distributed on an "AS IS"
64
c38311975d4f Merge from eCos master repository on 2000-01-28-04:28:11-GMT
jlarmour
parents: 2
diff changeset
66 // basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See the
c38311975d4f Merge from eCos master repository on 2000-01-28-04:28:11-GMT
jlarmour
parents: 2
diff changeset
67 // License for the specific language governing rights and limitations under
c38311975d4f Merge from eCos master repository on 2000-01-28-04:28:11-GMT
jlarmour
parents: 2
diff changeset
68 // the License.
c38311975d4f Merge from eCos master repository on 2000-01-28-04:28:11-GMT
jlarmour
parents: 2
diff changeset
69 //
c38311975d4f Merge from eCos master repository on 2000-01-28-04:28:11-GMT
jlarmour
parents: 2
diff changeset
70 // The Original Code is eCos - Embedded Configurable Operating System,
c38311975d4f Merge from eCos master repository on 2000-01-28-04:28:11-GMT
jlarmour
parents: 2
diff changeset
71 // released September 30, 1998.
c38311975d4f Merge from eCos master repository on 2000-01-28-04:28:11-GMT
jlarmour
parents: 2
diff changeset
72 //
c38311975d4f Merge from eCos master repository on 2000-01-28-04:28:11-GMT
jlarmour
parents: 2
diff changeset
73 // The Initial Developer of the Original Code is Red Hat.
c38311975d4f Merge from eCos master repository on 2000-01-28-04:28:11-GMT
jlarmour
parents: 2
diff changeset
74 // Portions created by Red Hat are
c38311975d4f Merge from eCos master repository on 2000-01-28-04:28:11-GMT
jlarmour
parents: 2
diff changeset
75 // Copyright (C) 1998, 1999, 2000 Red Hat, Inc.
c38311975d4f Merge from eCos master repository on 2000-01-28-04:28:11-GMT
jlarmour
parents: 2
diff changeset
76 // All Rights Reserved.
c38311975d4f Merge from eCos master repository on 2000-01-28-04:28:11-GMT
jlarmour
parents: 2
diff changeset
77 // -------------------------------------------
c38311975d4f Merge from eCos master repository on 2000-01-28-04:28:11-GMT
jlarmour
parents: 2
diff changeset
78 //
2
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents:
diff changeset
79 //####COPYRIGHTEND####
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents:
diff changeset
80 //===========================================================================