README
1+------------------------------------------------+
2| $TOPDIR/arch/mips/galileo/compressed/README |
3| |
4| By RidgeRun Inc, |
5| Aug, 2000 |
6+------------------------------------------------+
7
8Description:
9============
10 It is intended that this makefile be wired in to run as
11 part of a top level linux build. For example, at the
12 time of this writing, if the user types "make gboot" at
13 the top level then in addition to building vmlinux the
14 build system's makefiles will descend into this
15 directory and build the "all:" target of this
16 Makefile. This will have the result of compressing the
17 vmlinux system and producing four separate systems. The
18 following snippet is pulled from this directory's
19 Makefile and describes each system.
20
21 Four systems are availalbe for download to the EVB64120A
22 board.
23
24 1. - ramsys -
25 To be loaded into ram then run. When run
26 it decompresses the "vmlinux" kernel housed in its internal
27 data structures and then jumps to the image which
28 results in a linux kernel boot.
29
30 2. - flashsys -
31 To be loaded into ram so that it can be
32 burned into the onboard flash. Then the board jumpers
33 can be switched so that the next power cycle caused
34 the system in flash to run which then proceeds as
35 described by #1 above.
36 Note: burner.srec is the utility that will allow
37 the user to get this image into flash.
38
39 3. - flashsys2 -
40 To be loaded into ram so that it can be
41 burned into the onboard flash. Then on each power
42 cycle when the standard PMON prompt is presented
43 the user can type `call 0xbf000000` to invoke
44 the system in flash which then proceeds as
45 described by #1 above.
46 Note: burner.srec is the utility that will allow
47 the user to get this image into flash.
48
49 4. - burner.srec -
50 Related to #2 and #3 above.
51
52Example: Running from Ram
53==========================
54
55 In this scenario the compressed system is downloaded
56 into ram and run directly from there. No flash is involved
57 in this scenario. Naturally, the download must be repeated
58 on every power cycle.
59
60 1. At the PMON prompt type `load`
61 2. Assuming you have your host connected to /dev/ttyS0
62 type the following command in a host shell window.
63 `cat ramsys.srec > /dev/ttyS0`
64 3. When the download completes type the following
65 at the PMON prompt: `g`
66
67
68Example: Running from flash: Scenario #1
69========================================
70
71 In this scenario vmlinux runs out of flash code
72 automatically on every power up. This means that
73 standard PMON code (of eprom) never runs.
74
75 1. Place the boot jumpers in the Boot-from-eprom
76 state. This is the normal state and how the jumpers
77 are found when booting PMON.
78
79 Jumper settings. J11 - Removed
80 J20 - Moved from the 1&2 position to
81 the 2&3 position instead
82
83 2. Use PMON to "load" the burner.srec image and then
84 run it. This utility will prompt you to download
85 the image that you want burned into the flash
86 part.
87
88 3. Send the flashsys.srec image to the running burner
89 utility. The utililty will indicate when the burn
90 process has completed.
91
92 4. Now switch off power and change the jumpers to
93 the boot-from-flash position. The next power cycle
94 will run the flash based system automatically.
95
96 Jumper settings. J11 - Added.
97 J20 - Moved from the 2&3 position to
98 the 1&2 position instead
99
100Example: Running from flash: Scenario #2
101========================================
102
103 In this scenario vmlinux runs out of flash only if the
104 PMON user decides to jump there by issuing a command to
105 PMON. Every power cycle would continue to bring up PMON
106 and a user will have to reissue the jump command to
107 force control transfer to the flash system.
108
109 1. Insure that the boot jumpers are in the Boot-from-eprom
110 state. This is the normal state and how the jumpers
111 are found when booting PMON.
112
113 Jumper settings. J11 - Removed
114 J20 - Moved from the 1&2 position to
115 the 2&3 position instead
116
117 2. Use PMON to "load" the burner.srec image and then
118 run it. This utility will prompt you to download
119 the image that you want burned into the flash
120 part.
121
122 3. Send the flashsys2.srec image to the running burner
123 utility. The utililty will indicate when the burn
124 process has completed.
125
126 4. Now that the image is in flash the user can invoke
127 the following PMON command whenever a vmlinux
128 boot is desired:
129
130 call 0xbf000000
131
132