distrib/notes/evbarm/prep

   1 .\"     $NetBSD: prep,v 1.9 2008/09/06 21:49:33 tsutsui Exp $
   2 .\"
   3 .\" Copyright (c) 2001-2002 The NetBSD Foundation, Inc.
   4 .\" All rights reserved.
   5 .\"
   6 .\" Redistribution and use in source and binary forms, with or without
   7 .\" modification, are permitted provided that the following conditions
   8 .\" are met:
   9 .\" 1. Redistributions of source code must retain the above copyright
  10 .\"    notice, this list of conditions and the following disclaimer.
  11 .\" 2. Redistributions in binary form must reproduce the above copyright
  12 .\"    notice, this list of conditions and the following disclaimer in the
  13 .\"    documentation and/or other materials provided with the distribution.
  14 .\"
  15 .\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
  16 .\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
  17 .\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
  18 .\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
  19 .\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
  20 .\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
  21 .\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
  22 .\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
  23 .\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
  24 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
  25 .\" POSSIBILITY OF SUCH DAMAGE.
  26 .\"
  27 .
  28 First and foremost, before beginning the installation process,
  29 .Em make sure you have a reliable backup
  30 of any data on the target system that you wish to keep.
  31 Mistakes in partitioning may lead to data loss.
  32 .Ss2 Preparation for the Technologic Systems TS-7200
  33 The TS-7200 uses RedBoot firmware which supports loading the kernel via
  34 serial port and the on-chip Ethernet.
  35 These notes assume that the Ethernet will be used to load the kernel.
  36 RedBoot can either use TFTP or HTTP to load the kernel via the network.
  37 .Pp
  38 These notes also assume the the TS-7200 will be run from the CompactFlash;
  39 that a FFS filesystem on the CompactFlash card will provide the root file
  40 system.  The minimum size of the CompactFlash card is 64MB with 512MB being
  41 the recommended minimum size if attempting a full installation.
  42 .Pp
  43 The first step to install
  44 .Nx
  45 is to interrupt normal
  46 system bootup and drop to the RedBoot prompt by hitting Ctrl-C immediately
  47 after applying power.  To load both the installation kernel and the generic
  48 post-installation TS7200 kernel you will need network connectivity from RedBoot which
  49 you will have to configure using the RedBoot
  50 .Ic fconfig
  51 command; see the RedBoot documentation for more information.
  52 .Pp
  53 A compressed kernel image and loader suitable for placing into
  54 flash is provided with the distribution.
  55 Use of this image is optional;
  56 a kernel that can be directly loaded over the network
  57 by RedBoot is also provided.
  58 .Pp
  59 The image for the TS-7200 can be found under the
  60 .Nx*M
  61 \*V distribution directory in
  62 .Pa \*M/binary/gzimg/gzimg_TS7200_flash_0x60660000.gz ,
  63 and corresponds to the kernel in
  64 .Pa \*M/binary/kernel/netbsd-TS7200.gz .
  65 The following steps
  66 describe how to copy the compressed kernel image into flash.
  67 .Pp
  68 .(enum
  69 Uncompress the gzimg file and place it into the TFTP server's
  70 download area (note, the kernel inside the gzimg is still
  71 compressed after this step).
  72 .Pp
  73 .Dl server# Ic gzcat gzimg_TS7200_flash_0x60660000.gz \*[Gt] /tftpboot/gzimg_TS7200_flash_0x60660000
  74 .It
  75 Load the gzimg from the TFTP server.
  76 .Pp
  77 .Bd -literal
  78 RedBoot\*[Gt] load -r -b 0x00200000 gzimg_TS7200_flash_0x60660000
  79 Raw file loaded 0x00200000-0x00605fe0
  80 .Ed
  81 .It
  82 Use the RedBoot
  83 .Ic fis
  84 command to copy the image into flash.
  85 For more information on the RedBoot
  86 Flash Image System, see the RedBoot documentation.  The factory default
  87 Linux image may already be present in flash and must be deleted before
  88 continuing.
  89 .Bd -literal
  90 RedBoot\*[Gt] fis delete vmlinux
  91 RedBoot\*[Gt] fis create -b 0x00200000 -f 0x60660000 -l 0x00160000 netbsd.gz
  92 .Ed
  93 .enum)
  94 .Pp
  95 Once the compressed kernel image has been copied into flash, it may
  96 be started by jumping to the flash address of the image:
  97 .Bd -literal
  98 RedBoot\*[Gt] g 0x60660000
  99 .Ed
 100 .
 101 .Ss2 Preparation for the Intel IQ80310
 102 The IQ80310 uses RedBoot firmware from Red Hat, Inc.
 103 RedBoot supports loading the kernel via the serial port and the on-board
 104 Ethernet.
 105 These notes assume that the Ethernet will be used to load the kernel.
 106 RedBoot uses the Trivial File Transfer Protocol
 107 (TFTP) to load the kernel via the network.
 108 .Pp
 109 These notes also assume that the IQ80310 will be run as a diskless
 110 system; that an NFS server will provide the root file system.
 111 The
 112 .Nx
 113 kernel uses the Dynamic Host Configuration Protocol (DHCP) to
 114 obtain network address and root file system information.
 115 .Pp
 116 The first step is to configure your DHCP, NFS, and TFTP server
 117 software.
 118 You will need the MAC address for the on-board Ethernet,
 119 which RedBoot can provide; see the RedBoot documentation for more
 120 information.
 121 .Pp
 122 The next step is to configure RedBoot to obtain its IP address from
 123 your DHCP server; see the RedBoot documentation for more information.
 124 .Pp
 125 Once your DHCP server and RedBoot are properly configured, you should
 126 see information similar to the following when the IQ80310 is reset
 127 or powered-up:
 128 .Bd -literal
 129 RedBoot(tm) debug environment - built 17:16:14, Feb 12 2001
 130 Platform: IQ80310 (XScale)
 131 Copyright (C) 2000, Red Hat, Inc.
 132
 133 RAM: 0xa0000000-0xa2000000
 134 FLASH: 0x00000000 - 0x00800000, 64 blocks of 0x00020000 bytes each.
 135 IP: 192.168.0.10, Default server: 192.168.0.1
 136 RedBoot\*[Gt]
 137 .Ed
 138 .Pp
 139 A compressed kernel image and loader suitable for placing into
 140 flash is provided with the distribution.
 141 Use of this image is optional;
 142 a kernel that can be directly loaded over the network
 143 by RedBoot is also provided.
 144 .Pp
 145 The image for the IQ80310 can be found under the
 146 .Nx*M
 147 \*V distribution directory in
 148 .Pa \*M/binary/gzimg/gzimg_IQ80310_flash_0x00080000.gz ,
 149 and corresponds to the kernel in
 150 .Pa \*M/binary/kernel/netbsd-IQ80310.gz .
 151 The following steps
 152 describe how to copy the compressed kernel image into flash.
 153 .Pp
 154 .(enum
 155 Uncompress the gzimg file and place it into the TFTP server's
 156 download area (note, the kernel inside the gzimg is still
 157 compressed after this step).
 158 .Pp
 159 .Dl server# Ic gzcat gzimg_IQ80310_flash_0x00080000.gz \*[Gt] /tftpboot/gzimg_IQ80310_flash_0x00080000
 160 .It
 161 Load the gzimg from the TFTP server.
 162 .Pp
 163 .Bd -literal
 164 RedBoot\*[Gt] load -r -b 0xa0200000 gzimg_IQ80310_flash_0x00080000
 165 Raw file loaded 0xa0200000-0xa0305fe0
 166 .Ed
 167 .It
 168 Use the RedBoot
 169 .Ic fis
 170 command to copy the image into flash.
 171 For more information on the RedBoot
 172 Flash Image System, see the RedBoot documentation.
 173 .Bd -literal
 174 RedBoot\*[Gt] fis create -b 0xa0200000 -f 0x00080000 -l 0x00200000 netbsd.gz
 175 .Ns ... Erase from 0x00080000-0x00280000: ....................
 176 .Ns ... Program from 0xa0200000-0xa0400000 at 0x00080000: ....................
 177 .Ns ... Unlock from 0x007e0000-0x00800000: .
 178 .Ns ... Erase from 0x007e0000-0x00800000: .
 179 .Ns ... Program from 0xa1fd0000-0xa1ff0000 at 0x007e0000: .
 180 .Ns ... Lock from 0x007e0000-0x00800000: .
 181 .Ed
 182 .enum)
 183 .Pp
 184 Once the compressed kernel image has been copied into flash, it may
 185 be started by jumping to the flash address of the image:
 186 .Bd -literal
 187 RedBoot\*[Gt] g 0x00080000
 188
 189 \*[Gt]\*[Gt] NetBSD/IQ80310 Gzip Boot, Revision 1.1
 190 \*[Gt]\*[Gt] (root@tgm, Thu Mar 28 18:32:45 PST 2002)
 191 \*[Gt]\*[Gt] RAM 0xa0000000 - 0xafffffff, heap at 0xaffd0000
 192 \*[Gt]\*[Gt] Load address: 0xa0200000
 193 \*[Gt]\*[Gt] Image size: 741244
 194 Uncompressing image...done.
 195 Jumping to image @ 0xa0200000...
 196
 197 NetBSD/evbarm (IQ80310) booting ...
 198 Resetting secondary PCI bus...
 199 initarm: Configuring system ...
 200 physmemory: 65536 pages at 0xa0000000 -\*[Gt] 0xafffffff
 201 init subsystems: stacks vectors undefined pmap irq done.
 202 [ using 155084 bytes of netbsd ELF symbol table ]
 203 Copyright (c) 1996, 1997, 1998, 1999, 2000, 2001, 2002
 204     The NetBSD Foundation, Inc.  All rights reserved.
 205 Copyright (c) 1982, 1986, 1989, 1991, 1993
 206     The Regents of the University of California.  All rights reserved.
 207
 208 NetBSD 1.5ZC (IQ80310) #20: Fri Mar 29 10:25:53 PST 2002
 209     root@tgm:/u1/netbsd/src/sys/arch/evbarm/compile/IQ80310
 210 total memory = 256 MB
 211 avail memory = 232 MB
 212 using 1228 buffers containing 13208 KB of memory
 213 mainbus0 (root)
 214 cpu0 at mainbus0: i80200 step A-0 (XScale core)
 215 cpu0: DC enabled IC enabled WB enabled LABT
 216 cpu0: 32KB/32B 32-way Instruction cache
 217 cpu0: 32KB/32B 32-way write-back-locking Data cache
 218 obio0 at mainbus0: board rev. F, CPLD rev. D, backplane present
 219 com0 at obio0 addr 0xfe810000: ns16550a, working fifo
 220 com0: console
 221 com1 at obio0 addr 0xfe800000: ns16550a, working fifo
 222 iopxs0 at mainbus0: i80312 Companion I/O, acting as PCI host
 223 iopxs0: configuring Secondary PCI bus
 224 pci0 at iopxs0 bus 1
 225 pci0: i/o space, memory space enabled
 226 ppb0 at pci0 dev 7 function 0: Digital Equipment DECchip 21154 PCI-PCI Bridge (rev. 0x05)
 227 pci1 at ppb0 bus 2
 228 pci1: i/o space, memory space enabled
 229 fxp0 at pci1 dev 0 function 0: i82559S Ethernet, rev 9
 230 fxp0: interrupting at iq80310 irq 1
 231 fxp0: Ethernet address 00:80:4d:46:0b:b9
 232 inphy0 at fxp0 phy 1: i82555 10/100 media interface, rev. 4
 233 inphy0: 10baseT, 10baseT-FDX, 100baseTX, 100baseTX-FDX, auto
 234 clock: hz=100 stathz=0 profhz=0
 235 boot device: \*[Lt]unknown\*[Gt]
 236 root device:
 237 .Ed
 238 .
 239 .Ss2 Preparation for the Intel IQ80321
 240 The IQ80321 uses RedBoot firmware from Red Hat, Inc.
 241 RedBoot supports loading the kernel via the serial port and the on-board
 242 Ethernet.
 243 These notes assume that the Ethernet will be used to load the kernel.
 244 RedBoot uses the Trivial File Transfer Protocol
 245 (TFTP) to load the kernel via the network.
 246 .Pp
 247 These notes also assume that the IQ80321 will be run as a diskless
 248 system; that an NFS server will provide the root file system.
 249 The
 250 .Nx
 251 kernel uses the Dynamic Host Configuration Protocol (DHCP) to
 252 obtain network address and root file system information.
 253 .Pp
 254 The first step is to configure your DHCP, NFS, and TFTP server
 255 software.
 256 You will need the MAC address for the on-board Ethernet,
 257 which RedBoot can provide; see the RedBoot documentation for more
 258 information.
 259 .Pp
 260 The next step is to configure RedBoot to obtain its IP address from
 261 your DHCP server; see the RedBoot documentation for more information.
 262 .Pp
 263 Once your DHCP server and RedBoot are properly configured, you should
 264 see information similar to the following when the IQ80321 is reset
 265 or powered-up:
 266 .Bd -literal
 267 Ethernet eth0: MAC address 00:07:e9:03:38:40
 268 IP: 192.168.0.11, Default server: 192.168.0.1
 269
 270 RedBoot(tm) bootstrap and debug environment [ROM]
 271 Non-certified release, version UNKNOWN - built 11:21:56, Feb  1 2002
 272
 273 Platform: IQ80321 (XScale)
 274 Copyright (C) 2000, 2001, 2002, Red Hat, Inc.
 275
 276 RAM: 0x00000000-0x08000000, 0x00017008-0x01ddd000 available
 277 FLASH: 0xf0000000 - 0xf0800000, 64 blocks of 0x00020000 bytes each.
 278 RedBoot\*[Gt]
 279 .Ed
 280 .Pp
 281 A compressed kernel image and loader suitable for placing into
 282 flash is provided with the distribution.
 283 Use of this image is optional;
 284 a kernel that can be directly loaded over the network
 285 by RedBoot is also provided.
 286 .Pp
 287 The image for the IQ80321 can be found under the
 288 .Nx*M
 289 \*V distribution directory in
 290 .Pa \*M/binary/gzimg/gzimg_IQ80321_flash_0xf0080000.gz ,
 291 and corresponds to the kernel in
 292 .Pa \*M/binary/kernel/netbsd-IQ80321.gz .
 293 The following steps
 294 describe how to copy the compressed kernel image into flash.
 295 .Pp
 296 .(enum
 297 Uncompress the gzimg file and place it into the TFTP server's
 298 download area (note, the kernel inside the gzimg is still
 299 compressed after this step).
 300 .Pp
 301 .Dl server# Ic gzcat gzimg_IQ80321_flash_0xf0080000.gz \*[Gt] /tftpboot/gzimg_IQ80321_flash_0xf0080000
 302 .It
 303 Load the gzimg from the TFTP server.
 304 .Pp
 305 .Bd -literal
 306 RedBoot\*[Gt] load -r -b 0x00200000 gzimg_IQ80321_flash_0xf0080000
 307 Raw file loaded 0x00200000-0x00305fe4
 308 .Ed
 309 .It
 310 Use the RedBoot
 311 .Ic fis
 312 command to copy the image into flash.
 313 For more information on the RedBoot
 314 Flash Image System, see the RedBoot documentation.
 315 .Bd -literal
 316 RedBoot\*[Gt] fis create -b 0x00200000 -f 0xf0080000 -l 0x00200000 netbsd.gz
 317 * CAUTION * about to program 'netbsd.gz'
 318             at 0xf0080000..0xf027ffff from 0x00200000 - are you sure (y/n)? y
 319 .Ns ... Erase from 0xf0080000-0xf0280000: .......................
 320 .Ns ... Program from 0x00200000-0x00400000 at 0xf0080000: ......................
 321 .Ns ... Unlock from 0xf07e0000-0xf0800000: .
 322 .Ns ... Erase from 0xf07e0000-0xf0800000: .
 323 .Ns ... Program from 0x01ddf000-0x01dff000 at 0xf07e0000: .
 324 .Ns ... Lock from 0xf07e0000-0xf0800000: .
 325 .Ed
 326 .enum)
 327 .Pp
 328 Once the compressed kernel image has been copied into flash, it may
 329 be started by jumping to the flash address of the image:
 330 .Bd -literal
 331 RedBoot\*[Gt] g 0xf0080000
 332
 333 \*[Gt]\*[Gt] NetBSD/IQ80321 Gzip Boot, Revision 1.1
 334 \*[Gt]\*[Gt] (root@tgm, Thu Mar 28 18:32:45 PST 2002)
 335 \*[Gt]\*[Gt] RAM 0xa0000000 - 0xa7ffffff, heap at 0xa7fd0000
 336 \*[Gt]\*[Gt] Load address: 0xa0200000
 337 \*[Gt]\*[Gt] Image size: 739495
 338 Uncompressing image...done.
 339 Jumping to image @ 0xa0200000...
 340
 341 NetBSD/evbarm (IQ80321) booting ...
 342 initarm: Configuring system ...
 343 physmemory: 32768 pages at 0xa0000000 -\*[Gt] 0xa7ffffff
 344 init subsystems: stacks vectors undefined pmap irq done.
 345 [ using 155076 bytes of netbsd ELF symbol table ]
 346 Copyright (c) 1996, 1997, 1998, 1999, 2000, 2001, 2002
 347     The NetBSD Foundation, Inc.  All rights reserved.
 348 Copyright (c) 1982, 1986, 1989, 1991, 1993
 349     The Regents of the University of California.  All rights reserved.
 350
 351 NetBSD 1.5ZC (IQ80321) #1: Thu Mar 28 18:31:58 PST 2002
 352     root@tgm:/u1/netbsd/src/sys/arch/evbarm/compile/IQ80321
 353 total memory = 128 MB
 354 avail memory = 113 MB
 355 using 1228 buffers containing 6656 KB of memory
 356 mainbus0 (root)
 357 cpu0 at mainbus0: i80321 step A-0 (XScale core)
 358 cpu0: DC enabled IC enabled WB enabled LABT
 359 cpu0: 32KB/32B 32-way Instruction cache
 360 cpu0: 32KB/32B 32-way write-back-locking Data cache
 361 obio0 at mainbus0
 362 com0 at obio0 addr 0xfe800000: ns16550a, working fifo
 363 com0: console
 364 iopxs0 at mainbus0: i80321 I/O Processor, acting as PCI host
 365 iopxs0: configuring PCI bus
 366 pci0 at iopxs0 bus 0
 367 pci0: i/o space, memory space enabled, rd/line, rd/mult, wr/inv ok
 368 wm0 at pci0 dev 4 function 0: Intel i82544 1000BASE-T Ethernet, rev. 2
 369 wm0: interrupting at iop321 irq 27
 370 wm0: Ethernet address 00:07:e9:03:38:40
 371 makphy0 at wm0 phy 1: Marvell 88E1000 Gigabit PHY, rev. 0
 372 makphy0: 10baseT, 10baseT-FDX, 100baseTX, 100baseTX-FDX, 1000baseT, 1000baseT-FDX, auto
 373 clock: hz=100 stathz=0 profhz=0
 374 boot device: \*[Lt]unknown\*[Gt]
 375 root device:
 376 .Ed