第4章：硬件适配层应用——LED

本章导读

前几章我们看了 Z-Stack 的"大脑"（OSAL 调度）。这一章开始看"手脚"——HAL（硬件抽象层）。

为什么单独把 LED 拎出来讲？因为它是理解 HAL 的最佳入门案例：硬件简单（一个引脚 + 一个灯）、代码路径完整（从应用层 API → HAL 驱动 → GPIO 寄存器 → 灯亮）。看懂 LED 这条"链路"，后面按键、串口、显示屏都是同一套思路。

一、HAL 是什么

**HAL（Hardware Abstraction Layer，硬件抽象层）**是 Z-Stack 里负责"操作硬件"的一层。

它的设计思想一句话：把"硬件长什么样"和"上层想干什么"分开。

生活类比：HAL 就是"插座"。上层应用是"电器"（电饭煲、台灯），它只需要知道"插上去就能用"，完全不关心插座背后的电线怎么走、电从哪来。换一套插座（换开发板），电器不用改。

对应到代码上：

层级	关心什么	例子
应用层	想干什么	"点亮 LED1"
HAL 驱动	怎么操作这块板子	"把 P1_0 引脚输出低电平"
寄存器层	芯片内部怎么配	P1DIR 置位、P1_0 清零

好处：TI 的例程可以在不同开发板之间移植，就是因为 HAL 把"板子差异"都隔离在了自己这一层。你换一块板子，只需要改 HAL 的配置文件。

二、先看电路：GEC2530 底板的 LED（对照原理图）

打开 GEC2530 开发板底板原理图的 Sheet 8（LED 指示电路），可以看到 6 路 LED 的完整电路：

VDD_IO ──┬── LED1(D1) ──[330Ω R57]── P1_0
         ├── LED2(D2) ──[330Ω R58]── P1_1
         ├── LED3(D3) ──[330Ω R59]── P1_4
         ├── LED4(D4) ──[330Ω R63]── P0_1
         ├── REMOTI_LED0(D5)─[330Ω R65]── P0_7
         └── REMOTI_LED1(D6)─[330Ω R67]── P0_1

关键信息（与原理图一一对应）：

LED	控制引脚	限流电阻	点亮条件
LED1	P1_0	R57 = 330Ω	引脚输出低电平
LED2	P1_1	R58 = 330Ω	引脚输出低电平
LED3	P1_4	R59 = 330Ω	引脚输出低电平
LED4	P0_1	R63 = 330Ω	引脚输出低电平
REMOTI_LED0	P0_7	R65 = 330Ω	引脚输出低电平

看懂这个电路的两点：

LED 阳极接 VDD_IO，阴极经 330Ω 限流电阻接到 GPIO——所以 GPIO 输出低电平时 LED 才亮（低电平点亮）；
330Ω 限流电阻是必须的：LED 不能直接接电源，否则电流过大烧毁；330Ω 把电流限制在安全范围（VDD_IO=3.3V 时约 8~10mA）。

⚠️ 极性容易搞反：写代码前一定要确认你的板子是"低电平点亮"还是"高电平点亮"。GEC2530 底板是低电平点亮——也就是说，GPIO 输出 0 时灯亮，输出 1 时灯灭。很多同学第一次写 LED 程序点不亮，一半的原因是极性反了。

三、LED 驱动 API 简介

Z-Stack 的 HAL 为 LED 提供了完整的驱动 API，定义在 Components\hal\include\hal_led.h 中。最常用的三个：

① HalLedInit() —— 初始化 LED

void HalLedInit(void);

把用到的 LED 引脚配置为输出模式。它由 HAL 初始化流程自动调用（Hal_Init() 里会调用），一般不需要你手动调用。

② HalLedSet() —— 设置 LED 状态（最常用）

uint8 HalLedSet(uint8 led, uint8 mode);

参数	含义
`led`	要操作的 LED：`HAL_LED_1` / `HAL_LED_2` / `HAL_LED_3` / `HAL_LED_4`（可组合）
`mode`	状态：`HAL_LED_MODE_OFF`(灭) / `HAL_LED_MODE_ON`(亮) / `HAL_LED_MODE_TOGGLE`(翻转)

③ HalLedBlink() —— LED 闪烁

uint8 HalLedBlink(uint8 led, uint8 numBlinks, uint8 percent, uint16 period);

参数	含义
`numBlinks`	闪烁次数
`percent`	亮的时间占比（0~100，如 50 = 亮一半灭一半）
`period`	一个闪烁周期的毫秒数

这三个 API 内部帮你做了所有脏活：查表找到 LED 对应的引脚 → 配置方向 → 置位/清零。应用层永远只需要说"我要灯亮"，不需要知道引脚号——这就是 HAL 的价值。

四、LED 实验：让 LED1 闪烁

实验目标

在 SampleSwitch 工程上，让板上的 LED1（P1_0） 以 1 秒周期闪烁（亮 500ms、灭 500ms）。

第 1 步：确认 LED 引脚定义

在 HAL 的板级配置文件中（Components\hal\target\CC2530EB\Config\hal_board_cfg.h），LED 与引脚的对应关系通过宏定义：

/* HAL LED 宏定义（示意，具体以你的工程配置为准） */
#define LED1_BV  BV(0)      // P1_0 所在位
#define LED1_SBIT P1_0      // LED1 接在 P1_0

对照原理图：GEC2530 底板 LED1 = P1_0。如果你的板子不同，只需改这里——HAL 的"插座"思想就体现在这。

第 2 步：应用层调用 API

在应用层初始化函数 zclSampleSw_Init() 中，添加 LED 初始化与闪烁代码：

void zclSampleSw_Init(byte task_id) {
    // ……其他初始化……

    HalLedInit();                        // ① 初始化 LED（配置引脚为输出）
    HalLedSet(HAL_LED_1, HAL_LED_MODE_ON);  // ② 点亮 LED1（验证极性：低电平点亮）
    HalLedBlink(HAL_LED_1, 10, 50, 1000);   // ③ 闪烁 10 次：亮 500ms 灭 500ms
}

代码	做了什么
`HalLedInit()`	把 LED1 引脚（P1_0）配置为 GPIO 输出
`HalLedSet(HAL_LED_1, HAL_LED_MODE_ON)`	输出低电平 → 灯亮（若你的板子是高电平点亮，这里会是灭的，改配置即可）
`HalLedBlink(..., 50, 1000)`	按 50% 占空比、1000ms 周期闪烁

第 3 步：编译下载观察

右击工程 → Rebuild All 编译（errors 0 / warnings 0）；
使用仿真器把程序烧录到 GEC2530 开发板（注意选择正确的设备类型：协调器/路由器/终端均可）；
运行程序，观察 LED1：先常亮，随后以 1 秒周期闪烁 10 次。

实验变式：把 HalLedSet 换成 HalLedSet(HAL_LED_1 | HAL_LED_2, HAL_LED_MODE_ON)，可以同时点亮 LED1 和 LED2（P1_0、P1_1）——感受一下"多个 LED 组合操作"。

五、小结

问题	答案
HAL 是什么？	硬件抽象层：隔离"硬件差异"，让上层只说"想干什么"
GEC2530 的 LED 怎么接？	LED 阳极接 VDD_IO，阴极经 330Ω 接 GPIO，低电平点亮
LED1~LED4 引脚？	P1_0 / P1_1 / P1_4 / P0_1
最常用的三个 API？	`HalLedInit()` / `HalLedSet()` / `HalLedBlink()`
换板子怎么办？	只改 HAL 板级配置文件，应用层代码不动

一句话总结：LED 实验是"应用层 → HAL → GPIO"这条链路的最小完整样例。上层一个 API 调用，HAL 负责找到引脚、配置方向、输出电平——这条"API 调用链"的思维，将贯穿后面按键、串口、显示屏所有硬件章节。

课堂练习：LED

依据第4章：HAL 概念、LED 电路、三个 API（Init/Set/Blink）作答。点击选项即可作答、即时反馈对错。

HAL 概念、LED 电路（低电平点亮）、HalLedInit/Set/Blink

1 HAL（硬件抽象层）的核心作用是什么？

2 GEC2530 底板上，LED1 接在哪个引脚？

3 GEC2530 底板的 LED 是什么点亮条件？

4 HalLedSet(HAL_LED_1, HAL_LED_MODE_TOGGLE) 的作用是？

5 HalLedBlink(HAL_LED_1, 10, 50, 1000) 中参数 1000 的含义是？

已完成 0 / 5 题

内容来源：紫甲 IoT《ZigBee 3.0 开发指南》第三部分·第4章（4.1~4.4），经本站整理优化以便于理解，电路部分已对照 GEC2530 开发板底板原理图核对；原站链接

第1章：Z-Stack 3.0 架构详解