DLMS/COSEM 蓝皮书解读三十五GSM diagnosticclass_id 47—— 蜂窝模组自我体检注册/信号/小区/邻区v0/v1 合并系列说明本系列基于 DLMS UA《Blue Book蓝皮书第 16 版 · 第 2 部分》一个接口类一篇。第 34 篇讲了SMTP setupclass_id 46它让电表能发邮件。本篇的GSM diagnosticclass_id 47回到通信可观测性回答蜂窝模组GSM/GPRS/UMTS/LTE/CDMA此刻状态如何——注册、信号、小区、邻区。上篇回顾第 34 篇SMTP setup负责把告警/数据通过邮件发出去本篇则是蜂窝模组自身的体检表用来诊断为什么这台表连不上网。原文含 version 0 与 version 1本篇合并讲解并严格标注 v1 相对 v0 的扩展。0. 为什么需要这个类 —— 排查这台表为什么连不上网的第一手数据蜂窝网络时刻在变注册状态、信号强度、邻区切换……。电表或集中器带 GPRS/4G 模块要能把这些参数记下来才能诊断通信故障。蓝皮书对它的定位蓝皮书原文v0 Overview“The GSM/GPRS network is undergoing constant changes in terms of registration status, signal quality etc. It is necessary to monitor and log the relevant parameters in order to obtain diagnostic information that allows identifying communication problems in the network.”蓝皮书原文v0 Overview“A GSM diagnostic – Profile generic object is also available to capture the attributes of the GSM diagnostic object, see , 6.5.”即本类的属性可以被一个Profile genericclass_id 7第 7 篇对象定时捕获形成信号质量历史曲线——这是它最有用的玩法之一。蓝皮书原文v1 Overview扩展网络类型“An instance of the ‘GSM diagnostic’ class stores parameters of the GSM/GPRS, UMTS, CDMA or LTE network necessary for analysing the operation of the network.”1. 类蓝图1.1 属性表version 0 与 version 1两类版本属性名/数量完全一致都是 8 个差异在个别字段的类型与枚举取值见第 2/3 节。下表为 v0 基准v1 差异单独标注。#属性名读写数据类型默认值Short name说明1logical_namestaticoctet-string—x对象实例名OBIS2operatordyn.visible-string—x 0x08运营商名称3statusdyn.enum (0–255)0x 0x10注册状态4cs_attachmentdyn.enum (0–255)0x 0x18电路交换状态5ps_statusdyn.enum (0–255)0x 0x20分组交换状态6cell_infodyn.cell_info_type—x 0x30当前小区信息7adjacent_cellsdyn.array—x 0x38邻区列表8capture_timedyn.date-time—x 0x40采集时刻没有方法Specific methods 栏为空。注除logical_name为 static其余 7 个都是 dyn.动态由模组实时更新。Short name 偏移 v0/v1 相同。2. 属性逐条拆解2.1operator蓝皮书原文“Holds the name of the network operator e.g. ‘YourNetOp’”运营商显示名如China Mobile。纯字符串。2.2status注册状态蓝皮书原文(0) not registered, (1) registered, home network, (2) not registered, but MT is currently searching a new operator to register to, (3) registration denied, (4) unknown, (5) registered, roaming, (6) … (255) reserved值含义0未注册1已注册归属网络home2未注册正在搜索运营商3注册被拒4未知5已注册漫游roaming6–255保留排查口诀status0/2说明没注上网搜网/无卡/信号差status3是被运营商拒绝SIM/签约问题status5漫游注意流量资费。2.3cs_attachment电路交换状态蓝皮书原文(0) inactive, (1) incoming call, (2) active, (3) … (255) reserved值含义0非激活1来电中2活跃通话中3–255保留电表一般用不到语音此字段多为 0但做来电触发回拨见第 25 篇Auto answerclass_id 28时会变 1/2。2.4ps_status分组交换状态v0 vs v1 不同v0蓝皮书原文v0(0) inactive, (1) GPRS, (2) EDGE, (3) UMTS, (4) HSDPA, (5) … (255) reservedv1新增 LTE / CDMA蓝皮书原文v1(0) inactive, (1) GPRS, (2) EDGE, (3) UMTS, (4) HSDPA, (5) LTE, (6) CDMA, (7)…(255) reserved值v0 含义v1 含义0非激活非激活1GPRSGPRS2EDGEEDGE3UMTSUMTS4HSDPAHSDPA5保留LTE6保留CDMA7–255保留保留⚠️ 版本差异重点v0 的 5/6 是保留v1 的 5LTE、6CDMA。读ps_status5时要先看对象版本——v0 下它没意义v1 下它是已附着 LTE。2.5cell_info当前小区信息v0 vs v1 结构不同v0cell_info_type :: structure { cell_ID: long-unsigned, // 2 字节小区 IDhex location_ID: long-unsigned, // 2 字节 LAChex signal_quality: unsigned, ber: unsigned }v1扩展为 7 字段cell_info_type :: structure { cell_ID: double-long-unsigned, // 4 字节小区 IDhex location_ID: long-unsigned, // 2 字节 LAC/GSM 或 TAC/UMTS/CDMA/LTEhex signal_quality: unsigned, ber: unsigned, mcc: long-unsigned, // 新增Mobile Country Code mnc: long-unsigned, // 新增Mobile Network Code channel_number: double-long-unsigned // 新增ARFCN / eaRFCN(LTE) }关键字段语义cell_IDv0 是两字节hexv1 是四字节hex。location_IDv0 称 LACv1 明确GSM 下是 LACUMTS/CDMA/LTE 下是 TAC。蓝皮书原例00C3 195十进制。signal_quality信号质量映射蓝皮书原文(0) –113 dBm or less, (1) –111 dBm, (2…30) –109…–53 dBm, (31) –51 or greater, (99) not known or not detectableber误码率蓝皮书原文(0–7) as RXQUAL_n values specified in ETSI GSM 05.08:1996, 8.2.4. (99) not known or not detectablev1 新增mcc/mnc服务网络的移动国家码/移动网络码。v1 新增channel_number绝对射频信道号ARFCNLTE 下为 eaRFCN。2.6adjacent_cells邻区列表v0adjacent_cells :: array adjacent_cell_info adjacent_cell_info :: structure { cell_ID: long-unsigned, signal_quality: unsigned }v1cell_ID升为double-long-unsigned四字节signal_quality同前。用途看邻区信号判断是否该切到更强的小区——弱覆盖诊断利器。2.7capture_time蓝皮书原文“Holds the date and time when the data have been last captured. date-time is formatted as specified in 4.6.1.”即最近一次采集时刻按第 4.6.1 节的date-time格式12 字节见第 4 篇Extended register的capture_time拆解。3. 方法无Specific methods 栏为空。本类是只读诊断属性由模组自动更新没有 action。4. 实战举例示例 1正常附着 GPRS 的快照属性值v0 设备示例operatorChina Mobilestatus1homecs_attachment0ps_status1GPRScell_info{cell_ID0x0A1B, location_ID0x00C3, signal_quality22, ber1}adjacent_cells[{0x0A1C, 18}, {0x0A1D, 12}]capture_time2026-04-01 10:30:00示例为工程示意非蓝皮书原文signal_quality22 对应约 -67 dBm在 -53…-109 区间按公式 22→-1092*(22-2)-10940-69 附近具体映射依原文分段。示例 2搜网失败的故障快照status2searching、ps_status0inactive、signal_quality0≤-113 dBm、operator—— 典型地下室/无覆盖/SIM 接触不良。依枚举语义工程示意。示例 3v1 设备的 LTE 快照含 mcc/mnc/信道ps_status5LTE、cell_info{cell_ID0x000A1B2C, location_ID0x00C3, signal_quality28, ber2, mcc460, mnc0, channel_number0x0832}—— mcc460 是中国、mnc0 是移动、channel 0x08322098 是某 LTE 频点。依 v1 结构工程示意。示例 4与Profile generic(7) 联动做信号曲线按蓝皮书提示建一个Profile genericcapture_objects选本对象的signal_quality/status/ps_statuscapture_period设 900 秒即可自动记录一天内信号质量变化曲线定位间歇性掉线。联动为工程示意非蓝皮书原文强调蓝皮书原文已明确可用 Profile generic 捕获本对象属性。示例 5SN 短名读取base namexstatusx0x10ps_statusx0x20cell_infox0x30capture_timex0x40。工程示意。示例 6A-XDR 读statusenum (tag [16]0x10) 0x01 // status registered, home工程示意。示例 7v0 vs v1cell_ID字节长度差异v0cell_info.cell_ID是long-unsigned2 字节v1 是double-long-unsigned4 字节。解析代码必须按对象版本分支否则把 v1 的 4 字节当 2 字节读会错位整个结构。依原文类型差异。示例 8注册被拒status3排查清单SIM 是否插好/是否欠费status3 registration denied是否在该运营商覆盖区结合signal_qualityAPN/认证是否在PPP setup(44)/第 24 篇Modem configuration(27) 配对设备是否被加黑结合第 31 篇Auto answer白名单/GAO。排查逻辑为工程示意非蓝皮书原文。示例 9完整诊断排查流程以下为工程示意、非蓝皮书原文依本类枚举语义串成排查树。读 GSM diagnostic(47) ├─ status 0/2 ? 未注册/搜网 → 查 SIM、覆盖(signal_quality)、APN(44/27) ├─ status 3 ? 注册被拒 → 查 SIM 签约、白名单(28/GAO) ├─ status 5 ? 漫游 → 注意资费 ├─ ps_status 0 ? 未附着数据 → 查 PPP/IPCP 认证 ├─ ps_status 5(LTE, 仅 v1) ? 已上 4G ├─ signal_quality 偏低(0~10) ? 弱覆盖 → 看 adjacent_cells 找更强小区 └─ capture_time 过旧 ? 模组未刷新 → 查模组电源/AT 通道示例 10v0 → v1 迁移核对清单以下为工程示意、非蓝皮书原文依据第 2.4/2.5 节的 v1 扩展。项v0v1迁移动作ps_status5/6保留LTE / CDMA解析程序加分支cell_info.cell_ID2 字节4 字节改读double-long-unsignedcell_info字段数47增 mcc/mnc/channel结构体重定义adjacent_cells[].cell_ID2 字节4 字节解析分支网络类型覆盖GSM/GPRS/UMTSCDMA/LTE枚举映射补全5. 工程上容易踩的坑ps_status5的含义看版本v0 是保留v1 是LTE——不确认版本会误判。cell_ID字节数看版本v0 两字节、v1 四字节解析必须分支否则结构错位。location_ID在 v1 可能是 TACGSM 叫 LAC、UMTS/CDMA/LTE 叫 TAC同一字段两种语义。全 dynamic、无方法别找 action值由模组实时写SET 无效。signal_quality是离散等级不是 dBm 连续值0–31 加 99要按原文分段换算近似 dBm别当线性 dBm 用。ber用 RXQUAL 等级0–7 99不是百分比连续值。配Profile generic抓历史要设 capture_period否则只抓到单点蓝皮书已明示本对象可被 Profile generic 捕获。v1 才有的 mcc/mnc/channel老解析程序读 v1 对象会漏这三个字段。cs_attachment多数场景为 0别因为它一直是 0 就以为模组坏了——电表通常不用语音。相邻类LTE monitoring(151) 不在本类原文末尾附带了LTE monitoringclass_id 151, v0含lte_quality_of_serviceT3402/T3412/RSRQ/RSRP/qRxlevMin那是另一个类本篇按一个 class 一篇不展开留作后续篇目。6. 小结 下期预告GSM diagnosticclass_id 47是蜂窝模组的体检表8 个属性operator/status/cs_attachment/ps_status/cell_info/adjacent_cells/capture_time全部 dynamic、无方法。v1 相对 v0 的关键扩展是ps_status增加 LTE(5)/CDMA(6)、cell_info与adjacent_cells的cell_ID从 2 字节升 4 字节、并新增mcc/mnc/channel_number。它可被Profile generic(7) 捕获成信号历史曲线。下一篇第 36 篇IPv6 setupclass_id 48—— 把第 30 篇的 IPv4 补齐为双栈IPv6 地址、前缀、网关、DNS 怎么建模。它和MAC address setup(43) 提到的IPv6 配置由 IPv6 setup 提供正好呼应。