Air8783W 下载 Markdown

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

认识 Air8783W

正反面实物图均以 USB 插头朝上,点击图片可查看大图。以 PCB 边缘的 Air8783W 丝印识别板卡,正面中央为 Air8000W 模组。

正面接口和天线

Air8783W 正面实物标注,标出 USB-A 插头、网络灯、电源灯、BOOT 键、Air8000W 模组、Wi-Fi 天线和 4G 天线

背面卡座和调试点

Air8783W 背面实物标注,标出 USIM 卡座、降压电路和调试测试点

接口和器件

功能 位号与位置 开发时怎么用
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-CC 核心架构,区分 SIP 信令、RTP 媒体、板内 PCM 和 SIM VoLTE 通路

通路 处理什么 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

双向呼叫时序

下图并排比较两种呼入方向。联调时先找到来电的那一侧,再按箭头核对另一侧何时应答,以及板卡何时开始转接语音。

Air8783W SIP-CC 双向呼叫时序,展示 SIP 呼入转手机、手机呼入转 SIP 以及挂断联动

SIP 呼入转手机。 SIP 客户端呼叫板卡账号。参考示例先发带 SDP 的 183,确认 VoIP 就绪后拨打配置中的固定手机号。手机接通且 CC 的 PCM 通道就绪后,板卡正式应答 SIP,双方开始通话。 Air8783H 示例呼叫流程

手机呼入转 SIP。 手机拨打板载 SIM 号码。板卡通过 SIP 呼叫配置中的 remote_sip_uri,待 SIP 对端接听并建立媒体后接听蜂窝来电。参考示例按单通会话使用,任一侧挂断时清理两边呼叫与媒体。项目需要分组路由或多通并发时,应单独验证号码映射、资源回收及实际并发能力。 Air8783H 示例呼叫流程

跑通第一通桥接电话

准备固件和测试环境

  1. 准备 Air8783W、可下载和抓日志的 USB 连接、支持 VoLTE 的 SIM、可互通的 SIP 服务器和 SIP 客户端,以及一部用于收发测试电话的手机。服务器至少准备板卡注册账号和 SIP 客户端账号,可用自建 FreeSWITCH 等 PBX 联调。验证时使用可控的测试号码和独立账号。 Air8783H 示例准备 · FreeSWITCH 对接 FAQ
  2. 选择匹配 Air8000W 并经 Air8783W 板级确认的 LuatOS 内核。Air8000 固件记录曾明确列出 13/113/22/122 的 CC/SIP 纯 PCM 后端,可用于核对编译功能。内核、分支号、脚本版本与 Wi‑Fi 配套固件须一起记录。Air8783H 和 Air8784 的出厂固件分别针对自身硬件,迁移时复用其流程和脚本设计。 Air8000 固件记录 · Air8783H 出厂固件
  3. 从 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 的解析关系。 示例及烧录清单
  4. 如果沿用示例的接通播报,将 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 启动参数

读日志并完成双向测试

  1. 选择 4G 驱动,在 Luatools 中选择适配的 .soc、Lua 脚本和所需资源,完成下载后重启。从日志确认目标版本已启动、4G 网卡收到 IP_READY、CC 进入 bridge_pcm、SIP 报告 event register ok。网络拿到 IP 与 VoLTE 语音就绪分别检查。 Luatools 烧录 · 启动日志 · CC 事件
  2. 从 SIP 客户端呼叫板卡账号。接听固定目标手机,分别从两端说话确认可听。使用示例的 PCMA/PCMU 配置时,等接通播报结束后再验证实际人声。 SIP 来电转手机
  3. 从手机拨打板载 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 重做同一套测试,便于判断问题出在网络出口还是通话桥接。

Air8783W 4G 与 Wi-Fi 联调,列出两种网卡配置、VoLTE 条件、验收日志和无声排查步骤

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 产品页 · 合宙选型指南

参考资料

公开资料核对日期为 2026‑11‑22。