1.\" $NetBSD: bootmini2440.8,v 1.4 2012/06/02 14:04:34 njoly Exp $ 2.\" 3.\" Copyright (c) 2012 The NetBSD Foundation, Inc. 4.\" All rights reserved. 5.\" 6.\" This code is derived from software contributed to The NetBSD Foundation 7.\" by Paul Fleischer <paul@xpg.dk>. 8.\" 9.\" Redistribution and use in source and binary forms, with or without 10.\" modification, are permitted provided that the following conditions 11.\" are met: 12.\" 1. Redistributions of source code must retain the above copyright 13.\" notice, this list of conditions and the following disclaimer. 14.\" 2. Redistributions in binary form must reproduce the above copyright 15.\" notice, this list of conditions and the following disclaimer in the 16.\" documentation and/or other materials provided with the distribution. 17.\" 18.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS 19.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED 20.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR 21.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS 22.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 23.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 24.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 25.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 26.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 27.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 28.\" POSSIBILITY OF SUCH DAMAGE. 29.\" 30.Dd January 31, 2012 31.Dt BOOTMINI2440 8 evbarm 32.Os 33.Sh NAME 34.Nm bootmini2440 35.Nd bootloader for FriendlyARM MINI2440 evaluation board 36.Sh DESCRIPTION 37.Nm 38is a program to load 39.Tn ELF 40.Nx 41kernel, which works on top of 42.Tn U-Boot . 43It loads and executes a kernel from an SD memory card, or over 44the network using the 45.Tn NFS/TFTP 46protocol. 47.Pp 48The 49.Nm 50bootloader can be loaded anywhere by 51.Tn U-Boot , 52although care should be taken that the bootloader can load the 53.Nx 54kernel without overwriting itself. 55The kernel is, by default, made to be loaded at 0x30200000. 56The recommended location for 57.Nm 58is 0x30A00000. 59.Pp 60.Nm 61takes a number of arguments, which all are optional: 62.Dl Ar mac=xx:xx:xx:xx:xx:xx Ar opt1 ... Ar optN Ar bootname 63.Bl -tag -width xx 64.It Va mac= 65is used to set the MAC-address of the on-board DM9000 Ethernet 66chip. 67As Mini2440 has no EEPROM to store DM9000 MAC-address, this 68is necessary in order to have a working Ethernet controller. 69If this argument is left unspecified, a default value of 08:08:11:18:12:27 70is used. 71.It Va opt1 ... Va optN 72is one of single, kdb, ask, quiet, or verbose. 73Their meaning is described in 74.Xr boothowto 9 . 75.It Va bootname 76is one of the following: 77.Pp 78.Dl net: Ns Ar ip Ns : Ns Ar filename 79.Dl net: Ns Ar filename 80.Dl net: 81.Dl tftp: Ns Ar filename 82.Dl tftp: 83.Dl ld0 Ns Ar p : Ns Ar filename 84.Dl ld0 Ns Ar p : 85.Pp 86.Bl -tag -width xx 87.It net: Ns Va ip Ns : Ns Va filename 88use 89.Tn DHCP 90to determine own IP-address and load kernel specified by 91.Ar filename 92from the server specified by 93.Ar ip 94using 95.Tn NFS . 96.It net: Ns Ar filename 97use 98.Tn DHCP 99to determine own IP-address and server IP-address. 100Load kernel specified by 101.Ar filename 102from the server using 103.Tn NFS . 104.It net: 105use 106.Tn DHCP 107to determine own IP-address, server IP-address, and kernel to load. 108Load the kernel using 109.Tn NFS . 110.It tftp: Ns Ar filename 111use 112.Tn DHCP 113to determine own IP-address and server IP-address. 114Load kernel specified by 115.Ar filename 116from the server using 117.Tn TFTP . 118.It tftp: 119use 120.Tn DHCP 121to determine own IP-address, server IP-address, and kernel to load. 122Load kernel using 123.Tn TFTP . 124.It ld0 Ns Va p : Ns Va filename 125load kernel from an SD card. 126The kernel specified by 127.Ar filename 128is attempted loaded on the partition given by 129.Ar p . 130.It ld0 Ns Va p : 131load kernel from an SD card. 132The kernel will be loaded from the file 133.Dq Pa netbsd 134on the partition specified by 135.Ar p . 136.El 137.El 138.Sh EXAMPLES 139.Ss Loading Nm 140Use 141.Tn U-Boot 142to load 143.Nm 144at 0x30A00000 from an 145.Tn NFS 146share: 147.Dl Uboot> nfs 30A00000 10.0.0.1:/srv/mini2440/bootmini2440 148.Ss Booting Nx 149Load the kernel from an 150.Tn NFS 151share, overwriting the default MAC-address, and 152booting into single user-mode: 153.Dl Uboot> go 30A00000 single mac=08:08:11:20:22:30 net:10.0.0.1:/srv/mini2440/netbsd 154.Pp 155Load the kernel from an SD card, overwriting the default 156MAC-address, and booting into single user-mode: 157.Dl Uboot> go 30A00000 single mac=08:08:11:20:22:30 ld0a:netbsd 158.Sh SEE ALSO 159.Xr dhcpd 8 , 160.Xr diskless 8 , 161.Xr nfsd 8 , 162.Xr tftpd 8 , 163.Xr boothowto 9 164.Sh HISTORY 165The 166.Nx Ns Tn /evbarm 167.Nm 168first appeared in 169.Nx 6.0 . 170.Sh BUGS 171.Nm 172cannot currently function properly without 173.Tn U-Boot 174(or equivalent). 175Although it performs clock and 176.Tn UART 177configuration, it cannot bootstrap itself from 178.Tn NAND 179flash. 180