QuickStart for Keil µvision 2 Microcontroller IDE

Transcription

1 QuickStart for Keil µvision 2 Microcontroller IDE 1. Introduction The following steps show how to start a new project for the Infineon C167 Microcontroller using the Keil µvision 2 IDE (Integrated Developing Environment). Developing software for the C167 Microcontroller requires: the C167 Development Board a DB-9 serial cable an AC adapter supplying 8-13 V / min. 300 ma an IBM-compatible host-pc (Windows 9x/NT) the Keil µvision 2 Tool Chain (only Evaluation version required) Please go carefully through the following steps to get a working application! 2. Creating a new Project 2.1 First steps Before you begin to start a new project for your microcontroller you should do the following: 1. Connect the C167 Development Board (P1) to the serial interface of your host-pc (COM 1 or COM 2). 2. Connect the C167 Development Board (P3) to the Power Supply (please use the available AC-DC Adaptor). 3. Switch on the power, turn on your host-pc and boot Windows 9x or NT. 4. Start the IDE by double-clicking on the icon Keil µvision2 Evaluation Version. 5. Now the Keil IDE appears and automatically opens the last project. 6. Please close these project by selecting Close Project from the menu Project. 2.2 Creating a New Project 1. To create a new project file select from the µvision2 menu Project\New Project.... This opens a standard Windows dialog that asks you for the new project file name. (-> figure A1) 2. Change to the directory in which the project files should be saved in. 3. In the combobox Dateiname, enter the file name of the project you are creating. 4. By pressing Speichern the project files will be created. 5. In the following dialog you can choose the device for your target. Double click on Infineon as manufacturer for the CPU. Now choose the C167CR-LM from the list. (-> figure A2) Press the OK button. 6. To give the target of your project a name select the default Target 1 in the project window and click on it. Change Target 1 into a name you prefer e.g. MM167 and press return. C167 Team - 1 -

2 7. Select the file group Source Group 1 in the Project Window Files page and click on it to change the name into User. 8. Click with the right mouse key in the Project Window to open a local menu. Choose the option Targets, Groups, Files Select the tab Groups / Add Files and type the new group name System Files in the Group to Add: section. (-> figure A3) 10. Click on Add and then on OK. 11. Your project file structure should now look like -> figure A Next you should add source code to your project. Click with the right mouse key on the User group to open a local menu. The option Add Files to Group User opens the standard files dialog. 13. Select the file C_Template.c. Choosing Add adds the C_Template.c file to your current project window. For writing assembler code there is also a file ASM_Template.a66 available. 14. Close the window by pressing Close. 15. Now right click on group System Files and add the File Start167.a66. (You have to change the Filetype to ASM Source file *.a* to see this file). 16. If you want to write assembler code you also must add the files tool_c167.a66 and Reg167neu.inc to your current project (see step 15) (If you select the file Reg167neu.inc and press the Add button a dialog box appears which asks you for the right file type. Please select here Text Document file) 17. Your project window should now look like -> figure A5a or A5b. 18. Now you are able to modify the template files (C_Template.c or ASM_Template.a66) with your own code. To do so you have to double click on C_Template.c or ASM_Template.a66 to open it in the source code editor. 19. Now make your modifications to the code and save it by choosing File/Save or by clicking the floppy disk icon. The following steps are very important to get a properly working application. Please go through them carefully! 20. Select the name of the target. Open the Project/Options for Target xxxx menu and type the settings for the External Memory as shown in -> figure A6 (Make sure that #1 is set to ROM). 21. To configure the output options select the Output tab and activate the Debug Information and Browse Information option. Make also sure that the option Create Executable is selected. 22. The options under the Listing tab don t have to be changed 23. In the C166 tab it is recommendable to set the Warnings to Warninglevel The options under the A166 tab don t have to be changed 25. Make sure that under the L166 Locate tab the option Use Memory Layout from Target Dialog is selected. 26. In the tab L166 Misc the address space 8H-0BH, 0ACH-0AFH, 0B8H-0BBH must be entered under Reserve. Make sure that Warning level 2 is selected (-> figure A7). 27. In the Debug tab the Use of the Keil Monitor-166 Driver must be selected. The Load Application at Startup option should be activated. It s not necessary to acitivate the option Go till main(). 28. Now press the button Settings under the Debug tab. C167 Team - 2 -

3 29. A dialog with the Monitor Driver Settings appears. Select Monitor166 in ROM from the Monitor Configuration box. Make sure that the PC Port Settings are COM1 or COM2 and 9600 Baud. The other options can be left unchanged 30. Click on OK. 31. You are back in the Options for Target xxxx dialog. Click on OK 32. Now you are able to build your current project. Click on the Build Target icon from the tool bar or press F If the program contains any errors, they will be shown in an error dialog box on the screen. 34. If there are no errors, the code is compiled/assembled and linked and the executable code is ready to be downloaded to the board. 35. If a list of errors or warnings appears, use the source code editor to correct them. Save the file and repeat building the project (see step 32). 36. Before downloading the executable code to your board press the Reset (S1) on the Development Board. After one second you can release the Reset (S1) switch 37. Start downloading the executable code by pressing the Debug button on the tool bar or pressing Strg+F5. The small window which now appears can be closed by pressing the OK button. 38. Now the application is written to the RAM of the Development Board 39. Start the application by pressing the Run button on the tool bar or pressing F5 40. You can stop Debugging by pressing the Halt button on the tool bar or pressing Esc. 41. In the following window you must press the Stop Debugging button. 42. To quit the application on your Development Board press Reset (S1). At this point you should be able to write small applications for the C167 microcontroller by using the Keil µvision 2 Microcontroller IDE. C167 Team - 3 -

4 A. Appendix A1. Dialog box: Create New Project figure A1: Create New Project A2. Dialog box: Select Device for Target xxxx figure A2: Select Device for Target xxxx C167 Team - 4 -

5 A3. Dialog box: Targets, Groups, Files figure A3: Targets, Groups, Files A4. Project File Structure figure A4: Project File Structure C167 Team - 5 -

6 A5. Project Windows A5a. Project Window for a C-Project figure A5a: Project Window for a C-Project A5b. Project Window for an Assembler-Project figure A5b: Project Window for an Assembler-Project C167 Team - 6 -

7 A6. Dialog box: Options for Target xxxx / Target figure A6: Options for Target xxxx / Target C167 Team - 7 -

8 A7. Dialog box: Options for Target xxxx / L166 Misc figure A7: Options for Target xxxx / L166 Misc C167 Team - 8 -