www.zigbee-sh.cn
郑州新双恒译
HAL 驱动
应用程序编程接口
文件编号:F8W-2005-1504
德州仪器股份有限公司
美国加利福尼亚州圣迭戈
(619) 542-1200
版权 © 德州仪器公司 2005 版权所有 违者必究
www.zigbee-sh.cn
郑州新双恒译
HAL驱动API
F8W-2005-1504版本1.2
版本
1.0
1.1
1.2
描述
初始版本
更新了 HAL 睡眠
更新了 LCD 和定时器的 API
日期
03/02/2006
11/20/2006
11/22/2006
i
版权 © 德州仪器公司 2005 版权所有 违者必究
www.zigbee-sh.cn
郑州新双恒译
HAL驱动API
F8W-2005-1504版本1.2
目录
1、简介............................................................................................................................................... 1
1.1 目的....................................................................................................................................1
1.2 缩写....................................................................................................................................1
2、驱动 API 概览.............................................................................................................................. 2
2.1 函数调用............................................................................................................................2
2.1.1 初始化函数调用.....................................................................................................2
2.1.2 服务访问函数调用.................................................................................................2
2.1.3 回调函数调用.........................................................................................................2
2.2 服务....................................................................................................................................2
3、ADC 服务......................................................................................................................................3
3.1 HalAdcInit()....................................................................................................................... 3
3.1.1 描述.........................................................................................................................3
3.1.2 函数原型.................................................................................................................3
3.1.3 参数描述.................................................................................................................3
3.1.4 返回值.....................................................................................................................3
3.2 HalAdcRead().....................................................................................................................3
3.2.1 描述...........................................................................................................................3
3.2.2 函数原型.................................................................................................................3
3.2.3 参数描述.................................................................................................................3
3.2.4 返回值.....................................................................................................................3
3.3 常量....................................................................................................................................3
3.3.1 信道.........................................................................................................................3
3.3.2 分辨率.....................................................................................................................4
4、LCD 服务......................................................................................................................................4
4.1 HalLcdInit()........................................................................................................................4
4.1.1 描述.........................................................................................................................4
4.1.2 函数原型.................................................................................................................4
4.1.3 参数描述.................................................................................................................4
4.1.4 返回值.....................................................................................................................4
4.2 HalLcdWriteString().......................................................................................................... 4
4.2.1 描述.........................................................................................................................4
4.2.2 函数原型.................................................................................................................4
4.2.3 参数描述.................................................................................................................4
4.2.4 返回值.....................................................................................................................5
4.3 HalLcdWriteValue()........................................................................................................... 5
4.3.1 描述.........................................................................................................................5
4.3.2 函数原型.................................................................................................................5
4.3.3 参数描述.................................................................................................................5
4.4 HalLcdWriteScreen()......................................................................................................... 5
4.4.1 描述.........................................................................................................................5
4.4.2 函数原型.................................................................................................................5
4.4.3 参数描述.................................................................................................................5
4.4.4 返回值.....................................................................................................................5
4.5 HalLcdWriteStringValue()................................................................................................. 5
ii
版权 © 德州仪器公司 2005 版权所有 违者必究
www.zigbee-sh.cn
郑州新双恒译
HAL驱动API
F8W-2005-1504版本1.2
4.5.1 描述.........................................................................................................................5
4.5.2 函数原型.................................................................................................................5
4.5.3 参数描述.................................................................................................................6
4.5.4 返回值.....................................................................................................................6
4.6 HalLcdWriteStringValueValue()........................................................................................6
4.6.1 描述.........................................................................................................................6
4.6.2 函数原型.................................................................................................................6
4.6.3 参数描述.................................................................................................................6
4.6.4 返回值.....................................................................................................................6
4.7 HalLcdDisplayPercentBar()...............................................................................................7
4.7.1 描述.........................................................................................................................7
4.7.2 函数原型.................................................................................................................7
4.7.3 参数描述.................................................................................................................7
4.7.4 返回值.....................................................................................................................7
4.8 常量....................................................................................................................................7
4.8.1 选项.........................................................................................................................7
5、LED 服务...................................................................................................................................... 7
5.1 HalLedInit()........................................................................................................................7
5.1.1 描述.........................................................................................................................7
5.1.2 函数原型.................................................................................................................7
5.1.3 参数描述.................................................................................................................7
5.1.4 返回值.....................................................................................................................8
5.2 HalLedSet()........................................................................................................................ 8
5.2.1 描述.........................................................................................................................8
5.2.2 函数原型.................................................................................................................8
5.2.3 参数描述.................................................................................................................8
5.2.4 返回值.....................................................................................................................8
5.3 HalLedBlink().................................................................................................................... 8
5.3.1 描述.........................................................................................................................8
5.3.2 函数原型.................................................................................................................8
5.3.3 参数描述.................................................................................................................8
5.3.4 返回值.....................................................................................................................8
5.4 HalLedGetState()............................................................................................................... 8
5.4.1 描述.........................................................................................................................8
5.4.2 函数原型.................................................................................................................9
5.4.3 参数描述.................................................................................................................9
5.4.4 返回值.....................................................................................................................9
5.5 HalLedEnterSleep()............................................................................................................9
5.5.1 描述.........................................................................................................................9
5.5.2 函数原型.................................................................................................................9
5.5.3 参数描述.................................................................................................................9
5.5.4 返回值.....................................................................................................................9
5.6 HalLedExitSleep()..............................................................................................................9
5.6.1 描述.........................................................................................................................9
5.6.2 函数原型.................................................................................................................9
5.6.3 参数描述.................................................................................................................9
iii
版权 © 德州仪器公司 2005 版权所有 违者必究
www.zigbee-sh.cn
郑州新双恒译
HAL驱动API
F8W-2005-1504版本1.2
5.6.4 返回值.....................................................................................................................9
5.7 常量....................................................................................................................................9
5.7.1 LEDs........................................................................................................................9
5.7.2 模式.......................................................................................................................10
6、按键服务.....................................................................................................................................10
6.1 HalKeyInit()..................................................................................................................... 10
6.1.1 描述.......................................................................................................................10
6.1.2 函数原型...............................................................................................................10
6.1.3 参数描述...............................................................................................................10
6.1.4 返回值...................................................................................................................10
6.2 HalKeyConfig()................................................................................................................10
6.2.1 描述.......................................................................................................................10
6.2.2 函数原型...............................................................................................................10
6.2.3 参数描述...............................................................................................................11
6.2.4 返回值...................................................................................................................11
6.3 HalKeyRead()...................................................................................................................11
6.3.1 描述.......................................................................................................................11
6.3.2 函数原型...............................................................................................................11
6.3.3 参数描述...............................................................................................................11
6.3.4 返回值...................................................................................................................11
6.4 HalKeyEnterSleep()......................................................................................................... 11
6.4.1 描述.......................................................................................................................11
6.4.2 原型.......................................................................................................................11
6.4.3 详细参数...............................................................................................................11
6.4.4 返回值...................................................................................................................11
6.5 HalKeyExitSleep()........................................................................................................... 12
6.5.1 描述.......................................................................................................................12
6.5.2 函数原型...............................................................................................................12
6.5.3 参数描述...............................................................................................................12
6.5.4 返回值...................................................................................................................12
6.6 HalKeyPoll().................................................................................................................... 12
6.6.1 描述.......................................................................................................................12
6.6.2 函数原型...............................................................................................................12
6.6.3 参数描述...............................................................................................................12
6.6.4 返回值...................................................................................................................12
6.7 HalKeyPressed().............................................................................................................. 12
6.7.1 描述.......................................................................................................................12
6.7.2 函数原型...............................................................................................................12
6.7.3 参数描述...............................................................................................................12
6.7.4 返回值...................................................................................................................12
6.8 常量..................................................................................................................................12
6.8.1 按键.......................................................................................................................13
6.8.2 操纵杆...................................................................................................................13
6.8.3 状态.......................................................................................................................13
7、睡眠服务.....................................................................................................................................13
7.1 HalSleep().........................................................................................................................13
iv
版权 © 德州仪器公司 2005 版权所有 违者必究
www.zigbee-sh.cn
郑州新双恒译
HAL驱动API
F8W-2005-1504版本1.2
7.1.1 描述.......................................................................................................................13
7.1.2 函数原型...............................................................................................................13
7.1.3 参数描述...............................................................................................................13
7.1.4 返回值...................................................................................................................13
7.2 HalSleepWait().................................................................................................................13
7.2.1 描述.......................................................................................................................14
7.2.2 函数原型...............................................................................................................14
7.2.3 参数描述...............................................................................................................14
7.2.4 返回值...................................................................................................................14
8、定时器服务.................................................................................................................................14
8.1 操作模式..........................................................................................................................14
8.2 信道..................................................................................................................................14
8.3 中断/信道模式.................................................................................................................14
8.4 HalTimerInit ()................................................................................................................. 14
8.4.1 描述.......................................................................................................................14
8.4.2 函数原型...............................................................................................................14
8.4.3 参数描述...............................................................................................................14
8.4.4 返回值...................................................................................................................14
8.5 HalTimerConfig().............................................................................................................14
8.5.1 描述.......................................................................................................................15
8.5.2 函数原型...............................................................................................................15
8.5.3 参数描述...............................................................................................................15
8.5.4 返回值...................................................................................................................15
8.6 HalTimerStart ()............................................................................................................... 15
8.6.1 描述.......................................................................................................................15
8.6.2 函数原型...............................................................................................................15
8.6.3 参数描述...............................................................................................................16
8.6.4 返回值...................................................................................................................16
8.7 HalTimerStop()................................................................................................................ 16
8.7.1 描述.......................................................................................................................16
8.7.2 函数原型...............................................................................................................16
8.7.3 参数描述...............................................................................................................16
8.7.4 返回值...................................................................................................................16
8.8 HalTimerTick().................................................................................................................16
8.8.1 描述.......................................................................................................................16
8.8.2 函数原型...............................................................................................................16
8.8.3 参数描述...............................................................................................................16
8.8.4 返回值...................................................................................................................16
8.9 HalTimerInterruptEnable().............................................................................................. 16
8.9.1 描述.......................................................................................................................17
8.9.2 函数原型...............................................................................................................17
8.9.3 参数描述...............................................................................................................17
8.9.4 返回值...................................................................................................................17
8.10 常量................................................................................................................................17
8.10.1 定时器 ID............................................................................................................17
8.10.2 信道.....................................................................................................................17
v
版权 © 德州仪器公司 2005 版权所有 违者必究
www.zigbee-sh.cn
郑州新双恒译
HAL驱动API
F8W-2005-1504版本1.2
8.10.3 信道模式.............................................................................................................17
8.10.4 操作模式.............................................................................................................17
8.10.5 分频数(预分频)..................................................................................................18
8.10.6 状态.....................................................................................................................18
9、UART 服务................................................................................................................................. 19
9.1 HalUARTInit()................................................................................................................. 19
9.1.1 描述.......................................................................................................................19
9.1.2 函数原型...............................................................................................................19
9.1.3 参数描述...............................................................................................................19
9.1.4 返回值...................................................................................................................19
9.2 HalUARTOpen().............................................................................................................. 19
9.2.1 描述.......................................................................................................................19
9.2.2 函数原型...............................................................................................................19
9.2.3 参数描述...............................................................................................................19
9.2.4 返回值...................................................................................................................21
9.3 HalUARTClose................................................................................................................ 21
9.3.1 描述.......................................................................................................................21
9.3.2 函数原型...............................................................................................................21
9.3.3 参数描述...............................................................................................................21
9.3.4 返回值...................................................................................................................21
9.4 HalUARTRead ()............................................................................................................. 21
9.4.1 描述.......................................................................................................................21
9.4.2 函数原型...............................................................................................................21
9.4.3 参数描述...............................................................................................................21
9.4.4 返回值...................................................................................................................21
9.5 HalUARTWrite()..............................................................................................................22
9.5.1 描述.........................................................................................................................22
9.5.2 函数原型...............................................................................................................22
9.5.3 参数描述...............................................................................................................22
9.5.4 返回值...................................................................................................................22
9.6 HalUARTIoctl ().............................................................................................................. 22
9.6.1 描述.......................................................................................................................22
9.6.2 函数原型...............................................................................................................22
9.6.3 参数描述...............................................................................................................22
9.6.4 返回值...................................................................................................................23
9.7 HalUARTPoll()................................................................................................................ 23
9.7.1 描述.......................................................................................................................23
9.7.2 函数原型...............................................................................................................23
9.7.3 参数描述...............................................................................................................23
9.7.4 返回值...................................................................................................................23
9.8 Hal_UART_RxBuffLen()................................................................................................ 23
9.8.1 描述.......................................................................................................................23
9.8.2 函数原型...............................................................................................................23
9.8.3 详细参数...............................................................................................................23
9.8.4 返回值...................................................................................................................24
9.9 Hal_UART_TxBuffLen().................................................................................................24
vi
版权 © 德州仪器公司 2005 版权所有 违者必究
www.zigbee-sh.cn
郑州新双恒译
HAL驱动API
F8W-2005-1504版本1.2
9.9.1 描述.......................................................................................................................24
9.9.2 函数原型...............................................................................................................24
9.9.3 详细参数...............................................................................................................24
9.9.4 返回值...................................................................................................................24
9.10 Hal_UART_FlowControlSet().......................................................................................24
9.10.1 描述.....................................................................................................................24
9.10.2 函数原型.............................................................................................................24
9.10.3 参数描述.............................................................................................................24
9.10.4 返回值.................................................................................................................24
9.11 常量................................................................................................................................ 24
9.11.1 UART 端口......................................................................................................... 24
9.11.2 波特率.................................................................................................................24
9.11.3 奇偶性(奇偶校验).............................................................................................. 25
9.11.4 停止位.................................................................................................................25
9.11.5 状态.....................................................................................................................25
9.11.6 回调事件.............................................................................................................25
vii
版权 © 德州仪器公司 2005 版权所有 违者必究