dsPIC®语言工具入门 1.5 教程概述 下面的教程旨在帮助工程师熟悉C编程语言以及利用MPLAB集成开发环境(IDE) 和MPLAB C30编译器开始开发嵌入式系统的概念。本文档介绍了如何创建和编译项 目，如何利用dsPIC30F芯片的功能编写代码，以及如何校验和调试利用MPLAB C30 编写的代码。 首先要安装MPLAB C30编译器和MPLAB IDE v6.30(或更新版本)。请查阅关于 dsPIC®的文献，如dsPIC30 F Data Sheet General Purpose and Sensor Families (DS70083)和dsP1C30 F Programmer's Reference Manual(DS70030),以便获得 关于具体处理器的信息，如特殊功能寄存器、指令集和中断逻辑。 这些章节中关于使用MPLAB C30编译器的教程包括： ·第2章介绍了如何： ·创建和编译项目 ·在示例代码中运行、单步执行和设置断点 ·调试代码。 ·第3章介绍了如何： ·使用模板来创建源文件 ·在C中使用实时中断 ·第4章介绍了如何： ·在MPLAB C30编译器中使用汇编语言DSP子程序 ·与汇编语言模块之间传递参数 DS70094C_CN第8页 2005 Microchip Technology Inc
dsPIC® 语言工具入门 DS70094C_CN 第 8 页 2005 Microchip Technology Inc. 1.5 教程概述 下面的教程旨在帮助工程师熟悉 C 编程语言以及利用 MPLAB 集成开发环境 （IDE） 和 MPLAB C30 编译器开始开发嵌入式系统的概念。本文档介绍了如何创建和编译项 目，如何利用 dsPIC30F 芯片的功能编写代码，以及如何校验和调试利用 MPLAB C30 编写的代码。 首先要安装 MPLAB C30 编译器和 MPLAB IDE v6.30 （或更新版本）。请查阅关于 dsPIC® 的文献，如 dsPIC30F Data Sheet General Purpose and Sensor Families （DS70083）和 dsPIC30F Programmer’s Reference Manual （DS70030），以便获得 关于具体处理器的信息，如特殊功能寄存器、指令集和中断逻辑。 这些章节中关于使用 MPLAB C30 编译器的教程包括： • 第 2 章介绍了如何： - 创建和编译项目 - 在示例代码中运行、单步执行和设置断点 - 调试代码。 • 第 3 章介绍了如何： - 使用模板来创建源文件 - 在 C 中使用实时中断 • 第 4 章介绍了如何： - 在 MPLAB C30 编译器中使用汇编语言 DSP 子程序 - 与汇编语言模块之间传递参数
dsPIC®语言工具 MICROCHIP 入门 第2章教程1一创建项目 2.1 简介 本教程中简单的源代码是为MPLAB IDE v6.x项目所设计的。它将使用MPLAB SIM 软件模拟器来模拟dsPIC:30F6014芯片。本教程中假定目录C:\pic30too1s为 MPLAB C30编译器的安装目录。本教程包括： ·创建文件 ·使用项目向导 ·使用项目窗口 ·设置编译选项 ·编译项目 ·编译错误疑难解答 ·使用MPLAB SIM软件模拟器进行调试 ·生成映射文件 ·汇编代码的调试 ·深入学习 2.2 创建文件 启动MPLAB IDE v6.30(或更新的版本)并选择File>New打开一个新的空白的源文 件。例2-1给出了要键入（或者如果在阅读电子文档，拷贝和粘贴到）新源文件窗口 的源代码。 例2-1： MYFILE.C #include "p30f6014.h" int counter; /for TRISB and PORTB declarations int main (void) counter 1; TRISB =0; /configure PORTB for output while(1) /do forever { PORTB counter;/send value of 'counter'out PORTB counter++; return 0; TRISB和PORTB是dsPIC30F6014芯片的特殊功能寄存器。PORTB是一组通用输入/输 出引脚。TRISB的位用来配置PORTB引脚为输入(1)或输出(0)。 使用File>Save As将文件另存在安装目录的\examples目录下（通常为 c:pic30 tools\examples),文件名为MyFile.c。 2005 Microchip Technology Inc. DS70094C_CN第9页
dsPIC® 语言工具 入门 2005 Microchip Technology Inc. DS70094C_CN 第 9 页 第 2 章 教程 1 — 创建项目 2.1 简介 本教程中简单的源代码是为 MPLAB IDE v6.xx 项目所设计的。它将使用 MPLAB SIM 软件模拟器来模拟 dsPIC30F6014 芯片。本教程中假定目录 C:\pic30_tools 为 MPLAB C30 编译器的安装目录。本教程包括 : • 创建文件 • 使用项目向导 • 使用项目窗口 • 设置编译选项 • 编译项目 • 编译错误疑难解答 • 使用 MPLAB SIM 软件模拟器进行调试 • 生成映射文件 • 汇编代码的调试 • 深入学习 2.2 创建文件 启动 MPLAB IDE v6.30 （或更新的版本）并选择 File>New 打开一个新的空白的源文 件。例 2-1 给出了要键入 （或者如果在阅读电子文档，拷贝和粘贴到）新源文件窗口 的源代码。 例 2-1： MYFILE.C #include "p30f6014.h" int counter; // for TRISB and PORTB declarations int main (void) { counter = 1; TRISB = 0; // configure PORTB for output while(1) // do forever { PORTB = counter; // send value of ‘counter’ out PORTB counter++; } return 0; } TRISB和PORTB是dsPIC30F6014芯片的特殊功能寄存器。PORTB是一组通用输入/输 出引脚。 TRISB 的位用来配置 PORTB 引脚为输入 （1）或输出 （0）。 使用 File>Save As 将文件另存在安装目录的 \examples 目录下（通常为 C:\pic30_tools\examples），文件名为 MyFile.c
dsPIC®语言工具入门 2.3 使用项目向导 选择Project心Project Wizard来创建新项目。将出现一个欢迎页面。点击Next>继续。 1.在“Step One:Select a Device”中，通过下拉菜单选择dsPIC:30F6014芯片， 点击Next>继续。 2. 在“Step Two:Select a language toolsuite”中，选择“Microchip C30 Toolsuite”作为“Active Toolsuite”。然后点击工具包中（在“Toolsuite Contents”之下)的每个语言工具并检查或设置与其相关的可执行文件的路径 (图2-1)。 MPLAB ASM30汇编器应指向“LOCATION”下的汇编程序可执行文件 pic30-as.exe。如果没有这个文件，应键入或浏览到可执行文件的位置，通常 默认为： C:\Program Files\MPLAB IDE\dsPIC_Tools\Bin\pic30-as.exe MPLAB C30编译器应指向“LOCATION”下的编译程序可执行文件 pic30-gcc.exe。如果没有这个文件，应键入或浏览到可执行文件的位置，通 常默认为： C:\pic30 tools\bin\pic30-gcc.exe MPLAB LINK30目标链接器应指向“LOCATION”下的链接程序可执行文件 pic30-ld.exe。如果没有这个文件，应键入或浏览到可执行文件的位置，通 常默认为： C:\Program Files\MPLAB IDE\dsPIC Tools\Bin\pic30-ld.exe 点击Next>继续。 图2-1： 项目向导一选择语言工具 Project Wizard Step Two: Select a language toolsuite Active Toolsuite Microchip C30 Tooksute Toolsuite Conterts MPLAB ASM30Assembler Ipic30-as.exel CProgam Files\MFLAB IDE\dPIC Toos\Bin\pic30-as.exe Browse. Heip!My Sute lan't Listed! Show al installed tooleuites Back Neot Cancel Help DS70094C_CN第10页 2005 Microchip Technology Inc
dsPIC® 语言工具入门 DS70094C_CN 第 10 页 2005 Microchip Technology Inc. 2.3 使用项目向导 选择 Project>Project Wizard 来创建新项目。将出现一个欢迎页面。点击 Next> 继续。 1. 在 “Step One：Select a Device”中，通过下拉菜单选择 dsPIC30F6014 芯片， 点击 Next> 继续。 2. 在 “Step Two：Select a language toolsuite”中，选择 “Microchip C30 Toolsuite”作为 “Active Toolsuite”。然后点击工具包中 （在 “Toolsuite Contents”之下）的每个语言工具并检查或设置与其相关的可执行文件的路径 （图 2-1）。 MPLAB ASM30 汇编器应指向 “LOCATION”下的汇编程序可执行文件 pic30-as.exe。如果没有这个文件，应键入或浏览到可执行文件的位置，通常 默认为： C:\Program Files\MPLAB IDE\dsPIC_Tools\Bin\pic30-as.exe MPLAB C30 编译器应指向 “LOCATION”下的编译程序可执行文件 pic30-gcc.exe。如果没有这个文件，应键入或浏览到可执行文件的位置，通 常默认为： C:\pic30_tools\bin\pic30-gcc.exe MPLAB LINK30 目标链接器应指向 “LOCATION”下的链接程序可执行文件 pic30-ld.exe。如果没有这个文件，应键入或浏览到可执行文件的位置，通 常默认为： C:\Program Files\MPLAB IDE\dsPIC_Tools\Bin\pic30-ld.exe 点击 Next> 继续。 图 2-1： 项目向导 — 选择语言工具
教程1一创建项目 3. 在“Step Three:Name your project'”中，键入项目名MyProject并点击 BROWSE进入MPLAB C30安装目录下的\examples文件夹。然后点击 NEXT>继续 图2-2： 项目向导一项目名称和目录 Project Wizard Step Three: Name your project Project Name MyProiect Project Dreclory Cpicoo <Back Next Cancel 4. 在“Step Four:Add any existing files to your project”中，将添加两个文件到 项目中。 首先，选择先前在\examples文件夹中生成的源文件MyFile.c。点击 ADD>>将它添加到项目要使用的文件列表中（出现在右边）。 图2-3： 项目向导一添加C源文件 Project Wizard Step Four: Add any existing fles to your proiect 4d>》 C:\pic30_tools\examples\MyFile. 目example1.cmd example3c 日get_months Remove 目helo.c helo.cmd manc 日modo.8 Myfie c 目output.cm 日output.s Check the box toco the file to the <Back Cancal Help 2005 Microchip Technology Inc. DS70094CCN第11页
教程 1 — 创建项目 2005 Microchip Technology Inc. DS70094C_CN 第 11 页 3. 在 “Step Three：Name your project”中，键入项目名 MyProject 并点击 BROWSE 进入 MPLAB C30 安装目录下的 \examples 文件夹。然后点击 NEXT > 继续 图 2-2： 项目向导 — 项目名称和目录 4. 在 “Step Four： Add any existing files to your project”中，将添加两个文件到 项目中。 首先，选择先前在 \examples 文件夹中生成的源文件 MyFile.c。点击 ADD>> 将它添加到项目要使用的文件列表中 （出现在右边）。 图 2-3： 项目向导 — 添加 C 源文件
dsPIC®语言工具入门 其次，必须添加链接描述文件，告知链接器关于dsP1C30F6014的存储器构成。 链接描述文件位于MPLAB C30安装目录下的\support\gld文件夹中。向下 找到p30f6014.g1d文件，选中它并点击ADD>>将它添加到项目中。 图2-4： 项目向导一添加链接器脚本 Project Wizard Step Four: Add any existing fies to your project 日p30f6010. C:\pic30_toolsVexamoles\MyFile.c 5p306010g C:\pic30_tools\support\gld\p30E p306011 p3f601 Remove Sp3016012 p3060124 日p30f6013 p306013☐ 日p306014 日p30smgt Check the box to copy the file to the Droject ditecto厚 Back Nest☐Cancel Helb 点击Next>继续。 5. 在Summary(摘要)窗口中重新检查“项目参数”，验证芯片、工具包和项目 文件的位置是否正确。如果想修改某一项，可以点击Back返回上一个对话框。 点击Finish生成新的项目和工作区。 DS70094C_CN第12页 2005 Microchip Technology Inc
dsPIC® 语言工具入门 DS70094C_CN 第 12 页 2005 Microchip Technology Inc. 其次，必须添加链接描述文件，告知链接器关于 dsPIC30F6014 的存储器构成。 链接描述文件位于 MPLAB C30 安装目录下的 \support\gld 文件夹中。向下 找到 p30f6014.gld 文件，选中它并点击 ADD>> 将它添加到项目中。 图 2-4： 项目向导 — 添加链接器脚本 点击 Next> 继续。 5. 在 Summary （摘要）窗口中重新检查 “项目参数”，验证芯片、工具包和项目 文件的位置是否正确。如果想修改某一项，可以点击 Back 返回上一个对话框。 点击 Finish 生成新的项目和工作区