Repository navigation
v1.5.2
v1.5.2 —— 补上 ontweb 光口参数种子,收光盲区不再静默
两处一起修,因为它们是同一个盲区的两半。有一条迁移(补 4 条别名规则),
升级即换二进制,无需改配置。
1. 种子缺了 ontweb 通道那一族参数 —— 只影响新装机器
别名种子(迁移 #6)是照 TR-069 通道在真机上对出来的:
X_CU_WANEdgeONTPONInterfaceConfig.OpticalTransceiver.*(光模块寄存器原始值)X_GponInterafceConfig.*(同一台设备的整数近似值)
而 ontweb 通道(光猫 Web 普通账号)把光口信息页的读数写成 TR-098 形状的
InternetGatewayDevice.LANDevice.1.X_HW_LANOpticInterfaceConfig.1.* ——
那一族一条规则都没有。
后果:新装的机器纳管华为 V271-20 走 Web 通道时,收/发光/温度/电压/偏流在
参数驱动的视图(概览页、清单页)里全认不出来,只剩 optical_history 兜底。
现网那台机器的 14 条别名里有 4 条是手工补的 —— 所以只有新装机器受影响,
这类问题天然难被发现(现网是好的,新装的是坏的)。
新增迁移 #19 补齐这 4 条,换算已在现网逐条核对:
| 参数 | 原始值 | decode | 换算 |
|---|---|---|---|
TransceiverPower |
7499 | dbm_01uw |
−1.24997 dBm |
SupplyVoltage |
31450 | mv01 |
3.145 V |
TransceiverTemperature |
13056 | div256 |
51.0 ℃ |
BiasCurrent |
9500 | ua2 |
19.0 mA |
用 INSERT OR IGNORE + 表上的 UNIQUE(field, match_contains, match_suffix) 去重,
老库(已手工补过)不会插出重复行——迁移幂等,有测试钉住。
刻意不加 rx_power 规则:华为 V271-20 的 UserOpticInfo 只给 TX/电压/温度/
偏流四个原始值,固件不提供上行收光。加一条永远命不中的规则,只会让人以为
「配了就能读到」——这正是下面第 2 条要根治的毛病。
2. 收光读不到时不再「静默」
原来「读不到收光」和「收光正常」在界面上长得一样:概览页/清单页一个裸 -,
详情页整块趋势图悄悄消失。人只会读成「收光正常」。
而收光过低告警(rx_low)在这种情况下永远不会触发,却没有任何提示 ——
典型的静默盲区:功能看起来在工作,实际是瞎的。
现在把三件事分开:
| 情况 | 界面 |
|---|---|
| 收光有值 | 正常显示 |
| 认得出 TX、认不到任何 Rx 参数,历史里从未出现过收光 | 显式显示「本采集通道不提供收光功率读数」,并说明收光过低告警不会触发 |
| 两个方向都没有 | 仍是 -(那才是「这轮没采到」) |
判据落在 HostOptical.RxUnavailable(),概览页、清单页、详情页三处统一。
这个盲区能不能消掉:这台光猫做不到。收光要靠 TR-069 纳管读 RXPower,
而普通账号拿不到(这也是为什么默认走 ontweb 通道)。想要收光告警,得让设备
接受 CWMP 纳管(需要运营商超管权限配 ACS URL)。现在至少它是可见的,
而不是看起来一切正常。
验收
新增 6 个用例:判据三态、历史里出现过收光就不算能力缺失、种子覆盖、不加假
rx_power 规则、迁移幂等、以及一条端到端(详情页必须出现那句说明)。
全仓库测试通过、全量 -race 通过、GenieACS 官方模拟器互通性 8/8。
升级提示
换二进制即可,无需改配置。迁移 #19 自动执行,对已手工补过规则的老库无副作用。