MPLAB X IDE PROJECTS Microchip Technology Incorporated. All Rights Reserved DEV Slide 68

Size: px

Start display at page:

Brandon McDowell
5 years ago
Views:

2 MPLAB X IDE Projects What is a project? Definition A Project is defined by a collection of files within a specific directory structure used by MPLAB X IDE to keep track of all files, settings and configurations required for the development of an embedded application. Output of a Project is a programmable HEX file for a single PIC MCU Projects inputs include source files, header files, and --- libraries A project is a hierarchical set of directories which ---- contain, or point to directories containing, all the information needed to create a single PIC MCU HEX file 2013 Microchip Technology Incorporated. All Rights Reserved DEV Slide 69

3 What is in a project Files kept and specified by MPLAB X IDE projects: Source files (code and headers) Intermediate build files Files used for Debugging Finished HEX output file(s) Miscellaneous project configuration details Instructions for building the Project 2013 Microchip Technology Incorporated. All Rights Reserved DEV Slide 70

$How a Project is Stored Example My Documents Embedded Tutorial Sample_Project.X build dist nbproject Makefile Project Location =...\Embedded Tutorial\ Project Directory = Sample_Project.$

4 How a Project is Stored Example My Documents Embedded Tutorial Sample_Project.X build dist nbproject Makefile Project Location =...\Embedded Tutorial\ Project Directory = Sample_Project.X Intermediates Directory (*.o files) Output Directory (*.hex and *.elf files) Project Settings Directory Instructions to buld the project build and dist directories are created when the project is first built 2013 Microchip Technology Incorporated. All Rights Reserved DEV Slide 71

5 Project Source Files Example of Placing Source files INSIDE of a project directory.. Sample_Project.X build dist nbproject Makefile Source Files do not have to be kept in the project directory source files can be anywhere!! Adding Source files to the project directory can facilitate backup and distribution. Source Files 2013 Microchip Technology Incorporated. All Rights Reserved DEV Slide 72

6 Project Source Files Example of Placing Source files OUTSIDE of a project directory.. Sample_Project.X build dist nbproject Source Files do not have to be kept in the project directory source files can be anywhere!! Makefile Source Files 2013 Microchip Technology Incorporated. All Rights Reserved DEV Slide 73

7 Project Creation MPLAB X IDE Projects require the following information: The PIC MCU to be used Location where the project directory will be created Software tool needed to build the project The programmer/debugger used The source files Code, Headers and Libraries 2013 Microchip Technology Incorporated. All Rights Reserved DEV Slide 74

Project Creation Starting the process Select the New Project Icon 2013

9 Project Creation Project Types Select the Microchip Embedded from Categories Select Standalone Project from the Projects Window 2013 Microchip Technology Incorporated. All Rights Reserved DEV Slide 76

uses the PIC16F917 Select Next 2013 Microchip

10 Project Creation Device Selection Select the PIC MCU being used for the Device menu Mechatronics board uses the PIC16F917 Select Next 2013 Microchip Technology Incorporated. All Rights Reserved DEV Slide 77

11 Project Creation Debug Header If you require a debug header you will asked to select one. The PIC16F917 Does Not require a debug header Select Next 2013 Microchip Technology Incorporated. All Rights Reserved DEV Slide 78

PICkit3, ICD or Real ICE then it either isn t connected to the system or there is a problem with

12 Project Creation Hardware Tool Click on the serial number below the name of the tool you are using. Select the Simulator if no Debugger programmer connected If you don t see a serial number under a PICkit3, ICD or Real ICE then it either isn t connected to the system or there is a problem with the driver. Select Next 2013 Microchip Technology Incorporated. All Rights Reserved DEV Slide 79

14 Project Creation Project Location 1) Browse to the desired project location 3) Select Finish 2) Enter the name of the new project Project Folder will auto-populate 2013 Microchip Technology Incorporated. All Rights Reserved DEV Slide 81

15 Directory Structure after Project Creation You should now see a project tree under the Projects tab. This project tree will have no source files 2013 Microchip Technology Incorporated. All Rights Reserved DEV Slide 82

16 Directory Structure after a Project has been Created Empty Project Tree System Files Lab1.X You should now see a project tree under the Projects tab. This project tree will have no source files 2013 Microchip Technology Incorporated. All Rights Reserved DEV Slide 83

17 Directory Structure after a Project has been Created Empty Project Tree System Files Lab1.X You should now see a Adding a file to the project tree under the Project Directory Projects tab. This DOES NOT add it project tree will have no to the project source files 2013 Microchip Technology Incorporated. All Rights Reserved DEV Slide 84

Adding Source Files to a Project Select the

and click Select 2013 Microchip Technology

Adding Source Files to a Project File is Added to the Project Tree 2013

wish to remove from project then select Remove from Project

21 Removing Files From a Project secondfile.c.c is unwanted file Right click on the File you wish to remove from project then select Remove from Project from the popup menu 2013 Microchip Technology Incorporated. All Rights Reserved DEV Slide 88

23 Modifying Project Properties Open the project's properties Right click on the top node of the project in the project tree Select Properties from the popup menu Bottom of world's longest popup menu 2013 Microchip Technology Incorporated. All Rights Reserved DEV Slide 90

Modifying Project Properties Project Properties Window show the properties which can be modify Commonly modified properties include: The MCU used The Compiler (with version) being used Programmer -

24 Modifying Project Properties Project Properties Window show the properties which can be modify Commonly modified properties include: The MCU used The Compiler (with version) being used Programmer - debugger being used MPLAB X IDE simulator and Lab Center s Proteus Software simulator are both listed under Hardware Tools 2013 Microchip Technology Incorporated. All Rights Reserved DEV Slide 91

x2 Double-click on the source file to open it in the editor

25 Invoking the Editor You should now see the Source file listed in the project tree under the Source File directory. x2 Double-click on the source file to open it in the editor 2013 Microchip Technology Incorporated. All Rights Reserved DEV Slide 92

Editing a File The file will open in the

project is built 2013 Microchip Technology

26 Editing a File The file will open in the Editor Window User types changes to the code Code changes are saved in one of two ways: 1) The Save All Files button is pushed 2) The project is built 2013 Microchip Technology Incorporated. All Rights Reserved DEV Slide 93

Building a Project 2) Results of build process displayed in Output Window

Correcting a Build Error If an error is found during a build Double Click on the error

30 Correcting a Build Error The Editor Window will open up showing the line with the error Error Stripe shows relative position in file of all errors and warnings Active Parser shows errors in red before compilation Parser shows all warnings in 2013 Microchip Technology Incorporated. All Rights Reserved DEV Slide 97

31 Question: Knowledge Check After a project has been built, in which subdirectory will you find the production HEX file? Answer: the dist sub-directory 2013 Microchip Technology Incorporated. All Rights Reserved DEV Slide 98

INSTRUCTIONS FOR SETTING UP ROACH SOFTWARE IN MPLAB-X

UNIVERSITY OF CALIFORNIA, SANTA CRUZ BOARD OF STUDIES IN COMPUTER ENGINEERING CMPE118(218)/L: INTRODUCTION TO MECHATRONICS INSTRUCTIONS FOR SETTING UP ROACH SOFTWARE IN MPLAB-X These instructions are provided