test_serial_port.py 6.8 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186
  1. import pytest
  2. import sys
  3. import os
  4. import time
  5. from unittest.mock import MagicMock, patch
  6. sys.path.append(os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
  7. from modules.serial_port import SerialPort
  8. def _make_serial_instance():
  9. """创建一个不会导致后台读取线程崩溃的 mock 串口实例"""
  10. inst = MagicMock()
  11. inst.is_open = True
  12. inst.in_waiting = 0 # int,避免 _read_loop 中比较报错
  13. return inst
  14. class TestSerialPort:
  15. def setup_method(self):
  16. self.serial_port = SerialPort()
  17. self.data_callback = MagicMock()
  18. self.status_callback = MagicMock()
  19. self.serial_port.set_data_callback(self.data_callback)
  20. self.serial_port.set_status_callback(self.status_callback)
  21. def teardown_method(self):
  22. self.serial_port.disconnect()
  23. @patch('modules.serial_port.serial.Serial')
  24. def test_connect_success(self, mock_serial):
  25. """测试成功连接串口"""
  26. mock_serial.return_value = _make_serial_instance()
  27. success, message = self.serial_port.connect('COM1', 9600)
  28. assert success is True
  29. assert message == "已连接到 COM1,波特率 9600"
  30. # 验证 Serial 以关键字参数调用
  31. mock_serial.assert_called_once()
  32. _, kwargs = mock_serial.call_args
  33. assert kwargs['port'] == 'COM1'
  34. assert kwargs['baudrate'] == 9600
  35. # 状态回调应至少被以 True 调用过一次
  36. self.status_callback.assert_any_call(True)
  37. @patch('modules.serial_port.serial.Serial')
  38. def test_connect_failure(self, mock_serial):
  39. """测试连接串口失败"""
  40. mock_serial.side_effect = Exception("串口未找到")
  41. success, message = self.serial_port.connect('COM1', 9600)
  42. assert success is False
  43. assert "连接失败" in message
  44. # 失败时状态回调应以 False 调用
  45. self.status_callback.assert_any_call(False)
  46. @patch('modules.serial_port.serial.Serial')
  47. def test_disconnect(self, mock_serial):
  48. """测试断开串口连接"""
  49. mock_instance = _make_serial_instance()
  50. mock_serial.return_value = mock_instance
  51. self.serial_port.connect('COM1', 9600)
  52. self.status_callback.reset_mock()
  53. self.serial_port.disconnect()
  54. mock_instance.close.assert_called_once()
  55. self.status_callback.assert_any_call(False)
  56. @patch('modules.serial_port.serial.Serial')
  57. def test_disconnect_not_connected(self, mock_serial):
  58. """测试断开未连接的串口不应抛出异常,且状态为未连接"""
  59. # 不连接直接断开
  60. success, message = self.serial_port.disconnect()
  61. assert success is True
  62. assert self.serial_port.get_status()['connected'] is False
  63. @patch('modules.serial_port.serial.Serial')
  64. def test_send_data_success(self, mock_serial):
  65. """测试成功发送数据"""
  66. mock_instance = _make_serial_instance()
  67. mock_instance.write.return_value = 15
  68. mock_serial.return_value = mock_instance
  69. self.serial_port.connect('COM1', 9600)
  70. test_data = "Hello, Serial!"
  71. success, message = self.serial_port.send_data(test_data)
  72. assert success is True
  73. assert message == "发送成功"
  74. # 实际写入会自动追加换行符
  75. mock_instance.write.assert_called_once_with((test_data + '\n').encode('utf-8'))
  76. @patch('modules.serial_port.serial.Serial')
  77. def test_send_data_failure(self, mock_serial):
  78. """测试发送数据失败"""
  79. mock_instance = _make_serial_instance()
  80. mock_instance.write.side_effect = Exception("写入失败")
  81. mock_serial.return_value = mock_instance
  82. self.serial_port.connect('COM1', 9600)
  83. test_data = "Hello, Serial!"
  84. success, message = self.serial_port.send_data(test_data)
  85. assert success is False
  86. assert "发送失败" in message
  87. mock_instance.write.assert_called_once_with((test_data + '\n').encode('utf-8'))
  88. @patch('modules.serial_port.serial.Serial')
  89. def test_send_data_not_connected(self, mock_serial):
  90. """测试未连接时发送数据"""
  91. test_data = "Hello, Serial!"
  92. success, message = self.serial_port.send_data(test_data)
  93. assert success is False
  94. assert message == "串口未连接"
  95. @patch('modules.serial_port.serial.Serial')
  96. def test_get_status(self, mock_serial):
  97. """测试获取串口状态 (返回 dict)"""
  98. mock_serial.return_value = _make_serial_instance()
  99. # 初始状态未连接
  100. st = self.serial_port.get_status()
  101. assert isinstance(st, dict)
  102. assert st['connected'] is False
  103. # 连接后
  104. self.serial_port.connect('COM1', 9600)
  105. st = self.serial_port.get_status()
  106. assert st['connected'] is True
  107. # 断开后
  108. self.serial_port.disconnect()
  109. st = self.serial_port.get_status()
  110. assert st['connected'] is False
  111. @patch('modules.serial_port.serial.Serial')
  112. def test_receive_data(self, mock_serial):
  113. """测试接收数据回调"""
  114. mock_instance = _make_serial_instance()
  115. mock_serial.return_value = mock_instance
  116. self.serial_port.connect('COM1', 9600)
  117. # 模拟 _read_loop 收到数据后触发数据回调
  118. self.serial_port.data_callback("Test data")
  119. self.data_callback.assert_called_with("Test data")
  120. @patch('modules.serial_port.serial.Serial')
  121. def test_command_start_times_paced_by_interval(self, mock_serial):
  122. """队列内相邻指令的「发送起点」间隔应被节拍限制(不再背靠背)。"""
  123. mock_instance = _make_serial_instance()
  124. written_at = []
  125. def _record_write(data):
  126. written_at.append(time.monotonic())
  127. return len(data)
  128. mock_instance.write.side_effect = _record_write
  129. mock_serial.return_value = mock_instance
  130. self.serial_port.connect('COM1', 9600)
  131. # 固定节拍 0.2s(send_raw 不等应答,write 几乎瞬时完成)
  132. self.serial_port._cmd_min_interval = 0.2
  133. self.serial_port._next_cmd_time = 0.0
  134. self.serial_port.send_raw(b'\x01\x80' + b'\x00' * 12 + b'\x54\x01')
  135. self.serial_port.send_raw(b'\x01\x03\x00\x02\x00\x48\xe4\x3c')
  136. assert len(written_at) == 2
  137. gap = written_at[1] - written_at[0]
  138. # 第二条必须被排到第一条起拍之后约一个节拍(允许调度误差),不能背靠背
  139. assert 0.18 <= gap < 0.4, f"相邻发送起点间隔异常: {gap:.3f}s"
  140. if __name__ == "__main__":
  141. pytest.main(["-v", __file__])