Skip to content

v1.5.2

Choose a tag to compare

@github-actions github-actions released this 17 Oct 15:39
· 4 commits to main since this release

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 自动执行,对已手工补过规则的老库无副作用。