Transfer waveform data to/from 86100D

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
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
""" Example of FlexDCA's ":WAVeform:XML:READ?" and ":WAVeform:XML:WRITe?"
queries. FlexDCA offline is configured with a waveform.
Waveform data is returned from FlexDCA's channel 1A,
written into FlexDCA's waveform memory 2, and saved
to a waveform file without the definite-length block data
preamble).
"""

import pyvisa as visa  # import VISA library

ADDRESS = 'TCPIP0::localhost::hislip0,4880::INSTR'
IOTIMEOUT = 20000  # 20 seconds
CHANNEL = '1A'


def open_flexdca_connection(address):
    """ Opens visa connection to FlexFlexDCA. """
    print('Connecting to Flexdca ...')
    try:
        rm = visa.ResourceManager()
        connection = rm.open_resource(address)
        connection.timeout = IOTIMEOUT  # Set connection timeout to 20s
        connection.read_termination = '\n'
        connection.write_termination = '\n'
        inst_id = connection.query('*IDN?')
        print('\nFlexDCA connection established to:\n' + inst_id, flush=True)
    except (visa.VisaIOError, visa.InvalidSession):
        print('\nVISA ERROR: Cannot open instrument address.\n', flush=True)
        return None
    except Exception as other:
        print('\nVISA ERROR: Cannot connect to instrument:', other, flush=True)
        print('\n')
        return None
    return connection


def install_simulated_module(flexdca, channel, model, signal='NRZ'):
    """ Simplified installation of a simulated FlexDCA module.
    model
        Type of simulated module. "DEM" is a dual-electrical module.
        "QEM" is a quad-electrical module. "DOM" is a dual-optical
        module. "QEM" is a electrical-optical module.
    signal
        Format of waveform. NRZ or PAM4.
    """
    slot = channel[0]
    flexdca.write(':EMODules:SLOT' + slot + ':SELection ' + model)
    if signal in 'NRZ':
        flexdca.write(':SOURce' + channel + ':FORMat NRZ')
    else:
        flexdca.write(':SOURce' + channel + ':FORMat PAM4')
    flexdca.write(':SOURce' + channel + ':DRATe 9.95328E+9')
    flexdca.write(':SOURce' + channel + ':WTYPe DATA')
    flexdca.write(':SOURce' + channel + ':PLENgth 127')
    flexdca.write(':SOURce' + channel + ':AMPLitude 90E-3')
    flexdca.write(':SOURce' + channel + ':NOISe:RN 3.0E-6')
    flexdca.write(':SOURce' + channel + ':JITTer:RJ 4.0E-12')
    flexdca.write(':CHANnel' + channel + ':DISPlay ON')


def setup(flexdca, channel):
    flexdca.write('*CLS')
    flexdca.query(':SYSTem:DEFault;*OPC?')
    install_simulated_module(flexdca, channel, 'DEM')
    flexdca.query(':SYSTem:MODE OSCilloscope;*OPC?')
    flexdca.query(':TRIGger:PLOCk ON;*OPC?')
    flexdca.query(':SYSTem:AUToscale;*OPC?')
    flexdca.write(':ACQuire:EPATtern ON')  # Acquire entire pattern
    patternlength = flexdca.query(':TRIGger:PLENgth?')  # Get pattern length
    flexdca.write(':TIMebase:UIRANge ' + patternlength)  # View pattern
    flexdca.write(':ACQuire:STOP')


def get_binary_waveform_data(flexdca):
    """ Sends a scpi query to FlexDCA that returns SCPI binary data
    instead of an ASCII string. For example, ':WAVeform:XML:READ? CHAN2A'
    returns binary data.
    datatype
        Set to unsigned bytes for internal format PyVisa's default is
        float. You can change datatype to whatever you need that is
        supported by PyVisa.
    is_big_endian
        FlexDCA's byte order is little-endian by default.
    ieee
        IEEE definite-length block header is automatically stripped
        from returned data.
    """
    global CHANNEL
    flexdca.read_termination = ''
    flexdca.write_termination = ''
    message = ':WAVeform:XML:READ? CHAN' + CHANNEL
    data = flexdca.query_binary_values(message, datatype='B', is_big_endian=False, container=bytes, delay=None, header_fmt='ieee')
    flexdca.read_termination = '\n'
    flexdca.write_termination = '\n'
    return data


def write_data_to_waveform_memory(flexdca, values):
    data = b''  # Python 3 byte string (bytes not unicode)
    flexdca.read_termination = ''
    flexdca.write_termination = ''
    message = ':WAVeform:XML:WRITe? WMEMory2,'
    flexdca.write_binary_values(message, values, datatype='B', is_big_endian=False, termination=None, encoding=None)
    # to satisfy ':WAVeform:XML:WRITe? WMEMory2,' as a query
    data = flexdca.read_raw()
    flexdca.read_termination = '\n'
    flexdca.write_termination = '\n'
    return


FlexDCA = open_flexdca_connection(ADDRESS)
setup(FlexDCA, CHANNEL)
data = b''  # Python 3 byte string (bytes not unicode)
data = get_binary_waveform_data(FlexDCA)
write_data_to_waveform_memory(FlexDCA, data)
with open('scope_waveform.wfmx', 'wb') as fout:
    fout.write(data)
FlexDCA.write('DISPlay:WINDow:TIME1:DMODe STILed')  # display channel and CGGS waveforms
FlexDCA.write(':SYSTem:GTLocal')
FlexDCA.close()