.\" $NetBSD: bootmini2440.8,v 1.4 2012/06/02 14:04:34 njoly Exp $ .\" .\" Copyright (c) 2012 The NetBSD Foundation, Inc. .\" All rights reserved. .\" .\" This code is derived from software contributed to The NetBSD Foundation .\" by Paul Fleischer . .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: .\" 1. Redistributions of source code must retain the above copyright .\" notice, this list of conditions and the following disclaimer. .\" 2. Redistributions in binary form must reproduce the above copyright .\" notice, this list of conditions and the following disclaimer in the .\" documentation and/or other materials provided with the distribution. .\" .\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS .\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED .\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR .\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS .\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR .\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF .\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS .\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN .\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE .\" POSSIBILITY OF SUCH DAMAGE. .\" .Dd January 31, 2012 .Dt BOOTMINI2440 8 evbarm .Os .Sh NAME .Nm bootmini2440 .Nd bootloader for FriendlyARM MINI2440 evaluation board .Sh DESCRIPTION .Nm is a program to load .Tn ELF .Nx kernel, which works on top of .Tn U-Boot . It loads and executes a kernel from an SD memory card, or over the network using the .Tn NFS/TFTP protocol. .Pp The .Nm bootloader can be loaded anywhere by .Tn U-Boot , although care should be taken that the bootloader can load the .Nx kernel without overwriting itself. The kernel is, by default, made to be loaded at 0x30200000. The recommended location for .Nm is 0x30A00000. .Pp .Nm takes a number of arguments, which all are optional: .Dl Ar mac=xx:xx:xx:xx:xx:xx Ar opt1 ... Ar optN Ar bootname .Bl -tag -width xx .It Va mac= is used to set the MAC-address of the on-board DM9000 Ethernet chip. As Mini2440 has no EEPROM to store DM9000 MAC-address, this is necessary in order to have a working Ethernet controller. If this argument is left unspecified, a default value of 08:08:11:18:12:27 is used. .It Va opt1 ... Va optN is one of single, kdb, ask, quiet, or verbose. Their meaning is described in .Xr boothowto 9 . .It Va bootname is one of the following: .Pp .Dl net: Ns Ar ip Ns : Ns Ar filename .Dl net: Ns Ar filename .Dl net: .Dl tftp: Ns Ar filename .Dl tftp: .Dl ld0 Ns Ar p : Ns Ar filename .Dl ld0 Ns Ar p : .Pp .Bl -tag -width xx .It net: Ns Va ip Ns : Ns Va filename use .Tn DHCP to determine own IP-address and load kernel specified by .Ar filename from the server specified by .Ar ip using .Tn NFS . .It net: Ns Ar filename use .Tn DHCP to determine own IP-address and server IP-address. Load kernel specified by .Ar filename from the server using .Tn NFS . .It net: use .Tn DHCP to determine own IP-address, server IP-address, and kernel to load. Load the kernel using .Tn NFS . .It tftp: Ns Ar filename use .Tn DHCP to determine own IP-address and server IP-address. Load kernel specified by .Ar filename from the server using .Tn TFTP . .It tftp: use .Tn DHCP to determine own IP-address, server IP-address, and kernel to load. Load kernel using .Tn TFTP . .It ld0 Ns Va p : Ns Va filename load kernel from an SD card. The kernel specified by .Ar filename is attempted loaded on the partition given by .Ar p . .It ld0 Ns Va p : load kernel from an SD card. The kernel will be loaded from the file .Dq Pa netbsd on the partition specified by .Ar p . .El .El .Sh EXAMPLES .Ss Loading Nm Use .Tn U-Boot to load .Nm at 0x30A00000 from an .Tn NFS share: .Dl Uboot> nfs 30A00000 10.0.0.1:/srv/mini2440/bootmini2440 .Ss Booting Nx Load the kernel from an .Tn NFS share, overwriting the default MAC-address, and booting into single user-mode: .Dl Uboot> go 30A00000 single mac=08:08:11:20:22:30 net:10.0.0.1:/srv/mini2440/netbsd .Pp Load the kernel from an SD card, overwriting the default MAC-address, and booting into single user-mode: .Dl Uboot> go 30A00000 single mac=08:08:11:20:22:30 ld0a:netbsd .Sh SEE ALSO .Xr dhcpd 8 , .Xr diskless 8 , .Xr nfsd 8 , .Xr tftpd 8 , .Xr boothowto 9 .Sh HISTORY The .Nx Ns Tn /evbarm .Nm first appeared in .Nx 6.0 . .Sh BUGS .Nm cannot currently function properly without .Tn U-Boot (or equivalent). Although it performs clock and .Tn UART configuration, it cannot bootstrap itself from .Tn NAND flash.