| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186 |
- import pytest
- import sys
- import os
- import time
- from unittest.mock import MagicMock, patch
- sys.path.append(os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
- from modules.serial_port import SerialPort
- def _make_serial_instance():
- """创建一个不会导致后台读取线程崩溃的 mock 串口实例"""
- inst = MagicMock()
- inst.is_open = True
- inst.in_waiting = 0 # int,避免 _read_loop 中比较报错
- return inst
- class TestSerialPort:
-
- def setup_method(self):
- self.serial_port = SerialPort()
- self.data_callback = MagicMock()
- self.status_callback = MagicMock()
- self.serial_port.set_data_callback(self.data_callback)
- self.serial_port.set_status_callback(self.status_callback)
-
- def teardown_method(self):
- self.serial_port.disconnect()
-
- @patch('modules.serial_port.serial.Serial')
- def test_connect_success(self, mock_serial):
- """测试成功连接串口"""
- mock_serial.return_value = _make_serial_instance()
-
- success, message = self.serial_port.connect('COM1', 9600)
-
- assert success is True
- assert message == "已连接到 COM1,波特率 9600"
- # 验证 Serial 以关键字参数调用
- mock_serial.assert_called_once()
- _, kwargs = mock_serial.call_args
- assert kwargs['port'] == 'COM1'
- assert kwargs['baudrate'] == 9600
- # 状态回调应至少被以 True 调用过一次
- self.status_callback.assert_any_call(True)
-
- @patch('modules.serial_port.serial.Serial')
- def test_connect_failure(self, mock_serial):
- """测试连接串口失败"""
- mock_serial.side_effect = Exception("串口未找到")
-
- success, message = self.serial_port.connect('COM1', 9600)
-
- assert success is False
- assert "连接失败" in message
- # 失败时状态回调应以 False 调用
- self.status_callback.assert_any_call(False)
-
- @patch('modules.serial_port.serial.Serial')
- def test_disconnect(self, mock_serial):
- """测试断开串口连接"""
- mock_instance = _make_serial_instance()
- mock_serial.return_value = mock_instance
-
- self.serial_port.connect('COM1', 9600)
- self.status_callback.reset_mock()
-
- self.serial_port.disconnect()
-
- mock_instance.close.assert_called_once()
- self.status_callback.assert_any_call(False)
-
- @patch('modules.serial_port.serial.Serial')
- def test_disconnect_not_connected(self, mock_serial):
- """测试断开未连接的串口不应抛出异常,且状态为未连接"""
- # 不连接直接断开
- success, message = self.serial_port.disconnect()
-
- assert success is True
- assert self.serial_port.get_status()['connected'] is False
-
- @patch('modules.serial_port.serial.Serial')
- def test_send_data_success(self, mock_serial):
- """测试成功发送数据"""
- mock_instance = _make_serial_instance()
- mock_instance.write.return_value = 15
- mock_serial.return_value = mock_instance
-
- self.serial_port.connect('COM1', 9600)
-
- test_data = "Hello, Serial!"
- success, message = self.serial_port.send_data(test_data)
-
- assert success is True
- assert message == "发送成功"
- # 实际写入会自动追加换行符
- mock_instance.write.assert_called_once_with((test_data + '\n').encode('utf-8'))
-
- @patch('modules.serial_port.serial.Serial')
- def test_send_data_failure(self, mock_serial):
- """测试发送数据失败"""
- mock_instance = _make_serial_instance()
- mock_instance.write.side_effect = Exception("写入失败")
- mock_serial.return_value = mock_instance
-
- self.serial_port.connect('COM1', 9600)
-
- test_data = "Hello, Serial!"
- success, message = self.serial_port.send_data(test_data)
-
- assert success is False
- assert "发送失败" in message
- mock_instance.write.assert_called_once_with((test_data + '\n').encode('utf-8'))
-
- @patch('modules.serial_port.serial.Serial')
- def test_send_data_not_connected(self, mock_serial):
- """测试未连接时发送数据"""
- test_data = "Hello, Serial!"
- success, message = self.serial_port.send_data(test_data)
-
- assert success is False
- assert message == "串口未连接"
-
- @patch('modules.serial_port.serial.Serial')
- def test_get_status(self, mock_serial):
- """测试获取串口状态 (返回 dict)"""
- mock_serial.return_value = _make_serial_instance()
-
- # 初始状态未连接
- st = self.serial_port.get_status()
- assert isinstance(st, dict)
- assert st['connected'] is False
-
- # 连接后
- self.serial_port.connect('COM1', 9600)
- st = self.serial_port.get_status()
- assert st['connected'] is True
-
- # 断开后
- self.serial_port.disconnect()
- st = self.serial_port.get_status()
- assert st['connected'] is False
-
- @patch('modules.serial_port.serial.Serial')
- def test_receive_data(self, mock_serial):
- """测试接收数据回调"""
- mock_instance = _make_serial_instance()
- mock_serial.return_value = mock_instance
-
- self.serial_port.connect('COM1', 9600)
-
- # 模拟 _read_loop 收到数据后触发数据回调
- self.serial_port.data_callback("Test data")
- self.data_callback.assert_called_with("Test data")
- @patch('modules.serial_port.serial.Serial')
- def test_command_start_times_paced_by_interval(self, mock_serial):
- """队列内相邻指令的「发送起点」间隔应被节拍限制(不再背靠背)。"""
- mock_instance = _make_serial_instance()
- written_at = []
- def _record_write(data):
- written_at.append(time.monotonic())
- return len(data)
- mock_instance.write.side_effect = _record_write
- mock_serial.return_value = mock_instance
- self.serial_port.connect('COM1', 9600)
- # 固定节拍 0.2s(send_raw 不等应答,write 几乎瞬时完成)
- self.serial_port._cmd_min_interval = 0.2
- self.serial_port._next_cmd_time = 0.0
- self.serial_port.send_raw(b'\x01\x80' + b'\x00' * 12 + b'\x54\x01')
- self.serial_port.send_raw(b'\x01\x03\x00\x02\x00\x48\xe4\x3c')
- assert len(written_at) == 2
- gap = written_at[1] - written_at[0]
- # 第二条必须被排到第一条起拍之后约一个节拍(允许调度误差),不能背靠背
- assert 0.18 <= gap < 0.4, f"相邻发送起点间隔异常: {gap:.3f}s"
- if __name__ == "__main__":
- pytest.main(["-v", __file__])
|