API Reference v9.2.0
DeviceIOclass
Module: zaber_motion.ascii
Class providing access to the I/O channels of the device.
The following example illustrates how you can obtain an instance of this type:
from zaber_motion.ascii import Connection
connection = Connection.open_serial_port('COM3')
device = connection.get_device(1)
device_io = device.ioRelated Guides:
Index
mMethods
Methods
m
device_io.cancel_all_analog_outputs_schedule(channels = [])Cancel all scheduled analog output actions.
Requires at least Firmware 7.38.
Arguments
| Name | Type | Description |
|---|---|---|
| channels | List[bool] | Optionally specify which channels to cancel. Array length must be empty or equal to the number of channels on device. Specifying "True" for a channel will cancel the scheduled analog output value for that channel. |
m
device_io.cancel_all_digital_outputs_schedule(channels = [])Cancel all scheduled digital output actions.
Requires at least Firmware 7.37.
Arguments
| Name | Type | Description |
|---|---|---|
| channels | List[bool] | Optionally specify which channels to cancel. Array length must be empty or equal to the number of channels on device. Specifying "True" for a channel will cancel the scheduled digital output action for that channel. |
m
m
m
m
m
m
m
device_io.get_all_labels()Returns every label assigned to an IO port on this device.
Return Value
List[IoPortLabel] The labels set for this device's IO.m
m
m
device_io.get_channels_info()Returns the number of I/O channels the device has.
Return Value
DeviceIOInfo An object containing the number of I/O channels the device has.m
device_io.get_digital_input(channel_number)Returns the current value of the specified digital input channel.
Arguments
| Name | Type | Description |
|---|---|---|
| channel_number | int | Channel number starting at 1. |
Return Value
bool True if voltage is present on the input channel and false otherwise.m
m
device_io.get_label(port_type, channel_number)Returns the label of the specified channel.
Arguments
| Name | Type | Description |
|---|---|---|
| port_type | IoPortType | The type of channel to get the label of. |
| channel_number | int | Channel number starting at 1. |
Return Value
str The label of the specified channel.m
m
device_io.set_all_analog_outputs_schedule(values, future_values, delay, unit = Units.NATIVE)Sets current and future values for all analog output channels.
Requires at least Firmware 7.38.
Arguments
| Name | Type | Description |
|---|---|---|
| values | List[float] | Voltage values to set the output channels to immediately. |
| future_values | List[float] | Voltage values to set the output channels to in the future. |
| delay | float | Delay between setting current values and setting future values. |
| unit | TimeUnits | Units of time. |
m
device_io.set_all_digital_outputs(values)Sets values for all digital output channels.
Arguments
| Name | Type | Description |
|---|---|---|
| values | List[DigitalOutputAction] | The type of action to perform on the channel. |
m
device_io.set_all_digital_outputs_schedule(values, future_values, delay, unit = Units.NATIVE)Sets current and future values for all digital output channels.
Requires at least Firmware 7.37.
Arguments
| Name | Type | Description |
|---|---|---|
| values | List[DigitalOutputAction] | The type of actions to perform immediately on output channels. |
| future_values | List[DigitalOutputAction] | The type of actions to perform in the future on output channels. |
| delay | float | Delay between setting current values and setting future values. |
| unit | TimeUnits | Units of time. |
m
device_io.set_analog_input_lowpass_filter(channel_number, cutoff_frequency, unit = Units.NATIVE)Sets the cutoff frequency of the low-pass filter for the specified analog input channel. Set the frequency to 0 to disable the filter.
Arguments
| Name | Type | Description |
|---|---|---|
| channel_number | int | Channel number starting at 1. |
| cutoff_frequency | float | Cutoff frequency of the low-pass filter. |
| unit | FrequencyUnits | Units of frequency. |
m
m
device_io.set_analog_output_schedule(channel_number, value, future_value, delay, unit = Units.NATIVE)Sets current and future value for the specified analog output channel.
Requires at least Firmware 7.38.
Arguments
| Name | Type | Description |
|---|---|---|
| channel_number | int | Channel number starting at 1. |
| value | float | Value to set the output channel voltage to immediately. |
| future_value | float | Value to set the output channel voltage to in the future. |
| delay | float | Delay between setting current value and setting future value. |
| unit | TimeUnits | Units of time. |
m
device_io.set_digital_output(channel_number, value)Sets value for the specified digital output channel.
Arguments
| Name | Type | Description |
|---|---|---|
| channel_number | int | Channel number starting at 1. |
| value | DigitalOutputAction | The type of action to perform on the channel. |
m
device_io.set_digital_output_schedule(channel_number, value, future_value, delay, unit = Units.NATIVE)Sets current and future value for the specified digital output channel.
Requires at least Firmware 7.37.
Arguments
| Name | Type | Description |
|---|---|---|
| channel_number | int | Channel number starting at 1. |
| value | DigitalOutputAction | The type of action to perform immediately on the channel. |
| future_value | DigitalOutputAction | The type of action to perform in the future on the channel. |
| delay | float | Delay between setting current value and setting future value. |
| unit | TimeUnits | Units of time. |
m
device_io.set_label(port_type, channel_number, label)Sets the label of the specified channel.
Arguments
| Name | Type | Description |
|---|---|---|
| port_type | IoPortType | The type of channel to set the label of. |
| channel_number | int | Channel number starting at 1. |
| label | Optional[str] | The label to set for the specified channel. If no value or an empty string is provided, this label is deleted. |