使用 Arduino 和 Alexa 打造动画智能 LED 灯带控制系统

项目概述

本项目将指导你构建一个由 Amazon Alexa 语音控制的动画智能 LED 灯带系统。系统采用分层架构：Alexa 技能处理语音指令，AWS Lambda 函数作为桥梁，AWS IoT 设备影子存储灯带状态，树莓派通过 MQTT 订阅状态变化并通过串口指挥 Arduino 驱动 WS2812B (NeoPixel) 灯带。Arduino 运行 ALA (Arduino Light Animations) 库实现丰富的灯光动画效果。

所需硬件

• Arduino Uno / Nano / Mega（任选其一，Mega 可驱动更多像素点）
• 树莓派 3 Model B
• WS2812B / NeoPixel 可编程 LED 灯带
• Micro USB 线（连接树莓派与 Arduino）
• 电源适配器（分别为树莓派和灯带供电）
• 杜邦线、面包板等基础连接材料

所需软件与云服务

• Arduino IDE（上传 ALA 库固件）
• AWS 账号（使用 AWS IoT Core、Lambda、IAM）
• Amazon 开发者账号（创建 Alexa 自定义技能）
• GitHub 仓库代码：bportaluri/LightStrip

系统架构

整个系统包含以下核心组件：

1. Amazon Alexa：自定义技能 "Light Strip" 定义语音交互模型，将语音指令转换为意图发送给 Lambda。
2. AWS Lambda (Python)：接收 Alexa 请求，更新 AWS IoT 设备影子的期望状态。
3. AWS IoT Core：维护设备影子，通过 MQTT 将影子变更（delta）推送给订阅者（树莓派）。
4. 树莓派：运行 Python MQTT 客户端，订阅影子变更，通过串口向 Arduino 发送控制指令。
5. Arduino + ALA 库：解析串口指令，驱动 LED 灯带播放动画、变色、调节亮度等。

分步实施指南

第一阶段：硬件基础与 Web 控制（预备项目）

首先完成 Web-Controlled LED Animations with Raspberry Pi and Arduino 项目，建立树莓派、Arduino 与灯带的物理连接，并实现通过浏览器控制动画。这一步验证硬件通信无误，为后续接入 Alexa 打下基础。

第二阶段：AWS IoT 设备影子配置

1. 创建 IoT 策略

• 登录 AWS 控制台，切换到 US East (N. Virginia) 或 EU (Ireland) 区域。
• 进入 IoT Core > Secure > Policies，创建策略 LightStripPolicy：

Action: *
Resource: *
Effect: Allow

2. 注册 Thing 并下载证书

• 在 Manage > Things 创建单个 Thing，命名为 LS01。
• 选择 "One-click certificate creation" 生成证书，下载设备证书、私钥、公钥及 Root CA（Amazon Root CA 1）。
• 激活证书，附加刚创建的 LightStripPolicy。
• 记下 AWS IoT Endpoint（在 Settings 页面），后续配置树莓派需要。

第三阶段：树莓派 MQTT 客户端部署

# 安装 AWS IoT Device SDK for Python
sudo pip3 install AWSIoTPythonSDK

# 获取项目代码
mkdir -p /home/pi/LightStrip
cd /home/pi/LightStrip
wget https://github.com/bportaluri/LightStrip/archive/master.zip
unzip master.zip

# 复制证书到项目目录
cp /path/to/downloaded/certs/* /home/pi/LightStrip/LightStrip-master/pi/

编辑 lightstripcfg.py，填入：

• AWSIOT：你的 IoT Endpoint
• ROOT_CA、CERTIFICATE、PRIVATE_KEY：对应证书文件名
• DEVICE_NAME：保持 LS01

运行测试：

cd /home/pi/LightStrip/LightStrip-master/pi
sudo python3 lightstrip.py /dev/ttyACM0

成功连接后，在 AWS IoT 控制台的 LS01 > Shadow 页面编辑 Desired 状态：

{ "desired": { "animation": "101" } }

灯带应立即播放动画。再尝试设置颜色：

{ "desired": { "color": "0066CC" } }

第四阶段：AWS Lambda 函数创建

1. 在同一区域创建 Lambda 函数，名称 LightStrip，运行时 Python 3.6+。
2. 角色选择 "Create a custom role"，自动生成 lambda_basic_execution。
3. 记下右上角的 Lambda ARN。
4. 在代码编辑器中创建两个文件：

• lambda_function.py：从仓库 LightStrip/lambda/lambda_function.py 复制
• ala_controller.py：从仓库 LightStrip/lambda/ala_controller.py 复制

保存后，在 Configuration > Permissions 确保角色拥有 iot:UpdateThingShadow 权限。

第五阶段：Alexa 自定义技能配置

1. 进入 Alexa Developer Console，创建技能：

• 类型：Custom，语言：English (US)，名称：LightStrip，调用名：light strip

2. 在 Interaction Model > JSON Editor 粘贴仓库 LightStrip/alexaskill/lightstrip_skill.json 内容，保存并构建模型。
3. 在 Configuration 选择 AWS Lambda ARN，粘贴第 4 步记下的 ARN。

第六阶段：关联 Lambda 与 Alexa 技能

回到 Lambda 控制台，添加触发器 Alexa Skills Kit，应用 ID 填入技能 ID，保存。

支持的语音指令示例

• "Alexa, open Light Strip" — 打开技能，灯带亮蓝光欢迎
• "Turn on" / "Turn off" — 开关灯带
• "Set brightness to 50 percent" — 调节亮度
• "Set color to red" / "Set color to turquoise" — 设置颜色
• "Run an exciting animation" / "Run a relaxing animation" — 播放动画
• 多轮对话示例：

用户：Alexa, open Light Strip
Alexa：Welcome to LightStrip
用户：Launch an animation
Alexa：Do you want a relaxing or exciting animation?
用户：Relaxing
Alexa：OK（播放随机舒缓动画）
用户：Next animation
Alexa：OK（切换到下一个随机动画）

进阶优化建议

开机自启动

将 lightstrip.py 加入树莓派 /etc/rc.local 或创建 systemd 服务，实现上电自动运行。

自定义动画扩展

在 ala_controller.py 第 80 行左右定义了 20 种动画预设，可按需修改颜色调色板、速度、效果组合，或新增动画 ID 并在 Alexa 交互模型中添加对应语音槽位。

原理图与代码仓库

完整代码： GitHub - bportaluri/LightStrip

原理图： 参见项目附件中的 Fritzing 图，展示 Arduino 与灯带、电源连接细节。

故障排查提示

• 树莓派串口权限：sudo usermod -a -G dialout pi 后重启
• AWS 区域不一致：确保 IoT Core、Lambda、Alexa 技能全部在同一区域
• 证书路径错误：使用绝对路径或确保工作目录正确
• ALA 库安装：Arduino IDE 中通过库管理器搜索 "ALA" 安装