terafin/mqtt-alexa-bridge

mqtt-alexa-bridge 镜像文档

镜像概述

mqtt-alexa-bridge是一个用于桥接MQTT协议与Alexa智能家居技能的工具，旨在实现通过Alexa语音命令控制MQTT设备的功能。它作为中间件，接收来自Alexa的控制指令并转发至MQTT broker，同时支持设备状态反馈，适用于构建语音控制的智能家居系统。

核心功能与特性

• 协议桥接：实现Alexa智能家居技能与MQTT协议的双向通信
• 设备发现：支持Alexa设备发现功能，可自动识别配置的MQTT设备
• 灵活配置：通过环境变量自定义MQTT连接、配置路径及服务端口
• 安全支持：建议配合SSL加密保障通信安全，支持动态DNS与Let's Encrypt证书

使用场景

• 家庭智能家居系统，需通过Alexa语音控制基于MQTT协议的设备（如灯光、 thermostat等）
• 现有MQTT设备网络扩展Alexa语音控制能力
• 智能家居DIY项目，需要快速集成Alexa语音交互功能

使用方法与配置说明

环境变量配置

部署步骤

1. 配置Alexa智能家居技能

• 创建Alexa Smart Home技能，使用"Login with Amazon"进行账户关联
• 参考Alexa开发者文档完成技能基本配置

2. 安全设置（推荐）

• 配置动态DNS（如desec.io提供免费服务）
• 使用Let's Encrypt为域名生成SSL证书，确保Lambda适配器与Node-RED间通信加密

3. 部署Amazon Lambda适配器

在Amazon Lambda中部署以下Python适配器代码，将url替换为实际Node-RED端点：

python
"""
--------------------  REFERENCE MATERIALS  --------------------
Smart Home Skill API Reference:
https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/docs/smart-home-skill-api-reference
Python reference for url/http handling
https://docs.python.org/2/howto/urllib2.html
---------------------------------------------------------------
"""
import json
import urllib
import urllib2
import logging

logger = logging.getLogger()
logger.setLevel(logging.INFO)

# ============================================================================
#   Default Handler for all function requests
# ============================================================================
def lambda_handler(event, context):

    # Set the request URL to host:port.
    url = 'https://my_url/smarthome'  # 替换为实际Node-RED端点

    # Encode the request event data.
    data = json.dumps(event)

    # Perform the request with the event data.
    req = urllib2.Request(url, data)
    req.add_header('Content-Type' , 'application/json')


    # Create the response object.
    response = urllib2.urlopen(req)

    # Get the complete response page.
    the_page = str(response.read())

    # Load raw page data into JSON object.
    parsed_json = json.loads(the_page)

    # Log the event request, page response and json object.
    logger.info('**  Event Request  ** = {}'.format(event))
    logger.info('**  Page Response  ** = {}'.format(the_page))
    logger.info('**  Parsed JSON  ** = {}'.format(parsed_json))

    # Return value as a JSON object.
    return parsed_json

4. 网络配置

• 在防火墙设置端口转发，将外部请求转发至内部运行Node-RED的主机

5. Node-RED配置

• 导入提供的Node-RED流程
• 在"verify email"节点中修改为与Amazon账户关联的***地址

6. 设备发现与使用

• 在Alexa移动应用中，关联智能家居技能与Amazon账户
• 执行"发现设备"操作，应能发现测试设备（Test Light & Test Thermostat）
• 测试语音命令："Alexa, turn on test light"，可在Node-RED调试面板查看消息