我们在第一章中已经详细介绍了中档 PIC 单片机的 35 条指令,源程序的编写主要就是用这些基本的指令实现你的控制任务。但为了增加源程序的可读性和可维护性,我们引入了伪指令的概念。伪指令本身不会产生可执行的汇编指令,但它们可以帮组“管理”你编写的程序,其实用性和必要性绝不亚于 35 条正真的汇编指令。我们在此着重介绍最常用的几种伪指令。
#include 或 include
#include 伪指令的作用是把另外一个文件的内容全部包含复制到本伪指令所在的位置。被包含复制的文件可以是任何形式的文本文件,当然文件中的内容和语法结构必须是MPASM 能够识别的。最经常被“include”的是针对 PIC 单片机内部特殊功能寄存器定义的包含头文件,在 MPLAB 安装后它们全部放在路径“ C:\Program Files\MPLAB IDE\MCHIP_Tools”下,每一个型号的 PIC 单片机都有一个对应的预定义包含头文件,扩展名是“.inc”。除了一些符号预定义文件,你也可以把现有的其它程序文件作为一个代码模块直接“包含”进来作为自己程序的一部分。见例 3-01。
#include <p16f877a.inc> ;把预定义的 PIC16F877A寄存器符号包含到此处
#include ”math.asm” ;把现有的程序文件包含进来作为自己代码的一部分
例 3-01
请注意被包含文件的引用方式。一种是<>尖括号引用,这种引用意味着让编译器去默认的路径下寻找该文件,MPASM 默认的寄存器预定义文件存放路径即为上面提及的MPLAB 安装后的目录;另一种是””双引号引用,这种引用方式的意思是指示编译器从引号中指定的全程文件路径下寻找该文件。例 3-01 中”math.asm”没有指定路径,即意味着在当前项目路径下寻找 math.asm 文件。如果编译器找不到被包含的文件,将会有错误信息告知。
请在你的源程序中尽量用 MPLAB标准头文件定义的寄存器符号。一来这些被定义的寄存器符号和芯片数据手册上的描述一一对应,理解起来即直观又容易;二来如果用你自己定义符号就缺乏一个大家能一起交流的标准平台,其他人要解读你的代码时将费时费力。故例
3-01 中的首行#include 包含引用伪指令可以说是 PIC 单片机程序编写时的标准必备。
list
list 伪指令可以设定程序编译时的一些信息,例如所选单片机的型号,编译时选择的缺省数制等。例如:
list p=16f877a, r=DEC ;单片机型号为PIC16F877A,无特别指明的数字为十进制数
例 3-02
如果程序开发时使用项目管理的模式,则所有 list 伪指令可以描述的参数项都可以在项目的设定选项中通过对话框的形式设定并保存。在此只需对 list 伪指令稍作了解即可。
__config
此伪指令的重要作用是把芯片的配置字设定在源程序中,请参阅 2.5 节的详细说明。建议大家尽量用此伪指令把芯片的配置字写在程序中。
__idlocs
PIC 单片机中有一处非常特殊的标记单元。它独立于任何其它存储器,唯一的作用就是作为一个标记。此标记值无法用软件读到,读取和写入的方法只有通过编程器实现。此标记值没有读保护,你可以利用它存放程序的版本或日期等信息。如果需要,则可以用伪指令__idloc 在程序中定义具体的值。
__idloc 0x1234 ;设定芯片的标记值为0x1234,注意前面有两个下划线符
例 3-03
和__config 伪指令定义的配置字一样,用__idloc 定义的芯片标记值在最后也会存放在HEX文件中,这就要求编程器能够解析它。
errorlevel
errorlevel 的用途是控制编译信息的输出显示。编译器在编译你的源程序时会提供很多信息,有些信息是你必须要处理的,例如错误信息(Error),只要有错误信息存在,你的程序将永远无法完成编译;有些可能只需要关注,例如警告信息(Warning);也有一些可能你根本就不感兴趣,它们只是一些提示信息(Message)而已。注意出现警告和提示信息时将不会中止编译器的编译工作,你的程序将被编译并最终产生 HEX文件。图 3-14 中显示了一个程序编译后的各种信息实例,其中既有错误信息,也有警告和提示信息。我们可以用errorlevel 伪指令来控制输出信息的级别,或刻意关闭/打开一些提示信息。
图 3-14
编译信息的输出显示级别有三种,分别是 0、1 和 2。级别 0 代表显示所有信息,包括各种错误、警告和提示信息,如图 3-14 所示;级别 1 代表显示错误和警告信息,忽略提示信息;级别 3代表只显示错误信息而忽略警告和提示信息。在任何一个大的级别上还可以对
某些信息单独设定显示或关闭。每个信息都有一个识别标号,见图 3-14 中信息项“[]”中的数字,打开或关闭某类信息只需在 errorlevel 伪指令中引用信息识别标号,并在其前面用“+”或“-”号,即代表打开或关闭这一类信息,例如:
errorlevel 0, -302, -305 ;显示所有信息,但不需要302 和 305 这两类提示信息
errorlevel 1, +305 ;显示错误和警告信息,但同时还要关注 305类的提示信息
例 3-04
#define / #undefine
#define 的作用是定义常数符号,即用一个符号变量替换另一个符号串或变量。被替换的可以是任意字母数字组成的符号但替换者本身不能是一个纯数字。例如:
#define DELAY_TIME 1000 ;定义常数符号,即用DELAY_TIME符号代替 1000
#define KEY1 PORTB,7 ;用KEY1符号代替端口 PORTB 的第7 引脚
例 3-05
用#define 伪指令定义符号后,可使程序中的变量或指令变得更具实际意义,也使程序变得更易维护。指令“btfss PORTB,7”和“btfss KEY1”在事先用了例 3-05 中的#define 后编译的结果是一样的,但明显地后者看起来更容易理解,一看就知道这是在测试编号为KEY1 的一个按键。而且如果你的硬件设计改动了 KEY1 所接的单片机引脚,只要改动这一处#define 重新定义引脚位置,程序的其它部分无需任何修改,再编译一次即可得到更新后的软件代码。一个好的编程习惯是事先把一些代表实际意义的变量、单片机的输入输出引脚在硬件电路中的实际功能等用#define 伪指令定义成简单直观的符号名字,然后在程序中直接用其符号名字而不用简单机械的数字形式。替换的工作由编译器在编译时自动完成。它会先扫描你的源程序代码,把事先#define 的符号名改回成被替换的字符串,然后再继续编译生产机器码。