1.\" $NetBSD: bootmini2440.8,v 1.3 2012/02/13 18:30:44 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.Sh EXAMPLES 138.Ss Loading Nm 139Use 140.Tn U-Boot 141to load 142.Nm 143at 0x30A00000 from an 144.Tn NFS 145share: 146.Dl Uboot> nfs 30A00000 10.0.0.1:/srv/mini2440/bootmini2440 147.Ss Booting Nx 148Load the kernel from an 149.Tn NFS 150share, overwriting the default MAC-address, and 151booting into single user-mode: 152.Dl Uboot> go 30A00000 single mac=08:08:11:20:22:30 net:10.0.0.1:/srv/mini2440/netbsd 153.Pp 154Load the kernel from an SD card, overwriting the default 155MAC-address, and booting into single user-mode: 156.Dl Uboot> go 30A00000 single mac=08:08:11:20:22:30 ld0a:netbsd 157.Sh SEE ALSO 158.Xr dhcpd 8 , 159.Xr diskless 8 , 160.Xr nfsd 8 , 161.Xr tftpd 8 , 162.Xr boothowto 9 163.Sh HISTORY 164The 165.Nx Ns Tn /evbarm 166.Nm 167first appeared in 168.Nx 6.0 . 169.Sh BUGS 170.Nm 171cannot currently function properly without 172.Tn U-Boot 173(or equivalent). 174Although it performs clock and 175.Tn UART 176configuration, it cannot bootstrap itself from 177.Tn NAND 178flash. 179