CREATING FIRST PROJECT in mikropascal PRO for PIC32

Transcription

1 CREATING FIRST PROJECT in mikropascal PRO for PIC32

2 Project mikropascal PRO for PIC32 organizes applications into projects consisting of a single project file (file with the.mpp32 extension) and one or more source files (files with the.mpas extension). The mikropascal PRO for PIC32 compiler allows you to manage several projects at a time. Source files can be compiled only if they are part of the project. A project file contains: Project name and optional description; Target device in use; Device clock; List of the project source files; Binary files (*.mcl); and Other files. In this reference guide, we will create a new project, write code, compile it in the mikropascal PRO for PIC32 compiler and test the results. The purpose of this example is to make s on the microcontroller s PORTB blink, which will be easy to test. Figure 1: mikropascal PRO for PIC32 IDE 2 mikropascal PRO for PIC32 mikroelektronika

3 Hardware Connection For the purpose of testing this example on a PIC microcontroller, it is necessary to connect hardware as per schematic below. This program causes all the ports to change their logic state. However, in this example, s are, for the purpose of demonstration, connected to PORTB only. E9 10uF RG15 VCC RE5 RE6 RE7 RC1 RC2 RC3 RC4 RG6 RG7 RG8 MCLR RG9 GND VCC RA0 RE8 RE9 RB5 RB4 RB3 RB2 RB1 RB0 RE4 RE3 RE2 RG13 RG12 RG14 RE1 RE0 RA7 RA6 RG0 RG1 RF1 RF0 VCC VCAP RD7 RD6 RD5 RD4 RD13 RD12 RD3 RD2 RD1 PIC32MX795F512L RB6 RB7 RA9 RA10 AVCC AGND RB8 RB9 RB10 RB11 GND VCC RA1 RF13 RF12 RB12 RB13 RB14 RB15 GND VCC RD14 RD15 RF4 RF5 GND RC14 RC13 RD0 RD11 RD10 RD9 RD8 RA15 RA14 GND OSC2 OSC1 VCC RA5 RA4 RA3 RA2 RG2 RG3 VUSB VBUS RF8 RF2 RF3 R1 LD0 RB0 R5 LD4 R2 LD1 R6 LD5 RB1 R3 LD2 R7 LD6 RB2 R4 LD3 R8 LD7 RB3 RB4 RB5 RB6 RB7 Figure 2: Example of hardware connection Prior to creating a new project, it is necessary to do the following: Step 1: Install the compiler Install the mikropascal PRO for PIC32 compiler from the product CD or download it from the MikroElektronika website. Desktop shortcut and start menu shortcut will be automatically created. Step 2: Start up the compiler Start up the mikropascal PRO for PIC32 compiler by double clicking on the appropriate icon. The mikropascal PRO for PIC32 IDE (Integrated Development Environment) will appear on the screen. Now you are ready to start creating a new project. mikroelektronika mikropascal PRO for PIC32 3

4 New Project The process of creating a new project is very simple. Select the New Project option from the Project menu as shown in Figure on the left. The New Project Wizard window appears. It can also be opened by clicking on the New Project icon from the Project toolbar. The New Project Wizard window will guide you through the process of creating a new project. The introductory window of this application contains a list of actions to be performed when creating a new project. Click Next. 4 mikropascal PRO for PIC32 mikroelektronika

5 Step 1: Selecting MCU From drop down menu select appropriate microcontroller Step 2: Setting oscillator frequency Click Next In Device Clock field type in oscillator frequency in MHz Step 3: New project name Click Next Choose location on your PC where your file will be saved Type in project name Click Save mikroelektronika mikropascal PRO for PIC32 5

6 Step 4: Choosing new project location Click on the open icon if you want to change project location Project name on specified location Click Next Step 5: Adding additional files to project Click open icon to choose the file to be added to the project Click on the Add button to add chosen file to the project In this example we don t use any additional files so just click next Step 6: Including libraries Click Next It is recommended to choose Include All libraries option Clicking on Library Manager Help opens library with examples Click Next 6 mikropascal PRO for PIC32 mikroelektronika

7 Step 7: Finishing project The last step is confirmation of your previous settings. So click on the Finish button to end the process of creating your first project. Click Finish After you click on the Finish button a Code Editor will appear in the main window. The Code Editor represents a working space that is used to type source code in. Figure 3: first_project.mpas mikroelektronika mikropascal PRO for PIC32 7

8 Code example In this simple example (first_project.mpas) we will show you how to compile written source code into.hex file. program first_project; begin AD1PCFG := 0xFFFF; TRISB := 0; TRISC := 0; TRISD := 0; TRISE := 0; LATB := 0; LATC := 0; LATD := 0; LATE := 0; while TRUE do begin LATB := not LATB; LATC := not LATC; LATD := not LATD; LATE := not LATE; Delay_ms(1000); end; end. // Initialize PORTB as output // Initialize PORTC as output // Initialize PORTD as output // Initialize PORTE as output // Set PORTB to zero // Set PORTC to zero // Set PORTD to zero // Set PORTE to zero // Invert PORTB value // Invert PORTC value // Invert PORTD value // Invert PORTE value 8 mikropascal PRO for PIC32 mikroelektronika

9 Program compiling After source code is written it s time to make a.hex file for microcontroller programming. In the Build menu click on the Build option to start compiling If there are some errors in the source code a message window will show them, otherwise your code is compiled correctly, Figure 4. Figure 4: Message window After completing the code compilation, a file with the.hex extension will appear in the first project folder, Figure 5. Use this file (first project.hex) for microcontroller programming. Figure 5: Folder with.hex file If you want to automatically transfer compiled.hex file into the microcontroller select the Build+Program option from the Build menu or just press Ctrl+F11 on your keyboard. mikroelektronika mikropascal PRO for PIC32 9

10 Customizing project If needed it s possible to make changes in project. In the Project Settings window you can change microcontroller (MCU) type, MCU clock frequency and Build/Debugger options. Form drop down list select different microcontroller (MCU) Type in different MCU clock Change build type Change debugger Figure 6: Project Settings window In the Project Manager window customize project files by adding or removing files. To add/ remove file just right click on the folder you want to change and from pop-up window select desired action, Figure 7. Figure 7: Project Manager 10 mikropascal PRO for PIC32 mikroelektronika

11 Saving project While writing a source code you should save it from time to time by selecting the Save option from the File menu or by using keypad shortcut Ctrl+S, Figure 8. If you want to save file under different name click on the Save AS... option. Figure 8: Save source code Figure 9: Save project After project editing is finished, save it by clicking on the Save Project option from the Project menu, Figure 9. If you want to save project under different name click on Save project As... NOTE: The Save Project option saves only files which are additionally added to the previously created project. The Save option saves only file which is currently edited. mikroelektronika mikropascal PRO for PIC32 11

12 If you want to learn more about our products, please visit our web site: If you are experiencing some problems with any of our products or just need additional information, please contact our technical support: If you have any question, comment or business proposal, do not hesitate to contact us: