Page 1
LucidControl DI4DO4, User Manual (1.0) 2022/02/03 User Manual LucidControl DI4DO4 USB Module with 4 Digital Input and 4 Digital Output Channels Page 1 of 47...
A basic description of the LucidControl product family can be found in the general LucidControl User Manual. This document focuses on functions which are specific for the DI4DO4 USB IO module. 2 Setup and Installation Fig. 1 shows the sketch of the Digital DI4DO4 module with 4 digital input (DI0 to DI3) and 4 digital output (DO0 to DO3) channels.
LucidControl DI4DO4, User Manual (1.0) 2022/02/03 2.1 Safety Information LucidControl complies with regulations and industrial standards active in the EU. To keep the device functional, the following safety and maintenance information must be adhered. The device must only be used for the intended purpose.
LucidControl DI4DO4, User Manual (1.0) 2022/02/03 2.2 Configurations The digital output channels of the DI4DO4 are consist of solid-state relays. The digital input channels are available for different threshold levels: Threshold Level LowMax HighMin HighMax 2.5 V 3.5 V 7.5V 10 V 6.0 V...
2.3 Interface and Connection 2.3.1 USB Connection LucidControl USB modules are connected to the computer by using a USB 2.0 cable which must not extend a length of 5 m. They are bus powered what means that the host computer supplies the module with power.
LucidControl DI4DO4, User Manual (1.0) 2022/02/03 2.3.2.2 Digital Output Channels Fig. 3 shows the connection of the first digital output channel. When the output is activated, the SSR connects terminal 9 with terminal 10, closing the circuit and switching on the lamp in the shown application.
The LucidIoCtrl command line tool can be downloaded from our website: www.lucid-control.com/downloads This page provides the command line tool LucidIoCtrl for different architectures. Please see the section 3 of the general LucidControl User Manual for more information about LucidIoCtrl. 2.4.4 First Steps After the module was successfully installed, the green Power LED is switched on signaling that the module is ready for use.
Page 10
LucidControl DI4DO4, User Manual (1.0) 2022/02/03 Windows Examples Setting output channel number 4 to “1”. The module is connected to COM1 LucidIoCtrl -dCOM1 -tL -c4 -w1 [ENTER] Windows requires a different argument for comport numbers >= 10. LucidIoCtrl –d\\.\COM10 –tL –c4 –w1 [ENTER] Reading the states of all digital inputs and outputs LucidIoCtrl –dCOM1 –tL -c0,1,2,3,4,5,6,7 –r [ENTER]...
LucidControl DI4DO4, User Manual (1.0) 2022/02/03 3 Module Operation 3.1 Digital Input Channel Processing 3.1.1 Real-time Considerations Operating systems for personal computers are not made for deterministic real-time operation. Because of multitasking it cannot be ensured that a task will continue to run within a specified interval.
LucidControl DI4DO4, User Manual (1.0) 2022/02/03 In all modes the input values are captured and evaluated after a stable signal has been detected. 3.1.3.1 Reflect Mode The reflect mode acquires the logical input value. Fig. 4 illustrates the processing of the digital input channels in reflect mode.
LucidControl DI4DO4, User Manual (1.0) 2022/02/03 LucidIoCtrl Command Line Tool Example Set digital input channel 0 to Reflect Mode LucidIoCtrl –dCOM4 –c0 –sinDi0Mode=reflect [ENTER] 3.1.3.2 Edge Detection Digital input channels can operate in edge detection modes. In rising edge mode, the channel is sensitive for low-to-high transitions, in falling edge mode it recognizes high-to- low transitions.
LucidControl DI4DO4, User Manual (1.0) 2022/02/03 3.1.3.2.1 Rising Edge Detection Mode Fig. 7 shows a digital input signal and the corresponding input value in rising edge detection mode. After the HIGH input signal was detected as being valid, the input value remains pending until it was read by the host computer.
Page 15
LucidControl DI4DO4, User Manual (1.0) 2022/02/03 Fig. 9 illustrates a typical periodical input signal. In count mode all valid pulses are accumulated until the counting interval finishes. Count Fig. 9 Count Mode Fig. 10 shows the same input signal, but with a shorter count interval.
LucidControl DI4DO4, User Manual (1.0) 2022/02/03 Since the input value is updated after count interval has passed it takes 1 second to update the value. Decreasing the count interval results in a faster update of the input value. In Count Mode the value type N is supported. The count value is returned in hexadecimal and decimal format.
Page 17
LucidControl DI4DO4, User Manual (1.0) 2022/02/03 Fig. 11 shows a non-periodic input signal with 10 pulses in total. The counter value is read at 3 times. In the following it is explained how the options affect the count value. Fig. 11 Count Value Add Mode The value "Count"...
LucidControl DI4DO4, User Manual (1.0) 2022/02/03 3.2 Digital Output Channel Processing 3.2.1 Output Signal Value Inversion Digital output channels have an output signal value and a logical output value. The logical output value is the current state of the output which can be “0” (cleared) or “1” (set). The output signal value is calculated by the output handling.
LucidControl DI4DO4, User Manual (1.0) 2022/02/03 3.2.3 Operation Modes This section describes the operation of the different output modes and gives examples how the outputs can be controlled. Each of the outputs of the module can work in one of the following modes: •...
Page 20
LucidControl DI4DO4, User Manual (1.0) 2022/02/03 By switching an output periodically on and off it is e.g., possible to control the power consumed by a device and can be used for controlling the power of a pump or a heating element.
LucidControl DI4DO4, User Manual (1.0) 2022/02/03 Cancelation of On-Phase If output processing is stopped while the output is in on- phase (T ), IO Configuration Parameter outDi1CanCancel specifies the behavior of stopping If outDi1CanCancel is set to "off" the sequence completes as shown in Fig.
Page 22
LucidControl DI4DO4, User Manual (1.0) 2022/02/03 Setting the output value to “1” starts processing of the output handling by starting the interval (off-phase). After T has passed the output changes to on-phase and OnDelay OnDelay interval starts. After T time has passed output changes back to off-phase and...
Page 23
LucidControl DI4DO4, User Manual (1.0) 2022/02/03 restarts the T interval. OnHold LucidIoCtrl Command Line Tool Example Configure output channel 4 for On-Off mode LucidIoCtrl –dCOM4 –c4 –soutDi1Mode=onOff [ENTER] By default, T and T are set to 1s. OnDelay OnHold After writing a “1” to the output value of channel 0 the output will be set after 1s to “1”...
LucidControl DI4DO4, User Manual (1.0) 2022/02/03 3.3 Commands LucidControl IO Modules can be accessed by a protocol which is fully documented in the general LucidControl manual. This section describes in detail the commands, which are supported by the DI4DO4 module.
Status Length Status Returns Execution Status Code documented in the general LucidControl User Manual. 3.3.2 SetIoGroup This command sets the output values of a group of outputs. Tab. 6 lists the digital output channel modes and how the IO value is interpreted.
Page 26
LucidControl DI4DO4, User Manual (1.0) 2022/02/03 Command SetIoGroup Access Write Opcode 0x42 LucidIoCtrl Command Line Tool Call (-tL) LucidIoCtrl –d[COMx] –c[Channels] –tL –w[Values] Channels Comma separated list of channels e.g. –c4,5,6 Values Comma separated list of values to set e.g. -w1,1,0 LucidIoCtrl Command Line Tool Example Set output channel 4 to “1”, output channel 5 to “1”...
Page 27
Response Frame Status Length Status Returns Execution Status Code documented in the general LucidControl User Manual. Example of SetIoGroup The following request frame sets: • outputs 4 to “1”; output 5 to “1” and output 6 to “0” Request Frame...
LucidControl DI4DO4, User Manual (1.0) 2022/02/03 Response Frame Status Length 0x00 0x00 In case of an error, the command returns the Execution Status Code documented in the general LucidControl User Manual. 3.3.3 GetIo This command reads the value or state of an input or output channel.
Page 29
LucidControl DI4DO4, User Manual (1.0) 2022/02/03 Value Description Channel Number of input or output channel (Range: 0 to 3) Value Type Supported Value Types Value Type Value Range Response Len Digital Logic Value 0 / 1 1 Byte (0x00) Digital Counter Value...
LucidControl DI4DO4, User Manual (1.0) 2022/02/03 3.3.4 GetIoGroup This command reads the input or output values of a group of IO of the same Value Type. Tab. 6 lists the digital output channel modes and how the IO value is interpreted.
Page 31
LucidControl DI4DO4, User Manual (1.0) 2022/02/03 Value Description Channel Mask Specifies the IO channels to access Channel Bit Position Value 0x01 0x02 0x04 0x08 0x10 0x20 0x40 Channel P1A 0 P1=0x80 Mask P1A = 0x01 Values are bitwise or combined Size of P1 is 1 or 2 bytes.
The parameters are accessible by the SetParam and GetParam command which are described in the general LucidControl User Manual. The DI4DO4 modules mixes input and output channels what made it necessary to rename parameter names and change parameter addresses. 3.4.1 Digital Input Channels 3.4.1.1 inDi0Value...
LucidControl DI4DO4, User Manual (1.0) 2022/02/03 If inDi0Flags is changed by the SetParam command this must be done in a read-modify- write sequence in order to prevent overwriting other bit parameters. 3.4.1.3.1 inDi0Inverted This Bit Parameter configures the input signal value inversion.
LucidControl DI4DO4, User Manual (1.0) 2022/02/03 Read counter add setting of input channel 0 LucidIoCtrl –dCOM4 –c0 –ginDi0AddCounter [ENTER] inDi0AddCounter=on 3.4.1.3.3 inDi0ResetCounterOnRead This Bit Parameter controls how to update the counter value after it was read. It is relevant in Count Mode only.
LucidControl DI4DO4, User Manual (1.0) 2022/02/03 3.4.2 Digital Output Channels 3.4.2.1 outDi1Value This IO Configuration Parameter reflects the value or the state of the output (see Tab. 6). In the case the output is in Reflect mode the outDi1Value contains the logic value of the output.
LucidControl DI4DO4, User Manual (1.0) 2022/02/03 3.4.2.3 Bit Parameter outDi1Flags This IO Configuration Parameter groups configuration settings which are represented by one bit. Parameter outDi1Flags Access Read / Write Address 0x1901 The “bit container” consists of the following parameters. Bit Parameter...
LucidControl DI4DO4, User Manual (1.0) 2022/02/03 This Bit Parameter configures the output on-phase cancelation. Parameter outDi1Flags Access Read / Write Address 0x1901 Bit Parameter outDi1Flags Bit Parameter Bit Postion Values outDi1CanCancel Bit 1 Default Value Parameter Type 1 Bit LucidIoCtrl Command Line Tool...
LucidControl DI4DO4, User Manual (1.0) 2022/02/03 3.4.2.4 outDi1CycleTime This IO Configuration Parameter specifies the cycle time T of an output in Duty-Cycle Cycle Mode. Parameter outDi1CycleTime Access Read / Write Address 0x1910 Values in µs (micro seconds) Cycle ≤ T ≤...
LucidControl DI4DO4, User Manual (1.0) 2022/02/03 3.4.2.6 outDi1OnDelay This IO Configuration Parameter specifies the on-delay time T of an output in On-Off OnDelay Mode. Parameter outDi1OnDelay Access Read / Write Address 0x1912 Values in µs (micro seconds) OnDelay ≤ T ≤...
Page 43
LucidControl DI4DO4, User Manual (1.0) 2022/02/03 Note Timing limits (see 3.2.2) have to be considered. Page 43 of 47...
LucidControl DI4DO4, User Manual (1.0) 2022/02/03 4 Specification Parameter Condition Value Inputs No of Input Channels Inputs - Electrical Characteristics 2.5 V 05MaxLow Input Signal Maximum Low 6.0 V 10MaxLow Level 16.0 V 24MaxLow 3.5 V 05MinHigh Input Signal Minimum High 8.5 V...
Page 45
LucidControl DI4DO4, User Manual (1.0) 2022/02/03 Temperature Storage -20 °C … +70 °C Operation 0 °C … +55 °C Humidity < 85 % RH, non-condensing Module – Housing Dimensions L x W x H 90 x 54 x 62 mm...
2022/02/03 5 Order Information Format of order code: LCTR-DI4-voltage-DO4-I Order Code Product LucidControl USB IO Module with 4 insulated 5V LCTR-DI4-5-DO4-I Input Channels and 4 Solid State Relay (SSR) Output Channels LucidControl USB IO Module with 4 insulated 10V LCTR-DI4-10-DO4-I...
Need help?
Do you have a question about the DI4DO4 and is the answer not in the manual?
Questions and answers