_win32serialport.py 4.6 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133
  1. # -*- test-case-name: twisted.internet.test.test_win32serialport -*-
  2. # Copyright (c) Twisted Matrix Laboratories.
  3. # See LICENSE for details.
  4. """
  5. Serial port support for Windows.
  6. Requires PySerial and pywin32.
  7. """
  8. from __future__ import division, absolute_import
  9. # system imports
  10. from serial import PARITY_NONE
  11. from serial import STOPBITS_ONE
  12. from serial import EIGHTBITS
  13. from serial.serialutil import to_bytes
  14. import win32file, win32event
  15. # twisted imports
  16. from twisted.internet import abstract
  17. # sibling imports
  18. from twisted.internet.serialport import BaseSerialPort
  19. class SerialPort(BaseSerialPort, abstract.FileDescriptor):
  20. """A serial device, acting as a transport, that uses a win32 event."""
  21. connected = 1
  22. def __init__(self, protocol, deviceNameOrPortNumber, reactor,
  23. baudrate = 9600, bytesize = EIGHTBITS, parity = PARITY_NONE,
  24. stopbits = STOPBITS_ONE, xonxoff = 0, rtscts = 0):
  25. self._serial = self._serialFactory(
  26. deviceNameOrPortNumber, baudrate=baudrate, bytesize=bytesize,
  27. parity=parity, stopbits=stopbits, timeout=None,
  28. xonxoff=xonxoff, rtscts=rtscts)
  29. self.flushInput()
  30. self.flushOutput()
  31. self.reactor = reactor
  32. self.protocol = protocol
  33. self.outQueue = []
  34. self.closed = 0
  35. self.closedNotifies = 0
  36. self.writeInProgress = 0
  37. self.protocol = protocol
  38. self._overlappedRead = win32file.OVERLAPPED()
  39. self._overlappedRead.hEvent = win32event.CreateEvent(None, 1, 0, None)
  40. self._overlappedWrite = win32file.OVERLAPPED()
  41. self._overlappedWrite.hEvent = win32event.CreateEvent(None, 0, 0, None)
  42. self.reactor.addEvent(self._overlappedRead.hEvent, self, 'serialReadEvent')
  43. self.reactor.addEvent(self._overlappedWrite.hEvent, self, 'serialWriteEvent')
  44. self.protocol.makeConnection(self)
  45. self._finishPortSetup()
  46. def _finishPortSetup(self):
  47. """
  48. Finish setting up the serial port.
  49. This is a separate method to facilitate testing.
  50. """
  51. flags, comstat = self._clearCommError()
  52. rc, self.read_buf = win32file.ReadFile(self._serial._port_handle,
  53. win32file.AllocateReadBuffer(1),
  54. self._overlappedRead)
  55. def _clearCommError(self):
  56. return win32file.ClearCommError(self._serial._port_handle)
  57. def serialReadEvent(self):
  58. #get that character we set up
  59. n = win32file.GetOverlappedResult(self._serial._port_handle, self._overlappedRead, 0)
  60. first = to_bytes(self.read_buf[:n])
  61. #now we should get everything that is already in the buffer
  62. flags, comstat = self._clearCommError()
  63. if comstat.cbInQue:
  64. win32event.ResetEvent(self._overlappedRead.hEvent)
  65. rc, buf = win32file.ReadFile(self._serial._port_handle,
  66. win32file.AllocateReadBuffer(comstat.cbInQue),
  67. self._overlappedRead)
  68. n = win32file.GetOverlappedResult(self._serial._port_handle, self._overlappedRead, 1)
  69. #handle all the received data:
  70. self.protocol.dataReceived(first + to_bytes(buf[:n]))
  71. else:
  72. #handle all the received data:
  73. self.protocol.dataReceived(first)
  74. #set up next one
  75. win32event.ResetEvent(self._overlappedRead.hEvent)
  76. rc, self.read_buf = win32file.ReadFile(self._serial._port_handle,
  77. win32file.AllocateReadBuffer(1),
  78. self._overlappedRead)
  79. def write(self, data):
  80. if data:
  81. if self.writeInProgress:
  82. self.outQueue.append(data)
  83. else:
  84. self.writeInProgress = 1
  85. win32file.WriteFile(self._serial._port_handle, data, self._overlappedWrite)
  86. def serialWriteEvent(self):
  87. try:
  88. dataToWrite = self.outQueue.pop(0)
  89. except IndexError:
  90. self.writeInProgress = 0
  91. return
  92. else:
  93. win32file.WriteFile(self._serial._port_handle, dataToWrite, self._overlappedWrite)
  94. def connectionLost(self, reason):
  95. """
  96. Called when the serial port disconnects.
  97. Will call C{connectionLost} on the protocol that is handling the
  98. serial data.
  99. """
  100. self.reactor.removeEvent(self._overlappedRead.hEvent)
  101. self.reactor.removeEvent(self._overlappedWrite.hEvent)
  102. abstract.FileDescriptor.connectionLost(self, reason)
  103. self._serial.close()
  104. self.protocol.connectionLost(reason)