MPLAB X IDE快速操作指南.docx

1、MPLAB X IDE快速操作指南MPLAB X IDE快速操作指南模板的发布编 制卢继珍审 核批 准发布日期实施日期模板更改记录更改序号更改人/日期更改后的版次更改说明1卢继珍/2014-1-24A/00初稿模板详细内容 见后文。MPLAB X IDE快速操作指南编 制卢继珍审 核批 准发布日期实施日期MPLAB X IDE 快速指南一、环境搭建PIC单片机的开发环境以前主要是MPLAB IDE，但由于其已经暴露出诸多问题，在2010年8月，微芯公司发布了全新的MPLAB X IDE开发环境。见图。MPLAB X IDE是可以运行在PC（Windows、Mac OS和Linux）上的软件程序

2、，用于开发Microchip单片机和数字信号控制器的应用。由于它提供了一个统一的集成“环境”来支持嵌入式单片机的代码开发，因此称为集成开发环境（IDE）。下载路径：图1.1 MPLAB X IDE集成开发环境图标由于其主要是一个集成的软件编辑环境，并不提供编译功能，所以安装MPLAB X IDE以后，我们还要安装编译器。Microchip最新编译器产品线MPLAB XC为项目开发的软件需求提供完整的解决方案，并且可以替换所有MPLAB C和HI-TECH编译器。MPLAB XC编译器具有以下特性：支持所有8/16/32位PIC MCU以及dsPIC DSC与MPLAB X IDE配合工作，提供

3、全面的图形前端： 编辑错误和断点，以匹配源代码中相应的行支持C和C+源代码单步执行，以检测关键点的变量和结构在观察窗口显示已定义数据类型的数据结构（包括浮点）可以在Windows、Linux和Mac OS X系统上运行提供不同优化等级以满足各种需求，并且可以免费下载表：Microchip PIC单片机与编译器对应表专业版标准版免费版*C+PIC10/12/16/18 MCUMPLAB XC 8MPLAB XC 8MPLAB XC 8MPLAB XC 8 不可用PIC24 MCU和dsPIC DSCMPLAB XC 16MPLAB XC 16MPLAB XC 16MPLAB XC 16 不可用P

4、IC32 MCUMPLAB XC 32MPLAB XC 32MPLAB XC 32MPLAB XC 32XC系列编译器的下载路径：由于公司内部主要是PIC中低端系列的单片机，我们安装XC8和XC16编译器就可以了。MPLAB XC8编译器提供了三种模式：免费(Free)、标准(Standard)、专业(PRO)。标准和专业模式需要序列号来启用。无序列号的客户可以使用免费模式。基本的编译器操作、支持的器件和可用的存储器在三种模式中都是相同的，区别仅在于编译器的优化级别。如果我们要求的优化级别比较高，可以对XC8进行破解，破解方法见：安装完MPLAB X IDE集成开发环境和XC8等编译器以后，接

5、下来就可以打开MPLAB X IDE进行相关设置了。双击MPLAB X IDE图标，然后点击顶部菜单栏的Tools-Options, 点击“Embedded”图标，出现图所示界面：图1.2 MPLAB X IDE 编译环境设置界面点击“Add”,弹出图：图1.3 MPLAB X IDE 添加新的编译工具路径设置界面点击“Browse”，选择XC8及XC16的安装文件路径。将XC8及XC16编译工具添加进入开发环境中进行管理。以XC8为例，完成后如下图所示：图1.4 MPLAB X IDE 编译环境设置界面至此，已完成PIC单片机的开发及编译环境了。创建第一个项目：点击“File”“New Pr

6、oject”，弹出如下界面：图1.5 MPLAB X IDE 新建工程选择界面点击“Next”，出现如下“Select Device”界面，选择我们的目标CPU，这里以PIC16F877A为例：图1.6 MPLAB X IDE 芯片选择界面继续点击“Next”，出现“Select Tool”界面，选择我们的下载工具，这里选择“PICKit3”，如果当前选择的下载工具有效的话，会出现SN号，如下图所示：图1.7 MPLAB X IDE下载器选择界面选择“Next”，进入“Select Compiler”界面，选择我们的编译器，即所谓的语言工具。这里因为PIC16F877A单片机是8位的，所以我们

7、选择XC8编译器。图1.8 MPLAB X IDE编译器选择界面选择“Next”，进入“Select Project Name and Folder”,设置工程名和工程路径。图1.9 MPLAB X IDE工程名及路径设置界面点击“Finish”完成工程的建立。刚刚建立的工程是没有任何内容的，如下图所示：图1.10 MPLAB X IDE新建工程后的界面接下去，我们就可以新建文件或添加已经存在的文件，完成软件工程的代码编辑工作。常用的工程设置及工具含义：创建项目之后，可以在Project Properties（项目属性）对话框中查看或更改项目属性。通过以下任一方式访问该对话框： 在Projec

8、ts 窗口中右键单击项目名称，然后选择“Properties”（属性）。 在Projects 窗口中单击项目名称，然后选择FileProject Properties。里面有我们经常要设置的目标板的供电方式及编译的优化等级等等。图1.11 MPLAB X IDE工程属性设置界面其它的一些设置基本都在“Tool”-“Options”里面进行设置，如下图所示：图1.12 MPLAB X IDE选项设置界面基于MPLAB X IDE配置位设置 MPLAB X IDE和MPLAB IDE 8不同。MPLAB IDE 8 可以再界限中选择配置位就行。配置选项可以不写在代码中。MPLAB X IDE 如果

9、要配置的话必须在代码中写出配置。配置字中最重要的配置选项就是：看门狗配置 如：WDTE； 一般选择关闭看门狗。MCLRE复位脚的配置 如：MCLRE；一般选择复位脚作I/O，PIC16F877A无此选项。不用设置。震荡器的选择： 如：FOSC；根据实际情况配置，我这里一般选用XT，即标准的振荡频率1M4M。因为如果这三个没有配置好的话程序根本无法运行。其他配置可以看数据手册此不赘述。图1.13 MPLAB X IDE开发环境PIC设置位的设置界面实例介绍：打开MPLAB X IDE 在菜单栏中 点击Window-PIC Memory Veiws-Configuration bits，如下图所示

10、：图1.14 MPLAB X IDE开发环境PIC设置位的设置界面2 在出现的Configuration Bits中的改变每个配置中的option选项，红色的就是我们改变过的配置选项图1.15 MPLAB X IDE开发环境PIC设置位的设置界面3 配置完成后 点击 Genarate Source Code to Output 产生配置源代码。图1.16 MPLAB X IDE开发环境PIC设置位的设置界面将其中的#include #pragma config FOSC = XT / Oscillator Selection bits (XT oscillator)#pragma config

11、 WDTE = ON / Watchdog Timer Enable bit (WDT enabled)#pragma config PWRTE = OFF / Power-up Timer Enable bit (PWRT disabled)#pragma config BOREN = OFF / Brown-out Reset Enable bit (BOR disabled)#pragma config LVP = OFF / Low-Voltage (Single-Supply) In-Circuit Serial Programming Enable bit (RB3 is digi

12、tal I/O, HV on MCLR must be used for programming)#pragma config CPD = OFF / Data EEPROM Memory Code Protection bit (Data EEPROM code protection off)#pragma config WRT = OFF / Flash Program Memory Write Enable bits (Write protection off; all program memory may be written to by EECON control)#pragma c

13、onfig CP = OFF / Flash Program Memory Code Protection bit (Code protection off)上述代码粘贴在中即可。另外，为了编辑过程中支持中文注释，需要对编码格式进行更改，右键点击工程名，选择“Properties”-“General”，在Encoding下拉选项中选择“GB2312”选项。如图所示：图1.17 MPLAB X IDE开发环境工程属性的设置界面下面重点介绍一下在MPLAB X IDE中如何使用SVN。 在介绍SVN的使用之前，先让我们来了解一下SVN。SVN是什么？有一个简单但不十分精确比喻： SVN = 版本控

14、制 + 备份服务器简单的说，您可以把SVN当成您的备份服务器，更好的是，他可以帮您记住每次上传到这个服务器的档案内容。并且自动的赋予每次的变更一个版本。通常，我们称用来存放上传档案的地方就做Repository。用中文来说，有点像是档案仓库的意思。不过，通常我们还是使用Repository这个名词。基本上，第一次我们需要有一个新增(add)档案的动作，将想要备份的档案放到Repository上面。日后，当您有任何修改时，都可以上传到Repository上面，上传已经存在且修改过的档案就叫做commit，也就是提交修改给SVN server的意思。针对每次的commit，SVN server都会

15、赋予他一个新的版本。同时，也会把每次上传的时间记录下来。日后，因为某些因素，如果您需要从Repository下载曾经提交的档案。您可以直接选择取得最新的版本，也可以取得任何一个之前的版本。如果忘记了版本，还是可以靠记忆尝试取得某个日期的版本。为什么要用SVN? 备份工作档案是十分重要的。您永远不知道计算机上的硬盘何时会坏掉。根据经验法则再加上摩菲定理，坏事情往往都发生在最重要的时刻。例如，要release东西的前一刻，硬盘完全坏掉，无法修复。所以，常常备份工作数据是非常重要的。大部分公司的server都会有专门的备份机制，甚至是异地备援。绝对比放在自己的计算机里头，或是随身碟上面来的安全。版本

16、控管非常重要。您无法保证手头上最新版本永远都是对的。很多时候，在经过数天努力工作后，您才发现走错方向。需要将所有的修改回复到数天前版本。没有几个人能够完全记住自己修改过什么东西。如果没有做好版本控管，那么，最差的状况就是要全部重来。伙伴间的数据同步也是非常重要的。很多时候，除了您个人外，还有其它的伙伴也需要您的档案。怎么把最新的档案提供给伙伴呢？用e-mail？根据经验，用e-mail是一个很差的办法。到了最后，根本就不知道哪一封e-mail才是新的。因为可能您最新的e-mail已经被当成垃圾信给丢了。别忘了，现在很多e-mail软件都有anti-spam的功能，说不定这些信件都被当成广告信给

17、处理掉了。而且，您也应该知道一般档案如果放在e-mail内，档案大小会变得比较大（通常是原来的4/3倍以上）。如果每天更新一次，恐怕几天没收信的话，信箱就爆了！如果没有一个好的办法，备份不同版本是很耗费硬盘空间的。例如：您有一个总共10MB的目录，使用单纯的档案备份。如果有10个版本就会变成100MB。20个版本就有200MB。如果，不想备份这么多版本，势必就是要减少备份的次数。拉长备份周期将会导致数据遗失的危险性增高。把旧的不需要的备份删除？根据经验，只要时间一拉长，您跟本就不知道一个月以前的版本是重要或者是不重要。SVN能帮我们解决上面的问题吗？答案是肯定的：SVN Repository可

18、以是自己计算机上的一个目录，或者是随身碟（不建议这样用）。当然也可以是公司的服务器。SVN有很棒的版本控管机制。所有上传的版本都会帮您记录下来。日后您可以随时取得某一个时刻的版本。而且，也有版本分支及合并等好用的功能。SVN可以让不同的开发者存取同样的档案，并且利用SVN Server作为档案同步的机制。也就是说，您有档案更新时，无须将档案寄给您的开发成员。只需要告诉他新的版本已经在SVN Server上面，请他自己去SVN Server上面就可以取得最新版本。而且，SVN Server也可以做到当您上传新版本后，自动发信给相关的成员。SVN的存放档案方式是采用差异备份的方式。也就是说，他只会

19、备份有不同的地方。所以很省硬盘空间。此外，他也可以针对所谓的非文字文件进行差异备份。MPLAB X IDE 具有一个内置的本地文件历史记录功能，这是NetBeans 平台的补充功能。该功能为本地项目和文件提供内置的版本控制支持，类似于传统的版本控制系统。可用工具包括本地DIFF 和文件恢复。在项目或文件窗口右键单击一个文件可以查看本地历史记录选项。要查看文件的本地历史记录： 在项目或文件窗口中右键单击文件，并选择Local History （本地历史记录） Show Local History （显示本地历史记录）。此处将会列出过去对文件进行的所有更改。 在项目或文件窗口中右键单击文件，并选择

20、Local HistoryRevert to （还原为）。此时将打开Revert to 对话框，列出文档的所有先前版本。选择一个并单击OK 可还原为该版本。如果更偏好使用完整的版本控制系统，也提供了对于CVS、Subversion和Mercurial的支持。 源代码控制可通过以下方式获取： ToolsOptions，Miscellaneous（杂项），Versioning（版本控制）设置版本控制程序。 Team（团队）菜单选择版本控制程序子菜单。 WindowVersioning打开版本控制窗口。需要保存到存储库（repository）中的项目文件： MPLAB X IDE项目定义为包含nbp

21、roject子目录的目录。该nbproject子目录包含编译项目映像所需的文件。nbproject下的一些文件将根据需要重新生成。因此，不需要将它们提交到版本控制存储库。将重新生成因而不需要保存在存储库中的文件包括： nbproject/Makefile-* nbproject/Package-* nbproject/private nbproject/private/* 其中，private是一个目录。 在MPLAB X IDE项目目录中，存在另一个仅在创建项目时创建的Makefile文件；因此应将它提交到存储库中。更多信息： 关于使用本地文件历史记录和/或源代码控制的更多信息，请参见Net

22、Beans帮助主题IDE BasicsVersion Control and File History（版本控制和文件历史记录）下的目录。关于以上源代码控制程序的进一步信息，请参见： CVS Subversion注：MPLAB X IDE最新版本也不能支持及以上版本，故如果使用MPALB内部的集成SVN菜单，只能下载版本到之间的版本。首先，介绍MPLAB X IDE内部集成的Subversion版本控制菜单的使用：第一步设置Subversion的安装路径及用户名密码等，依次，Tools-Options，Miscellaneous（杂项），Versioning（版本控制），Subversion，

23、打开如下窗口，按图设置。图1.18 MPLAB X IDE开发环境SVN的设置界面执行Team-Subversion-Checkout，图1.19 MPLAB X IDE开发环境SVN的操作界面弹出如下界面：图1.20A MPLAB X IDE开发环境SVN环境设置界面点击“Next”，弹出如下界面：图1.20B MPLAB X IDE开发环境SVN环境设置界面点击“Finish”，完成文件从服务器到本地的下载，然后就可以添加到工程中，进行相关更改，可以看到，当我们编辑已经纳入到版本控制里面的文件时，再次点击“Team”菜单，里面的内容已经由图变成了图的形式。更加方便我们进行版本控制的操作。图

24、1.20C MPLAB X IDE开发环境SVN环境设置界面下面重点介绍一下单独使用外部SVN来进行版本控制，这种控制方式也是比较推荐的，因为MPLAB X IDE支持的SVN版本比较低，基本不是主流的版本了。而且，经过测试，MPLAB X IDE对SVN的支持也不好，在验证SVN的用户名和密码时存在BUG（也许是版本不兼容问题）。SVN的安装和使用具体可以参见SVN客户端操作指导。当我们新开始一个软件工程开发时，首先申请SVN仓库申请一块空间，也就是得到一个SVN路径，当我们得到SVN路径，就可以进行SVN的版本管理了。我们先建立一个SVN工作的文件夹，例如，我们先在E盘建立一个SVN_WO

25、RK的文件夹，然后再在里面根据我们的工程实际建立一个文件夹，比如PIC16F877A（名称不推荐使用中文）。右键点击“PIC16F877A”这个文件夹，在弹出的菜单中选择SVN Checkout，弹出图，如下图所示：图1.21 SVN Checkout设置界面点击“OK”，进入PIC16F877A文件夹，我们就可以发现多了一个.SVN的隐藏属性的文件夹。打开MPLAB X IDE，根据我们上述章节所描述，开始在PIC16F877A文件夹下面建立一个新的软件工程，并且在其工程文件夹中再分别建立Source，Header文件夹，存放我们的C源文件和头文件。完成后如图所示：图1.22 新建CZF30

26、0_KEYBOARD工程目录图新建我们项目的头文件及源文件，并放入相应的文件夹内。完成后如图所示：图1.23 MPLAB X IDE新建立工程界面回到PIC16F877A文件夹的上层目录，在PIC16F877A文件夹上点击右键，弹出图所示界面，在红色框框中填写软件提交的备注。图1.24 SVN Committed界面以下四类文件因为是在编译过程中产生的文件，因此不需要上传到SNV中： nbproject/Makefile-* nbproject/Package-* nbproject/private nbproject/private/* 在软件开发及调试的过程中，建议每天做一次版本的提交，并编写相关版本的备注。如果是多人开发，在每次软件更改前建议做一次SVN Checkout。