本文档包括单片机系统中常用到的时钟中断、通讯及键盘扫描等模块(见所附源程序)的说明。这些模块使用前后台系统模型。为达到最大的灵活性, 需要在用户工程中定义config.h文件, 在其中定义各模块可选参数的设置,而不是直接更改源代码。

这些可选内容大部分为宏定义,如果不定义宏相应的功能在编译时被屏蔽,不会增加代码长度。 具体可选内容见各模块中的说明。

在Config.h文件中还要包含一个单片机硬件的资源头文件。

各模块使用了定义在Common.h中的一些数据类型。如:BIT(bit) BYTE(unsigned char)等,具体请参见源程序。

时钟模块

  在单片机软件设计中, 时钟是重要资源, 为了充分利用时钟资源, 故设计本时钟模块。 本模块使用定时器0,在完成用户指定功能的同时, 还能够自动处理一些其它模块中与时钟相关的信息。

  时钟模块由声明文件Timer.h以及实现文件Timer.c组成。

  用户应该在Config.h中定义宏TIMER_RELOAD来设定定时器0的重装载初值。推荐的定时器0的中断时间大于1毫秒。

  在程序的初始化阶段调用时钟模块的初始化函数InitTimerModule()之后,就可以使用时钟模块所以支持的各种功能。具体描述如下:

延时:当用户需要进行一定时间的延时时,可以通过调用Delay()来进行,参数为时钟中断的次数。如时钟中断周期为1ms, 想进行100ms的延时, 则可以调用Delay(100)。

注意:

如果延时的绝对时间小于时钟中断的周期,则不能够用本方法做到延时。

定时:当程序中需要使用定时功能时,如等待某外部事件,如果在一定时间内发生则继续执行,如果在这段时间内发生,则认为出现错误,转向错误处理机制。

在此推荐一种编程模式,但用户可以用自己认为更合理的方式处理此类问题。

这里简单说明一下关于阻塞式函数及非阻塞式函数。简单说,阻塞式函数就是当检测完成条件,如果不能够完成则等待,如:

void CheckSomething()

{

  // gbitSuccessFlag is a global variable

  while(gbitSuccessFlag == FALSE)

  {

    // do nothing but waiting

  }

}

可以看到,当bitSuccessFlag没有被设置为TRUE时,函数保持等待状态不返回,这样就是阻塞式的函数。

另外一种情况:

BIT CheckSomething()

{

  if(gbitSuccessFlag == TRUE)

  {

    // …

    return TRUE;

  }

  return FALSE;

}

在这里,如果所检测的事件有没有完成,函数进行检测之后,立刻返回,通过返回值报告完成情况,如果没有完成,则等待调用者分配再次执行的机会。这样的函数就是非阻塞函数。

在应用定时功能时,首先要将检测函数定义成非阻塞函数。如上面的第二个版本的CheckSomething。

然后下面模式:

BIT bitDone = FALSE;

ResetClock(); // clear timer interrupt times counter

while(GetClock() < MAX_WAITINGTIME)

{

  if(CheckSomething() == TRUE)

  {

    bitDone = TRUE;

    break;

  }

}

if(bitDone == FALSE)

{

  // process time out

}

或者简单写成:

BIT bitDone = FALSE;

ResetClock();

while(GetClock() < MAX_WAITINGTIME && (bitDone = CheckSomething));

if(bitDone == FLASE)

{

  // …

}

软件看门狗:实现具有局限性的看门狗功能。在程序中合适的地方加入对软件看门狗的复位函数ResetWatchDog(),在Config.h中加入宏TIMER_WATCHDOGTIMEOUT。当程序运行时,如果在发生TIMER_WATCHDOGTIMEOUT次时钟中断之内没有复位软件看门狗, 则系统复位。

注意:

如果没有加入TIMER_WATCHDOGTIMEOUT宏,程序中的ResetWatchDog没有任何用处,不用删除。

如果系统不能实现时钟中断,则软件看门狗也同时失去功能。

目前版本的的时钟模块的复位功能并不是完全复位,主要表现在当复位之后,系统将不再响应任何中断。所以软件看门狗只是一个程序的调试功能,不应该将它用于正式工作的程序,此时应该使用硬件看门狗。

用户自定义任务:如果想在时钟中断内执行一些耗时较短的任务,可以定义回调函数OnTimerInterrupt。函数原形为:void OnTimerInterrupt();

如果想在发生时钟中断时执行一些功能,而这些功能又耗时相对较长,不合适放在中断响应函数内部,则可以在程序中的主循环中的任意地方添加: ImpTimerService(),同时提供原形为void OnTimerEvent()的回调函数。具体的程序如下所示:

void main()

{

  Initialize();

  while(TRUE)

  {

    // … working

    ImpTimerService();

    // … working

  }

}

void OnTimerEvent()

{

  // do some task

}

对通讯模块提供支持:如通讯中的各种超时等,见通讯模块中的详细说明。

对键盘扫描模块提供支持:可以自动调用键盘扫描模块,见键盘扫描模块中的详细说明。

对程序调试提供支持:在程序开发过程中,有时为了判断程序是不是在工作,常用利用单片机系统的某一空闲引脚通过一个限流电阻接一个发光二极管,在程序中间隔固定时间交替控制发光管的明暗。实现这个功能只要在Config.h文件中定义TIMER_FLASHLED宏,如:

#define TIMER_FLASHLED        P1_0

则当时钟中断发生256次之后,改变发光管的状态。

通讯模块

  串口资源做为单片机与外界通信的常用手段,通讯模块提供了完全缓冲的串口通讯底层机制,适用于长度不大的数据包的发送及接收。如果处理关键数据,需要用户自己提供纠错协议。

  通讯模块由声明文件SComm.h及实现文件SComm.c组成。

  初始化:调用函数InitSCommModule()来初始化通讯模块:

  void InitSCommModule(BYTE byTimerReload, BIT bitTurbo)

  参数说明:

byTimerReload: 定时器1的重装载初始值。

bitTurob: 当此参数为TRUE时,串行通讯在定时器1的溢出速率基础上加倍。为FALSE时,串行通讯速率为定时器1的溢出速率。

  缓冲区:模块使用了由宏SCOMM_SENDBUFSIZE、SCOMM_RECEBUFSIZE及SCOMM_PKGBUFSIZE所指定长度的三个缓冲区,分别为发送、接收及数据包(用于处理接收到的数据)缓冲区(如果没有使用异步接收功能,则不需要使用数据包缓冲区)。

  在缺省时,这三个宏都被定义为10,但用户可以自已按照系统的RAM资源占用情况在Config.h中重定义缓冲区的大小。需要注意的是,如果缓冲的长度不够,当发送或接收长数据包的时候可能会发生问题,关于数据缓冲区的最小值的设置可以参考下面的说明。

  注意:需要尽快取出接收缓冲区中的数据,否则当缓冲区满之后,新的数据将被简单的丢掉。

  字节级服务函数: 在Config.h文件中定义了宏SCOMM_DriverInterface(如:#define SCOMM_DriverInterface),则可以使用字节级服务函数,即通讯模块的底层函数。

  共有两个函数可以使用:

  void SendByte(BYTE byData);

  发送一个字节,如果当前缓冲区满,则等待。参数byData为要发送的数据。

BYTE ReceByte();

接收一个字节,如果当前缓冲区中没有数据,则此函数阻塞,直到接收到数据为止。接收到数据通过返回值返回。

可以通过调用IsSendBufEmpty() IsSendBufFull() IsReceBufEmpty() IsReceBufFull()  宏来判断缓冲区的空或满,以防系统阻塞。

不推荐直接使用这一级的服务函数,应该使用高层次上的服务函数或者在这一级服务函数的基础上构造自己的通讯函数。

  

  数据包级服务函数:在Config.h文件中定义宏SCOMM_PackageInterface(如: #define SCOMM_PackageInterface)则可以使用数据包级服务函数。

  共有两个函数可以使用:

void SendPackage(BYTE* pbyData, BYTE byLen);

发送数据包,参数pbyData为将要发送的数据包缓冲区(数组)的指针,byLen为将要发送的数据包的长度。

当没有定义SCOMM_DriverInterface时,数据被完全缓冲。即不能够发送长度超过发送缓冲区长度的数据包。当定义了SCOMM_DriverInterface时,采用单字节发送,这时不限制需要发送的数据的长度。

BYTE RecePackage(BYTE* pbyData, BYTE byLen);

接收数据包,参数pbyData为存放将要接收的数据的缓冲区,byLen为缓冲区长度。返回值为接收到的字节数,当模块的接收缓冲区为空时,函数非阻塞,立即返回,返回值为零。

同步发送接收服务函数:

比如在一个串行总线多机通讯系统中,主机需要定时循检各从机的状态,往往是发一个包含从机地址及指令的数据包给从机,之后等待一定的时间,从机需要在这段时间之内给主机一个应答,如果没有这个应答,则认为从机工作状态出错,转去进行相应的处理。在这个模型里,主机不能够不进行等待而给另一台从机发送指令,也不能够不管从机在很久没有应答的情况下继续等待。还有一种情况,比如当使用485总线进行通信时,如果是两条通讯线则系统只能工作在半双工模式下,总线在同一时间内只能工作在发送或接收, 为了防止发送和接收相互干扰,这时的通讯常常需要使用同步发送和接收。

当在Config.h文件中定义宏SCOMM_SyncInterface后,则可以使用通讯模块提供同步发送接收函数:

void SendPackage(BYTE* pbyData, BYTE byLen);

发送数据包,参数pbyData为将要改善的数据包的缓冲区指针,byLen为将要发送的数据包的长度。

这个函数可以保证等待一个完整的数据包完全发送出去之后,它才返回,在这段时间内,它会阻塞运行。

BYTE SyncRecePackage(BYTE* pbyBuf, BYTE byBufLen, WORD wTimeout, BYTE byParam);

接收数据包。返回值为接收到的数据包长度。参数pbyBuf为将要接收数据包的缓冲区的指针,byBufLen为提供的缓冲区的长度,wTimeout为通信超时值,如果在发生了由wTimeout所指定次数的时钟中断而还没有接收到或没有接收到完整的数据包时,函数返回零,最后一个参数byParam的含义见后面的解释。

异步发送接收服务函数:

在一个简单的系统或多机通讯系统中的从机上,一般情况下不需要复杂的停等的工作模式,而且往往单片机需要对硬件进行控制和检测,不允许长时间的停下来检测通讯,但又要求当需要通讯时需要尽快的反应速度,这时就需要使用异步发送和接收服务函数。

使用异步发送和接收服务函数需要在Config.h文件中定义SCOMM_AsyncInterface宏。

同样提供两个服务函数:

void SendPackage(BYTE* pbyData, BYTE byLen);

发送数据包,参数pbyData为将要改善的数据包的缓冲区指针,byLen为将要发送的数据包的长度。

这里的函数的接口与同步发送和接收的服务函数相同。关于这里的细节,见后面对同步和异步服务函数的说明。

void AsyncRecePackage(BYTE byParam);

接收数据包,参数byParam的意义见后面的描述。

使用异步通讯需要用户定义一个回调函数,原型如下:

void OnRecePackage(BYTE* pbyData, BYTE byBufLen);

当异步接收服务函数接收到数据包之后,调用OnRecePackage回调函数,在pbyData指定的缓冲区中存放数据包,byBufLen为数据包的长度。

在Config.h文件中定义宏SCOMM_TIMEOUT可以设定异步接收的超时值,当开始接收数据包,但没有收完数据而发生了SCOMM_TIMEOUT次时钟中断后,认为接收超时, 将已接收到的数据删除。

同步和异步通讯服务函数:

有些情况下,比如一个通讯系统中,由一台计算机通过串口控制主机,主机通过串口连接很多从机,主机的串口采用分时复用,在这样的模型中,主机和控制计算机之间的通讯可以使用,异步通讯方式,而主机与从机可以使用同步通讯方式。而同步和异步的发送函数接口是相同的,在这样的情况下,发送都是同步的。在这样的模型中,当使用不同的接收函数之前,需要注意清除接收缓冲区中的内容,通讯模块提供函数:ClearReceBuffer来做到这一点,此函数原型如下:

void ClearReceBuffer();

KeilC51常用功能模块使用说明的更多相关文章

  1. PHP常用功能模块

    错误异常模块 错误处理 1. 系统定义了一些二进制码,用来表示错误报告的级别:     在 /etc/php5/apache2/php.ini中修改php配置文件,其中display_errors默认 ...

  2. Biopython常用功能模块

    Biopython项目是旨在减少计算生物学中代码重复的开源项目之一,由国际开发人员协会创建. 它包含表示生物序列和序列注释的类,并且能够读取和写入各种文件格式(FASTA,FASTQ,GenBank和 ...

  3. python常用功能模块

    路径相关:os.pathlib Windows注册表相关:winreg 系统cpu.内存.线程相关:psutil 文件.文件夹处理:shutil 解析和生成ini文件:ConfigParser:(co ...

  4. 使用Teigha.net读取CAD的常用功能模块

    Teigha中实体旋转 代码: using (var trans = database.TransactionManager.StartTransaction()) { Entity ent = tr ...

  5. Atiit 常见功能 常用功能与模块的最快速解决方案

    Atiit 常见功能 常用功能与模块的最快速解决方案 一.大力使用第三方API接口 一.导出excel jquery.table2excel 二.Form表单验证,使用h5验证属性 验证发生在form ...

  6. CTO也糊涂的常用术语:功能模块、业务架构、用户需求、文档……

    功能模块.业务架构.需求分析.用户需求.系统分析.功能设计.详细设计.文档.业务.技术--很多被随口使用的名词,其实是含糊甚至错误的. 到底含糊在哪里,错误在哪里,不仅仅是新手软件开发人员糊涂,许多入 ...

  7. [转]WebPack 常用功能介绍

    概述 Webpack是一款用户打包前端模块的工具.主要是用来打包在浏览器端使用的javascript的.同时也能转换.捆绑.打包其他的静态资源,包括css.image.font file.templa ...

  8. FastReport.Net 常用功能总汇

    一.常用控件 文本框:输入文字或表达式 表格:设置表格的行列数,输入数字或表达式 子报表:放置子报表后,系统会自动增加一个页面,你可以在此页面上设计需要的报表.系统在打印处理时,先按主报表打印,当碰到 ...

  9. WebPack常用功能介绍

    概述 Webpack是一款用户打包前端模块的工具.主要是用来打包在浏览器端使用的javascript的.同时也能转换.捆绑.打包其他的静态资源,包括css.image.font file.templa ...

随机推荐

  1. JS如何封装一些列方法为一个对象的操作,然后集中管理这些操作,方便修改和调用

    var Api = { ajax:{ // 添加项目 旧! add_project : function(pro_name, html, css, js,callback) { $.post(&quo ...

  2. 黑马程序员-集合(二)contains()方法的内部探索

    ------Java培训.Android培训.iOS培训..Net培训.期待与您交流! ------- 我们知道集合是用来存储对象的.在他们实现了众多的接口我们以Arraylist为列子 所有已实现的 ...

  3. 1.RABBITMQ 入门 - WINDOWS - 获取,安装,配置

    一. 背景:     公司项目有所改动,要求微信(移动端调用的接口),日志接口换位log4net,全部改成以rabbitMQ作为服务支持, 二.本地环境:     windows 10 enterpr ...

  4. [DB2]实现项目多数据库切换(上)--环境部署

    基本软硬件信息:Windows 8.1 X64 / Microsoft Visual Studio 2012  / ThinkPad S3-S431 安装工具:IBM Data Studio 4.1. ...

  5. ios 设置label的高度随着内容的变化而变化

    好吧 步骤1:创建label _GeRenJianJie = [[UILabel alloc]init]; 步骤2:设置label _GeRenJianJie.textColor = RGBAColo ...

  6. CSS 伪元素

    CSS伪元素是用来添加一些选择器的特殊效果. 语法 伪元素的语法: selector:pseudo-element {property:value;} CSS类也可以使用伪元素: selector.c ...

  7. js获取页面元素距离浏览器工作区顶端的距离

    先介绍几个属性:(暂时只测了IE和firefox,实际上我工作中用到的最多的是chrome)  网页被卷起来的高度/宽度(即浏览器滚动条滚动后隐藏的页面内容高度) (javascript)       ...

  8. cocos2d-x Android 环境搭建问题汇总

    初次接触Cocos2d-x,准备搭建一个hello world的Android环境,问题遇到很多.在此记录,为自己,也为大家,避免重走弯路! 具体的环境搭建,可以参考官方的文档.在Windows7平台 ...

  9. 总结javascript继承的两种方式的N中写法

    最近翻看博客园,总结了一下javascript的继承方式:prototype和copy继承方式. 一.prototype方式 当一个函数被创建时,Function构造函数产生的函数会隐式的被赋予一个p ...

  10. codeblocks调试(转载)

    单步调试  1)设置断点  在需要设置断点处,右击左边行号,Add breakpoint,则出现一个红色的点(可以同时设置多个,前提是不能在debug的运行模式下). 2)调试运行 Debug-> ...