qmsk/dmx/control.py
author Tero Marttila <terom@paivola.fi>
Thu, 01 May 2014 23:34:20 +0300
changeset 83 136e210fce82
parent 74 9031dafa39d6
permissions -rw-r--r--
qmsk.dmx: new Head-based model/view; output/updates not yet implemented
74
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
     1
import collections
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
     2
import logging; log = logging.getLogger('qmsk.dmx.control')
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
     3
import serial
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
     4
83
136e210fce82 qmsk.dmx: new Head-based model/view; output/updates not yet implemented
Tero Marttila <terom@paivola.fi>
parents: 74
diff changeset
     5
"""
136e210fce82 qmsk.dmx: new Head-based model/view; output/updates not yet implemented
Tero Marttila <terom@paivola.fi>
parents: 74
diff changeset
     6
    Low-level DMX channel output.
136e210fce82 qmsk.dmx: new Head-based model/view; output/updates not yet implemented
Tero Marttila <terom@paivola.fi>
parents: 74
diff changeset
     7
"""
136e210fce82 qmsk.dmx: new Head-based model/view; output/updates not yet implemented
Tero Marttila <terom@paivola.fi>
parents: 74
diff changeset
     8
74
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
     9
class DMXError (Exception) :
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
    10
    def __init__ (self, **kwargs) :
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
    11
        self.kwargs = kwargs
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
    12
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
    13
    def __str__ (self) :
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
    14
        return self.__doc__.strip().format(**self.kwargs)
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
    15
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
    16
class DMXCommandError (DMXError) :
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
    17
    """
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
    18
        Command {cmd!r} failed: {out!r}
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
    19
    """
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
    20
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
    21
class DMXUnknownCommandError (DMXError) :
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
    22
    """
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
    23
        Unknown command: {cmd!r}
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
    24
    """
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
    25
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
    26
class DMX (object) :
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
    27
    """
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
    28
        Arudino-based DMX controller using src/hello-dmx.c over the serial port.
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
    29
    """
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
    30
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
    31
    SERIAL = '/dev/arduino'
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
    32
    SERIAL_BAUD = 9600
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
    33
    SERIAL_TIMEOUT = 1.0
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
    34
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
    35
    @classmethod
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
    36
    def open (cls, path, baud=SERIAL_BAUD, timeout=SERIAL_TIMEOUT) :
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
    37
        return cls(serial.Serial(path, baud, timeout=timeout))
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
    38
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
    39
    def __init__ (self, io) :
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
    40
        self.io = io
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
    41
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
    42
        # XXX: bug
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
    43
        self.io.write('\r')
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
    44
        self.io.flush()
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
    45
        self.io.read(1)
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
    46
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
    47
    def _arg (self, arg) :
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
    48
        if isinstance(arg, str) :
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
    49
            value, = arg
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
    50
            value = ord(value)
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
    51
        elif isinstance(arg, int) :
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
    52
            value = arg
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
    53
        else :
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
    54
            raise ValueError(arg)
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
    55
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
    56
        if 0 <= value <= 255 :
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
    57
            return str(value)
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
    58
        else :
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
    59
            raise ValueError(value)
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
    60
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
    61
    def __call__ (self, cmd, *args) :
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
    62
        out = cmd + ' ' + ' '.join(self._arg(arg) for arg in args) + '\r'
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
    63
        
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
    64
        log.info("%s", out)
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
    65
        
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
    66
        self.io.write(out)
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
    67
        self.io.flush()
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
    68
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
    69
        ret = self.io.read(len(out))
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
    70
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
    71
        if '!' in ret :
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
    72
            raise DMXCommandError(cmd=out, out=ret)
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
    73
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
    74
        elif '?' in ret :
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
    75
            raise DMXUnknownCommandError(cmd=cmd)
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
    76
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
    77
    def clear (self) :
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
    78
        """
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
    79
            Set dmx = [ ]
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
    80
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
    81
            i.e. start transmitting zero-length DMX packets.
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
    82
            For most lights, this seems to be equivalent to losing the DMX signal, and they retain their old state.
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
    83
        """
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
    84
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
    85
        self('c')
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
    86
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
    87
    def zero (self) :
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
    88
        """
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
    89
            Set dmx = [0, ...]
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
    90
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
    91
            Uses the maximum DMX packet length available.
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
    92
        """
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
    93
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
    94
        self('z')
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
    95
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
    96
    def out (self, *values) :
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
    97
        """
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
    98
            Set dmx = (value, ...)
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
    99
        """
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
   100
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
   101
        self('o', *values)
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
   102
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
   103
    def set (self, start, *values) :
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
   104
        """
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
   105
            Set dmx[start:] = value
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
   106
        """
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
   107
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
   108
        self('s', start, *values)
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
   109
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
   110
    def fill (self, start, end, *values) :
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
   111
        """
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
   112
            Set dmx[start:end] to repetitions of (value, ...)
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
   113
        """
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
   114
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
   115
        self('f', start, end, *values)
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
   116
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
   117
    def range (self, start, stop, step, value) :
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
   118
        """
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
   119
            Set dmx[start:end:step] = value
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
   120
        """
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
   121
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
   122
        self('r', start, stop, step, value)
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
   123
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
   124
    def __setitem__ (self, index, value) :
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
   125
        if isinstance(value, collections.Sequence) :
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
   126
            values = tuple(value)
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
   127
        else :
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
   128
            values = (value, )
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
   129
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
   130
        if isinstance(index, slice) :
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
   131
            if index.start and index.stop and index.step :
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
   132
                # XXX: single
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
   133
                self.range(index.start, index.stop, index.step, value)
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
   134
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
   135
            elif index.start and index.stop :
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
   136
                self.fill(index.start, index.stop, *values)
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
   137
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
   138
            elif index.start :
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
   139
                self.set(index.start, *values)
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
   140
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
   141
            else :
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
   142
                raise IndexError("invalid slice: %s" % (index, ))
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
   143
        
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
   144
        else :
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
   145
            # simple set
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
   146
            self.set(index, *values)
9031dafa39d6 dmx: split into qmsk.dmx
Tero Marttila <terom@paivola.fi>
parents:
diff changeset
   147