DJYOS定时器组件硬件接口手册.PDFVIP

DJYOS 定时器组件硬件接口说明 编写: 朱海兵 2015 年3 月23 日 Review: _年_月_ 日 审阅:罗侍田 贡献者列表 DJYOS 开发团队。 1.概述 DJYOS 的定时器管理，分软件定时器(SoftTimer)和硬件定时器(HardTimer)两部分。 软件定时器组件，允许用户申请任意多个定时器（受内存容量限制），依用户所需要的 精度，它的时钟源可以选择系统tick ，定时精度也不超过tick 间隔；也可以选择硬件定时器， 其精度只受硬件定时器本身和中断响应延迟的限制。 如何选择tick 还是硬件定时器做时基呢？ 软件定时器初始化时，如果参数选择 CN_TIMER_SOURCE_TICK。即： ModuleInit_SoftTimer(CN_TIMER_SOURCE_TICK); 则表明使用tick 作为时钟源。 如果选择CN_TIMER_SOURCE_HARD，则使用硬件定时器作为时钟源。 如果用硬件定时器，则需要确认在“工程目录\\src\user\critical\critical.c ”文件的critical 函数中调用ModuleInit_HardTimer 函数的代码行不被注释。此时，ModuleInit_SoftTimer 函 数会调用HardTimer 模块的功能，申请硬件定时器，如果申请不到，则返回错误。 HardTimer 组件并不是SoftTimer 组件专用的，它可以管理除Tick 定时器以外的全部硬 件定时器，提供通用的高精度定时服务。HardTimer 模块标准化了硬件接口，如果你需要使 用硬件定时器服务，就需要编写标准接口函数，否则，本文剩余部分，就不需要阅读了。 当然，软件所需要的定时功能千差万别，硬件定时器提供的支持也百花齐放，HardTimer 模块不可能穷举所有可能，它只提供通用的定时服务。如果你所需要的定时功能咱没有提供， 你大可绕开timer 模块，天马行空，怎么写驱动都行。 关于DJYOS 定时器组件的使用方法可详见《都江堰操作系统用户手册》的“定时器组 件”章节。 2.移植的源码目录 如果使用CPU 内置定时器，在eclipse 工程中的目录中将有如下文件： src-OS_code-bsp-cpudrv-src-cpu_peri_timer.c 。 相应的头文件目录为： src-OS_code-bsp-cpudrv- src-cpu_peri_timer.h 。 在文件系统 （硬盘）中的目录结构是： djysdk\djysrc\bsp\cpudrv\cpu_name\src\cpu_peri_timer.c。 下面阐述怎么编写这两个文件。 3.实现标准硬件接口函数 DJYOS 定时器底层驱动需要提供四个函数，分别是ModuleInstall_HardTimer(HardTimer 初始化)及硬件定时器模块需要调用的三个钩子函数。 3.1 硬件定时器初始化 void ModuleInstall_HardTimer(void); 头文件： cpu_peri_timer.h 参数：无。 返回值：无。 说明： 该函数功能为定时器初始化，需要完成以下四个工作： 1. 使能定时器时钟； 2. 配置时钟频率； 3. 对定时器芯片结构体tagTimerChip 成员赋值； 4. 调用系统函数TimerHard_RegisterChip 将该定时器注册到系统时钟芯片中。 tagTimerChip 在timer_hard.h 中定义，具体如下： struct tagTimerChip { char *chipname; //chip名字，必须为静态型 fnTimerHardAlloc timerhardalloc; //分配定时器 fnTimerHardFree timerhardfree; //释放定时器 fnTimerHardCtrl timerhardctrl ; //操