Skip to content

flygoly/hipi

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

31 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

HiPi

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 并启动守护进程。

快速重装(不需拔插 USB)

./scripts/quick-reinstall.sh

开发安装

sudo 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

手动 deb 包

./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

CLI 速查

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

About

A desktop application for Ubuntu desktop ARM64) to manage 4G SMS and voice calls via Quectel EC801E-CN modules.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors