Simtec ABLE Bootloader



  • LINUX® is a registered trademark of Linus Torvalds.

  • UNIX® is a registerd trademark of The Open Group.

  • All trademarks are acknowledged.

While every precaution has been taken in the preparation of this set of books, the publisher assumes no responsibility for errors or omissions, or for damages resulting from the use of the information contained herein.

Revision History
Revision 1.0024th January 2003VRS

Initial release.

Revision 1.403rd February 2003VRS

Updated user guide.

Revision 1.5525th April 2003VRS

Updated user guide.

Revision 1.7317th September 2003VRS

Updated user guide.

Revision 1.8018th November 2003VRS

Updated user guide.

Revision 1.9510th March 2004VRS

Updated user guide.

Revision 2.0112th October 2004VRS

Updated user guide.

Revision 2.0813th April 2005VRS
Updated user guide.
Incorporated ABLE FIS tool guide.
Revision 2.2020th Febuary 2006 

Updated user guide

Table of Contents

ABLE User Guide
I. Usage
1. Overview
2. Getting Started
2.1. Using hyperterm as a serial console
2.2. Using minicom as a serial console
3. Command Line Interface
3.1. Command line editing
3.2. Simple commands
3.3. Conditional execution
3.4. Quoting
3.5. Shell variables
3.5.1. Simple variables
3.5.2. Non volatile variables
3.5.3. Positional variables
3.5.4. Special variables
3.5.5. Accessing variables
3.5.6. Variables with special meanings
3.6. Filesystem navigation
3.7. ABLE help system
3.8. Shell script
4. Setting Options
5. ABLE Console
5.1. Console drivers
5.2. Setting parameters on serial drivers
5.3. Configuring the console system
5.4. Setting the logging level
5.5. Practical use of the console system
5.5.1. Basic serial debug console
5.5.2. No console at all
5.5.3. Displaying a logo and boot abort
6. Starting an Operating System Manually
6.1. Data sources
6.2. Alias sources
6.3. Network sources
6.4. XModem source
6.5. Navigating a filesystem
6.6. How ABLE identifies files.
6.6.1. ABLE shell script
6.6.2. ABLE executable
6.6.3. ARM LINUX® zImage
6.6.4. ELF and AOUT files
6.6.5. UNIX® Compress files
6.6.6. Gzip files
6.6.7. Images, text and data files
6.6.8. Motorola S-Record
6.7. Starting an Operating System
6.7.1. The "setargs, load and boot" method
6.7.2. The "command line" method
7. Starting an Operating System Automatically
8. Networking
8.1. Finding a network interface
8.2. Configuring a network interface
8.3. Using the network to obtain files
9. Upgrading
9.1. Obtaining Upgrades
9.2. Loading the Upgrade
9.3. Running the upgrade
II. Command Reference
I. Core Commands
autoboot — Attempt to locate and boot suitable images automatically.
console — Controls ABLE console.
date — Show the current real time clock date and time.
devls — Lists information about devices attached to a system
display — Display and image on console.
help — Display help on built in commands
history — Lists the commands in the command line history.
hwinfo — Print hardware information.
man — Manual page display
meminfo — Shows memory information.
modules — List ABLE modules
pmu — Power management control
reset — Reset machine
sbcd — Manipulates the board configuration data.
setdate — Sets the date in the real time clock
setopt — Sets device options.
settime — Sets the real time clock
shadow — Moves ABLE into RAM
showhz — Shows how long a system has been running
sysmsg — Show system messages.
sysspeed — Sets the system clockspeed
tasks — Displays task threads currently running on system.
uname — Print system identification
version — Display ABLE shell version
wrout — Write a string to an output file.
II. Shell Commands
echo — Output some text to standard output
exit — Exit ABLE shell
read — Reads a line of input into shell variables
sh — Start a new ABLE shell
sleep — Delay for a specified amount of time
test — Performs test operations
III. Network operations
ifconfig — Network device configuration and selection
mii — MII phy control
IV. File Navigation
cd — Change present working directory
ls — List files in directory
lsfs — List available filesystems
pwd — Show present working directory
V. File manipulation commands
cat — Displays contents of a text file
cp — Copy a file.
dumpfile — Displays a file in a hexadecimal dump
file — Tests each argument in an attempt to classify it.
sum — Checksum a file
VI. Non-volatile settings
nvclear — Reset non-volatile settings to defaults
nvsave — Save altered non-volatile settings
nvset — Set non-volatile parameters
nvshow — Show non-volatile parameters
nvunset — Clears non-volatile parameter
VII. OS manipulation commands
boot — Starts loaded OS images
load — Load executable images
showargs — Shows arguments to be passed to any booted OS
setargs — Sets arguments to be passed to an OS started with the boot command
VIII. Debugging commands
bast-at — Perform an audio test.
bast-at2 — Perform BAST audio test copies the line in to the line out
bast-hdlcd — Manipulate an HD44780 attached to the EB2410ITX LCD Module port.
dmcfg-rd — Debug command to read Davicom EEPROM
dmcfg-wr — Debug command to write Davicom EEPROM
dump — Displays an area of memory in hex dump
memset — Set range of memory to a specific value.
peek — Examine memory location
pic-rd — Read a value to the PMU PIC
pic-wr — Write a value to the PMU PIC
poke — Poke memory location
tick — Check system timing.
vtp1 — Video test pattern
vtp2 — Video test pattern
vtp3 — Video test pattern
vtp4 — Video test pattern
vtp5 — Video test pattern
III. Non-Volatile Variables Reference — Enable auto boot
boot.cmd — Command line to use for auto boot
boot.timeout — Time to wait before auto boot
boot.fs — The filesystems to be scanned by the autoboot command.
console.write — Default Console output stream — Default Console input stream
console.level — Console logging level
fb.enable — Framebuffer driver - enable output
fb.output — Framebuffer driver - output target
fb.x — Framebuffer driver - Display X size (width)
fb.y — Framebuffer driver - Display Y size (height)
fb.refresh — Framebuffer driver - Display refresh frequency
ide.multi-limit — IDE multiple sector read limit
shell.hist — Shell history depth
sys.autoshadow — Determines if ABLE will automatically moved into RAM at system start
sys.speed — System speed set at start time
usb.enable — USB system enable
usb.hubdepth — USB system depth hubs should be searched for devices to
IV. Appendices
A. Changelog
ABLE FIS User Guide
1. Overview
2. Using ABLE FIS
2.1. Main Menu
2.2. Edit Menu
ABLE batty user guide
1. Overview
2. Using batty