Skip to content

chenxuuu/sms_forwarding

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

39 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

低成本短信转发器

当前分支为新方案,老方案请前往luatos分支
本项目仅用于接收短信与进行保号相关功能。
多卡控制、通话、拨号、开放接口、自动化等功能永远不会支持,请勿提出相关需求。

后台页面演示

本项目旨在使用低成本的硬件设备,实现短信的自动转发功能,支持多种推送方式同时启用。

视频教程:B站视频

功能

  • 支持使用通用AT指令与模块进行通信
  • 开启后支持通过WEB界面配置短信转发参数、查询当前状态
  • 支持多达5个推送通道同时启用,每个通道可独立配置
  • 支持将收到的短信转发到指定的邮箱
  • 支持通过WEB界面主动发送短信,以便消耗余额
  • 支持通过WEB界面进行Ping测试,以极低的成本消耗余额
  • 支持长短信自动合并(30秒超时)
  • 支持管理员短信远程发送短信和重启设备

推送通道支持

支持以下7种推送方式,可同时启用多个通道:

推送方式 说明 需要配置
POST JSON 通用HTTP POST URL
Bark iOS推送服务 Bark服务器URL
GET请求 URL参数方式 URL
钉钉机器人 企业群通知 Webhook URL,可选Secret加签
PushPlus 微信公众号推送 Token
Server酱 微信推送服务 SendKey
自定义模板 灵活的JSON模板 URL + 请求体模板
飞书机器人 自定义通知 Webhook URL

推送格式说明

  • POST JSON: {"sender":"发送者号码","message":"短信内容","timestamp":"时间戳"}
  • Bark: {"title":"发送者号码","body":"短信内容"}
  • GET请求: URL?sender=xxx&message=xxx&timestamp=xxx(自动URL编码)
  • 钉钉机器人: 文本消息格式,支持加签验证
  • PushPlus: 使用Token推送,支持HTML格式
  • Server酱: 使用SendKey推送,支持Markdown格式
  • 自定义模板: 使用{sender}{message}{timestamp}占位符
  • 飞书机器人: 文本消息格式,支持加签验证
状态信息 主动ping

硬件搭配

如果希望自行焊接硬件,参考下面的硬件搭配,总成本约¥27.8,仅支持移动/联通卡。

若希望直接使用成品,可选直接购以下套件,支持移动/联通/电信卡:

硬件连接

ESP32C3 与 ML307R-DC 通过串口(UART)连接,接线如下:

┌───────────────────────────────────────────────┐
|                                               |
|   ESP32C3 Super Mini      ML307R-DC核心板     |
| ┌───────────────────┐    ┌─────────────────┐ |
└─┼─ GPIO5 (MODEM_EN) │    │                 │ |
  │       GPIO3 (TX) ─┼───►│ RX              │ |
  │                   │    │             EN ─┼─┘
  │       GPIO4 (RX) ◄┼────┤ TX              │ 
  │                   │    │                 │ 
  │              GND ─┼────┤ GND             │ 
  │                   │    │                 │ 
  │               5V ─┼────┤ VCC (5V)        |
  │                   │    │                 │
  └───────────────────┘    └─────────────────┘
                           │                 │
                           │  SIM卡槽        │
                           │  (插入Nano SIM) │
                           │                 │
                           │  天线接口       │
                           │  (连接4G天线)   │
                           └─────────────────┘

改变接线方式,核心板不再和en短接而是和esp32c3的GPIO5连接,使模块能够被控制上下电(代码也同步改动)。 可通过USB连接ESP32C3进行编程和供电,正常工作时,ESP32C3的虚拟串口数据将直接被转发到ML307R-DC,方便调试。

软件组成

  • ESP32C3运行自己的Arduino固件,负责连接WiFi和接收ML307R-DC发送过来的短信数据,然后转发到指定HTTP接口或邮箱
  • ML307R-DC运行默认的AT固件,不用动

需要在Arduino IDE中单独安装这些库:

  • ReadyMail by Mobizt
  • pdulib by David Henry

需要在Arduino IDE中安装ESP32开发板支持,参考官方文档,版型选MakerGO ESP32 C3 SuperMini

About

超低成本硬件短信转发器:ML307R+ESP32C3 支持移动联通电信

Resources

License

Stars

Watchers

Forks