263 ECE Lab 2
Programming & Cosmic
Lab 2
Programming & Cosmic Spring 09
Page 2 of 5
Object: For this lab you will be using the Cosmic CX6811 Integrated Development Environment (IDE). The IDE is a graphical interface which combines all of the software tools needed to enter a source program in either assembly language or in C, a C compiler, an Assembler, a linker, and a simulator. For this lab you will be using the editor to generate a text file containing the assembly language source file, then you will convert the source program into machine language using the assembler and linker. Finally, you will debug your program using the simulator. Material: You will need the HC11 Programming Reference Manual and a USB memory stick to save your project. Preparation: Before coming to the lab you must have Programming Assignment 3 (Sort Program) completed and entered into text file using a simple text editor such as Microsoft Notepad - do not use Microsoft WORD. Note: If you do not have the completed source code for this program do not bother to come to lab - you will be asked to leave and return when it is ready.
Lab: Working with your assigned lab group, complete the following steps. 1. Start the Cosmic software by double clicking on the COSMIC CX6811 icon on the Windows desktop. 2. The IDE (aptly named IDEA6811) will start and show the main screen. On the top line, click on PROJECT, then in the drop down menu click on NEW: this will bring up the Project Navigator which is a set of selections on the left side of the screen. These selection make up the elements of the project. 3. Click on PROJECT again, then click on WORKING DIRECTORY in the drop down menu. 4. In the pop-up window, select a working directory in one of the following locations: on the USB memory stick or in a sub-folder on you engineering account. You will point to an existing directory in one of those locations so you need to use Windows Explorer or My Computer to create the folder before you do this step. Typically you will create a new folder for each project to keep your work organized. In the Project Navigator, make sure that the working directory appears. As you add files to the working directory, they will be listed here. Note: You will not be able to store your work on the hard drive of the computer you are using.
Lab 2
Programming & Cosmic Spring 09
Page 3 of 5
5. You should now make sure the text file containing your program is in the directory that you just specified as the WORKING DIRECTORY and that it has a .s extension. Note: The following instructions refer to file names as <filename>. Replace <filename> with a name of your choice, such as Lab2_xx (use your initials in place of the xx), and the extension specified. You should avoid the use of spaces in any file names - Cosmic can get confused. Be sure to include the assignment name, your name(s), and the date as comment lines at the beginning of all Lab programs.
6. Click on PROJECT again, this time select ADD FILE and select the source file for your program. 7. In cases where you want to use the text editor in Cosmic to create the source file you would do the following: Click on FILE, then NEW. In the pop-up window, select Assembly Source File. When you hit OK the text editor will open and you can use it to enter the program. 8. When you have finished entering the entire program save it by clicking on FILE, then SAVE AS. You will be asked for a file name and a location to store the file - save it in your working directory. The system will and append a .s extension to the file name you entered. The .s extension is the way that the IDE identifies that the file is an assembly language source file. A "C" source file would have a .c extension. Note: You can create the file with any text editor - just be sure to save the file with the extension .s not .txt. You will have to be careful if you use Microsoft Notepad because it has the tendency to always append a .txt even if you specify something else. 9. In the Project Navigator, right click on SOURCE FILES then select ADD FILE. In the popup window, go select the <filename>.s file you just created with the text editor. You should see the file name appear below the SOURCE FILES. If you click on the + in front of the filename, it opens file specific information related to that file. 10. In the Project Navigator, click on the TOOLS selection at the bottom of the window. In the TOOLS menu, click on the + in front of ASM CA6811. Right click on the OPTIONS selection. This opens a dialog box where you set up the command line options to be used when the CA6811 Assembler program is called. These options are global in scope and will affect all files with a .s extension. 11. In the GENERAL ckeck all four selections. At the bottom of this window you can see the command line built being - you should see ca6811 -xx -x -a -v
Lab 2
Programming & Cosmic Spring 09
Page 4 of 5
12. In the LISTING section, highlight OUTPUT A LISTING: -l (lower case L) should be added to the command line window. 13. In the MISCELLANEOUS section, select ACCEPT OLD MOTOROLA SYNTAX then click on OK. 14. Now left click on the + in front of LINKER then right click on CREATE COMMAND FILE. This opens a file named untitled.lkf which we need to edit. Edit the default linker command file by first deleting all of the lines in the file. Next enter the name of the file and add a .o extension, e.g. <filename.o>. The .o extension indicates to the IDE the the file is an object file. When you have finished, save the edited file as <filename>.lkf. The linker is normally used to resolve the absolute memory addresses from a number of object files and/or library functions and combine them into a single load file. Since you only have a single file and you have already set the memory address by means of the ORG assembler directive, we are shortcutting the functions performed by the linker program. 15. Now right click on the OPTIONS selection under LINKER. In the pop-up window, check the box next to the Output to File and then enter <filename>.h11. Check the box in front of Command File and enter <filename>.lkf. Finish the selection by clicking on OK. 16. Now left click on the + in front of BUILDER then right click on OPTIONS. In the pop-up window check the box labeled CONVERT TO S_RECORDS then click on the OPTIONS box. In the next pop-up window, check the box labeled OUTPUT TO FILE, then enter <filename>.s19 in the blank space. Click on OK to close the window and then repeat for the next window. 17. At this point all of the settings for your project are complete so you should save the project. Select PROJECTS from the top line and then select SAVE AS and enter <filename>.prj 18. The icons at the top of the window are shortcuts for various operations. The icon that looks like a white/green ice cream sandwich is the command to compile or assemble your program, depending on the extension of the file that is highlighted. The program will try to compile/assemble whatever file is highlighted. If the highlighted file is not appropriate, such as the linker control file, nothing happens and there is no error indication and no entry in the error file. 19. The two icons next to the COMPILE icon are BUILD and RE_BUILD ALL. The REBUILD ALL runs all of the processes (compiler/assembler, linker, etc) one after the other and creates all new output files. The BUILD command only recompiles any file that has changed since the last build and then only runs the rest of the process if a new object file exists..
Lab 2
Programming & Cosmic Spring 09
Page 5 of 5
20. If the ERROR window is not currently displayed, click on the WINDOWS selection at the top of t...