HowTo文档
基于 LuatOS 的 SIP 终端如何与 XSwitch 集成?
合宙有很多支持 SIP 的终端产品(参见 合宙产品选型指南),都可以与 XSwitch 互联互通。产品型号不同,与 XSwitch 的对接方式也有所不同。
Air8784
Air8784 主打 SIP 全双工通话无回声,支持且仅支持 4G 网络,支持物联网卡和普通 SIM 卡。

下面,主要以 以 Air8784 为例进行说明。
通过合宙云端 IoT 平台对接
终端管理平面注册到合宙 IoT 平台,SIP 注册到合宙云端 SIP 平台。
以 IMEI 0186431712345678 为例,终端会以 IMEI + 0 作为账号注册到合宙 SIP 服务器(cc.luatos.com),XSwitch 以 IMEI + 1 作为 SIP 账号注册到合宙 SIP 服务器。
在 XSwitch 中添加一个网关:
- 名称:
luatos-1(任意) - 用户名:
01864317123456781 - 密码:
123456(按合宙平台规则) - 服务器:
cc.luatos.com - 端口:
8910 - 协议:
tcp|udp
这种方式,每台终端设备对都应 XSwitch 中的一个网关。
终端呼叫 XSwitch
注册完成后,在终端上按下 SOS 键(呼叫键),会呼叫 01864317123456781。
在 XSwitch 侧添加一个路由,被叫号码 01864317123456781,然后路由到相应的目的地。也可以先不做路由,先打个电话看一下(失败的)话单,再决定如何做路由。
XSwitch 呼叫终端
在 XSwitch 侧拨打任意号码,直接路由到上面建立的网关(如 luatos-1)即可。注意,路由上要做一下号码变换,把被叫号码全部变为 01864317123456780(注意最后的 0,这是合宙平台的约定)。
其他具体细节参考合宙 Air8784 的文档。
直接对接 XSwitch
Air8784 出厂固件直接连接到合宙平台。如果要连接到 XSwitch,则需要自行改代码或刷 XSwitch 提供的固件。
直接将注册信息写到代码中
Air8784 出厂固件代码 是开源的,可以直接修改 sip_config.lua 中相应的参数,让它注册到 XSwitch 平台。然后重新刷机即可。
不过,这种方式不利于以后修改密码之类的。
呼叫逻辑:
- 终端呼叫 XSwitch 时,呼叫
IMEI + 1。 - XSwitch 呼叫终端时,直接路由到 “本地分机” 即可。如果被叫号码不是
IMEI + 0,则在路由上做一个号码变换,将被叫号码变为IMEI +0,即可以找到设备。
远程管理与动态配置
XSwitch 也全面支持 LuatOS 的终端管理和数据下发协议,所以,可以通过修改代码,让终端直接指向 XSwitch 相关的云端管理服务。
修改 task_cloud.lua,使用 mqtt 协议:
- local ok,err=cloud.setup({transport="tcp",use_getip=true,auto_reconnect=true,debug=false}) + local ok,err=cloud.setup({transport="mqtt",use_getip=true,auto_reconnect=true,debug=false})
修改 excloud.lua,增加如下两行,指向 XSwitch 的云端 mqtt 服务器。如:
config.host = "mqtt.xswitch.cn" config.getip_url = "http://demo.xswitch.cn/api/hello/luatos/getip"
为了让终端能连接到 MQTT 获取信息,还需要在 MQTT 服务器上为每个终端(IMEI)建一个账号。
可以直接在 XSwitch 控制台上,对设备(IMEI,如 0186431712345678)下发命令,如:
luarun xui/examples/luatos.lua update 0186431712345678 luarun xui/examples/luatos.lua mode 0186431712345678 round luarun xui/examples/luatos.lua transport 0186431712345678 tcp 5060 luarun xui/examples/luatos.lua password 0186431712345678 123456 luarun xui/examples/luatos.lua get 0186431712345678 luarun xui/examples/luatos.lua command 0186431712345678 '{"op":"update"}'
XSwitch 发布的硬件终端出厂时已经刷好了上述代码对应的固件。
其他
由于 Air8784 是类似 “一键呼叫” 的设备,因此,被叫号码是固定的(可以在出厂时写入或从云端下发)。但 XSwitch 支持非常灵活的路由配置,所以,不管哪种 SIP 对接方式,只要呼叫到达了 XSwitch,就可以路由到任何地方。
另外,上面只是使用了 Air8784 作为例子。其他型号的 SIP 终端也都可以与 XSwitch 互通。Air8784 支持连接物联网平台远程管理,有些型则没有连物联网平台,可以直接通过 SIP 注册的方式注册到 XSwitch 进行呼叫。