Source code for inkex.ports

# coding=utf-8
#
# Copyright (C) 2019 Martin Owens <doctormo@gmail.com>
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; either version 2 of the License, or
# (at your option) any later version.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
#
"""
Common access to serial and other computer ports.
"""

import os
import sys
import time
from .utils import DependencyError, AbortExtension

try:
    import serial
    from serial.tools import list_ports
except ImportError:
    serial = None

[docs]class Serial: """ Attempt to get access to the computer's serial port. with Serial(port_name, ...) as com: com.write(...) Provides access to the debug/testing ports which are pretend ports able to accept the same input but allow for debugging. """ def __init__(self, port, baud=9600, timeout=0.1, **options): self.test = port == '[test]' if self.test: import pty # This does not work on windows self.controller, self.peripheral = pty.openpty() port = os.ttyname(self.peripheral) self.has_serial() self.com = serial.Serial() self.com.port = port self.com.baudrate = int(baud) self.com.timeout = timeout self.set_options(**options)
[docs] def set_options(self, stop=1, size=8, flow=None, parity=None): """Set further options on the serial port""" size = {5: 'five', 6: 'six', 7: 'seven', 8: 'eight'}.get(size, size) stop = {'onepointfive': 1.5}.get(stop.lower(), stop) stop = {1: 'one', 1.5: 'one_point_five', 2: 'two'}.get(stop, stop) self.com.bytesize = getattr(serial, str(str(size).upper()) + 'BITS') self.com.stopbits = getattr(serial, 'STOPBITS_' + str(stop).upper()) self.com.parity = getattr(serial, 'PARITY_' + str(parity).upper()) # set flow control self.com.xonxoff = flow == 'xonxoff' self.com.rtscts = flow in ('rtscts', 'dsrdtrrtscts') self.com.dsrdtr = flow == 'dsrdtrrtscts'
def __enter__(self): try: # try to establish connection self.com.open() except serial.SerialException: raise AbortExtension("Could not open serial port. Please check your device"\ " is running, connected and the settings are correct") return self.com def __exit__(self, exc, value, traceback): if not traceback and self.test: output = ' ' * 1024 while len(output) == 1024: time.sleep(0.01) output = os.read(self.controller, 1024) sys.stderr.write(output.decode('utf8')) #self.com.read(2) self.com.close()
[docs] @staticmethod def has_serial(): """Late importing of pySerial module""" if serial is None: raise DependencyError("pySerial is required to open serial ports.")
[docs] @staticmethod def list_ports(): """Return a list of available serial ports""" Serial.has_serial() # Cause DependencyError error return [hw.name for hw in list_ports.comports(True)]