test_panel_registration.py 35 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669
  1. """线架注册模型(80/81 口径:保活/两级绑定/换架接管/冲突防抢占)单元测试。
  2. 图解口径(严格):
  3. - 已绑定地址: 0x80 保活带绑定 UID -> 收到匹配 81 才在线
  4. - 连续 PANEL_KEEPALIVE_MISS_LIMIT(=2) 次无匹配 81 -> 离线并停止 0x03 读卡
  5. - 重新上线/换机/新注册: 先经 0x10 重下绑定②,再恢复读卡
  6. - 同址不同 UID: 原机在线=冲突不替换;原机离线=自动换架接管
  7. - 未绑定地址: 全 0 的 0x80 探测 -> 收到 81 本地建立绑定①(不发 82/83)
  8. """
  9. import sys
  10. import os
  11. import time
  12. from unittest.mock import patch
  13. import pytest
  14. sys.path.append(os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
  15. import app as app_module # noqa: E402
  16. from app import app # noqa: E402
  17. def make_cards(port_map):
  18. """构造 24 路读卡结果;port_map: {port_id: 'hex12'}"""
  19. cards = []
  20. for ant in range(1, 25):
  21. hex_str = (port_map.get(ant) or '').lower()
  22. cards.append({
  23. 'antenna': ant,
  24. 'card_str': hex_str,
  25. 'present': bool(hex_str),
  26. 'uid': '' if not hex_str else ':'.join(hex_str[i:i + 2] for i in range(0, 12, 2)),
  27. })
  28. return cards
  29. def read_result(cards, addr=1):
  30. """V5 批量读结果(不再包含 panel_uid)。"""
  31. return {
  32. 'success': True, 'device_address': addr, 'function_code': 3,
  33. 'cards': cards, 'raw_data': 'TEST',
  34. }
  35. class TestPanelRegistration:
  36. def setup_method(self):
  37. self._saved = {
  38. 'stored': dict(app_module.address_config.stored_devices),
  39. 'panel_config': dict(app_module.panel_config),
  40. 'port_state': dict(app_module.port_state),
  41. 'ka_miss': dict(app_module.panel_keepalive_miss),
  42. 'synced': set(app_module.panel_mappings_synced),
  43. 'conflict': dict(app_module.panel_conflict),
  44. 'address_range': app_module.dtu_config.get('address_range'),
  45. 'port_mappings': app_module.dtu_config.get('port_mappings'),
  46. 'last_seen': dict(app_module.device_last_seen),
  47. 'config_addr': dict(app_module._panel_config_addr_state),
  48. 'read_fallback': app_module.PANEL_READ_FALLBACK_KEEPALIVE,
  49. }
  50. self.mock_modbus = patch.object(app_module, 'modbus_client').start()
  51. self.mock_save_dev = patch.object(app_module, 'save_device_config').start()
  52. self.mock_save_dtu = patch.object(app_module, 'save_dtu_config').start()
  53. self.mock_register = patch.object(app_module, 'dtu_register').start()
  54. self.mock_panel_status = patch.object(app_module, 'dtu_publish_panel_status').start()
  55. # 读卡默认无卡;写卡默认成功(82/83 已废弃,自动流程不再调用 confirm_address)
  56. self.mock_modbus.read_all_antenna_cards.return_value = read_result(make_cards({}))
  57. self.mock_modbus.set_card_mapping.return_value = {'success': True}
  58. app_module.address_config.stored_devices.clear()
  59. app_module.panel_config.clear()
  60. app_module.port_state.clear()
  61. app_module.panel_keepalive_miss.clear()
  62. app_module.panel_mappings_synced.clear()
  63. app_module.panel_conflict.clear()
  64. app_module.device_last_seen.clear()
  65. app_module._panel_config_addr_state.update(
  66. {'pending_address': None, 'pending_until': None})
  67. def teardown_method(self):
  68. patch.stopall()
  69. app_module.address_config.stored_devices.clear()
  70. app_module.address_config.stored_devices.update(self._saved['stored'])
  71. app_module.panel_config.clear()
  72. app_module.panel_config.update(self._saved['panel_config'])
  73. app_module.port_state.clear()
  74. app_module.port_state.update(self._saved['port_state'])
  75. app_module.panel_keepalive_miss.clear()
  76. app_module.panel_keepalive_miss.update(self._saved['ka_miss'])
  77. app_module.panel_mappings_synced.clear()
  78. app_module.panel_mappings_synced.update(self._saved['synced'])
  79. app_module.panel_conflict.clear()
  80. app_module.panel_conflict.update(self._saved['conflict'])
  81. app_module.device_last_seen.clear()
  82. app_module.device_last_seen.update(self._saved['last_seen'])
  83. app_module._panel_config_addr_state.clear()
  84. app_module._panel_config_addr_state.update(self._saved['config_addr'])
  85. if self._saved['address_range'] is None:
  86. app_module.dtu_config.pop('address_range', None)
  87. else:
  88. app_module.dtu_config['address_range'] = self._saved['address_range']
  89. if self._saved['port_mappings'] is None:
  90. app_module.dtu_config.pop('port_mappings', None)
  91. else:
  92. app_module.dtu_config['port_mappings'] = self._saved['port_mappings']
  93. app_module.PANEL_READ_FALLBACK_KEEPALIVE = self._saved['read_fallback']
  94. def _query_map(self, uid_by_addr):
  95. """按地址返回 0x80 查询结果(不在 map 中的地址视为无应答)"""
  96. def fake(addr, uid=None, timeout=None):
  97. value = uid_by_addr.get(addr)
  98. if value is None:
  99. return {'error': 'response timeout or too short', 'raw_data': ''}
  100. return {'success': True, 'device_address': addr, 'uid': value,
  101. 'raw_data': 'TEST'}
  102. self.mock_modbus.query_address.side_effect = fake
  103. def test_takeover_rebinds_uid_and_inherits_mappings(self):
  104. """换架(原机离线): 81 回新 UID -> 重绑地址、保留 panel_id/映射;先 0x10 再读卡,不发 82。"""
  105. old_uid = 'a1' * 12
  106. new_uid = 'b2' * 12
  107. pid = 'PANEL_dtu_001_5'
  108. app_module.dtu_config['address_range'] = {'start': 5, 'end': 5}
  109. app_module.dtu_config['port_mappings'] = {pid: {'3': 'AABBCCDDEEFF'}}
  110. app_module.address_config.stored_devices[old_uid] = 5
  111. app_module.panel_config[pid] = {'address': 5, 'position': 5, 'panel_uid': old_uid, 'status': 'offline'}
  112. app_module.panel_keepalive_miss[pid] = 2
  113. self._query_map({5: new_uid})
  114. self.mock_modbus.read_all_antenna_cards.return_value = read_result(
  115. make_cards({3: 'aabbccddeeff'}), addr=5)
  116. app_module._sweep_panel_addresses()
  117. devices = app_module.address_config.stored_devices
  118. assert devices.get(new_uid) == 5
  119. assert old_uid not in devices
  120. assert app_module.panel_config[pid]['panel_uid'] == new_uid
  121. assert app_module.panel_config[pid]['status'] == 'online'
  122. assert pid not in app_module.panel_keepalive_miss
  123. # 82/83 已废弃:自动接管不得发 confirm_address
  124. assert self.mock_modbus.confirm_address.called is False
  125. # 先 0x10 下发绑定②(继承原面板数据),再读卡
  126. args, _ = self.mock_modbus.set_card_mapping.call_args
  127. assert args[0] == 5
  128. assert args[1].get(3) == 'AABBCCDDEEFF'
  129. assert self.mock_modbus.read_all_antenna_cards.called
  130. assert self.mock_save_dev.called
  131. assert self.mock_register.called
  132. def test_healthy_query_same_uid_reads_cards(self):
  133. """正常轮次: 「地址+绑定 UID」80 -> 匹配 81 -> 0x03 读卡,绑定不变,稳态不再重发 0x10。"""
  134. uid = 'aa' * 12
  135. pid = 'PANEL_dtu_001_6'
  136. app_module.dtu_config['address_range'] = {'start': 6, 'end': 6}
  137. app_module.address_config.stored_devices[uid] = 6
  138. app_module.panel_config[pid] = {'address': 6, 'position': 6, 'panel_uid': uid, 'status': 'online'}
  139. app_module.panel_mappings_synced.add(pid) # 本会话已下发过绑定②
  140. self._query_map({6: uid})
  141. self.mock_modbus.read_all_antenna_cards.return_value = read_result(make_cards({}), addr=6)
  142. app_module._sweep_panel_addresses()
  143. assert app_module.address_config.stored_devices == {uid: 6}
  144. assert self.mock_modbus.confirm_address.called is False
  145. assert self.mock_modbus.set_card_mapping.called is False # 稳态在线不重发 0x10
  146. assert self.mock_modbus.query_address.call_count == 1
  147. query_args, query_kwargs = self.mock_modbus.query_address.call_args
  148. assert query_args[0] == 6
  149. assert query_kwargs.get('uid') == uid
  150. assert self.mock_modbus.read_all_antenna_cards.called
  151. def test_first_online_pushes_mapping_before_read(self):
  152. """服务重启后首次匹配 81(cfg=online 但本会话未同步)-> 先 0x10 再读卡。"""
  153. uid = 'ad' * 12
  154. pid = 'PANEL_dtu_001_9'
  155. app_module.dtu_config['address_range'] = {'start': 9, 'end': 9}
  156. app_module.address_config.stored_devices[uid] = 9
  157. app_module.panel_config[pid] = {'address': 9, 'position': 9, 'panel_uid': uid, 'status': 'online'}
  158. app_module.dtu_config['port_mappings'] = {pid: {'1': '111111111111'}}
  159. self._query_map({9: uid})
  160. self.mock_modbus.read_all_antenna_cards.return_value = read_result(make_cards({}), addr=9)
  161. app_module._sweep_panel_addresses()
  162. # 下发 0x10 与业务读卡都发生
  163. assert self.mock_modbus.set_card_mapping.called
  164. # 顺序:最后一次 set_card_mapping(0x10) 在最后一次业务 read(0x03) 之前
  165. # (_hardware_card_base 取硬件基底的那次 read 不计,它在 set_card_mapping 之前)
  166. names = [c[0] for c in self.mock_modbus.method_calls]
  167. last_set = len(names) - 1 - names[::-1].index('set_card_mapping')
  168. last_read = len(names) - 1 - names[::-1].index('read_all_antenna_cards')
  169. assert last_set > names.index('read_all_antenna_cards')
  170. assert last_set < last_read
  171. def test_one_miss_still_reads_two_miss_offline_stops_read(self):
  172. """严格模式:第1次无81仍读卡并计1;连续第2次无81(读卡也失败)判离线、停止读卡。"""
  173. app_module.PANEL_READ_FALLBACK_KEEPALIVE = False
  174. uid = 'ab' * 12
  175. pid = 'PANEL_dtu_001_7'
  176. app_module.dtu_config['address_range'] = {'start': 7, 'end': 7}
  177. app_module.address_config.stored_devices[uid] = 7
  178. app_module.panel_config[pid] = {'address': 7, 'position': 7, 'panel_uid': uid, 'status': 'online'}
  179. app_module.panel_mappings_synced.add(pid)
  180. self.mock_modbus.query_address.return_value = {
  181. 'error': 'response timeout or too short', 'raw_data': ''}
  182. self.mock_modbus.read_all_antenna_cards.return_value = {'error': 'read timeout'}
  183. # 第 1 次:仍在线,本轮仍读卡,计数=1
  184. app_module._sweep_panel_addresses()
  185. assert app_module.panel_keepalive_miss[pid] == 1
  186. assert app_module.panel_config[pid]['status'] == 'online'
  187. assert self.mock_modbus.read_all_antenna_cards.call_count == 1
  188. # 第 2 次:判离线,停止读卡(读卡调用数不再增加)
  189. app_module._sweep_panel_addresses()
  190. assert app_module.panel_config[pid]['status'] == 'offline'
  191. assert self.mock_modbus.read_all_antenna_cards.call_count == 1
  192. self.mock_panel_status.assert_any_call(pid, 7, None, online=False)
  193. def test_fallback_read_ok_keeps_panel_online_without_81(self):
  194. """兼容模式(默认开):从不回 81,但 0x03 读卡持续成功 -> 始终在线、不累计离线。"""
  195. uid = 'b0' * 12
  196. pid = 'PANEL_dtu_001_20'
  197. app_module.dtu_config['address_range'] = {'start': 20, 'end': 20}
  198. app_module.address_config.stored_devices[uid] = 20
  199. app_module.panel_config[pid] = {'address': 20, 'position': 20, 'panel_uid': uid, 'status': 'online'}
  200. app_module.panel_mappings_synced.add(pid)
  201. assert app_module.PANEL_READ_FALLBACK_KEEPALIVE is True
  202. self.mock_modbus.query_address.return_value = {'error': 'no 81', 'raw_data': ''}
  203. self.mock_modbus.read_all_antenna_cards.return_value = read_result(make_cards({}), addr=20)
  204. for _ in range(4): # 远超 2 次阈值
  205. app_module._sweep_panel_addresses()
  206. assert app_module.panel_config[pid]['status'] == 'online'
  207. assert app_module.panel_keepalive_miss.get(pid, 0) == 0
  208. def test_fallback_read_fail_then_recover_by_read(self):
  209. """兼容模式:读卡也连续失败会判离线;之后读卡恢复即救回在线(先 0x10 再处理)。"""
  210. uid = 'b1' * 12
  211. pid = 'PANEL_dtu_001_21'
  212. app_module.dtu_config['address_range'] = {'start': 21, 'end': 21}
  213. app_module.dtu_config['port_mappings'] = {pid: {'1': 'AAAAAAAAAAAAAAAA'}}
  214. app_module.address_config.stored_devices[uid] = 21
  215. app_module.panel_config[pid] = {'address': 21, 'position': 21, 'panel_uid': uid, 'status': 'online'}
  216. app_module.panel_mappings_synced.add(pid)
  217. self.mock_modbus.query_address.return_value = {'error': 'no 81', 'raw_data': ''}
  218. # 连续 2 轮读卡也失败 -> 离线
  219. self.mock_modbus.read_all_antenna_cards.return_value = {'error': 'read timeout'}
  220. app_module._sweep_panel_addresses()
  221. app_module._sweep_panel_addresses()
  222. assert app_module.panel_config[pid]['status'] == 'offline'
  223. # 第 3 轮:81 仍缺失,但读卡恢复 -> 兼容救回在线
  224. self.mock_modbus.read_all_antenna_cards.return_value = read_result(make_cards({}), addr=21)
  225. app_module._sweep_panel_addresses()
  226. assert app_module.panel_config[pid]['status'] == 'online'
  227. assert app_module.panel_keepalive_miss.get(pid, 0) == 0
  228. # 离线恢复先经 0x10 重下绑定②
  229. assert self.mock_modbus.set_card_mapping.called
  230. def test_offline_keeps_polling_80_but_never_reads(self):
  231. """严格模式:已离线机继续发带 UID 的 80 探测恢复,但在收到匹配 81 前不再读卡。"""
  232. app_module.PANEL_READ_FALLBACK_KEEPALIVE = False
  233. uid = 'ae' * 12
  234. pid = 'PANEL_dtu_001_10'
  235. app_module.dtu_config['address_range'] = {'start': 10, 'end': 10}
  236. app_module.address_config.stored_devices[uid] = 10
  237. app_module.panel_config[pid] = {'address': 10, 'position': 10, 'panel_uid': uid, 'status': 'offline'}
  238. app_module.panel_keepalive_miss[pid] = 2
  239. self.mock_modbus.query_address.return_value = {'error': 'timeout', 'raw_data': ''}
  240. app_module._sweep_panel_addresses()
  241. assert self.mock_modbus.query_address.call_count == 1
  242. assert self.mock_modbus.query_address.call_args.kwargs.get('uid') == uid
  243. assert self.mock_modbus.read_all_antenna_cards.called is False
  244. assert app_module.panel_config[pid]['status'] == 'offline'
  245. def test_recovery_pushes_mapping_then_reads(self):
  246. """离线后重新收到匹配 81 -> 恢复在线;先 0x10 重下绑定②再读卡,查询仍带绑定 UID。"""
  247. uid = 'c3' * 12
  248. pid = 'PANEL_dtu_001_2'
  249. app_module.dtu_config['address_range'] = {'start': 2, 'end': 2}
  250. app_module.dtu_config['port_mappings'] = {pid: {'2': '222222222222'}}
  251. app_module.address_config.stored_devices[uid] = 2
  252. app_module.panel_config[pid] = {'address': 2, 'position': 2, 'panel_uid': uid, 'status': 'offline'}
  253. app_module.panel_keepalive_miss[pid] = 2
  254. self._query_map({2: uid})
  255. self.mock_modbus.read_all_antenna_cards.return_value = read_result(make_cards({}), addr=2)
  256. app_module._sweep_panel_addresses()
  257. assert app_module.address_config.stored_devices == {uid: 2}
  258. assert app_module.panel_config[pid]['status'] == 'online'
  259. assert pid not in app_module.panel_keepalive_miss
  260. assert self.mock_modbus.query_address.call_count == 1
  261. assert self.mock_modbus.query_address.call_args.kwargs.get('uid') == uid
  262. # 重新上线先 0x10 再业务读卡(基底 read 不计)
  263. names = [c[0] for c in self.mock_modbus.method_calls]
  264. last_set = len(names) - 1 - names[::-1].index('set_card_mapping')
  265. last_read = len(names) - 1 - names[::-1].index('read_all_antenna_cards')
  266. assert last_set > names.index('read_all_antenna_cards')
  267. assert last_set < last_read
  268. def test_unbound_probe_registers_new_panel_without_confirm(self):
  269. """未绑定地址全 0 探测收到 81 -> 本地建立绑定①并上线;不发 82,先 0x10 再读卡。"""
  270. new_uid = 'd4' * 12
  271. app_module.dtu_config['address_range'] = {'start': 4, 'end': 4}
  272. self._query_map({4: new_uid})
  273. self.mock_modbus.read_all_antenna_cards.return_value = read_result(make_cards({}), addr=4)
  274. app_module._sweep_panel_addresses()
  275. assert app_module.address_config.stored_devices.get(new_uid) == 4
  276. assert 'PANEL_dtu_001_4' in app_module.panel_config
  277. assert self.mock_modbus.confirm_address.called is False
  278. # 注册时探测用全 0
  279. assert self.mock_modbus.query_address.call_args.kwargs.get('uid') is None
  280. assert self.mock_save_dev.called
  281. def test_offline_panel_still_probes_unbound(self):
  282. """严格模式:即使有绑定线架离线,地址段内未绑定地址仍照常全 0 顺序探测。"""
  283. app_module.PANEL_READ_FALLBACK_KEEPALIVE = False
  284. old_uid = 'e5' * 12
  285. pid = 'PANEL_dtu_001_2'
  286. app_module.dtu_config['address_range'] = {'start': 2, 'end': 3}
  287. app_module.address_config.stored_devices[old_uid] = 2
  288. app_module.panel_config[pid] = {'address': 2, 'position': 2, 'panel_uid': old_uid, 'status': 'offline'}
  289. app_module.panel_keepalive_miss[pid] = 2
  290. self._query_map({}) # 所有地址无应答
  291. self.mock_modbus.read_all_antenna_cards.return_value = {'error': 'timeout'}
  292. app_module._sweep_panel_addresses()
  293. probed = [c.args[0] for c in self.mock_modbus.query_address.call_args_list]
  294. # 绑定地址 2 带 UID 查询,未绑定地址 3 也必须探测(顺序 2、3)
  295. assert probed == [2, 3]
  296. assert self.mock_modbus.query_address.call_args_list[0].kwargs.get('uid') == old_uid
  297. assert self.mock_modbus.query_address.call_args_list[1].kwargs.get('uid') is None
  298. # 离线机不读卡
  299. assert self.mock_modbus.read_all_antenna_cards.called is False
  300. def test_keepalive_miss_limit_marks_offline(self):
  301. """连续 PANEL_KEEPALIVE_MISS_LIMIT 次无匹配 81 -> 离线并发布离线状态。"""
  302. uid = 'f6' * 12
  303. pid = 'PANEL_dtu_001_3'
  304. app_module.dtu_config['address_range'] = {'start': 3, 'end': 3}
  305. app_module.address_config.stored_devices[uid] = 3
  306. app_module.panel_config[pid] = {'address': 3, 'position': 3, 'panel_uid': uid, 'status': 'online'}
  307. app_module.panel_mappings_synced.add(pid)
  308. self.mock_modbus.query_address.return_value = {'error': 'timeout'}
  309. self.mock_modbus.read_all_antenna_cards.return_value = {'error': 'timeout'}
  310. for _ in range(app_module.PANEL_KEEPALIVE_MISS_LIMIT):
  311. app_module._sweep_panel_addresses()
  312. assert app_module.panel_config[pid]['status'] == 'offline'
  313. assert app_module.panel_keepalive_miss[pid] == app_module.PANEL_KEEPALIVE_MISS_LIMIT
  314. self.mock_panel_status.assert_any_call(pid, 3, None, online=False)
  315. def test_conflict_does_not_replace_while_old_online(self):
  316. """原机仍在线(首次探测到不同 UID,原机未离线)-> 冲突:不替换/不下发/不读卡。"""
  317. old_uid = '11' * 12
  318. new_uid = '22' * 12
  319. pid = 'PANEL_dtu_001_11'
  320. app_module.dtu_config['address_range'] = {'start': 11, 'end': 11}
  321. app_module.address_config.stored_devices[old_uid] = 11
  322. app_module.panel_config[pid] = {'address': 11, 'position': 11, 'panel_uid': old_uid, 'status': 'online'}
  323. app_module.dtu_config['port_mappings'] = {pid: {'1': '333333333333'}}
  324. self._query_map({11: new_uid}) # 同地址回了不同 UID,原机计数=0(仍在线)
  325. app_module._sweep_panel_addresses()
  326. # 绑定①不变
  327. assert app_module.address_config.stored_devices.get(old_uid) == 11
  328. assert new_uid not in app_module.address_config.stored_devices
  329. assert app_module.panel_config[pid]['panel_uid'] == old_uid
  330. # 记冲突
  331. assert app_module.panel_conflict.get(pid) == new_uid
  332. # 不下发绑定②、不读卡
  333. assert self.mock_modbus.set_card_mapping.called is False
  334. assert self.mock_modbus.read_all_antenna_cards.called is False
  335. assert app_module.panel_keepalive_miss[pid] == 1
  336. def test_conflict_then_old_offline_triggers_takeover(self):
  337. """冲突中:新 UID 持续应答、原机连续2次无匹配81 -> 第2次离线后立即接管新 UID。"""
  338. old_uid = '44' * 12
  339. new_uid = '55' * 12
  340. pid = 'PANEL_dtu_001_12'
  341. app_module.dtu_config['address_range'] = {'start': 12, 'end': 12}
  342. app_module.address_config.stored_devices[old_uid] = 12
  343. app_module.panel_config[pid] = {'address': 12, 'position': 12, 'panel_uid': old_uid, 'status': 'online'}
  344. app_module.dtu_config['port_mappings'] = {pid: {'1': '666666666666'}}
  345. self._query_map({12: new_uid})
  346. self.mock_modbus.read_all_antenna_cards.return_value = read_result(make_cards({}), addr=12)
  347. app_module._sweep_panel_addresses() # 第1次:冲突,原机 miss=1
  348. assert app_module.panel_config[pid]['panel_uid'] == old_uid
  349. app_module._sweep_panel_addresses() # 第2次:原机离线 -> 接管新 UID
  350. assert app_module.address_config.stored_devices.get(new_uid) == 12
  351. assert old_uid not in app_module.address_config.stored_devices
  352. assert app_module.panel_config[pid]['panel_uid'] == new_uid
  353. assert app_module.panel_config[pid]['status'] == 'online'
  354. assert pid not in app_module.panel_conflict
  355. assert self.mock_modbus.set_card_mapping.called # 接管先 0x10
  356. def test_pending_config_address_probed_even_when_offline(self):
  357. """配置地址后的新地址优先全 0 探测(即使有其他绑定线架离线)。"""
  358. old_uid = 'e6' * 12
  359. new_uid = 'f7' * 12
  360. pid = 'PANEL_dtu_001_2'
  361. app_module.dtu_config['address_range'] = {'start': 2, 'end': 8}
  362. app_module.address_config.stored_devices[old_uid] = 2
  363. app_module.panel_config[pid] = {'address': 2, 'position': 2, 'panel_uid': old_uid, 'status': 'offline'}
  364. app_module.panel_keepalive_miss[pid] = 2
  365. app_module._panel_config_addr_state['pending_address'] = 8
  366. app_module._panel_config_addr_state['pending_until'] = time.time() + 60
  367. self._query_map({8: new_uid})
  368. self.mock_modbus.read_all_antenna_cards.return_value = read_result(make_cards({}), addr=8)
  369. app_module._sweep_panel_addresses()
  370. assert app_module.address_config.stored_devices.get(new_uid) == 8
  371. assert app_module._panel_config_addr_state['pending_address'] is None
  372. def test_panel_unbind_api(self):
  373. """解绑 API: 移除绑定与面板配置。"""
  374. client = app.test_client()
  375. uid = '99' * 12
  376. pid = 'PANEL_dtu_001_7'
  377. app_module.address_config.stored_devices[uid] = 7
  378. app_module.panel_config[pid] = {'address': 7, 'position': 7, 'panel_uid': uid, 'status': 'online'}
  379. resp = client.post('/api/panel/unbind', json={'address': 7})
  380. data = resp.get_json()
  381. assert resp.status_code == 200 and data['success']
  382. assert uid not in app_module.address_config.stored_devices
  383. assert pid not in app_module.panel_config
  384. assert self.mock_save_dev.called
  385. def test_query_address_api(self):
  386. """V5 查询 API: 返回线架 UID 与原始帧。"""
  387. client = app.test_client()
  388. self.mock_modbus.query_address.return_value = {
  389. 'success': True, 'device_address': 5, 'uid': 'aa' * 12, 'raw_data': 'TEST'}
  390. with patch.object(app_module, '_serial_connected', return_value=True):
  391. resp = client.post('/api/modbus/query_address', json={'address': 5})
  392. data = resp.get_json()
  393. assert resp.status_code == 200
  394. assert data['success'] is True
  395. assert data['uid'] == 'aa' * 12
  396. assert self.mock_modbus.query_address.call_args[0][0] == 5
  397. def test_confirm_address_api_bind(self):
  398. """V5 确认 API: bind=true 时同时写入本地绑定表。"""
  399. client = app.test_client()
  400. uid = 'ab' * 12
  401. self.mock_modbus.confirm_address.return_value = {'success': True, 'uid': uid, 'raw_data': 'TEST'}
  402. with patch.object(app_module, '_serial_connected', return_value=True):
  403. resp = client.post('/api/modbus/confirm_address',
  404. json={'address': 6, 'uid': uid, 'bind': True})
  405. data = resp.get_json()
  406. assert resp.status_code == 200 and data['success'] is True
  407. assert app_module.address_config.stored_devices.get(uid) == 6
  408. assert self.mock_save_dev.called
  409. def test_config_address_api_requires_serial(self):
  410. """串口未连接时配置地址接口返回 400。"""
  411. client = app.test_client()
  412. with patch.object(app_module, '_serial_connected', return_value=False):
  413. resp = client.post('/api/panel/config_address', json={})
  414. assert resp.status_code == 400
  415. assert resp.get_json()['success'] is False
  416. def test_config_address_status_api(self):
  417. client = app.test_client()
  418. resp = client.get('/api/panel/config_address_status')
  419. data = resp.get_json()
  420. assert resp.status_code == 200 and data['success'] is True
  421. assert 'config' in data
  422. def test_update_dtu_config_address_range(self):
  423. """DTU 配置 API: 地址段写入并校验。"""
  424. client = app.test_client()
  425. resp = client.post('/api/dtu/config', json={'address_range': {'start': 5, 'end': 60}})
  426. assert resp.status_code == 200
  427. assert app_module.dtu_config['address_range'] == {'start': 5, 'end': 60}
  428. assert self.mock_save_dtu.called
  429. resp = client.post('/api/dtu/config', json={'address_range': {'start': 70, 'end': 10}})
  430. assert resp.status_code == 400
  431. assert app_module.dtu_config['address_range'] == {'start': 5, 'end': 60}
  432. def test_address_range_fallback(self):
  433. app_module.dtu_config['address_range'] = {'start': 60, 'end': 10}
  434. assert app_module._address_range() == (1, 50)
  435. app_module.dtu_config['address_range'] = {'start': 3, 'end': 9}
  436. assert app_module._address_range() == (3, 9)
  437. app_module.dtu_config['address_range'] = None
  438. assert app_module._address_range() == (1, 50)
  439. def test_single_port_write_persists_only_target_port(self):
  440. """单端口写卡:硬件帧带全 24 口,但配置只落目标这一条(修复映射污染)。"""
  441. client = app.test_client()
  442. pid = 'PANEL_dtu_001_8'
  443. app_module.panel_config[pid] = {'address': 8, 'position': 8,
  444. 'panel_uid': 'cc' * 12, 'status': 'online'}
  445. app_module.dtu_config['port_mappings'] = {}
  446. # 硬件基底:4/22/23 口插着卡(这些只应出现在下发帧,不应落盘)
  447. self.mock_modbus.read_all_antenna_cards.return_value = read_result(
  448. make_cards({4: '04' * 6, 22: '16' * 6, 23: '17' * 6}), addr=8)
  449. # set_card_mapping 回 24 路 cards_written(模拟真实实现)
  450. written = {p: None for p in range(1, 25)}
  451. written[1] = 'aabbccddeeff'
  452. written[4] = '040404040404'
  453. written[22] = '161616161616'
  454. written[23] = '171717171717'
  455. self.mock_modbus.set_card_mapping.return_value = {
  456. 'success': True, 'device_address': 8, 'cards_written': written, 'raw_data': 'T'}
  457. with patch.object(app_module.serial_client, 'get_status', return_value={'connected': True}):
  458. resp = client.post('/api/modbus/set_card_mapping',
  459. json={'device_address': 8, 'port_id': 1,
  460. 'card_uid': 'AABBCCDDEEFF'})
  461. assert resp.status_code == 200 and resp.get_json()['success']
  462. saved = app_module.dtu_config['port_mappings'][pid]
  463. # 只落目标 1 口;硬件基底里的 4/22/23 不得被灌进配置,也不得出现 null
  464. assert saved == {'1': 'AABBCCDDEEFF'}
  465. # 下发帧仍带全部端口(目标口是新卡号,其它保留硬件读回值)
  466. args, _ = self.mock_modbus.set_card_mapping.call_args
  467. assert args[1][1] == 'AABBCCDDEEFF'
  468. assert args[1][4] == '040404040404'
  469. assert self.mock_save_dtu.called
  470. def test_single_port_clear_deletes_mapping_key(self):
  471. """单端口清除:删除该端口配置键(不写 null),硬件帧目标口发 None。"""
  472. client = app.test_client()
  473. pid = 'PANEL_dtu_001_8'
  474. app_module.panel_config[pid] = {'address': 8, 'position': 8,
  475. 'panel_uid': 'cc' * 12, 'status': 'online'}
  476. app_module.dtu_config['port_mappings'] = {pid: {'1': 'AABBCCDDEEFF', '2': '222222222222'}}
  477. self.mock_modbus.read_all_antenna_cards.return_value = read_result(make_cards({}), addr=8)
  478. self.mock_modbus.set_card_mapping.return_value = {
  479. 'success': True, 'device_address': 8,
  480. 'cards_written': {p: None for p in range(1, 25)}, 'raw_data': 'T'}
  481. with patch.object(app_module.serial_client, 'get_status', return_value={'connected': True}):
  482. resp = client.post('/api/modbus/set_card_mapping',
  483. json={'device_address': 8, 'port_id': 1, 'card_uid': None})
  484. assert resp.status_code == 200 and resp.get_json()['success']
  485. saved = app_module.dtu_config['port_mappings'][pid]
  486. assert '1' not in saved and saved.get('2') == '222222222222'
  487. args, _ = self.mock_modbus.set_card_mapping.call_args
  488. assert args[1][1] is None # 硬件目标口清成 0xFF
  489. def test_prune_null_port_mappings(self):
  490. """启动清理:删除 null/空端口,保留有效卡号;面板清空后整组移除。"""
  491. app_module.dtu_config['port_mappings'] = {
  492. 'PANEL_dtu_001_1': {'1': 'AABBCCDDEEFF', '5': None, '10': ''},
  493. 'PANEL_dtu_001_4': {str(i): None for i in range(1, 24)} | {'24': 'DDAD57F95002'},
  494. 'PANEL_dtu_001_9': {'1': None, '2': None},
  495. }
  496. removed = app_module._prune_null_port_mappings()
  497. pm = app_module.dtu_config['port_mappings']
  498. assert removed == 27 # 2(面板1)+ 23(面板4 的 1..23)+ 2(面板9)
  499. assert pm['PANEL_dtu_001_1'] == {'1': 'AABBCCDDEEFF'}
  500. assert pm['PANEL_dtu_001_4'] == {'24': 'DDAD57F95002'}
  501. assert 'PANEL_dtu_001_9' not in pm
  502. def test_clear_panel_mappings_api(self):
  503. """清空面板映射 API:删配置+在线时硬件 24 口清成 None,不影响绑定①。"""
  504. client = app.test_client()
  505. uid = '77' * 12
  506. pid = 'PANEL_dtu_001_7'
  507. app_module.address_config.stored_devices[uid] = 7
  508. app_module.panel_config[pid] = {'address': 7, 'position': 7,
  509. 'panel_uid': uid, 'status': 'online'}
  510. app_module.dtu_config['port_mappings'] = {pid: {'1': '111111111111', '3': '222222222222'}}
  511. self.mock_modbus.set_card_mapping.return_value = {'success': True}
  512. with patch.object(app_module.serial_client, 'get_status', return_value={'connected': True}):
  513. resp = client.post('/api/panel/clear_mappings', json={'address': 7})
  514. data = resp.get_json()
  515. assert resp.status_code == 200 and data['success']
  516. assert data['removed'] == 2
  517. assert pid not in app_module.dtu_config['port_mappings']
  518. # 绑定①保留
  519. assert app_module.address_config.stored_devices.get(uid) == 7
  520. # 硬件整帧清空
  521. args, _ = self.mock_modbus.set_card_mapping.call_args
  522. assert args[0] == 7 and all(v is None for v in args[1].values())
  523. def test_mapping_upsert_and_delete_api(self):
  524. """映射管理:新增落单口并在线下发;删除移除键且硬件目标口 None。"""
  525. client = app.test_client()
  526. uid = '88' * 12
  527. pid = 'PANEL_dtu_001_6'
  528. app_module.address_config.stored_devices[uid] = 6
  529. app_module.panel_config[pid] = {'address': 6, 'position': 6,
  530. 'panel_uid': uid, 'status': 'online'}
  531. app_module.dtu_config['port_mappings'] = {}
  532. self.mock_modbus.read_all_antenna_cards.return_value = read_result(make_cards({}), addr=6)
  533. self.mock_modbus.set_card_mapping.return_value = {'success': True}
  534. serial_ok = patch.object(app_module.serial_client, 'get_status',
  535. return_value={'connected': True})
  536. serial_ok.start()
  537. try:
  538. # 新增端口 3
  539. resp = client.post('/api/panel/mapping',
  540. json={'address': 6, 'port': 3, 'card_uid': 'aabbccddeeff'})
  541. d = resp.get_json()
  542. assert resp.status_code == 200 and d['success'] and d['action'] == 'set'
  543. assert app_module.dtu_config['port_mappings'][pid] == {'3': 'AABBCCDDEEFF'}
  544. # 下发帧目标口为新卡号(规范化大写)
  545. args, _ = self.mock_modbus.set_card_mapping.call_args
  546. assert args[1][3] == 'AABBCCDDEEFF'
  547. # 非法卡号被拒
  548. bad = client.post('/api/panel/mapping',
  549. json={'address': 6, 'port': 4, 'card_uid': 'zz'})
  550. assert bad.status_code == 400
  551. # 删除端口 3
  552. resp = client.post('/api/panel/mapping',
  553. json={'address': 6, 'port': 3, 'card_uid': None})
  554. d = resp.get_json()
  555. assert resp.status_code == 200 and d['action'] == 'delete'
  556. assert '3' not in app_module.dtu_config['port_mappings'].get(pid, {})
  557. args, _ = self.mock_modbus.set_card_mapping.call_args
  558. assert args[1][3] is None
  559. finally:
  560. serial_ok.stop()
  561. def test_mappings_list_includes_unbound_residual(self):
  562. """映射列表:包含已注册面板和有残留映射的未注册面板。"""
  563. client = app.test_client()
  564. uid = '5a' * 12
  565. pid1 = 'PANEL_dtu_001_2'
  566. app_module.address_config.stored_devices[uid] = 2
  567. app_module.panel_config[pid1] = {'address': 2, 'position': 2,
  568. 'panel_uid': uid, 'status': 'online'}
  569. app_module.dtu_config['port_mappings'] = {
  570. pid1: {'1': '111111111111'},
  571. 'PANEL_dtu_001_9': {'5': '555555555555', '7': None},
  572. }
  573. resp = client.get('/api/panel/mappings')
  574. d = resp.get_json()
  575. assert resp.status_code == 200 and d['success']
  576. by_id = {g['panel_id']: g for g in d['panels']}
  577. assert by_id[pid1]['registered'] is True
  578. assert by_id[pid1]['mappings'] == [{'port': 1, 'uid': '111111111111'}]
  579. g9 = by_id['PANEL_dtu_001_9']
  580. assert g9['registered'] is False and g9['address'] == 9
  581. # null 条目在列表里归一为 None(仍可见,便于清理)
  582. assert {m['port']: m['uid'] for m in g9['mappings']} == {5: '555555555555', 7: None}
  583. if __name__ == '__main__':
  584. pytest.main([__file__, '-v'])