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
|
from typing import Tuple, Sequence, Optional
import numpy as np
from public import public
@public
class Scope(object):
"""An oscilloscope."""
def open(self) -> None:
"""Open the connection to the scope."""
raise NotImplementedError
@property
def channels(self) -> Sequence[str]:
"""A list of channels available on this scope."""
raise NotImplementedError
def setup_frequency(self, frequency: int, pretrig: int, posttrig: int) -> Tuple[int, int]:
"""
Setup the frequency and sample count for the measurement. The scope might not support
the requested values and will adjust them to get the next best frequency and the largest
supported number of samples (or the number of samples requested).
:param frequency: The requested frequency in Hz.
:param pretrig: The requested number of samples to measure before the trigger.
:param posttrig: The requested number of samples to measure after the trigger.
:return: A tuple of the actual set frequency and the actual number of samples.
"""
raise NotImplementedError
def setup_channel(self, channel: str, coupling: str, range: float, enable: bool) -> None:
"""
Setup a channel to use the coupling method and measure the given voltage range.
:param channel: The channel to measure.
:param coupling: The coupling method ("AC" or "DC).
:param range: The voltage range to measure.
:param enable: Whether to enable or disable the channel.
"""
raise NotImplementedError
def setup_trigger(self, channel: str, threshold: float, direction: str, delay: int,
timeout: int, enable: bool) -> None:
"""
Setup a trigger on a particular `channel`, the channel has to be set up and enabled.
The trigger will fire based on the `threshold` and `direction`, if enabled, the trigger
will capture after `delay` ticks pass. If trigger conditions do not hold it will fire
automatically after `timeout` milliseconds.
:param channel: The channel to trigger on.
:param threshold: The value to trigger on.
:param direction: The direction to trigger on ("above", "below", "rising", "falling").
:param delay: The delay for capture after trigger (clock ticks).
:param timeout: The timeout in milliseconds.
:param enable: Whether to enable or disable this trigger.
"""
raise NotImplementedError
def setup_capture(self, channel: str, enable: bool) -> None:
"""
Setup the capture for a channel.
:param channel: The channel to capture.
:param enable: Whether to enable or disable capture.
"""
raise NotImplementedError
def arm(self) -> None:
"""Arm the scope, it will listen for the trigger after this point."""
raise NotImplementedError
def capture(self, timeout: Optional[int] = None) -> bool:
"""
Wait for the trace to capture, this will block until the scope has a trace.
:param timeout: A time in milliseconds to wait for the trace, returns `None` if it runs out.
:return: Whether capture was successful (or it timed out).
"""
raise NotImplementedError
def retrieve(self, channel: str) -> Optional[np.ndarray]:
"""
Retrieve a captured trace of a channel.
:param channel: The channel to retrieve the trace from.
:return: The captured trace (if any).
"""
raise NotImplementedError
def stop(self) -> None:
"""Stop the capture, if any."""
raise NotImplementedError
def close(self) -> None:
"""Close the connection to the scope."""
raise NotImplementedError
|
