Air8783W SIP-CC 开发指南
Air8783W 是基于 Air8000W 的 USB 形态语音网关板,用来把 SIP 客户端的网络通话与板载 SIM 的蜂窝语音通话双向桥接。它沿用 Air8783H 的产品定位,增加了 Wi‑Fi 作为 SIP 信令与 RTP 媒体的网络出口。即使 SIP 走 Wi‑Fi,手机号一侧仍由板载 SIM 通过 4G VoLTE 建立。首次联调建议先跑通 4G,再切换到 Wi‑Fi 并重复双向测试。 Air8000 产品资料 · Air8783H 双向桥接参考
软件步骤以 Air8783H 官方纯 PCM 示例为移植基线。烧录前请确认 Air8000W 内核和脚本已适配 Air8783W。 Air8783H 纯 PCM 示例 · Air8000 固件与 Demo
需要按目录跳转章节或复制配置示例时,可以在新标签页打开 HTML 图文版。
认识 Air8783W
正反面实物图均以 USB 插头朝上,点击图片可查看大图。以 PCB 边缘的 Air8783W 丝印识别板卡,正面中央为 Air8000W 模组。
正面接口和天线
背面卡座和调试点
接口和器件
| 功能 | 位号与位置 | 开发时怎么用 |
|---|---|---|
| USB 与供电 | USB‑A 插头 J101,板顶;背面 U210、L200 降压 | 使用具备稳定 5 V 供电与数据连接的 USB 口。J101 的 1~4 脚依次为 VBUS、D−、D+、GND;原理图给出的板内 VBAT 标称约 3.89 V。 |
| 蜂窝语音 | J3,背面中部左侧 | 断电插入支持来电、外呼及 VoLTE 的测试 SIM。先确认入网与语音就绪,再联调 SIP‑CC。 |
| 下载模式 | KEY6,正面右上 | 对应 BOOT/USB_BOOT。按键服务于下载调试,具体进入下载模式的时序按板级固件和 Luatools 流程执行。 |
| 指示灯 | LED240、LED2,正面左上 | 以 USB 朝上看,左侧 LED240 由 GPIO26/NET_STATUS 驱动,右侧 LED2 接 VBAT 供电指示。SIP 注册与通话状态以日志为准。 |
| 4G 和 Wi‑Fi 射频 | U2 在正面下方,J461 在正面右边缘 | U2 对应 LTE 天线组件;J461 对应 Wi‑Fi 陶瓷天线。设计外壳或固定件时保留天线区域,并在装壳后测试两条链路。 |
| 外置看门狗 | U221,背面 | GPIO27/WG 接入看门狗链路,输出经电路连接 RESET_N。迁移示例时保留 GPIO26 与 GPIO27 的板级用途,并随固件验证馈狗行为。 |
| 通话音频 | Air8000W 内部 PCM | 桥接在模组内部传递双向 PCM,讲话和收听分别在 SIP 客户端与手机上完成。 |
调试测试点
| 测试点 | 原理图网络 | 用途 |
|---|---|---|
| T7 / T4 / T12 | VBUS / VBAT / GND | 排查 USB 供电和板内降压,观察 4G 发射或通话启动时的供电跌落。 |
| T1 / T2 / T3 | DBG_RXD / DBG_TXD / GND | 背面卡座下方的调试口。接入串口工具前核对 IO 电平、共地及收发方向。 |
| T9 / T10 / T11 | USB_DM / USB_DP / GND | J101 周边的 USB 数据链路测试点。 |
| T5 / T6 | BOOT / VDD_EXT | BOOT 电路测试点。 |
核对测试点对应的网络和电路连接时,可查看 Air8783W 原理图。
理解 SIP-CC 的两条通路
读架构图时,沿上方的 SIP 信令线看呼叫控制,沿下方的媒体线看语音怎样从 RTP 经板内 PCM 接到 VoLTE。右侧实物照片标出了蜂窝语音使用的 USIM 卡座。
| 通路 | 处理什么 | Air8783W 上的实现 |
|---|---|---|
| SIP 信令 | REGISTER 注册,INVITE 建立对话,SDP 协商媒体,BYE 结束通话 |
示例中的 SIP 客户端连接 PBX 或 SIP 服务,使用选定的 4G 数据网卡或 Wi‑Fi STA。 |
| RTP 媒体 | 收发 SIP 对端的语音 | voip 按 SDP 的地址、端口、编解码参数收发 RTP,与桥接应用交换 PCM。 |
| 蜂窝 CC | 经 SIM 拨号、接听、来电和挂断 | cc 在运营商 VoLTE 通道执行呼叫,纯 PCM 桥接后端提供蜂窝语音的上下行。 |
SIP 服务器负责注册与路由。它是否转发 RTP 取决于 PBX、SBC 和 NAT 配置。无论 RTP 是由服务端锚定,还是与对端直接交互,设备都应使用本次 SDP 协商出的媒体参数。 SIP 与 SDP 说明 · VoIP 媒体 API · CC 通话 API
双向呼叫时序
下图并排比较两种呼入方向。联调时先找到来电的那一侧,再按箭头核对另一侧何时应答,以及板卡何时开始转接语音。
SIP 呼入转手机。 SIP 客户端呼叫板卡账号。参考示例先发带 SDP 的 183,确认 VoIP 就绪后拨打配置中的固定手机号。手机接通且 CC 的 PCM 通道就绪后,板卡正式应答 SIP,双方开始通话。 Air8783H 示例呼叫流程
手机呼入转 SIP。 手机拨打板载 SIM 号码。板卡通过 SIP 呼叫配置中的 remote_sip_uri,待 SIP 对端接听并建立媒体后接听蜂窝来电。参考示例按单通会话使用,任一侧挂断时清理两边呼叫与媒体。项目需要分组路由或多通并发时,应单独验证号码映射、资源回收及实际并发能力。 Air8783H 示例呼叫流程
跑通第一通桥接电话
准备固件和测试环境
- 准备 Air8783W、可下载和抓日志的 USB 连接、支持 VoLTE 的 SIM、可互通的 SIP 服务器和 SIP 客户端,以及一部用于收发测试电话的手机。服务器至少准备板卡注册账号和 SIP 客户端账号,可用自建 FreeSWITCH 等 PBX 联调。验证时使用可控的测试号码和独立账号。 Air8783H 示例准备 · FreeSWITCH 对接 FAQ
- 选择匹配 Air8000W 并经 Air8783W 板级确认的 LuatOS 内核。Air8000 固件记录曾明确列出
13/113/22/122的 CC/SIP 纯 PCM 后端,可用于核对编译功能。内核、分支号、脚本版本与 Wi‑Fi 配套固件须一起记录。Air8783H 和 Air8784 的出厂固件分别针对自身硬件,迁移时复用其流程和脚本设计。 Air8000 固件记录 · Air8783H 出厂固件 - 从 Air8783H 官方页打开
sip_cc_bridge_pcm示例,在 Luatools 建立项目。加入main.lua、netdrv/下 3 个 Lua 文件、sip_cc/下 6 个 Lua 文件,再加入exsipclient.lua和exsipproto.lua。启用 Wi‑Fi 时补入exnetif.lua、dnsproxy.lua、dhcpsrv.lua、httpdns.lua、udpsrv.lua。保持示例模块目录与require的解析关系。 示例及烧录清单 - 如果沿用示例的接通播报,将
Time_travel_8k.mp3随脚本烧录,核对板端路径/luadb/Time_travel_8k.mp3。如果 SIP 使用 TLS,按服务器证书链加入 CA 并在注册前完成时间同步。 示例资源与 TLS
上板后可先在 main.lua 中临时记录这些能力,再由示例完成实际初始化。若常量或函数缺失,优先更换或核对内核编译配置。接口存在表示可以进入下一步联调,最终仍以初始化和双向通话结果为准。 CC API · VoIP API
local cc_pcm = cc and cc.AUDIO_MODE_BRIDGE_PCM ~= nil
and type(cc.bridgePcmStats) == "function"
and type(cc.bridgeAudioStop) == "function"
local sip_pcm = voip and voip.AUDIO_MODE_BRIDGE ~= nil
and type(voip.setAudioMode) == "function"
and type(voip.pcmIn) == "function"
and type(voip.pcmOut) == "function"
and type(voip.start) == "function"
log.info("sip_cc", "cc_pcm", not not cc_pcm, "voip_pcm", not not sip_pcm)
修改 SIP 参数
在示例的 sip_cc/config.lua 配置表中修改相应字段。下面的域名、账号和号码是占位值。remote_sip_uri 指向手机呼入时要找的 SIP 对端,target_phone_number 是 SIP 呼入时拨打的固定手机号。示例不会把 SIP 请求中的号码动态转拨到蜂窝侧。 Air8783H 配置说明
-- 修改现有配置表中的这些字段
sip_server_addr = "sip.example.com",
sip_server_port = 5060,
sip_domain = "sip.example.com",
sip_transport = "udp",
sip_username = "DEVICE_ACCOUNT",
sip_password = "DEVICE_PASSWORD",
remote_sip_uri = "sip:TEST_PEER@sip.example.com",
target_phone_number = "TEST_PHONE_NUMBER",
rtp_port = 40000,
codec = "PCMA",
ptime = 20,
adapter = socket.LWIP_GP,
auto_answer_sip = true,
auto_handle_mobile_incoming = true,
5060 和 40000 是示例值。按服务器配置填写 SIP 监听端口,按本端 SDP 和对端协商结果检查 RTP 地址与端口;信令与媒体分别验证可达性。两个自动处理开关适合验证样机,部署时应在 PBX 限制可呼入分机,并按业务限制可外呼目标。 SIP 参数和媒体协商 · VoIP 启动参数
读日志并完成双向测试
- 选择 4G 驱动,在 Luatools 中选择适配的
.soc、Lua 脚本和所需资源,完成下载后重启。从日志确认目标版本已启动、4G 网卡收到IP_READY、CC 进入bridge_pcm、SIP 报告event register ok。网络拿到 IP 与 VoLTE 语音就绪分别检查。 Luatools 烧录 · 启动日志 · CC 事件 - 从 SIP 客户端呼叫板卡账号。接听固定目标手机,分别从两端说话确认可听。使用示例的 PCMA/PCMU 配置时,等接通播报结束后再验证实际人声。 SIP 来电转手机
- 从手机拨打板载 SIM。接听
remote_sip_uri所在的 SIP 客户端,再检查双向人声。分别从两侧挂断,确认另一侧退出,并立即重拨验证资源释放。 手机来电转 SIP
选择 4G 或 Wi‑Fi 网络出口
初次移植按单一 SIP 出口测试。netdrv/netdrv_device.lua 的驱动选择和 sip_cc/config.lua 的 adapter 配置需要匹配。网卡选定后,检查 SIP 信令与 RTP 媒体是否从同一预期接口出站。 Air8783H 网络配置 · Air8000 NETDRV · VoIP adapter
| SIP 出口 | netdrv_device.lua 启用项 |
config.lua 的 adapter |
验证重点 |
|---|---|---|---|
| 4G 数据 | require "netdrv_4g" |
socket.LWIP_GP |
SIM 数据业务、APN、DNS、运营商网络的 SIP/RTP 可达性。 |
| Wi‑Fi STA | require "netdrv_wifi" |
socket.LWIP_STA |
在 netdrv/netdrv_wifi.lua 配置 2.4 GHz 热点的 SSID 和密码,核对该网卡获 IP、DNS、服务器路由及双向 RTP。CC 继续使用 SIM 的 VoLTE。 |
网卡参数配好后,按下图从获取 IP 一直检查到通话和重拨。先用 4G 建立基线,再切到 Wi‑Fi 重做同一套测试,便于判断问题出在网络出口还是通话桥接。
Wi‑Fi 用例中可对照板端网卡日志和 PBX 会话,确认 SIP 确实经 Wi‑Fi 到达。保持 SIM 入网,按 4G 基线的两个方向各打一通,再验证挂断和重拨。专网或局域网 PBX 使用该网络可用的 DNS,按需调整示例驱动的 socket.setDNS()。 网络驱动与 DNS · Air8000 网络接口
如需量产时自动选网,可在应用层实现链路状态机。结束旧会话并关闭旧网卡绑定的 SIP/RTP 连接,等待目标网卡 IP_READY,以新地址重新注册,再建立新通话。验收记录掉线到重新注册的时间,并分别验证 Wi‑Fi 掉电和 4G 数据不可用场景。正在进行的呼叫、主动保活和重复切网属于独立测试项。 exnetif 多网融合 · Air8000W 多网切换
音频和联调验收
编解码和 PCM
| 参数 | 起步配置 | 进一步验证 |
|---|---|---|
| 编解码 | PCMA、ptime = 20 ms |
可按 PBX 配置测试 PCMU。评估 G729 或 G722 时逐项确认设备、服务和客户端支持。 |
| PCM 格式 | 有符号 16 bit、单声道、小端 | 8 kHz 下 20 ms 为 160 样本、320 字节。按实际 PCM 采样率处理帧长、缓冲与节拍。 |
| G722 | 参考示例支持这一选项 | 媒体 PCM 为 16 kHz,而 SDP/RTP 时钟为 8 kHz;确认桥接的采样率转换能力。 |
| 接通播报 | 按需沿用示例的 MP3 资源 | 在 PCMA/PCMU 下确认播报和返回人声。参考示例的 G729/G722 跳过这项播报,TTS、录音和 DTMF 随实际固件单独验收。 |
| TLS 与 RTP 加密 | 联调按 SIP 服务配置使用 UDP、TCP 或 TLS | TLS 保护 SIP 信令,媒体使用独立协商的 SRTP 配置。确认实际固件功能和双方协商结果。 |
桥接代码若要改动 PCM 搬运,按 API 返回的实际消费样本数保留未写入的尾部,并给两路音频分别管理队列和重采样状态。发生重拨、超时或断网时应清理上一次会话的媒体状态。 Air8783H 编解码与播报 · VoIP PCM、DTMF 与安全媒体 API
接入 IVR 或需要键盘控制时,增加双向 DTMF 验收。合宙公开的 sip_cc_bridge_dtmf 可作桥接参考;在样机上分别测试 SIP→CC 和 CC→SIP,核对设备与 PBX 的 SIP INFO 或 RTP telephone-event 配置。 DTMF 示例索引 · CC DTMF API
按现象排查
| 现象 | 优先核对 | 观察点 |
|---|---|---|
| USB 无枚举或周期性重启 | USB 数据连接、VBUS/VBAT、BOOT 状态、看门狗配置 | 换已验证的 USB 口;看 Luatools 或 DBG 复位日志,抓复位前供电。 |
| Wi‑Fi 已连接,SIP 注册失败 | Wi‑Fi 网卡是否拿到 IP,adapter、DNS、域、端口和协议 |
SIP 首次 401 或 407 可属于鉴权挑战;若反复挑战或无成功应答,核对凭据和 PBX 日志。TLS 再查系统时间与 CA。 |
| SIP 注册成功,手机号侧无法接通 | SIM 语音权限、VoLTE、运营商覆盖、固定目标号码和桥接内核 | 查看 CC_IND 及拨号/接听事件,确认有 CC 语音就绪与正确号码。 |
| 已接通但单向或双向无声 | SDP 的 c=/m=、实际 RTP、NAT、PBX 媒体转发、编解码一致性 |
两端分别讲话,对照 RTP stats 的收发与 cc.bridgePcmStats().dl_pushed 的增量;排除播报阶段的静音。 |
| 首通正常,重拨失败 | SIP 对话、CC 呼叫、RTP socket 和 PCM 任务的释放 | 分别从 SIP 和手机挂断,查另一侧是否结束、媒体是否停止,随后马上重拨。 |
| 4G 正常、Wi‑Fi 路径失败 | 驱动与 adapter、2.4 GHz、Wi‑Fi DNS/路由、SIP/RTP 接口绑定 |
先验证设备 Wi‑Fi 能访问服务器,再验证注册与双向 RTP,保留蜂窝驻网做 CC。 |
纯 PCM 示例以 CC 真实接通阶段的 dl_pushed 增量判断蜂窝下行。示例参数 cc_audio_start_timeout_ms、cc_media_missing_call_limit 和 cc_media_reboot_on_error 用于等待 PCM 与异常恢复,调整前记录已接通时长和异常统计,避免把早期媒体或静音注入当成蜂窝下行。 纯 PCM 日志与异常检测 · CC 状态事件
样机验收项目
| 项目 | 通过条件 |
|---|---|
| 4G 与 Wi‑Fi 基线 | 每个出口均有 SIP 注册证据,分别完成 SIP→手机、手机→SIP,并验证两端都能讲话和收听。 |
| 呼叫结束与恢复 | 双端分别主动挂断,另测拒接、未接超时和对端占线。回到空闲后可发起下一通。 |
| 意外断链 | 单独模拟 SIP 出口断开、Wi‑Fi 恢复和蜂窝语音不可用,记录会话清理、重新注册及恢复接通的结果。 |
| 版本和证据 | 归档板版、固件文件名及分支号、脚本版本、SIM 运营商、PBX 配置、所用网卡、RTP/CC 统计。现场日志对账号、号码与设备标识按项目规则脱敏。 |
SIP 产品与模组选型
从 Air8783W Air8783H Air8784 选起
| 型号 | SIP 接入 | 音频与蜂窝侧 | 推荐场景 |
|---|---|---|---|
| Air8783W | 4G 数据或 2.4 GHz Wi‑Fi STA | Air8000W,板内纯 PCM SIP↔CC,蜂窝侧保留 VoLTE SIM | 固定点位有 Wi‑Fi,同时需要与普通手机号双向通话,也可在只有 4G 数据的现场使用。 Air8000W 平台 |
| Air8783H | 4G 数据 | Air780EH2,官方有纯 PCM 桥接示例及 SIP_CC 出厂应用 | 只需 4G 的小型 SIP↔手机号网关,或作为 Air8783W 软件移植基准。 产品和示例 · 出厂固件 |
| Air8784 | 4G 数据 | Air780EHM + UART Air1103,整机可本地免提,官方固件有 SIP 与 SIP_CC 模式 | 现场人员需直接对讲、收听或使用成品免提终端,也可在配套固件下评估手机号桥接。 产品 · 出厂固件 |
大屏控制板和嵌入式终端
| 支持 SIP 的型号 | 推荐场景 | 选型时核对 |
|---|---|---|
| Air8605W、Air8605M | 大屏自助柜、门禁、客服协助。W 适合有稳定 Wi‑Fi 的现场,M 适合 4G 部署。 | 两款均为 Air1602 主控与 Air1103 音频,支持本地 SIP 对讲。W 用 Air6205A,M 用 Air780EX2。分别选配固件。 Air8605 产品 · 软件总体说明 |
| Air8605B | 需要 UVC、双路 485 和 SIP 的定制项目可询证。 | 合宙 FAQ 记录的是专用配置,取样前确认具体装配、固件和供货。 官方 FAQ |
| Air8606W1、Air8606W2、Air8606W3、Air8606M1、Air8606M2、Air8606M3 | 大屏 SIP 协助与设备总线。W 用 Air6205 Wi‑Fi,M 用 Air780EX2 4G,两系均提供以太网 WAN。 | 1 为单路隔离 RS485 + CAN + 人脸配件。2 为单路隔离 RS485 + RS232 + 人脸配件。3 为双路隔离 RS485 + CAN。SIP 选后缀 1~3,后缀 4/5 为 UART6 TTL 配置。 Air8606 十型号选型 |
| Air8701M/MF/MS/MFS | 自研 4G SIP 对讲、门禁或嵌入式免提终端,需在底板上配麦克风和扬声器。 | Air780EHM + Air1103。F 带 16 MB SPI Nor Flash,S 带贴片 SIM。核对音频硬件与所需 SIP、CC、TTS 等固件组合。 Air8701 八型号与管脚 |
| Air8701G/GF/GS/GFS | 在 Air8701 的 SIP 终端设计中同时需要定位。 | Air780EGG + Air1103,带 GNSS 和 G‑Sensor。F/S 定义相同,G 与 M 的内部占用脚和底板连接要分别核对。 Air8701 G 系列 |
Air8605、Air8606 的公开方案是大屏本地 SIP 终端,适合人在设备上讲话和收听。两系列的 M 版使用 Air780EX2 提供 4G 数据,CC 核心库支持表将 Air780EX2 列为不支持。需要用板载 SIM 桥接普通手机号时,从上述 Air8783W、Air8783H 或 Air8784 中选。大屏型号按整机选型表核对语音装配。 Air8605M 语音 FAQ · Air8606 产品 · CC API 支持表 · 大屏整机选型表
自研硬件的 SIP 评估起点
| 平台 | 选择理由 | 适配重点 |
|---|---|---|
| Air8000 系列,优先 Air8000W | 项目需要 4G+Wi‑Fi,或需自研 SIP↔CC 双网桥接。 | 型号按频段、Wi‑Fi 和硬件资源选,内核按 voip、cc 与纯 PCM 后端选。本地对讲还需配实际音频链路。 产品型号 · 平台固件 |
| Air780EHM、Air780EHV | 自研 4G SIP 设备或桥接。EHM 可参考 Air8784 的 Air1103 方案,EHV 可利用其音频硬件开发本地通话。 | 核对具体内核分支、音频硬件、话机电气与 AEC;SIP+CC+显示或 TTS 的组合需实测。 EHM 固件 · EHV 产品 · VoIP 支持 |
| Air780EGH、Air780EGG | 需要 4G+GNSS 的自研 SIP 终端,EGG 可参考 Air8701G 音频架构。 | 按具体固件核对 SIP、CC、音频和 GNSS 是否同时启用。 EGG/EGH 固件 · VoIP 支持 |
| Air700ECH | 评估体积紧凑的 4G 自研桥接。公开固件记录明示 CC/SIP 纯 PCM 后端的分支。 | 核对模块供电、固件、内存及目标音频功能。 Air700ECH 固件 |
| Air780EHU、Air780EHN | 分别面向欧亚与北美的自研 SIP IP 终端候选。公开固件有 VoIP 及 PCM 桥接功能记录。 | 确认频段、实际音频硬件和固件。若项目需要 SIP‑CC,另用目标地区运营商 SIM 验证 IMS/VoLTE 开通、呼入、外呼和双向 PCM。 EHU/EHN 固件 · 硬件规格对照 |
| Air8201 系列 | 以定位为主、需要 SIP 的二次开发项目。可优先评估带音频芯片的 Air8201G‑LM、Air8201H‑BM。 | 对照演示、具体装配的 Codec/PA 和固件做验证,明确需求是本地 SIP 对讲还是 SIP↔CC。 Air8201 软件 · 官方 SIP 示例线索 · 产品选型 |
| Air1601、Air1602、Air1603 | 适合外接网络及音频的自研 SIP 主控。公开 V1028 固件记录包含 voip。 |
按具体板卡落实麦克风采集、播放和免提 AEC。需要快速验证大屏 SIP,可优先采用带 Air1103 的 Air8605 或 Air8606 对应型号。 Air1601 固件 · Air1602 固件 · Air1603 固件 |
同系列名称容易混淆。普通 Air8783 的产品页定位是 USB 上网卡和短信转发,选 SIP‑CC 桥接时用有对应方案的 Air8783H 或 Air8783W。自研板的产品定型以具体硬件、固件版本、SIP 功能和 CC 功能逐项验收。 Air8783 产品页 · 合宙选型指南
参考资料
- 板级电路连接。 Air8783W 原理图
- SIP-CC 参考项目及 AirCloud 出厂方案。 Air8783H 纯 PCM 示例 · Air8783H 出厂固件 · Air8784 出厂固件
- Air8000W 平台和多网接入。 Air8000 产品 · Air8000 固件 · NETDRV · exnetif
- 通话 API。 exsip 信令 · voip 媒体 · cc 蜂窝通话
- 下载、烧录与日志。 Luatools 使用手册 · Air8000 USB 下载接口
公开资料核对日期为 2026‑11‑22。




