Digital IO Control
- 06 Sep 2024
- 5 Minutes to read
- Print
- PDF
Digital IO Control
- Updated on 06 Sep 2024
- 5 Minutes to read
- Print
- PDF
Article summary
Did you find this summary helpful?
Thank you for your feedback
Functional scope
This section shows the capabilities of digital IO lines.
allPIXA evo
This table contains the supported LineMode and LineFormat entries for each supported line.
Line | LineMode | LineFormat | Comment |
Line1 | Input | RS422 | |
Line1 | Output | Not Supported | Output mode not supported |
Line2 | Input | RS422 | |
Line2 | Output | Not Supported | Output mode not supported |
Line3 | Input | SingleEnded_3V3 | |
Line3 | Output | SingleEnded_3V3 | |
Line4 | Input | SingleEnded_3V3 | |
Line4 | Output | SingleEnded_3V3 | |
Line5 | Input | SingleEnded_3V3 | |
Line5 | Output | SingleEnded_3V3 | |
Line6 | Input | SingleEnded_3V3 | |
Line6 | Output | SingleEnded_3V3 | |
Line7 | Input | SingleEnded_3V3 | |
Line7 | Output | SingleEnded_3V3 | |
Line8 | Input | SingleEnded_3V3 | |
Line8 | Output | SingleEnded_3V3 | |
Line9 | Input | SingleEnded_3V3 | |
Line9 | Output | SingleEnded_3V3 | |
Line10 | Input | Not Supported | Input mode not supported |
Line10 | Output | Misc | |
Line11 | Input | SingleEnded_3V3 | |
Line11 | Output | SingleEnded_3V3 |
This table contains the supported LineSource entries for each supported line.
Line | LineSource |
Line1 | Not Supported |
Line2 | Not Supported |
Line3 | Off FrameActive LineActive |
Line4 | Off FrameActive LineActive |
Line5 | Off FrameActive LineActive FlashOut1 |
Line6 | Off FrameActive LineActive FlashOut2 |
Line7 | Off FrameActive LineActive FlashOut3 |
Line8 | Off FrameActive LineActive FlashOut4 |
Line9 | Off FrameActive LineActive MSOut |
Line10 | Fan |
Line11 | Off MSOut |
allPIXA neo
This table contains the supported LineMode and LineFormat entries for each supported line.
Line | LineMode | LineFormat | Comment |
Line1 | Input | RS422 RS422_NoTerm SingleEnded_3V3 SingleEnded_5V SingleEnded_12V SingleEnded_24V | |
Line1 | Output | Not Supported | Output mode not supported. |
Line2 | Input | RS422 RS422_NoTerm SingleEnded_3V3 SingleEnded_5V SingleEnded_12V SingleEnded_24V | |
Line2 | Output | Not Supported | Output mode not supported. |
Line3 | Input | RS422 RS422_NoTerm SingleEnded_3V3 SingleEnded_5V SingleEnded_12V SingleEnded_24V | |
Line3 | Output | RS422 SingleEnded_3V3 | |
Line4 | Input | RS422 RS422_NoTerm SingleEnded_3V3 SingleEnded_5V SingleEnded_12V SingleEnded_24V | |
Line4 | Output | RS422 SingleEnded_3V3 | |
Line5 | Input | NoConnect SingleEnded_3V3 | |
Line5 | Output | NoConnect SingleEnded_3V3 RS422 | |
Line6 | Input | NoConnect SingleEnded_3V3 | |
Line6 | Output | NoConnect SingleEnded_3V3 RS422 | |
Line7 | Input | NoConnect SingleEnded_3V3 | If Line5 format is configured as RS422 then Line7 is not available. |
Line7 | Output | NoConnect SingleEnded_3V3 | |
Line8 | Input | NoConnect SingleEnded_3V3 | If Line6 format is configured as RS422 then Line8 is not available. |
Line8 | Output | NoConnect SingleEnded_3V3 | |
Line9 | Input | Not Supported | Input mode not supported |
Line9 | Output | Misc |
This table contains the supported LineSource entries for each supported line.
Line | LineSource |
Line1 | Not Supported |
Line2 | Not Supported |
Line3 | Off FrameActive LineActive UserOutput3 LineTrigger FrameTrigger Exposure |
Line4 | Off FrameActive LineActive UserOutput4 LineTrigger FrameTrigger Exposure |
Line5 | Off FrameActive LineActive UserOutput5 LineTrigger FrameTrigger Exposure |
Line6 | Off FrameActive LineActive UserOutput6 LineTrigger FrameTrigger Exposure |
Line7 | Off FrameActive LineActive UserOutput7 |
Line8 | Off FrameActive LineActive UserOutput7 |
Line9 | Fan UART0 |
Line Selector
Name | LineSelector | Standard |
Description | Selects the physical line (or pin) of the external device connector. | |
Interface | Enumeration | |
Access mode | Read/Write | |
Adjustable while grabbing | Yes | |
Value range | See enum entries table below. | |
Default value | Line1 | |
Availability | See enum entries table below. | |
Notes | Also check allPIXA evo and allPIXA neo for availability. | |
Error behavior | See the device error code documentation. | |
Line Selector Enum Entries:
Name | Availability | Description |
Line1 | Selects Line1 | |
Line2 | Selects Line2 | |
Line3 | Selects Line3 | |
Line4 | Selects Line4 | |
Line5 | Selects Line5 | |
Line6 | Selects Line6 | |
Line7 | Selects Line7 | |
Line8 | Selects Line8 | |
Line9 | Selects Line9 | |
Line10 | Selects Line10 | |
Line11 | Selects Line11 |
Line Mode
Name | LineMode[LineSelector] | Standard |
Description | Controls whether the physical line is used to input or output a signal. | |
Interface | Enumeration | |
Access mode | Read/Write | |
Adjustable while grabbing | Yes | |
Value range | See enum entries table below. | |
Default value | Input | |
Notes | - | |
Error behavior | See the device error code documentation. | |
Line Mode Enum Entries:
Name | Description |
Input | The selected physical line is used to Input an electrical signal |
Output | The selected physical line is used to Output an electrical signal |
Line Inverter
Name | LineInverter[LineSelector] | Standard |
Description | Controls the inversion of the signal of the selected input or output Line. | |
Interface | Boolean | |
Access mode | Read/Write | |
Adjustable while grabbing | Yes | |
Value range | True – The Line signal is inverted False – The Line signal is not inverted | |
Default value | False | |
Availability | ||
Notes | - | |
Error behavior | See the device error code documentation. | |
Line Status
Name | LineStatus[LineSelector] | Standard |
Description | Returns the current status of the selected input or output Line. | |
Interface | Boolean | |
Access mode | Read only | |
Adjustable while grabbing | - | |
Value range | - | |
Default value | True – The level of the Line signal is High False – The level of the Line signal is low | |
Availability | ||
Notes | - | |
Error behavior | - | |
Line Source
Name | LineSource[LineSelector] | Standard |
Description | Selects which internal acquisition or I/O source signal to output on the selected Line. LineMode must be output. | |
Interface | Enumeration | |
Access mode | Read/Write | |
Adjustable while grabbing | Yes | |
Value range | See enum entries table below. | |
Default value | Off | |
Availability | See enum entries table below. | |
Notes | Also check allPIXA evo and allPIXA neo for availability. | |
Error behavior | See the device error code documentation. | |
Line Source Enum Entries:
Name | Availability | Description |
Off | Line output is disabled | |
FlashOut1 | Line output is Flash out 1 state. | |
FlashOut2 | Line output is Flash out 2 state. | |
FlashOut3 | Line output is Flash out 3 state. | |
FlashOut4 | Line output is Flash out 4 state. | |
FrameActive | Line output is Frame active state. | |
LineActive | Line output is Line active state. | |
MSOut | Line output is MasterSlave out state. | |
UserOutput3 | The UserOutput3 bit state as defined by its current UserOutputValue. | |
UserOutput4 | The UserOutput4 bit state as defined by its current UserOutputValue. | |
UserOutput5 | The UserOutput5 bit state as defined by its current UserOutputValue. | |
UserOutput6 | The UserOutput6 bit state as defined by its current UserOutputValue. | |
UserOutput7 | The UserOutput7 bit state as defined by its current UserOutputValue. | |
UserOutput8 | The UserOutput8 bit state as defined by its current UserOutputValue. | |
Fan | Line output is Fan | |
UART0 | Line output is UART | |
LineTrigger | Device is receiving a Line start trigger | |
FrameTrigger | Device is receiving a Frame start trigger | |
Exposure | Line output is Exposure |
Line Format
Name | LineFormat[LineSelector] | Standard |
Description | Controls the current electrical format of the selected physical input or output line. | |
Interface | Enumeration | |
Access mode | Read/Write | |
Adjustable while grabbing | Yes | |
Value range | See enum entries table below. | |
Default value | It depends on the LineSelector and the variant. | |
Availability | See enum entries table below. | |
Notes | Also check allPIXA evo and allPIXA neo for availability. | |
Error behavior | See the device error code documentation. | |
Line Format Enum Entries:
Name | Availability | Description |
NoConnect | The line is not connected. | |
SingleEnded_3V3 | The line is single ended input or output for 3.3V. Input signals less than 1.5V are considered as level low, signals higher than 1.5V as level high. | |
SingleEnded_5V | The line is single ended input for 5.0V or output for 3.3V. Input signals less than 2.5V are considered as level low, signals higher than 2.5V as level high. | |
SingleEnded_12V | The line is single ended input for 12.0V or output for 3.3V. Input signals less than 5.0V are considered as level low, signals higher than 5.0V as level high. | |
SingleEnded_24V | The line is single ended input for 24.0V or output for 3.3V. Input signals less than 5.0V are considered as level low, signals higher than 5.0V as level high. | |
RS422_NoTerm | The line is currently accepting or sending RS422 level signals with no electrical termination. | |
RS422 | The line is currently accepting or sending RS422 level signals. | |
Misc | The line is a special one |
UserOutput Selector
Name | UserOutputSelector | Standard |
Description | Selects which bit of the User Output register will be set by UserOutputValue. | |
Interface | Enumeration | |
Access mode | Read/Write | |
Adjustable while grabbing | Yes | |
Value range | See enum entries table below. | |
Default value | UserOutput3 | |
Notes | - | |
Error behavior | See the device error code documentation. | |
UserOutput Selector Enum Entries:
Name | Description |
UserOutput3 | Select the bit 3 of the User Output register. |
UserOutput4 | Select the bit 4 of the User Output register. |
UserOutput5 | Select the bit 5 of the User Output register. |
UserOutput6 | Select the bit 6 of the User Output register. |
UserOutput7 | Select the bit 7 of the User Output register. |
UserOutput8 | Select the bit 8 of the User Output register. |
UserOutput Value
Name | UserOutputValue[UserOutputSelector] | Standard |
Description | Sets the value of the bit selected by UserOutputSelector. | |
Interface | Boolean | |
Access mode | Read/Write | |
Adjustable while grabbing | Yes | |
Value range | True – The selected UserOutput bit set to 1 False – The selected UserOutput bit set to 0 | |
Default value | False | |
Availability | ||
Notes | - | |
Error behavior | See the device error code documentation. | |
Trigger Activation
Name | IOAnalyzerTriggerActivation | Custom |
Description | Selects the trigger condition for sampling. | |
Interface | Enumeration | |
Access mode | Read/Write | |
Adjustable while grabbing | Yes | |
Value range | See enum entries table below. | |
Default value | Auto | |
Availability | ||
Notes | - | |
Error behavior | See the device error code documentation. | |
Trigger Activation Enum Entries:
Name | Description |
Auto | Auto |
FallingEdgeChA | Falling Edge Channel A |
RisingEdgeChA | Rising Edge Channel A |
FallingEdgeChB | Falling Edge Channel B |
RisingEdgeChB | Rising Edge Channel B |
FallingEdgeChAorB | Falling Edge Channel A or Channel B |
RisingEdgeChAorB | Rising Edge Channel A or Channel B |
Source Channel A
Name | IOAnalyzerSourceChannelA | Custom |
Description | Selects an analyzer source for channel A. | |
Interface | Enumeration | |
Access mode | Read/Write | |
Adjustable while grabbing | Yes | |
Value range | See enum entries table below. | |
Default value | Off | |
Availability | ||
Notes | - | |
Error behavior | See the device error code documentation. | |
Source Channel A Enum Entries:
Name | Description |
Off | Off |
Line1 | Line1 |
Line2 | Line2 |
Line3 | Line3 |
Line4 | Line4 |
Line5 | Line5 |
Line6 | Line6 |
Line7 | Line7 |
Line8 | Line8 |
Line9 | Line9 |
LinkTrigger0 | LinkTrigger0 |
LinkTrigger1 | LinkTrigger1 |
Source Channel B
Name | IOAnalyzerSourceChannelB | Custom |
Description | Selects an analyzer source for channel B. | |
Interface | Enumeration | |
Access mode | Read/Write | |
Adjustable while grabbing | Yes | |
Value range | See enum entries table below. | |
Default value | Off | |
Availability | ||
Notes | - | |
Error behavior | See the device error code documentation. | |
Source Channel B Enum Entries:
Name | Description |
Off | Off |
Line1 | Line1 |
Line2 | Line2 |
Line3 | Line3 |
Line4 | Line4 |
Line5 | Line5 |
Line6 | Line6 |
Line7 | Line7 |
Line8 | Line8 |
Line9 | Line9 |
LinkTrigger0 | LinkTrigger0 |
LinkTrigger1 | LinkTrigger1 |
Start Sampling
Name | IOAnalyzerStartSampling | Custom |
Description | Starts sampling for the selected trigger condition. | |
Interface | Command | |
Access mode | Read/Write | |
Adjustable while grabbing | Yes | |
Value range | See enum entries table below. | |
Default value | 1 | |
Availability | ||
Notes | - | |
Error behavior | See the device error code documentation. | |
Stop Sampling
Name | IOAnalyzerStopSampling | Custom |
Description | Stops sampling for the selected trigger condition. | |
Interface | Command | |
Access mode | Read/Write | |
Adjustable while grabbing | Yes | |
Value range | See enum entries table below. | |
Default value | 1 | |
Availability | ||
Notes | - | |
Error behavior | See the device error code documentation. | |
Sample Rate Reduction
Name | IOAnalyzerSampleRateReduction | Custom |
Description | Selects the sample rate reduction factor. | |
Interface | Enumeration | |
Access mode | Read/Write | |
Adjustable while grabbing | Yes | |
Value range | See enum entries table below. | |
Default value | ReductionFactor_1 | |
Availability | ||
Notes | - | |
Error behavior | See the device error code documentation. | |
Sample Rate Reduction Enum Entries:
Name | Description |
ReductionFactor_1 | No sample rate reduction |
ReductionFactor_10 | Sample rate reduction by factor 10 |
ReductionFactor_100 | Sample rate reduction by factor 100 |
ReductionFactor_1000 | Sample rate reduction by factor 1000 |
Sample Rate
Name | IOAnalyzerSampleRate | Custom |
Description | Displays the sample rate in Hz. | |
Interface | Float | |
Access mode | Read Only | |
Adjustable while grabbing | No | |
Value range | - | |
Default value | - | |
Availability | ||
Notes | - | |
Error behavior | See the device error code documentation. | |
Trigger Position
Name | IOAnalyzerTriggerPosition | Custom |
Description | Selects the trigger position for an io analyzer. | |
Interface | Integer | |
Access mode | Read/Write | |
Adjustable while grabbing | Yes | |
Value range | [0, 2047] | |
Default value | 0 | |
Availability | ||
Notes | - | |
Error behavior | See the device error code documentation. | |
IO Analyzer State
Name | IOAnalyzerState | Custom |
Description | Displays the state of an IO analyzer. | |
Interface | Enumeration | |
Access mode | Read Only | |
Adjustable while grabbing | No | |
Value range | See enum entries table below. | |
Default value | PreEventSampling | |
Availability | ||
Notes | - | |
Error behavior | See the device error code documentation. | |
IO Analyzer State Enum Entries:
Name | Description |
PreEventSampling | An IO Analyzer is in pre-event sampling state. |
WaitForTrigger | An IO Analyzer is waiting for the trigger. |
Sampling | An IO Analyzer is sampling the signal. |
Finished | An IO Analyzer is stopped manually, or the buffer is full. |
IO Analyzer State
Name | IOAnalyzerState | Custom |
Description | Displays the state of an IO analyzer. | |
Interface | Enumeration | |
Access mode | Read Only | |
Adjustable while grabbing | No | |
Value range | See enum entries table below. | |
Default value | PreEventSampling | |
Availability | ||
Notes | - | |
Error behavior | See the device error code documentation. | |
IO Analyzer State Enum Entries:
Name | Description |
PreEventSampling | An IO Analyzer is in pre-event sampling state. |
WaitForTrigger | An IO Analyzer is waiting for the trigger. |
Sampling | An IO Analyzer is sampling the signal. |
Finished | An IO Analyzer is stopped manually, or the buffer is full. |
IO Analyzer Status
Name | IOAnalyzerStatus | Custom |
Description | Displays the status of an IO analyzer. | |
Interface | Enumeration | |
Access mode | Read Only | |
Adjustable while grabbing | No | |
Value range | See enum entries table below. | |
Default value | AnalyzerInactive | |
Availability | ||
Notes | - | |
Error behavior | See the device error code documentation. | |
IO Analyzer Status Enum Entries:
Name | Description |
AnalyzerInactive | Analyzer is not active. |
AnalyzerInProgress | Analyzer is either waiting for trigger or sampling. |
Success | Sampling finished successfully. |
Warning | An IO Analyzer is finished with warning. |
AliasingWarning | Could not sample all the signal transition. |
Event Count
Name | IOAnalyzerEventCount | Custom |
Description | Displays the valid IO analyzer events occurred. | |
Interface | Integer | |
Access mode | Read Only | |
Adjustable while grabbing | No | |
Value range | [0, 2048] | |
Default value | 2048 | |
Availability | ||
Notes | - | |
Error behavior | See the device error code documentation. | |
Was this article helpful?