Home

ABLE User Guide - Simtec Electronics

1. 52 9 2 The romwrite command producing warnings seeseeeee eme hee hene 52 9 3 The romwrite command completing successfully 52 29 Using the console command teen fere senna ERREUR EU PEDE tent l iron ciones 65 30 Using the date command seen 67 31 Using the devis command eem ree eer Ene rr te ree EE IR Er ey eoru rte Re ERR ERR 69 32 Using the display command ss 71 33 Usms the help Command AS aO RAS ne de MUR UD ti ens 73 34 Usme thie history command 5 utere oett Sunes as nr ins eol Peer ede EEA REEERE ENE pud 75 35 Using the hwinfo command ss 77 36 Using the man commiand 1 cete te vanes ttes deed erii aaa cn eegtesagvelaas den doe eoe tee de eau 79 37 Using the meminfo command ss 81 38 Usmg the modules command cs res eerte er ted step reme pee danser E S Oboe o entente teen en del 83 39 Using the setdate command to set the real time clock se A 91 40 Using the setopt command to alter serial port options sess 93 41 Using the settime command to set the real time clock o ooccoocccnnccnnnoccnnccnnnnccnnnncnonccnnnnconnnrnnnnooe 95 42 Using the sliowhz command 5 ener terret E e rete ERR RD Rer FERRE RE RR Ere ne reg 99 43 Displaying the system messages after a default boot cele ee cece cee ce ence eeeeeeeeeecaeeea eens eeae esas 101 44 Using th
2. CHAN il 0 canes il QE brw rw rw 1 0 O0 0 O norO brw rw rw 1 0 0 OF O hdcl brw rw rw 1 0 0 OF DENIS um 1 0 0 0 9 ELY lei dL 9 9 OF O xmodem brw rw rw 1 0 0 OF O console Drw caw AW 1 97 O char4 brw rw rw 1 0 0 0 O char3 brw rw rw 1 0 0 D 0 cin brw rw rw 1 0 0 OF 0 inue 1L Dim i 0 O char0 3L 0 0 OF O 24cxx0p1 brw rw rw 1 0 0 0 O 24cxx0 Sec i 0 0 O nand0p2 gt dL 0 40 0 O nand0p1 io i 0 0 OF O nando brw rw rw 1 0 0 OF O s3c2410x lrwxrwxrwx 1 0 0 11 incl gt ack erez lrwxrwxrwx 1 0 0 5 s3c2410 serial2 gt char lrwxrwxrwx 1 0 0 5 Soc NI ONES enses E chars lrwxrwxrwx 1 0 0 5 SSeC2Z40L0_seieieil clase lrwxrwxrwx 1 0 O0 5 uil6550 seriat gt clu lrwxrwxrwx 1 0 0 5 ul6550_serial0 gt char0 lrwxrwxrwx 1 0 0 8 nvram0 gt 24cxx0p1 lrwxrwxrwx 1 0 0 LS lasmi gt menol392 e 31 1572 lrwxrwxrwx 1 0 0 7 flash0 gt nand0pl gt The sources listed as links are aliases which build upon or cook the behaviour of other sources 6 2 Alias sources 39 Chapter 6 Starting an Operating System Manually The previous section described how to identify a possible data source within ABLE Typically these data sources are a raw unprocessed set of data to be useful a data source is generally partitioned and has a filing system placed upon it The process of building upon a raw data source is sometimes referred to as cooking which
3. The four byte 32 bit addressed data record may be repeated as often as required to load all the program into memory The four byte address gives access to the entire 4GB memory region of the ARM memory map The ad dress is specified as a physical location au d Length Address CRC Data Four byte addressed data 5 Data XXXXXXXX 00 FF The four byte 32 bit address end record is used to specify the address that execution will start from The address is specified as a physical location This record should only occur once at the end of the data s 7 Length Entry Address CRC 5 00000000 FFFFFFFF 00 FF Four byte addressed data end During the parsing of an S Record it is possible a syntax error in the input data may occur If this happens an error report will be reported in the form error 1 om lume 1 Table 6 1 S Record loader error codes Code Error 1 Line didn t start with S Line finished before type 2 3 Type was not 0 9 4 Line finished before length 5 Length field contained invalid characters Simtec Electronics 43 Chapter 6 Starting an Operating System Manually Code Error 6 Line finished early in data 7 Data contained invalid characters 8 Checksumfailed Where the errors refer to invalid characters this means characters other than 0 9 and A E were found in the line Example 6 5 An example S Record T
4. n 161 IVA 163 vel AT 165 mir e 167 VIL OS manipulation commands ss 169 boot terrestre dra oia ee OUR Eon 171 irn EET 173 SHOW ALES eR 175 SA A A ad 177 VIII Debugging commands derit ert ran E as RE A ERR Pee PORE ses reed cash anse 179 Dt aa 181 Dast a12 55m met muets EN anne nine E cod io CERN ten ey 183 bast hdled cis tr ais 185 Amick gard SERRE eet e E tt e ecete spas rdiet te 187 AIMNCES WI Susie Soy eds revo tese use OSs us goto ortos entadars e uut le orne ro ge Ufer ua o eee tn 189 dump sites Te Neo teeth eroi ob eet a oe ede etes po me IE ene lok ie 191 niu lt 0 denne EET 193 iv Simtec Electronics nnam H 197 jov age cC ile da dee n p EE O 199 juo UE 201 o dq cT 203 ger PE 205 MA E RR E 207 ins ERE 209 DUE 211 WEDS cde or tee PEERS a lata cis 213 III Non Volatile Variables Reference cseeseeseee I meme me eme he esee ese ere eese uses enun 215 BOOP AUTO ys sod o rA cd ees tam cesso n ag the eee a eee ee n boe de wre ed a Lec is e MORES 217 booted RN RT ELT 219 DoOt UnmeoUts sunt o ada de tr t Eo o oc vea UE ohne teh adu Dae E tt a E Cokes pa 221 hear ce EE 223 Console Write owed UR ED e eM E EE E MUT MER re 225 console read 3 54 cedant e RS RU teo mt Et n des 227 Console AE EEE EE E E A 229 A oto ee er tese s e e naa a os sr Aaea aie es an os e Aan 231 I b Output e nei ne SU clave se ent ores stub en E MY me shat e
5. Simtec Electronics Samsung 2410 Evaluation Board Resources Firefox File Edit View Go Bookmarks Tools Help Qa X E X amp A http www simtec co uk products EB2410ITX resources html firmware O Go 2 Firmware ABLE AA ABLE is Simtec s next generation firmware It is cross platform and is being actively developed for all Simtec boards The ABLE resources section has more information and documentation The current version of ABLE for the EB2410ITX is 2 20 which is available in two binary packages The changelog details the changes in this release Romwrite upgrade suitable if upgrading from a previous version of ABLE H Raw binary suitable for programming with an EEPROM programmer H ABLE User Guide fo TA ABLE FAQ Tol ABLE Changelog TS TE Le EB2410ITX resources webpage open at the firmware section A version of ABLE which is up to date at the time of shipping is provided on the boards support CD It is always recommended that the latest update be obtained from the website in preference to the CD version 9 2 Loading the Upgrade The upgrade can be retrieved from any available boot device Some examples for a EB2410ITX are cdrom cd0 eb2410itx romwrite v220 bin tftp tftpboot eb2410itx romwrite v220 bin 51 Chapter 9 Upgrading hard disc hd0 eb2410itx romwrite v220 bin ABLE can navigate several types of filesystem Section 6 5 Navigating a filesystem h
6. bin sh ABLE shell test echo TEST test d sit 2 amp amp echo Yi ZY 2 lit i 1 6 echo 2 lt i 2 que 1 EG ecmo 2 gt 14 L i gi 2 amp emo Wil gt 24 echo TEST simple variable expansion foo bar echo foo echo TEST variable expansion within test bar 10 dL sihe Siseue gi Calas Wil So i gne Soar amp amp Secas i gt Ses echo Sbar echo TEST quoting tests echo TEST single quotes 28 Simtec Electronics Shell script acaso UN XS We Secus Sit Soc Sto echo TEST double quotes echa SO SO O Sfoo Scho JUS S AO pones exo WX WS My Sos S4 Sito Wero echo TEST quoted single var Cem oM Hioc T OON echo TEST quoted curly brace single var echo S foo S foo echo TEST positional parameters echo There are S positional parameters che AIT parameters PS a echo Parameter 0 1 2 gt 0 1 2 lt echo Parameter 0 0 echo Parameter 1 1 echo Parameter 2 2 echo Parameter 3 3 When executed the above script should produce the following output gt tftpboot test sh one two three readudp incorrect length SUUS TESE 2 gt odi EST simple variable expansion w K EST variable expansion within test lt di 0 EST quoting tests EST single quotes w Sbar Sfoo foo EST double quotes S Ww 10 4 Jeu too SIS me CLOLSS S w 10 Ss ber Sitoo EST quoted single var arbar EST quoted curly brace single
7. Example 67 Using the showargs command gt showargs BOOTARGS root dev hda3 gt 175 176 Simtec Electronics Name setargs Sets arguments to be passed to an OS started with the boot command Synopsis setargs arguments Options arguments Arguments to be passed to OS Description Sets arguments to be passed to an OS started with the boot command Example 68 Using the setargs command gt showargs BOOTARGS root dev hda3 gt setargs root dev hdcl console ttySACO 115200 gt showargs BOOTARGS root dev hdcl console ttySACO 115200 gt 177 178 Simtec Electronics Debugging commands These are commands used to debug issues with ABLE and manipulating specific system functions Some of these commands may not be available in all configurations and platforms 179 180 Simtec Electronics Name bast at Perform an audio test Synopsis bast at scale Options scale Volume between 0 off and 16 full Description Perform an audio test generates a 1 378KHz sine wave 44 1 KHz clock 32 samples 1 378KHz Warning The sound is very loud using higher scale values Ear protection may be required 181 182 Simtec Electronics Name bast at2 Perform BAST audio test copies the line in to the line out Synopsis bast at2 Description Performs a test on the EB2410ITX audio system by copying the line in to line out 183 184 Simtec Electron
8. The Simtec Electronics Advanced Boot Load Environment ABLE is a portable modular boot loader for use in ap plications where an Operating System OS must be retrieved and started ABLE provides extended functionality providing modules for a command line video consoles serial consoles network booting and numerous other facil ities ABLE is a powerful tool and provides a flexible environment useful for both the development and deployment of systems ABLE is a boot loader not an Operating System this distinction can sometimes lead to misunderstand ings about the capabilities provided by ABLE A boot loader in this context is a self contained program which re trieves and starts execution of an Operating System it does not execute user programs itself all the CLI commands are built in and does not provide services to an Operating System once started PC BIOS perform this role The modular nature of ABLE allows the use of the same building blocks for every supported platform The integ ration and omission of various modules allow for specific driver sets depending on the peripherals of a platform The flexibility of this approach allows for a common familiar environment across all supported platforms while still supporting a complete feature set This user guide covers the operation of ABLE from its command line interface CLI For details on the program ming interface and more advanced topics please see the ABLE Reference manual or contact
9. gt showhz ize i609 12988 secomels gt 99 100 Simtec Electronics Name sysmsg Show system messages Synopsis sysmsg Description Displays the system message history buffer This buffer contains all the messages ABLE has produced Not all of these messages may have been output to the console the console level variable and the console command control which messages are displayed and which are simply placed in the message buffer Example 43 Displaying the system messages after a default boot The system message log contains more information than will can be useful for discovering problems selected all wr for console write selected all rd for console read DRAM 128 Mb 134217728 bytes BASIE EMOS So 1 02 3 00601 55 ls 0 0 9 0 1 8 ABLE 2 20 Copyright 2001 2005 2006 Simtec normally be output to the console these messages 6a Electronics PIO mode 4 link ok 100Mbit full duplex Thu Feb 16 14 47 40 GMT 2006 0x014b RO 07292 S121 addressed UID unset ng CPU Speed to 266MHz LO Quo qw locals LEO Ola da Clloelk dito Cm WwW loci hdb ATAPI CDROM TOSHIBA CD ROM XM 7002B hdc FUJITSU MHF2043AT ATA PIO mode 4 hdc Diagnosing disc drive ok hdc 4GB dme c a Uncle sexe 2 hdb Drive Empty DMSOD0S chs iil OOs OilssceOOsOilsoa atime pay MEZOOOs ies USA Eemeicie OOs Oils 3clsOWsOil s Gio TMP101 not de
10. The setargs load and boot method as its description suggests uses a three stage method in order to start an oper ating system The setargs command is used to set the arguments with which to call the OS Theload command with the path to the OS kernel or image to load The boot command to start the loaded image with the specified parameters This method gives the most flexibility and control but is cumbersome to use Example 6 6 Using the setargs load and boot method to start a LINUXO kernel gt setargs root dev hdal console ttySAC0 115200 gt load hd0 vmlinuz loaded hd0 vmlinuz 0x16a6e0 bytes at 0x00008000 gt boot boots lonas Y ias Booting Linux Simtec Electronics The command line method 6 7 2 Simtec Electronics UACOMLESS STAN ol tee ei te nie Re else A Rb le I ETE eu Linux version 2 6 11 vince gerald CPU ARM920Tid wb 41129200 revision O ARMv4T CPUO D VIVT write back cache CPUO I cache 16384 bytes associativity 64 32 byte lines 8 sets CPUO D cache 16384 bytes associativity 64 32 byte lines 8 sets Machine Simtec BAST Memory policy ECC disabled Data cache writeback CPU S3C2410A id 0x32410002 S3C2410 core 266 000 MHz memory 133 000 MHz peripheral 66 500 MHz SSC Clocks We ZOO Sinmeee mikeerc icoimies USE Power Comexzol e 2004 Simese lecrromicas Built 1 zonelists Kernel command line root dev hdal console ttysAc0 11520
11. enable output Description If set the framebuffer device driver will be enabled and added to the list of selectable consoles If clear then the framebuffer driver will not be initialised and video console will not be selectable Platforms EB2410ITX default is on i e framebuffer will be enabled EB7500ATX default is on i e framebuffer will be enabled 231 232 Simtec Electronics Name fb output Framebuffer driver output target Description Determines the output device for framebuffers with multiple output ports Platforms EB2410ITX default is vga i e output will be sent to vga socket 233 234 Simtec Electronics Name fb x Framebuffer driver Display X size width Description This determines how many pixels wide the video display console will be See fb y for the y resolution Platforms EB2410ITX default is 640 235 236 Simtec Electronics Name fb y Framebuffer driver Display Y size height Description This determines how many pixels high the video display console will be See fb x for the x resolution Platforms EB2410ITX default is 480 237 238 Simtec Electronics Name fb refresh Framebuffer driver Display refresh frequency Description This determines the framebuffer refresh rate Platforms EB2410ITX default is 60 239 240 Simtec Electronics Name ide multi limit IDE multiple sector read limit Descri
12. rw r r rwr r IWXY XYE X ENT r gt hdc2 hdc1 ext2 9190877 97 5 Lo umeumel p2 sn 1 92 to nand0pl 376034 28687 1016944 45 1484512 533056 PRPRPRPRPR 6666 SISSI 3 7 ABLE help system System map 2 4 25 bast config 2 4 25 bast vmlinuz 2 4 25 bast patches 2 4 25 bast vinil nia 2 5 oesie System map 2 6 11 bast The ABLE command line has a useful help system available the help command gives a list of all known com mands some commands have a help parameter which is another way to obtain the help text Example 3 5 Getting help on the uname command gt help Internal commands are sh autoboot sbcd bast at2 bast EL dmcfg rd mii ECO ML file hwinfo wrout nvsave nvshow nvset sleep showhz sysmsg reset memset meminfo 15s SiS help ca EP cd history sysspeed settime Use bast hdlcd dmcfg wr ESSE version uname Seow peek echo pwd setdate help lt command gt to get brief explanation command help for command usage Simtec Electronics if available pic wr pmu console nvclear sum showargs poke dumpfile boot devls prier shadow display nvunset tasks Seu auris modules dump load date 27 Chapter 3 Command Line Interface gt help uname Help on uname Usage uname OPTION Print system information No OPTION is the same as s e all information in the order Sip kernel nam kernel
13. 152 MHz 158 MHz 170 MHz 180 MHz 186 MHz 192 MHz ADEME 210 MHz 226 MHz 266 MHz 268 MHz 270 MHz gt sysspeed 226 Setting CPU Speed to 226MHz CPU Speed successfully changed gt sysspeed 34 MHz 45 MHz 51 MHz 48 MHz 56 MHz 68 MHz 79 MHz 85 MHz 90 MHz 101 MHz ESE 118 MHz 124 MHz 135 web 147 MHz 152 MHz 158 MHz 170 MHz 180 MHz 186 MHz 192 pz 203 MHz 210 Wily DAS B 266 MHz 268 MHz 270 MHz gt 103 104 Simtec Electronics Name tasks Displays task threads currently running on system Synopsis tasks Description ABLE runs several threads to control various hardware devices This command displays the currently running threads The information is presented in a tabular form The columns are Task name and address Priority of execution Current state Register context block Time thread was last scheduled The scheduling for the threads is a simple round robin method which suffices for ABLE requirements Example 45 Using the tasks command This example shows the tasks command when run on a EB2410ITX The showhz command is used to show the current system time which is the same as used in the Last Run column It shows the Ethernet PHY control task the USB host controller driver the reaper task to clean up after other tasks the init task which starts the system and the main task which typically runs the autoboot or interactive shell gt showhz tasks showhz HZ 13e6034 208650 seconds Task Prio
14. Built 1 zonelists Kernel command line root dev hdal console ttySAC0 115200 45 46 Simtec Electronics Chapter 7 Starting an Operating System Automatically ABLE has a flexible system to automatically run a given user command at boot time The command to be run is controlled by the boot cmd non volatile variable If the boot command is not set it defaults to the autoboot com mand The execution of the boot process may be prevented by setting the boot auto variable to true If the boot auto variable is not set or set to false the boot command is run after a delay set by the boot timeout variable The delay is in seconds and allows the user to abort the boot process by pressing a key The console input from which the keypress is accepted is described in detail in Chapter 5 ABLE Console The boot command is executed by the ABLE shell Any shell script command may be placed in the boot cmd seperated by semicolons If more than a small number of commands need to be issued they should be placed in a shell script and the script executed Example 7 1 Displaying a logo during the automatic boot process This example shows how the boot cmd can be set to display a logo on the video console before continuing with an automated boot using the autoboot command gt nvset boot cmd display d s3c2410x video tftpboot logo bmp Z autoboot gt nvshow boot cmd boot cmd display d s3c2410x video tftpbo
15. GI 120 Simtec Electronics Name sh Start a new ABLE shell Synopsis sh x e v i help version Options x Display the command to be executed with its variables expanded e Exit immediately if a command fails v Display lines of input as they are read i Start an interactive shell help Display short helptext and exit version Display commands version and exit Description This command starts a new ABLE shell for full information on using the shell refer to Chapter 3 Command Line Interface The newly created shell environment is separate from the invoking shell variables from the parent are not available and upon exit any variables set within the shell are lost Example 50 Subshell variable scope This example shows setting variables in the outer shell and in the subshell and their scope gt echo FOO gt echo BAR gt FOO hello and goodbye gt BAR goodbye and hello gt sh gt echo FOO gt echo BAR gt BAR something else gt FOO entirely gt echo FOO S BAR something else entirely gt exit gt echo FOO hello and goodbye gt echo BAR goodbye and hello The x e and v switches control the shells overall behaviour these variables are accessed from the shell using the special variable _ 121 122 Simtec Electronics Name sleep Delay for a specified amount of time Synopsis sleep time Options time Time in se
16. Sres Clos mln Age gt 0007 e0 starting PHY reset 262 TMP101 not detected sys autoshadow unset automatically shadowing gt date Wed Mar 22 01 02 26 2006 gt settime 16 40 0 gt date Wed Mar 22 16 40 00 2006 gt See also setdate date ABLE 2 21r1 Copyright 2001 2005 2006 Simtec Electronics 100Mbit full duplex 95 96 Simtec Electronics Name shadow Moves ABLE into RAM Synopsis shadow Description Moves ABLE into RAM This allows systems where ABLE executes directly from flash memory to move ABLE into RAM where it will execute faster this is also required if the underlying flash memory is to be reprogrammed e g when upgrading ABLE This command is largely deprecated and is generally now only used on the EB7500ATX Most platforms are run ning ABLE shadowed as most current designs do not have directly mapped memory to execute from 97 98 Simtec Electronics Name showhz Shows how long a system has been running Synopsis showhz Description ABLE maintains an internal timer which increments 100 times a second The timer is started from O and hence gives an indication of the amount of time since the last reset This command displays the value of the system timer in hexadecimal the value is also converted into seconds for convenience Example 42 Using the showhz command gt showhz sleep 10 showhz HZ be36 486 seconds HZ c227 497 seconds
17. Synopsis dumpfile filename s start offset l length length b blksize size t text help Options filename File to dump s start offset Offset in bytes into the file to start the dump 1 length length Length of data in bytes to dump b blksize size Block size t text Dump text only no hex output help Display short helptext and exit Description Use to display the contents of a file in a hexadecimal dump The output will be put through a pager and can be aborted with q Care should be taken with the parameters to this command which come after the filename Example 61 Using the dumpfile command This example shows the dumpfile command being used in text only mode to show the first 300 bytes of a file dumpfile hd0 etc services t 1 300 dump hd0 etc services is 17571 bytes long dumping 0 to 300 00000000 4 Network services Internet style Note that it is presently 00000040 the policy of IANA to assign a single well known port number 00000080 for both TCP and UDP hence officially ports have two entries 000000c0 even if the protocol doesn t support UDP operations Update 00000100 d from http www iana org assignments port numbers and other gt This shows the file dump of the same file with hex output and starting with a hundred byte offset into the file gt dumpfile hd0 etc services s 100 dump hd0
18. Synopsis nvsave Description This command commits any changed non volatile variables to real storage Without this command changes will not be retained across a reset 161 162 Simtec Electronics Name nvset Set non volatile parameters Synopsis nvset variable value Options variable A non volatile variable name value Value to set variable to Description Sets a non volatile variable to a given value The same effect can be achieved by simply setting the shell variable appropriately The value is usually free form text for general options for boolean values the values on and off are used true false and 0 1 may also be used Example 64 Using the nvset command and shell method to alter a non volatile variables nvshow fb enable b enable on nvset fb enable off nvshow fb enable enable off fb enable on nvshow fb enable enable on fb enable false nvshow fb enable nable EIE nvset fb enable tru nvshow fb enable fb enable on o oO a 0 G oO WENA Ten WA NZ an WWE eap Y a YA pops V 163 164 Simtec Electronics Name nvshow Show non volatile parameters Synopsis nvshow variable Options variable non volatile variable name Description This command shows the current settings of the non volatile variables If the variable is omitted a complete list 1s shown otherwise only the specified variable is shown Single non volatile sett
19. added to a list Once all the filesystems have been checked the list is displayed and a countdown commenced starting with the boot timeout value If a user selects on of the entries they are then prompted to alter the guessed parameters and asked if they wish to make the resulting command line the boot cmd entry If the user does not interact with the command before the countdown completes the first entry on the list is attempted if that fails the second is tried and so on down the list until all entries have been attempted Figure 7 Autoboot command flowchart 61 autoboot 62 autoboot command executed Is boot fs set Set boot fs to default cd hd rom tftpboot Select next filesystem from boot fs Add item to boot list Found bootable item on filesystem Any more filesystems to check Display boot list Is there another item on boot list Select next item on boot list Key pressed boot timeout exceeded Execute boot item exit command Select boot item from list Simtec Electronics Simtec Electronics Flowchart of the autoboot command 63 64 Simtec Electronics Name console Controls ABLE console Synopsis console a add driver d drivers s level 2eve1 l list h help Options a add d drivers S level 1 Last h help Description adds a new console driver to those
20. baud rate parity etc altered as required at initialisation time or later with the setopt command u16550 serialX A given system may have several standard 16550 based serial ports each will have an entry As with all serial devices except the serial driver in ABLE the port settings may be altered as required at initialisation time or later with the setopt command 5 2 Setting parameters on serial drivers The serial port drivers s3c2410_serial and u16550 serial can be given parameters when they are initialised This 1s achieved by placing additional comma separated parameters after the driver name within the containing brackets The configuration format is in one of the forms driverxX driverX baud driverX baud data format Options may be omitted Such options are either left as the current settings or set to defaults as necessary The de fault settings when the ports are first initialised is 115200 baud eight data bits no parity and a single stop bit 115200 8n1 The data format is specified as three single character values The first denotes the number of data bits typically eight or seven The second sets the parity type one of none n odd o or even e The third is the number of stop bits either one or two Example 5 2 Setting serial console driver parameters To use the s3c2410 serial driver first port at 19200 baud using the default data format mg S3e24 1 CO 19201 To use the s3c2410
21. file OPTIONS ab mime Causes the file command to output mime type strings rather than the more traditional human readable ones help display short helptext and exit version display commands version and exit DESCRIPTION The file command examines a given file and tries to determine the files type The underlying detection code is the same as that used by ABLE when determining how to load and execute files this is useful if the user wishes to check ABLE is correctly determining a files type Example 48 Using the file command to determine filetypes HORS Note This command is only available on a limited number of platforms due to the size of the manual files re quired 79 80 Simtec Electronics Name meminfo Shows memory information Synopsis meminfo Description Shows the memory availabe within the system and the ABLE current memory usage Example 37 Using the meminfo command gt meminfo Memory regions 30000000 size 04000000 65536 KiB 34000000 size 04000000 65536 KiB Memory pool 382 3752 KiB 18 free blocks gt 81 82 Simtec Electronics Name modules List ABLE modules Synopsis modules Description Lists all the ABLE modules within a particular build ABLE is constructed using a small section of head or ini tialisation code and a number of modules Each module provides a specific piece of functionality to the system e g the cmd_ time module provides th
22. Or the value with the current contents of memory Clear the bits of the memory location which are set in value Alter the memory to the value Repeats the read count times Memory address to read in hexadecimal Value to set in hexadecimal This command alters a memory location to the specified value The address specified is dependant on the machine architecture and is the translated by the MMU The p option causes the physical address specified to be translated into a virtual address suitable for use within ABLE the virtual translated address is shown See also dump peek memset 201 202 Simtec Electronics Name tick Check system timing Synopsis tick Description Outputs a dot once a second until one of q or e is pressed This is used to verify system timing 203 204 Simtec Electronics Name vtp1 Video test pattern Synopsis vtpl Description Video test pattern filling the whole of the screen with the following pattern Left hand side 8 pixel vertical red bar Right hand side with 8 pixel green bar The rest of the screen is an stipple pattern of white and black single pixels This command will not be available if the frame buffer is disabled Figure 8 Video test pattern 1 205 206 Simtec Electronics Name vtp2 Video test pattern Synopsis vtp2 Description alternating 8x8 white and black block pattern reen with the following pattern Left hand
23. System Manually Chapter 7 Starting an Operating System Automatically Chapter 8 Networking Chapter 9 Upgrading Part II Command Reference Part III Non Volatile Variables Reference Gives an outline of what functions ABLE does and does not provide and a brief discussion of possible features Gives an introduction to the facilities of ABLE and methods for interacting with the bootloader Gives a comprehensive guide to using the in built command line interface Provides a guide to the use of non volatile ram settings Shows how ABLE communicates with the user and how that is controlled Shows how Operating systems may be started manually Shows how the automatic boot process operates Gives details on how to configure network interfaces from ABLE Gives details on how to upgrade the bootloader Is a complete reference to all the built in commands within ABLE Is a complete reference to all the non volatile variables available within ABLE Acknowledgements Several people contributed to the creation of this book in various ways I would especially like to thank R Parry and M Gillard for proofreading Feedback Any suggestions comments or corrections concerning this document are welcomed please contact Simtec Electronics giving The document title The document revision A clear explanation of your comments and how they apply xiii XIV Simtec Electronics Part Usage Chapter 1 Overview
24. This command can be used to obtain a complete list of the devices attached to the system Example 31 Using the devls command This shows the use of a simple devls command on the EB2410ITX The output shows a list of all devices within the system and information on those devices where known gt devls buss bus l VO 9 DERE C9 C9 CO C9 CO CO COSSIO eee dy la SS NS DDD fe SS 00000000 80000000 Samsung S3C2410 1 10 regions Samsung S3C2410 OHCI 1 IO regions Samsung UART 1 IO regions Samsung UART 1 IO regions Samsung UART 1 IO regions bast idel 2 IO regions bast ide2 2 IO regions asix ax88796 1 IO regions dm9000 1 IO regions superio seriall 1 10 regions superio serial2 1 10 regions rombank0 1 IO regions bus CEE L re il 0 b 0 0 So C31 65 00250 000010 io meer se SNS DO OSA SO Gre DDD eee OO DADO ADD 63 DIO ODO LADOS C2 CO CO CO CO CO C2 CO CO CO CO CO SB WW WWW CO OO 9 9 3 69 63 3 5 69 I 2 9 9 2 3 65 ere MONEDA DN AO 69 DIU Ss e x Ge IG EN CO R Ge E Ge e Ga E e X Go GS OF SS Ore ee Ses Ce 69 69 91 6369 XXI ere cree SO 9 3 oooO Ok Xen 2 5 5 Lap tT M uer OX c Nus oer Boe Dx em tom TA ue CT so 69 amp 5 5 amp 3 9 465 sn CO CO CO CO CO CO CO CO WWW CO IS RI
25. bits no parity 1 stop bit and no flow control Figure 2 2 Hyperterm displaying ABLE output 20 Simtec Electronics Using minicom as a serial console Fim Ect War Cab Tranter Hala Diu alg scien rl 0ki_ml67x_ init scanning for OKT_HLOTH device oki ml amp x scan bDarz H fc7el amp deu fcidei ki ml lx installed routines EEPROM 2LCXX LOL betes single byte addrezzed invram on 2400 HVHDH crc does not match 74 vs ff ki ml amp x timer registering timers ki ml amp x timer add with ira 1 oki ml 7x timeb set tmr fl d98 scaler 1 neriaod xBfff selected all w for console write stream selected all rd for console read stream DRAH 32 Hb 30554432 betes Ricoh RAADIK 36 21 39 12he mode ABLE 2 87 laki eb amp Tdip oki mb 7 lvinceBgerald Wed Feb 23 15 48 22 GHT 28085 iromB on mort SYSTEM Warning cannot get unique default HAT DAS deb rl 60 62 85 6 EE Be int ple link dom failed to find cou device boot cid unzet defaulting to rowl roet deus mtdblocki ro console t tysi 1978 Butobost in 12 zecomdzs attempt 1 Press any key to abort gt Ionnected AL WIRE MEA Aci spat Wana el Sakae Once the connection is established the output from ABLE should be seen in the Hyperterm window 2 2 Using minicom as a serial console To access the serial console from LINUX the minicom program can be used Identify which serial port the EB675001DIP is connected to an
26. into Chapter 3 Command Line Interface Updated Part II Command Reference Updated Part III Non V olatile Variables Reference Created Appendix A Changelog Revision 2 21 23rd February 2006 VRS Minor editorial changes Revision 2 22 21st March 2006 VRS Updated to refer to ABLE version 2 21 Updated Chapter 6 Starting an Operating System Manually Updated Part III Non V olatile Variables Reference 255 Appendix A Changelog 256 Updated Part IL Command Reference Revision 2 23 30th April 2006 VRS Updated to refer to ABLE version 2 22 Updated Chapter 3 Command Line Interface Revision 2 24 3rd June 2006 VRS This version is the first edition of the printed book Updated to refer to ABLE version 2 24 Updated Chapter 6 Starting an Operating System Manually Updated Chapter 7 Starting an Operating System Automatically Simtec Electronics Index A ABLE executable 42 51 Advanced Technology Attachment see ATA Advanced Technology Attachment Packet Interface see ATAPD AOUT 42 ATA Advanced Technology Attachment 39 ATAPI Advanced Technology Attachment Packet Interface 39 batty 42 BIOS 17 C command autoboot 61 bast at 181 bast at2 183 bast hdlcd 185 boot 44 171 cat 42 147 cd 26 41 137 console 33 35 36 65 cp 149 date 67 devls 69 display 42 71 dmcfg rd 187 dmcfg wr 189 dump 191 dumpfile 42 151 echo 115 exit 117 file 26 41 41 1
27. line as if typed in Example 34 Using the history command gt history history meminfo tasks hwinfo a hwinfo O1 4 D ND ES 75 76 Simtec Electronics Name hwinfo Print hardware information Synopsis hwinfo a u help version Options a displays all the hardware info fields u displays the systems unique ID help display short helptext and exit version display commands version and exit Description Show hardware specific information typically the machines unique identification bytes Example 35 Using the hwinfo command gt hwinfo Unique ID 0x00 0x01 0x3d 0x00 0x01 0x6a gt 77 78 Simtec Electronics Name man Manual page display Synopsis man command Options command Name of command to display man page for Description This command displays the manual page for a specified command The manual pages are generated directly from the ABLE reference documentation and formatted for 80 column output The output is stored on an ABLE access ible filesystem and and displayed with the ABLE pager The pager output can be aborted with q Example 36 Using the man command This example shows the man command used to get the manual page of the file command ie IE ete OI File manipulation commands FILE 1 NAME file Tests each argument in an attempt to classify it SYNOPSIS fal i mime help version
28. real time clock setopt Sets device options settime Sets the real time clock sh Start a new ABLE shell showargs Shows arguments to be passed to any booted OS shadow Moves ABLE into RAM showhz Shows how long a system has been running sleep Delay for a specified amount of time sum Checksum a file sysmsg Show system messages sysspeed Sets the system clock speed tasks Displays tasks running on system test Performs test operations tick check system timing uname Print system identification version Display ABLE shell version Command Purpose vtp1 Video test pattern vtp2 Video test pattern vtp3 Video test pattern vtp4 Video test pattern vtp5 Video test pattern wrout Write a string to an output file Core Commands These are the core commands available from the shell command line of ABLE from version 2 20 and later 59 60 Simtec Electronics Name autoboot Attempt to locate and boot suitable images automatically Synopsis autoboot Description This command may be executed from the Command Line Interface however it is usually executed as part of the autoboot sequence as explained in Chapter 7 Starting an Operating System Automatically This command takes each filesystem in turn from the boot fs variable and searches it for bootable images As each possible image is located a suitable set of parameters are derived if possible and the image and the commands are
29. side 8 pixel vertical red bar Video test pattern filling the whole of the sc el green bar The rest of the screen is an Right hand side with 8 pix ilable if the frame buffer is disabled This command will not be ava Figure 9 Video test pattern 2 nn et ns he ta m Soe 207 208 Simtec Electronics Name vtp3 Video test pattern Synopsis vtp3 Description Video test pattern filling the whole of the screen with the pattern left and right hand sides have an 8 pixel vertical green bar The rest of the screen is an alternating 8x8 pixel blue and red checkerboard pattern This command will not be available if the frame buffer is disabled Figure 10 Video test pattern 3 209 210 Simtec Electronics Name vtp4 Video test pattern Synopsis vtp4 Description Video test pattern filling the whole of the screen with the following pattern Left and right hand side 8 pixel vertic al green bar The rest of the screen is diagonal lines going from black to white then back to black This command will not be available if the frame buffer is disabled Figure 11 Video test pattern 4 211 212 Simtec Electronics Name vtp5 Video test pattern Synopsis Description Video test pattern filling the whole of the screen with the following pattern Left hand side is a vertical blue bar 8 pixels wide with red single line at the top The right hand side is green The ri
30. unset gt date Saw wel Oil igs gt setdate 10 3 gt date lies Meka 110 Mec gt Srare 71960 264 00 04 2003 2006 00 33 2006 See also settime date 00013305 00 01 08 sites jolayy O0 2 Oils Sels 00 9 01 9 alo LPA 45e1 0007 PIO mode 4 link ok 100Mbit full duplex automatically shadowing 91 92 Simtec Electronics Name setopt Sets device options Synopsis setopt device options Options device device on which to set options options options to apply to device Description This command allows device options to be altered typically baud rates and data formats on character devices The device which options are applied to is typically a serial port The console command can be used to obtain a list of appropriate devices with the d option The options are in the form baud data format The baud rate is a simple numeric value e g 115200 or 19200 The data format is specified as three single charac ter values The first denotes the number of data bits typically eight or seven The second sets the parity type one of none n odd o or even e The third is the number of stop bits either one or two The initial port options are detailed in Section 5 2 Setting parameters on serial drivers Example 40 Using the setopt command to alter serial port options This example shows the setopt command altering the baud rate of the second s3c2410 seria
31. var arbar EST positional parameters here are 4 positional parameters All parameters gt one two three lt after Parameter 0 1 2 gt tftpboot test sh one two lt AO sies e des OA ON es A A UY Parameter 0 tftpboot test sh Parameter l one Parameter 2 two Parameter 3 three gt Simtec Electronics 29 30 Simtec Electronics Chapter 4 Setting Options ABLE has the ability to store settings in non volatile memory Currently all supported boards have this feature The commands for manipulating the non volatile memory are nyshow nvset nysave nvclear These commands are used to manipulate a set of variables which remain after reset or power cycle and are hence referred to as non volatile The variables are numbers strings or boolean values The nvshow command can be used without arguments in order to list the current values of all variables Example 4 1 Using the nvshow command to list the default variables gt nvshow shell hist is unset HOO Es LS aser DOOL AULO QUIE boot cmd is unset boot timeout is unset ide multi limit is unset usb hubdepth is unset usb enable is unset console level 9 console write is unset console read is unset fb enable is unset fb output is unset fb refresh is unset fb y is unset fb x is unset sys autoshadow is unset sys speed is unset gt The variables their meanings and default values are shown in Part III Non Vola
32. well known values at fixed offsets in the file and common executable binary format headers The overall ap proach is similar to the UNIX file command which is provided with the ABLE shell built in file command Once a files contents are identified ABLE will use the appropriate module to load and execute the file If a unre Simtec Electronics 41 Chapter 6 6 6 1 6 6 2 6 6 3 6 6 4 6 6 5 6 6 6 6 6 7 6 6 8 42 Starting an Operating System Manually cognised filetype or one for which no loader module is present ABLE will report the error and return to the com mand line ABLE shell script This file type is identified by the string sh in the first four bytes of the file Such files are executed with the ABLE shell as detailed in Section 3 8 Shell script ABLE executable This file type is identified by the hexadecimal value AB1E0001 at the beginning of the executable file This file type is used for ABLE binary program extensions for code which it is not desirable to ship within ABLE because of space or licencing constraints Examples of such programs are the romwrite reflash tool and batty test tool ARM LINUX zlmage This file type is identified by the hexadecimal value 016F2818 thirty six bytes into the file This file type is used for compressed LINUXO kernel images When a file of this type is executed ABLE sets up an appropriate parameter list and starts execution of the kernel ima
33. 0 66 99 A user wishing to use the this method in the boot cmd setting should make use of the mands To set the command from the above example would be to separate the com nvset boot cmd setargs root dev hdal console ttySACO 115200 load hd0 vmlinuz boot The command line method The command line method is a less flexible but much simpler and obvious method of starting an OS kernel or image The image to be executed is simply given on the command line followed by its parameters exactly like run ning any other command Note Any parameters set with the setargs command are not considered when using this method Example 6 7 Using the command line method to start a LINUX kernel gt hd0 vmlinuz root dev hdal console ttySAC0 115200 loaded hd0 vmlinuz 0x16a6e0 bytes at 0x00008000 boots boorineo Iliav Booting Linux Uncompressdrcm dl oro veni toas Le M ne ee le nl eee e Linux version 2 6 11 vince gerald CPU ARM920Tid wb 41129200 revision O ARMvAT CPUO D VIVT write back cache CPUO I cache 16384 bytes associativity 64 32 byte lines 8 sets CPUO D cache 16384 bytes associativity 64 32 byte lines 8 sets Machine Simtec BAST Memory policy ECC disabled Data cache writeback CPU S3C2410A id 0x32410002 S3C2410 core 266 000 MHz memory 133 000 MHz peripheral 66 500 MHz S30241 Clocks C 2004 Simes lescaciomies USB Porerzr Ceuerol e 2004 Simese IElecuioenacs
34. 42 6 6 3 ARM LINUXQ zImage siemens intensit mette ERR SEE perpe eR legs 42 6 6 4 ELF and AO T files 15e eternity EI y rene Ee desks one 42 6 6 5 UNIXO Compress files er cere e e Dr e eoe rte denen 42 6 6 6 Gzip TES sho ie ete ixi tn ete e O o lade Sent ied 42 6 6 7 Images text and data files o i ann iE a EE em e 42 6 6 8 Motorola S Recotd 5n fter vane enue tee eto tosh oe tees eo reel eds 42 6 7 Starting an Operating System sss e enhem menthe 44 6 7 1 The setargs load and boot method coooccnocnnccnnccnoconocnnccnnconnccnnccnnconnccnnoos 44 6 7 2 The command line method sssssssse e 45 7 Starting an Operating System Automatically ssssssee ee 47 8 Networking ME 49 8 1 Finding a network interface os scsi eite ON 49 8 2 Configuring a network interface ss 49 8 3 Using the network to obtain files sss meme Hen 49 9 Upgradin M EH E 51 9 1 Obtamime Uperades bits id e be ee etal ea ee 51 9 2 Loading the Burn ss m 51 9 3 R nning the upgrade eI E eie ve p RE Mug 52 IT Command Reference ma iia do keiten etd 55 Core Commands A e nn iia 59 ABLE User Guide AMOO di a Rer eR rv RP OE one 61 CONSOLE aid 65 A 67 dl at s 69 display ea NA da acta 71 Delta teet ee esci eo etie tapete e ouai tec at dete traider 73 histoOky iege RN RE e eirca eque ev EE epa 75 A OO 77 MAM 5 less EPI 79 TD TDITILO Nara rr das tn ns ie nt ann
35. 53 help 27 73 history 75 hwinfo 50 77 ifconfig 49 131 load 44 173 Is 26 41 139 Isfs 26 141 man 79 meminfo 81 memset 193 mii 133 modules 83 nvclear 31 159 nvsave 25 31 161 nvset 24 31 163 nvshow 31 165 nvunset 167 peek 195 pic rd 197 pic wr 199 pmu 85 poke 201 pwd 26 143 read 119 reset 87 sbcd 89 setargs 44 177 setdate 91 setopt 34 93 settime 95 sh 121 shadow 97 showargs 175 showhz 99 sleep 123 sum 155 sysmsg 36 101 sysspeed 103 tasks 105 test 23 28 125 tick 203 uname 27 107 version 109 vtp1 205 vtp2 207 vtp3 209 vtp4 211 vtp5 213 wrout 111 command line interface 17 23 conditionals 23 editing 23 filesystem 26 help 27 quoting 24 variables 24 accessing 25 non volatile see non volatile variables positional 25 25 simple 24 special 25 special meaning 26 Compress file 42 console 19 D DHCP Dynamic Host Configuration Protocol 40 49 49 49 50 50 50 131 131 E ELF 42 EXT2 40 F FAT 40 FFS 40 G Gzip file 42 H Hyperterm 19 20 21 IDE see ATA Integrated Drive Electronics see ATA 257 Index Internet Protocol see IP IP Internet Protocol 49 131 132 ISO9660 40 40 L Linux 42 M Minicom 21 22 22 modular system 17 modules 17 19 N NetBSD 42 non volatile variables 24 boot 19 auto 217 cmd 37 37 38 219 fs 223 timeout 221 console le
36. 60 Using cat command to display files contents This example shows the display of two files one text and one binary gt cat hd0 etc passwd oo 580 90 sieoore 3 roo 2 Mola loyal daemon x 1 1 daemon usr sbin bin sh brng De 2 sigume arias losin Sia Ss ss Ss ewes claws Joa Sia Syme seas 65534 e 5ymes oras Ada sance gt This shows the display of part of a binary file and the undesirable effects gt cat hd0 bin ls fb p VaeM mLXkZ P ngqBo INO oo oos om ep esr Al RO RIAS SS WMO unb sesso sd 9 Co Al s ss DOMO stares loys AOS Seats wee Ge GIS GULL eran So co gll ETE TEST orsa A ee e ee e iR SESS er ar nye I WI 5 deny EZ EA UE E SOM OE WM e eA M Oe eA TOS 8 04 sec Gig Isl 510 c UNES ora etes aL alo AUTO e E OA giebt ooo n ol nio 5 5 oo Wired es sal L s 0 fU To Doo akg Sj c Hodo Mo ToDo of Ie ee eo ee O E TR E ee Pr ON A ts tite cie o o UV Me XX Een PE SN On Eo Li os AIR SN RE AR MCA MOMS aS MEK E oo M ive Ne cme able Ln eller ees he e REP OS SRE Bleu O ER QU DL E cen cult OET R Ma ee deg E lars ocv he mI UN Am LUN 5 lt aR Ea See also dumpfile 147 148 Simtec Electronics Name cp Copy a file Synopsis cp source destination Options source File to copy from destination File to copy to Description Copy source file to destination 149 150 Simtec Electronics Name dumpfile Displays a file in a hexadecimal dump
37. DOC RU OO DONNE aaa a dEIETEJEJDIC QUE 35 d 30 0 050509909058959565 COCONOAMOOS EdEAEYEdEdEdE JE aaa aa a Bo TY O19 05 0 0 Ea OOOO JE JEJE TEIEJEJEJEJE JE IEIEIETEIENEJE HEJEJEIEJEJEJEJE BG c OX OUO uo ue OS NODO 8 ETE TE TRAE RIE GIEAE NE IEEE ETE RETEIBAEIE IRAE JEJBTEJESEIEIESE m OY TRITT OT IND GOOD Otho OOOO NET Cie ARIEI ICIETEJE e TE MEJEICIEIEIEJEJE BS So UO oO D SO o 59 MORE gt See also peek poke memset 191 192 Simtec Electronics Name memset Set range of memory to a specific value Synopsis memset address length value Options address Start address of memory to set in hex length Length of area to set in hex value Value to set memory region to in hex defaults to 0 if unspecified Description This command alters an area of memory starting at address and spanning the specified Length to the specified value The address specified is dependant on the machine architecture and is the translated by the MMU See also peek poke dump 193 194 Simtec Electronics Name peek Examine memory location Synopsis peek p v b h w rpt count help version address Options wW rpt count address Description Interpret address as physical Interpret address as virtual the default if not specified Byte 8bit wide read Half word 16bit wide read Word 32bit wide read default if not specified Repeats the read count
38. E R EERE A e done sd te 25 3 2 Variables with special meanings ss 26 3 1 Available console drivers i rette Rr Pre ciat rere Oe bep Eee e Fa te ei eatis Fes asis ee OR 33 6 1 S Record loader error codes ses 43 5 Commands in alphabetical order ete i Dette Pe ERR EPI REP ER ERE DR POE ESSO UES 55 6 Defined console log levels eerie oerte tue ed tuere Pee PEE See nein 65 7 Escaped echo Characters ioo tet t E te REDE CERTE UE PEE PERI bee EO PERRA IER 115 8 Possible test expressions cese usce idea guce cou ipdendset Dyer seti ree e e rante pier reat deep eh ERES TNR TV 125 9 Alphabetical list of non volatile variables sssssss eme ee 215 Simtec Electronics List of Examples 2 1 Display after starting ABLE on EB2410ITX ue 19 3 1 Using the test command and conditional operators sss 23 3 2 Using curly braces to disambiguate variables ooooooccnnccnnconcconconoconononcnnncnnccnnconnccnnccnnconnconnoos 25 3 3 Accessing positional parameters sise 26 3 4 Navigating a filesystem 2 nente metre Pre Per rre EPEE IO ETE PRESISERER 26 3 5 Getting help on the uname command sss IH Hehe heehenthenree 27 3 6 Example shell seript rtt Ft IEEE Re paris rare sashes bes poble andes 28 4 1 Using the nvshow command to list the default variables ooooconocnnccnnccnnccnnncnnnonoronccnnccnnccnncnnno 31 4 2 sing th
39. Kbyte packets and checksum or CRC16 checks The filename used with the XModem source is the serial port source on which to perform the transfer these can be identified as aliases for char sources within a full source listing see Example 6 1 Using the Is command to list available sources The parameters for a serial driver source are more fully described in Section 5 2 Setting parameters on serial drivers If the transfer is performed on the same source as is being used for the console care must be taken not to use com mands which produce output during their reading of the file Because of this the sum command may be used in its non verbose mode but would cause the transfer to fail if the v option is used because it would output characters to denote progress Similarly the dumpfile and cat commands would cause a failure Obviously this is not an issue 1f the transfer source is not used as a source for the console Example 6 4 Using the XModem source This example shows a file being checksummed from the first S3C2410 serial port source The C characters are the XModem receive characters signifying the start of the XModem sequence The same file is then checksummed us ing the network interface to show the correctness of the transfer gt sum xmodem s3c2410 serial0 eee ee 39872 33 xmodem s3c2410 serial0 Sun tao oxi y SUSAN Soo Seu gt 6 5 Navigating a filesystem Sources with filesystems that support enumerati
40. O 1 0 1750 1 10998 7101 tus B2B DEVSEL MED Region 0 IO e8c0 size 0040 Region 1 IO e8a0 size 0020 NI 010055237 0420 0 T 1099352437 tus B2B DEVSEL MED Region 0 MEM 32bit at 0x07011000 on memory 00000000 80000000 Rev 0x41 Class size 0x00000400 Rev 0x01 Class size 0x01000000 Rev 0x01 Class size 0x00001000 ew eed Class Rev 0x00 Class Rev 0x03 Class size 0x00001000 000 03000002 intel21285 1 IO regions n0 42000000 size 00100000 mulitplier 0001 15152590 Do 129 0 12 30 18 Simtec Electronics Name display Display and image on console Synopsis console d device device x x y y w width width h height height delay time help version file Options d device CUM ray w width h height delay help version Description console device on which to plot image X co ordinate to place image on screen y co ordinate to place image on screen width of image on screen height of image on screen time to delay between displaying each image display short helptext and exit display commands version and exit This command displays an image on screen if it is one of the recognised formats The currently supported image formats are BMP and PGM Example 32 Using the display command This shows using the console command on the EB2410ITX
41. O Se el This shows the devls command used in verbose mode on a PCI system gt devls v MUSSO OOOO OOOO 010013ea 01010000 0x0072 ds1687 03000000 03000000 T 0x03 8 16550 03000000 03000000 0x02f 8 16550 03000000 03000004 0x0060 intel8042 lus joel om az 1285 OLOOLOS O1OOIS33 7 0 1059 1535 Rey OxeS Class 6 1 0 CmdStatus 3200000f CMD IO MEM MASTER SPECIAL Status DEVSEL MED MT ABRT M ABRT 69 devis 70 01001 CmdSt Sta 01001 CmdSt Sta 01001 masia Sta 01001 CmdStatus 02800005 CMD IO MASTER Sta gt gt 01001 CmdStatus 02800001 CIMIDI D Ste 01001 CmdStatus 02800006 CMD MEM MASTER Ste loss cju 03000 Regio OLL OLIOLI 0 930 y LOLLSONLS atus 02800007 CMD IO MEM MASTER tus B2B DEVSEL MED Region 0 IO f880 size 0080 Region 1 MEM 32bit at 0x05000000 0ea 01005000 0 10 0 10ea 5000 atus 02000007 CMD IO MEM MASTER tus DEVSEL MED Region 0 MEM 32bit at 0x06000000 Osa OLOOSOSC T O20 i Mees 5050 erus OO OOO Owe CMD IO MEM MASTER tus DEVSEL MED Region 0 MEM 32bit at 0x07010000 Region 1 IO 000 size 0100 YO 010052291 0 16450 10019985229 tus B2B DEVSEL MED Region 4 IO ecf0 size 0010 03000000 03000001 03000000 03000001 OSD OLOOT
42. SIMTEC ELECTRONICS ABLE User Guide Simtec Electronics ABLE User Guide Simtec Electronics by V R Sanders and B J Dooks Published 2006 Copyright O 2003 2004 2005 2006 Simtec Electronics e LINUXO is a registered trademark of Linus Torvalds UNIX is a registered trademark of The Open Group PCG isa registered trademark of Philips Semiconductors Corporation All other trademarks are acknowledged While every precaution has been taken in the preparation of this book the publisher assumes no responsibility for errors or omissions or for damages resulting from the use of the information contained herein Table of Contents A NN xiii O 15 IUD PEOR 17 2 Getting Started ON 19 2 1 Using hyperterm as a serial console sse 19 2 2 Using minicom as a serial console sssssssssse emen 21 3 Command Line Interface ruere tee ette re te iia 23 3 1 Command IS CIO ios 23 3 2 Simple commands cuota Cere ee ie opt eater eie up Sire ode se ride 23 3 3 Conditional XecUtlOn vicodin nU Eee epe eee SL Ces teo Orbe teen ed 23 3 4 QuoUng RN 24 3 5 Shell variables tia NE eed rete iio 24 EN Simple variables i aerei Pret r nie vs ieee entendre Peintre pee here 24 3 5 2 Non volatile variables ssssssssssesse emm em em ee 24 3 5 3 Positional Variables reris srt teet PRI ib ee seed 25 3 54 Special variables 2 20 5 ee ere noti reed dear ee Ere ERAT vs 25 3 5 5 ACCE
43. SSING variables iter pt re Er OR URP PR RR ie dt en nen 25 3 5 6 Variables with special meanings sese HH 26 3 6 Files ySter Navigation ssh ss eee d ERN v qe 26 37 ABLE Help System ecco entro ote postre te or eoo c ebur bote oed oes Stan en OPERE 27 3 8 Shell Script t or Fe e SM RS 28 4 Settmg Options 5 eet e beet ed etuer lee EET Set ie eR ET ex tus 31 DABLE Consoli IIA SUE RN i ee ede ee a 33 Dil Console EM T 33 5 2 Setting parameters on serial drivers eee 34 5 3 Configuring the console system se 34 54 Setting the logging level eei eee e epe tyre ne dee nE 36 5 5 Practical use of the console system sss eee mene 36 5 5 1 Basic serial debug console sssssss ee 36 5 522 No console atall criara trt E GR EO Det E Kee sett uds 37 5 5 3 Displaying a logo and boot abort sss 37 6 Starting an Operating System Manually sse emen ene 39 6 1 Data SQUICOS Tr 39 6 2 Alias SoUrCes Lotina 39 6 3 NetWork SOULCES E 40 6 4 XMod m So rce o eet dad 41 6 5 Navigating filesystem x eter aes Osona ie E E DRUSI DR Fete si doi 41 6 6 How ABLE identifies files sesssssss Henne 41 6 6 1 ABLE shell Script ss rer re tre Per rere D retenue pin ree ED 42 6 6 2 ABLE executable ette cte ver IE geb E Roper er eee OE Se Rer tnt
44. Setup of basic serial console gt nvshow console write console write is unset gt nvshow console read console read is unset gt nvset console write u16550 serial0 9600 8n1 Simtec Electronics 9 9 2 9 9 3 No console at all gt nvshow console write console write u16550 serial0 9600 8n1 gt nvset console read ul6550_serial0 9600 8n1 gt nvshow console read console read ul6550_serial0 9600 8n1 gt nvsave verifying written data gt No console at all In this scenario no console output whatsoever is required Generally this is only useful when a project has reached final production and a fixed OS image is being retrieved from reliable storage This is straightforward to achieve by using the null driver Set the console read and console write variables to null Be sure to set the boot cmd and other boot variables to correctly boot your OS before setting this or you will need to recover the system with the physical non volatile ignore jumper As a precaution against loosing the console completely you can add a console a serial to the end of the boot cmd variable Example 5 6 Using the null drivers safely This example shows how the addition of the console command can recover from a situation where otherwise the physical jumper would have to be accessed gt nvset boot cmd hd0 nosuchkernel console a serial gt nvset boot auto on nvset console write null gt nvset cons
45. Simtec Electronics support directly ABLE is typically provided in any board directly manufactured by Simtec Electronics Customer applications which are not manufactured by Simtec Electronics may still use ABLE once a suitable binary distribution licence is obtained 17 18 Simtec Electronics Chapter 2 Getting Started When a platform is initially powered or a hard reset performed the ABLE environment will be started each com ponent module will be loaded in turn The last module loaded is the ABLE shell which will present the user with a command line interface ABLE has a flexible console system for its input and output which can be configured to meet most requirements The console system is controlled with console command and the console read and console write para meters Details on using the console system can be found in Chapter 5 ABLE Console The default console operation is to use all suitable input and output devices available On the EB2410ITX both the first serial port and the video display will be used for output and the serial port and USB keyboard for input In general use the console is used to interact with the ABLE Command Line Interface This command line inter face is generally assumed for most interactions with ABLE Example 2 1 Display after starting ABLE on EB2410ITX This example shows the typical default output shown when ABLE is started selected all wr for console write selected all rd for co
46. am 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 Whether 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 Name boot auto Enable auto boot Description Tf this variable is unset the default action is the same as if it were set to true The complete autoboot process is dis cussed in Chapter 7 Starting an Operating System Automatically 217 218 Simtec Electronics Name boot cmd Command line to use for auto boot Description This variable is used as a command line to be automatically executed when the boot auto variable is set to true and the boot timeout is set to non zero If unset defaults to autoboot The complete autoboot process is discussed in Chapter 7 Starting an Operating System Automatically 219 220 Simtec Electronics Name boot timeout Time to wait before auto boot Description This variable is used to configure the number of seconds to wait for the user to abort the auto boot sequence when
47. arning Image release 2003062801 is lower than running release 2003071701 warning machine 3 is not supported by image Warnings detected proceed with upgrade yes to continue no Upgraded cancelled by user input gt The romwrite command may fail at the Erasing Device stage if the system supports physical non volatile stor age protection This feature is currently present on all Simtec Electronics boards except the EB110ATX A successful flash operation will result in a message asking the user to reset the platform Until the system is reset the old version of ABLE is still running Example 9 3 The romwrite command completing successfully Simtec Electronics Running the upgrade gt shadow shadowing ABLE into main memory gt tftpboot able bast O NO Tie GIA OR DCS boot booting able appl ROM Write Version 1 00 e 2002 Z00S Siwmeec El crronies Replacing current version 174 with image version 220 Image release number is 2003091701 Machine is BAST Plesni SST Sens JO 052 792 Initialising programmer Erasing device done N E EAN MARNE Gouna ata done Vverityingo da A ot tool dead col done Finishing operation done Done Please Reset machine gt Simtec Electronics 53 54 Simtec Electronics Part Il Command Reference The sections in Part II split the commands available into groupings by type Each command is documented in the standard UNIX
48. arta pasate aa denia 81 MOULES tidad 83 pup 85 IeSelc sd vel A TROPAS P EE P PEE de ete Ve SUME eee ge Tee qe PORE Sn eS be 87 TT 89 SEU AG mo 91 SEO ia nm en 93 SEM e A eS e ed O ant 95 SALON E 97 SHO WIZ tt en Vitec tii 99 SYSS nee einen es esL deste otl nana Tim Tere Eos e E Ne Te mde SO ve ane 101 OQ quM 103 Ir ERE 105 Durum 107 Mone PEE 109 WIQU citet ehe e Pe a ia eb EH P 111 IL Shell Comin ands oret trei e rer er ntm tete emilie onu 113 echo aei TUR eet er ra AI RE RYE Ve PUE ae rie NAUES UE AN 115 eKits en dd coire etat Sd e E Ed Nes 117 NS 119 dm ideados 121 sleep cuisine Ee eM Tu 123 OS eec lee nn ore tieu eie ved hae ds eee eui etos tnm Moan eden a Leb db exe EI E rienda 125 M Network Operations sine E I PRU Rei ee Ie S e ERE eder EET dee 129 Y CODTIS 51e inner pet oper ome rr tpe deer ttr ee eee 131 nne 133 IV File Navigation scsi t Peer testes EE PERI ERR E ERROR UE e POE Ere PORE Per PSOE ERRARE ste i 135 Gd Ss E lbestn ence iieri e 137 RE D 139 ASA A i 141 PU A Wee IA E 143 V File manipulation commands ss 145 Cy DE UM E Ed e TEE ree aye DERE NEyT ni E Eee as 147 LL 149 COLA pile ida Deed 151 OR ote age eset nae EE Er HERR E veo ERE RAP RN CURE tee Erin T PER P Pete Ee rae 153 S D a a EAEE Ee 155 VI Non volatile settings 3 ue rot re D a AE Fe POS Tea de 157 drin tite este 159 vC
49. as more details on how to locate files Upgrades because of their transient nature are typically retrieved from the network using TFTP Chapter 8 Networking details configuring and using network interfaces ABLE may need to be moved to execute from memory on some platforms such as the EB7500ATX This is achieved with the shadow command If the shadow operation is not performed then romwrite will prompt the user to issue the shadow command Example 9 1 The romwrite command requiring the shadow command tftpboot eb2410itx romwrite v174 bin ee AA ew etr eu DECO eS boot booting able appl ROM Write Version 1 00 c 2002 2003 Simtec Electronics cannot run without ABLE shadowed use the shadow command and then re run this application gt 9 3 Running the upgrade 52 The romwrite command also performs several checks to ensure the update is suitable These include downgrading and checking the machine type matches the image Warning Overriding any warnings may result in an inoperable system so be sure you understand any warnings be fore continuing with the upgrade Example 9 2 The romwrite command producing warnings tftpboot ebll0atx romwrite v173 bin Aic AA AA OE HEAR DEOS boot booting able appl ROM Write Version 1 00 e 2002 2005 Simce El crronies Replacing current version 174 with image version 173 warning Image version 173 is lower than running version 174 Image release number is 2003062801 w
50. cessing positional parameters This example shows accessing the first positional parameter then the first positional parameter when the tenth was meant and finally accessing the tenth parameter correctly gt echo 1 one gt echo 10 one0 gt echo 10 ten gt Variables with special meanings There are a small number of shell variables which have special meaning to the shell environment itself These vari ables generally affect some aspect of the shell environment Several of these variables have defaults which are as signed by the shell upon initialisation Table 3 2 Variables with special meanings Variable Meaning PSI This variable contains the text of the prompt to use which allows users to alter their prompt or scripts to use the same prompt as the shell This value is set to gt by default PS4 This variable is the forth level prompt it is used when the x switch is in operation to preface output lines This value is set to by default PWD This variable is the present working directory within the filesystem Consult Section 3 6 Filesystem navigation for more details This value is set to by default OLDPWD The previous working directory Consult Section 3 6 Filesystem navigation for more details IFS The Internal Field Separator that is used for word splitting after expansion and to split lines into words with the read command This value is set to space tab newline by de faul
51. cfg wr Debug command to write Davicom EEPROM dump Displays an area of memory in hex dump dumpfile Displays a file in hex dump Command Purpose echo Output some text to standard output exit Exit ABLE shell file Tests each argument in an attempt to classify it help Display help on built in commands history Lists the commands in the command line history hwinfo Print hardware information ifconfig Network device configuration and selection load Load executable images Is List files in directory Isfs List available filesystems man Manual page display mii MII phy control meminfo Shows memory information memset Set range of memory to a specific value modules List ABLE modules nvclear Reset non volatile settings to defaults nvset Set non volatile parameters nvsave Save altered non volatile settings nvshow Show non volatile parameters nvunset Clears non volatile parameter peek Examine a memory location pic rd Read a value to the PMU PIC pic wr Write a value to the PMU PIC pmu Power management control poke Poke memory location pwd Show present working directory read Reads a line of input into shell variables reset Reset machine sbcd 1 Manipulates the board configuration data setargs Sets arguments to be passed to an OS started with the boot command setdate Sets the date in the
52. cnncnnncnnnrnnncnnccnnccnnccnnccnncnnncnnncnnncnnnes 147 61 Using the dumpfile command ss 151 xi ABLE User Guide 62 Using the file command to determine filetypes ooocccooccnnnoccnnncnnnnconnnocnnncononnconnnncnonccnnnnccnnnccnns 153 63 Checksumming a file with the sum command sssssssse e eme Heer 155 64 Using the nvset command and shell method to alter a non volatile variables 163 65 Using the nivshow Command ersed a R eee tee prever ennemi ques trios dende 165 66 Using the boot command ne us Secu EEE nn dite ten rete das 171 67 Using the showargs command ss 175 68 Using the setargs command miii ee eene ee Ie seine nee es 177 69 Using the dump command to examine memory cocoooconncnniocnnccnnncnnonnnrnnncnnccnnconnccnnccnncnnncnnncnnncnnnes 191 xii Simtec Electronics Preface About this document This document describes the Simtec Electronics Advanced Boot Load Environment ABLE which provides a flexible environment for both experimentation and integrator solutions Intended Audience This document is aimed at anyone using the ABLE bootloader The first part is more useful to the beginner but the reference parts allow the book to remain useful to the more experienced user Chapter Summary Chapter 1 Overview Chapter 2 Getting Started Chapter 3 Command Line Inter face Chapter 4 Setting Options Chapter 5 ABLE Console Chapter 6 Starting an Operating
53. conds to delay Description This command is used to pause execution for a given length of time The time given must be a simple integer num ber of seconds Example 51 Using the sleep command to delay execution gt date sleep 15 date sleep 9 date sleep 292 date igs dea OF 04125831 2003 ics Jaa OS 4226806 2008 Piet dem OF 0413250215 2003 ist dema OF Os 31207 2003 gt 123 124 Simtec Electronics Name test Performs test operations Synopsis test help version expression Options help Display this help and exit version Output version information and exit expression Expression to evaluate Description Exit with the status determined by the expression shown in Table 8 Possible test expressions An omitted expression defaults to false Otherwise the expression is evaluated to a true or false result and sets exit status accordingly An alias is provided so this command can be called as this gives a more familiar way to use this command For the tests which check for a file having UNIX read or write permissions ABLE assumes the root UID 0 and GID 0 superuser is being used Table 8 Possible test expressions Test Result is true if expression expression is true l expression expression is false expressionl a expression2 both expression1 and expression are true expressioni o expression2 either expressionl or expression is tr
54. cter device char0 char0 character device 24cxx0p1 dev e03c2f14 start 0x00000008 size 0x000001f8 blksz 0x0001 24cxx0 dev e03c2f14 start 0x00000000 size 0x00000400 blksz 0x0001 nand0p2 dev e03c44b4 start 0x00000020 size 0x00001fe0 blksz 0x0200 gt nand0p1 dev e03c44b4 start 0x00000000 size 0x00000020 blksz 0x0200 nand0 dev e03c44b4 start 0x00000000 size 0x04000000 blksz 0x0200 s3c2410x s3c2410x character device 142 Simtec Electronics Name pwd Show present working directory Synopsis Description This command can be used to show the present working directory This information is also available in the PWD shell variable Example 59 Using the pwd command and PWD variable to show the present working directory gt cd hd0 boot gt pwd hd0 boot gt echo PWD hd0 boot ACI a venue gt pwd hd0 var gt 143 144 Simtec Electronics File manipulation commands These are the commands to manipulate files and are available from the shell command line of ABLE from version 2 20 and later 145 146 Simtec Electronics Name cat Displays contents of a text file Synopsis cat filename Options filename File to display Description Use to display the contents of a file The file will be displayed in ASCII text non printable characters and escape sequences may cause various effects This is usually only an issue if binary files are displayed Example
55. currently active shows all available display drivers which can be used with the a switch sets the logging level to new value if given and displays the current logging level lists the currently active consoles displays the short help text and exits This command is used to manipulate the ABLE console system At boot the active console is determined by the console read and console write values The console command allows the current active console sources to be altered while the system is running The console command allows the level of messages displayed logged on the console to be altered Any messages with a level lower than the current log level will be output to the console For example if the log ging level is set to 6 all messages except those of level Log and Debug will be shown The initial log level is controlled by console level and defaults to 6 if the variable is unset Table 6 Defined console log levels Level Value Description Critical 0 Critical errors that will prevent prop er continued operation of ABLE Error 1 Error messages Warn 3 Warning messages Info 5 Messages which give more informa tion about an operation Log 7 Messages which are the result of nor mal operation Debug 9 Debugging messages these will rarely be seen on non debugging re leases of ABLE Example 29 Using the console command This example shows the use of the console command and its switc
56. d ensure a note is made of the correct device node e g something like dev ttySO or dev ttyUSBO Figure 2 3 Minicom settings window Welcome to minicom 2 1 r Comm Parameters 4 OPTIONS History Buf Compiled on Mar 29 2 Press CTRL A Z for h Current 115200 8N1 Speed Parity A 300 L None B 1200 M Even C 2400 N Odd D 4800 0 Mark E 9600 P Space F 19200 G 38400 H 57600 I 115200 Q 8 N 1 J 230400 R 7 E 1 Choice or Enter to exit Data c uU 0 41 0 Ui Stopbits W 1 Ai 2 CTRL A Z for help 115200 8N1 Minicom 2 1 Simtec Electronics Offline 21 Chapter 2 Getting Started Start minicom and ensure the correct settings are selected Default is Ctrl A p These settings are 115200 baud 8 data bits no parity and 1 stop bit Obviously minicom should be using the correct serial port as noted earlier 22 Simtec Electronics Chapter 3 Command Line Interface The ABLE command line interface CLI provides the primary method for interacting with ABLE The command line is sometimes referred to by the UNIX naming as a shell The ABLE shell is a very basic UNIX bourne shell and should be familiar to anyone experienced with that environment The CLI is a flexible environment and commands can be placed in a script file for automation purposes All the current commands are documented in Part II Command Reference 3 1 Command line editing Th
57. d pipe r file file exists and read permission is granted s file file exists and has a size greater than zero S file file exists and is a socket t fd file descriptor fd is opened on a terminal u file file exists and its set user ID bit is set w file file exists and write permission is granted x file file exists and execute or search permission is granted Except for h and L all file related tests dereference symbolic links Beware that parentheses need to be escaped e g by back slashes for shells Example 52 Performing assorted tests This example shows the use of the test command with various expressions Each test uses amp amp echo true to make it clear when the expression returns a true zero exit status Scose 1 ge ss eco cise 1 eq 2 amp amp echo true 1 eq 1 amp amp echo true al o Oo 000000000 gr pu ct 1 ge 0 amp amp echo true Excel oo ili gt test 1 ge 0 amp amp echo true ate 2echo 2 0 gt test 1 ge 0 amp amp echo true gt test 0 ge 1 amp amp echo true true gt test f hd0 etc services amp amp echo true true test lab cre sermices 1 0e 0 Es Echo true true cese ic MeO ere services a 1 0e 2 E cho rue ese RM ec services 1 oe 2 E Seas us true gt test n foo amp amp echo true true gt test n amp amp echo true gt test z foo amp amp ech
58. e default prompt is gt this can be altered by setting the value of the PS1 shell variable Commands can be entered at the prompt and executed by pressing return If an error is made while typing a command the left and right arrow keys can be used to position the cursor and in sert or delete characters Once a command has been executed it may be recalled by using the up arrow indeed several commands are stored in the command history to a depth determined by the shell hist parameter By using the up and down arrow keys the desired line in the history may be selected The command may then optionally be edited and then executed by pressing return Depending on the terminal in use some standard control characters can be used for example Control U to clear a line 3 2 Simple commands The shell processes commands as a series of tokens separated by unquoted space tab Il amp amp and characters The first token specifies the command to be executed and is passed as the first argument all the remaining tokens are passed as parameters to the command Each command exits with a status this status is represented by a number between 0 and 255 A command which exits with a status of O has succeeded any other value is taken to indicate a failure The shell itself will return the status of the last command it executed or the value specified if using the exit com mand 3 3 Conditional execution Multiple commands can be placed on a sing
59. e nvset command iii eb di EE os tes ES 31 5 1 Using the console command to show available drivers ooooncnoccnncnnccnnccnnccnnconnconnccnnconnconaconncos 33 5 2 Setting serial console driver parameters ss 34 5 3 Showing the consoles of an unconfigured system sss e 35 5 4 Adding console drivers to a running system emen mhent herren 35 5 5 Setup of basic serial console 1 rete teen ttd ee en Ms the ad at ne tnt due Sese TUE 36 5 6 Using the null drivers safely ss 37 5 7 A method to display logo and boot abort ue 38 6 1 Using the Is command to list available sources sss e 39 6 2 Using the Is command to list cooked sources se 40 6 3 Using the titphoot source eee ttes ondaa euo EE RUE ai es 40 6 4 Using the XMod m source intr repase reape EEE E OE ERI rep Ex rotar eses nn 41 6 5 An example S Record noria monts eret eine Heenan Ho E AER irte beis 44 6 6 Using the setargs load and boot method to start a LINUX kernel 44 6 7 Using the command line method to start a LINUX kernel see 45 7 1 Displaying a logo during the automatic boot process ccooccccnocccononocononocononocononorononoronanoronacoronocos 47 8 1 Executing a program using the tftpboot pseudo filesystem ocooocnnccnnnnnncnnocnnccnnconnconnccnnconnconncos 50 9 1 The romwrite command requiring the shadow command
60. e syspeed command on a EB2AIOITX 0 eee cc eece ence eeceeecaeeeaeeeaeeea sean ecu eees 103 45 Using the tasks commiand ss ss cease creto rebote eroe te E ycemedslee ded shops annee niet ste 105 46 Using the uname command on the EB2410ITX 0 eee ee cence neces Heer 107 47 Using the version command ss 2420505 olere vetet le Ge omi eet iecit la dinos 109 48 Using the echo command 3 ree dE ec e OE MF Ue ees 115 49 Using the read command isise dore odo He tree rete Coto ep vesci o ettet Ser eon 119 30 Subshell variable scope i eee ete eter cheatin cdots ree nul seine eee Mets eaten 121 51 Using the sleep command to delay execution ssssssssesse e emen eee 123 52 Performing assorted tests ecce ee eere ese rt td ree egere vue eh i SER Der Ae 126 53 Using the ifconfig command to select default interface esse 131 54 Using the ifconfig command to configure a fixed address ooococoocconnccnnnnccnnccnnnnconnnncnonccnnnnccnnacnnns 132 55 Using the mii command to show all the registers in a phy eeeeeeeeeceeeeeceeececeeeeeeeeeeeeeceaneeeees 133 56 Using the cd and Is commands to navigate a filesystem sese 137 57 Usmsg theIs commiand 0 en es te Ert a E ME rette a e Ute en 139 TRINEO 141 59 Using the pwd command and PWD variable to show the present working directory 143 60 Using cat command to display files contents ocooocnnocnnccnnc
61. e time command to the shell The modules are loaded according to their priority the lowest most important priority first rising to the highest lowest importance This priority system ensures a fixed load order so facilities and drivers are available in the ap propriate sequence Example 38 Using the modules command gt modules current modules md_time priority 0x md_devls priority 0 md_setdate priority x88796 priority 0x5 m9000 priority 0x50 imtec_ide priority bd2016a_ide priorit nubis_bus priority ast_bus priority 0x siris_bus priority QU o toy 9 for d Ox 99 OY Ol vr1000 bus priority samsung s3c2410x pri dev 24cxx priority 0 nvram init priority s3c2410x timer prior hztimer priority 0xa cmd sysspeed priorit romfs priority 0xa70 serial qe selon serial_s3c2410 prior serial_console prior allrd_console priori allwr_console priori null_console priorit alga congos Torr usbkbd priority 0xa8 ps2kbd_serpic priori s3cvid_console prior sm50lvid console pri console priority 0xa draminit priority 0x drv pmu bast priorit usb core priority 0x usb ohci priority 0x announce priority 0x confs priority 0xaa iso9660fs priority ffs priority 0xaa00 ext2fs priority 0xaa jffs2 priority 0xaa0 LILODOOC Droite 0x char code priority 0 ide priority 0xb0000 Tee Nilo mdk2440 bus priority 100 x100 0x100 000 00 a
62. ectly executed from flash Platforms EB2410ITX EB7500ATX EB675001DIP 245 246 Simtec Electronics Name sys speed System speed set at start time Description Tf set the value is passed to the command sysspeed at system startup If unset the value is dependant on the type of board See the sysspeed command for more details Platforms EB2410ITX numerous settings possible the default is 203MHz for the S3C2410 A20 and 266MHz for the S3C2410 A26 IM2440D20 numerous settings possible the default is 400MHz for the S3C2440 A40 247 248 Simtec Electronics Name usb enable USB system enable Description This determines if the USB subsystem is enabled This allows USB devices to be used required for the USB hid keyboard driver Platforms EB2410ITX default is on IM2440D20 default is on 249 250 Simtec Electronics Name usb hubdepth USB system depth hubs should be searched for devices to Description This determines how many hubs the USB system will scan looking for usable peripherals Platforms EB2410ITX IM2440D20 251 252 Simtec Electronics Part IV Appendices Appendix A Changelog Revision History Revision 1 00 24th January 2003 VRS Initial Release Revision 1 40 3rd February 2003 VRS Updates to non volatile commands addition of version command Revision 1 55 25th April VRS Improved command references in Core Commands Added Chapter 4 Settin
63. emset meminfo peek poke modules ILS Less Ine de echo dumpfile dump cat cp cd pwd boot load loa SHEE vtp5 vtp4 vtp3 vtp2 eq sysspeed settime setdate devls date Us help lt command gt to get brief explanation lt command gt help for command usage if available gt lacio las lo Helio o Imelps Lists available commands Optional arg gives help on specific command Please report bugs to lt support simtec co uk gt gt help sh elo em sims Usage sh OPTION FIL Siege e Shell GI al start an interactive shell els display this help and exit version output version information and exit Please report bugs to lt support simtec co uk gt Sala mel Usage sh OPTION FILE Seca aS NeR Exi start an interactive shell nc display this help and exit version output version information and exit Please report bugs to lt support simtec co uk gt 73 help The Example 3 5 Getting help on the uname command is another example of using the help command 74 Simtec Electronics Name history Lists the commands in the command line history Synopsis history Description Lists the commands in the command line history Each command is numbered in the list The number of com mands kept in the history is set with the shell hist non volatile variable Commands are accessed in the history by using the up and down arrows The command may be edited in place and then executed as with any other command
64. er 5 ABLE Console ABLE generally has to communicate with the end user it does this by using any of the connected devices for which it has drivers 5 1 Console drivers Console drivers are categorised as either input and output sources The sources for the console can be found using the console command Example 5 1 Using the console command to show available drivers This shows the available drivers and if they can be used for read write or both gt console d w a s3c2410x video CG usbkbd Gite mule Ga null a all wr GC all il gt oizol Ca serial Care ES Ger rw aei gt s3c2410 serial0 s3c2410_seriall Estee 2 Os EE u16550_serial0 u16550 serial These drivers allow access to the peripherals on a system They can be used to provide input from a user to ABLE and output from ABLE to the user Any number of them may be used simultaneously it is possible though not practical to have ABLE appear on every serial port and video console attached to a system Table 5 1 Available console drivers Driver Description s3c2410x video Video display driver for the s3c2410 internal controller sm501 video Video display driver for the Silicon motion 501 controller usbkbd Reads input from any HID USB keyboard attached to the system ps2kbd Reads input from any PS2 keyboard attached to the system null The null driver is a special driver which swallows a
65. er switch is used The return code is zero unless end of file is encountered read times out or an invalid file is supplied as the argu ment to u Example 49 Using the read command This example shows the use to the read command in several ways Firstly reading simple text without a prompt and then with a long prompt gt read some tex gt echo SR some tex Fuego o IE IL YC RMI ES EU Va long pronor a long prompt some text with a long prompt gt echo SRI some tex gt BP Irt t with a long prompt 119 read This shows reading values into a specified variable and how the REPLY variable is unaffected SINE Sine TES gt read p VARIABLE Ssome text with a prompt in VARIABLE echo SVARIABLE some text with a prompt in VARIABL gt echo SREPLY mo ieply gt GI This shows the use of the silent switch to suppress echoing of output gt read s VARIABL ES gt echo VARIABLE some text in VARIABLE with silent enabled gt This shows the use of the delimiter and timeout options to read a preset number of characters and perform a read within a set amount of time gt read n 5 VARIABLE 12345 gt echo VARIABLE 12345 gt read d 9 VARIABLE this text continues until a 9 gt echo SVARIABL cnie tae continues Wiel a eco 2 0 gt read t 3 VARIABL gt echo 7 1 gt echo VARIABLE caile Si continues Waal a gt El
66. ess to ABLE on that new device This can be especially useful in scripts which can add displays based upon shell de cisions Section 5 5 Practical use of the console system contains more examples on using this feature Example 5 4 Adding console drivers to a running system This example shows the adding of the second s3c2410 serial port once added the serial port can be used to interact with ABLE gt console 1 Console write all write gt s3c2410x video S3C24XX Framebuffer 640x480 60Hz 31 5 KHz AAN IATA gt serial low level serial Console read all read gt usbkbd USB Keyboard Driver gt null NULL gt serial low level serial gt console a s3c2410 seriall adding console s3c2410 seriall gt console 1 Console write muli exiis gt quece2A4d serial Ec S3e2410 sxeseatelb gt s3c2410x video S3C24XX Framebuffer 640x480 60Hz 31 5 KHz gt null NULL gt serial low level serial Console read all read Simtec Electronics 35 Chapter 5 ABLE Console SSA ES CAE 5624110 sxexestet1 gt usbkbd USB Keyboard Driver gt null NULL gt serial low level serial 5 4 Setting the logging level The ABLE console output is split into levels of importance Only messages with a level lower than the current log ging level are displayed The logging level is set at boot time by the console level variable if unset the value defaults to 6 A
67. etc services is 17571 bytes long es 100 wa 17571 00000064 7720656c 2d6c6c65 776f6e6b 20230a6e le well known 00000074 74726 70 6d756e20 20726562 20726f66 port number for 00000084 68746f62 50435420 64666120 50445520 both TCP and UDP 00000094 6568203b 2c65636e 66666f20 61696369 hence officia 000000a4 20796c6c 74726f70 61682073 74206576 lly ports have t 000000b4 65206 77 6972746e 230a7365 65766520 wo entries ev 000000c4 6669206e 65687420 6 727020 6f636f74 n if the protoco 000000d4 6 64206c 27667365 75732074 726 7070 1 doesn t suppor 000000e4 44552074 706 2050 74617265 736e6f 69 3 t UDP operations 000000 4 0a230a2e 70552023 65746164 72662064 Updated fr 00000104 68206d6f 3a707474 77772 2 61692e77 om http www ia 00000114 6f2e616e 612f6772 67697373 6e656d6e na org assignmen 151 dumpfile 00000124 00000134 00000144 00000154 00000164 00000174 00000184 00000194 MORE gt See also 152 cat VOZEIS TA 20646e61 20736563 DSLT 2 696763 66216372 20230a2e 62206c6c 2074726 6568746 f 656b696c 65657266 T7 1376963 132 6374 2077654e 64612065 626d756e 20230a72 74746820 2 647362 632e6265 69767265 74726 70 20646564 20737265 12 193 13 Bie Bae Quo 2E T 1291 TH9238 5 DS 7 20736563 69112072 712206e6f ts port numbers and other sour ces like hecos www freebsd org cgi cvsweb cgi s rc etc services New ports wi ll be added
68. fop utility For six by nine inch book output the Render X XEP digital typography tool was used to convert the FO XML to print ready PDF output The cover designs were developed in the GNU Image Manipulation Program http www gimp org GIMP 259 260 Simtec Electronics
69. g Options to clarify non volatile usage Revision 1 73 17th September VRS Improved Chapter 9 Upgrading Revision 1 80 18th November VRS Updated commands Updated Part III Non V olatile Variables Reference Updated FAQ Revision 1 82 27th November VRS Updated commands Updated Part III Non V olatile Variables Reference Updated FAQ Revision 1 95 10th March 2004 VRS Updated devls Updated Part III Non V olatile Variables Reference Removed FAQ future versions are online http www simtec co uk products SW ABLE faq html Revision 1 99 2nd August 2004 VRS Added echo Updated Part III Non V olatile Variables Reference Revision 2 01 11th October 2004 VRS Updated netif command Added ifconfig Updated Chapter 6 Starting an Operating System Manually Revision 2 08 13th April 2005 VRS Added Chapter 2 Getting Started Chapter 7 Starting an Operating System Automatically Chapter 8 Networking Updated Chapter 1 Overview Chapter 3 Command Line Interface Chapter 6 Starting an Operating System Manually Added boot fs Revision 2 20 17th January 2006 VRS The ABLE 2 20 release is a significant milestone release which represents a greater expansion in capabilities than many previous releases Updated to refer to ABLE version 2 20 Updated Chapter 2 Getting Started Updated Chapter 3 Command Line Interface Created Chapter 5 ABLE Console Removed separate script chapter and moved contents
70. ge Full details of the ARM LINUX booting procedure can be found in the Booting ARM Linux ht tp www simtec co uk products SWLINUX files booting_article html document ELF and AOUT files The ELF and AOUT binary file detection is provided for NetBSD and OpenBSD operation The ELF header is de tected from the hexadecimal value 464C457F at the beginning of the file and the various AOUT formats with sev eral differing magic numbers The AOUT types supported are the old impure format the read only text format the compact demand load format and the demand load format When a file of this type is executed the relevant sections are loaded and relocated as described by their binary headers The code is entered at its entry point with the MMU running and the parameters and command line passed as expected by the BSD kernel Although the LINUX kernel can be extracted as an ELF object ABLE is unlikely to execute the image correctly the zImage format should be used UNIX Compress files UNIX compress files are identified by their first two bytes which contain 0x9D and Ox1F These files when loaded to be executed are decompressed and the result file typed again Gzip files Gzip files are identified by their header of Ox8B1F at the beginning of the file These files when loaded to be ex ecuted are decompressed and the result file typed again Images text and data files These files are identified by various methods but al
71. ght hand side is a vertical green bar 8 pixels wide with a blue cap on the top line The rest of the screen is an alternating 8x8 white and black block pattern This command will not be available if the frame buffer is disabled Figure 12 Video test pattern 5 n 213 214 Simtec Electronics Part Ill Non Volatile Variables Reference Part III shows the available non volatile variables These nvram variables are available and usable in ABLE version 2 20 or later Any variables which are not avail able on all platforms will be marked as such in their description section Each variable is documented in a format similar to the UNIX manual page layout The page is separated into sev eral parts Name The name of the variable and its purpose Description Describes the variable in detail Platforms This optional section describes the platforms which use the variable is present if not present the vari able is available on all platforms See also This optional section gives references to other variables which may be relevant Table 9 Alphabetical list of non volatile variables Variable Purpose boot auto 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 com mand console write Default Console output stream console read Default Console input stre
72. gives a cooked data source To make the users interaction with ABLE easier a set of alias sources are automatically generated Each of these aliases may be referred to as a source in its own right The Is command can be used to list these aliases Example 6 2 Using the Is command to list cooked sources The Is command performed on the root directory Sls 1 lrwxrwxrwx 1 0 0 Li lack gt Imckeil sex 2 lrwxrwxrwx 1 0 0 8 nvram0 gt 24cxx0p1 lrwxrwxrwx 1 0 0 15 Elasiil gt meum sitis lrwxrwxrwx 1 0 0 7 flash0 gt nand0pl1 gt ABLE detects and creates a cooked source for every raw source that can provide files Each of the raw sources will be examined for recognised filesystems and if a partitioned device each partition will be scanned ABLE can in terpret several filesystems these include EXT2 FFS ISO9660 including rockridge extensions and FAT Filesys tems are only scanned for on suitable sources 1 e ISO9660 filesystems would only be searched for on cdrom Sources The user need not use the aliases and may specify the full source descriptor if desired The sources hd0 and hdc1 ext2 from the previous examples are completely equivalent The full construct may be used to attempt to force ABLE to interpret filesystems where it has not automatically detected one but this will almost certainly result in unexpected and incorrect behaviour 6 3 Network sources The network is treated differently to other
73. he SO record starts the file The S3 records contain the data The S7 record contains the entry address and com pletes the file load S0030000FC S325 3225 923 S325 04403C0880018D08DD900000000011000026000000003C0880012508DC50C50000B401 0460C50100B8C50200BCC50300C0C50400C4C50500C8C50600CCC50700D0C50800D4FA 0480C50900D8C50A00DCC50B00E0C50C00E4C50D00E8C50E00ECC50F00F0C51000F49A 04A0C51100F8C51200FCC5130100C5140104C5150108C516010CC5170110c518011434 ISS Ue o d exe em fe SS a etes amy te 70500000000FA 6 7 Starting an Operating System 6 7 1 Once a complete file path to an operating system image has been decided upon the boot process is simple ABLE may be used to start a recognised operating system in two ways The two methods for starting an operating system are the setargs load and boot method or the command line method As can be seen from Example 6 6 Using the setargs load and boot method to start a LINUXO kernel and Example 6 7 Using the command line method to start a LINUX kernel both these methods produce ex actly the same result and the kernel is passed exactly the same parameters in both cases The command line method is preferred as it is simpler and more obvious but there are some limited circum stances where it is not sufficient multiple boot files and the setargs load and boot is necessary The setargs load and boot method
74. hes First all the available drivers are listed then the current log level is displayed and changed Finally the active drivers are listed a new driver added and listed again to show the addition was successful gt console d 65 console w a s3c2410x video a usbkbd ul JL all wr Ga al L iel Mar serial rw s3c2410_serial2 Gran SS AOS eat IS rw s3c2410 serial0 gt console s Current console level 6 gt console s 4 Changing log level 6 to 4 gt console 1 Console write all write gt s3c2410x video S3C24XX Framebuffer 640x480 60Hz 31 5 KHz gt null NULL gt serial low level serial Console read all read usbkbd USB Keyboard Driver gt null NULL gt serial ow level serial console a s3c2410 seriall adding console s3c2410 seriall gt console 1 Console write all write gt SSC2Z4 10 serialil e el 362411 serial gt s3c2410x video S3C24XX Framebuffer 640x480 60Hz 31 5 KHz gt null NULL gt serial low level serial Console read all read gt eso241 sese sg sel 952210 ES ETES gt usbkbd USB Keyboard Driver null NULL gt serial low level serial gt 66 Simtec Electronics Name date Show the current real time clock date and time Synopsis date Description Show the current real time clock date and time The settime and setdate commands can be u
75. hich do not match the syntax for simple variable names These typically access specific information within the shell and are read only Table 3 1 Special variables Variable name Value Exit status of last command Shell parameters All the positional parameters separated by the first character of the IFS variable The number of positional parameters 3 5 5 Accessing variables Variables are accessed within the shell by using the dollar symbol followed by the variable name name The vari able name my also be surrounded by curly braces name The curly brace form is less ambiguous because if the braces are omitted the shell may not be able to distinguish between a variable name and the text surrounding it The curly brace form is unambiguous as the variable name is clearly delimited Example 3 2 Using curly braces to disambiguate variables This example shows a variable myvariable being set and then displayed using the two forms showing the ambi guity problem gt myvariable hello gt echo foo myvariable bar foo hello bar gt echo foo myvariablebar foo gt echo foo myvariable bar foohellobar gt Simtec Electronics 25 Chapter 3 Command Line Interface 3 5 6 Special care must be taken of positional parameters the simple version with no braces is limited to the nine single digits 1 9 to access the the later positional parameters curly braces must be used Example 3 3 Ac
76. icom DM9000 chipset Tulip chipset Realtek chipset and the traditional NE2000 based devices ABLE does not currently have support for serial based protocols such as Serial Line Internet Protocol SLIP or Point to Point Protocol PPP but there is provision for XModem protocol see Section 6 4 XModem source IP network settings can set maunually or be retrieved from the network from a Dynamic Host Configuration Pro tocol DHCP or Bootstrap Protocol BOOTP server To transfer files ABLE uses the Trivial File Transfer Protocol TFTP protocol TFTP is a very simple protocol it lacks the ability to list directory contents has no authentication or encryption mechanisms and performs its trans fers in lock step with only one packet on the network at any time which reduces its performance Despite its lack of facilitys it is sufficient for retreving files 8 1 Finding a network interface ABLE will create an interface for every supported device it can find All IP capable interfaces available on a plat form can be listed with the ifconfig command SLi COMir ILE amp amO Link encap Ethernet HWaddr 00 01 3d 00 01 6a ze aces 0 0 00 Wiese 25525952255 gateway addr 0 0 0 0 tftpserver 0 0 0 0 ig MODUS 50 Mewstie gi ne0 Link encap Ethernet HWaddr 00 01 3d 00 01 6b las exeleseg050 0 0 Diese 0 0 0 gateway addr 0 0 0 0 tftpserver 0 0 0 0 MTU 1500 Metric 1 In this case two interfaces are available dm0 and ne0 Some platform
77. ics Name bast hdlcd Manipulate an HD44780 attached to the EB2410ITX LCD Module port Synopsis bast hdlcd i 1 1ines w width m msg f ont c cursor z h text Options a Initialise the display 1 Set number of lines on display w Set width of display m Display a message on screen f Set font to use c Set cursor type Z Clear screen h Move cursor home text Text to display Description Manipulate an HD44780 attached to the EB2410ITX LCD Module port 185 186 Simtec Electronics Name dmcfg rd Debug command to read Davicom EEPROM Synopsis dmcfg rd register Options register Davicom EEPROM register to read Description Debug command to read Davicom EEPROM 187 188 Simtec Electronics Name dmcfg wr Debug command to write Davicom EEPROM Synopsis dmcfg wr register value Options register Davicom EEPROM register to write value Value to write into EEPROM Description Debug command to write Davicom EEPROM 189 190 Simtec Electronics Name dump Displays an area of memory in hex dump Synopsis dump start end Options start Memory address to dump from in hex Address is in logical memory space end Last memory address to dump in hex Address is in logical memory space Description Use to display the contents of a memory area in a hex dump The output will be put through a pager and can be abo
78. ings are also available as variables in the shell because a full stop is ambiguous within a variable name the required non volatile setting must be placed within curly braces Example 65 Using the nvshow command gt nvshow hist is unset loo se uus mee DONA O boot cmd hd0 boot vmlinuz 2 6 13 simtecl root dev hdcl console ttySAC0 110 boot timeout is unset ide multi limit is unset usb hubdepth is unset usb enable is unset console level is unset console write is unset console read is unset fb enable on fb output is unset fb refresh is unset rooy S SET Das S ASEE sys autoshadow is unset sys speed is unset gt nvshow fb enable fb enable on gt echo fb enable on gt 165 166 Simtec Electronics Name nvunset Clears non volatile parameter Synopsis nvunset variable Options variable A non volatile variable name Description Unsets a non volatile variable so the default value will be used 167 168 Simtec Electronics OS manipulation commands These are the commands to start and manipulate loaded executable images entries and are available from the shell command line of ABLE from version 1 55 and later 169 170 Simtec Electronics Name boot Starts loaded OS images Synopsis boot help version Options help Display short help message and exit version Display the version of the boot command and exit Descri
79. l Linux Kernel hd0 bin ls hd0 etc services hd0 boot vmlinuz 2 6 13 simtecl ls application x executable etc services text plain boot vmlinuz 2 6 13 simtecl application octet stream 153 154 Simtec Electronics Name sum Checksum a file Synopsis sum filename Options filename Name of file to checksum Description Checksum a file the value produced is the same as the sum command under UNIX This allows for files to be verified before loading with ABLE Example 63 Checksumming a file with the sum command crc 32182 417 Kb processed tftpboot s3c2410 romwrite 220 bin 155 156 Simtec Electronics Non volatile settings These are the commands to manipulate non volatile memory entries and are available from the shell command line of ABLE from version 1 53 and later 157 158 Simtec Electronics Name nvclear Reset non volatile settings to defaults Synopsis nvclear Description This command wipes the nvvars stored in the hardware but does not update the values in memory This allows the in memory values to be saved with the nvsave command Warning A common mistake when using this command is to assume the nvsave command is required this will simply result in the current in memory settings being retained the additional nvsave command is not re quired 159 160 Simtec Electronics Name nvsave Save altered non volatile settings
80. l port to 19600 gt console d w a s3c2410x video e SO El Gaves ea u5wg will w all wr allil ieel rw serial rw s3c2410_serial2 rw s3c2410_seriall rw s3c2410_serial0 rw u16550_seriall rw u16550_serial0 gt setopt s3c2410 seriall 19600 8n1 93 94 Simtec Electronics Name settime Sets the real time clock Synopsis settime hour minute second Options hour hour to set using 24 hour clock minute minute to set second second to set Description This command allows the time to be set in the real time clock The real time clock is typically battery backed and the settings are retained across reboots Example 41 Using the settime command to set the real time clock This example shows the time being altered the system reset and the retention and correct update of the time across the reset gt date Weel Mene CIAO OS gt settime 1 2 3 gt date Wed Mar 22 01 02 03 2006 gt reset selected all wr for console write selected all rd for console read DRAM 128 Mb 134217728 bytes xA ST IMU wwersslom 1 02 DOES CA OO hdb ATAPI CDROM TOSHIBA CD ROM XM 7002B PIO mode 4 hdc FUJITSU MHF2043AT ATA PIO mode 4 hdc Diagnosing disc drive ok hdc 4GB hdb Drive Empty MIO cide sci OOsOilsseleOOsOisoa dime pa labels Ole NEO mets USAGemeicse OOs Oils AclsOOsOil s Glo n n ade PHY OLSO silo
81. l share the common property that they cannot be executed These files must be manipulated with other commands such as the display command for images the cat command for text and the dumpfile for data Motorola S Record Files of this type are identified by their format which must be correct for the first few lines of the file When loaded the whole file must be of the correct format The recognised S Record format is well defined Each file consists of a series of lines Each line begins with an S character and is terminated by a newline Each line represents an individual record its type is determined by the Simtec Electronics Motorola S Record second character on the line 0 to 9 followed by a record length type dependant data and finally a checksum All data after the type field is presented as 8 bit octets coded as two hexadecimal values e g the value 255 is presented as the text FF Figure 6 1 Outline of Motorola S Record Area included in Length and checksumed Type Length CRC 0 9 00 FF xiu 00 FF The checksum is calculated as a ones complement of the data octets including the length The header record is typically the first record in the file ABLE does not interpret this record beyond printing the data section as ASCII output on the console Any number of headers may be included as they have no impact on the decoding of the other lines sl 0 Length Address Data CRC Header record 3 Data 0000 00 FF
82. le line each command separated with a conditional operator which con trols execution of subsequent commands Commands may be separated with one of three conditional operators The first is not really a conditional each command will be executed despite the exit code of the previous com mand The second amp amp will only execute the next command if the previous one exited with a non zero exit code e The third Il will only execute the second command if the first command exits with a zero exit code With these constructs simple conditional decision processes can be built The test command can be used to test logical expressions and combined with the conditional operators make de cisions based upon a variety of tests Example 3 1 Using the test command and conditional operators This example shows how to use the test command to perform some simple textural and numeric comparisons The 23 Chapter 3 Command Line Interface full range of comparisons available can be found in Table 8 Possible test expressions S 4d le 2 amp amp cho 1 lt 2 1 amp 2 gt 2 e i amp amp cho 2 lt 1 gt 3 e 2 i s secas Yi 24 2 2 ge 1 amp amp echo 2 gt 1 DP gt dL gt text text amp amp echo true Lone ro de Vesa taco iesu Lie gt text foo 6 echo true echo false false gt Mee fe Weg 6 echo ezue l cho False ie gt to
83. les are also accessible from within the shell The variable form is identical to that of simple variables with one exception the body of the variable name will contain a full stop Simtec Electronics Positional variables The value is interpreted in the same way as if passed to the nvset command Options that take boolean values can be set with on and off true or false and 0 or 1 may also be used Other options typically take free form text as with simple variables the value may need to be quoted to get a correct assignment Any changes to the non volatile variables will not be made permanent until a nvsave command is issued Chapter 4 Setting Options contains details on using the non volatile settings 3 5 3 Positional variables The positional parameters are similar to the simple variables except the variable name is a positive integer number Each parameter is set from the arguments to the shell or script when it was started The single digit O has special meaning and is set to the name of the shell or script Positional parameters cannot be assigned with the normal assignment operator and are read only When the tenth or later positional parameters are referenced they must be disambiguated using curly braces this is shown fully in Example 3 3 Accessing positional parameters 3 5 4 Special variables In addition to simple variables there are a small number of special variables w
84. ll available interfaces S Changes output to short format help Display commands syntax then exits version Displays commands version then exits address Address to assign to interface e g 192 168 7 101 interface Name e g ne0 or deO unless a is used netmask Netmask to assign to interface e g 255 255 255 0 gateway Default gateway to assign to interface e g 192 168 7 1 tftpserver TFTP server address to use e g 192 168 7 10 up Selects the interface as operational and the default down Disables the interface Description This command allows network interfaces to be manually configured and different interfaces to be selected Normally ABLE will use DHCP on the default interface when retrieving files over tftp the default interface may be changed with this command by using just the up flag see Example 53 Using the ifconfig command to select default interface By using the other parameters the interface may be configured with IPv4 addresses Configuring in this way re moves the requirement of using a DHCP server Example 53 Using the ifconfig command to select default interface gt 1ECOMELS A amO aci OOS Oils Sole 20 20320 ne0 inlivievckobe 0102 Oil e Sole std OO gt ifconfig dm0 up looking for net dm0 net dm0 selected as gt ifconfig nel up looking for net neO net ne0 selected as gt boot interface boot interface 131 ifconfig 132 Example 54 Using the ifconfig command to configu
85. ll mes sages of any priority can be viewed with the sysmsg command after boot Warning Setting this value to 0 will result in no output being displayed from ABLE unless a critical error occurs However the console input will still function correctly The console level can be dropped by using console s 6 This will allow what is being typed to be seen once more 5 5 Practical use of the console system 9 5 1 36 The practical applications of the console system may not be immediately apparent The flexibility of the system al lows for configurations in deployed solutions which meet the needs to the developer The following sections outline a few use cases from which a developer should be able to construct many function alities Some of these make use of the scripting capabilities which are described in Chapter 3 Command Line In terface Warning It is possible to configure the console settings so no input or output can be made to the console In this case the non volatile ignore jumper on the board should be used to recover the unit This will cause the default all drivers to be used Basic serial debug console In this scenario the requirement is to get a serial console on the first 16550 based serial port only It should be con figured to 9600 baud eight data bits no parity and a single stop bits This is achieved trivially by setting console read and console write to WLSSS0 serial 9500 Gal Example 5 5
86. ll output sent to it and never produces any output multi The multi driver is a pseudo driver which allows for multiple console sources it should never be directly used all wr The all write driver is the default output driver if no other is specified This driver sets the output to be all the available output devices However it only selects the basic seri al driver not any of the other possible serial targets this is to limit ABLE to a sensible number of peripherals on some boards there might be more than ten serial ports which will probably be connected to peripherals which would not respond well to the ABLE con sole all rd The all read driver is the read equivalent to the a11 wr driver This driver selects all the available input sources again only selecting the basic serial driver serial This driver is a read write capable driver which is connected to what is historically con sidered the console serial port This is typically the first serial port On the EB2410ITX 33 Chapter 5 ABLE Console Driver Description for instance it is the first internal port of the s3c2410 on the EB110ATX it is the foot bridge debug port and on the EB675001 DIP it is the main 16550 based port The port will have the settings of 115200 baud eight data bits no parity and a single stop bit s3c2410 serialX The serial ports on the s3c2410 are presented as a series of three devices These devices may have their settings
87. manual page layout The page is separated into several parts Name The name of the command and its purpose Synopsis Command synopsis which may illustrate several invocations Options This part is only present if the command has arguments The command arguments are listed to gether with a description Description Describes the detailed use of the command See also This optional section gives references to other commands which may be relevant Conventions used in this part command text arguments within are required replaceable text for arguments argument s within are optional argument l argument separated by cannot be used together e argument is repeatable expression entire expression is repeatable Table 5 Commands in alphabetical order Command Purpose autoboot Attempt to locate and boot suitable images automatically boot Starts loaded OS images bast hdlcd Manipulate an HD44780 attached to the EB2410ITX LCD Module port bast at Perform an audio test bast at2 Perform BAST audio test copies the line in to the line out cat Displays contents of a text file cd Change present working directory console Controls ABLE console cp Copy a file 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 dmcfg rd Debug command to read Davicom EEPROM dm
88. mer ei ere Gite x65100 x658 0x65 UY 0000 y 0xa6000 00 ty 0xa880 ity 0xa88 ity 0xa8a O X Grok 1S ON A eo cem Geo 5 il 8 x 71000 ty 0xa8a ty 0xa8a y 0xa8a0 ty 0xa8a a00 ty 0xa8a0 ity 0xa8a00 ority 0xa8a00 8a01 a8a05 y 0xa9100 a9800 a9802 She ic ic 01 xaa002 DDN o gt c iS 002 02 aa002 xaa003 83 modules 84 ide_disc_drv priority 0xb0001 ide_cdrom_drv priority 0xb0001 rom priority 0xb1000 net_dm9000 priority 0xd1001 netudp priority 0xd1002 netipv4 priority 0xd1002 netif priority 0xd1002 net_isa_ne2k priority 0xd1002 net_ax88796 priority 0xd1002 net_testl priority 0xd1003 cyclone code priority 0xd1101 sh_osloader priority 0xe0000 app1_osloader priority 0xe0000 lzw osloader priority 0xe0000 netbsd osloader priority 0xe0000 linux osloader priority 0xe0000 srec osloader priority 0xe0000 zlib osloader priority 0xe0000 tmp101 priority 0xe8000 dload priority 0xf00 dboot priority 0xf00 d_cd priority 0xf000 d_cp priority 0xf000 AMECA O y 0 OU d_dump priority 0xf0 0 0 0 0 DD d_echo priority 0xf help priority 0xf lsfs priority 0xf ls priority 0xf00 modules priority 0x poke priority 0xf00 meminfo priority 0x memset priority 0xf reset priority 0xf0 sleep priority 0xf0 wrout priority 0xf0 hwinfo priority 0xf d file priority 0xf00 d display p
89. name ioi nodenam network node hostname Tr kernel releas kernel releas War kernel version kernel version m machine machine hardware name 0 operating system operating system help display this help and exit version display version and exit Please report bugs to lt support simtec co uk gt gt uname help Usage uname OPTION Print system information No OPTION is the same as s Za bl all information in the order Sip kernel nam kernel name idly nodenam network node hostname 17 kernel releas kernel releas War kernel version kernel version Sala wine machine hardware name 0 operating system operating system lne lio display this help and exit version display version and exit Please report bugs to lt support simtec co uk gt gt uname a ABLE gt 3 8 Shell script unknown 2 20 1 Tue Feb 14 12 06 59 GMT 2006 s3c2410x ABL BI ABLE has the ability to execute shell scripts These are simple text files with commands in them The shell com mands in the file are executed in consecutive order as if they had been typed at the command line To be recognised a script file must start with a line sh or bin sh After this commands may be placed on each line as desired Lines starting with a are interpreted as comments and are ignored Example 3 6 Example shell script This is an example shell script which tests the test command and shell quoting
90. nsole read DRAM 128 Mb 134217728 bytes VASES IMU wersslom 2 02 iD 009 08 SclsWOs ilsba ABLE 2 20 Copyright 2001 2005 2006 Simtec Electronics hdb ATAPI CDROM TOSHIBA CD ROM XM 7002B PIO mode 4 hdc FUJITSU MHF2043AT ATA PIO mode 4 hdc Diagnosing disc drive ok hdc 4GB held wim moel ge 7 hdb Drive Empty IDA cue iil OOsOilsscleOOsOilsea aime pay Link Ok LONE will culex NEZO0O0s mets 184 Ee nerie 00201 530800201 s Glo TMP101 not detected sys autoshadow unset automatically shadowing gt a Unless the boot parameters are altered from their default settings the automatic boot process will commence To manually start an operating system the command line must be used 2 1 Using hyperterm as a serial console To access the serial console from windows the Hyperterm program can be used Identify which serial port the plat form is connected to and ensure a note is made of the correct COM port e g COMI or COM2 Figure 2 1 Hyperterm settings window 19 Chapter 2 Getting Started COM Properties a k E x Port Settings Bits per second Data bits Parity Stop bits Flow control Start HyperTerm and create a new connection When prompted for which modem to use instead choose the appro priate COM port as noted earlier Then the appropriate settings for your platform please refer to platform specific documentation typically these settings are 115200 bits per second 8 data
91. o bart M7 S foo us echo true lecho false false SEoo z S fool amp amp echo true echo false Love gt 3 4 Quoting Some characters and words have special meanings to the shell The quoting process is used to remove these special properties There are three ways to quote special values The escape character V e Single quotation marks e Double quotation marks The escape character a backslash causes the shell to ignore the special properties of the following character Single quotes around characters stop any special meanings Strings escaped with single quotes may not contain a single quote because the escape character has no effect within single quotes Double quotes preserve all characters within them except and V The escape character only works for a limited number of characters within double quotes these are and X 3 5 Shell variables 3 5 1 3 5 2 24 Simple variables The ABLE shell supports simple variables these variables are in the form name value where the name must start with a letter of the alphabet upper or lower case or an underscore _ and continue with letters of the alphabet numbers or an underscore _ The value may contain any arbitrary numeric or tex tural value and when omitted is a null empty string The value may need to be quoted in order to get a correct assignment Non volatile variables The non volatile variab
92. o true gt test foo foo amp amp echo true true gt test foo bar amp amp echo true Stes O ON Woysie Ge Sele ruS gt gt gt gt E Ll ge 1 amp amp echo roue d Simtec Electronics a H G 0 gt test ge 2 echo true gt test 1 gt 1 amp amp echo true gt test le 2 amp amp echo true MS gt test 1 le 1 amp amp echo true TEUS gt test 1 le 0 amp amp echo true gt test 1 1t 1 amp amp echo true gt test 1 ne 1 amp amp echo true gt test 1 ne 0 amp amp echo true true gt test f hd0 etc services gt test f hd0 etc services amp amp echo true true gt test d hd0 etc services amp amp echo true gt test d hd0 etc amp amp echo true true gt test b hd0 etc services amp amp echo true gt test b hd0 dev hda amp amp echo true true gt test c hd0 dev hda amp amp echo true test c hd0 dev tty amp amp echo true true gt Simtec Electronics 127 128 Simtec Electronics Network operations These are the commands for controlling the network interfaces 129 130 Simtec Electronics Name ifconfig Network device configuration and selection Synopsis ifconfig al s help version interface gateway address tftpserver address up down Options address netmask address a Displays information about a
93. ole read null gt nvsave verifying written data ECCE Autoboot attempt 2 Press any key to abort Autobooting in 6 gt Even using this technique it is easy to get a system into an unbootable state because of this setting the consoles to null is generally inadvisable if another approach can be found Displaying a logo and boot abort This scenario the console is required if user input is given at a specific point in the boot sequence after a boot logo is displayed This is a slightly more complex situation and the developer may decide to place this in a shell script rather than try and cram it all into a single boot cmd line The general solution is Simtec Electronics 37 Chapter 5 ABLE Console 38 Set the console logging level to 0 to inhibit any other ABLE output Use the display command to plot the image Use the echo command to display the user message Use the read command to wait for user input with a two second timeout If the user input is the correct key to abort the boot process set a variable to indicate this If the abort variable is unset start the OS Set the console log level to something reasonable and start a shell Example 5 7 A method to display logo and boot abort sh display d s3c2410x video tftpboot logo bmp Z echo n press c to enter ABLE ABORT no read i 2 sa Il e IBS amp SES ge amp G ABORITSyeq SABORT no amp amp hd0 kernel ro
94. ome Lalo mnt proc root sbin tmp sys Srv opt lost found Sua media var usr bin boot dev home Waie mnt proc LOOL sbin tmp sys Srv opt Simtec Electronics Name Isfs List available filesystems Synopsis 1sfs p partitions v verbose h help Options p partitions Show all partition information v verbos More verbose output h help Display short helptext and exit Description This command lists available filesystems Example 58 Using the Isfs command This shows the Isfs command displaying all the filesystem devices which can be used to read data from The ali ases with a filesystem specifier have been recognised and can be navigated with the other filesystem commands Zeus acl alias for Maciel 26522 nvram0 alias for 24cxx0p1 flash1 alias for nand0p2 jffs2 flash0 alias for nandOpl SILSES cw HO elias o Maciel sde 2 nvram0 alias for 24cxx0p1 flash1 alias for nand0p2 Jjffs2 flash0 alias for nand0pl hdc1 ext2 ARO COJE xmodem char0 24cxx0p1 24cxx0 nor0 dev e03be754 start 0x00000000 size 0x00200000 blksz 0x0001 hdc1 dev e03bec74 start 0x0000003f size 0x007a90b5 blksz 0x0200 ide RCE MED ECC IS 00000000 size 0x7 rrer DIS zM0 021010 tftpboot xmodem char4 char4 character device char3 char3 character device 141 Isfs char2 char2 character device char1 charl chara
95. on EXT2 ISO9660 etc can be browsed and navigated A filesys tem arranges information as files within directories The file navigation commands see File Navigation can be used to change the present working directory PWD and enumerate list the contents of directories A filesystem is presented as a hierarchical tree of directories which contain files and more directories ABLE presents directories in the UNIX manner and includes the and directories which represent the current directory and the parent directory respectively Any file or directory name prefixed by a is considered hidden and will not be listed with the Is command unless the a option is used ABLE starts with the PWD set to the root directory As already seen in Example 6 1 Using the Is command to list available sources this directory contains all available sources by default only the alias sources are listed the raw sources being hidden The cd command is used to change the PWD The ls command with no parameters lists the available files in the PWD Once a file is located the file manipulation commands can be used see File manipulation commands to examine or verify the file The file command is especially useful for determining if ABLE can identify a file as an operating system image 6 6 How ABLE identifies files ABLE uses a set of heuristics to determine a files contents The methods used include magic numbers sequences of
96. on r Simtec Electronics Name file Tests each argument in an attempt to classify it Synopsis file i mime help version filename Options i mime Causes the file command to output mime type strings rather than the more traditional human help readable ones Display short helptext and exit version Display commands version and exit filename Description Name of file to checksum The file command examines a given file and tries to determine the files type The underlying detection code is the same as that used by ABLE when determining how to load and execute files this is useful if the user wishes to check ABLE is correctly determining a files type Section 6 6 How ABLE identifies files has more information on the detection method Example 62 Using the file command to determine filetypes gt file hd Fh p Lil ula p Fh p Lil E o Ol D D D 2 0 Fh ja JL JL Wie We ee Y eM e Y us ex Sr far 12 Fh aaga 0 hd0 boo ile tf tftpboot cla tpboot e hd e e Jere hd bin late boo 1 bin 0 boot vmlinuz 2 6 13 simtecl t vmlinuz 2 6 13 simtecl Linux Kernel tpboot test sh test sh shell tpboot srec srec Motorola S Record 0 etc services services data 0 bin ls hd0 etc services hd0 boot vmlinuz 2 6 13 simtecl Les Slt services ASCII text t vmlinuz 2 6 13 simtec
97. ot dev hdcl console ttySACO 115200 console s 6 Sia i This script would be stored somewhere accessible to ABLE flash hard disc or network and boot cmd set to that location Once verified consoles could be configured as required and console level set to 0 Simtec Electronics Chapter 6 Starting an Operating System Manually ABLE is a powerful tool but its ultimate aim is simply to obtain the operating system image and start its execution with the appropriate parameters This chapter shows how to use ABLE to achieve this aim using the Command Line Interface 6 1 Data sources To obtain the operating system image ABLE can retrieve data from a number of sources A source may be a block device where data can be random accessed in discrete chunks or a stream device where data can be ac cessed serially ABLE insulates the user from these details and provides a unified interface Any device for which ABLE has a driver can act as a source Devices that ABLE can create sources from include ATA hard drives ATAPI cdroms memory devices USB devices and network interfaces ABLE identifies a sources by placing the source name in brackets Sources can be found from the ABLE command line by using the Is command on the root directory Example 6 1 Using the Is command to list available sources The Is when performed on the root directory with the a option shows all available sources 24s a 1
98. ot logo bmp Z autoboot gt nvset boot auto true gt nvshow boot auto OO SULO oum gt nvset boot timeout 1 gt nvshow boot timeout DOOL Emsoe dl gt nvset console level 5 gt nvsave gt reset No Available Targets gt Some of the examples presented in Section 5 5 Practical use of the console system make user of the automatic boot process and may be of interest Figure 7 1 Initial boot operations shows the logic of the initial start process The operation is to loop for key board input for the time specified in boot timeout If no user input is received before the timeout the boot cmd variable is inspected if set the command is executed with the ABLE shell otherwise the autoboot command is executed by default Figure 7 1 Initial boot operations 47 Chapter 7 Starting an Operating System Automatically 48 Initial Autoboot Key Pressed Y boot timeout exceeded N Execute boot cmd Y boot cmd set Execute autoboot command Flowchart for the initial boot operations Abort autoboot Simtec Electronics Chapter 8 Networking ABLE has basic networking facilities allowing it to transfer data using the User Datagram Protocol UDP running over Internet Protocol IP ABLE has drivers for a common set of Ethernet adaptors encompasing those found on Simtec Electronics boards and common PCI cards The supported cards include those based upon Dav
99. ption Tf set the value is used to limit the number of sectors read from an IDE drive in a single operation With most drives this can be left unset Some drives have firmware which incorrectly report the number of sectors they can transfer Quantum Fireball TM series seem especially susceptible This parameter allows the user to force ABLE to read a smaller number of sectors than the drives reported capability The smaller of this parameter and the drives reported maximum number of sectors is used Platforms All Platforms with IDE ports 241 242 Simtec Electronics Name shell hist Shell history depth Description How many commands to remember in the shell history The shell is the ABLE module which provides the com mand line The command line editor can remember several previous commands accessed by using the up arrow This variable controls how many previous commands are remembered The Chapter 3 Command Line Interface covers the use of ABLE shell in more detail 243 244 Simtec Electronics Name sys autoshadow Determines if ABLE will automatically moved into RAM at system start Description Set to on to shadow ABLE into memory at start time See the shadow command for more details If this is unset then the value will be determined by the amount of memory available if more than 32Mbyte of memory is fitted the shadow will be performed This parameter is only available on platforms where ABLE can be dir
100. ption This command starts execution of a previously loaded OS image Its operation is fully described in Chapter 6 Starting an Operating System Manually The arguments passed to the image are set with the setargs command Example 66 Using the boot command gt boot boot an image must be loaded with the load command first gt load tftpboot batty tftp attempting bootp bootp sending request bootp serverip 192 168 7 1 loxogt9os iweumasks 255522555 25950 DOTADAS Si Cro 192 1056 571 NOUS iweuwmeslss 255255525570 bootp address 192 168 7 29 gt boot Simcace IXoeueel es Tool Version 0523 c 2005 Simtec Electronics EB24101TX BAST Test Suite 171 172 Simtec Electronics Name load Load executable images Synopsis load file Options file File paths to load Description This command is used to load OS files which can be started using the boot command The way a file is loaded is determined by the files type The file type is found using the internal detection code The type of a file may be ex amined using the file command The Chapter 6 Starting an Operating System Manually provides a complete description of this commands opera tion See also file 173 174 Simtec Electronics Name showargs Shows arguments to be passed to any booted OS Synopsis showargs Description Shows arguments to be passed to an OS started with the boot command
101. r In previous versions the variable was was called cons_write Platforms EB2410ITX additional valid value is s3c2410x video EB110ATX additional valid value is vga EB7500ATX additional valid value is vidc 225 226 Simtec Electronics Name console read Default Console input stream Description Determines where console input will come from See console write for details on setting the write stream There are three console drivers available on every platform the null driver which produces no input so no but tons can be pressed the a11 rd driver which accepts input from any console driver capable of producing it and the serial driver which accepts input from the console serial port typically the first serial port on a system The default where no nvram variable is set on all platforms since ABLE version 1 79 is the a11 rd target Warning This Variable has been renamed in ABLE versions 2 20 and later In previous versions the variable was called cons_read Platforms EB2410ITX additional valid value is usbkbd IM2440D20 additional valid value is usbkbd EB110ATX additional valid value is ps2kbd EB7500ATX additional valid value is ps2kbd 227 228 Simtec Electronics Name console level Console logging level Description Sets the default console logging level This can be altered after boot with console command 229 230 Simtec Electronics Name fb enable Framebuffer driver
102. rd configuration data for passing to an OS s show Show Simtec Electronics board configuration data d drivers List Simtec Electronics board configuration data drivers h help display short help message Description Simtec board configuration data control command allows manipulation of the board configuration data on suppor ted machines 89 90 Simtec Electronics Name setdate Sets the date in the real time clock Synopsis setdate day month year Options day day of month to set month month to set year year to set two digit values will have 2000 added Description This command allows the date to be set in the real time clock The real time clock is typically battery backed and the settings are retained across reboots Example 39 Using the setdate command to set the real time clock gt setdate 1 2 3 setdate assuming year value is offset from 2000 gt date Seu Res Oil 17259252 2008 TES selected all wr for console write selected all rd for console read DRAM 128 Mb 134217728 bytes BASTE PMU erceiton 1402 ID OOe2 Oils SeleOOs ils ABLE 2 20 Copyright 2001 2005 2006 Simtec 6a Electronics hdb ATAPI CDROM TOSHIBA CD ROM XM 7002B hdc FUJITSU MHF2043AT ATA PIO mode 4 hdc Diagnosing disc drive ok hdc 4GB hdb Drive MSDS ems si NE2000 ne0 ISA Generic n n Empty Us PEN OLEO 2191910 e0 starting PHY reset TMP101 not detected sys autoshadow
103. re a fixed address This example shows the first davicom interface dm0 being configured with the IP protocol address 192 168 7 101 with a netmast of 255 255 255 0 and to use the tftpserver 192 168 7 10 no default gateway has been specified muneri gua 192 168 7 101 netmask 255 255 255 0 vicoserver 192 108 7 110 mp looking for net dm0 net dm0 selected as boot interface gt Simtec Electronics Name mii MI phy control Synopsis mii d dev device p phy address s show r read address w write address value h help Options d dev Performs operation on the specified device p phy Specify phy address on device s show Show allregisters for phy r read Readmiiregister w write Write mii register h help Display short help message Description Gives control of MII phy parameters on supported network controllers Example 55 Using the mii command to show all the registers in a phy cuni COS 00 3000 01 7849 02 0180 03 04 Olel 05 0000 06 0004 07 08 0000 09 0000 10 0000 11 12 0000 13 0000 14 0000 15 16 0000 Al 0295 19 lice 19 20 0000 21 5256 22 O7ec 23 24 0800 L25 2043 1281 e Ofer 12711 28 0010 291 1000 30 0000 31 gt bb10 2001 0000 0000 0000 4001 ike ili 0001 133 134 Simtec Electronics File Naviga
104. riority 0x ol eons Ao OOO d test priority 0xf00 d set priority 0xf000 d ifconfig priority 0xf0000 d mii priority 0xf0000 d autoboot priority 0xf0001 hell priority 0xf0002 See ere 5j 20000000000 000 ee memes er exe DONADO OSA m m m m m m m m m m m m m m m m m m m m m m m m m m Maa O OMOMEM EE aaa E ea a A E SE SE E Simtec Electronics Name pmu Power management control Synopsis pmu o r w state n statej s a 1 Options o turns power off r hard reset w set global wake on state to on with 1 or off with 0 n set wake on LAN state to on with 1 or off with 0 s set PMU value a perform PMU action 1 list current PMU values Description Used to manipulate the Power Management Unit of a platform 85 86 Simtec Electronics Name reset Reset machine Synopsis reset Description This command may be used to reset the machine the exact behaviour is system dependant On the EB7500ATX and EB2410ITX boards this command will communicate with the power management device to perform a physical system reset while the EB110ATX will perform a simple soft reset 87 88 Simtec Electronics Name sbcd Manipulates the board configuration data Synopsis sbcd l load file s show d drivers h help Options I load Load Simtec Electronics boa
105. rity State Regs Last Run ax88796 mii e0369794 00000000 r y e03697d0 013e604e usb hc e036c934 00100000 r y e036c970 013e6057 reaper e03c1a54 00000100 r y e03c1a90 013e6060 lite GOSS 100000010 ic 03c7e20 013e6068 maja eU Sxegyis4 TiOQOO0O0Q CUSCO 09359e6071 HZ 13e607a 208651 seconds gt 105 106 Simtec Electronics Name uname Print system identification Synopsis uname a all s kernel name n nodename r kernel release v kernel version m machine o operating system help version Options a sald print all information in the following order S kernel nam print the kernel name n nodenam print the network node hostname kernel releas print the kernel release v kernel version print the kernel version m machine print the machine hardware name o operating system print the operating system help display this help and exit version output version information and exit Description Print system identification this command is practically identical in use to equivalent commands under UNIX The uname command prints information about the machine and operating system it is run on If no options are giv en the s option is assumed The information printed is always in the order kernel name nodename kernel release machine and operating system The values displayed may contain spaces or punctuation Example 46 Using the
106. ro ones LSB unset Writing address to each location Testing system RAM 0x00400000 0x07d00000 Pattern all ones Pattern all zeros Pattern alternate zero ones LSB set Pattern alternate zero ones LSB unset Writing address to each location Checking ABLE CRC CIC Qu Searching for ABLE info Version 208 Release 2005041001 Supported machine number 3 Supported machine number 6 Testing CPLD registers CPLD ID register value 00 OK DONDI LS cess Lo Ok 0 reaerlec O wean PASSED all tests OK gt Simtec Electronics Chapter 9 Upgrading ABLE is usually stored in non volatile memory It may be upgraded either by running the romwrite ABLE execut able or by reprogramming the non volatile storage directly e g by use of an EEPROM programmer It is generally recommended that users only upgrade if they are suffering a specific issue with a prior version or re quire an added feature Every effort is made to ensure errors are not introduced in updates but Simtec Electronics offer no warranty 9 1 Obtaining Upgrades Simtec Electronics generally provide ABLE upgrades as a romwrite package which combines both the program ming utility and the upgrade in a single binary image Upgrades to the latest version can be obtained for each supported product on the Simtec Electronics website from the resource pages http www simtec co uk support resources html Figure 9 1 EB2410ITX resources page
107. rted with q Example 69 Using the dump command to examine memory This example shows the dump command being used to display the first 4KB of memory The output is aborted with q after the first page gt dump O 1000 00049000010 amp SES esSsil4 es girl esQ9xil4 e As seoscsochsodus 000900100 S5QREOCHIA e5eriQu4d es59ri i4 esQirirQi l 9 sosososcosoososco OOOO OZ OS COTAS TOOLE ta OA ATA A tO AAAI S VHS 0e Dia Diora OOOO OOS EIN CO OOO OOOO EOL GATS OOOO EOOOLOWS RTT re ume OKOKON KOS aaa TdEIEdE QEJEJEJEIEACIE dL dEJEJCJEJEIE 15 S ymo 56 0059309099995 QOXGKONOIONSYO S ae aa ar RME 000 0 006 0 Prises Meter EJEIEIEJEJETETS JESEICIEJEJEQETE LS D OO OO OUT OO aUDSOg KOKOKOKOKO DR ciar dEJEJEJEQEdEISIE JEJEJEJEJEQE EIE 9 NS in D OR 0 0 OTIO E ITO OOOCWMENOS AIZEA E DEE JEJE JESEdGIEIEdE dE IEICE IMIE EID JEJEJEJE JEJEIBIL Bo 23 019 0 0 COD D QUO OS o COOOOOGOS rp dE TEJEJETE dE JEJE TEIEJE JE TE JE EJEJEQETEJETEJE QUEJEIEILIEQEJU SN JS on os oo ee OOCOCMOSHOS aaa SEJENEIEIGIE ETE MOURIER IE IRIE dEJETEJETE JE EIE 9 OO 0 0 D DO 0 AO 0 0 OKONO S dEiEUEdEdEILIEJE JEJEJEQEICIEIEIE QEJEJEJCQEJEdE L MEAR ICI CIDADE S 1x06 09D 0959999wD5 DOUDOU ER ee ea AEIR EAE IRIE 1 OO QUU DUO TO A OOMONOKOC COR SARI UEIEIE UE JEdETE EJEIEIEJEJEJETS IJEICIE3EJEQE TE SOG OUO ood 5 MO SU meg QNO 000 S JEIEJEJE JE IERIE AEdEJEQETEdETETS dEJEJEJEQEdEJE TE QEJEJEJEIEIE TELE 30 ONE DR
108. s may have more than one of the same type of interface which will be presented as dm0 dm1 dm2 etc 8 2 Configuring a network interface Once the required interface is identified it can be configured for use This is achieved using the up option to the if config command This is only required if the required interface does not already have the UP flag in the above case the dm0 interface is marked such because the first interface is marked up by default If the DHCP protocol is used no futher configuration is required and the settings will be recovered the first time the interface is accessed If an automatic server is unavailable or cannot be used for other reasons manual configuration is neccisary Apply ing IP settings manually requires an IP address and netmask and an optional default gateway Although not an IP setting the address of the TFTP server is specified too The ifconfig command is used to set the desired values Full details on setting fixed addresses and other aspects of configuring interfaces can be found in the ifconfig com mand documentation 8 3 Using the network to obtain files Once the interface settings are configured files may be retrieved from the network using the TFTP protocol Files are accessed with the tftpboot source If no filename is given the one provided by the DHCP server will 49 Chapter 8 Networking 50 be used if the DHCP server doesn t provide a filename one based upon the hardware uniq
109. sed to set the real time clock and date Example 30 Using the date command This example shows the use of the date command to get the current date and time the date and time being kept across a reset and finally used to show a delay gt date igs Mie 10 Dis 3800 200 gt date mean Merse E MLS SS 205 2006 gt reset selected all wr for console write selected all rd for console read 128 Mb 134217728 bytes DRAM BASIE ABLE 2 aces m hdc Di hdb ATAPI C PMU version 1 02 ID 002 0s ScleOOs Oils 20 Cove DROM ERT UJITSU MHF204 agnosing disc drive ok 2001 2005 2006 Simtec OSHIBA CD ROM XM 7002B 3AT ATA PIO mode 4 hdc hdb e0 P e0 s BISTRO NIS sys au gt date ica Mee dO OL Se gt date ica Meke MO 0 23 Est Mee 10 Miles gt See also 4GB Cmon sleep 22 settime setdate Drive Empty DM9000 NE2000 n n ne0 ISA Ge a LSO 1971 00 7 CGE Lime PEO e not detecte toshadow unse 224 da 44 206 eset 260 d 2006 te 2006 2006 6a Electronics PIO mode 4 00 01 3d 00 01 6a int phy link ok 100Mbit full duplex aerie 00701336 000l 6 state 7869 LPA 45e1 0007 t automatically shadowing 67 68 Simtec Electronics Name devls Lists information about devices attached to a system Synopsis devis v h Options v be more verbose in output h display help message Description
110. serial driver second port at 38400 baud 8 data bits no parity and a single stop bit eS 2 4 10 seriall 38400 Sl To use the u16550 serial driver first port with the current baud rate 8 data bits no parity and a single stop bit u16550 serial0 8nl1l 5 3 Configuring the console system 34 At boot the console output is sent to all the devices listed in console write The list is a comma separated set of driver names the serial devices must be bracketed and may contain additional parameters Likewise for the console input using the console read non volatile variable When these variables are not set they default to all wr and all rd respectively Simtec Electronics Configuring the console system The current active drivers may be displayed with console 1 The output of this command is split into two sections for the write console output and read console input Example 5 3 Showing the consoles of an unconfigured system gt nvshow console write console write is unset gt nvshow console read console read is unset gt console 1 Console write all write gt s3c2410x video S3C24XX Framebuffer 640x480 60Hz 31 5 KHz gt null NULL gt serial low level serial Console read all read gt usbkbd USB Keyboard Driver gt null NULL gt serial low level serial gt Once a system is running it is sometimes useful to add an additional driver Adding a driver allows acc
111. sources It is accessed through a source which defines the access pro tocol Currently the only supported access protocol is TFTP The tftpboot source uses the currently configured net work interface which is set with ifconfig Chapter 8 Networking describes the configuring and setup of network interfaces in more detail The tftpboot source cannot be enumerated that is a list of files cannot be obtained with the Is command the file name to be retrieved must be already known To use the filename provided by the DHCP server the tftpboot source can be used without a file specified Example 6 3 Using the tftpboot source This example shows that the tftpboot source is unable to enumerate the contents of the source using the tftpboot source with an explicit filename and using the server provided filename when its present and when not set Sle L O O SSSR OOO i OOO gt sum tftpboot batty 18014 33 tftpboot batty gt sum tftpboot tftpboot using bootp filename batty 19014 33 toa Seb tala tftpboot using bootp filename warning filename is null tftp may fail moror Locas rara SNO Sucla Exile Or Chimeccomy gt 40 Simtec Electronics Navigating a filesystem 6 4 XModem source The XModem source is treated differently to other sources It provides a way to obtain files over a serial connec tion using the XModem protocol The implementation of the XModem protocol within ABLE accepts 128byte or 1
112. stems Example 57 Using the Is command This shows a simple directory listing of the first hard disc partition with a filesystem Sils decl lost found Sua media var usr bin boot dev home Io mnt proc root sbin tmp sys srv opt gt This shows a detailed directory listing of the first hard disc partition with a filesystem gt is 1 acl CNP 22 0 4096 drwxr xr x 22 00 4096 drwxr xr x 2 9 10 49157 ILosiesric wnacl drwxr xr x TS 4096 etc drwxr xr x 2 4096 media drwxr xr x 13 4096 var drwxr xr x 32 4096 usr drwxr xr x 2 0 4096 bin 139 Is 140 CHENE RE drwxr xr x drwxrwXxr x OE WIESE XE ES CEWE XE drwxr Xr x drwxr xr x CHERE RES drwxrwxrwx drwxr xr x drwxr xr x drwxr xr x gt This shows the PWD being changed and the Is command used to display the directory contents gt cd hd0 Sls dJb 3 drwxr Xr x drwxr xr x CHERE Chase Chop CHERS E ES ClAW RIE EE drwxr xr x drwxr Xxr x CHE RES ALWXIWXY X CHAN drwxr xr x drwxr Xr x lit WIESE RE drwxr Xr x drwXrWXIWX drwxr xr x BE WIESE IE TES drwxr xr x gt NNN BN O1 N PO o O1 1 N RE J NN NNNO0DN GORN P2 PO ND NO N BAN O1 N P2 o0 0 eee res eee ere DAD MD MODO DO ADS ADOSADO AS MOS Ole eee SAS SAS QS Cra eee G11 Gx eee E 4096 24576 4096 4096 4096 4096 4096 4096 4096 4096 4096 4096 boot dev h
113. t 3 6 Filesystem navigation 26 ABLE has the ability to fully navigate detected filesystems The File Navigation commands may be used to move around and list the entries within any filesystem which supports directory enumeration currently only the tftpboot pseudo filesystem does not It should be noted that only devices with a valid filesystem recognised and supported by ABLE can be navigated in this way ABLE presents all available filesystems and devices in a hierarchical structure The root of this filesystem is a vir tual representation of all the available devices The devices are either direct representations of devices or aliases which show the detected filesystems on devices At initial boot time the Present Working Directory PWD is set to which represents the root of the filesystems The PWD is changed with the cd command and displayed with the pwd command The ls command without any parameters lists the PWD With a parameter it lists the specified directory The Isfs command is exactly the same as using ls Example 3 4 Navigating a filesystem Simtec Electronics ABLE help system gt pwd AES hdl aliases to hd0 aliases to nvram0 aliases flash1 aliases flash0 aliases EC axel SAILS lost found var Sua usr bin boot dev home lag mnt proc root sbin tmp sys srv opt floppy cdrom media initrd vmlinuz gt cd boot zies i rw r r rw r r
114. t to display Description This command is used to display text on the output console One use is in scripts to indicate what actions are being performed If the e option is used the following sequences are recognised Table 7 Escaped echo characters Character Result VONNN the character whose ASCII code is NNN octal iM backslash Va alert BEL b backspace c suppress trailing newline same as the n option f form feed n new line r carriage return t horizontal tab v vertical tab Example 48 Using the echo command gt echo pepper echo fish pepper ie Lela gt echo n pepper echo fish pepperfish gt 115 116 Simtec Electronics Name exit Exit ABLE shell Synopsis exit status Options status Integer exit status Description Cause the shell to exit with a specified status If the status code is omitted the exit status is that of the last com mand executed If the initial shell is exited any additional modules with lower priority will be executed ultimately if no further modules are available the system will halt 117 118 Simtec Electronics Name read Reads a line of input into shell variables Synopsis read d delimiter Le n number Lp prompt ss t timeout u file variable Options d delimiter n number p promp t timeo u fd variable Descrip
115. tected sys autoshadow unset automatically shadowing gt sysmsg 15 celes Srecicus 200000007 ezo 90 E 410 ket 2 low level serial 00000000 3 log level is now 1 4 ABLE 2 20 s3c2410x vince gerald 5 Processor Samsung S3C2410A arm920 6 System Machine bast s3c2410x Linux id Je S3C 240 X RICS 192429257 03403720103 8 s3c2410x character device 9 NAND configured boot slot is 0 card s 10 NAND device 0 Samsung K9F1208u0a 131 11 flash0 on nand0pl 125 Grlasial on eue 2 2 7 1 92 13 EEPROM 24cXX 1024 bytes single byt 14 nvram0 on 24cxx0p1 15 sys speed is unset Setti 16 u16550 serial0 aliased to char0 ys Miss series altas me eneur 18 s3c2410 serial 115200 8n1 16 byte f 19 s3c2410_serial0 aliased to char2 208 SIC7Z410 seriek 1LSZ200 uad 16 lee E ZU SIECZAN0 Serie culslesecl o KENS 2268 SICZEO series 1115200 Gini iS loce E 23 s3c2410_serial2 aliased to char4 24 all wr adding console serial 25e alles CLE console ll 26 no configuration defaulting to VGA 27 Chrontel CH7006 detected 28 screen mode is 640x480 Hz Hz HSync 29 video video size 300K 30 s3c fb VClk 22166666 HZ Sig comricuistasg dla 70053 wee 101 sysmsg 102 ell enes Excloll real eel ro dal mo console i ng console s3c2410x video nd SM501 device selected all selected all DRAM 128 Mb BAST PMU ve usb enable n usb hubdepth new hc e036d SESE sige lo
116. the boot auto variable is on The complete autoboot process is discussed in Chapter 7 Starting an Operating Sys tem Automatically 221 222 Simtec Electronics Name boot fs The filesystems to be scanned by the autoboot command Description This variable is used to configure the names and ordering of the filesystems to be automatically scanned by the autoboot command If unset it defaults to cd hd rom tftpboot e g try the CDROM hard discs NOR flash and then the network 223 224 Simtec Electronics Name console write Default Console output stream Description Determines where console output will be sent See console read for details on setting the read stream Note the read and write sources do not have to be balanced and may be mixed as required e g write set to vga and read set to serial There are three console drivers available on every platform the null driver which redirects all ABLE output nowhere so it is not seen the a11 wr driver which sends all console output to any console driver capable of dis playing it and the serial driver which sends output to the console serial port typically the first serial port on a system Full details on controlling the console system can be found in Chapter 5 ABLE Console The default where no nvram variable is set on all platforms since ABLE version 1 79 is the al 1 wr target Warning This Variable has been renamed in ABLE versions 2 20 and late
117. tile Variables Reference The nvset command is used to change the values of the variables its syntax is nvset variable value Where the variable is one of those shown in Part III Non Volatile Variables Reference and the value is cor rect for the variables type Example 4 2 Using the nvset command This example shows the setting of three variables one of each type and their effects on the variables as shown by nvshow It should be noted that to set string values with spaces in them the values must be quoted appropriately gt nvshow boot cmd boot time shell hist 0 GhblEIO loYO E OLE auto shadow off cons write cons read 31 Chapter 4 Setting Options 32 gt nvset boot cmd boot hd0 vmlinuz root dev hdal gt nvset boot time 1 gt nvset auto boot on gt nvshow boot cmd boot hd0 vmlinuz root dev hdal boot time 1 shell hist 0 auto boot on auto shadow off cons write cons read gt Values altered with the nvset command are not permanent until the nvsave command has been issued The nvsave command commits the current changes to the non volatile storage without this the changes will be lost upon a sys tem reset The nvclear command can be used to restore the values back to the defaults The nvsave should not be used to at tempt to save these values this would result in the current settings state being saved not the default values Simtec Electronics Chapt
118. times Memory address to read in hexadecimal This command retrieves a memory location and prints it in hexadecimal The address specified is dependant on the machine architecture and is the translated by the MMU The p option causes the physical address specified to be translated into a virtual address suitable for use within ABLE the virtual translated address is shown during display See also poke dump memset 195 196 Simtec Electronics Name pic rd Read a value to the PMU PIC Synopsis pic rd register Options register Register to read from Description Debug command to directly read value from PMU registers 197 198 Simtec Electronics Name pic wr Write a value to the PMU PIC Synopsis pic wr register value Options register Register to set value Value to write into register Description Debug command to put values directly into the PMU registers 199 200 Simtec Electronics Name poke Poke memory location Synopsis poke p v b b w eor orr bic set rpt count address value Options set rpt count address value Description Interpret memory address as physical location Interpret address as virtual the default if not specified Byte 8bit wide read Half word 16bit wide read Word 32bit wide read default 1f not specified Exclusive or the value with the current contents of memory
119. tion These are the file commands are available from the shell command line of ABLE from version 2 20 and later 135 136 Simtec Electronics Name cd Change present working directory Synopsis cd directory Options directory Directory to set as present working directory Description This changes the present working directory of the shell to the specified directory the change may be relative to the current directory or an absolute path Example 56 Using the cd and Is commands to navigate a filesystem This shows using the cd command to change into the boot directory of the first hard drive and then perform a relat 1ve move into the var directory gt cd hd0 boot gt 1s Conso CSSS Mec valibnnz 2 6 13 Simeecil Sel o o AS gt ls lati cache backups local lock log run Spool tmp opt mail gt 137 138 Simtec Electronics Name ls List files in directory Synopsis ls a directory Options 1 Long listing giving more information a Listing includes all files directory Directory to list Description This command produces a list of all the files in a given directory if no directory is specified then the present work ing directory is shown Example 56 Using the cd and Is commands to navigate a filesystem shows the listing of the PWD Listing the root directory ls is the same as the Isfs command and lists all the available filesy
120. tion t ut The delimiter is a single character which is used to terminate the input line the default if this option is not given is newline If the input is not coming from a file u isn t used the input will be read with a line editor This line editor is the same as the main shell but with no history The command exits after reading the specified number of characters The prompt will be output before starting to accept input The prompt is only displayed if u is not being used If the u is not being used characters entered are usually displayed this switch inhibits this display This can be used for password entry this stops reading input after the timeout and exits with a non zero exit code The option has no effect if the u option is being used Instead of reading input from the console read from the given file descriptor The names of the variables to place the read text into If no names are supplied the input is put into the REPLY variable One line is read from the console or from the file descriptor supplied as an argument to the u option and the first word is assigned to the first variable name the second word to the second name and so on with leftover words and their intervening separators assigned to the last name If there are fewer words read from the input stream than names the remaining names are assigned empty values The characters in IFS are used to split the line into words unless the delimit
121. to find a suitable output device and then using that driver to display a bitmap file from a tftp server gt console d 1w w a Ges ivre Wa Gea rw aeu CIS WEE gt display d s3c2410x video gt s Se 241b exexeaterlt 1 s3c2410x video usbkbd multi null all wr SAME EE serial ISSN ONES eri a2 s3c2410 serial0 tftpboot logo bmp 71 display SIMTEC ELECTRONICS iiyama Vision Master Pro 400 Simtec logo displayed with the display command on an EB2410ITX video console 72 Simtec Electronics Name help Display help on built in commands Synopsis help command Options command inbuilt command name Description Without a parameter this command lists the in built commands understood by the shell Specifying a command name prints a brief help message for that command which is typically the same as using the he1p option Example 33 Using the help command This shows the help command being used to get help on the help command itself it then shows obtaining help on the sh command and obtaining the same information with the help option gt help Internal commands are sh autoboot sbcd bast hdlcd pic wr pies ed logs az la Sie Ee dmcfg rd dmcfg wr pmu shadow mii MECON Ser ECESE console display file hwinfo wrout version nvclear nvunset nvsave nvshow nvset uname sum tasks sleep showhz sysmsg setopt showargs setargs reset m
122. ue n string the length of stringis nonzero string equivalent to n string z string the length of stringis zero stringl string2 the strings are equal stringl string2 the strings are not equal integerl eq integer2 integer is equal to integer2 integeri ge integer2 integerlis greater than or equal to integer2 integeri gtinteger2 integerlis greater than integer2 integerl le integer2 integerl is less than or equal to integer2 integer1 lt integer2 integerlis less than integer2 integeri ne integer2 integer1 is not equal to integer2 filel ef file2 filel and file2 have the same device and inode num bers filel nt file2 filel is newer modification date than file2 filel ot file2 filel is older than file2 b file file exists and is block special c file file exists and is character special 125 test 126 Test Result is true if d file fileexists and is a directory e file file exists f file file exists and is a regular file g file file exists and is set group ID G file file exists and is owned by the effective group ID h file file exists and is a symbolic link same as L k file file exists and has its sticky bit set L file file exists and is a symbolic link same as h O file file exists and is owned by the effective user ID p file file exists and is a name
123. ue ID is used the hwinfo command can be used to find the unique ID Most of the operations described here are not usually required if a properly configured DHCP and TFTP servers are used Any file that can be accessed using TFTP can be used wherever a filename is used within ABLE no dis tinction between network and local files is explicitly made the one exception being that filesystem stat calls can not be sensibly answered via TFTP The ability to use the network in this way allows for a very rapid compile execute and test cycle No physical me dia is involved and mistakes can be rectified and retested in a short time Example 8 1 Executing a program using the tftpboot pseudo filesystem This example shows the batty board test tool being retrieved over the network using a default DHCP configuration gt aa OAE ES tftp attempting bootp bootp sending request loexow9s serxwvestios 192 108 701 bootp netmask 255 255 255 0 lNodusys sejwvenios 192 108 711 lolas meuimasiks 255225525500 lo rrjos aelhesss 192 188 7 222 loaded tftpboot batty 0x8040 bytes at 0x00008000 boot booting able appl Simeae Bono Wess exo Weicssloi O O 2005 Siaeece Hecer onies EB2410ITX BAST Test Suite Testing S3C24XX CPU Core CPU ID 32410002 OK S3C2410A Testing internal SRAM block Pattern all ones Pattern all zeros Pattern alternate zero ones LSB set Pattern alternate ze
124. uname command on the EB2410ITX gt uname ABLE gt uname a ABLE unknown 2 21 1 Mon Mar 13 12 19 51 GMT 2006 s3c2410x ABLI 2undtne E ZI 2D AMe av 1 Mon Mar 13 12 19 51 GMT 2006 gt IE See also version 107 108 Simtec Electronics Name version Display ABLE shell version Synopsis version Description Displays the version number and build information of the currently executing instance of ABLE This is the same text which is output during the boot process The information provided by this command is also available from the uname command Example 47 Using the version command gt version ABLE 2 20 Copyright 2001 2005 2006 Simtec Electronics gt See also uname 109 110 Simtec Electronics Name wrout Write a string to an output file Synopsis wrout file string Options file filename of file to write string string to write to file Description This command allows output to be sent to a file this can be a special device such as char2 111 112 Simtec Electronics Shell Commands These are the commands which can be used to perform operations related to the ABLE shell 113 114 Simtec Electronics Name echo Output some text to standard output Synopsis echo n e text Options n do not output the trailing newline e enable interpretation of the backslash escaped characters text tex
125. ure se ENS 233 ibd rc rr RW Mec HC REC RE 235 DO EEUMMCIIPTME 237 A cet cee 2 sou cies wth ens ao ru das uere ber e ee dE de 239 SER ID mit sariren TERM CAN RQ wae dee anes EEE S ce 241 shell hist a SR tarde ER TR AT al rra ah AMS tear oe inh ies Cv Are ent 243 aridum viniste 245 sys Speed NN 247 usb enable AAE TAE EEE EIEE E AEE E T ETTO E NEEE EEES 249 usb hubd pth i ld AR e een 251 TV Appendices RR 253 Ae Chan O sos Pen ER ta diac thawte idea 255 ndex 4 A A e e ON eA Tian ARE E MN Seu Se RETNA 257 Simtec Electronics vi Simtec Electronics List of Figures 2 1 Hyperterm settings AAA NS 19 2 2 Hyperterm displaying ABLE output sisi 20 2 3 Minicom settings WIDdOW ette Rr Pr De tre PRI Feb ane rente hentai tere sati pese Eee reet Met 21 6 1 Outline of Motorola S Record seine 43 7 T Initial boot operations oce t REEF EE XS Ti nales rai n pala 47 9 1 EB2AIOIT X resources page sn uen dessine rer obren ee en ii anne See tnt 51 7 Autoboot command flowchart sise miennes ERE ER EET ERE SEEN EEEE postales gees 61 8 Video test pattern A ee eter ripe Ques cobiab cdots ES EEEE EE esse 205 9 Video test pattern Zi re DRUSI eer e e eb eee 207 107 Vid o test patterm3 n eet tie ee optat aiii ide 209 11 V1deo test pattern 4 ie A i N s 211 12 Vid o test patteri S iei pee hr eren iere tee Seder cetero periere opt less te 213 vil vili Simtec Electronics List of Tables SS niet anse E E
126. ve NBII 2 20 Co hdb ATAPI C AEs IM LES hdc Diagnosi vel set setting 6 wr for console write rd for console read 134217728 bytes Salon 1 02 ot set setting 1 not set setting 2 1b4 e036d1b4 pyright 2001 2005 2006 Simtec DROM TOSHIBA CD ROM XM 7002B MHF2043AT ATA PIO mode 4 ng disc drive ok hdc 4GB ado ow m hdb Drive M9000 dm0 E2000 ned e0 PHY 018 startin MPTOT not ys autoshad ne0 bringi sysmsg oO Val S Bee dcl ext2 Empt y a lee ISA Generic 0 bb10 G Pike reser detected ow unset mej lel uo state 7849 238 489 IB 00301 3els 00 OLS 0001232 00201253 aac jolayy 00015 Sels 003 OL s Ge LPA 0000 0004 6a Electronics PIO mode 4 link ok 100Mbit full duplex automatically shadowing Simtec Electronics Name sysspeed Sets the system clockspeed Synopsis sysspeed speed Options speed system speed in MHz a integer number is required and the MHz units should be omitted Description Displays possible speeds with no parameters or sets the system speed in MHz Example 44 Using the syspeed command on a EB2410ITX This shows the sysspeed command being used to list possible values with the indicating the current selected speed The speed is changed to 226 MHz from 266MHz and redisplayed gt sysspeed 34 MHz 45 MHz 51 MHz 48 MHz 56 MHz 68 MHz 79 MHz 85 MHz 90 MHz 101 MHz 113 MHz 118 MHz 124 MHz RS AMEL 147 MHz
127. vel 36 38 65 229 read 19 34 37 65 227 write 19 34 37 65 225 fb enable 231 output 233 refresh 239 x 235 y 237 ide multi limit 241 shell hist 243 sys autoshadow 245 speed 247 usb enable 249 hubdepth 251 O OpenBSD 42 operating system 17 39 P PCI 49 PPP Point to Point Protocol 49 R reset 52 87 hard 19 romwrite 42 51 52 S S Record 42 Shell script 28 42 SLIP Serial Line Internet Protocol 49 T TFTP Trivial File Transfer Protocol 40 49 49 49 49 50 258 50 50 52 U UDP User Datagram Protocol 49 Universal Serial Bus see USB USB Universal Serial Bus 19 33 39 User Datagram Protocol see UDP X XModem 41 41 41 41 41 41 49 Z zImage 42 Simtec Electronics Colophon This Document was prepared in Docbook XML http www docbook org using the GNU emacs text editor The source was combined with DocBook XSL Stylesheets http docbook sourceforge net projects xsl using an XSLT processor to produce output in various formats For web output the Saxon XSLT processor http saxon sourceforge net was used to convert the docbook XML directly to HTML For print output the Saxon XSLT processor http saxon sourceforge net was used to convert the docbook XML to Formatting Objects FO XML For general print documents the FO XML is converted to PDF and Postscript with the Apache project FOP ht tp xmlgraphics apache org

ABLE User Guide - Simtec Electronics

Contents

Download Pdf Manuals

Related Search

Related Contents