Air8783H 整机使用说明
作者:蒋骞 | 最后修改:2026-11-02
声明: Air8783H SIP_CC桥接通话为中性物联网硬件,仅限本人实名登记的 SIM 卡用于企业合法内部运维,严禁用于任何违法行为。
Air8783H 固件下载地址:https://cdn18.luatos.com/files/Air8783H/LuatOS_Air8783H/
一、最新版本固件
固件:Air8783H_Factory_001.000.001_LuatOS-SoC_V2054_Air780EH2_13.soc
固件更新说明(2026-10-23)
- 用于SIP_CC桥接通话,支持SIP话机管理平台,支持SOS号码设置
固件:Air8783H_Factory_001.000.001_LuatOS-SoC_V2054_Air780EH2_13.soc
二、历史版本固件
固件更新说明(2026-10-23)
- 第一版正式量产固件
- 支持 SIP_CC、Air153C 看门狗、FOTA 升级
三、源码链接
我们基于 Air8783H 开发了 SIP_CC,即SIP桥接4G、上传合宙 AirCloud 功能,参考源码如下:
https://gitee.com/openLuat/LuatOS/tree/master/module/Air8783H/project/sip_cc_web
四、图文使用说明
4.1 步骤总览
-
将实名认证的手机卡装进Air8783H的SIM卡槽中,注意SIM卡方向,切勿装反;
-
将装好流量卡的Air8783H上电,标准 USB 5V 供电(电流至少1A),可接USB 充电器或充电宝使用;
-
登录iot平台将设备归属到“8783H_SIP”项目下,详细步骤参考4.2节;
-
iot账号登录SIP话机管理平台,点击设备设置进行SIP参数和SOS号码设置,详细步骤参考4.3节、4.4节;

4.2 把设备归属到自己的合宙 IoT 账号
Air8783H 的 SIP 体验平台认的是「合宙 IoT 账号 + 项目」,所以在登录控制台之前,要先把账号和项目备好,并把设备挂到自己名下。这一步只需做一次。
4.2.1 登录合宙 IoT 云平台
打开合宙 IoT 云平台,用手机号登录。CRM 与 IoT 是同一个合宙账号(账号即手机号),忘记密码可点「找回密码」重置:
https://iot.openluat.com/cloud/main
4.2.2 新建 8783H_SIP 项目
- 进入「我的项目」。
- 点「新建项目」。
- 项目名称填 8783H_SIP,项目描述随意,比如我这里填的是「测试 8784 的 SIP 通话」。
- 点「提交」。

4.2.3 把设备 IMEI 转移到 8783H_SIP 项目
新设备默认在别的项目(如「合宙标准模块」)或别的账号下,需要转移到你自己的 8783H_SIP 项目,SIP 体验平台才能管理到它。操作参考官方文档「合宙的设备如何归属到自己账号名下」:
https://docs.openluat.com/air780epm/product/attributioniot/
线上(IoT 平台)操作步骤如下:
- 登录 iot.openluat.com,进入「我的设备」。
- 输入设备 IMEI 查询当前归属;线下批量订单的设备通常先在「合宙标准模块」项目下。
- 点所选项目的「操作」,选择「批量转移」。
- 选择「转移到其他账号」或目标项目,并把目标项目设为 8783H_SIP。
- 填设备 IMEI(单个设备直接填;多台可勾选「转移当前项目所有设备」,或上传含 IMEI 清单的 Excel),提交。
设备一旦设置到自己名下,合宙不再有权限转移。官方电商渠道(淘宝 / 微信商城)可在 crm.luatos.com 用订单号 + 快递单号自助设置归属;非官方渠道购买的设备请联系对应渠道客服协助。
4.3 登录 Air8783H SIP 控制台
平台地址(SIP 设备管理控制台):
- 打开上面的地址,会先进入「登录控制台 · Air8783H」页面。
- 点击「使用合宙 IoT 账号登录」,跳转到合宙官方授权页。
- 用合宙 IoT 账号登录(手机号密码或微信扫码),授权后自动跳回控制台。

登录后进入设备管理工作台首页。左侧导航只有两项:设备管理(当前页,卡片式管理每台设备)与分组管理(层级分组与逐级拨打,详见第 4.4.5 节)。
工作台顶部可切换「项目」(未来会有多款SIP话机设备,不同的设备根据不同的项目进行切换)、按 IMEI 筛选、刷新列表。每台设备一张卡片,卡片上直接给出常用操作:查看定位(地图)、设备设置(SIP / SOS 通道 / 音量 / TTS / 诊断,第 4.4 节)、通话记录(通话历史,第 4.4.4 节)、刷新状态(get_status 回传电量 / 经纬度 / SIP 状态),卡片右上角 版本(固件更新,第 4.6.1 节)。

设备卡片上的 SIP 状态由两部分叠加:在线与否来自账号在线状态接口(服务器侧注册状态,每 12 秒自动刷新);通话中 / 拨号中这类瞬时状态来自设备上报。卡片的电量、经纬度取自设备 get_status 回执(battery / location 段),点「刷新状态」可让设备重新上报。
4.4 设备设置
在设备管理页点某台设备的「设备设置」,打开设置面板。副标题明确写着「每一台独立提交,提交后立即下发到设备」。面板自上而下分为:
- SIP 设置:服务器地址、端口、域、传输协议(UDP / TCP / TLS)、SIP 账号 / 密码、自动接听与延时;
- SOS 设置:四个互斥通道(SIP / SIP_CC / CC / 分组管理);
- 音量调节:喇叭音量 0–31、麦克音量 1–8;
- TTS 下发:输入要本地语音合成播报的内容;
- 设备上报记录(诊断):读取设备最近的上报原文用于核对。

任一栏修改后点该栏的「提交」按钮即下发;密码仅本次提交使用,不写入浏览器、也不回填。点卡片上的「刷新状态」可让设备回传当前 SIP 参数与自动接听设置,页面据此自动回填供核对。
4.4.1 SIP 账号设置
SIP 设置区用于配置注册参数。默认服务器 cc.luatos.com、端口 8910、传输 UDP。传输协议下拉支持 UDP / TCP / TLS:需要 SIP over TLS 时把这里改为 TLS 并提交即可(CA 证书仍需手工烧录到设备 /luadb/sip-ca.pem,网页侧不负责上传证书),详见第 12.2 节。
勾选「自动接听」后,设备在响铃到设定秒数(0–20,默认 5 秒)时自动接听;不勾选则关闭自动接听(此时按键参数不会下发)。打开面板时各栏会回填上次填写 / 下发的值,SIP 密码出于安全不回填,重新提交时需再次输入。

合宙的每台SIP设备都会有两个测试账号,默认设备端用 IMEI+0,对端软终端用 IMEI+1。

| 项目 | 取值 |
|---|---|
| SIP 服务器 | cc.luatos.com |
| 端口 / 传输 | 8910 / UDP |
| 密码 | 123456 |
| 本机(设备)账号 | IMEI + 0 |
| 对端(软终端 / 另一台设备) | IMEI + 1 |
举例,若设备 IMEI 为 864317088102861:
- 设备自己注册为 8643170881028610@cc.luatos.com
- 它的对端软终端是 8643170881028611@cc.luatos.com
设备开机已自动用 IMEI 注册,所以你只需要保证对端(手机软终端)填的是 IMEI+1 这个账号、服务器 cc.luatos.com:8910、UDP、密码 123456。
注意:IMEI+0 / IMEI+1 是在 IMEI 末尾「追加」一个字符,不是把 IMEI 当数字做加法。例:IMEI 864317088102861 → 本机 8643170881028610,对端 8643170881028611。
密码:出厂默认就是 123456,与固件内置的一致,不需要额外分配(在「设备设置 → SIP 设置」里填写)。对端软终端注册不上时,优先核对这里的密码是否与设备一致。
4.4.2 对端账号软终端:手机Linphone/电脑MicroSIP
对端软终端就相当于「另一部电话」:设备按键拨号、或桥接发起的呼叫,最终都落到软终端账号(IMEI+1)上。下面用官方推荐的两款免费软件做对端。
通用填写参数(两款软件一致):服务器 / 域名 cc.luatos.com,端口 8910,传输 UDP,账号 = 你的设备 IMEI+1(例:8643170881028611),密码 123456。
电脑端 MicroSIP(Windows)
- 到官网 www.microsip.org/downloads 下载并安装 MicroSIP。
- 添加账号:SIP Server / Domain 填 cc.luatos.com,Port 填 8910,Username 填设备 IMEI+1,Password 填 123456,Transport 选 UDP。
- 保存后账号显示在线(注册成功)。
- 拨打设备:
(1)在 MicroSIP 里输入设备账号 IMEI+0 可以向设备发起呼叫;
(2)Air8784整机设备通过按键呼叫时,MicroSIP 会收到来电。

手机端 Linphone(安卓)
- 安装安卓版 Linphone(合宙分发地址 www.pgyer.com/53b4d12991b2582c45497671bfcb7201)。
- 添加 SIP 账号:Domain / 服务器填 cc.luatos.com,端口 8910,用户名填设备 IMEI+1,密码 123456,传输选 UDP。
- 注册成功后即可拨打设备账号 IMEI+0,或接收设备来电。

软终端账号必须用 IMEI+1,不要填 IMEI+0——那是设备自己的账号,重复登录会冲突注册不上。
4.4.3 SOS 设置
SOS 设置里四个子标签即为四种通话通道,当前生效的通道会高亮提示「当前生效:XX」。四个通道互斥,只能有一种生效:提交某个通道会清空设备里其余通道的号码,8783H只支持SIP_CC模式。
- SIP_CC:设备作为 SIP↔CC 桥接,填 SIP_CC 对端号码(需已实名、开通语音的 SIM 卡);

4.4.4 通话记录
点设备卡片的「通话记录」,按设备上报的 SIP 账号查询通话历史。可按日期(今天 / 近 3 天 / 近 7 天)、SIP 账号、接通情况筛选后点「查询」。由于记录按账号查,需先让设备上报 sip_username(即设备 IMEI+0 账号),查询时填写该账号即可拉到对应记录。
注意:当前只有用合宙SIP服务器下的账号才支持查询通话记录和录音

4.4.5 分组管理与网页拨号
左侧导航「分组管理」按一级 / 二级 / 三级层级把设备编入分组。未归属的设备都在「未分组设备」节点下,右键设备(或行尾 ⋯)可拨号、查看定位、分组移动。
网页拨号(软电话)使用的 SIP 账号在「分组管理 → 超级管理员账号」里配置,仅保存在本机浏览器,不上报平台;浏览器端只能以 WebSocket(WS / WSS)连接 SIP 服务器,请确认服务器已开启对应监听端口(推荐 WSS,https 页面可用)。


4.4.6 音量、TTS 与诊断
回到「设备设置」面板下部:
- 音量调节:喇叭音量 0–31(默认 28)、麦克音量 1–8(默认 2),拖动后「提交音量设置」即下发;
- TTS 下发:输入要播报的内容,中文会自动转成 JSON Unicode 转义后再下发(规避平台链路编码问题),「提交 TTS 内容」即本地语音合成播报;
- 设备上报记录(诊断):点「读取最近上报」看设备实际回传的
cmd、字段与tag,用于核对「卡片显示未收到回执」等问题;「查看最近下发」可核对前端到底发了几次(下发走 TCP)。



4.5 实战:跑通一次 SIP_CC 通话
目标:用手机打给设备里的手机卡,电脑 SIP 软终端会收到来电,验证整条语音链路。前提是先按第 4.4.3 节在「设备设置 → SOS 设置」里选好 SIP_CC 通道、填好对端号码(即本设备 IMEI+1)和手机号,并提交下发——没有通道配置,设备按 SOS 是拨不出去的。
- 确认设备已上电、进业务模式,日志能看到「SIP 注册成功」(或心跳行 SIP注册=Y)。
- 手机 / 电脑上装好 SIP 软终端,按第 4.4.2 节约定填 IMEI+1 账号并完成注册。
- 在「设备管理」页点该设备的「设备设置」,进入「SOS 设置」选 SIP_CC 通道,填对端号码(IMEI+1)和SOS手机号后点「提交」;面板提示提交成功后配置即下发到设备。
- 若设备原本跑的是 SIP 分支,切到 SIP_CC 后会保存配置、空闲时重启再上线,等它重新注册上来。
- 手机拨打设备中的手机卡,VoLTE自动接通后,SIP向对端(软终端)发出 INVITE。
- 软终端振铃,你在软终端上接听,双向通话建立。
验证点(checkpoint):日志出现 180 Ringing,说明信令已送达对端;出现 200 OK 表示接通。若对端无人接听,约 30 秒后超时,返回 486 Busy Here,设备回到空闲。
4.6 远程升级(FOTA)与 SIP over TLS
4.6.1 固件更新(FOTA)
最简单的方式是在设备管理页点设备卡片右上角的 版本 按钮,打开「固件更新」面板:
- 面板顶部显示设备当前固件版本(如
Air8783H_Factory_001.000.002)及其 Tag 1027 上报时间; - 点 重新读取版本 可实时刷新设备当前烧录的版本;
- 确认后点 开始更新,平台经 AirCloud 控制命令(Tag19 / Tag1281)远程下发升级。

升级期间一定不能断电,请保持设备联网、电源稳定;升级完成后设备会自动重启,重启期间短暂离线属正常现象。
若控制台版本入口暂不可用,仍可走合宙 IoT 设备管理平台的 AirCloud 下发:顶部菜单 基础能力 → AirCloud → AirCloud 上报记录,找到目标设备点 下发,命令类型选 控制命令 (Tag19)、数据类型选 ASCII 字符,消息内容填 update 或 fota,设备收到后调用 libfota3 检查并执行升级。
4.6.2 切换 SIP 传输为 TLS
首选(网页):在「设备设置 → SIP 设置」里把 传输协议 下拉(UDP / TCP / TLS)改为 TLS,确认服务器地址与端口后点 提交 SIP 设置,配置即经 set_config 下发到设备;设备回执显示 设备已确认保存:<server>:<port>(TLS)。

备选(云端):仍可由 AirCloud 上报记录下发控制命令,消息内容填 {"op":"set_transport","sip_transport":"tls"}(切回 UDP 填 {"op":"set_transport","sip_transport":"udp"};非默认端口附加 sip_server_port,例如 {"op":"set_transport","sip_transport":"tls","sip_server_port":5062})。
两种方式都要求设备已烧录 CA 证书到 /luadb/sip-ca.pem(网页侧不负责上传证书),且底层为支持 SIP over TLS 的固件版本。
切换后设备约 1 秒重启生效,传输与端口持久化到 fskv,重启后自动回载。
五、常见问题
| 现象 | 排查方向 |
|---|---|
| SIP 注册不上 / 账号无法登录 | 看日志有无 exsip init completed 与 SIP 注册成功(心跳 SIP注册=Y);没有则查 4G 驻网、fskv 是否被改、是否真的进了业务模式;账号类问题另查服务器与端口、账号末尾 0/1、实际 SIP 密码、传输方式及网络连通性 |
| 软终端在线但呼叫不到设备 | 设备是否也完成 SIP 注册;拨打的是否为设备端账号;是否选错 IMEI |
| 能注册,但按 SOS 拨不出去 | 先确认是否已在「设备设置 → SOS 设置」选好通道并提交;没有通道配置就没有呼叫目标 |
| 同一设备无法切换通道 / 号码不生效 | SOS 四通道互斥,提交新通道会清空其余通道号码;确认提交的是当前要用的通道 |
| 轮拨顺序不符合预期 | 设备设置 SOS 通道里的目标序号、等待时间(默认 30 秒)与目标上限是否正确保存 |
| 只有一方能听见声音 | 双方麦克风与扬声器、音量、应用权限,以及网络的语音媒体通路 |
| 通话有回声、断续或杂音 | 音频接线、麦克风与喇叭布置、音量、供电稳定性、网络质量及固件适配 |
| CC 模式打不通 / 提示卡无效 | SIP_CC 需要已实名且开通语音功能的手机卡,物联网卡不行 |
| 普通手机号无法呼叫 | 是否使用 SIP_CC,SIM 卡是否实名且支持语音,以及实机版本是否支持此场景 |
| 按键没反应 | 确认按的是 SOS(GPIOxx)发起 / 接听、UP(GPIOxx)长按挂断;网页不下发呼叫 |
完成实机配置后,建议分别验证:软终端呼叫设备、设备呼叫软终端、双方接听与挂断,以及在最终外壳和常用音量下的双向语音。使用轮拨时,再验证首个目标接听后不继续呼叫、首个目标未接听时能按顺序转向下一目标。