01
双向通话
- SIP 来电触发对固定手机号的呼叫。
- 手机来电触发对指定 SIP URI 的呼叫。
- 一次桥接一通电话；任一侧挂断后联动结束另一侧并释放媒体资源。
- PCMA / PCMU 可在接通后播报文件；TTS 需要配套固件能力。
Engineering overview / 语音桥接开发
SIP 与蜂窝语音的连接点
一页了解 Air8783H 的功能边界、双向通话路径与开发接入要点。
01 / CAPABILITIES
先明确设备与后台的职责
Air8783H 提供语音桥接通路；管理与统计能力需要 SIP 后台及业务系统配合。
Air8783H / 设备侧
SIP ↔ 内部 PCM ↔ CC / VoLTE
将 SIP 网络通话与 SIM 卡蜂窝语音双向桥接。音频在模组内部通过 PCM 传递，无需外接音频 Codec，也无需本地麦克风、喇叭或音频回环线；双方使用 SIP 通话端与手机收听、讲话。
SIP 后台 / 业务系统
管理、调度、统计与业务联动
账号权限、业务分组、通话报表、呼叫调度和工单联动由后台提供。录音回溯等能力取决于后台选配，不应视为 Air8783H 硬件自带功能。
02
音频与协议
- VoIP 编解码与内部 PCM 桥接由配套固件实现。
- PCM 为 16 位有符号小端、单声道。
ptime固定为 20 ms。- TLS 保护 SIP 信令；媒体加密还需 SRTP 能力与相应配置。
03
开发接入
- 使用 LuatOS / Lua 和 Luatools。
- 准备对应硬件固件、项目脚本与公共库。
- 配置 SIP 服务、账号、固定手机号和目标 SIP URI。
- Lua 脚本不能替代固件缺失的 CC / VoIP PCM 桥接能力。
04
联调检查
- 先确认
IP_READY和 SIP 注册成功，再检查 PCM 就绪。 - 结合 RTP 收发和
cc.bridgePcmStats()排查音频。 - 听到播报后仍需验证双方讲话。
- Wi-Fi 驱动存在，不代表现有硬件默认支持 Wi-Fi。
接入前提：USB 5 V / ≥1 A；SIM 已开通语音和 VoLTE，能正常呼入呼出。使用 4G 承载 SIP 时，还需要可用的数据业务。供电要求引用官方功能配图，具体硬件接线以对应资料为准。
02 / CALL PATH
切换方向，理解一次桥接如何建立
以下是流程说明。点击步骤查看该阶段的条件与日志关注点。
由来电触发；程序启动后不会立即自动拨号。
默认 PCMA / PCMU 场景中，接通后的延时与播报期间会暂时静音原桥接语音；播报结束、桥接恢复后再验证双向讲话。旧通话清理完成后才能建立下一通桥接。
03 / IMPLEMENTATION NOTES
开发速查
保留影响接入与验证的关键差异，具体实现以官方当前 Demo 为准。
编解码与 PCM 参数
| CODEC | SIP 媒体侧 PCM | 当前 Demo 接通播报 |
|---|---|---|
| PCMA · 默认 | 8 kHz | MP3 / 按配置使用 TTS |
| PCMU | 8 kHz | MP3 / 按配置使用 TTS |
| G729 | 8 kHz | 跳过播报 |
| G722 | 16 kHz | 跳过播报 |
所有行均使用 ptime = 20。G722 的 SDP 标识 G722/8000 指 RTP 时钟，媒体 PCM 仍为 16 kHz。编解码器需要固件、SIP 服务和客户端共同支持。
开发准备顺序
- 确认硬件与配套固件固件须包含 CC 纯 PCM、VoIP PCM 桥接、选定 codec，以及需要的播报能力。
- 加入项目脚本与公共库包含 Demo 的 10 个 Lua 文件，以及
exsipclient.lua、exsipproto.lua；按功能加入音频与证书资源。 - 配置账号、目标与网卡修改
sip_cc/config.lua；默认 4G 对应socket.LWIP_GP，网卡与适配器需一致。 - 烧录并按日志验证使用 Luatools；从网络、注册、媒体就绪到双向讲话逐层确认。
注册成功却没有声音，先查哪里？
SIP 注册只说明信令环节已完成。继续检查协商出的 RTP 地址与端口是否双向可达、RTP 收发计数是否增长、CC PCM 通道是否就绪，以及接通播报是否已经结束。听到文件播报不能替代双方讲话测试。
Wi-Fi 能直接作为 Air8783H 的标配能力使用吗？
不能仅凭 Demo 包含 Wi-Fi STA 驱动就认定硬件支持。切换前需确认目标硬件与固件具备该功能，并配套修改网络驱动与 adapter。Wi-Fi 只改变 SIP 的联网方式，蜂窝通话仍需 SIM 卡和 VoLTE。
配置 TLS 后，语音是否也已经加密？
当 media_encryption = "none" 时，TLS 只保护 SIP 信令。媒体加密需要固件与服务端共同具备对应 SRTP 能力。TLS 还需正确的 CA 证书、匹配的服务器域名与可信网络时间。
能否只换 Lua 脚本，或者套用其他型号固件？
不能用 Lua 配置补齐固件缺失的底层 PCM 或 VoIP 能力。官方当前页面未指定一个可直接套用的最低固件版本，应按对应硬件及所需功能确认配套固件。脚本注释出现其他型号名称，不等于允许混用其固件。
04 / OFFICIAL RESOURCES
继续开发，从官方资料开始
Air8783H 官方文档功能说明、硬件参考与 SIP-CC 纯 PCM Demo 文档docs.openluat.com/air8783h/SIP-CC 桥接 Demo 仓库项目入口、网络驱动、呼叫协调与配置文件module/Air8783H/project/sip_cc_bridge_pcm
本 HTML 已内嵌功能图、样式与交互脚本，直接打开即可浏览；访问官方资料链接需要联网。图为功能示意，不能作为尺寸、引脚或电气原理图使用。