summaryrefslogtreecommitdiffstats
path: root/lab_control/jds6600.py
blob: 5ada6cf9a8ecd5029e3cf683262214229897177c (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
"""
Implements partial support for Joy-IT JDS6600 function generator.
"""

import serial

from lab_control.function_generator import FunctionGenerator

def _checkChannel(channel: int):
    assert channel in JDS6600.AVAILABLE_CHANNELS, f"JDS6600: Invalid channel {channel}"

def _checkArg(arg: float, lowerBound: float, upperBound: float):
    valid = arg is not None
    if valid:
        valid &= arg >= lowerBound
        valid &= arg <= upperBound
    assert valid, f"JDS6600: Invalid argument {arg}"

class JDS6600(FunctionGenerator):
    """
    Instances of this class bind to the JDS6600 serial port
    and offer an API to control the device.
    """
    AVAILABLE_CHANNELS = [1, 2]
    SINE       = 0
    SQUARE     = 1
    TRIANGULAR = 3

    def __init__(self, portName):
        super().__init__()
        self._port = serial.Serial(portName)
        self._port.baudrate = 115200
        self._port.bytesize = serial.EIGHTBITS
        self._port.stopbits = serial.STOPBITS_ONE
        self._port.parity = serial.PARITY_NONE

    def closePort(self) -> None:
        """
        Close the serial port. Instances of this class
        are no longer usable after this is called.
        """
        self._port.close()

    def _queryOnOff(self) -> list[str, str]:
        # response format: ":r20=0,0."
        response = self._sendRequest("r20")
        return [response[5], response[7]]

    def _sendRequest(self, opcode: str, args: str="") -> str:
        request = f":{opcode}={args}.\r\n"
        self._port.write(request.encode())
        responseRaw = self._port.readline()
        return responseRaw.decode().strip()

    def setOn(self, channel: int) -> None:
        _checkChannel(channel)

        state = self._queryOnOff()
        state[channel - 1] = "1"
        self._sendRequest("w20", f"{state[0]},{state[1]}")

    def setOff(self, channel: int) -> None:
        _checkChannel(channel)

        state = self._queryOnOff()
        state[channel - 1] = "0"
        self._sendRequest("w20", f"{state[0]},{state[1]}")

    def setFrequency(self, channel: int, frequency: float) -> None:
        _checkChannel(channel)
        _checkArg(frequency, 0.0, 60e6)

        opcode = f"w{23 + channel - 1}"
        arg = int(frequency * 100.0)
        self._sendRequest(opcode, str(arg))

    def setAmplitude(self, channel: int, amplitude: float) -> None:
        _checkChannel(channel)
        _checkArg(amplitude, 0.0, 20.0)

        opcode = f"w{25 + channel - 1}"
        arg = int(amplitude * 1000.0)
        self._sendRequest(opcode, str(arg))

    def setFunction(self, channel: int, function: int) -> None:
        _checkChannel(channel)
        _checkArg(function, 0, 16)

        opcode = f"w{21 + channel - 1}"
        self._sendRequest(opcode, str(function))