"""V5 协议 (modbus_rtu) 单元测试。 V5 (20261023) 相对 V4 的变化: 1. 取消广播发现/自动分配地址,地址由配置卡写入线架。 2. 地址查询握手(16 字节): 0x80 查询: [add][0x80][12 字节 UID][CRC_L][CRC_H] - 已绑定地址 -> 携带绑定 UID;未绑定地址 -> 12 字节全 0 0x81 应答: [add][0x81][12 字节 UID][CRC_L][CRC_H](线架自身 UID) 0x82 确认: [add][0x82][12 字节 UID][CRC_L][CRC_H] 0x83 应答: [add][0x83][12 字节 UID][CRC_L][CRC_H] 3. 批量读卡回归标准 MODBUS 0x03(帧内不再带 UID): 请求 8B: [add][0x03][0x00][0x02][0x00][0x48][CRC_L][CRC_H] 响应 149B: [add][0x03][0x90][144 数据字节][CRC_L][CRC_H] 每张卡 6 字节;无卡标记 = FF FF FF FF FF FF 4. 配置地址状态: 发送 AA B7 00 07 80 00 00 FF 00 00 02 64 03, 应答 55 00 00 02 [ANTLIST] [ADDR] [XOR] 03。 注: 过渡期兼容 V4 旧固件 161B 批量读响应(尾部多 12 字节 UID,UID 忽略)。 """ import sys import os from unittest.mock import MagicMock import pytest sys.path.append(os.path.dirname(os.path.dirname(os.path.abspath(__file__)))) from modules.modbus_rtu import ( # noqa: E402 ModbusRTUClient, calculate_crc16, verify_crc16, build_read_cards_request, build_address_query_request, parse_address_query_response, build_address_confirm_request, parse_address_confirm_response, build_config_address_enter_frame, parse_config_address_response, CARD_REG_ADDR, CARD_REG_QUANTITY, CARD_DATA_BYTES, ANTENNA_COUNT, NO_TAG_BYTES, BULK_RESPONSE_LEN, BULK_REQUEST_LEN, BULK_BYTE_COUNT, ADDRESS_FRAME_LEN, ZERO_UID, CONFIG_ADDRESS_ENTER_FRAME, ANTENNA_ADDRESSES, ) # 协议文档示例 UID: 51 00 12 00 11 00 00 4C 30 31 33 56 PANEL_UID = bytes.fromhex('510012001100004c30313356') PANEL_UID_HEX = PANEL_UID.hex() # 文档示例帧 DOC_QUERY_ZERO = bytes.fromhex('0180' + '00' * 12 + '5401') DOC_QUERY_RESP = bytes.fromhex('0181510012001100004c30313356d0d3') DOC_CONFIRM_REQ = bytes.fromhex('0182510012001100004c30313356d510') DOC_CONFIRM_RESP = bytes.fromhex('0183510012001100004c30313356d791') DOC_READ_REQ = bytes.fromhex('010300020048e43c') DOC_CONFIG_ENTER = bytes.fromhex('aab70007800000ff0000026403') def build_bulk_response(addr: int, tag_data: bytes) -> bytes: """构造合法的 149 字节 V5 批量读响应帧。""" assert len(tag_data) == CARD_DATA_BYTES, f"tag_data 必须 {CARD_DATA_BYTES} 字节" frame = bytes([addr, 0x03, BULK_BYTE_COUNT]) + tag_data return frame + calculate_crc16(frame) def build_legacy_uid_bulk_response(addr: int, tag_data: bytes, uid: bytes = PANEL_UID) -> bytes: """构造 V4 旧固件 161 字节响应帧(尾部多 12 字节 UID)。""" assert len(tag_data) == CARD_DATA_BYTES assert len(uid) == 12 frame = bytes([addr, 0x03, BULK_BYTE_COUNT]) + tag_data + uid return frame + calculate_crc16(frame) def build_exception_response(addr: int, function_code: int, exception_code: int) -> bytes: """构造 Modbus 异常响应帧 (5 字节)。""" frame = bytes([addr, function_code | 0x80, exception_code]) return frame + calculate_crc16(frame) def build_config_response(antenna: int, addr: int, prefix: bytes = b'', suffix: bytes = b'') -> bytes: """构造配置卡应答帧 55 00 00 02 ANTLIST ADDR XOR 03。""" head = bytes([0x55, 0x00, 0x00, 0x02, antenna, addr]) xor = 0 for b in head: xor ^= b return prefix + head + bytes([xor, 0x03]) + suffix class TestAddressQueryProtocol: """0x80 / 0x81 地址查询。""" def test_build_query_zero_uid_matches_doc(self): """未绑定地址探测: 01 80 + 12×00 + CRC(54 01)。""" assert build_address_query_request(0x01, None) == DOC_QUERY_ZERO assert build_address_query_request(0x01) == DOC_QUERY_ZERO def test_build_query_with_uid(self): frame = build_address_query_request(0x01, PANEL_UID_HEX) assert len(frame) == ADDRESS_FRAME_LEN assert frame[:2] == bytes([0x01, 0x80]) assert frame[2:14] == PANEL_UID assert frame[14:] == calculate_crc16(frame[:14]) def test_parse_query_response_matches_doc(self): result = parse_address_query_response(DOC_QUERY_RESP) assert 'error' not in result assert result['success'] is True assert result['device_address'] == 0x01 assert result['uid'] == PANEL_UID_HEX def test_parse_query_response_zero_uid_is_invalid(self): frame = bytes([0x01, 0x81]) + ZERO_UID result = parse_address_query_response(frame + calculate_crc16(frame)) assert result['success'] is True assert result['uid'] is None def test_parse_query_response_all_ff_uid_is_invalid(self): frame = bytes([0x01, 0x81]) + b'\xff' * 12 result = parse_address_query_response(frame + calculate_crc16(frame)) assert result['uid'] is None def test_parse_query_response_crc_failure(self): bad = bytearray(DOC_QUERY_RESP) bad[-1] ^= 0xFF result = parse_address_query_response(bytes(bad)) assert 'error' in result assert 'CRC' in result['error'] def test_parse_query_response_wrong_function_code(self): frame = bytes([0x01, 0x82]) + PANEL_UID result = parse_address_query_response(frame + calculate_crc16(frame)) assert 'error' in result def test_parse_query_response_exception(self): result = parse_address_query_response(build_exception_response(0x01, 0x80, 0x02)) assert 'error' in result def test_parse_query_response_short(self): assert 'error' in parse_address_query_response(b'') assert 'error' in parse_address_query_response(DOC_QUERY_RESP[:8]) class TestAddressConfirmProtocol: """0x82 / 0x83 地址确认。""" def test_build_confirm_matches_doc(self): assert build_address_confirm_request(0x01, PANEL_UID_HEX) == DOC_CONFIRM_REQ def test_parse_confirm_matches_doc(self): result = parse_address_confirm_response(DOC_CONFIRM_RESP) assert 'error' not in result assert result['success'] is True assert result['device_address'] == 0x01 assert result['uid'] == PANEL_UID_HEX def test_parse_confirm_wrong_function_code(self): frame = bytes([0x01, 0x81]) + PANEL_UID result = parse_address_confirm_response(frame + calculate_crc16(frame)) assert 'error' in result class TestModbusClientAddressOps: """ModbusRTUClient 的 0x80/0x82 客户端方法。""" def setup_method(self): self.client = ModbusRTUClient(MagicMock()) self.client.serial.ser = MagicMock() def test_query_address_sends_doc_frame(self): self.client.serial.send_and_wait.return_value = DOC_QUERY_RESP result = self.client.query_address(0x01, uid=None) assert 'error' not in result assert result['uid'] == PANEL_UID_HEX sent = self.client.serial.send_and_wait.call_args[0][0] assert sent == DOC_QUERY_ZERO assert self.client.serial.send_and_wait.call_args.kwargs['min_response_bytes'] == ADDRESS_FRAME_LEN def test_confirm_address_sends_doc_frame(self): self.client.serial.send_and_wait.return_value = DOC_CONFIRM_RESP result = self.client.confirm_address(0x01, PANEL_UID_HEX) assert 'error' not in result assert result['uid'] == PANEL_UID_HEX sent = self.client.serial.send_and_wait.call_args[0][0] assert sent == DOC_CONFIRM_REQ def test_query_address_invalid_uid(self): result = self.client.query_address(0x01, uid=b'\x00' * 11) assert 'error' in result def test_query_address_serial_not_connected(self): self.client.serial.ser = None assert 'error' in self.client.query_address(0x01) def test_query_address_timeout(self): self.client.serial.send_and_wait.return_value = b'' result = self.client.query_address(0x01) assert 'error' in result class TestReadAllAntennaCards: """V5 标准 MODBUS 0x03 批量读。""" def setup_method(self): self.client = ModbusRTUClient(MagicMock()) self.client.serial.ser = MagicMock() def _mock_response(self, response_bytes: bytes): self.client.serial.send_and_wait.return_value = response_bytes def test_request_frame_matches_doc(self): """请求固定 8 字节: 01 03 00 02 00 48 E4 3C。""" self._mock_response(build_bulk_response(0x01, NO_TAG_BYTES * ANTENNA_COUNT)) self.client.read_all_antenna_cards(0x01) sent = self.client.serial.send_and_wait.call_args[0][0] assert sent == DOC_READ_REQ assert len(sent) == BULK_REQUEST_LEN assert build_read_cards_request(0x01) == DOC_READ_REQ def test_min_response_bytes_is_149(self): self._mock_response(build_bulk_response(0x01, NO_TAG_BYTES * ANTENNA_COUNT)) self.client.read_all_antenna_cards(0x01) kwargs = self.client.serial.send_and_wait.call_args.kwargs assert kwargs.get('min_response_bytes') == BULK_RESPONSE_LEN def test_no_panel_uid_in_v5_result(self): """V5 读卡结果不再包含 panel_uid(UID 走 0x80 查询)。""" self._mock_response(build_bulk_response(0x01, NO_TAG_BYTES * ANTENNA_COUNT)) result = self.client.read_all_antenna_cards(0x01) assert 'error' not in result assert 'panel_uid' not in result def test_legacy_161_response_tolerated(self): """过渡期: V4 旧固件 161B 响应仍可解析,UID 忽略。""" self._mock_response(build_legacy_uid_bulk_response(0x01, NO_TAG_BYTES * ANTENNA_COUNT)) result = self.client.read_all_antenna_cards(0x01) assert 'error' not in result assert len(result['cards']) == ANTENNA_COUNT assert 'panel_uid' not in result def test_no_tag_response(self): self._mock_response(build_bulk_response(0x01, NO_TAG_BYTES * ANTENNA_COUNT)) result = self.client.read_all_antenna_cards(0x01) assert result['success'] is True assert result['device_address'] == 0x01 assert result['function_code'] == 0x03 assert len(result['cards']) == ANTENNA_COUNT for idx, card in enumerate(result['cards']): assert card['antenna'] == idx + 1 assert card['present'] is False assert card['card_str'] == '' assert card['uid'] == '' def test_tag_on_antenna_24(self): tag = bytes([0xED, 0x9A, 0x57, 0xF9, 0x50, 0x01]) tag_data = NO_TAG_BYTES * 23 + tag self._mock_response(build_bulk_response(0x03, tag_data)) result = self.client.read_all_antenna_cards(0x03) cards = result['cards'] assert len(cards) == 24 assert all(not c['present'] for c in cards[:23]) assert cards[23]['present'] is True assert cards[23]['card_str'] == 'ed9a57f95001' assert cards[23]['uid'] == 'ed:9a:57:f9:50:01' def test_tag_on_antenna_1(self): tag = bytes([0xAA, 0xBB, 0xCC, 0xDD, 0xEE, 0xFF]) self._mock_response(build_bulk_response(0x01, tag + NO_TAG_BYTES * 23)) result = self.client.read_all_antenna_cards(0x01) assert result['cards'][0]['present'] is True assert result['cards'][0]['card_str'] == 'aabbccddeeff' for i in range(1, 24): assert result['cards'][i]['present'] is False def test_multiple_tags(self): tag1 = bytes([0x11, 0x22, 0x33, 0x44, 0x55, 0x66]) tag12 = bytes([0x77, 0x88, 0x99, 0xAA, 0xBB, 0xCC]) tag24 = bytes([0xDD, 0xEE, 0xFF, 0x00, 0x11, 0x22]) tag_data = bytearray(NO_TAG_BYTES * ANTENNA_COUNT) tag_data[0:6] = tag1 tag_data[11 * 6:12 * 6] = tag12 tag_data[23 * 6:24 * 6] = tag24 self._mock_response(build_bulk_response(0x01, bytes(tag_data))) result = self.client.read_all_antenna_cards(0x01) assert result['cards'][0]['card_str'] == '112233445566' assert result['cards'][11]['card_str'] == '778899aabbcc' assert result['cards'][23]['card_str'] == 'ddeeff001122' assert result['cards'][1]['present'] is False def test_crc_failure(self): response = bytearray(build_bulk_response(0x01, NO_TAG_BYTES * ANTENNA_COUNT)) response[-1] ^= 0xFF self._mock_response(bytes(response)) result = self.client.read_all_antenna_cards(0x01) assert 'error' in result assert 'CRC' in result['error'] def test_short_frame(self): self._mock_response(bytes([0x01, 0x03, 0x90] + [0xFF] * 7)) assert 'error' in self.client.read_all_antenna_cards(0x01) def test_exception_response(self): self._mock_response(build_exception_response(0x01, 0x03, 0x02)) result = self.client.read_all_antenna_cards(0x01) assert 'error' in result assert 'exception' in result['error'].lower() def test_unexpected_function_code(self): frame = bytes([0x01, 0x04, BULK_BYTE_COUNT]) + NO_TAG_BYTES * ANTENNA_COUNT self._mock_response(frame + calculate_crc16(frame)) assert 'error' in self.client.read_all_antenna_cards(0x01) def test_serial_not_connected(self): self.client.serial.ser = None assert 'error' in self.client.read_all_antenna_cards(0x01) def test_empty_response(self): self._mock_response(b'') assert 'error' in self.client.read_all_antenna_cards(0x01) class TestReadAntennaCardSingle: """单卡提取 (向后兼容包装)。""" def setup_method(self): self.client = ModbusRTUClient(MagicMock()) self.client.serial.ser = MagicMock() def test_extract_antenna_1_with_tag(self): tag = bytes([0xDE, 0xAD, 0xBE, 0xEF, 0x00, 0x01]) self.client.serial.send_and_wait.return_value = build_bulk_response( 0x01, tag + NO_TAG_BYTES * 23) result = self.client.read_antenna_card(0x01, 1) assert 'error' not in result assert result['antenna'] == 1 assert result['card_number_str'] == 'deadbeef0001' assert result['uid'] == 'de:ad:be:ef:00:01' assert result['card_number'] == int.from_bytes(tag, 'big') assert result['card_number_hex'] == f'0x{int.from_bytes(tag, "big"):012x}' def test_extract_antenna_no_tag(self): self.client.serial.send_and_wait.return_value = build_bulk_response( 0x01, NO_TAG_BYTES * 24) result = self.client.read_antenna_card(0x01, 5) assert result['antenna'] == 5 assert result['card_number_str'] == '' assert result['uid'] == '' def test_invalid_antenna_number(self): assert 'error' in self.client.read_antenna_card(0x01, 25) assert 'error' in self.client.read_antenna_card(0x01, 0) def test_bulk_error_propagates(self): self.client.serial.send_and_wait.return_value = b'' assert 'error' in self.client.read_antenna_card(0x01, 1) def test_does_not_send_v2_frame(self): """单卡读不得发 V2 逐天线帧 (0x0002+(n-1)*4)。""" self.client.serial.send_and_wait.return_value = build_bulk_response( 0x01, NO_TAG_BYTES * 24) self.client.read_antenna_card(0x01, 10) sent = self.client.serial.send_and_wait.call_args[0][0] assert sent == DOC_READ_REQ assert sent[2:4] != bytes([0x00, 0x26]) class TestConfigAddressProtocol: """配置地址状态(刷配置卡设置地址)。""" def test_enter_frame_matches_doc(self): assert CONFIG_ADDRESS_ENTER_FRAME == DOC_CONFIG_ENTER assert build_config_address_enter_frame() == DOC_CONFIG_ENTER assert len(DOC_CONFIG_ENTER) == 13 def test_parse_response_with_garbage_prefix(self): frame = build_config_response(antenna=3, addr=12) result = parse_config_address_response(b'\x00\xff' + frame + b'\x99') assert 'error' not in result assert result['antenna'] == 3 assert result['address'] == 12 assert result['raw_data'] == frame.hex() def test_parse_response_checks_xor(self): frame = bytearray(build_config_response(antenna=1, addr=5)) frame[6] ^= 0xFF result = parse_config_address_response(bytes(frame)) assert 'error' in result def test_parse_response_rejects_bad_antenna(self): assert 'error' in parse_config_address_response(build_config_response(0, 5)) assert 'error' in parse_config_address_response(build_config_response(25, 5)) def test_parse_response_short(self): assert 'error' in parse_config_address_response(b'') assert 'error' in parse_config_address_response(b'\x55\x00\x00\x02') class TestAntennaAddressesMapping: def test_all_antennas_share_card_register(self): for ant in range(1, 25): assert ANTENNA_ADDRESSES[ant] == CARD_REG_ADDR assert CARD_REG_QUANTITY == 0x48 assert CARD_DATA_BYTES == 144 class TestCrcHelpers: def test_request_crc_matches_doc(self): """文档示例请求帧 (01 03 00 02 00 48) CRC = E4 3C。""" assert calculate_crc16(bytes([0x01, 0x03, 0x00, 0x02, 0x00, 0x48])) == bytes([0xE4, 0x3C]) def test_query_zero_uid_crc_matches_doc(self): frame = bytes([0x01, 0x80]) + ZERO_UID assert calculate_crc16(frame) == bytes([0x54, 0x01]) def test_confirm_crc_matches_doc(self): frame = bytes([0x01, 0x82]) + PANEL_UID assert calculate_crc16(frame) == bytes([0xD5, 0x10]) def test_verify_crc16_valid_frame(self): frame = bytes([0x01, 0x03, 0x90]) + b'\xff' * 144 assert verify_crc16(frame + calculate_crc16(frame)) is True def test_verify_crc16_corrupted(self): frame = bytes([0x01, 0x03, 0x90]) + b'\xff' * 144 crc = bytearray(calculate_crc16(frame)) crc[0] ^= 0xFF assert verify_crc16(frame + bytes(crc)) is False if __name__ == '__main__': pytest.main([__file__, '-v'])