nidaqmx.task.do_channel

class nidaqmx._task_modules.channels.do_channel.DOChannel(task_handle, virtual_or_physical_name, interpreter)[source]

Bases: Channel

Represents one or more digital output virtual channels and their properties.

property chan_type

Indicates the type of the virtual channel.

Type:

nidaqmx.constants.ChannelType

property channel_names

Specifies the unflattened list of the virtual channels.

Type:

List[str]

property description

Specifies a user-defined description for the channel.

Type:

str

property do_data_xfer_mech

nidaqmx.constants.DataTransferActiveTransferMode: Specifies the data transfer mode for the device.

property do_data_xfer_req_cond

nidaqmx.constants.OutputDataTransferCondition: Specifies under what condition to transfer data from the buffer to the onboard memory of the device.

property do_generate_on

nidaqmx.constants.ActiveOrInactiveEdgeSelection: Specifies on which edge of the sample clock to generate samples.

property do_invert_lines

Specifies whether to invert the lines in the channel. If you set this property to True, the lines are at high logic when off and at low logic when on.

Type:

bool

property do_line_states_done_state

Specifies the state of the lines in a digital output task when the task completes execution.

Type:

nidaqmx.constants.Level

property do_line_states_paused_state

Specifies the state of the lines in a digital output task when the task pauses.

Type:

nidaqmx.constants.Level

property do_line_states_start_state

Specifies the state of the lines in a digital output task when the task starts.

Type:

nidaqmx.constants.Level

property do_logic_family

Specifies the logic family to use for generation. A logic family corresponds to voltage thresholds that are compatible with a group of voltage standards. Refer to the device documentation for information on the logic high and logic low voltages for these logic families.

Type:

nidaqmx.constants.LogicFamily

property do_mem_map_enable

Specifies for NI-DAQmx to map hardware registers to the memory space of the application, if possible. Normally, NI- DAQmx maps hardware registers to memory accessible only to the kernel. Mapping the registers to the memory space of the application increases performance. However, if the application accesses the memory space mapped to the registers, it can adversely affect the operation of the device and possibly result in a system crash.

Type:

bool

property do_num_lines

Indicates the number of digital lines in the channel.

Type:

int

property do_output_drive_type

Specifies the drive type for digital output channels.

Type:

nidaqmx.constants.DigitalDriveType

property do_overcurrent_auto_reenable

Specifies whether to automatically reenable channels after they no longer exceed the current limit specified by do_overcurrent_limit.

Type:

bool

property do_overcurrent_limit

Specifies the current threshold in Amperes for the channel. A value of 0 means the channel observes no limit. Devices can monitor only a finite number of current thresholds simultaneously. If you attempt to monitor additional thresholds, NI-DAQmx returns an error.

Type:

float

property do_overcurrent_reenable_period

Specifies the delay in seconds between the time a channel no longer exceeds the current limit and the reactivation of that channel, if do_overcurrent_auto_reenable is True.

Type:

float

property do_tristate

Specifies whether to stop driving the channel and set it to a high-impedance state. You must commit the task for this setting to take effect.

Type:

bool

property do_usb_xfer_req_count

Specifies the maximum number of simultaneous USB transfers used to stream data. Modify this value to affect performance under different combinations of operating system and device.

Type:

int

property do_usb_xfer_req_size

Specifies the maximum size of a USB transfer request in bytes. Modify this value to affect performance under different combinations of operating system and device.

Type:

int

property do_use_only_on_brd_mem

Specifies whether to write samples directly to the onboard memory of the device, bypassing the memory buffer. Generally, you cannot update onboard memory after you start the task. Onboard memory includes data FIFOs.

Type:

bool

property is_global

Indicates whether the channel is a global channel.

Type:

bool

property name

Specifies the name of the virtual channel this object represents.

Type:

str

property physical_channel

nidaqmx.system.physical_channel.PhysicalChannel: Specifies the name of the physical channel upon which this virtual channel is based.

save(save_as='', author='', overwrite_existing_channel=False, allow_interactive_editing=True, allow_interactive_deletion=True)

Saves this local or global channel to MAX as a global channel.

Parameters:
  • save_as (Optional[str]) – Is the name to save the task, global channel, or custom scale as. If you do not specify a value for this input, NI-DAQmx uses the name currently assigned to the task, global channel, or custom scale.

  • author (Optional[str]) – Is a name to store with the task, global channel, or custom scale.

  • overwrite_existing_channel (Optional[bool]) – Specifies whether to overwrite a global channel of the same name if one is already saved in MAX. If this input is False and a global channel of the same name is already saved in MAX, this function returns an error.

  • allow_interactive_editing (Optional[bool]) – Specifies whether to allow the task, global channel, or custom scale to be edited in the DAQ Assistant. If allow_interactive_editing is True, the DAQ Assistant must support all task or global channel settings.

  • allow_interactive_deletion (Optional[bool]) – Specifies whether to allow the task, global channel, or custom scale to be deleted through MAX.

property sync_unlock_behavior

Specifies the action to take if the target loses its synchronization to the grand master.

Type:

nidaqmx.constants.SyncUnlockBehavior