User Guide for Running a Project on the Embest Board
Contents
1. Figure 7 The Disassembly View 2 4 5 Stopping and Disconnecting the Project In order to terminate the board host connection go to the Debug menu and select the Disconnect option Then turn off the power switch Page 7 Last Update July 2010 Embest IDE Pro Education Edition Disassembly File Edit View Project Build Debug Tools Window Help DISAGIG RBS SESYSA a Geese P eee ali E a Workspace ProjectGuide1 m 5 a ProjectGuide1 files SM Disassembly b Embest ci ine Project Source Files 6x 606680668 6x 66666664 6x 66666668 6x 6666866c 8x 66686616 6x 66866614 6x 66666618 6x6668661c 6x 66666626 6x 68668624 8x 66666628 6x 6666862c 6x 66686638 B H MnsertArm1 s equ SWI_CheckBlue 6x263 Blue button constants equ BLUE 8 equ BLUE_1 memwrite success l gt memurite 6x61C086624 6x66866459 menwrite success gt memwrite 6x61C86628 6x66666616 memwrite success gt memwrite 6x61C8662C 6x66666626 memwrite success gt memwrite 6x61C86636 6x66666626 memwrite success Ln 1 Col 1 DOS Read NUM A Figure 8 Downloading Page 8 Last Update July 2010 Appendix 1 Description of the Embest University board The Embest University board consists of two parts the Main Board and the board with the LCD and Key board as shown in Figure 9 LCD SCREEN WWWEMBEDINFOOOM EMBEST INFOXTECH CO LTD Figure 9 The Layout of the Embest University Board2. The Main Board includes several peripheral components listed in Table 1 Table 1 Some of the Peripheral Components of Embest University Board Label Component 8 SE 8 Segment Display IDE External IDE port EarPhone Earphone Output MicroPhone Microphone Input Ethernet 10M Ethernet Interface Connector USB USB Connector LCD 320 240 mono LCD Screen Display POWER External Power Button RESET Reset Button UART Universal Asynchronous Receiver Transmitter Page 9 Last Update July 2010 The structure of the Main Board is shown in Figure 10 ROM IDE FLASH UART1 UARTO l memory x 7 di N va Gi LA TI s a driver w W 8 SE t EARPHONE SW1 SW2 MICRO p PHONE k LINK ETHERNET connector 1 i KEYBOARD controller sa Fe i pi N n ye i LINK controller MEN Q 1 R an USR gt a a x X ae SWw3 _ gt SWA 6 POWER a 5102 No om TO ene i I NE MAK KAKA AM AR YA DA JTAG RESET LED1 SB2 N ARM LED2 SB3 SDRAM EXTEND PROCESSOR Figure 10 The Structure of the Embest University Board Page 10
3. can be accomplished in two steps 1 In the Workspace window right click the folder Project Source Files and select Add Files to Folder Page 3 Last Update July 2010 2 Locate and select the InsertARM1 s file The file will appear in the list of files belonging to the Project Source Files folder in the Workspace window Note adding a file to a project creates a reference from the project to the file It does not create a new copy of the file for the project Therefore one needs to be careful if the same file is added to two different projects After addingInsertARM1 s to the ProjectGuidel workspace its code can be viewed in the Source code win dow by double clicking the InsertARM1 s file in the Workspace window The result is shown in Figure 4 Embest IDE Pro Education Edition H AlnsertArm 1 s File Edit View Project Build Debug Tools Window Help Osugi selecta ea S FORO 0 8 BRBERE Esanssaas all Bi H lnsertArm1 s r t E Workspace ProjectGuide1 GFile name InsertArmi s oe ProjectGuide1 files Function This file is used to demonstrate how to use the Embest G Project Source Files a 44binit s 2 ethernet s 8 Segment display code equ SWI_SETSSEGMENTDISPLAY 6x266 interrupt s LED codes keyboard s equ LEFT_LED 6x 62 Icd s equ RIGHT_LED 6x 61 antan GSWI timer code pors equ SWI_TIMER Bx6d segment s equ FUEL_TIME 1666 speaker s SWI codes for buttons i equ SWI_CheckBlack a
4. four stages as shown schematically in Figure 1 1 Open the previously prepared project using the Embest IDE 2 Add the assembly source file to the project 3 Build the project 4 Execute the project on the Embest University board The following sections present detailed explanations of each step This documentation is intended to walk a new user through the steps above using as an example an assembly source file called InsertARM1 s into a pre viously prepared Embest IDE project called ProjectGuide1 i 2 1 Opening a Previously Prepared Project To start the Embest IDE application select the folder reached by Start Menu Programs EmbestIDE Pro Education Edition for ARM and from inside this folder select gt EmbestIDE Pro Education Edition for ARM The Embest IDE should start appearing as shown in Figure 2 Step 1 Step 2 Step 3 Step 4 Open a pre Add the Build the Execute the pared project ye source file to project with project with with the Emb the project in the Embest the Embest est IDE the Embest IDE University IDE Board Figure 1 Embedding ARM assembly code into a pre prepared project 1 The local user can download ProjectGuide1 from the Resources section of the web pages Important note The project folder should be downloaded onto the user s locally allocated space i e the H drive Page 1 Last Update July 2010 Embe
5. the Project for the Download At the top of the Embest IDE overall window click on the Project dropdown menu and select the settings option The Project Settings window will appear as shown in Figure 5 Select the tab labelled Debug A text field labeled Symbo File will appear Click the button beside this text field see Figure 5 and locate and select the ProjectGuidel elf file Project Settings Settings For Workspace ProjectGuide1 oe ProjectGuidel files 4 9 Project Source Files G Project Header Files Symbol file H ProjectGuide1 debug ProjectGuide1 elf Action after connected C None click this button to specify C Auto download the output file for debug Command script H ProjectGuide1 src ev40boot cs zi OK Cancel Figure 5 Project Settings Dialogue Window Next select Download in the Category dropdown menu as shown in Figure 6 To confirm the new settings click the OK button at the bottom of this dialogue window Page 5 Last Update July 2010 Project Settings Settings For Processor Remote Debug Directory Compiler Assemb 4 s Workspace ProjectGuide1 O OOOO ekea ProjectGuidel files Category Download i A H Project Source Files r H Project Header Files ADownload file H ProjectGuide1 debug ProjectGuide1 elf Download verify A L Download address Execute program trom ox0coo0000 Don t pate O Download address Zo Program entry point C
6. Last Update July 2010 User Guide for Running a Project on the Embest Board Li Yu M Serra S Lee Cultura Department of Computer Science University of Victoria 1 Overview The Embest University board is a development board for embedded systems which is used with the Embest IDE Integrated Development Environment The board is based on the ARM 7TDMI cote processor It is par ticularly suitable for use in university courses at both the undergraduate and graduate levels in computer science computer engineering and electrical engineering The IDE supports embedded software development on the Embest board Through its graphical user interface it facilitates managing and building projects as well as allow ing applications to be run and debugged This guide only explains how to integrate an ARM assembly file into a previously prepared Embest IDE project A separate document named Guide for Building a New Project on the Embest Board describes how to prepare a new project using the Embest IDE Appendix 1 contains a description of the Embest University development board A set of companions Power Point slides is also available to be used in a lab environment This document assumes a basic knowledge of ARM assembly language and the ARM architecture 2 Embedding ARM Assembly Code into an Embest Project Integrating an ARM assembly language source file into a previously prepared project for the Embest IDE can be accomplished in these
7. M Project Header Files Se SS K3 m gt Blue button constants equ BLUE_8 equ BLUE 1 Find in Files l Ln 1 Col 1 Figure 4 After adding the source file InsertArm1 s 2 3 Building the Project Once the file Insert ARM1 s has been added to the project as above the workspace is ready to be built In this context building a project implies assembling and linking all the files within it ready to be downloaded and executed To build a workspace go to the Build dropdown menu item top border of the overall window and select Rebuild All Provided that no errors occur when building the project the output message Command s success fully executed appears in the Output window with the tab Build refer to the bottom of Figure 2 In addition Page 4 Last Update July 2010 this stage also produces a file called ProjectGuidel elf the f extension indicates the executable linking file for mat ProjectGuidel elf is the file to be downloaded into the memory space of the Embest board It is created inside the project s folder as listed in the Workspace window 2 4 Executing the Project on the Board The final stage is to download and execute the project on the Embest board For clarity this stage is divided into four steps as 1 Prepare the project for download 2 Connect to the Embest University board 3 Download the executable to the board 4 Run the project 2 4 1 Preparing
8. he Szatws border will display the message Info download completed 2 4 4 Running the Project Running the project means using the Embest University board to execute the code and interact with the board component as the application requires Once the project has been successfully downloaded go to the Debug menu and select the Go option The executable should begin running on the board Page 6 Last Update July 2010 Embest IDE Pro Education Edition Disassembly DAR D SAGGKDREBSQZS BBA ABIAK2RSK GQELZSOB S9S8PCou sYSEAADAAB BS AsesaA B H insertArm1 s a 9 Workspace ProjectGuide1 JE S E ProjectGuide1 files Sf Disassembly A Project Source Files 44binit s 6x 66666664 6x114 8x 68666668 6x12c chemet 8x 8888888c 9x15c InsertArm1 s 9x00009910 9x144 interrupt s 6x 66888614 6x14 keyboard s 6x 68666618 Sxfc 6x6868861c Gxey 6x66666626 pe pc 58c 6x66666624 pe pc 58c 6x 66666628 pe pc 58c 6x 6686862c pe pe 58c 6x66666636 pc pc 58c Dre woe H E Project Header Files equ SWI_CheckBlue 6x2 63 lt a m A Blue button constants equ BLUE_8 equ BLUE_1 A memwrite success gt memwrite 6x61C86624 6x68866459 memwrite success gt memwrite 6x61C86628 6x66666616 memwrite success gt memwrite 6x61C8662C 6x66666626 memwrite success gt memwrite 6x61C86636 6x66666628 memwrite success Command Find in Files 1 Fi Ln 1 Col 1 pos Read NUM
9. lick this button to speafy the output file for download cnc Figure 6 Project Setting for Download Execute until 2 4 2 Connecting to the Embest University Board Prior to turning on power to the Embest University board ensure that all connections including the serial port line between the board and PC host as well as the board s external power supply ate properly attached Consult the illustrations in Appendix 1 Use the power switch labeled SW3 in Appendix 1 to turn the power on The next step is to establish communi cation between the Embest IDE and the board Choose the Debug dropdown menu in the main window and select the Remote Connect option If the connection is successfully established the Output window will display the message memwrite success and the Embest IDE will switch its status to Disassembly as shown in Figure 7 If however the board and Embest IDE fail to establish a connection an error message will appear in the Output window under the tab Debug 2 4 3 Downloading the Executable to the Embest University Board Now that the board and the Embest application are successfully connected the executable file can be copied onto the boards memory space To download ProjectGuidel elf go to the Debug menu tab and select the Download option A loading bar appears at the bottom of the Embest IDE while the elf file is being down loaded This is illustrated in Figure 8 below When the download is complete t
10. s Various tabs are also available depend ing on the current use see below Page 2 Last Update July 2010 Workspace Window Output Window Source Code Vindow Embest IDE Pro Education Edition BAR ole aglaj e cea A JE AB AKI n BLSOE VON GE Sila os a we a hi amp Top Menu and Toolbar a 6 Workspace ProjectGuidel S E ProjectGuide1 files 2 Project Source Files G Project Header Files Status Bat Figure 3 After opening the project ProjectGuidel Exploring further the sample ProjectGuidel select the Files tab available at the bottom border of the Work space Window There are two sub folders in the ProjectGuidel workspace Project Source Files and Project Header Files These folders each contain a collection of files which are used by the project builder software to connect to various components of the Embest board For example the 1cd s source file in the Project Source Files folder and the 1cd a archive file in the Proj ect Header Files folder are associated with the LCD screen functionality on the Embest board In this pre pared project all these files have been constructed in advance and can thus be ignored for the moment Further explanation on how to implement these files will be available in Part 2 of this document 2 2 Adding an Assembly Source File to the Project The second stage is to integrate the assembly language source file InsertARM1 s into the ProjectGuidel project This
11. st IDE Pro Education Edition DAR SEA 4 e A eee A 24 No Functions o gt N Buila Fis OVR Read NUM 4 Figure 2 Startup window of the Embest IDE To open the sample project for this guide namely ProjectGuidel first select File gt Open Workspace A pop up window appears Locate the ProjectGuide1 folder by navigating to its location and then select the file called ProjectGuidel ews The ews extension stands for Embest Workspace Upon completion the Embest IDE should resemble Figure 3 It is assumed here that the sample project has been saved on a user drive The Embest IDE has several components each with different functionality The top Menu follows the usual pat tern containing several submenus such as File Edit and Build At the top right there is a Toolbar for the most commonly used tools The top left window is the Workspace Window displaying information regarding files in the current open project The top right window is the Source Code Window where the user views and edits code The bottom Ouzput Win dow displays the status of the project being built file search output information command line input and output information depending on the current use At the very bottom the Szazus border displays detailed information for the current use of the menu and tool bars as well as the cursor s current line and column number in the Source Code Window when in use In Figure 3 it simply shows the Ready statu
Download Pdf Manuals
Related Search