| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458 |
- """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'])
|