服务器地址与端口配置指令(含返回校验)

用 TCP/UDP 或 MIP/BIP 改服务器地址,改前先 CXIP 留底、改后再 CXIP 复查。本文只写站内已公开的 5 条指令,回执样例与型号矩阵请向商务索取。

改服务器地址之前,先发一条 <CXIP,> 把原值记下来。改完再发一次 CXIP,回执和你设的值一致才算成功。中间这步校验不能省,因为站内短信配置页写得很清楚:地址配错不会报错,只是设备不上线。

本文只用站内已公开的 5 条指令,全部是查询与常规配置类。断油、复位、远程调试类指令不在公开范围,本文不列。

一、适用范围与前置条件

适用型号与固件版本:需向商务确认。站内没有「型号 × 指令支持矩阵」与按固件版本区分的指令表,《短信规范》只写「不同设备支持情况不同」而无对照表。研发补出之前,不要按型号名推断指令是否可用;本文写法来自站内已上线的短信配置页,属通用格式,不代表 11 款逐款验证过。

网络制式与通道前提:设备要能收短信,或你能用串口连上;SIM 卡在网、未欠费;平台已经把新地址与端口给你。部标机型与非部标机型的地址指令不同,见第二节。

前置条件清单:

项 要求
权限 只做常规配置类指令;改连接模式、复位、恢复出厂不在本文范围
工具 手机短信,或电脑 + 串口调试工具 S-COM V10
备份 改前必须发 <CXIP,> 并保存回执原文,这是回滚时可依赖的依据
记录 型号、固件版本、原 IP / 端口、新 IP / 端口、操作时间
风险提示 地址写错会让设备下线;批量操作前先在单台上验证

站内格式有四条要记牢:字头是 3 个大写字母且大小写敏感;参数用逗号分段,最后一段后面也要有逗号;各段不分先后;一条短信可以发多条指令,按书写顺序执行。< 开头会回一条短信,> 开头只执行不回复。

二、指令表(5 条,风险等级来自指令库分级)

指令 参数 说明 示例 风险等级
TCP IP:端口 非部标设备,TCP 上报 <TCP=8.8.8.8:5555,> 中
UDP IP:端口 非部标设备,UDP 上报 <UDP=8.8.8.8:5555,> 中
MIP IP:端口 部标设备,主服务器 <MIP=8.8.8.8:5555,> 中
BIP IP:端口 部标设备,副服务器 <BIP=8.8.8.8:5555,> 中
CXIP 无参数 查询设置信息:IP、连接方式、APN、版本 <CXIP,> 低

示例里的 8.8.8.8:5555 是站内短信配置页的占位示例,不是真实平台地址,也不是推荐端口。上线或实操时换成平台给你的值。

两条容易出错的边界:

  1. 部标机用 MIP / BIP,非部标机用 TCP / UDP。不确定自己属于哪种,先发 CXIP 看回执,或联系技术支持,别两种都试一遍。
  2. 主备要一起改。只改 MIP 不改 BIP,主服务器故障时没有备份通道;平台迁移时 TCP 与 UDP 也建议一起改,避免「IP 改了、通道没改,设备看着在线其实不上报」。

SLM(连接模式设置)会决定设备走 TCP 还是 UDP,改错会导致不上线,按发布分级属「联系服务商」,本文不展开语法。

三、执行步骤(每步给出预期结果)

第 1 步 · 留底:发 <CXIP,>,把回执里的服务器 IP、连接方式、APN、版本抄下来。

预期:收到一条回执短信。没收到,先查号码、设备供电、卡是否欠费,别继续。

第 2 步 · 下发:按机型选一组,一次发完,减少半套配置。

非部标机:<TCP=新IP:新端口,UDP=新IP:新端口,CXIP,>
部标机:  <MIP=新IP:新端口,BIP=新IP:新端口,CXIP,>

预期:< 开头会回一条短信;末尾的 CXIP 让设备在同一条里复查一次。批量配置可以把开头换成 > 只执行不回复,但那样你会少一份回执留证,单台验证时别这么做。

第 3 步 · 复查:再单独发一次 <CXIP,>,逐项比对新值。

预期:回执里的 IP / 端口 / 连接方式与第 2 步设的一致。不一致,按第五节处理,不要重复下发第三遍。

第 4 步 · 看平台:确认设备按新地址上线、轨迹时间正常更新。

预期:平台有新点位。配置对了但没点位,转去「不上报数据的 5 步自查」。

站内短信配置页给了「新设备首次配置」与「平台迁移 / 换服务器」两个场景,上面第 2 步沿用迁移场景的写法:一次发完,避免只改一半。

四、返回与校验

返回码含义表:需向商务确认。 《短信规范》只给了下发格式,没有给成功 / 失败回执样例,站内也没有公开返回码表。因此本页不列任何 OK / ERROR 码或错误编号——编一个出来,比没有更危险。

按模板要求,这一段本应必填返回码表;目前本页不满足该必填项,研发补齐回执样例前不建议发稿。在补齐之前,用下面三个可执行的校验动作替代:

校验动作 判断标准
看有没有回执 < 开头的指令应回一条短信;没有回执先查号码、供电、卡
发 CXIP 复查 回执里的 IP / 端口 / 连接方式与本次设置值一致
看平台 设备上线,且轨迹时间随新配置更新

三条都过,才算配置生效。只有回执这一条过、后两条没过,是「指令收到了但没生效」,不是成功。

五、失败处理与回滚

现象 先查 处理
发了没回执 号码、设备供电、卡是否欠费 不重复下发,先恢复通信
回执正常但不上线 CXIP 里的 IP / 端口 / 连接方式 按机型核对 TCP/UDP 与 MIP/BIP 是否用对
上线了但没数据 <CXPI,> 查电压与定位状态 转不上报数据排查
换卡后离线 APN 是否改成新卡的 按 APN 配置流程处理
改了过一会儿又变回去 平台是否在下发配置 找平台侧确认下发规则,别反复改

回滚:把第 1 步 CXIP 记下的原 IP / 端口按原通道类型重发一遍,再 CXIP 复查。这是本文推荐的退路。

恢复出厂:RES 属高风险、按发布分级归「联系服务商」,会清掉全部配置,本文不给语法。需要时联系技术支持按机型操作。

六、版本与变更、下一步动作

版本与变更记录:需向商务确认。站内没有指令变更时间、改动人与影响型号的记录。按改造方案第七节,工具型内容需版本管理与双人复核;发布前应由研发补一条版本记录并注明固件版本范围。

你现在可以做的动作:先在单台设备上走完第三节四步,把两次 CXIP 回执原文和平台上线时间存证;确认无误后再批量下发。批量时用 > 开头减少回执,但保留至少一台用 < 开头留证。

该找谁:机型是部标还是非部标、指令是否支持你这台、回执样例与返回码表、固件版本对应关系,找技术支持 400-008-5969;平台新地址与端口找平台方或商务。

相关工具:电脑端用站内串口调试工具页批量发送、看回执;短信格式见站内短信配置页。真实服务器地址由平台方提供。

参考页面