ARM Ubuntu Desktop 上的 4G 短信与通话桌面应用,优先支持 Quectel EC801E-CN USB 一体化模组。
git clone https://github.com/flygoly/hipi.git
cd hipi
sudo ./scripts/hipi-setup.sh # 一键环境配置 + USB 绑定
# 注销重登(使 dialout 组生效)后
hipi ui完整 0→1 教程(刷机、插卡、安装、验短信/语音):docs/getting-started.md
- 短信收发(会话列表、搜索、桌面通知、中文解码)
- 语音通话(拨号盘、来电接听、通话记录)
- 联系人簿(vCard 导入导出)
- 短信转发(号码 + Webhook HMAC 验签)
- 模组状态(信号、运营商、托盘 / GNOME 顶栏扩展)
- 首次运行向导、CSV 导出
| 项目 | 要求 |
|---|---|
| 架构 | ARM64(如 Orange Pi、树莓派、VMware Fusion ARM 虚拟机) |
| 系统 | Ubuntu 24.04 Desktop(GNOME) |
| 模组 | Quectel EC801E-CN + 含语音/短信的 SIM(ECM/RNDIS/AT 自动适配) |
| 服务 | ModemManager、PipeWire |
sudo ./scripts/hipi-setup.sh脚本自动完成:启用 ModemManager debug 模式、安装 udev 规则、释放 AT 端口、绑定 option 驱动、安装 HiPi 并启动守护进程。
./scripts/quick-reinstall.shsudo apt install python3-pip python3-gi python3-dbus modemmanager network-manager \
pipewire pipewire-pulse libqmi-utils gir1.2-glib-2.0
pip install -e ".[dev]"
systemctl --user enable --now hipi-daemon
hipi ui./packaging/debian/build-deb.sh 0.1.0
sudo dpkg -i build/debian/hipi_0.1.0_arm64.deb安装后 postinst 会自动启用 hipi-daemon、GNOME 扩展,并配置 loginctl enable-linger。
hipi ping # 检查守护进程
hipi status # 模组状态
hipi unlock <PIN> # 解锁 SIM
hipi send-sms <号> "内容" # 发短信
hipi list-conversations # 会话列表
hipi dial <号> # 拨打电话
hipi hangup # 挂断
hipi sync # 同步模组短信
hipi setup-audio # 配置通话音频
hipi list-calls # 通话记录
hipi list-contacts # 联系人hipi ping && hipi status
./scripts/device-verify.sh
./scripts/modem-probe.sh
journalctl --user -u hipi-daemon -f| 文档 | 内容 |
|---|---|
| getting-started.md | 从零到一完整指南 |
| hardware.md | 硬件连接与供电 |
| device-checklist.md | 真机验收清单 |
| troubleshooting.md | 故障排除 |
| webhook.md | Webhook 转发与验签 |
| ec801e-one-shot.md | 验收快速索引 |
hipi ui (PySide6) ←RPC→ hipi-daemon ←D-Bus→ ModemManager ←USB→ EC801E
↓
SQLite
Apache License 2.0 — 见 LICENSE