MBL Users Manual For EV44B0-II Board

Transcription

1 For EV44B0-II Board MICETEK International Inc., 1/28

2 Glossary MBL MICETEK BOOT LOADER MICETEK International Inc., 2/28

3 Table of Contents Introduction... 5 Memory Map... 6 Flash Memory Map... 6 DRAM Memory Map... 6 Installation How to burn the MBL to flash Connect to MBL (Micetek Boot Loader):... 8 Using the Monitor/Debug Firmware What is MBL Operational Procedure System Power-up System Initialization Commands Help printenv setenv saveenv md mw mm nm cp cmp crc erase flinfo protect bdinfo iminfo mtest usb icache dcache MICETEK International Inc., 3/28

4 reset sleep version go run bootm bootd bootp Tftpboot rarpboot loadb loads autoscr base echo Update MBL or Save user program on FlashROM MICETEK International Inc., 4/28

5 Introduction MBL is Bootloader for booting the Linux kernel or other applications from EV44b0-II board. MBL supports Ethernet/serial/USB to download an image. When you download a large image from a server, Ethernet capability can help you to save time. For convenience, MBL also support serial or USB download. The software structure of MBL is described in figure 1. Command TFTP Handling Handlin Kermit Console UDP Environmen IP ARP UART Driver Ethernet Ethernet Driver Flash Driver USB Driver Initialize System EV44b0ii S3C2510 UART EV44b0ii S3C2510 Ethernet Ethernet MAC Flash Memory USB Application & Protocols Driver Physical Fig 1. Firmware Structure of MBL In figure 1, MBL has 3 layers as Application & Protocol, Driver and Physical. In physical layer, there are three components, which are UART, Ethernet, USB and Flash memory. Driver layer has a responsibility of communicating with Application & Protocol layer and Physical layer. Application & protocol layer has command routines, which are used by users, and delivers commands to each protocol. MICETEK International Inc., 5/28

6 Memory Map Flash Memory Map 0x FLASH (2MB) Free space 0x x x Environment Variables Bootloader Fig 2. Flash Memory Map Figure 2 shows the memory map of Flash memory. Flash memory is divided into 3 parts, which are MBL code, free space and environment space. After reset or power up, Flash memory base address is 0x0. DRAM Memory Map 0x0c X0c MBL code copy and running area Image Downloading Area 0x0c Fig 3. SDRAM Memory Map MICETEK International Inc., 6/28

7 Figure 3 shows the memory map of SDRAM. After MBL boot up, MBL copy itself to RAM from 0x0c to 0x0c7fffff. The lower space of RAM is reserved for downloading Linux image or other applications such as EV44B0II test program. The default address of downloading space is 0x0c But you can change this downloading space address if you want to. MICETEK International Inc., 7/28

8 Installation 3.1 How to burn the MBL to flash Please see the readme.txt on your CD s root directory. 3.2 Connect to MBL (Micetek Boot Loader): PART A: HARDWARE CONNECT: install USB port driver: select MBL directory\usb\drivers\bulkusb.inf, right-click it and select install PART B: ROOT INSTALL. (1) Start Programms Accessories Communications Hyper Terminal, (2) Then create a new terminal, input the description of connecting, like ev44b0ii: MICETEK International Inc., 8/28

9 (3) Select COM port to config as follows and select OK : (NOTES: baud rate must be , flow control should be NONE. And the rest are the default value. ) (4) Power on EV44B0II board, MBL will boot up. At end prompt appears when it means the EV44b0-II board is ready and can accept EV44b0ii command. MICETEK International Inc., 9/28

10 Using the Monitor/Debug Firmware The EV44b0II board computer has a resident firmware package that provides a self-contained programming and operating environment. The firmware, named MBL, provides the user with monitor/debug interface, inline assembler and disassembly, program download, register and memory manipulation, and I/O control functions. This Chapter is a how-to-use description of the MBL package, including the user interface and command structure What is MBL MBL is a resident firmware package for the ARM family single board computer. The firmware (stored in one 1Mx16 Flash ROM device) provides a self-contained programming and operating environment. MBL interacts with the user through pre-defined commands that are entered via the terminal. These commands are defined in Section 4.3, Commands. The user interface to MBL is the command line. A number of features have been implemented to achieve an easy and intuitive command line interface. The command line prompt is. Any MBL command may be executed from the prompt. In general, MBL is case sensitive. For serial communications, MBL requires baud rate, eight data bits, no parity, and one stop bit, no data flow control. After the system initialization, the board waits for a command-line input from the user terminal. When a proper command is entered, the operation continues in one of the two basic modes. If the command causes the execution of the user program, the MBL may or may not be re-entered, depending on the discretion of the user. For the alternate case, the command will be executed under control of the MBL firmware, and after command completion, the system returns to command entry mode. On operation, user can interrupt current task by pressing CRTL-C. For commands that accept an optional [.b.w.l] to modify the memory access size, the valid values are:.b 8-bit(byte) access.w 16-bit(word) access.l 32-bit(long) access If no optional is provided, the default width is.l, 32-bit Operational Procedure System power-up and initial operation are described in detail in chapter 1. This information is repeated here for convenience and to prevent possible damage System Power-up Be sure the power supply is connected properly prior to power-up MICETEK International Inc., 10/28

11 Make sure the terminal is connected to UART0 (P2) connector. Turn power on to the board System Initialization Hardware RESET Button. Software Reset Command Commands If MBL is burned to Flash memory and power on, you can find the screen as below from terminal window: In general, when you don t press any key, the number following Hit any key to stop autoboot: in this screen is decreased by one per sec. When the counter reaches to zero, tftp;go 0x0c command runs automatically. If you press any key before counter value 0, then prompt appears. Welcome to MICETEK World! M(icetek)B(oot)L(oader) v1.0.2 (Jan :43:45) MBL code range: 0x0c > 0x0c71764c DRAM Configuration: Bank #0: start 0x0c MB FLASH Configuration: Bank: 2 MB Hit any key to stop autoboot: 0 The initial screen shows such various information as version, MBL code range, SDRAM size and base, FLASH memory size and so on Help Press help or? or h', then you can find all possible commands that MBL supports. MICETEK International Inc., 11/28

12 help go - start application at address 'addr' run - run commands in an environment variable bootm - boot application image from memory bootp - boot image via network using BootP/TFTP protocol tftpboot- boot image via network using TFTP protocol and env variables ipaddr and serverip rarpboot- boot image via network using RARP/TFTP protocol bootd - boot default, i.e., run 'bootcmd' loads - load S-Record file over serial line loadb - load binary file over serial line (kermit mode) autoscr - run script from memory md - memory display mm - memory modify (auto-incrementing) nm - memory modify (constant address) mw - memory write (fill) cp - memory copy cmp - memory compare crc32 - checksum calculation base - print or set address offset printenv- print environment variables setenv - set environment variables saveenv - save environment variables to persistent storage protect - enable or disable FLASH write protection erase - erase FLASH memory flinfo - print FLASH memory information bdinfo - print Board Info structure iminfo - print header information for application image loop - infinite loop on address range mtest - simple RAM test icache - enable or disable instruction cache dcache - enable or disable data cache reset - Perform RESET of the CPU echo - echo args to console sleep - delay execution for some time usb - USB download with verbose info version - print monitor version help - print online help? - alias for - quick boot If you want to know about a specific usage of a command, then press help command. help md md [.b,.w,.l] address [# of objects] - memory display printenv Showing the environment value stored in Flash memory. MICETEK International Inc., 12/28

13 printenv bootargs=devfs=mount root=ramfs console=ttys0, bootcmd=tftp;go 0x0c baudrate= ethaddr=08:00:3e:21:c7:f8 ipaddr= serverip= netmask= bootfile="linux_bootram.bin" loadaddr=0x0c bootdelay=9 rootdelay=7 Environment size: 255/65532 bytes bootcmd : the environment value which runs automatically after counter value zero. When the counter reaches zero, if no keys are pressed, MBL starts to find the command in bootcmd variable. Then MBL performs the command in bootcmd variable. baudrate : UART speed rate. The unit is bps. ethaddr : This is the Ethernet MAC address of the EV44b0-II board. bootfile : This value is used for tftpboot command. If users execute tftpboot command without any information, then MBL will download a file depicted in bootfile variable. bootdelay : the counter value which is the default number MBL delays and automatically runs bootcmd. ipaddr : IP address of EV44b0-II board serverip : IP address of host computer which is a tftp server netmask : netmask value setenv Setting the environment variables that are in SDRAM now. setenv bootdelay 4 printenv bootargs=devfs=mount root=ramfs console=ttys0, bootcmd=tftp;go 0x0c baudrate= ethaddr=08:00:3e:21:c7:f8 ipaddr= serverip= netmask= bootfile="linux_bootram.bin" loadaddr=0x0c bootdelay=4 MICETEK International Inc., 13/28

14 After changing the value in SDRAM, input printenv and press Enter to confirm values saveenv Saving the values from SDRAM to Flash memory. You should use saveenv to save the environment values to Flash memory. saveenv Un-Protected 1 sectors Erasing sector 4... ok. Saving Environment to Flash...done. Protected 1 sectors md Displaying the memory contents. If you set the optional [.b.w.l] explicitly, the optional must follow md command and there are no spaces between them. (eg md.b 0x0c ) help md md [.b,.w,.l] address [# of objects] - memory display md : ea e59ff014 e59ff014 e59ff b : displaying the memory contents in the unit of byte(8-bit).w : displaying the memory contents in the unit of word(16-bit)..l : displaying the memory contents in the unit of double word(32-bit) and it is the default optional. The last argument is the length that is to be displayed. md.b : ea 14 f0 9f e5 14 f0 9f e5 14 f0 9f e : 14 f0 9f e5 14 f0 9f e5 14 f0 9f e5 14 f0 9f e : c c 0c c c : MICETEK International Inc., 14/28

15 md.w : 0012 ea00 f014 e59f f014 e59f f014 e59f : f014 e59f f014 e59f f014 e59f f014 e59f : c c00 000c 0c c : c c00 001c 0c00 beef dead : c c c71 c0de 0bad..p...p.Pwq : 0000 e10f 001f e3c e380 f000 e129...) : 0015 eb mw Writing a value into a specific memory address that must be writable. If you set the optional [.b.w.l] explicitly, the optional must follow mw command and there are no spaces between them (eg mw.w 0x0c ). If you try to modify the value in ROM, this operation is in invalidation. help mw mw [.b,.w,.l] address value [count] - write memory mw 0x0c md 0x0c c000000: b4a3db =Jk If count isn t set, its default value is mm The mm command modifies memory at the address, and at the same time the address automatically increases 1 unit, which consist to the optional. If you set the optional [.b.w.l] explicitly, the optional must follow md command and there are no spaces between them(eg mm.b 0x0c ). And after you modify the value of the current addr, the addr increases as follows: if you selected.b, the addr automatically increase 1(byte). if you selected.w (the default optional), the addr automatically increase 2(word). if you selected.l, the addr automatically increase 4(long). MICETEK International Inc., 15/28

16 help mm mm [.b,.w,.l] address - memory modify, auto increment address mm 0x0c c000000: ? 3 0c000004: ? 2 0c000008: ? md 0x0c c000000: nm The nm command modifies memory at the address until you abort it by Ctrl+c. If you set the optional [.b.w.l ] explicitly, the optional must follow md command and there are no spaces between them.(eg nm.b 0x0c ). help nm nm [.b,.w,.l] address - memory modify, read and keep address nm 0x0c c000000: ? 1 0c000000: ? c000000: ? md 0x0c c000000: E# cp Copying data from source address to destination address according to the counter value. If you set the optional [.b.w.l] explicitly, the optional must follow md command and there are no spaces between them (eg cp.b 0 0x0c ). help cp cp [.b,.w,.l] source target count - copy memory cp.b 0 0x0c md.b 0x0c c000000: md.b : MICETEK International Inc., 16/28

17 cmp Comparing data of addr1 with data of addr2 to an extent of count value. If you set the optional [.b.w.l ] explicitly, the optional must follow cmp command and there are no spaces between them(e.g. cmp.b 0x0c ). help cmp cmp [.b,.w,.l] addr1 addr2 count - compare memory cmp 0 0x0c Total of 2 words were the same crc32 Calculating crc32 checksum. help crc32 crc32 address count - compute CRC32 checksum crc32 0c0x0c CRC32 for c c1 ==> e erase Erasing the contents of Flash memory. There are 4 ways of erasing. 1) Using address of Flash memory. Start and End address should be in the same sector in Flash memory. 2) Using sector numbers of Flash memory. N means the bank value. We have one bank for Flash memory, N is 1. 3) Using bank number. There is only one bank for flash memory, so bank value should always be 1 in current board. 4) Erasing full flash memory. MICETEK International Inc., 17/28

18 help erase erase start end - erase FLASH from addr 'start' to addr 'end' erase N:SF[-SL] - erase sectors SF-SL in FLASH bank # N erase bank N - erase FLASH bank # N erase all - erase all FLASH banks flinfo This shows the information about flash memories in EV44b0-II board. When you put the command flinfo, you can get the following information: current memory types, sizes, and addresses for each sector. In the below figure, the symbol (RO) means read-only. The memory space of ready-only can include MBL code and environment variables. help flinfo flinfo - print information for all FLASH memory banks flinfo N - print information for FLASH memory bank # N flinfo Bank # 1: FUJITSU: MBM29LV160TE (16Mbit) Size: 2 MB in 35 Sectors Sector Start Addresses: (RO) (RO) (RO) A B C D E F A B C D E F F FA FC protect It can decide whether each sector of flash memory is read-only or writable. The usage is similar to `erase command. Protect on can set each sector read-only. Contrary protect off can set each sector writable. And the address start and end must lie in the same sector. MICETEK International Inc., 18/28

19 help protect protect on start end - protect FLASH from addr 'start' to addr 'end' protect on N:SF[-SL] - protect sectors SF-SL in FLASH bank # N protect on bank N - protect FLASH bank # N protect on all - protect all FLASH banks protect off start end - make FLASH from addr 'start' to addr 'end' writable protect off N:SF[-SL] - make sectors SF-SL writable in FLASH bank # N protect off bank N - make FLASH bank # N writable protect off all - make all FLASH banks writable protect on ffff Protected 1 sectors bdinfo It gives us the current board information: MAC address, IP address, serial baud rate, architecture number, address of environment table, boot parameters, the address of RAM which stores environment variables, and SDRAM address after remapping. bdinfo enetaddr = 08:00:3E:21:C7:F8 ip_addr = baudrate = bps arch_number = 189 env_t = 0C boot_params = DRAM:00.start = 0C DRAM:00.size = iminfo It gives us the information of MBL image. You can usually use this command when you want to confirm whether the download image is correct after you download MBL image by tftp. MICETEK International Inc., 19/28

20 help iminfo iminfo addr [addr...] - print header information for application image starting at address 'addr' in memory; this includes verification of the image contents (magic number, header and payload checksums) mtest It is the memory test command by writing/reading data in address 7Mb space from 0x0c If you abort it, please press Ctrl+c. mtest Writing: , Reading: Writing: , Reading: Writing: , Reading: Writing: , Reading: Writing: , Reading: Writing: , Reading: Writing: , Reading: usb The usb command is that by the USB port you may download a bin file to the specified address. The default address is 0x0c Input usb, the following information will occur. help usb usb [load addr] [verbose level], '0' for no debug, '1' for print some debug info... usb Ev44B0II USB driver v /01/09 Qinwei, MICETEK Shanghai Open USB Port! And then, by hand open ev44b0ii CD\usb\UsbDownload.exe; open open bin file dialog box. Select a bin file and click ok (the optional verify means whether verify download image or not). When the downloading procedure is successful, select exit to close the dialog. And then input go 0x0c to run the downloaded bin file. The following information is closely to the above. MICETEK International Inc., 20/28

21 Download file name: "C:\Documents and Settings\administrat..." File length: Load address: 0x0C Loading(without verify):...download OK. Close USB Port! go 0x0c S3C44B0X Test Program Ver 0.00 rsyscfg=0xe MCLK= :Touch Panel 1:Cache 2:keyboard 3:UART 0 4:UART 0 FIFO 5:UART 1 6:UART 1 FIFO 7:USB TEST 8:etnernet test 9:SLOW Mode 10:HOLD Mode 11:STOP Mode 12:Zdma0 13:Zdma1 14:WDTimer 15:RTC(display) 16:RTC(Test) 17:RTC Tick 18:IIC(KS24C080) 19:RecIIS_uda :IIS(uda1341) 21:Etc... 22:Change PLL 23:Test AFC(Tx) 24:Test AFC(Rx) 25:flash writer 20ef,1f,3f,SAT,3f:7f:60 Select the function to test? Now you may test the listing options (About how to test EV44b0II, please refer EV44B0 test manual). If you want to return, please press reset button on the EV44b0-II board icache Instruction cache is enabled or disabled by its switch. help icache icache [on, off] - enable or disable instruction cache icache on Instruction Cache is ON dcache Data cache is enabled or disabled by its switch. help dcache dcache [on, off] - enable or disable data (writethrough) cache dcache off Data (writethrough) Cache is OFF MICETEK International Inc., 21/28

22 reset It is the command that reloads the MBL code. And its function is similar to press reset button on the EV44b0-II board. reset Welcome to MICETEK World! M(icetek)B(oot)L(oader) v1.0.2 (Jan :43:45) MBL code range: 0x0c > 0x0c71764c DRAM Configuration: Bank #0: start 0x0c MB FLASH Configuration: Bank: 2 MB Hit any key to stop autoboot: sleep It is the command that makes system in sleep status for designated seconds. It can increase the system stability for us to insert this command among commands. help sleep sleep N - delay execution for N seconds (N is _decimal_!!!) sleep version It displays the version information. help version version - No help available. version M(icetek)B(oot)L(oader) v1.0.2 (Jan :43:45) MICETEK International Inc., 22/28

23 go It is an instruction to move PC (program counter) to an assigned address with parameter. Its sample refers to usb command. go 0? Welcome to MICETEK World! M(icetek)B(oot)L(oader) v1.0.2 (Jan :43:45) MBL code range: 0x0c > 0x0c71764c DRAM Configuration: Bank #0: start 0x0c MB FLASH Configuration: Bank: 2 MB Hit any key to stop autoboot: run When this command is typed to environments variable, it is operated as a run command. printenv bootargs=devfs=mount root=ramfs console=ttys0, bootcmd=tftp;go 0x0c baudrate= ethaddr=08:00:3e:21:c7:f8 ipaddr= serverip= netmask= bootfile="linux_bootram.bin" loadaddr=0x0c bootdelay=4 Environment size: 243/65532 bytes run bootcmd EV44B0II ethernet driver v /01/08 by Qinwei, MICETEK Shanghai In environments variable, tftp;go 0x0c indicates bootcmd. Therefore, run bootcmd executes tftp and go 0x0c With this function, the user can make batch function for a useful command bootm bootm loads linux kernel to memory and then move PC to execute kernel. It interprets MBL image to detect the addresses of loaded image and TEXT executed. At first, after making MBL image in Host, copy it to tftpboot. MICETEK International Inc., 23/28

24 ~/MBL/tools]$ mkimage.sh linux.bin.gz gzip mkimage -A arm -O linux -T kernel -C gzip -a e n uclinux - d linux.bin.gz linux.bin.gz.img Image Name: uclinux Created: Tue Jul 30 14:16: Image Type: ARM Linux Kernel Image (gzip compressed) Data Size: Bytes = kb = 0.45 MB Load Address: 0x Entry Point: 0x Header Checksum: 0x12c58ed7 Data Checksum: 0x67e26ade [jipark@laminaz ~/MBL/tools]$ cp linux.bin.gz.img /tftpboot In target, it downloading the compressed image and then executes bootm as a parameter with the received address. tftp linux.bin.gz.img BootFile [linux.bin.gz.img], Load addr [0x500000] ARP broadcast 1 eth addr: 00:03:47:e0:87:a2 Got good ARP - start TFTP Server ethernet address 00:03:47:e0:87:a2 TFTP from server ; our IP address is Filename 'linux.bin.gz.img'. Load address: 0x Loading: ********************T**************************************** ***********************done Bytes transferred = (720d4 hex) bootm ## Booting image at Image Name: uclinux Image Type: ARM Linux Kernel Image (gzip compressed) Data Size: Bytes = 456 kb = 0 MB Load Address: Entry Point: Verifying Checksum... OK Uncompressing Kernel Image... OK No initrd ## Transferring control to Linux (at address )... Starting kernel... Linux version uc0 (root@laminaz) (gcc version (release)) # :33:54 KST bootd This command executes a script. By default, i.e., run 'bootcmd' MICETEK International Inc., 24/28

25 bootd EV44B0II ethernet driver v /01/08 by Qinwei, MICETEK Shanghai bootp Boot image via network using BootP/TFTP protocol help bootp bootp [loadaddress] [bootfilename] Tftpboot The tftpboot command is same with tftp. Its function is download the file assigned and save it to memory. tftp linux.bin.gz.img BootFile [linux.bin.gz.img], Load addr [0x500000] ARP broadcast 1 eth addr: 00:03:47:e0:87:a2 Got good ARP - start TFTP Server ethernet address 00:03:47:e0:87:a2 TFTP from server ; our IP address is Filename 'linux.bin.gz.img'. Load address: 0x Loading: ************************************************************ ********TT****************T******************done Bytes transferred = (720d4 hex) The first parameter is the address of the memory to save. The address is Hexadecimal. The second parameter is the file name to be received from tftp server. The * display during the file receiving, and T means time out. To cancel download, type Ctrl+c rarpboot Boot image via network using RARP/TFTP protocol help rarpboot rarpboot [loadaddress] [bootfilename] MICETEK International Inc., 25/28

26 loadb This command is useful to download the file when you have no ethernet. This uses Kermit protocol. The first argument is the address where the program will be downloaded. The process is described as follows: First, input loadb 0x0c and press Enter. Second, select the send item from transfer menu. Third, from the pop dialog select an input file and Kermit protocol and send it. help loadb loadb [ off ] [ baud ] - load binary file over serial line with offset 'off' and baudrate 'baud' loadb 0x0c ## Ready for binary (kermit) download... ## Start Addr = 0x0c The figure shows the screen shot of PC when you send the file using Kermit loads The executing procedure of this command is similar to that of loadb, the file to load must be S-Record file. help loads loads [ off ] - load S-Record file over serial line with offset 'off' loads 0x0c ## Ready for S-Record download... <INTERRUPT> MICETEK International Inc., 26/28

27 autoscr Run script from memory help autoscr autoscr [addr] - run script starting at addr. A valid autoscr header must be present base Print or set address offset help base base - print address offset for memory commands base off - set address offset for memory commands to 'off' base Base Address: 0x base 0x Base Address: 0x base 0x Base Address: 0x base off Base Address: 0x base Base Address: 0x echo Echo args to console help echo echo [args..] - echo args to console; \c suppresses newline MICETEK International Inc., 27/28

28 Update MBL or Save user program on FlashROM Boot up MBL, use tftp 0x0c EV44B0_MBL.bin command to load the bin file to default address, then use update 0x0 to save the downloaded file to 0x0(flash start address). And you also can use update 0x to save the downloaded to 0x10000(for save user program on flash). Welcome to MICETEK World! M(icetek)B(oot)L(oader) v1.0.2 (Jan :09:41) MBL code range: 0x0c > 0x0c717a98 DRAM Configuration: Bank #0: start 0x0c MB FLASH Configuration: Bank: 2 MB Hit any key to stop autoboot: 0 tftp 0x0c EV44B0_MBL.bin EV44B0II ethernet driver v /01/08 by Qinwei, MICETEK Shanghai ARP broadcast 1 Server eth addr: 00:05:5d:60:f8:bc TFTP from server ; our IP address is Filename 'EV44B0_MBL.bin'. Load address: 0xc Loading: ***************** done Bytes transferred = (144f1 hex) update 0x0 Erasing sector 0... ok. Erasing sector 1... ok. Saving Image to Flash...done. update 0x Erasing sector ok. Erasing sector ok. Saving Image to Flash...done. flinfo Bank # 1: FUJITSU: MBM29LV160TE (16Mbit) Size: 2 MB in 35 Sectors Sector Start Addresses: (RO) (RO) (RO) A B C D E F (RO) (RO) A B C D E F F FA FC000 MICETEK International Inc., 28/28