零成本改造老旧DSC安防主机：用Arduino与路由器实现邮件报警

1. 项目概述

如果你家里有一套老旧的DSC安防报警主机，比如经典的PC1555MX，它可能还在兢兢业业地工作，但它的通知方式或许还停留在电话拨号时代。在这个万物互联的时代，我们总希望关键信息能第一时间推送到手机。今天分享的，就是一个几乎零成本的改造方案：用一块比拇指还小的Arduino Digispark（核心是ATTINY85微控制器）和一台早已退役的Linksys WRT54G路由器，让这台老古董报警主机学会“发邮件”。

这个项目的核心思路非常直接：DSC报警主机通过一个叫做Keybus的串行总线与键盘、扩展模块通信。我们利用Digispark这块超低成本的开发板，通过两个电阻分压，安全地“窃听”Keybus总线上的数据流，解析出具体的报警分区（Zone）和系统布防（Armed）状态。然后，Digispark通过串口将解析出的状态码（比如“15”表示1区和5区报警，“A16”表示系统布防状态下1区和6区报警）发送给旁边的WRT54G路由器。这台刷写了特殊定制版DD-WRT固件的路由器，则扮演了一个微型服务器的角色，它运行一个Shell脚本，持续监听串口数据，一旦发现状态变化，就调用邮件客户端（msmtp）向预设的邮箱发送报警邮件。

整个系统的硬件成本极低，主要依赖闲置或二手设备，软件层面则涉及嵌入式编程和Linux系统的基本操作。它不仅复活了旧设备，更重要的是提供了一种将传统、封闭的安防系统接入现代通知管道的可行思路。无论你是嵌入式爱好者、网络管理员，还是只是想给家里安防系统加点智能功能的DIY玩家，这个项目都能提供从硬件连接到软件调试的一手经验。

2. 系统架构与核心原理拆解

2.1 整体信号流与职责划分

要理解这个项目，首先得看清数据是怎么流动的。整个系统可以分为三个清晰的层级：信号采集层、协议解析层和网络通知层。

信号采集层的主角是DSC报警主机的Keybus。这不是一个标准的UART或I2C总线，而是一个由DSC定义的、基于时钟（CLK）和数据（DTA）线的同步串行协议。黄线通常是时钟（Clock），绿线是数据（Data）。主机通过这个总线以特定的帧格式，持续广播系统的各种状态，包括哪个防区被触发、系统是否处于布防状态等。我们的目标就是非侵入式地读取这两根线上的信号。

协议解析层的核心是Arduino Digispark。它的任务非常专一：实时捕捉Keybus上的时钟上升沿，并在每个时钟沿读取数据线上的电平（高为“1”，低为“0”），将这些比特流拼接成原始的二进制字符串。然后，它需要像一个翻译官一样，根据DSC的协议文档，从这一长串二进制位中，提取出对我们有用的“命令字”和“数据位”。例如，当解析到命令字0x27时，紧随其后的某些数据位就代表了8个基础防区的触发状态。Digispark解析成功后，会将结果编码成简单的ASCII字符串（如“15”或“A16”），通过其唯一的硬件串口发送出去。

网络通知层则由WRT54G路由器承担。刷入了DD-WRT后，它本质上变成了一台运行Linux的小型服务器。它通过串口（通常是/dev/tts/0）接收来自Digispark的ASCII字符串。运行在路由器上的Shell脚本是这个层级的“大脑”。它需要做几件事：第一，持续监听串口数据；第二，解析收到的字符串，区分是布防状态“A”还是防区编号“1-8”；第三，实现简单的状态去重和延时触发逻辑，避免因传感器抖动或持续触发导致邮件轰炸；第四，组装邮件正文（HTML格式），调用msmtp命令通过SMTP协议（例如Gmail的SMTP服务）将报警信息发送出去。

这三层通过串口线物理连接，通过自定义的简单文本协议进行通信，层层递进，最终将物理世界的报警事件转化为互联网上的电子邮件。

2.2 关键硬件选型与考量

为什么是Digispark和WRT54G？这背后是成本、功耗和功能性的综合权衡。

Arduino Digispark (ATTINY85)：选择它首要原因是尺寸和成本。ATTINY85是一款只有8个引脚的微控制器，Digispark开发板将其与USB编程接口集成，体积非常小巧。对于本项目，我们只需要用到它的两个数字输入引脚（监听Keybus）、一个串口输出引脚（连接路由器）以及中断功能。ATTINY85完全能满足需求。更关键的是，它的工作电压范围是2.7-5.5V，而WRT54G路由器恰好提供了一个3.3V的电源引脚，可以直接为其供电，无需额外的电压转换模块，简化了布线。虽然Digispark设计使用5V，但在3.3V下以8MHz频率运行ATTINY85是稳定可靠的，其电流消耗（约10mA）也远低于路由器GPIO口的驱动能力。

Linksys WRT54G V1-V3：这是一款具有传奇色彩的路由器，其开源特性催生了DD-WRT等第三方固件生态。选择它有几个不可替代的优势：1.硬件串口：WRT54G主板上有清晰的TX、RX、GND串口引脚，方便直接连接微控制器，这是大多数现代无线路由器所不具备的。2.可定制固件：DD-WRT提供了完整的Linux环境，我们可以自由安装软件包（如msmtp）、编写并后台运行脚本。3.低功耗与稳定性：作为网络设备设计，它能够7x24小时稳定运行。4.闲置利用：很多人家中都有吃灰的此型号路由器，零成本利用。需要注意的是，必须使用V1到V3版本，因为它们只有4MB Flash，后续版本缩水为2MB，无法运行功能完整的DD-WRT。我们使用的固件是一个“微版+”定制固件，在4MB空间内集成了SSH、串口支持和SMTP客户端等必要功能。

电平转换与信号隔离：这是硬件连接中最需要谨慎处理的部分。DSC Keybus的工作电压是12V，而Digispark的输入引脚只能承受5V。原始方案中使用两个10K电阻对12V信号进行分压，这是一种简单有效的办法，能将电压降至安全范围。但这里存在优化空间。更好的做法是使用光耦（如PC817）进行隔离。光耦的输入端接Keybus线路（同样需要串联限流电阻），输出端接Digispark的输入引脚。这样做的好处是实现了电气隔离，完全避免了高压串入损坏微控制器的风险，也消除了共地可能带来的干扰，系统的可靠性和安全性会高很多。如果报警主机价值不菲，强烈建议增加光耦隔离。

2.3 DSC Keybus协议浅析

理解协议是正确解析数据的前提。DSC的Keybus协议是一个主从结构的同步串行协议，报警主机是主机，不断向外广播信息。

每一帧数据都由主机发出的时钟信号同步。当时钟线（CLK）从低电平变为高电平（上升沿）时，从设备（如我们的Digispark）应该去读取数据线（DTA）上的电平。一系列时钟上升沿对应的数据位就组成了一帧数据。

根据社区逆向工程的结果，帧数据包含多个字节，有特定的结构。例如，命令字0x05通常与系统状态相关，如布防、撤防、故障等。在我们的代码中，我们特别关注该帧中的第15位（从0开始计数），如果这一位是1，就认为系统处于“Armed”（布防）状态，并发送字符‘A’。

命令字0x27则与防区状态相关。代码中从特定偏移量开始读取8个比特位，每一位对应一个防区（1-8）。如果某一位是1，则表示对应的防区被触发。Digispark会依次检查这8位，并发送对应的ASCII数字字符（‘1’到‘8’）。

这种解析方式高度依赖于特定的DSC主机型号和固件版本。原始作者使用的PC1555MX是经典的型号，对于其他DSC主机（如PC1616、PC1832等），Keybus协议帧结构可能略有不同，可能需要调整代码中的偏移量或命令字判断逻辑。在动手前，最好能在相关论坛搜索一下对应型号的协议信息。

3. 硬件准备与连接详解

3.1 物料清单与工具准备

在开始焊接和接线之前，请确保你手头有以下物品：

1. 核心设备：
   • DSC报警主机（如PC1555MX）一台，并确保其Keybus总线可访问（通常在主板上或键盘接口旁）。
   • Arduino Digispark（基于ATTINY85）开发板一块。
   • Linksys WRT54G路由器（必须是V1, V2或V3版本）一台。
2. 电子元件：
   • 10kΩ 电阻 2个（用于基础分压方案）。
   • （推荐）PC817光耦合器 2个，配套的220Ω限流电阻 2个，1kΩ上拉电阻 2个（用于更安全的光耦隔离方案）。
   • 杜邦线（母对母、公对母）若干。
   • 细导线、焊锡、万用表。
3. 工具与软件：
   • 电烙铁、焊台。
   • 螺丝刀（用于打开路由器外壳）。
   • 安装了Arduino IDE的电脑，并已添加Digispark开发板支持。
   • TFTP客户端软件（用于刷写路由器固件）。
   • 串口调试助手（可选，用于测试）。

3.2 WRT54G路由器改造与供电

首先处理路由器。WRT54G的串口引脚位于主板之上，通常标为JP1或JP2。你需要打开路由器外壳，找到这个4针或6针的接口。典型的引脚定义是：VCC（3.3V）， GND， TX， RX。注意：路由器的TX引脚要连接Digispark的RX（接收）引脚，路由器的RX连接Digispark的TX（发送）引脚。GND务必连接。

重要提示：在连接任何线路前，请用万用表确认引脚。找到可靠的GND点（如USB外壳或某个电容的负极），然后测量其他引脚对GND的电压。上电后，3.3V电源引脚对GND应为3.3V。TX引脚在空闲时也应为高电平（3.3V）。确认无误后再接线。

对于供电，我们计划从路由器的3.3V引脚取电给Digispark。计算一下：ATTINY85在8MHz下工作电流约5-10mA，两个光耦的输出侧电流约3-5mA每个，总计不超过20mA。WRT54G的3.3V线性稳压器通常能提供数百mA电流，因此负载完全在安全范围内。直接从路由器的3.3V引脚引出正极，连接到Digispark的VCC（或5V引脚，因为它内部有稳压），从GND引脚引出负极到Digispark的GND。

3.3 Digispark与Keybus的安全连接

这是整个硬件环节最关键的一步，连接错误可能损坏设备。

方案A：电阻分压法（原始方案）这是最简单的方法。取两个10kΩ电阻串联，连接在DSC Keybus的时钟线（黄线）和地之间。两个电阻的中间连接点，就是分压后的信号点，将其连接到Digispark的PIN2（对应中断0）。对数据线（绿线）进行同样的操作，分压后连接到Digispark的PIN1。Digispark的GND需要连接到DSC报警主机的GND（通常在Keybus接口附近能找到）。

计算一下：12V输入，经过两个10k电阻，中间点电压 = 12V * (R2 / (R1+R2)) = 12V * (10k / 20k) = 6V。这个电压对于5V系统来说仍然偏高，但对于3.3V系统（Digispark此时由3.3V供电，其输入高电平阈值约为2.6V）来说，6V是危险的，可能超过其绝对最大额定值。实际上，由于Keybus信号不是稳定的12V直流，而是脉冲信号，且微控制器内部有钳位二极管，短时间内或许能工作，但长期看有风险。因此，不推荐长期使用此方案。

方案B：光耦隔离法（推荐方案）这是更专业和安全的做法。以时钟线连接为例：

1. 从DSC Keybus时钟线（黄线）串联一个220Ω的限流电阻，连接到光耦PC817的输入端（阳极，引脚1）。
2. Keybus的地线连接到光耦输入端的阴极（引脚2）。
3. 光耦的输出端集电极（引脚4）连接Digispark的PIN2，并通过一个1kΩ的上拉电阻连接到Digispark的VCC（3.3V）。
4. 光耦的输出端发射极（引脚3）连接到Digispark的GND。

数据线（绿线）依照同样方式连接至Digispark的PIN1。 这样，当Keybus时钟线为高电平时，光耦输入端导通，输出端三极管饱和，PIN2被拉低至接近GND（低电平）。当Keybus时钟线为低电平时，光耦截止，输出端三极管断开，PIN2被1kΩ上拉电阻拉至高电平（3.3V）。这样就实现了12V信号到3.3V信号的隔离转换，且信号是反相的。在软件中，我们需要通过中断触发方式（如RISING或FALLING）来适配这种反相。如果使用光耦，代码中的中断触发边沿可能需要从RISING改为FALLING，因为物理上的上升沿（光耦导通）在Digispark引脚上看到的是下降沿。

注意：在焊接和接线时，务必断开所有设备的电源。先连接好Digispark与路由器之间的串口线和电源线，再谨慎连接Keybus部分。建议先不接Keybus，用Arduino IDE的串口监视器测试Digispark与路由器之间的通信是否正常，然后再接入Keybus进行测试。

4. 软件环境配置与固件刷写

4.1 定制DD-WRT固件刷写指南

WRT54G的官方固件无法运行我们的脚本，因此必须刷入定制的DD-WRT固件。这个过程需要耐心，因为刷机时机很关键。

1. 准备工作：

   • 用网线将电脑的以太网口与WRT54G的任意一个LAN口（1-4）连接。
   • 关闭电脑的Wi-Fi，确保有线网络是唯一活动连接。
   • 将电脑的IPv4地址手动设置为192.168.1.2，子网掩码255.255.255.0，网关留空。
   • 下载提供的定制固件文件：dd-wrt.v24-18946_NEWD_micro-plus_ssh_serial_openSSL_smtp.bin。
   • 在电脑上安装并运行一个TFTP客户端（如Tftpd64）。

2. 刷机过程：

   • 打开TFTP客户端，将服务器地址设置为192.168.1.1，选择下载的固件.bin文件。
   • 按住WRT54G路由器背面的Reset按钮不放，然后给路由器通电。
   • 持续按住Reset按钮约30秒，直到路由器前面板的DMZ或DIAG指示灯开始快速闪烁（而不是正常的慢闪）。此时松开Reset按钮。这个状态表明路由器进入了TFTP恢复模式。
   • 关键步骤：在TFTP客户端中，点击“上传”或“Put”按钮。如果时机正确，你会看到传输进度条。传输完成后，路由器会自动重启，这个过程可能需要2-3分钟。如果传输失败（超时），你需要重复断电、按住Reset、通电、等待指示灯快闪、点击上传这个过程。可能需要多次尝试才能抓住正确的时机。

3. 刷机后设置：

   • 路由器重启后，将电脑的IP改回自动获取（DHCP）。
   • 在浏览器中打开http://192.168.1.1，使用用户名root，密码admin登录DD-WRT管理界面。
   • 网络设置：为避免IP冲突，建议将WRT54G设置为与主路由不同的网段。例如，主路由是192.168.0.1，则将WRT54G的LAN口IP设为192.168.1.1，关闭其DHCP服务器。然后用网线将WRT54G的LAN口连接到主路由的LAN口。这样，WRT54G就相当于一个有线客户端/交换机，同时拥有自己的管理IP。
   • 基本设置：在“Setup”->“Basic Setup”中，确保路由器时间、时区设置正确，这对邮件时间戳很重要。

4.2 Digispark开发环境与程序上传

Digispark使用ATTINY85芯片，需要在Arduino IDE中进行额外配置。

1. 安装开发板支持：

   • 打开Arduino IDE，进入“文件”->“首选项”，在“附加开发板管理器网址”中添加：https://digistump.com/package_digistump_index.json
   • 然后进入“工具”->“开发板”->“开发板管理器”，搜索“Digistump AVR Boards”，找到后安装。
   • 安装完成后，在“工具”->“开发板”中选择“Digispark (Default - 16.5mhz)”。

2. 修改配置以适应我们的硬件：

   • 由于我们使用3.3V供电且不需要USB模拟串口（我们使用硬件串口），需要对开发板配置进行修改。找到Arduino IDE安装目录下的硬件包。路径可能类似：C:\Users\[用户名]\AppData\Local\Arduino15\packages\digistump\hardware\avr\1.6.7。
   • 进入该目录下的variants文件夹，找到digispark文件夹，编辑其中的pins_arduino.h文件。
   • 找到关于时钟频率的定义，为了在3.3V下稳定运行，我们需要将系统时钟设为8MHz。找到类似#define CLOCKSPEED 16500000L的行，将其修改为#define CLOCKSPEED 8000000L。同时，确保PLLTIMER等相关配置是针对8MHz的。
   • 重要：修改前请备份原文件。不同版本的硬件包可能文件结构略有不同，核心是找到时钟频率的定义处。

3. 编译与上传代码：

   • 将提供的DSC_READ4_simplified.ino代码复制到Arduino IDE中。
   • 在“工具”菜单中，选择正确的开发板、处理器（ATTiny85）和时钟（8 MHz internal）。
   • 最关键的一步：在“工具”->“编程器”中，选择“USBtinyISP”。
   • 点击“上传”按钮。此时IDE会编译代码，并在底部状态栏显示“Plug in device now...”（正在插入设备）的提示。
   • 只有在这个时候，才将Digispark通过USB线插入电脑。IDE会自动检测并开始上传程序。上传成功后，状态栏会显示“Done uploading”。

实操心得：Digispark的上传方式比较特殊，需要先点击上传再插入设备，新手容易搞错顺序导致上传失败。如果失败，多试几次，确保在提示插入设备时再插入。另外，修改系统时钟为8MHz是必须的，否则在3.3V电压下以16.5MHz运行可能导致程序执行不稳定。

4.3 Shell脚本部署与邮件服务配置

脚本将在WRT54G上运行，我们需要通过SSH登录路由器进行操作。

1. SSH登录与基础配置：

   • 确保电脑和WRT54G在同一网络（或已按前述方式连接）。
   • 使用SSH客户端（如PuTTY），连接192.168.1.1，端口22，用户名root，密码admin。
   • 登录后，首先更新软件包列表并安装必要的工具（如果固件未预装）：

     ipkg update ipkg install msmtp

   msmtp是一个轻量级SMTP客户端，用于发送邮件。

2. 配置msmtp：

   • 创建或编辑msmtp的配置文件。这里我们采用命令行参数传递密码的简单方式（安全性稍差，适合家庭内网环境）。更安全的方式是使用msmtp的passwordeval配合加密文件，但配置更复杂。我们使用作者提供的命令行方式。
   • 你需要准备好一个Gmail邮箱，并开启“两步验证”。然后生成一个“应用专用密码”。这个密码不是你的Gmail登录密码，而是专门给msmtp这类应用使用的。
   • 在Shell脚本中，发送邮件的命令如下（你需要替换其中的用户名和专用密码）：

     msmtp --host=smtp.gmail.com --port=587 --protocol=smtp --auth=on --user=yourname@gmail.com --passwordeval='echo YourAppSpecificPassword' --tls=on --tls-starttls --tls-certcheck=off --from=yourname@gmail.com recipient@gmail.com

3. 部署监控脚本：

   • 使用vi或nano编辑器，在路由器的/tmp目录（重启会丢失）或/jffs目录（如果支持持久存储）下创建脚本文件，例如alarm_monitor.sh。
   • 将项目正文中提供的完整Shell脚本复制进去。务必仔细修改脚本中的以下部分：
     • 所有出现的username@gmail.com和yourpasswordhere，替换为你的Gmail地址和应用专用密码。
     • 脚本中zone1到zone6对应的报警描述（如'Alarm 1: Front Door/Side Door<br>'），根据你实际的防区布置进行修改。
     • 脚本开头的delay=60变量，定义了状态持续多少秒后才发送邮件（用于防抖）。测试时可以设为60（1分钟），正式使用可以设为900（15分钟）或更长。
   • 给脚本添加执行权限：chmod +x /jffs/alarm_monitor.sh

4. 设置开机自启动：

   • 我们需要让脚本在路由器启动后自动运行。DD-WRT提供了rc_custom这个用户自定义启动脚本。
   • 在DD-WRT管理界面，进入“Administration”->“Commands”选项卡。
   • 在“Commands”文本框中，输入以下内容（假设脚本放在/jffs）：

     sleep 30 /jffs/alarm_monitor.sh &

   sleep 30是等待路由器网络等服务完全启动。&符号让脚本在后台运行。

   • 点击“Save Startup”按钮。这样，每次路由器重启后，监控脚本就会自动运行。

5. 系统调试与问题排查实录

5.1 分阶段调试策略

不要试图一次性连接所有设备并期望它工作。分阶段调试是成功的关键。

第一阶段：Digispark独立测试。上传完代码后，先不连接路由器。将Digispark通过USB连接到电脑，打开Arduino IDE的串口监视器（注意：Digispark的USB转串口和硬件串口是分开的，此测试仅验证程序是否运行，不涉及与路由器的通信）。你可能会看到“Ready!”的输出。然后，用金属镊子短暂触碰连接Keybus时钟线的引脚（PIN2）和GND，模拟一个脉冲信号。观察串口监视器是否有乱码或字符输出。这可以初步验证Digispark的中断响应和程序逻辑是否正常。

第二阶段：路由器串口测试。断开Digispark与Keybus的连接，只连接Digispark与WRT54G的串口线（TX-RX交叉，GND相连，并供上3.3V）。通过SSH登录路由器。首先检查串口设备是否存在：ls -la /dev/tts*。通常会是/dev/tts/0。然后，我们可以用cat命令监听串口：cat /dev/tts/0。此时，手动将Digispark的TX引脚（PIN0）短暂接地再放开，模拟发送一个字节。在路由器的SSH窗口里，你应该能看到一个乱码字符（因为手动接地产生的是不符合串口协议的信号）。这证明物理连接和路由器端的串口读取基本正常。按Ctrl+C终止cat命令。

第三阶段：Keybus信号监听与解析测试。这是最核心的调试。将Digispark正确连接到Keybus（建议先使用万用表测量Keybus上的电压，确认黄线、绿线和GND）。给DSC主机和整个系统上电。在路由器SSH中再次运行cat /dev/tts/0。然后，触发DSC报警主机上的一个已知防区（比如打开一个门窗传感器）。你应该能看到串口输出对应的数字，例如触发1区就输出“1”。如果系统布防后触发，可能会输出“A1”。如果没有任何输出，问题可能出在：

1. 电平不匹配：Keybus的12V信号没有成功被Digispark识别。用万用表测量连接到Digispark输入引脚的实际电压，在Keybus空闲和活动时分别测量。
2. 中断引脚错误：确认代码中attachInterrupt(0, ...)对应的是Digispark的PIN2（Arduino引脚编号2）。
3. 协议不匹配：你的DSC主机可能使用不同的命令字。需要更深入地分析Keybus数据流。一个高级的调试方法是，修改Digispark代码，让它将原始的二进制字符串通过串口打印出来，然后在电脑上捕获并分析，与已知的DSC协议进行比对。

5.2 常见问题与解决方案速查表

以下是我在实现过程中遇到的一些典型问题及解决方法：

5.3 安全性强化与进阶优化建议

原始方案在家庭内网环境下可行，但从安全性和健壮性角度，还有很大提升空间。

1. 密码安全：在脚本中明文存储邮箱密码是最大的安全隐患。如果路由器暴露在公网（极其不推荐），风险极高。即使在局域网，也应改进。可以创建一个只读的密码文件，并使用gpg加密，在脚本中用passwordeval='gpg --decrypt /jffs/password.gpg'来调用。更进阶的做法是使用OAuth 2.0认证，但这在嵌入式环境配置非常复杂。

2. 通知渠道多样化：邮件通知可能有延迟。可以集成其他即时性更高的通知方式：

   • Telegram Bot：在脚本中调用curl命令，通过Telegram Bot API发送消息到手机，几乎实时。
   • Pushover：一个统一的推送服务，提供API，可以发送推送通知到iOS/Android设备。
   • Webhook：将报警事件通过HTTP POST请求发送到你自己的服务器，服务器可以触发更复杂的逻辑，如打电话、记录数据库等。

3. 状态持久化与可视化：目前脚本状态存储在内存变量中，路由器重启会丢失。可以将防区触发历史记录到路由器的/jffs目录下的一个文件，或者更理想的是，发送到一个简单的数据库（如SQLite）或时间序列数据库（如InfluxDB），然后配合Grafana做一个简单的报警历史仪表盘。

4. 协议解析的健壮性：当前的解析代码相对简单，没有考虑帧校验、错误恢复等。在实际环境中，Keybus总线可能有干扰。可以增加校验和验证，对错误帧进行丢弃，并加入看门狗机制，在Digispark长时间无响应时自动重启。

这个项目最大的价值在于它提供了一个清晰的框架和思路。你可以根据自己的需求，替换其中的任何一个组件。比如，用ESP8266代替Digispark和WRT54G，直接通过Wi-Fi发送HTTP请求；或者用树莓派Zero W作为中心，获得更强的处理能力和更丰富的软件生态。核心思想不变：监听传统设备的信号，将其转化为数字世界可理解的事件，从而实现智能化和远程化。