RedBoot User's Guide

Documentation licensing terms

This material may be distributed only subject to the terms and conditions set forth in the Open Publication License, v1.0 or later (the latest version is presently available at http://www.opencontent.org/openpub/).

Distribution of substantively modified versions of this document is prohibited without the explicit permission of the copyright holder.

Distribution of the work or derivative of the work in any standard (paper) book form is prohibited unless prior permission is obtained from the copyright holder.

Trademarks

Altera® and Excalibur™ are trademarks of Altera Corporation.

AMD® is a registered trademark of Advanced Micro Devices, Inc.

ARM®, StrongARM®, Thumb®, ARM7™, ARM9™ is a registered trademark of Advanced RISC Machines, Ltd.

Cirrus Logic® and Maverick™ are registered trademarks of Cirrus Logic, Inc.

Cogent™ is a trademark of Cogent Computer Systems, Inc.

Compaq® is a registered trademark of the Compaq Computer Corporation.

Fujitsu® is a registered trademark of Fujitsu Limited.

IBM®, and PowerPC™ are trademarks of International Business Machines Corporation.

IDT® is a registered trademark of Integrated Device Technology Inc.

Intel®, i386™, Pentium®, StrataFlash® and XScale™ are trademarks of Intel Corporation.

Intrinsyc® and Cerf™ are trademarks of Intrinsyc Software, Inc.

Linux® is a registered trademark of Linus Torvalds.

Matsushita™ and Panasonic® are trademarks of the Matsushita Electric Industrial Corporation.

Microsoft®, Windows®, Windows NT® and Windows XP® are registered trademarks of Microsoft Corporation, Inc.

MIPS®, MIPS32™ MIPS64™, 4K™, 5K™ Atlas™ and Malta™ are trademarks of MIPS Technologies, Inc.

Motorola®, ColdFire® is a trademark of Motorola, Inc.

NEC® V800™, V850™, V850/SA1™, V850/SB1™, VR4300™, and VRC4375™ are trademarks of NEC Corporation.

PMC-Sierra® RM7000™ and Ocelot™ are trademarks of PMC-Sierra Incorporated.

Red Hat, eCos™, RedBoot™, GNUPro®, and Insight™ are trademarks of Red Hat, Inc.

Samsung® and CalmRISC™ are trademarks or registered trademarks of Samsung, Inc.

Sharp® is a registered trademark of Sharp Electronics Corp.

SPARC® is a registered trademark of SPARC International, Inc., and is used under license by Sun Microsystems, Inc.

Sun Microsystems® and Solaris® are registered trademarks of Sun Microsystems, Inc.

SuperH™ and Renesas™ are trademarks owned by Renesas Technology Corp.

Texas Instruments®, OMAP™ and Innovator™ are trademarks of Texas Instruments Incorporated.

Toshiba® is a registered trademark of the Toshiba Corporation.

UNIX® is a registered trademark of The Open Group.

All other brand and product names, trademarks, and copyrights are the property of their respective owners.

Warranty

eCos and RedBoot are open source software, covered by a modified version of the GNU General Public Licence, and you are welcome to change it and/or distribute copies of it under certain conditions. See http://ecos.sourceware.org/license-overview.html for more information about the license.

eCos and RedBoot software have NO WARRANTY.

Because this software is licensed free of charge, there are no warranties for it, to the extent permitted by applicable law. Except when otherwise stated in writing, the copyright holders and/or other parties provide the software “as is” without warranty of any kind, either expressed or implied, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose. The entire risk as to the quality and performance of the software is with you. Should the software prove defective, you assume the cost of all necessary servicing, repair or correction.

In no event, unless required by applicable law or agreed to in writing, will any copyright holder, or any other party who may modify and/or redistribute the program as permitted above, be liable to you for damages, including any general, special, incidental or consequential damages arising out of the use or inability to use the program (including but not limited to loss of data or data being rendered inaccurate or losses sustained by you or third parties or a failure of the program to operate with any other programs), even if such holder or other party has been advised of the possibility of such damages.


Table of Contents
1. Getting Started with RedBoot
More information about RedBoot on the web
Installing RedBoot
User Interface
RedBoot Editing Commands
RedBoot Command History
RedBoot Startup Mode
RedBoot Resource Usage
Flash Resources
RAM Resources
Configuring the RedBoot Environment
Target Network Configuration
Host Network Configuration
Verification
2. RedBoot Commands and Examples
Introduction
Common Commands
alias -- Manipulate command line aliases
baudrate -- Set the baud rate for the system serial console
cache -- Control hardware caches
channel -- Select the system console channel
cksum -- Compute POSIX checksums
disks -- List available disk partitions.
dump -- Display memory.
help -- Display help on available commands
iopeek -- Read I/O location
iopoke -- Write I/O location
gunzip -- Uncompress GZIP compressed data
ip_address -- Set IP addresses
load -- Download programs or data to the RedBoot platform
mcmp -- Compare two segments of memory
mcopy -- Copy memory
mfill -- Fill RAM with a specified pattern
ping -- Verify network connectivity
reset -- Reset the device
version -- Display RedBoot version information
Flash Image System (FIS)
fis init -- Initialize Flash Image System (FIS)
fis list -- List Flash Image System directory
fis free -- Free flash image
fis create -- Create flash image
fis load -- Load flash image
fis delete -- Delete flash image
fis lock -- Lock flash area
fis unlock -- Unlock flash area
fis erase -- Erase flash area
fis write -- Write flash area
Filesystem Interface
fs info -- Print filesystem information
fs mount -- Mount a filesystem
fs umount -- Unmount filesystem
fs cd -- Change filesystem directory
fs mkdir -- Create filesystem directory
fs deldir -- Delete filesystem directory
fs del -- Delete file
fs move -- Move file
fs list -- List filesystem directory
fs write -- Write to filesystem
Persistent State Flash-based Configuration and Control
Executing Programs from RedBoot
go -- Execute a program
exec -- Execute a Linux kernel
3. Rebuilding RedBoot
Introduction
Rebuilding RedBoot using ecosconfig
Rebuilding RedBoot from the Configuration Tool
4. Updating RedBoot
Introduction
Load and start a RedBoot RAM instance
Update the primary RedBoot flash image
Reboot; run the new RedBoot image
5. Installation and Testing
AM3x/MN103E010 Matsushita MN103E010 (AM33/2.0) ASB2305 Board
Overview
Initial Installation
Additional Commands
Memory Maps
Rebuilding RedBoot
ARM/ARM7 ARM Evaluator7T
Overview
Initial Installation
Quick download instructions
Special RedBoot Commands
Memory Maps
Rebuilding RedBoot
ARM/ARM7+ARM9 ARM Integrator
Overview
Initial Installation
Quick download instructions
Special RedBoot Commands
Memory Maps
Rebuilding RedBoot
ARM/ARM7+ARM9 ARM PID Board and EPI Dev7+Dev9
Overview
Initial Installation Method
Special RedBoot Commands
Memory Maps
Rebuilding RedBoot
ARM/ARM7 Atmel AT91 Evaluation Boards (EBXX)
Overview
Initial Installation Method
Special RedBoot Commands
Memory Maps
Rebuilding RedBoot
ARM/ARM7 Atmel JTST Evaluation Board (AT572D740-DK1)
Overview
Installing a RedBoot image on the JTST
Special RedBoot Commands
Memory Maps
ARM/ARM7 Cirrus Logic EP7xxx (EDB7211, EDB7212, EDB7312)
Overview
Initial Installation Method
Special RedBoot Commands
Memory Maps
Platform Resource Usage
Rebuilding RedBoot
ARM/ARM9 Agilent AAED2000
Overview
Initial Installation Method
Special RedBoot Commands
Memory Maps
Rebuilding RedBoot
ARM/ARM9 Altera Excalibur
Overview
Initial Installation Method
Flash management
Special RedBoot Commands
Memory Maps
Rebuilding RedBoot
ARM/StrongARM(SA110) Intel EBSA 285
Overview
Initial Installation Method
Communication Channels
Special RedBoot Commands
Memory Maps
Platform Resource Usage
Rebuilding RedBoot
ARM/StrongARM(SA1100) Intel Brutus
Overview
Initial Installation Method
Special RedBoot Commands
Memory Maps
Platform Resource Usage
Rebuilding RedBoot
ARM/StrongARM(SA1100) Intel SA1100 Multimedia Board
Overview
Initial Installation Method
Special RedBoot Commands
Memory Maps
Platform Resource Usage
Rebuilding RedBoot
ARM/StrongARM(SA1110) Intel SA1110 (Assabet)
Overview
Initial Installation Method
Special RedBoot Commands
Memory Maps
Platform Resource Usage
Rebuilding RedBoot
ARM/StrongARM(SA11X0) Bright Star Engineering commEngine and nanoEngine
Overview
Initial Installation
Download Instructions
Cohabiting with POST in Flash
Special RedBoot Commands
Memory Maps
Nano Platform Port
Ethernet Driver
Rebuilding RedBoot
ARM/StrongARM(SA11X0) Compaq iPAQ PocketPC
Overview
Initial Installation
Additional commands
Memory Maps
Rebuilding RedBoot
ARM/StrongARM(SA11X0) Intrinsyc CerfCube
Overview
Initial Installation
Additional commands
Memory Maps
Rebuilding RedBoot
ARM/XScale Cyclone IQ80310
Overview
Initial Installation Method
Error codes
Using RedBoot with ARM Bootloader
Special RedBoot Commands
IQ80310 Hardware Tests
Rebuilding RedBoot
Interrupts
Memory Maps
Platform Resource Usage
ARM/XScale Intel IQ80321
Overview
Initial Installation Method
Switch Settings
LED Codes
Special RedBoot Commands
Rebuilding RedBoot
Interrupts
Memory Maps
Platform Resource Usage
ARM/Intel XScale IXDP425 Network Processor Evaluation Board
Overview
Initial Installation Method
LED Codes
Rebuilding RedBoot
Interrupts
Memory Maps
Platform Resource Usage
ARM/Intel XScale Generic Residential Gateway
Overview
Initial Installation Method
Rebuilding RedBoot
Interrupts
Memory Maps
Platform Resource Usage
Motorola PrPMC1100 CPU card
Overview
Initial Installation Method
Rebuilding RedBoot
Interrupts
Memory Maps
Platform Resource Usage
CalmRISC/CalmRISC16 Samsung CalmRISC16 Core Evaluation Board
Overview
Initial Installation Method
Special RedBoot Commands
Special Note on Serial Channel
Rebuilding RedBoot
CalmRISC/CalmRISC32 Samsung CalmRISC32 Core Evaluation Board
Overview
Initial Installation Method
Special RedBoot Commands
Special Note on Serial Channel
Rebuilding RedBoot
FRV/FRV400 Fujitsu FR-V 400 (MB-93091)
Overview
Initial Installation Method
Special RedBoot Commands
Memory Maps
Rebuilding RedBoot
Fujitsu FR-V Design Kit (MB93091-CBxx)
Overview
Initial Installation Method
Special RedBoot Commands
Memory Maps
Rebuilding RedBoot
Resource Usage
Fujitsu FR-V Portable Demonstration Kit (MB93093-PD00)
Overview
Initial Installation Method
Special RedBoot Commands
Memory Maps
Rebuilding RedBoot
Resource Usage
IA32/x86 x86-Based PC
Overview
Initial Installation
Flash management
Special RedBoot Commands
Memory Maps
Rebuilding RedBoot
MIPS/MIPS32(CoreLV 4Kc)+MIPS64(CoreLV 5Kc) Atlas Board
Overview
Initial Installation
Flash management
Additional commands
Interrupts
Memory Maps
Rebuilding RedBoot
MIPS/MIPS32(CoreLV 4Kc)+MIPS64(CoreLV 5Kc) Malta Board
Overview
Initial Installation
Additional commands
Interrupts
Memory Maps
Rebuilding RedBoot
MIPS/RM7000 PMC-Sierra Ocelot
Overview
Additional commands
Memory Maps
Rebuilding RedBoot
MIPS/VR4375 NEC DDB-VRC4375
Overview
Initial Installation Method
Special RedBoot Commands
Memory Maps
Ethernet Driver
Rebuilding RedBoot
PowerPC/MPC860T Analogue & Micro PowerPC 860T
Overview
Initial Installation Method
Special RedBoot Commands
Memory Maps
Rebuilding RedBoot
PowerPC/MPC8XX Motorola MBX
Overview
Initial Installation Method
Special RedBoot Commands
Memory Maps
Rebuilding RedBoot
SuperH/SH3(SH7708) Hitachi EDK7708
Overview
Initial Installation Method
Memory Maps
Rebuilding RedBoot
SuperH/SH3(SH7709) Hitachi Solution Engine 7709
Overview
Initial Installation Method
Special RedBoot Commands
Memory Maps
Ethernet Driver
Rebuilding RedBoot
SuperH/SH3(SH7729) Hitachi HS7729PCI
Overview
Initial Installation Method
Special RedBoot Commands
Memory Maps
Rebuilding RedBoot
SuperH/SH3(SH77X9) Hitachi Solution Engine 77X9
Overview
Initial Installation Method
Special RedBoot Commands
Memory Maps
Ethernet Driver
Rebuilding RedBoot
SuperH/SH4(SH7751) Hitachi Solution Engine 7751
Overview
Initial Installation Method
Special RedBoot Commands
Memory Maps
Ethernet Driver
Rebuilding RedBoot
List of Examples
1-1. Sample DHCP configuration file
1-2. Sample /etc/named.conf for Red Hat Linux 7.x