MPLABIDEPDF.book

Transcription

1 MPLAB IDE 用户指南 2005 Microchip Technology Inc. DS51519A_CN

2 请注意以下有关 Microchip 器件代码保护功能的要点 : Microchip 的产品均达到 Microchip 数据手册中所述的技术指标 Microchip 确信 : 在正常使用的情况下, Microchip 系列产品是当今市场上同类产品中最安全的产品之一 目前, 仍存在着恶意 甚至是非法破坏代码保护功能的行为 就我们所知, 所有这些行为都不是以 Microchip 数据手册中规定的操作规范来使用 Microchip 产品的 这样做的人极可能侵犯了知识产权 Microchip 愿与那些注重代码完整性的客户合作 Microchip 或任何其他半导体厂商均无法保证其代码的安全性 代码保护并不意味着我们保证产品是 牢不可破 的 代码保护功能处于持续发展中 Microchip 承诺将不断改进产品的代码保护功能 任何试图破坏 Microchip 代码保护功能的行为均可视为违反了 数字器件千年版权法案 (Digital Millennium Copyright Act) 如果这种行为导致他人在未经授权的情况下, 能访问您的软件或其他受版权保护的成果, 您有权依据该法案提起诉讼, 从而制止这种行为 提供本文档的中文版本仅为了便于理解 Microchip Technology Inc. 及其分公司和相关公司 各级主管与员工及事务代理机构对译文中可能存在的任何差错不承担任何责任 建议参考 Microchip Technology Inc. 的英文原版文档 本出版物中所述的器件应用信息及其他类似内容仅为您提供便利, 它们可能由更新之信息所替代 确保应用符合技术规范, 是您自身应负的责任 Microchip 对这些信息不作任何明示或暗示 书面或口头 法定或其他形式的声明或担保, 包括但不限于针对其使用情况 质量 性能 适销性或特定用途的适用性的声明或担保 Microchip 对因这些信息及使用这些信息而引起的后果不承担任何责任 未经 Microchip 书面批准, 不得将 Microchip 的产品用作生命维持系统中的关键组件 在 Microchip 知识产权保护下, 不得暗中或以其他方式转让任何许可证 商标 Microchip 的名称和徽标组合 Microchip 徽标 Accuron dspic KEELOQ microid MPLAB PIC PICmicro PICSTART PRO MATE PowerSmart rfpic 和 SmartShunt 均为 Microchip Technology Inc. 在美国和其他国家或地区的注册商标 AmpLab FilterLab Migratable Memory MXDEV MXLAB PICMASTER SEEVAL SmartSensor 和 The Embedded Control Solutions Company 均为 Microchip Technology Inc. 在美国的注册商标 Analog-for-the-Digital Age Application Maestro dspicdem dspicdem.net dspicworks ECAN ECONOMONITOR FanSense FlexROM fuzzylab In-Circuit Serial Programming ICSP ICEPIC Linear Active Thermistor MPASM MPLIB MPLINK MPSIM PICkit PICDEM PICDEM.net PICLAB PICtail PowerCal PowerInfo PowerMate PowerTool rflab rfpicdem Select Mode Smart Serial SmartTel Total Endurance 和 WiperLock 均为 Microchip Technology Inc. 在美国和其他国家或地区的商标 SQTP 是 Microchip Technology Inc. 在美国的服务标记 在此提及的所有其他商标均为各持有公司所有 2005, Microchip Technology Inc. 版权所有 Microchip 位于美国亚利桑那州 Chandler 和 Tempe 及位于加利福尼亚州 Mountain View 的全球总部 设计中心和晶圆生产厂均于 2003 年 10 月通过了 ISO/TS-16949:2002 质量体系认证 公司在 PICmicro 8 位单片机 KEELOQ 跳码器件 串行 EEPROM 单片机外设 非易失性存储器和模拟产品方面的质量体系流程均符合 ISO/TS :2002 此外, Microchip 在开发系统的设计和生产方面的质量体系也已通过了 ISO 9001:2000 认证 DS51519A_CN 第 ii 页 2005 Microchip Technology Inc.

3 MPLAB IDE 用户指南 目录 前言... 1 第 1 部分 MPLAB IDE 第 1 章 MPLAB IDE 简介 1.1 嵌入式系统简介 开发周期 项目管理器 语言工具 目标调试 器件编程 MPLAB IDE 组件 MPLAB IDE 文档 MPLAB IDE 在线帮助 MPLAB IDE 更新和版本编号 第 2 章 MPLAB IDE 入门 : 基础教程 2.1 简介 MPLAB IDE 的特性和安装 教程概述 选择器件 创建项目 设置语言工具 为项目命名 将文件添加到项目中 编译项目 创建代码 再次编译项目 使用软件模拟器测试代码 教程总结 第 3 章步骤和教程 3.1 简介 选择器件 设置配置位 使用编辑器创建源代码 创建新项目 使用项目向导 设置语言工具包 Microchip Technology Inc. DS51519A_CN 第 iii 页

4 MPLAB IDE 用户指南 3.8 为新项目命名和定位 添加文件 完成项目 查看项目窗口 设置编译选项 编译项目 选择调试器 运行代码 查看 Debug 窗口 使用 Watch 窗口 使用断点 选择编程器 对器件进行编程 使用 Microchip 帮助 第 4 章项目和工作区 4.1 简介 使用项目向导 创建 / 更新任何项目 设置项目结构 相关路径 项目文件夹和文件 使用版本控制系统 (VCS) 设置 / 更改项目 使用单个项目和工作区 在单个工作区中使用多个项目 编译无需项目的应用程序 第 5 章集成工具 5.1 简介 语言工具包 Microchip 语言工具 第三方语言工具 编辑器 软件模拟器 在线仿真器 在线调试器 编程器 第三方工具 第 6 章 MPLAB IDE 疑难解答 6.1 简介 常见问题 /FAQ 错误消息 限制 DS51519A_CN 第 iv 页 2005 Microchip Technology Inc.

5 目录 第 2 部分 MPLAB IDE 使用参考 第 7 章 MPLAB IDE 界面 7.1 简介 MPLAB IDE 菜单栏 MPLAB IDE 工具栏 MPLAB IDE 状态栏 第 8 章 MPLAB IDE 窗口 8.1 简介 更改窗口数据和属性 代码显示窗口中的符号 项目窗口 Output 窗口 Disassembly Listing 窗口 Hardware Stack 窗口 Program Memory 窗口 File Registers 窗口 EEPROM 窗口 LCD Pixel 窗口 Watch 窗口 Special Function Registers 窗口 Trace Memory 窗口 Configuration Bits 窗口 文件 ( 编辑器 ) 窗口 第 9 章 MPLAB IDE 对话框 9.1 简介 About MPLAB IDE 对话框 Add Watch 对话框 Breakpoints 对话框 Build Options 对话框 Export Hex File 对话框 External Memory Setting 对话框 File Management 对话框 Fill Memory/Registers 对话框 Find In Project Files 对话框 Find and Replace 对话框 Help Topics 对话框 Import 对话框 New Project 对话框 Project-Display Preferences 对话框 Project Wizard 对话框 Properties 对话框 Save Project As 对话框 Microchip Technology Inc. DS51519A_CN 第 v 页

6 MPLAB IDE 用户指南 9.19 Select Device 对话框 Select Language Toolsuite 对话框 Set Language Tool Location 对话框 Settings 对话框 Table Setup 对话框 User ID Memory 对话框 Version-Control 对话框 Watch 对话框 第 10 章 MPLAB IDE 操作参考 10.1 简介 命令行选项 MPLAB IDE 所使用的文件 保存的信息 第 3 部分 MPLAB 编辑器 第 11 章使用编辑器 11.1 简介 配置编辑器 文件处理 文本处理 使用调试功能 键盘功能 编辑器疑难解答 第 4 部分 MPLAB SIM 第 12 章软件模拟器概述 12.1 简介 软件模拟器功能 软件模拟器模型 PICmicro MCU 软件模拟器模型 dspic DSC 软件模拟器执行 第 13 章 MPLAB SIM 入门 13.1 简介 使用跑表 使用激励 使用软件模拟器跟踪 使用外部存储器 第 14 章使用激励 14.1 简介 SCL Generator 对话框 Stimulus Controller 对话框 激励输入相互作用 DS51519A_CN 第 vi 页 2005 Microchip Technology Inc.

7 目录 第 15 章使用激励 PIC17 器件 15.1 简介 使用引脚激励 使用文件激励 第 16 章软件模拟器疑难解答 16.1 简介 常见问题 /FAQ 限制 第 17 章软件模拟器使用参考 17.1 简介 调试功能 Settings 对话框 Settings 对话框 PIC17 器件 词汇表 索引 全球销售及服务网点 Microchip Technology Inc. DS51519A_CN 第 vii 页

8 MPLAB IDE 用户指南 注 : DS51519A_CN 第 viii 页 2005 Microchip Technology Inc.

9 MPLAB IDE 用户指南 前言 客户须知 所有文档均会更新, 本手册也不例外 Microchip 的工具和文档都在不断演变以满足客户的需求, 因此在实际使用中某些对话框和 / 或工具的说明可能与本文档所述之内容有所不同 请访问我们的网站 ( 获取最新的可用文档 文档均标记有 DS 编号 该编号出现在每页底部的页码之前 DS 编号的命名约定为 DSXXXXXA, 其中 XXXXX 为文档编号, A 为文档版本 欲了解开发工具的最新信息, 请参阅 MPLAB IDE 在线帮助 在 Help ( 帮助 ) 菜单选择 Topics ( 主题 ), 打开现有的在线帮助文件列表 简介 文档编排 本章包含在使用 MPLAB IDE 前需要了解的一般信息 本章中讨论的内容包括 : 文档编排 本指南中使用的约定 推荐读物 Microchip 网站 开发系统客户变更通知服务 客户支持 本文档说明了使用 MPLAB IDE 开发固件的方法 本手册的内容编排如下 : 第 1 部分 MPLAB IDE 第 1 章 : MPLAB IDE 简介 讲述了 MPLAB IDE 及其如何帮助开发应用程序 第 2 章 : MPLAB IDE 入门 : 基本教程 讲述了 MPLAB IDE v6.xx 软件的安装方法以及如何使用该软件开发示例应用程序 第 3 章 : 步骤和教程 逐一介绍了使用 MPLAB IDE 开发应用程序的必要步骤 每一步均给出了示例 第 4 章 : 项目和工作区 讲述了 MPLAB 的项目和工作区在应用程序开发过程中的使用 包括关于项目向导 (Project Wizard) 版本控制系统和项目及单文件和多文件项目的信息 2005 Microchip Technology Inc. DS51519A_CN 第 1 页

10 MPLAB IDE 用户指南 第 5 章 : 集成工具 讲述了在 MPLAB IDE 中可使用的语言工具 ( 汇编器和编译器 ) 软件工具和硬件工具 第 6 章 : 疑难解答 讲述了在 MPLAB IDE 操作中的常见问题及解决方法 第 2 部分 MPLAB IDE 使用参考 第 7 章 : MPLAB IDE 界面 讲述了 MPLAB IDE 的界面, 包括菜单栏 工具栏和状态栏 第 8 章 : MPLAB IDE 窗口 讲述了所有的 MPLAB IDE 窗口 包括窗口中符号的定义 第 9 章 : MPLAB IDE 对话框 讲述了所有的 MPLAB IDE 对话框 第 10 章 :MPLAB IDE 操作参考 讲述了关于命令行选项 快捷 ( 热 ) 键 MPLAB IDE 使用的文件的综合信息以及可移植性信息 第 3 部分 MPLAB 编辑器 第 11 章 : 使用编辑器 讲述了 MPLAB 编辑器的使用方法 包括文本处理 配置编辑器 对文件和文本进行操作 本章还提供了其他补充信息, 包括键盘功能 编辑器上下文相关 ( 鼠标右键 ) 菜单和疑难解答 第 4 部分 MPLAB SIM 第 12 章 : 软件模拟器概述 MPLAB SIM 软件模拟器的概述 本章讨论了软件模拟器的功能 模型和执行 第 13 章 :MPLAB SIM 入门 讲述了 MPLAB SIM 的初级使用 本章建议了可参考的教程并讨论了软件模拟器的功能 第 14 章 : 使用激励 讲述了如何对大多数 PICmicro 单片机 (MCU) 和 dspic 数字信号控制器 (Digital Signal Controller, DSC) 使用软件模拟器激励 讨论了使用 SCL 发生器创建激励的方式和激励控制 第 15 章 : 使用激励 PIC17 器件 详细说明了如何对 PIC17CXXX MCU 器件使用软件模拟器激励 讨论了引脚激励和文件激励 第 16 章 : 软件模拟器疑难解答 讲述了 MPLAB SIM 操作中的常见问题及解决方法 第 17 章 : 软件模拟器使用参考 详细说明了在使用软件模拟器调试应用程序的过程中可使用的功能 DS51519A_CN 第 2 页 2005 Microchip Technology Inc.

11 前言 本指南中使用的约定 本文档可能采用了以下约定 : 文档约定 说明表示示例 Arial 字体 : 斜体字符 参考书目 MPLAB IDE 用户指南 需强调的文字... 仅有的编译器... 首字母大写 窗口 Output ( 输出 ) 窗口 对话框 Settings ( 设置 ) 对话框 菜单选项 选择 Enable Programmer ( 使能编程器 ) 引用 窗口或对话框中的域名 Save project before build 带右尖括号有下划线的斜体文字 菜单路径 File>Save 粗体字 对话框按钮 单击 OK 选项卡 单击 Power 选项卡 bnnnn 二进制数, 其中 n 是一个数字 b00100, b10 尖括号 < > 括起的文字 键盘上的按键 按下 <Enter> 或 <F1> Courier 字体 : 常规 Courier 源代码示例 #define START 文件名 autoexec.bat 文件路径 c:\mcc18\h 关键字 _asm, _endasm, static 命令行选项 -Opa+, -Opa- 位值 0, 1 斜体 Courier 可变参数 file.o, 其中 file 可以是任一有效文件名 0xnnnn 十六进制数, 其中 n 是一个十 0xFFFF, 0x007A 六进制数字 方括号 [ ] 可选参数 mcc18 [ 选项 ] file [ 选项 ] 花括号和竖线 :{ } 选择互斥参数 ; 或 选择 errorlevel {0 1} 省略号... 替换重复文本 var_name [, var_name...] 表示由用户提供的代码 void main (void) {... } 2005 Microchip Technology Inc. DS51519A_CN 第 3 页

12 MPLAB IDE 用户指南 推荐读物 本文档介绍了使用 MPLAB IDE 的方法 下面列出了其他有用的文档 这些 Microchip 文档均已提供, 建议作为补充参考资料使用 MPLAB IDE 的自述文件 (Readme) 如需了解使用 MPLAB IDE 的最新信息, 请阅读 Readme for MPLAB IDE.txt 文件 (ASCII 文本文件 ), 该文件位于 MPLAB IDE 安装目录的 Readmes 子目录下 自述文件包含了本文档中可能未提供的更新信息和已知问题 自述文件有关使用其他工具的最新信息, 请参阅与工具相关的自述文件, 文件位于 MPLAB IDE 安装目录的 Readmes 子目录下 自述文件包含了本文档中可能未提供的更新信息和已知问题 在线帮助文件在线帮助提供了全面的 MPLAB IDE MPLAB 编辑器和 MPLAB SIM 软件模拟器的帮助文档 包括教程 功能说明和参考资料 PICmicro 数据手册和系列参考手册请访问 Microchip 网站以获取器件数据手册和相关器件系列参考手册的完整的已更新版本 dspic30f Family Overview (DS70043) dspic30f 器件及其架构的概述 dspic30f Programmer's Reference Manual (DS70030) 该文档提供了有关 dspic30f 器件编程的一般信息, 此外还提供了完整的指令集列表 MICROCHIP 网站 Microchip 网站 ( 为客户提供在线支持 客户可通过该网站方便地获取文件和信息 只要使用常用的因特网浏览器即可访问, 网站提供以下信息 : 产品支持 数据手册和勘误表 应用笔记和范例程序 设计资源 用户指南和硬件支持文档 最新软件版本以及归档软件 常规技术支持 常见问题 (Frequently Asked Questions, FAQ) 技术支持请求 在线讨论组和 Microchip 顾问计划成员名单 Microchip 的业务范围 产品选型和订购指南 最新 Microchip 新闻稿 研讨会和活动安排表 Microchip 销售办事处 代理商以及工厂代表处列表 DS51519A_CN 第 4 页 2005 Microchip Technology Inc.

13 前言 开发系统客户变更通知服务 Microchip 的客户通知服务有助于客户了解 Microchip 产品的最新信息 注册客户可在他们感兴趣的某个产品系列或开发工具发生变更 更新 发布新版本或勘误表时, 收到电子邮件通知 欲要注册, 请登录 Microchip 网站 点击 客户变更通知 服务并按照注册说明完成注册 开发系统产品分类如下 : 编译器 Microchip C 编译器及其他语言工具的最新信息 包括 MPLAB C17 MPLAB C18 和 MPLAB C30 C 编译器 ; MPASM 和 MPLAB ASM30 汇编器 ; MPLINK 和 MPLAB LINK30 目标链接器, 以及 MPLIB 和 MPLAB LIB30 目标库管理器 仿真器 Microchip 在线仿真器的最新信息 包括 MPLAB ICE 2000 和 MPLAB ICE 4000 在线调试器 Microchip 在线调试器 MPLAB ICD 2 的最新信息 MPLAB IDE Microchip 开发系统工具的 Windows 集成开发环境 MPLAB IDE 的最新信息 主要针对 MPLAB IDE MPLAB SIM 软件模拟器 MPLAB IDE 项目管理器以及一般编辑和调试功能 编程器 Microchip 编程器的最新信息 包括 MPLAB PM3 和 PRO MATE II 器件编程器以及 PICSTAR Plus 开发编程器 客户支持 Microchip 产品的用户可以通过以下渠道获取帮助 : 代理商或代表 当地销售办事处 应用工程师 (FAE) 技术支持 开发系统信息热线用户应联系代理商 代表处或应用工程师 (FAE) 获取支持 当地销售办事处也可为用户提供帮助 本文档后附有销售办事处及其地址的列表 也可通过 网站获取技术支持 2005 Microchip Technology Inc. DS51519A_CN 第 5 页

14 MPLAB IDE 用户指南 注 : DS51519A_CN 第 6 页 2005 Microchip Technology Inc.

15 MPLAB IDE 用户指南 第 1 部分 MPLAB IDE 第 1 章 MPLAB IDE 简介... 9 第 2 章 MPLAB IDE 入门 : 基本教程 第 3 章步骤和教程 第 4 章项目和工作区 第 5 章集成工具 第 6 章 MPLAB IDE 疑难解答 Microchip Technology Inc. DS51519A_CN 第 7 页

16 MPLAB IDE 用户指南 注 : DS51519A_CN 第 8 页 2005 Microchip Technology Inc.

17 MPLAB IDE 用户指南 第 1 章 MPLAB IDE 简介 1.1 嵌入式系统简介 MPLAB IDE 是一种在 PC 机上运行的软件, 用来为 Microchip 单片机开发应用程序 由于它提供了一种单一的集成环境来为嵌入式单片机开发程序代码, 因此被称为集成开发环境或 IDE 经验丰富的嵌入式系统设计人员可以跳过这部分而直接转至第 1.7 节 MPLAB IDE 的组件 在此还建议浏览第 1.9 节 MPLAB IDE 在线帮助 和第 1.10 节 MPLAB IDE 更新和版本编号 本章的其余部分简要地介绍了嵌入式系统开发以及使用 MPLAB IDE 的方法 嵌入式系统 说明嵌入式系统通常为一种利用小型单片机 ( 如 Microchip PICmicro MCU 或 dspic 数字信号控制器 (DSC)) 功能的设计 这种单片机将微处理器 ( 类似于台式计算机中的 CPU) 与某些称为 外设 的附加电路相结合, 加上同一芯片上的其他电路就构成了一个需要极少其他外部器件的小型控制模块 这种单一的器件可以被嵌入到其他电子和机械设备中, 以实现低成本的数字控制 嵌入式控制器和 PC 机之间的区别 嵌入式控制器与 PC 机之间的主要区别在于 : 嵌入式控制器专用于某项特定任务, 或某类特定任务 而 PC 机则设计为能够运行多种不同类型的程序, 并能够连接到多种不同的外部设备 嵌入式控制器只有一个程序, 因此成本低廉, 只要能够保证处理专项任务所需的计算能力和硬件即可 而 PC 机的核心具有比较昂贵的通用中央处理单元 (CPU), 它还包含了很多其他外部设备 ( 内存 磁盘驱动器 视频控制器和网络接口电路等 ) 嵌入式系统具有低成本的智能型微控制器单元 (MCU), 在同一芯片上还有很多外设电路而外部设备则相对较少 通常, 嵌入式系统属于隐藏部件, 或者是其他产品的子模块, 如电池式钻孔机 冰箱或车库开门器 此类产品中的控制器只执行整个设备的一小部分功能 控制器给这些设备中的关键子系统增添了低成本的智能 举例来说, 烟雾检测器就是一种嵌入式系统 它的功能是检测传感器输出的信号, 如果信号表示有烟雾存在, 则发出警报 可以使烟雾检测器中的小程序执行无限循环, 不停地对烟雾传感器输出的信号进行采样, 也可以使烟雾检测器处于低功耗的 休眠 模式, 由传感器的输出信号将它唤醒 唤醒后烟雾检测器中的小程序就会发出警报 该程序可能还具有一些其他功能, 如用户测试功能和电池欠压报警 虽然配备传感器和音频输出设备的 PC 机通过编程也可以实现上述功能, 但这并不是一种节约成本的解决方案 ( 而且它也不可能在 9 伏的电压下以无人照管方式常年运作!) 嵌入式设计使用廉价的单片机, 为我们的日常生活环境提供智能化处理, 如烟雾检测器 相机 手机 家用电器 汽车 智能卡以及安防系统 2005 Microchip Technology Inc. DS51519A_CN 第 9 页

18 MPLAB IDE 用户指南 单片机的组件 PICmicro MCU 具有用于储存固件或编码指令的程序存储器, 以运行程序 它还具有 文件寄存器 存储器, 用来储存程序计算或临时数据所需的变量 单片机芯片本身还具有很多外围设备 其中某些外设被称为 I/O 端口 I/O 端口是单片机上的引脚, 可以将其驱动为高电平或低电平以发送信号 闪烁指示灯或驱动扬声器 发送任何能够通过线路传输的信息 这些引脚通常为双向引脚, 可以配置为输入, 以使程序能够对外部开关或传感器作出响应, 或是与某些外部器件通信 图 1-1: PICmicro MCU 数据手册 框图 ( 摘录 ) 21 地址锁存器程序存储器数据锁存器 表指针 <21> 递增 / 递减逻辑 21 PCLATU PCLATH PCU PCH PCL 程序计数器 31 级堆栈表锁存器 16 8 ROM 锁存器 IR 数据锁存器 数据 RAM 地址锁存器 12 地址 <12> BSR FSR0 FSR1 FSR2 Bank0,F 12 译码器 递增 / 递减逻辑 数据总线 <8> 端口 A 端口 B 端口 C RA0/AN0 RA1/AN1 RA2/AN2/VREF- RA3/AN3/VREF+ RA4/T0CKI RA5/AN4/LVDIN RA6 RB0/INT0 RB1/INT1 RB2/INT2 RB3/INT3 RB4/KBI0 RB5/KBI1/PGM RB6/KBI2/PGC RB7/KBI3/PGD RC0/T1OSO/T13CKI RC1/T1OSI/CCP2 RC2/CCP1 RC3/SCK/SCL RC4/SDI/SDA RC5/SDO RC6/TX1/CK1 RC7/RX1/DT1 为了设计这种系统, 必须确定应用需要哪些外设 模数转换器允许单片机连接到传感器并接收变化的电平 串行通信外设可以通过线缆以串行方式与另一台单片机 局域网或因特网通信 PICmicro MCU 上称为定时器的外设可以精确的检测信号事件并生成和捕捉通信信号以及输出精确的波形, 甚至可以在单片机挂起或因电源故障或硬件故障导致单片机工作异常时自动将其复位 其他外设可以检测外部电源是否降到了危险电平之下, 以便让单片机能够及时存储重要信息, 从而在完全掉电之前安全关闭 DS51519A_CN 第 10 页 2005 Microchip Technology Inc.

19 MPLAB IDE 简介 应该使用哪种 PICmicro MCU 在很大程度上取决于运行应用程序所需的外设和存储器大小 其他因素可能包括单片机的功耗及其 外形因素, 即安装到目标设计中的物理封装尺寸和特性 图 1-2: PICmicro 器件封装 E E1 引脚数 =n1 p D1 D 2 1 B n CH x 45 A α c A2 β L φ A1 (F) 使用 MPLAB IDE 实现嵌入式系统设计 嵌入式控制器开发系统是在台式计算机上运行的程序系统, 它有助于编写 编辑和调试程序代码 ( 嵌入式系统应用的灵魂 ), 并将其烧写到单片机中 MPLAB IDE 在 PC 机上运行, 包含设计和部署嵌入式系统应用所需的全部组件 开发嵌入式控制器应用的典型任务有 : 1. 创建高端设计 根据所需的功能和性能, 决定最适用于应用的 PICmicro 或 dspic 器件, 然后设计相关的硬件电路 在决定由哪些外设和引脚控制硬件之后, 编写固件 ( 控制嵌入式应用中的硬件的软件 ) 可以使用语言工具编写和编辑代码, 这些语言工具如汇编器 ( 可以直接将汇编代码转换为机器码 ) 或编译器 ( 允许使用更通用的语言创建程序 ) 汇编器和编译器允许使用功能标号来标识代码子程序, 变量名可与其用途相关联, 并采用有助于在可维护的结构中组织代码的程序结构, 从而使代码易于理解 图 1-3: PICmicro MCU 数据手册 时序 ( 摘录 ) Q1 Q2 Q3 Q4 Q1 TT1P Q1 Q2 Q3 Q4 Q1 Q2 Q3 Q4 Q1 T1OSI OSC1 TSCS 内部系统时钟 SCS (OSCCON<0>) 程序计数器 TOSC PC TDLY PC+2 PC Microchip Technology Inc. DS51519A_CN 第 11 页

20 MPLAB IDE 用户指南 图 1-4: PICmicro MCU 数据手册 指令 ( 摘录 ) 2. 使用汇编器和 / 或编译器以及链接器汇编 编译和链接软件以将您的代码转换为 0 和 1 序列 可被 PICmicro MCU 识别的机器码 机器码最终将变为固件 ( 编程到单片机中的代码 ) 3. 测试代码 通常, 复杂的程序不一定会按照预期运行, 要得到正确的结果, 还需要除去设计中的 错误 (bug) 您可以通过调试器观察与所编写的带有符号和函数名的源代码相对应的机器码中 0 和 1 序列 的执行 在调试过程中, 您可以测试代码以观察变量在程序执行过程中各个点的值 进行 what if 检查 更改变量值和单步调试程序 4. 将代码 烧写 到单片机中, 验证其在最终的应用中是否能正确执行 当然, 其中的每个步骤都可能非常复杂 重要的是必须关注设计中的细节, 并依靠 MPLAB IDE 及其组件来完成每个步骤, 这样就不会不断地将时间浪费在学习上 DS51519A_CN 第 12 页 2005 Microchip Technology Inc.

21 MPLAB IDE 简介 虽然可使用 MPLAB IDE 对电路和代码进行建模, 以便做出关键的设计决定, 步骤 1 仍需由设计人员完成 MPLAB IDE 真正起帮助作用的是在步骤 2 到步骤 5 它的程序编辑器有助于使用选定的语言工具编写正确的代码 编辑器可以识别汇编器和编译器的编程语法结构, 从而自动将源代码以不同颜色区分, 这有助于确保代码在语法上的正确性 项目管理器有助于组织应用程序中使用的各种文件 : 源文件 处理器描述头文件以及库文件 编译了代码之后, 您还可以控制编译器以何种程度优化代码大小或执行速度, 以及将在器件中的哪些部分存储各个变量及程序数据 您也可以指定 存储器模型 以使您的应用能最佳地利用单片机的存储器 如果在编译应用程序时语言工具报错, 则会显示出错的行, 双击它即可转到对应的源文件, 以便立即编辑 编辑后, 可以按 build ( 编译 ) 按钮再次尝试 由于要编写和测试很多子程序段, 因此复杂的代码通常会经过许多次这样的编写 编译 修正过程 MPLAB IDE 会以最快的速度执行这一过程, 从而使您能够尽快转入下一个步骤 代码编译没有错误之后, 还需要对其进行测试 MPLAB IDE 具有称为 调试器 的组件和免费的软件模拟器, 以帮助所有的 PICmicro 和 dspic 器件测试代码 即使当硬件还没有完成时, 您也可以使用软件模拟器开始测试代码 软件模拟器就是一种模拟单片机执行的软件 软件模拟器可以接收模拟输入 ( 激励信号 ), 以便模拟固件对外部信号的响应 软件模拟器可以测试代码执行时间 单步调试代码以观察变量和外设, 并跟踪代码以生成详细的程序运行记录 一旦硬件进入样机阶段, 就可以使用诸如 MPLAB ICE 或 MPLAB ICD 2 的硬件调试器了 这些调试器在实际的应用上实时运行代码 MPLAB ICE 实际上取代了目标板上的单片机, 它使用高速仿真头对设计中的硬件进行完全控制 MPLAB ICD 2 则使用在许多带有闪存程序存储器的 Microchip MCU 中内置的特殊电路, 并且能 检查 目标单片机中的程序和数据存储器 MPLAB ICD 2 可以停止和开始执行程序, 使您可以直接使用应用板上的单片机测试代码 应用程序正确运行之后, 就可以使用某一 Microchip 器件编程器来对单片机编程了, 如 PICSTART Plus 或 MPLAB PM3 这些编程器可以验证将要执行的最终代码和所设计的是否一致 MPLAB IDE 支持大多数 PICmicro MCU 和所有的 dspic 数字信号控制器 2005 Microchip Technology Inc. DS51519A_CN 第 13 页

22 MPLAB IDE 用户指南 1.2 开发周期 编写应用程序的过程通常被称为开发周期 因为第一次就可以完成从设计到实现的所有步骤而不出任何差错是很少的 通常, 编写代码之后要进行测试和修改才能生成正确执行的应用程序 集成开发环境让嵌入式系统设计工程师能够顺利完成这种开发周期, 而不会因为要在各种工具之间切换而分心 使用 MPLAB IDE, 所有功能都集成在一起, 工程师就可以专心完成应用程序, 而不会因为要切换不同的工具和操作模式而中断开发 图 1-5: 设计周期 编译 / 汇编 / 链接代码 将代码下载到调试器 编辑 / 创建 / 设计源代码 分析 / 调试代码 IDE 就是一种 包装器 (wrapper), 它协调同一图形用户界面的所有工具 这一过程通常是自动完成的 例如, 一旦代码编写完成, 就可以将其转换为可执行指令, 并下载到单片机中观察它的运行 这一过程需要多种工具 : 编写代码的编辑器 管理文件及设置的项目管理器 将源代码转换为机器码的编译器或汇编器, 以及多种连接到目标单片机的硬件或用来模拟单片机运行的软件 DS51519A_CN 第 14 页 2005 Microchip Technology Inc.

23 MPLAB IDE 简介 1.3 项目管理器 项目管理器管理要编辑的文件和其他相关文件, 以便将这些文件送至语言工具进行汇编或编译, 并最终送至链接器 链接器的任务是将来自汇编器 编译器和库的目标代码片段存放到嵌入式控制器的恰当存储区, 并确保各个模块之间可以相互协调 ( 或 链接在一起 ) 从汇编 编译到链接的整个操作过程被称为项目 build 使用 MPLAB 项目管理器, 每个文件可以根据需要调用不同的语言工具 并且编译过程会将所有的语言工具操作集成到一起 图 1-6: MPLAB 项目管理器 源文件 汇编器编译器 各编译选项 MPLAB 项目管理器 目标文件库 链接描述文件 链接器 调试文件 可执行文件 源文件是遵从汇编器或编译器规则编写的文本文件 汇编器和编译器将源文件转换为中间模块机器码和占位符, 以作为函数和数据存储的参考 链接器解析这些占位符, 并将所有模块合并为一个可执行的机器码文件 链接器还会生成一个调试文件, 允许 MPLAB IDE 将正在执行的机器码与源文件相关联 文本编辑器用于编写代码 这不是普通的文本编辑器, 而是专门为编写 Microchip MCU 的代码而设计的编辑器 它可以识别文本中的语法结构, 并采用彩色编码来区分各种元素, 如指令助记符 C 语言结构和注释 编辑器支持编写源代码常用的操作, 如查找 C 语言中的匹配花括号 注释和取消注释代码段 查找多个文件中的文本以及添加特殊书签等 编写好代码之后, 编辑器可以配合其他工具, 显示调试器中代码的执行 编辑器中可以设置断点, 而且将鼠标指针悬停在变量名上方还可以查看变量的值 可以将源代码窗口中的变量名拖拽到 Watch ( 观察 ) 窗口中 2005 Microchip Technology Inc. DS51519A_CN 第 15 页

24 MPLAB IDE 用户指南 1.4 语言工具 语言工具就是诸如交叉汇编器和交叉编译器的程序 大多数人都比较熟悉在 PC 机上运行的语言工具, 比如 Visual Basic 或 C 编译器 当使用嵌入式系统的语言工具时, 就会使用 交叉汇编器 或 交叉编译器 这些工具与常见编译器的区别在于, 它们在 PC 机上运行, 但生成的代码却在其他微处理器 ( 单片机 ) 上运行, 即它们为单片机交叉编译代码, 单片机使用与 PC 机完全不同的指令集 语言工具还会生成调试文件, MPLAB IDE 使用这个文件将机器指令和存储单元与源代码相关联 这种集成让 MPLAB 编辑器能够设置断点, 允许在 watch 窗口中查看变量的内容, 并允许您单步调试源代码, 观察应用程序的执行 嵌入式系统语言工具与在 PC 机上运行和执行的编译器还有一点不同, 那就是对空间非常敏感 生成的代码量越小越好, 因为这样可以尽可能的减少目标对存储器的占用, 从而降低成本 这就意味着需要一种使用特定于机器的知识来优化和增强代码的技术 对于 PC 机, 复杂程度适中的程序通常就会大到数兆字节 而简单的嵌入式系统程序则可以小至几千字节, 甚至更小 中等规模的嵌入式系统可能需要 32K 或 64K 的代码, 以实现相对复杂的功能 某些嵌入式系统会使用数兆字节的空间, 以存储大型表 用户文本消息或数据日志 图 1-7: 编译器将源代码转换为机器指令 } } int main(void) { counter = 1 ; TRISB = 0 ; while (input1 = 0) { PORTB = count ; counter++ ; 编译器 Compiler DS51519A_CN 第 16 页 2005 Microchip Technology Inc.

25 MPLAB IDE 简介 1.5 目标调试 在开发环境中, 代码的执行是在调试器中测试的 调试器可以是软件程序, 用来模拟单片机的操作以便进行测试, 也可以是特殊的仪器, 用来分析在应用程序中执行的代码 MPLAB IDE 中内置了软件模拟器, 因此不需要任何其他硬件就可以对程序进行测试 软件模拟器是一种软件调试器, 软件模拟器的调试功能与硬件调试器的功能几乎完全相同, 学习起来非常容易 由于软件模拟器使用 PC 机中的 CPU 来模拟单片机的操作, 因此它通常比实际单片机运行得要慢一些 MPLAB IDE 为所有的 PICmicro 和 dspic 处理器提供了许多软件模拟器 在 MPLAB IDE 中, 您可以使用两种类型的硬件 : 编程器和硬件调试器 编程器直接将机器码从 PC 机传送到目标单片机的片内存储器中 然后就可以将单片机插入到应用中了, 并希望单片机中的程序能够按设计运行 但是, 代码通常都不会完全按照预期运行, 设计人员需要检查代码及其在应用中的运行状况, 以决定如何修改源代码, 使之能够按预期运行 这个过程被称为调试 如前所述, 软件模拟器可以用于测试代码的运行, 但是一旦向单片机烧写了固件, 就由软件模拟器之外的很多因素发挥作用了 仅使用编程器, 虽然可以更改代码, 并将其重新烧写到单片机, 然后插入目标进行重新测试, 但如果代码比较复杂, 这个过程就非常费时费力, 而且很难弄清楚硬件中究竟发生了什么问题 在这种情况下, 硬件调试器就非常有用了 硬件调试器可以是在线仿真器, 它使用专用硬件来代替实际的目标单片机 它也可以是在线调试器, 使用具有特殊内置调试功能的单片机 硬件调试器和软件模拟器一样, 允许设计人员检查当代码执行到各个点时的变量, 单步调试程序以检查硬件与专用电路交互时的指令 在项目设计周期的末期, 调试通常会变得紧迫 随着交付期的临近, 让应用程序按最初设计运行是部署产品之前的最后一步, 这通常是使产品交付延期的最大因素 这就是集成开发环境最重要之处 调试和修改代码 重新编译 下载和测试 所有都需要时间 在一个环境中使用所有工具可以减少该 周期 的时间 能否在最后这几个步骤中找出关键错误对嵌入式系统设计人员是一种考验 使用正确的工具可以节省时间 使用 MPLAB IDE 可以选择多种工具, 不过这些工具的界面都是类似的, 因此从软件模拟器到低成本的在线调试器再到强大的在线仿真器的学习过程也会比较简单 2005 Microchip Technology Inc. DS51519A_CN 第 17 页

26 MPLAB IDE 用户指南 1.6 对器件编程 1.7 MPLAB IDE 的组件 应用程序经过调试并在开发环境中运行后, 还需要对其进行测试 可以使用在线调试器或器件编程器对器件进行编程 MPLAB IDE 可以设置为编程器功能, 从而为器件烧写程序 目标应用程序现在可视为接近完成的状态 样机开发编程器可以快速制作和评估样机 某些应用程序可以在器件焊接到目标板上之后进行编程 使用在线串行编程 (In-Circuit Serial Programming, ICSP ), 可以在生产过程中将固件编程到应用中, 从而能够在嵌入式应用开发的末期将更新的版本编程到嵌入式应用中 支持在线调试的器件甚至可以在生产完成后重新插入到 MPLAB ICD 2 中, 以进行质量检测和下一代固件的开发 MPLAB IDE 具有内置组件和插入模块来为系统配置各种软件和硬件工具 MPLAB IDE 内置组件 内置组件包括 : 项目管理器项目管理器提供 IDE 和语言工具之间的集成和通信 编辑器编辑器是功能全面的程序文本编辑器, 它还可以作为调试器的窗口使用 汇编器 / 链接器和语言工具汇编器可以单独使用来汇编单个文件, 也可以与链接器配合使用, 以从不同的源文件 库和重新编译的目标文件生成一个项目 链接器负责将编译后的代码分配到目标单片机的存储区中 调试器 Microchip 调试器允许使用断点 单步调试 watch 窗口以及目前 MPLAB IDE 调试器中的所有功能 将它与编辑器配合使用, 可以将正在调试的目标中的信息与源代码相关联 执行引擎 MPLAB IDE 中具有适用于所有 PICmicro 和 dspic 器件的软件模拟器 这些软件模拟器使用 PC 机来模拟 PICmicro 和 dspic 器件的指令和某些外设功能 还可以使用可选的在线仿真器和在线调试器通过在应用硬件中运行代码来测试代码 DS51519A_CN 第 18 页 2005 Microchip Technology Inc.

27 MPLAB IDE 简介 1.8 MPLAB IDE 文档 1.9 MPLAB IDE 在线帮助 MPLAB IDE 的其他可选组件 您可以选购以下组件并将它们添加到 MPLAB IDE 中 : 编译器语言工具 Microchip 的 MPLAB C17 MPLAB C18 和 MPLAB C30 可以提供高度集成的优化代码 MPLAB IDE 项目管理器可以调用这些编译器以及 HI-TECH IAR microengineering Labs CCS 和 Byte Craft 生产的编译器, 来编译自动载入到目标调试器中的代码, 进行即时测试和校验 编程器 PICSTART Plus PRO MATE II MPLAB PM3 以及 MPLAB ICD 2 都可以将代码编程到目标单片机中 MPLAB IDE 提供了对代码和数据编程的完全控制, 还可以使用 MPLAB IDE 对配置位进行设置来设定目标单片机的各种操作模式 在线仿真器 MPLAB ICE 2000 和 MPLAB ICE 4000 是功能全面的适用于 PICmicro 和 dspic 器件的仿真器 它们通过 I/O 端口与 PC 机相连, 可以对目标应用中的单片机操作进行完全控制 在线调试器 MPLAB ICD 2 提供了一种取代仿真器的经济方案 通过使用部分片上资源, MPLAB ICD 2 可以将代码下载到被插入到应用中的目标单片机中, 并设置断点, 单步调试和监视寄存器及变量 现有以下文档可帮助您使用 MPLAB IDE: MPLAB IDE Quick Chart (DS51410) MPLAB IDE 快速入门指南 (DS51281C_CN) MPLAB IDE 用户指南 (DS51519A _CN) 与 MPLAB IDE 配合使用的各种 Microchip 软件和硬件工具也存在相应文挡 请访问 Microchip 网站获取这些文档的可下载 pdf 版本 由于 MPLAB IDE 还在不断地更改中 ( 请参阅第 1.10 节 MPLAB IDE 更新和版本编号 ), 本文中提到的部分细节可能会有所改变 对话框的外观可能与本手册中介绍的不完全一致, 菜单列表的顺序也可能不同, 或是增加了新的项 因此, 在线帮助是您当前使用的 MPLAB IDE 版本的最佳参考 MPLAB IDE 具有大量的在线帮助, 处在不断更新之中 如果在使用 MPLAB IDE 时遇到了问题, 一定要查看在线帮助寻找答案 最重要的是, 在线帮助列出了特定工具在支持特定器件时可能存在的任何限制 在使用新的器件 / 工具组合之前, 请始终尝试查看这部分内容 Debugger>Settings 对话框的 Limitations ( 限制 ) 选项卡给出了软件模拟器 仿真器或在线调试器与正在被模拟的实际器件相比可能存在的任何限制 一般限制则显示在文本区中 2005 Microchip Technology Inc. DS51519A_CN 第 19 页

28 MPLAB IDE 用户指南 图 1-8: DEBUGGER>SETTINGS:LIMITATIONS 选项卡 按下 Details ( 详情 ) 按钮, 显示与要被调试的器件相关的具体限制 从这里显示的信息中还可以看到与调试器相关的一般限制 图 1-9: 软件模拟器限制详细信息 DS51519A_CN 第 20 页 2005 Microchip Technology Inc.

29 MPLAB IDE 简介 从 MPLAB IDE 的 Help ( 帮助 ) 菜单, 选择 Help>Topics, 获取 MPLAB IDE 及其所有组件的帮助列表 图 1-10: MPLAB IDE HELP>TOPICS 菜单 MPLAB IDE 帮助涵盖了 MPLAB IDE 的各个方面以及所有的 Microchip 工具 可以按目录或索引方式离线查看它, 也可以使用搜索实用程序查找有关任何 MPLAB IDE 主题的帮助 MPLAB IDE 帮助还可以指引用户获取其他类型的帮助, 如 Microchip Update Notification system (Microchip 更新通知系统 ) 图 1-11: MPLAB IDE HELP 对话框 2005 Microchip Technology Inc. DS51519A_CN 第 21 页

30 MPLAB IDE 用户指南 1.10 MPLAB IDE 更新和版本编号 MPLAB IDE 是一个不断改进的程序, 具有成千上万的用户 Microchip 在不断地设计具有新功能的新型单片机 许多新的 MPLAB IDE 功能都源自客户的需求和内部使用 不断开发的新设计和发布的新单片机促使 MPLAB IDE 将不断改进 MPLAB IDE 计划大约每四个月更新一次, 以便增加新的器件支持和新的功能 此外, 在两个主要的发行版之间, 还会发布另外的 临时 发行版 MPLAB IDE 的版本编号方案可以反映出当前版本属于主要产品发行版还是临时发行版 如果版本号以零结束, 即 MPLAB IDE v6.50 v.6.60 或 v7.00, 则表示该版本是主要的产品发行版 如果版本号以零以外的数字结束, 即 v6.41 v6.52 或 v7.55, 则表示该版本是临时发行版 临时发行版主要是为了提供对新器件或组件的早期试用, 或进行快速重要修正及新功能的预演 这种临时发行版并没有经过如产品发行版那样的完整测试, 因此建议不要在严格的设计中使用这种版本 我们建议在开发过程中使用产品发行版, 除非是在使用了新器件或组件, 或是遇到了临时发行版中已修正的某个问题时, 才使用临时发行版以有效利用 MPLAB IDE MPLAB IDE 软件的每一次新的发布都实现了新的功能, 因此印刷文档的内容肯定会比在线帮助滞后 在线帮助是解决有关 MPLAB IDE 中任何问题的最好参考 要在 MPLAB IDE 及其组件更新时得到通知, 请在 网站上订阅 客户变更通知 服务的 Development Tools 部分 DS51519A_CN 第 22 页 2005 Microchip Technology Inc.

31 第 2 章 MPLAB IDE 入门 : 基础教程 MPLAB IDE 用户指南 2.1 简介 MPLAB 集成开发环境 (IDE) 是一个综合的编辑器 项目管理器和设计平台, 适用于使用 Microchip PICmicro 和 dspic 单片机进行嵌入式设计的应用开发 本章讲述了 MPLAB IDE 的初步使用 本简短教程将讲述如何创建项目 编辑代码和测试应用程序 学习完本教程后, 就可以快速了解项目管理器 编辑器和调试器的基本概念 在后面的章节中还会讲述 MPLAB IDE 的完整功能 本节将详细说明 MPLAB IDE 的安装和卸载 接下来是介绍创建项目和说明 MPLAB IDE 基本调试功能的简单逐步教程 学习完教程后, MPLAB IDE 的新手将对使用此系统开发应用有一个基本的了解 无需前面的知识, 以及 MPLAB IDE 及其组件的综合技术细节, 就可形成使用 MPLAB IDE 的基本框架 本教程将涉及以下基本步骤 : MPLAB IDE 的功能和安装 教程概述 选择器件 创建项目 设置语言工具 为项目命名 创建代码 再次编译项目 使用软件模拟器测试代码 教程总结 2005 Microchip Technology Inc. DS51519A_CN 第 23 页

32 MPLAB IDE 用户指南 2.2 MPLAB IDE 的功能和安装 MPLAB IDE 是基于 Windows 操作系统的集成开发环境, 适用于 PICmicro MCU 系列和 dspic 数字信号控制器的开发 MPLAB IDE 提供以下功能 : 使用内置的编辑器创建和编辑源代码 汇编 编译和链接源代码 通过使用内置的软件模拟器观察程序流程, 或者使用在线仿真器或在线调试器以实时方式观察程序流程来调试可执行逻辑 用软件模拟器或仿真器进行时序测量 查看 Watch 窗口中的变量 使用器件编程器将固件烧写入器件 ( 欲知详细信息, 请查阅具体的器件编程器的用户手册 ) 注 : MPLAB IDE 也支持部分第三方工具 详情请查阅发行声明或自述文件 安装 / 卸载 MPLAB IDE 要在系统上安装 MPLAB IDE: 注 : 对于某些 Windows 操作系统, 需要管理员权限才能在个人计算机上安装软件 若想从光盘安装, 请将安装光盘放入光驱 遵循屏幕上的菜单来安装 MPLAB IDE 若未出现屏幕菜单, 请使用 Windows 资源管理器 进行查找并执行 CD-ROM 中的可执行文件 menu.exe 若想从 Microchip 网站 ( 下载 MPLAB IDE, 请找到下载 (.zip) 文件, 选择该文件然后将它保存到计算机 将该文件解压缩并执行解压缩后的文件来进行安装 要卸载 MPLAB IDE: 选择开始 > 设置 > 控制面板, 打开控制面板 双击 添加 / 删除程序 在列表中找到 MPLAB IDE 并单击它 单击更改 / 删除将该程序从系统中删除 DS51519A_CN 第 24 页 2005 Microchip Technology Inc.

33 MPLAB IDE 入门 : 基础教程 运行 MPLAB IDE 软件安装后, 要启动 MPLAB IDE, 双击桌面上的图标或选择 Start>Programs>Microchip MPLAB IDE vx.x>mplab IDE vx.x 屏幕会显示 MPLAB IDE 徽标并随后显示 MPLAB IDE 界面 ( 图 2-1) 图 2-1: MPLAB IDE 界面 2.3 教程概述 要创建目标 PICmicro MCU 可执行的代码, 需要将源文件添加到项目中, 然后可以使用选定的语言工具 ( 汇编器 编译器和链接器等 ) 将代码编译为可执行代码 在 MPLAB IDE 中, 由项目管理器控制这一过程 所有项目均具有以下基本步骤 : 选择器件 MPLAB IDE 的功能根据所选择的器件而有所不同 应该在开始项目之前完成器件选择 创建项目将使用 MPLAB 项目向导来创建项目 选择语言工具将在项目向导中选择语言工具 就本教程而言, 将使用内置的汇编器和链接器 而在其他项目中, 也许需要选择 Microchip 的某一编译器或其他第三方工具 将文件添加到项目将在项目中添加两个文件, 一个模板文件和一个链接描述文件 这两个文件都位于 MPLAB IDE 文件夹的子文件夹中 使用这两个文件, 开始项目就容易多了 创建代码将向模板文件添加一些代码, 从 I/O 端口发出一个递增的值 编译项目 2005 Microchip Technology Inc. DS51519A_CN 第 25 页

34 MPLAB IDE 用户指南 将编译项目 使源文件被汇编和链接成可以在选定的 PICmicro MCU 上运行的机器码 使用软件模拟器测试代码最后, 将使用软件模拟器测试代码 项目向导将轻松地指导我们完成大部分的步骤 注 : 在今后的产品发布中用户界面中的某些部分可能会有所更改, 并且本教程中的屏幕截图可能也会与以后发布的 MPLAB IDE 界面不完全相符 随着更多器件的发布, 将会添加新的功能 本教程中描述的任何功能均不会被删除, 并且可能添加更多的功能 在线帮助是当前版本的 MPLAB IDE 最新的参考资料 DS51519A_CN 第 26 页 2005 Microchip Technology Inc.

35 MPLAB IDE 入门 : 基础教程 2.4 选择器件 为了在本文档中显示菜单选择的过程, MPLAB IDE 中顶行菜单中的菜单项, 将会显示在菜单名之后, 如 MenuName>MenuItem 要在 Configure ( 配置 ) 菜单中选择 Select Device ( 选择器件 ), 将写作 Configure>Select Device 请选择 Configure>Select Device 图 2-2: 选择器件 2005 Microchip Technology Inc. DS51519A_CN 第 27 页

36 MPLAB IDE 用户指南 如果还未选择器件, 请从 Device ( 器件 ) 对话框的下拉列表中选择 PIC18F452 图 2-3: SELECT DEVICE 对话框 指示灯 表示支持此器件的 MPLAB IDE 组件 绿灯表示完全支持 黄灯表示对即将发布的器件的最小支持, 当前版本的某一 MPLAB IDE 组件可能不支持该器件 有黄灯而不是绿灯的组件通常是针对新器件的早期采用者, 他们需要这些器件的支持并明白某些操作和功能是不可用的 红灯表示不支持这种器件 将来可能会提供支持或者该工具根本不适合该器件, 例如, MPLAB ICE 2000 不支持 dspic 器件 DS51519A_CN 第 28 页 2005 Microchip Technology Inc.

37 MPLAB IDE 入门 : 基础教程 2.5 创建项目 下一步, 使用项目向导创建项目 项目是将文件组织起来以便进行编译和汇编的方式 我们将使用一个用于该项目的汇编文件和一个链接描述文件 选择 Project>Project Wizard 在 Welcome ( 欢迎 ) 对话框中, 单击 Next> 继续 下一个对话框 (Step One ( 第一步 )) 让您选择器件 ( 已选定 ) 确定所选择的是 PIC18F452 否则, 请在下拉列表中选择 PIC18F452 单击 Next> 图 2-4: 项目向导 选择器件 2005 Microchip Technology Inc. DS51519A_CN 第 29 页

38 MPLAB IDE 用户指南 2.6 设置语言工具 Project Wizard 的第二步设置该项目所要使用的语言工具 在 Active Toolsuite ( 可用工具包 ) 列表框中选择 Microchip MPASM Toolsuite (Microchip MPASM 工具包 ) 然后应可在 Toolsuite Contents ( 工具包内容 ) 框中看到 MPASM 和 MPLINK 可以单击任一个查看其位置 如果将 MPLAB IDE 安装到了默认目录, 则 MPASM 汇编器的可执行文件位于 : C:\Program Files\MPLAB IDE\MCHIP_Tools\mpasmwin.exe MPLINK 链接器的可执行文件位于 : C:\Program Files\MPLAB IDE\MCHIP_Tools\mplink.exe 以及 MPLIB 库管理器的可执行文件位于 : C:\Program Files\MPLAB IDE\MCHIP_Tools\mplib.exe 如果未正确显示, 使用 Browse ( 浏览 ) 按钮将它们设置为 MPLAB IDE 子文件夹中的相应文件 图 2-5: 项目向导 选择语言工具 完成后, 单击 Next> DS51519A_CN 第 30 页 2005 Microchip Technology Inc.

39 MPLAB IDE 入门 : 基础教程 2.7 为项目命名 向导的第三步让您为项目命名并将它存入文件夹 这个示例项目将被命名为 MyProject 使用 Browse 按钮, 将项目放在名为 Projects32 的文件夹中 单击 Next> 图 2-6: 项目向导 为项目命名 2005 Microchip Technology Inc. DS51519A_CN 第 31 页

40 MPLAB IDE 用户指南 2.8 将文件添加到项目中 Project Wizard 的第四步允许为项目选择文件 由于还未选择源文件, 我们将使用 MPLAB IDE 模板文件 这些模板文件是用于开始项目的简单文件 它们具有任何源文件的基本部分并且包含可帮助您编写和组织代码的信息 这些文件在 MPLAB IDE 文件夹中, 默认情况下该文件夹位于个人计算机的 Program Files 文件夹中 每个 Microchip PICmicro 和 dspic 器件都有一个模板文件 选择名为 f452tmpo.asm 的文件 如果将 MPLAB IDE 安装在了默认位置, 则该文件的完整路径为 : C:\Program Files\MPLAB IDE\MCHIP_Tools\TEMPLATE\Object\f452tmpo.asm 图 2-7: 项目向导 选择模板文件 单击 Add>> ( 添加 ) 将文件名移到右边的窗格中, 然后单击文件名前面的复选框将此文件复制到项目目录 接下来, 添加项目的第二个文件 : 链接描述文件 每个器件都有一个链接描述文件 这些文件定义各个器件的存储器配置和寄存器名称 链接描述文件在 MCHIP_Tools 文件夹下的 LKR 子文件夹中 本项目使用名为 18F452.lkr 的文件 该文件的完整路径如下 : C:\Program Files\MPLAB IDE\MCHIP_Tools\LKR\18F452.lkr 注 : 还有一个名为 18F452i.lkr 的链接描述文件, 在使用 MPLAB ICD 2 ( 所以名称中有 i ) 时, 用于此器件 该链接描述文件为 MPLAB ICD 2 保留了存储区 由于本例将使用软件模拟器, 因此不需要使用该链接描述文件 要将链接描述文件复制到项目中, 请单击对应的复选框 DS51519A_CN 第 32 页 2005 Microchip Technology Inc.

41 MPLAB IDE 入门 : 基础教程 图 2-8: 项目向导 选择链接描述文件 确保您的对话框类似于上图, 选中这两个复选框, 然后单击 Next> 完成项目向导 项目向导的结束屏幕是一个摘要, 显示了所选择的器件 工具包和新项目文件名 图 2-9: 项目向导 摘要 2005 Microchip Technology Inc. DS51519A_CN 第 33 页

42 MPLAB IDE 用户指南 在单击了 Finish ( 完成 ) 按钮之后, 复查 MPLAB IDE 界面上的项目窗口 它看起来应该如图 2-10 所示 如果此项目窗口未打开, 请选择 View>Project 图 2-10: 项目窗口 提示 : 可以通过在项目窗口中使用鼠标右键来添加文件和保存项目 发生错误时, 可以通过选择文件并使用单击鼠标右键出现的菜单来手动删除它们 2.9 编译项目 使用 Project ( 项目 ) 菜单可以汇编和链接当前文件 虽然这些文件中还没有任何代码, 但确保了项目是正确设置的 要编译项目, 可选择以下任一种方式 : Project>Build All 在项目窗口中右击项目名称并选择 Build All ( 编译所有 ) 在项目工具栏中单击 Build All 图标 将鼠标悬停在图标上即可看到弹出的文本, 显示该图标的含义 Output ( 输出 ) 窗口将显示编译的结果 在任何一步中, 应该都没有错误 图 2-11: OUTPUT 窗口 DS51519A_CN 第 34 页 2005 Microchip Technology Inc.

43 MPLAB IDE 入门 : 基础教程 2.10 创建代码 通过在项目窗口中双击模板文件名, 或者通过用光标选择模板文件并用鼠标右键打开上下文菜单, 可打开项目中的模板文件 : 图 2-12: 项目上下文菜单 ( 单击鼠标右键 ) 在此文件的开头有一些注释, 并且此区域可被用作文件的标准注释信息头 现在您可以不管它, 但如果这是一个实际的项目, 您可以在这里输入与设计有关的信息 注 : 图 2-13: 此处显示行数 可以通过右击编辑器窗口, 选择 Properties ( 属性 ), 然后在 Editor Options ( 编辑器选项 ) 对话框的 Editor ( 编辑器 ) 选项卡中选中 / 清除 Line Numbers ( 行数 ) 复选框, 来显示或隐藏行数 模板文件 向下滚动到文件底部 2005 Microchip Technology Inc. DS51519A_CN 第 35 页

44 MPLAB IDE 用户指南 文件第一部分的代码用于较高级的功能, 如在最终应用程序中设置中断和配置位 现在可以忽略这些细节而只专注于编写代码 新代码将放在文件中符号 Main 之后 图 2-14: 模板文件 MAIN 打开任何源文件就可以自动进入编辑器 输入以下代码 : Main: clr f movwf movwf Init clrf IncCount incf movf movwf WREG PORTC; clear PORTC TRISC; configure PORTC as all outputs COUNT COUNT COUNT,W PORTC; display COUNT on PORTC calldelay goto IncCount; infinite loop Delay movlw 0x40; set outer delay loop movwf DVAR2 Delay0 movlw 0xFF movwf DVAR; set inner delay loop Delay1 decfsz DVAR goto Delay1 decfsz DVAR2 goto Delay0 return DS51519A_CN 第 36 页 2005 Microchip Technology Inc.

45 MPLAB IDE 入门 : 基础教程 现在模板文件应如图 2-15 所示 图 2-15: 模板文件 添加代码 在这个简短的代码中, 我们使用了三个变量, 分别为 COUNT DVAR 和 DVAR2 需要在模板文件中名为 UDATA 的未初始化数据段中定义这些变量 在模板文件的该段中已有三个变量, 因此使用相同的格式把我们的变量加在后面即可 每个变量都是 8 位的, 因此, 只需要为每个变量保留 1 个字节 图 2-16: 模板文件 添加变量 添加这三行 2005 Microchip Technology Inc. DS51519A_CN 第 37 页

46 MPLAB IDE 用户指南 2.11 再次编译项目 选择 Project>Build All 汇编和链接代码 如果代码汇编的过程没有出错, Output 窗口就如图 2-17 所示 : 图 2-17: 编译完成后的 OUTPUT 窗口 如果汇编和链接不成功, 检查以下各项然后再次编译项目 : 检查在编辑器窗口中输入的代码的拼写和格式 确认新变量和特殊功能寄存器 TRISC 和 PORTC 是大写的 如果汇编器在 Output 窗口中报错, 双击错误, MPLAB IDE 就会打开源代码窗口, 并在左边空白处用绿色箭头指向源代码中相应的行 检查是否为 PICmicro 器件使用了正确的汇编器 (MPASM 汇编器 ) 和链接器 选择 Project>Set Language Tool Locations 单击 + 号框以展开 Microchip MPASM Toolsuite 及其 Executables 单击 MPASM Assembler (mpasmwin.exe) 然后检查显示的位置 如果位置正确, 单击 Cancel 如果不正确, 更改位置然后单击 OK 默认搜索路径可能为空 在成功编译项目后, 会加载语言工具生成的输出文件 此文件包含可被编程到 PICmicro MCU 的目标代码和调试信息, 便于调试源代码并在 Watch 窗口中以符号的形式查看源变量 注 : 在现实应用中, 需要将多个文件编译 / 汇编和链接成最终的可执行应用程序时, 项目的真正作用非常明显 项目会跟踪所有这些过程 可为每个文件设置 Bulid Options ( 编译选项 ) 来访问语言工具的其他功能, 如报告输出和编译器优化 DS51519A_CN 第 38 页 2005 Microchip Technology Inc.

47 MPLAB IDE 入门 : 基础教程 2.12 使用软件模拟器测试代码 要测试代码, 就需要用于执行 PICmicro 指令的软件或硬件 调试执行工具, 就是一种硬件或软件工具, 用于在程序 ( 在本例中, 为 cnt452.asm) 执行过程中检查代码 硬件工具 ( 如 MPLAB ICE 或 MPLAB ICD 2) 可以在实际的器件中执行代码 如果没有硬件调试器, 可以使用 MPLAB 软件模拟器来测试代码 本教程使用的就是 MPLAB SIM 软件模拟器 软件模拟器是在个人计算机上运行的软件程序, 它用于模拟 PICmicro MCU 的指令 它并不是 实时 运行的, 因为软件模拟器程序的运行速度取决于计算机的速度 代码的复杂性 操作系统的开销以及正在运行的其他任务的数目 但是, 软件模拟器可精确测量代码在应用中实时运行时, 所需要的时间 注 : 其他调试执行工具还包括 MPLAB ICE 2000 MPLAB ICE 4000 和 MPLAB ICD 2 可以选择一些硬件工具来测试应用板上的代码 大部分 MPLAB IDE 调试操作和软件模拟器一样, 但是与软件模拟器不同的是, 这些工具允许目标 PICmicro MCU 以实际目标应用中的全速运行 选择软件模拟器作为调试执行工具 这可以通过 Debugger>Select Tool 下拉菜单完成 在选择了 MPLAB SIM 之后, 应可看到以下变化 ( 参见图 2-18 中的相应编号 ) MPLAB IDE 窗口底部的状态栏应该变为 MPLAB SIM 现在 Debugger ( 调试器 ) 菜单中应该会出现更多菜单项 调试工具栏中应该会出现更多工具栏图标 提示 : 若将鼠标指针悬停于工具栏按钮之上, 即可看到有关该按钮功能的简单描述 图 2-18: MPLAB SIM 作为调试器时的 MPLAB IDE 界面 Microchip Technology Inc. DS51519A_CN 第 39 页

48 MPLAB IDE 用户指南 接下来, 选择 Debugger>Reset, 就会在程序开始之处显示一个绿色箭头 这是模板文件的一部分 此时存储器中的第一条指令将跳至名为 Main 的标号处 ( 您已在此处插入了代码 ) 该指令跳过存储器中地址较低的 PIC18XXXX 向量区 图 2-19: DEBUG>RESET 要单步执行应用程序, 请选择 Debugger>Step Into 这将执行当前指向的代码行, 然后箭头将指向要执行的下一行代码 这些常用功能在调试工具栏中也有快捷方式 表 2-1: 调试快捷方式图标 Debugger 菜单 工具栏按钮 热键 Run ( 运行 ) F9 Halt ( 暂停 ) F5 Animate ( 单步连续运行 ) Step Into ( 单步运行 ) F7 Step Over ( 单步跳过 ) F8 Step Out Of ( 单步跳出 ) Reset ( 复位 ) F6 提示 : 单击工具栏上相应的图标或者使用菜单项旁边显示的热键 这通常是重复操作的最佳方法 DS51519A_CN 第 40 页 2005 Microchip Technology Inc.

49 MPLAB IDE 入门 : 基础教程 接下来, 单击 Step Into 图标或选择 Debugger>Step Into 来单步运行 Main 中的代码 图 2-20: DEBUG>STEP INTO 为了查看代码是否按照预期运行, 可以向 PORTC 发送递增值, 然后观察发送到 PORTC 的值 选择 View>Watch 打开一个空的 Watch 窗口 在 Watch 窗口的顶部有两个下拉列表 左边标注为 Add SFR 的下拉列表可用于将特殊功能寄存器 PORTC 添加到 Watch 窗口 从列表中选择 PORTC, 然后单击 Add SFR ( 添加特殊功能寄存器 ) 将它添加到窗口 图 2-21: WATCH 选择 PORTC 2005 Microchip Technology Inc. DS51519A_CN 第 41 页

50 MPLAB IDE 用户指南 右边的下拉列表允许添加程序中的变量 使用此下拉列表将 COUNT 变量添加到 Watch 窗口 从列表中选择 COUNT, 然后单击 Add Symbol ( 添加变量 ) 将它添加到窗口 图 2-22: WATCH 选择变量 COUNT Watch 窗口现在应显示两个寄存器的地址 值和名称 在程序执行的当前时刻, 它们均应为零 注 : 图 2-23: 也可以从 SFR File Register ( 文件寄存器 ) 或编辑器窗口中将这些项拖拽到 Watch 窗口, 或者直接在窗口中的 symbol name ( 符号名称 ) 下方单击, 然后输入这些项, 从而将它们添加到 Watch 窗口 WATCH 复位值 DS51519A_CN 第 42 页 2005 Microchip Technology Inc.

51 MPLAB IDE 入门 : 基础教程 可以继续单步执行代码, 但是请将断点设置在向 PORTC 发出第一个值之前 要设置断点, 请将光标放在要设置断点的行上, 然后单击鼠标右键 图 2-24: 调试上下文菜单 ( 在行上右击鼠标 ) 从上下文菜单中选择 Set Breakpoint ( 设置断点 ) 该行上会出现一个红色的 B ( 也可以在行上双击鼠标来添加断点 ) 图 2-25: 编辑器窗口 设置断点 选择 Debugger>Run 运行应用程序 在程序暂停在第一个断点之前, 状态栏上会短暂地显示文本消息 Running ( 运行 ) 2005 Microchip Technology Inc. DS51519A_CN 第 43 页

52 MPLAB IDE 用户指南 现在 Watch 窗口应显示变量 COUNT 的值已被加 1, 但是由于断点位于将值传给 PORTC 的代码执行前的那一行上, 因此 PORTC 的值仍为零 图 2-26: WATCH 执行到断点时 单击 Run 图标执行代码, 直到再次到达该断点 现在 Watch 窗口应显示两个值均被加 1 图 2-27: WATCH 下一次执行到该断点时 这似乎表示程序按照设计正常运行的 您可以单步运行代码或者多次运行代码以确认它是否正确执行 如果单步运行进入延时循环, 您将需要不断执行几千次单步运行, 才能结束循环 要跳出这种延时循环, 可以使用 Debugger>Step Out 如果对计算延时时间感兴趣, 可以使用数据手册确定运行延时循环中的每个指令所需要的时间并由此得出一个相当精确的数字 也可以使用 MPLAB StopWatch ( 跑表 ) 来测量延时时间 重点应该关注显示 COUNT 的每个新值时的时间 如果像最初那样在从 COUNT 移动到 PORTC 的指令上设置断点, 那么就可以运行程序到同一位置的下一个断点来测量该时间 DS51519A_CN 第 44 页 2005 Microchip Technology Inc.

53 MPLAB IDE 入门 : 基础教程 使用 Debugger>StopWatch 打开 StopWatch 对话框 确定在 movwf COUNT 指令处设置了断点, 然后依次单击 Debug>Reset 和 Debug>Run, 程序将在 movwf COUNT 指令处暂停 若采用默认的 4 MHz 的处理器频率, StopWatch 将显示到达第一个断点花了 8 us 图 2-28: STOPWATCH 在第一个断点处 再次执行 Run 来运行一次循环, StopWatch 显示它花费了 49ms 要更改此时间, 可以改变延时循环中的值 图 2-29: STOPWATCH 在延时之后 2.13 教程总结 通过学习本教程, 您已经执行了创建 编译和测试简单项目的主要步骤 完成的任务包括 : 选择器件, 即 PIC18F452 使用 Project Wizard 创建项目, 并使用该向导完成以下任务 : 选择 MPLAB IDE 中内置的 MPASM 汇编器和 MPLINK 链接器语言工具 ; 为项目添加文件 : 用于选定器件的模板文件和用于正确编译项目的链接描述文件 编写一些简单的代码, 将变化的值发往 I/O 端口 编译项目 最后, 使用软件模拟器测试代码 这些是开始使用 MPLAB IDE 的基本步骤 现在您已准备就绪, 可继续探索 MPLAB IDE 的功能了 2005 Microchip Technology Inc. DS51519A_CN 第 45 页

54 MPLAB IDE 用户指南 注 : DS51519A_CN 第 46 页 2005 Microchip Technology Inc.

55 MPLAB IDE 用户指南 第 3 章步骤和教程 3.1 简介 此步骤和教程是专为帮助初学者和有经验的应用开发人员而设计的 本章给出了对使用 MPLAB IDE 和各种 Microchip 开发工具进行开发的逐步说明, 其中, 每一步都首先讨论了通用信息, 然后提供具体的使用示例 将每步的示例连起来就构成一个应用示例 入门 选择器件 设置配置位 使用编辑器创建源代码 创建 设置和编译项目 创建新项目 使用项目向导 设置语言工具包 为新项目命名和定位 添加文件 完成项目 查看项目窗口 设置编译选项 编译项目 调试 选择调试器 运行代码 查看 Debug 窗口 使用 Watch 窗口 使用断点 编程 选择编程器 对器件进行编程 其他资源 使用 Microchip 帮助 2005 Microchip Technology Inc. DS51519A_CN 第 47 页

56 MPLAB IDE 用户指南 3.2 选择器件 3.3 设置配置位 要开始开发应用程序, 请选择想要为其开发代码的 Microchip 器件 要选择器件 : 1. 选择 Configure>Select Device 2. 在 Select Device 对话框中, 通过 Device 列表框选择器件 Microchip Tool Support (Microchip 工具支持 ) 部分将显示支持该器件的工具 3. 单击 OK ( 确定 ) 此时状态栏中将会显示所选择的器件 教程步骤 1: 选择 PIC18F8720 单片机作为要使用的器件 许多 Microchip 工具均支持此器件 可以通过对配置位编程 ( 读作 0) 或不编程 ( 读作 1) 来选择不同的器件配置 欲知更多信息, 请查询器件的数据手册 在 MPLAB IDE 或在代码中设置配置位 可以在代码中设置配置位 ( 即, 使用 config 命令或初始化代码 ); 也可以使用 Configuration Bits ( 配置位 ) 窗口 (Configure>Configuration Bits) 设置配置位 虽然可以使用两种方法, 但是也许应该仅选择一种方法以避免混淆和改写位值 如果想要在窗口中更改配置位的值, 在开发完成前请不要在代码中更改配置位 而是等到开发完成以后才将窗口值加入代码, 重新编译项目 ( 该过程会将代码值输入窗口 ) 并执行最终运行以确保一切正确 如果想要在代码中更改配置位的值, 请不要对窗口进行任何更改 每当编译项目时, 都会将代码值装入窗口, 此时先前对窗口所做的任何更改都将丢失 保存 / 清零配置位的值 当关闭 / 打开工作区时将保存 / 恢复 Configuration bit ( 配置位 ) 窗口的值 如果在 Settings ( 设置 ) 对话框 (Configure>Settings) 的 Program Loading ( 程序装载 ) 选项卡中选择了 Clear program memory upon loading a program ( 在装载程序时清空程序存储器 ) 复选框, 配置位就会在装载程序 ( 即编译 导入或打开项目 ) 时被清零 使用外部存储器时的设置 如果器件支持外部存储器, 并且在配置位中选择了使用外部存储器的模式, 就还需要在 External Memory Settings ( 外部存储器设置 ) 对话框 (Configure>External Memory) 中设置所使用的外部存储器的大小 DS51519A_CN 第 48 页 2005 Microchip Technology Inc.

57 步骤和教程 教程步骤 2: 3.4 使用编辑器创建源代码 对于所选择的器件 : 将使用默认的配置位值, 因此不会对 Configuration Bits 窗口进行任何更改 检查 Configure>Settings 的 Program Loading 选项卡中的设置 应该选中 : Clear memory before building a project ( 在编译项目之前清空存储器 ) 和 Clear program memory upon loading a program ( 在装载程序时清空程序存储器 ) PIC18F8720 器件可以使用外部存储器 但在本教程将使用单片机模式或者所有的片上存储器 选择 File>New 打开一个空的编辑器窗口, 可以在该窗口中输入源代码 要保存您的工作, 请选择 File>Save 欲知更多有关编辑器的信息, 请参阅第 11 章 使用编辑器 教程步骤 3: 使用 Windows 资源管理器创建 / 定位存放应用程序项目文件的文件夹 ( 目录 ) 然后, 在编辑器窗口中输入以下信息, 或是将以下信息剪切和粘贴到编辑器窗口中 完成以后, 将文件以文件名 cnt8720.asm 保存到该项目文件夹下 title PIC18F8720 Counting Program #include <p18f8720.inc> udata 0x60 COUNT res 1 RST code 00h goto Start PGM code Start clrf WREG ;clear W register movwf PORTC ;clear PORTC movwf TRISC ;config PORTC as outputs Init clrf COUNT ;clr count IncCount incf COUNT,F ;increment count movf COUNT,W movwf PORTC ;display on port c goto IncCount ;loop end 2005 Microchip Technology Inc. DS51519A_CN 第 49 页

58 MPLAB IDE 用户指南 3.5 创建新项目 3.6 使用项目向导 3.7 设置语言工具包 项目包含编译和测试应用程序所需的源文件 项目配置 ( 工作区 ) 包括以下内容 : 处理器和显示信息, 如所有打开窗口的性质 大小和位置以及工具栏 执行和调试设置的相关信息 欲知更多有关项目和工作区的信息, 请参阅第 4 章 项目和工作区 可以在 Settings ( 设置 ) 对话框 (Configure>Settings) 的 Project 和 Workspace 选项卡中选择项目和工作区的全局设置 教程步骤 4: 在本教程中, 请保留项目和工作区的默认设置 最明显的就是这意味着您将使用一对一的项目 工作区模型 要在当前工作区中创建新的项目, 请使用 Project Wizard 选择 Project>Project Wizard 出现 项目向导 欢迎 屏幕 单击 Next> 继续 出现 项目向导 选择器件 屏幕 验证此处显示的是否是您已经在 Select Device 对话框中选定的器件 要更改器件, 请使用下拉菜单 单击 Next> 继续 教程步骤 5: 您将使用步骤 1 中选择的器件, 因此不需要进行任何更改 现在将添加项目中要使用的语言工具 您将看到 项目向导 选择语言工具包 屏幕 从 Active Toolsuite ( 可用工具包 ) 下拉菜单中选择项目要使用的语言工具包 ( 由 Microchip 或第三方提供 ) 从该菜单中只可选择已经安装的并且可以和先前选择的器件配合工作的语言工具包 要查看所有现有的 ( 已安装的 ) 工具包, 请选中 Show all installed toolsuites ( 显示所有已安装的工具包 ) 如果在这个列表中仍然找不到所需要的工具包, 请单击 Help! My Toolsuite Isn't Listed! ( 需要帮助! 没有列出我所需的工具包 ) 以获取更多信息 Toolsuite Contents ( 工具包内容 ) 下的框中将显示所选工具包中的工具列表 前面有红 X 的工具表示该工具未安装或者 MPLAB IDE 无法获得该工具的可执行文件的路径 要指定或检查工具所对应的可执行文件的位置分配, 请单击工具, 以在 Location of Selected Tool ( 所选工具位置 ) 下显示出可执行文件及其路径 在该文本框中输入或修改路径, 或者单击 Browse 查找可执行文件 单击 Next> 继续 DS51519A_CN 第 50 页 2005 Microchip Technology Inc.

59 步骤和教程 教程步骤 6: 3.8 为新项目命名和定位 在本教程中, 根据以下步骤设置语言工具 : 在 Active Toolsuite 中选择 Microchip MPASM Toolsuite (Microchip MPSAM 工具包 ) 在 Toolsuite Contents 中逐次单击 MPASM Assembler MPLINK Object Linker 和 MPLIB Object Librarian 以确认它们的位置 单击 Browse 找到未列出的可执行文件 此工具包随 MPLAB IDE 一起安装, 并且其工具可执行文件位于 MPLAB IDE 安装目录下的 MCHIP_Tools 子目录中 现在将输入新项目的名称和路径 您将看到 项目向导 为项目命名 屏幕 要设置目录 : 输入现有目录的路径, 或是输入新目录的路径 输入新的路径时, 单击 Next> 会提示创建目录 单击 Browse 找到现有的目录或是想要放置新目录的上一级目录 在 Browse for Folder ( 查找文件夹 ) 对话框中单击 OK 如果正在创建新目录, 请在完成路径后单击 Next> 如果目录不存在将会提示创建目录 教程步骤 7: 在 Project Name ( 项目名称 ) 中输入 cnt8720 然后单击 Browse 并找到在步骤 3 中创建源代码时设置的应用程序项目目录 3.9 添加文件 现在将向项目中添加文件 您将看到 项目向导 添加现有文件 屏幕 选择要添加的文件 单击一个文件名以选择该文件 按住 Ctrl 键并单击以选择多个文件 单击 Add>> ( 添加 ), 要添加到新项目中的文件将出现在右面的列表中 要将文件从列表中删除, 请单击文件名选择要删除的文件, 然后单击 Remove ( 删除 ) 单击 Next> 继续 教程步骤 8: 将在项目中添加两个文件 : 找到文件 cnt8720.asm 并单击它 然后单击 Add>> 将它添加到项目中 在 MPLAB IDE 安装目录下的 MCHIP_Tools/LKR 子目录中找到 PIC18F8720 器件的链接描述文件 18F8720.lkr 注 : 如果计划使用 MPLAB ICD 2 作为调试工具, 则请选择 18F8720i.lkr 文件 选中该文件, 然后单击 Add>> 将它添加到项目中 并且还请选中所添加的文件旁边的复选框以将该文件复制到项目目录 2005 Microchip Technology Inc. DS51519A_CN 第 51 页

60 MPLAB IDE 用户指南 3.10 完成项目 现在应该检查项目设置 将显示 项目向导 摘要 屏幕 检查项目的摘要信息 如果有任何错误信息, 请使用 Back 返回到需要更改信息的对话框 当对项目设置满意时, 单击 Finish 3.11 查看项目窗口 教程步骤 9: 单击 Finish 完成项目设置 如果项目窗口尚未打开, 请选择 View>Project 将它打开 工作区的名称将显示在项目窗口顶端的栏中 而项目名称则应该显示在项目窗口内部的最上方 项目名称下还将显示文件类型和任何已添加的文件的树型结构 教程步骤 10: 项目窗口应该如图 3-1 所示 右击树型结构中的各项以查看相应的弹出菜单 右击 Source Files ( 源文件 ), 将看到 Add Files ( 添加文件 ) 菜单项, 这意味着在初始设置之后, 还可以将更多的源文件添加到项目中 右击文件 cnt8720.asm, 将看到 Remove 菜单项, 通过该方式可以将文件从项目中删除 右击窗口中的空白区域并在弹出菜单中选择 Preferences ( 首选项 ) 从而打开 Project-Display Preferences ( 项目 显示首选项 ) 对话框 虽然本教程不会更改任何首选项, 但仍请注意 Version Control ( 版本控制 ) 部分 欲知更多有关在项目中使用版本控制文件的信息, 请参阅第 4.6 节 使用版本控制系统 (VCS) 单击 Cancel 关闭对话框 图 3-1: 项目窗口示例 DS51519A_CN 第 52 页 2005 Microchip Technology Inc.

61 步骤和教程 3.12 设置编译选项 MPLAB IDE 对项目中所要包含的工具和文件具有默认设置 然而, 您可能想要或需要修改这些设置 要设置编译选项, 请选择 Project>Build Options>Project 或在项目窗口中右击项目, 并在弹出菜单中选择 Build Options ( 编译选项 ) 将打开 Build Options 对话框 单击 General ( 常规 ) 选项卡, 输入文件的路径或者单击 Browse 按钮查找路径, 这些文件可能是输出文件 include 文件 库文件或链接描述文件 注 : 这些是 MPLAB IDE 路径 并不是所有的语言工具都会使用此信息 单击具体的语言工具的选项卡 ( 如 MPASM Assembler) 并设置该工具的操作特性 单击 OK 要改写某个特定项目文件的项目设置, 例如 ProjFile1.asm, 请选择 Project>Build Options>ProjFile1.asm, 或右击项目窗口中的 ProjFile1.asm, 并从弹出菜单中选择 Build Options 将打开 File Settings ( 文件设置 ) 对话框 单击具体的语言工具的选项卡 ( 如 MPASM Assembler) 并设置该工具的操作特性 单击 OK 教程步骤 11: 设置项目编译选项 : 选择 Project>Build Options>Project 单击 MPLINK Linker 选项卡 选中 Generate map file ( 生成映射文件 ) 复选框 单击 OK 3.13 编译项目 现在已经准备就绪, 可以编译项目了 可以通过以下方式选择 Build All 菜单栏 (Project>Build All) 弹出菜单 ( 右击项目窗口中的项目名称 ) 工具栏 ( ) 在编译的过程中 : 如果选用了 MPASM 汇编器, 就会打开一个状态窗口, 显示编译的进度和最后的结果 编译完成后将关闭该窗口 还将打开 Output 窗口 该窗口将显示有关编译的信息, 包括遇到的任何错误 2005 Microchip Technology Inc. DS51519A_CN 第 53 页

62 MPLAB IDE 用户指南 3.14 选择调试器 如果项目编译失败, 请检查以下各项, 然后重新编译项目 : 检查在编辑器窗口中输入的所有代码的拼写和格式 如果在 Output 窗口中报告有错, 双击该错误就会在源代码窗口左侧的灰色区域中以绿色箭头指出源代码中出错的行 检查用于该项目及其项目文件的语言工具是否正确 编译成功后, 将装载由语言工具生成的调试文件 (*.cod, *.cof, *.elf 等 ) 该文件允许您调试源代码, 并在 Watch 窗口中以符号的形式查看变量 教程步骤 12: 根据以上说明, 通过选择 Build All 编译项目 应该能够成功地编译代码 如果确实遇到了编译错误, 请根据以上说明对编译错误进行诊断 通过 Debugger>Select Tool 选择工具以帮助调试代码 Microchip 提供以下几种类型的调试工具 : MPLAB SIM 软件模拟器 用软件模拟器件操作 MPLAB ICD 2 在线调试器 使用 ICD 和带有内置调试电路的专用闪存器件来在器件中调试代码 参见 MPLAB IDE 目录中的 Readme 文件以查看所支持的器件的列表 MPLAB ICE 4000 在线仿真器 通过访问器件的存储器单元, 用硬件仿真具有较大存储容量的 PIC18 MCU 和 dspic DSC 的操作 参见 MPLAB IDE 目录中的 Readme ( 自述 ) 文件以查看受支持的器件的列表 MPLAB ICE 2000 在线仿真器 通过访问器件的存储器单元, 用硬件仿真大多数 PICmicro MCU 的操作 参见 MPLAB IDE 目录中的 Readme 文件以查看所支持的器件的列表 一旦选定了调试工具, 就会发现 IDE 发生了以下改变 : Debugger 菜单 几个标准的选项将变为可用 还可能会出现其他工具特定的选项 该菜单的大部分选项均会出现在源代码 ( 文件 ) 窗口或 Program Memory 窗口的右击弹出菜单中 View ( 查看 ) 菜单 根据选定的调试器, 还可能会出现其他调试选项 调试工具栏 几个标准的选项将变为可用 还可能会出现其他工具特定的选项 状态栏 现在应该在此显示出选定的调试工具 教程步骤 13: 如果已经购买了用于开发应用程序的硬件或第三方工具, 现在请在 Debugger 菜单中选中它 如果它在菜单中不可视 ( 灰掉了 ), 请查询工具自带的文档, 以在 MPLAB IDE 中正确安装和设置该工具 如果没有其他工具, 请选择 MPLAB IDE 中内置的软件模拟器 MPLAB SIM DS51519A_CN 第 54 页 2005 Microchip Technology Inc.

63 步骤和教程 3.15 运行代码 不管选择了哪种调试工具, 都需要运行 ( 执行 ) 代码以对代码进行调试 选择 Debugger>Reset>Processor Reset 将在源代码窗口左侧的灰色区域中显示一个实心的绿色箭头, 表明这是要执行的第一行源代码 选择 Debugger>Run 运行应用程序 在状态栏中将显示 Running, 并且灰色区域中的箭头将变为空心的 要暂停程序执行, 请选择 Debugger>Halt 实心的绿色箭头将指向应用程序停止时所在的代码行 也可以通过选择 Debugger>Step Into 单步运行应用程序 这将执行当前代码行, 然后箭头将指向要执行的下一行代码 注 : 也可以单击工具栏上相应的图标, 或者使用菜单项旁边显示的热键而不是选择菜单项来选择相应的调试命令 这是在调试时重复地运行 暂停和单步执行的最佳方法 教程步骤 14: 3.16 查看 DEBUG 窗口 复位代码 (Debugger>Reset), 并通过单击工具栏上的 Run 图标运行代码 ( 将鼠标悬停在工具栏图标上可查看图标的含义 ) 然后通过单击 Halt 图标停止程序 可以在标准的调试窗口中查看程序存储器 数据存储器以及其他类型的器件存储器的内容, 以辅助调试应用程序 这些窗口在 View 菜单上总是可见的 但是, 若器件或调试工具不支持某些项, 这些项可能就会灰掉 欲知更多有关每个调试窗口的信息, 请参阅第 8 章 MPLAB IDE 窗口 Disassembly Listing 窗口 Hardware Stack 窗口 Program Memory 窗口 File Registers 窗口 EEPROM 窗口 LCD Pixel 窗口 Watch 窗口 Special Function Registers 窗口菜单中可能还会出现其他调试窗口, 这取决于选定的调试工具 Trace Memory 窗口 ( 对于模拟器和仿真器 ) 2005 Microchip Technology Inc. DS51519A_CN 第 55 页

64 MPLAB IDE 用户指南 教程步骤 15: 3.17 使用 WATCH 窗口 可能会使用以下窗口观察正在运行的代码 : 文件 ( 编辑器 ) 窗口 显示实际的汇编或 C 代码 Program Memory 窗口 以十六进制操作码 (Opcode Hex) 机器码或符号形式显示代码 Disassembly Listing 窗口 显示反汇编后的代码 Watch 窗口 显示指定要 观察 的寄存器和位的值 应该已经打开了包含代码的文件窗口 在下一步中将使用 Watch 窗口 要查看应用程序的执行过程, 就需要打开调试窗口来观察寄存器的值 虽然 File Register 窗口和 Special Function Register 窗口可以显示许多寄存器的值, 但是通常只希望查看少量的特定寄存器 要设置将要查看的寄存器的列表, 请使用 Watch 窗口 (View>Watch) 要将项目添加到 Watch 窗口中 : 请在下拉列表中选中某个 SFR 或变量, 然后单击相应的 Add 按钮 将 SFR 窗口 File Register 窗口或 File 窗口中的某项拖到 Watch 窗口中 直接在窗口中的 symbol name 下方单击, 以输入 SFR 或变量名 首先列出的是符号的文件寄存器地址, 接下来是符号名称, 最后是符号的值 欲知更多有关 Watch ( 观察 ) 窗口的信息, 请参阅第 8.12 节 Watch 窗口 教程步骤 16: 首先设置 Watch 窗口 : 在窗口顶部的变量选择框中选择 COUNT 单击 Add Symbol 将它添加到 Watch 窗口列表中 若想在下拉列表中快速查找该变量, 请在选中下拉图标后输入 COUNT 在窗口顶部的 SFR 选择框中选择 WREG 单击 Add SFR 将它添加到 Watch 窗口列表中 若想在下拉列表中快速查找 WREG, 请在选中下拉图标后输入 WREG 在窗口顶部的 SFR 选择框中选择 PORTC 单击 Add SFR 将它添加到 Watch 窗口列表中 若想在下拉列表中快速查找 PORTC, 请在选中下拉图标后输入 PORTC DS51519A_CN 第 56 页 2005 Microchip Technology Inc.

65 步骤和教程 现在应该已经将这些符号添加到了 Watch 窗口中了 接下来, 将运行代码, 并在单步执行程序的过程中观察变量和 SFR 值的变化 选择 Debugger>Reset>Processor Reset 复位应用程序 选择 Debugger>Step Into ( 或者单击等效的工具栏图标 ) 直到代码运行至以下程序行 : incf COUNT,F ;increment count 再执行一步, 将在 Watch 窗口中看到 COUNT 的值从 00 变为了 01 接着再执行一步, 将在 Watch 窗口中看到 WREG 的值从 00 变为了 01 然后再执行一步, 将在 Watch 窗口中看到 PORTC 的值从 00 变为了 01 注 : 若在前面的调试操作中对 Watch 窗口中的值做了更改, 相应值就会呈现彩色, 若未更改则为黑色 3.18 使用断点 您可以使用断点来使程序有条件地暂停, 这样就可以在运行一段时间之后观察存储器 寄存器或变量的值 可以在文件 ( 编辑器 ) 窗口 程序存储器窗口或反汇编窗口设置断点 断点设置 可采用以下方法设置断点 : 1. 双击灰色区域 双击想要设置断点的那行代码旁边的灰色区域 再次双击可删除断点 2. 弹出菜单 将指针放在想要设置断点的那行代码上 然后, 右击鼠标, 在弹出菜单中选择 Set Breakpoint ( 设置断点 ) 一旦设置了断点, Set Breakpoint 就会变为 Remove Breakpoint ( 删除断点 ) 和 Disable breakpoint ( 禁止断点 ) 弹出菜单中 Breakpoints 下的其他选项用于删除 启用或禁止所有断点 3. Breakpoint 对话框 打开 Breakpoint 对话框 (Debugger>Breakpoints) 以设置 删除 启用或禁止断点 必须在选择调试工具后才可以使用该选项 断点符号 在每个支持的窗口左侧的灰色区域中均将显示与断点操作相关的符号 欲知有关这些符号的信息, 请参阅第 8.3 节 在代码窗口中显示符号 2005 Microchip Technology Inc. DS51519A_CN 第 57 页

66 MPLAB IDE 用户指南 3.19 选择编程器 代码中的断点 更改源代码时将会自动调整断点 这意味着 : 在地址上设置的断点将会始终位于这些地址, 与该地址的代码无关 在源代码行中设置的断点将会随着这些代码行移动 当在 C 代码中设置断点时, 若调试时需要在 C 代码列表和相关的汇编列表中切换, 必须十分小心 当在一行 C 代码上设置断点时, 在汇编代码中的对应的第一行代码上也会同时设置断点 在两个列表相应的代码行边均会显示一个红色的断点符号 当在汇编列表中对表示一行 C 代码的任一行汇编代码设置断点时, 汇编代码行旁会出现一个红色的断点符号, 而 C 代码行旁会出现一个黄色的断点符号 当在 Program Memory 窗口中删除对表示一行 C 代码的任一行汇编代码所设置的断点时, 汇编代码行旁红色的断点符号将消失, 而 C 代码行旁仍会保留黄色的断点符号, 直到删除了所有对应的汇编代码断点为止 断点和 MPLAB ICD 2 MPLAB ICD 2 在线调试器所支持的断点数是有限的 可用的数目显示在 Breakpoint 对话框中 (Debugger>Breakpoints) 教程步骤 17: 要使用断点再次运行程序 : 选择 Debugger>Reset>Processor Reset 复位应用程序 双击以下代码行旁的灰色区域, 设置一个断点 : incf COUNT,F ;increment count 选择 Debugger>Run 运行程序 程序执行应该在断点处停止 此时 Watch 窗口中所有项的值都应该为 0x00 可以从该断点处单步运行代码以观察 Watch 窗口中值的变化 一旦对代码进行了调试并顺利运行之后, 就应该为器件编程并尝试在应用中运行该程序 通过 Programmer>Select Programmer 选择编程器 要使用的编程器取决于要编程的器件 PICSTART Plus 和 PICkit 1 开发编程器 用于在开发 ( 非生产 ) 环境中为大多数 PICmicro MCU 器件编程 参见 MPLAB IDE 目录中的 Readme 文件以查看所支持的器件的列表 MPLAB ICD 2 在线调试器 用于为某些闪存器件编程 参见 MPLAB IDE 目录中的 Readme 文件以查看受支持的器件的列表 MPLAB PM3 器件编程器 用于为 PIC18 MCU 和 dspic DSC 器件编程 参见 MPLAB IDE 目录中的 Readme 文件以查看所支持的器件的列表 PRO MATE II 器件编程器 用于为大多数 PICmicro MCU 器件编程 参见 MPLAB IDE 目录中的 Readme 文件以查看所支持的器件的列表 DS51519A_CN 第 58 页 2005 Microchip Technology Inc.

67 步骤和教程 3.20 对器件进行编程 3.21 使用 MICROCHIP 帮助 一旦选择了编程器, 就会发现 IDE 发生了以下改变 : Programmer 菜单 几个标准的选项将变为可用 还可能会出现其他特定于工具的选项 该菜单的大部分选项均会出现在源代码 ( 文件 ) 窗口或 Program Memory 窗口的右击弹出菜单中 编程器工具栏 几个标准的选项将变为可用 还可能会出现其他特定于工具的选项 状态栏 现在应该在此显示出选定的编程器 一般来说, 要对器件编程 : 在代码中或是通过 Configure> Configuration Bits 检查配置位的值 在 Programmer>Settings 对话框中检查编程设置 选择 Programmer>Program 完成对器件的编程后, 就可以尝试在应用中使用它了 若该器件不能按照预期运行, 将需要调试代码并再次对该器件编程 ( 或对一个新器件编程 ), 然后再次将器件插到应用中 Microchip Technology 提供有关 MPLAB IDE 及其所有开发工具的在线 HTML 帮助 选择 Help>Topics 在 Help Topics ( 帮助主题 ) 对话框中会列出所有可用的帮助文件 帮助查看导航 可用的帮助类型 帮助查看导航 帮助查看器的主要功能如图 3-2 所示 图 3-2: 标题栏 按钮栏 帮助查看器 主要功能 浏览按钮 导航窗格 视图窗格 浏览按钮 按钮栏 显示 / 隐藏 显示或隐藏左边的窗格 返回 返回一个主题 打印 打印当前显示的主题 选项 显示更多可用的选项 2005 Microchip Technology Inc. DS51519A_CN 第 59 页

68 MPLAB IDE 用户指南 浏览按钮每个在视图窗格中显示的主题都带有浏览按钮 单击 <, 根据目录中的排序, 浏览前一个帮助主题 单击 >, 根据目录中的排序, 浏览下一个帮助主题 导航窗格 要查看将所有的 Microchip 帮助主题按功能组织的列表, 请单击目录选项卡 然后单击文件夹旁边的 + 号, 打开该文件夹, 以查看其中所包含的主题 单击列出的主题, 即可在查看器右边的窗格中查看与该主题相关的帮助信息 要查看帮助主题的按字母排序的列表, 请单击索引选项卡 要搜索帮助主题中的关键字, 请单击搜索选项卡 要创建和维护收藏主题的列表, 请单击书签选项卡 要关闭左边的窗格, 请单击按钮栏上的隐藏按钮 ( 单击后它将变为显示按钮 ) 要查看左边的窗格, 请单击按钮栏上的显示按钮 ( 单击后它将变为隐藏按钮 ) 视图窗格单击蓝色的带有下划线的文字以激活一个超级链接 : 跳转到另一个主题 请单击返回按钮返回, 或者浏览到其他主题 打开一个弹出框 若要关闭该弹出框, 请单击弹出框以外的区域 可用的帮助类型 通过 MPLAB IDE Help 菜单即可使用工具的帮助文件 通过这些帮助项可获取有关特定对话框或窗口的帮助信息 工具的限制则可从 Settings 对话框中获取 HELP 菜单通过 Help 菜单即可使用每个开发工具的帮助文件 大多数帮助文件均包含以下内容 : 工具概述 教程 / 使用示例 通用信息 疑难解答信息 参考资料 对话框单击每个对话框中的 Help 按钮, 即可使用对话框帮助 单击 Help 将显示使用对话框完成某项任务的逐步说明 窗口按下 F1 键, 即可使用窗口帮助 当窗口处于激活状态时, 按下键盘上的 F1 键, 即可查看有关该窗口内容的信息 限制当选定了器件 (Configure>Select Device) 并设置了调试工具 (Debugger>Select Tool) 以后, 就会显示调试工具限制 可以打开 Settings 对话框 (Debugger>Settings) 并单击 Limitations 选项卡查看这些设置 可通过打开工具的帮助文件 (Help>Topics), 并在 目录 或 索引 中查找 Limitation 以获取调试和编程工具的限制 DS51519A_CN 第 60 页 2005 Microchip Technology Inc.

69 MPLAB IDE 用户指南 第 4 章项目和工作区 4.1 简介 项目和工作区是 MPLAB IDE v6.xx 的两个主要部分 项目包含了编译应用程序所需的文件 ( 源代码和链接描述文件等 ), 还包含这些文件与各种编译工具及编译选项之间的对应关系 工作区包含了有关选定器件 调试工具和 / 或编程器 打开的窗口和窗口的位置及其他 IDE 配置设置的信息 设置项目及其对应工作区的最好方法是使用项目向导 这样就可以在一个工作区中设置一个项目 若要设置较高级的应用, 可以手动设置项目和工作区 可以利用工作区设置, 在一个工作区中打开多个项目 而且, 还可以在多项目工作区中定制每个项目, 以创建较大应用程序 ( 多项目并存 ) 的一部分 如果使用的是只有一个汇编文件的应用程序, 则可以使用 Quickbuild ( 快速编译 ) (Project>Quickbuild) 来通过 MPASM 汇编器汇编代码, 而无须创建项目 但是仍需要有一个对应的工作区来保存设置 项目 使用项目向导 创建 / 更新任何项目 设置项目结构 相关路径 项目文件夹和文件 使用版本控制系统 (VCS) 设置 / 更改项目 项目和工作区 使用单个项目和工作区 ( 如 MPLAB IDE v5.xx 和更早的版本 ) 在单个工作区中使用多个项目 编译无需项目的应用程序 ( 快速编译 ) 2005 Microchip Technology Inc. DS51519A_CN 第 61 页

70 MPLAB IDE 用户指南 4.2 使用项目向导 项目向导由若干对话框组成, 可以遵循这些对话框设置项目 项目向导 欢迎 项目向导 选择器件 项目向导 选择语言工具包 ( 选择语言工具包 ) 项目向导 为项目命名 项目向导 添加文件 项目向导 摘要 项目向导 欢迎 选择 Project>Project Wizard 启动项目的设置向导 请遵循 Project Wizard 中的对话框, 设置新的项目 还可以使用帮助查看器中的浏览顺序来查看向导中的步骤 单击 Next 继续 项目向导 选择器件 Step 1: Select a Device ( 步骤 1: 选择器件 ) 将显示出默认的 MPLAB IDE 器件, 或之前使用 Select Device 对话框选定的器件 从列表中为项目选择器件, 或输入器件的名称 单击 Next 继续 项目向导 选择语言工具包 Step 2: Select a Language Toolsuite ( 步骤 2: 选择语言工具包 ) 在 Active Toolsuite 下拉菜单中为项目选择语言工具包 虽然无论选择什么器件都会显示第三方语言工具, 但是在这个菜单中只能选择已安装且适用于所选器件的 Microchip 语言工具包 要查看所有可用的 ( 已安装的 ) 工具包, 请选择 Show all installed toolsuites ( 显示所有已安装的工具包 ) 如果在这个列表中仍然找不到所需要的工具包, 请单击 Help!My Toolsuite Isn't Listed! ( 需要帮助! 没有列出我所需的工具包 ) 查阅更多信息 Toolsuite Contents 下的框中将显示所选工具包中的工具列表 前面有红 X 的工具表示该工具未安装或者 MPLAB IDE 无法获得该工具的可执行文件的路径 要指定或检查工具所对应的可执行文件的位置分配, 请单击工具, 以在 Location of Selected Tool ( 所选工具位置 ) 下显示出可执行文件及其路径 在该文本框中输入或修改路径, 或者单击 Browse 查找可执行文件 单击 Next 继续 DS51519A_CN 第 62 页 2005 Microchip Technology Inc.

71 项目和工作区 4.3 创建 / 更新任何项目 项目向导 为项目命名 Step 3: Name Your Project ( 步骤 3: 为项目命名 ) 输入新项目的名称和位置 要设置目录 : 输入现有目录的路径, 或是输入新目录的路径 输入新的路径时, 单击 Next> 会提示创建目录 单击 Browse 找到现有的目录或是想要放置新目录的上一级目录 在 Browse for Folder 对话框中单击 OK 如果正在创建新目录, 请在完成路径后单击 Next> 如果目录不存在将会提示创建目录 项目向导 添加文件 Step 4: Add Any Existing Files to Your Project ( 步骤 4: 向项目中添加任何现有文件 ) 如果已经准备了想向新项目中添加的文件, 现在将选择它们 : 选择要添加的文件 单击一个文件名以选择该文件 按住 Ctrl 键并单击以选择多个文件 按 ADD>> 列出被添加到新项目的文件 要将文件从列表中删除, 请单击文件名选择要删除的文件, 然后单击 Remove 如果希望将文件复制到新项目而不是移动文件, 请选中已添加的文件旁边的复选框 单击 Next 继续 项目向导 摘要 检查项目的摘要信息 如果有任何错误信息, 请使用 Back 返回到需要更改信息的对话框 当对项目设置满意时, 单击 Finish 无论使用的是单项目工作区还是多项目工作区, 创建或更新项目的过程均相同 1. 在当前工作区中创建 / 打开一个项目 项目就会出现在项目窗口中 选择 Project>New, 创建新项目 在对话框中输入新项目的名称和位置 选择 Project>Open, 打开现有项目 2. 选择 Project>Build Options>Project 的 General 选项卡, 指定 / 更改项目文件的路径 3. 首先通过选择 Project>Set Language Tool Locations 指定每个语言工具的路径来指定 / 更改项目中的语言工具 然后选择 Project>Set Language Toolsuite 设置项目的工具包 4. 通过选择 Project>Build Options>Project, 或右击项目窗口中的项目名称并选择 Build Options, 然后单击相应的语言工具选项卡, 设置 / 更改项目的语言工具属性 2005 Microchip Technology Inc. DS51519A_CN 第 63 页

72 MPLAB IDE 用户指南 5. 选择 Project>Add Files 为项目添加文件, 方法是右击项目窗口中的项目名称并选择 Add Files to Project ( 为项目添加文件 ), 或右击项目窗口中的文件类型并选择 Add Files, 添加特定类型的文件 注 : 6. 选择 Project>Remove File From Project 或右击项目窗口中的文件并选择 Remove, 删除项目中的文件 7. 如果要使对单个文件所设置的语言工具属性不同于整个项目, 请选择 Project>Build Options> 文件名, 其中文件名是一个文件的名称, 或者在项目窗口中右击文件名并选择 Build Options 这些设置仅应用于单个文件 4.4 设置项目结构 相关路径 即使文件尚不存在, 也可以将其添加到项目中 这对于在真正开发这些文件之前构建项目是非常有用的 请切记在编译项目之前创建这些文件, 否则编译肯定会失败 下面是创建推荐的项目目录结构的示例, 该目录结构是使用 Build Options 的 General 选项卡上的相关路径创建的 保持所有项目子文件夹平行可以更容易地对中间文件 include 文件 库文件和链接描述文件分组 注 : 确保源代码文件使用惟一的名称, 否则目标文件会被覆盖 例如, file.asm 汇编后生成 file.o, 而 file.c 编译后也生成 file.o, 这样就会覆盖第一个 file.o 图 4-1: 推荐的项目结构 project project.mcp project.mcw project.hex source1 csrc.c asmsrc.asm src2.c source2 src3.c source3 tmp csrc.o asmsrc.o src2.o src3.o include header.h header.inc lib clib.lib lkr device.lkr Project>Build Options>Project, General 选项卡输出目录 :C:\project 中间文件目录 :..\tmp 汇编器 Include 文件路径 :..\include Include 文件路径 :..\include 库文件路径 :..\lib 链接描述文件路径 :..\lkr DS51519A_CN 第 64 页 2005 Microchip Technology Inc.