跳转至

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)

  1. 用于SIP_CC桥接通话,支持SIP话机管理平台,支持SOS号码设置

固件:Air8783H_Factory_001.000.001_LuatOS-SoC_V2054_Air780EH2_13.soc

二、历史版本固件

固件更新说明(2026-10-23)

  1. 第一版正式量产固件
  2. 支持 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 步骤总览

  1. 将实名认证的手机卡装进Air8783H的SIM卡槽中,注意SIM卡方向,切勿装反;

  2. 将装好流量卡的Air8783H上电,标准 USB 5V 供电(电流至少1A),可接USB 充电器或充电宝使用;

  3. 登录iot平台将设备归属到“8783H_SIP”项目下,详细步骤参考4.2节;

  4. iot账号登录SIP话机管理平台,点击设备设置进行SIP参数和SOS号码设置,详细步骤参考4.3节、4.4节;

web_setting.png

4.2 把设备归属到自己的合宙 IoT 账号

Air8783H 的 SIP 体验平台认的是「合宙 IoT 账号 + 项目」,所以在登录控制台之前,要先把账号和项目备好,并把设备挂到自己名下。这一步只需做一次。

4.2.1 登录合宙 IoT 云平台

打开合宙 IoT 云平台,用手机号登录。CRM 与 IoT 是同一个合宙账号(账号即手机号),忘记密码可点「找回密码」重置:

https://iot.openluat.com/cloud/main

4.2.2 新建 8783H_SIP 项目

  1. 进入「我的项目」。
  2. 点「新建项目」。
  3. 项目名称填 8783H_SIP,项目描述随意,比如我这里填的是「测试 8784 的 SIP 通话」。
  4. 点「提交」。

在合宙 IoT 云平台新建项目 8783H_SIP

4.2.3 把设备 IMEI 转移到 8783H_SIP 项目

新设备默认在别的项目(如「合宙标准模块」)或别的账号下,需要转移到你自己的 8783H_SIP 项目,SIP 体验平台才能管理到它。操作参考官方文档「合宙的设备如何归属到自己账号名下」:

https://docs.openluat.com/air780epm/product/attributioniot/

线上(IoT 平台)操作步骤如下:

  1. 登录 iot.openluat.com,进入「我的设备」。
  2. 输入设备 IMEI 查询当前归属;线下批量订单的设备通常先在「合宙标准模块」项目下。
  3. 点所选项目的「操作」,选择「批量转移」。
  4. 选择「转移到其他账号」或目标项目,并把目标项目设为 8783H_SIP。
  5. 填设备 IMEI(单个设备直接填;多台可勾选「转移当前项目所有设备」,或上传含 IMEI 清单的 Excel),提交。

设备一旦设置到自己名下,合宙不再有权限转移。官方电商渠道(淘宝 / 微信商城)可在 crm.luatos.com 用订单号 + 快递单号自助设置归属;非官方渠道购买的设备请联系对应渠道客服协助。

4.3 登录 Air8783H SIP 控制台

平台地址(SIP 设备管理控制台):

SIP 话机管理平台:sip.luatos.com

  1. 打开上面的地址,会先进入「登录控制台 · Air8783H」页面。
  2. 点击「使用合宙 IoT 账号登录」,跳转到合宙官方授权页。
  3. 用合宙 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 设置 + SOS 设置(四通道)

任一栏修改后点该栏的「提交」按钮即下发;密码仅本次提交使用,不写入浏览器、也不回填。点卡片上的「刷新状态」可让设备回传当前 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 设置:服务器 / 端口 / 传输协议(UDP / TCP / TLS)/ 自动接听

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

SIP 账号映射:设备用 IMEI+0,对端软终端用 IMEI+1

项目 取值
SIP 服务器 cc.luatos.com
端口 / 传输 8910 / UDP
密码 123456
本机(设备)账号 IMEI + 0
对端(软终端 / 另一台设备) IMEI + 1

举例,若设备 IMEI 为 864317088102861:

设备开机已自动用 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)

  1. 到官网 www.microsip.org/downloads 下载并安装 MicroSIP。
  2. 添加账号:SIP Server / Domain 填 cc.luatos.com,Port 填 8910,Username 填设备 IMEI+1,Password 填 123456,Transport 选 UDP。
  3. 保存后账号显示在线(注册成功)。
  4. 拨打设备:

(1)在 MicroSIP 里输入设备账号 IMEI+0 可以向设备发起呼叫;

(2)Air8784整机设备通过按键呼叫时,MicroSIP 会收到来电。

MicroSIP 拨号盘与「编辑账户」页:服务器 cc.luatos.com:8910、用户名 IMEI+1、传输 UDP

手机端 Linphone(安卓)

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

Linphone 添加账号(一) Linphone 添加账号(二) Linphone 拨号 / 通话界面

软终端账号必须用 IMEI+1,不要填 IMEI+0——那是设备自己的账号,重复登录会冲突注册不上。

4.4.3 SOS 设置

SOS 设置里四个子标签即为四种通话通道,当前生效的通道会高亮提示「当前生效:XX」。四个通道互斥,只能有一种生效:提交某个通道会清空设备里其余通道的号码,8783H只支持SIP_CC模式。

  • SIP_CC:设备作为 SIP↔CC 桥接,填 SIP_CC 对端号码(需已实名、开通语音的 SIM 卡);

SOS 设置:SIP_CC 子标签(四通道互斥,当前生效提示)

4.4.4 通话记录

点设备卡片的「通话记录」,按设备上报的 SIP 账号查询通话历史。可按日期(今天 / 近 3 天 / 近 7 天)、SIP 账号、接通情况筛选后点「查询」。由于记录按账号查,需先让设备上报 sip_username(即设备 IMEI+0 账号),查询时填写该账号即可拉到对应记录。

注意:当前只有用合宙SIP服务器下的账号才支持查询通话记录和录音

通话记录:日期 / SIP 账号 / 接通情况筛选 + 查询

4.4.5 分组管理与网页拨号

左侧导航「分组管理」按一级 / 二级 / 三级层级把设备编入分组。未归属的设备都在「未分组设备」节点下,右键设备(或行尾 ⋯)可拨号、查看定位、分组移动。

网页拨号(软电话)使用的 SIP 账号在「分组管理 → 超级管理员账号」里配置,仅保存在本机浏览器,不上报平台;浏览器端只能以 WebSocket(WS / WSS)连接 SIP 服务器,请确认服务器已开启对应监听端口(推荐 WSS,https 页面可用)。

分组管理:分组树 + 新建分组 + 超级管理员账号

网页拨号账号配置:超级管理员 SIP 账号(仅本机保存)

4.4.6 音量、TTS 与诊断

回到「设备设置」面板下部:

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

音量调节:喇叭 / 麦克滑块 + 提交

TTS 下发:播报内容输入框 + 提交

设备上报记录(诊断):读取最近上报 / 复制全部 / 查看最近下发

4.5 实战:跑通一次 SIP_CC 通话

目标:用手机打给设备里的手机卡,电脑 SIP 软终端会收到来电,验证整条语音链路。前提是先按第 4.4.3 节在「设备设置 → SOS 设置」里选好 SIP_CC 通道、填好对端号码(即本设备 IMEI+1)和手机号,并提交下发——没有通道配置,设备按 SOS 是拨不出去的。

  1. 确认设备已上电、进业务模式,日志能看到「SIP 注册成功」(或心跳行 SIP注册=Y)。
  2. 手机 / 电脑上装好 SIP 软终端,按第 4.4.2 节约定填 IMEI+1 账号并完成注册。
  3. 在「设备管理」页点该设备的「设备设置」,进入「SOS 设置」选 SIP_CC 通道,填对端号码(IMEI+1)和SOS手机号后点「提交」;面板提示提交成功后配置即下发到设备。
  4. 若设备原本跑的是 SIP 分支,切到 SIP_CC 后会保存配置、空闲时重启再上线,等它重新注册上来。
  5. 手机拨打设备中的手机卡,VoLTE自动接通后,SIP向对端(软终端)发出 INVITE。
  6. 软终端振铃,你在软终端上接听,双向通话建立。

验证点(checkpoint):日志出现 180 Ringing,说明信令已送达对端;出现 200 OK 表示接通。若对端无人接听,约 30 秒后超时,返回 486 Busy Here,设备回到空闲。

4.6 远程升级(FOTA)与 SIP over TLS

4.6.1 固件更新(FOTA)

最简单的方式是在设备管理页点设备卡片右上角的 版本 按钮,打开「固件更新」面板:

  1. 面板顶部显示设备当前固件版本(如 Air8783H_Factory_001.000.002)及其 Tag 1027 上报时间;
  2. 点 重新读取版本 可实时刷新设备当前烧录的版本;
  3. 确认后点 开始更新,平台经 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)。

SIP 设置:传输协议下拉选择 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)长按挂断;网页不下发呼叫

完成实机配置后,建议分别验证:软终端呼叫设备、设备呼叫软终端、双方接听与挂断,以及在最终外壳和常用音量下的双向语音。使用轮拨时,再验证首个目标接听后不继续呼叫、首个目标未接听时能按顺序转向下一目标。

搜索