I-8024UW / I-8028UW
I-9024U / I-9028U
Linux API Reference Manual
V 2.0.1 July 2020
Written by Edward Ku
Edited by Cindy Huang
Warranty
All products manufactured by ICP DAS are under warranty regarding defective materials for a period
of one year, beginning from the date of delivery to the original purchaser.
Warning
ICP DAS assumes no liability for any damage resulting from the use of this product. ICP DAS reserves
the right to change this manual at any time without notice. The information furnished by ICP DAS is
believed to be accurate and reliable. However, no responsibility is assumed by ICP DAS for its use,
nor for any infringements of patents or other rights of third parties resulting from its use.
Copyright
Copyright © 2018 by ICP DAS Co., Ltd. All rights are reserved.
Trademarks
Names are used for identification purposes only and may be registered trademarks of their
respective companies.
Contact Us
If you have any problems, please feel free to contact us.
You can count on us for a quick response.
Email: service@icpdas.com
I-8024UW/I-8028UW/I-9024U/I-9028U Module Linux API User Manual, v2.0.1
P. 2
Table of Contents
Table of Contents ........................................................................................................................................... 3
1. Introduction ........................................................................................................................................... 5
1.1. Specifications .................................................................................................................................. 7
1.2. Pin Assignments .............................................................................................................................. 8
1.3. Jumper Setting .............................................................................................................................. 10
1.4. Wire Connections ......................................................................................................................... 11
1.5. Block Diagram ............................................................................................................................... 12
1.6. Dimensions ................................................................................................................................... 13
2. Quick Start ........................................................................................................................................... 14
3. Power-on Mode ................................................................................................................................... 16
3.1. Power-on Value Mode .................................................................................................................. 18
3.2. Retentive Mode ............................................................................................................................ 19
4. Watchdog ............................................................................................................................................. 20
5. API References ..................................................................................................................................... 25
5.1. i8028U_Init ................................................................................................................................... 27
5.2. i8028U_GetFirmwareVersion ....................................................................................................... 28
5.3. i8028U_GetLibVersion .................................................................................................................. 29
5.4. i8028U_ReadAO_GainOffset ........................................................................................................ 30
5.5. i8028U_WriteAOHex ..................................................................................................................... 32
5.6. i8028U_WriteAO ........................................................................................................................... 34
5.7. i8028U_ReadAOHex ...................................................................................................................... 36
5.8. i8028U_ReadAO ............................................................................................................................ 38
5.9. i8028U_SetPowerOnEnStatus ...................................................................................................... 40
5.10. i8028U_GetPowerOnEnStatus .................................................................................................... 41
5.11. i8028U_WritePowerOnHex_AO .................................................................................................. 42
5.12. i8028U_WritePowerOn_AO ........................................................................................................ 44
5.13. i8028U_ReadPowerOnHex_AO................................................................................................... 46
5.14. i8028U_ReadPowerOn_AO ......................................................................................................... 48
5.15. i8028U_WriteSafeHex_AO .......................................................................................................... 50
5.16. i8028U_WriteSafe_AO ................................................................................................................ 52
5.17. i8028U_ReadSafeHex_AO ........................................................................................................... 54
5.18. i8028U_ReadSafe_AO ................................................................................................................. 56
5.19. i8028U_SetModuleWDTConfig ................................................................................................... 58
5.20. i8028U_GetModuleWDTConfig .................................................................................................. 60
I-8024UW/I-8028UW/I-9024U/I-9028U Module Linux API User Manual, v2.0.1
P. 3
5.21. i8028U_GetModuleWDTStatus .................................................................................................. 62
5.22. i8028U_ResetModuleWDT ......................................................................................................... 63
5.23. i8028U_RefreshModuleWDT ...................................................................................................... 64
Appendix A. Error Code ............................................................................................................................... 65
Appendix B. Revision History ....................................................................................................................... 66
I-8024UW/I-8028UW/I-9024U/I-9028U Module Linux API User Manual, v2.0.1
P. 4
1. Introduction
Model
I-8024UW
I-8028UW
I-9024U
I-9028U
Channel 4 8 4 8
Voltage or Current Output
Jumper
Jumper
Software
Software
Range
0 ~ +5 VDC, ±5 VDC, 0 ~ +10 VDC, ±10 VDC, 0 ~ +20 mA, +4 ~ +20 mA
Resolution
16-bit
Power-on Value
Yes
Safe Value
Yes
System LED Indicator
1 LED as Power Indicator
Dimension (L x W x H)
129 mm × 31 mm × 114 mm
144 mm x 30.3 mm x 134 mm
The I-9024U/I-9028U is a 4-channel/8-channel Isolated analog output module that can be used on a
9000 series PAC, and allows a programmable output range on all analog output channels (0 to 5 V, ±5 V,
0 to 10 V, ±10 V, +4 to +20 mA or 0 to +20 mA). Each Analog Output channel can be configured for an
individual range, providing an RF immunity level matching that defined by the IEC 61000-4-3 standard.
The I-9024U/I-9028U module features channel to-channel isolation as well as 4 kV ESD protection and
1000 VDC intra-module isolation.
And the I-8024UW/ I-8028UW is also a 4-channel/8-channel Isolated analog output module that can be
used on a 8000 series PAC.
Features
I-8024UW/I-8028UW/I-9024U/I-9028U Module Linux API User Manual, v2.0.1
P. 5
Applicable Platform table
Platform
OS
Module
XPAC
XP-8000(WES)
I-8024UW/ I-8028UW
XP-8000-Atom (WES)
I-8024UW/ I-8028UW
XP-8000-WES7 (WES7)
I-8024UW/ I-8028UW
XP-8000-CE6 (WinCE 6.0)
I-8024UW/ I-8028UW
XP-8000-Atom-CE6 (WinCE 6.0)
I-8024UW/ I-8028UW
XP-9000-WES7(WES7)
I-9024U/ I-9028U
WinPAC
WP-8000 (CE 5.0/7.0)
I-8024UW/ I-8028UW
WP-9000-CE7 (CE 7.0)
I-9024U/ I-9028U
LinPAC
LinPAC-8000(Linux kernel 3.2/4.4)
I-8024UW/ I-8028UW
LinPAC-9000(Linux kernel 3.2/4.4)
I-9024U/ I-9028U
IPAC
iPAC-8000 (MiniOS7)
I-8024UW/ I-8028UW
I-8000 (MiniOS7)
I-8024UW/ I-8028UW
The following table shows which platform the module applies to.
I-8024UW/I-8028UW/I-9024U/I-9028U Module Linux API User Manual, v2.0.1
P. 6
1.1. Specifications
Model
I-8024UW
I-8028UW
I-9024U
I-9028U
Analog Output
Channels
4 8 4
8
Current Output Wiring
Source
Range
0 ~ +5 VDC, ±5 VDC, 0 ~ +10 VDC, ±10 VDC,
0 ~ +20 mA, +4 ~ +20 mA
Resolution
16-bit
Accuracy
±0.02% of FSR
Zero Drift
±0.2 μV/°C
Span Drift
±25 ppm/°C
Short Circuit Protection
Yes
Power-on Value
Yes
Safe Value
Yes
External Power Requirements
Reserve Polarity Protection
Yes
Powered from Terminal Block
Yes, 15 ~ 30 VDC
Isolation
3000 VDC
LED Indicators
System LED Indicator
1 LED as Power Indicator
Isolation
Intra-module Isolation, Field-to-Logic
3000 VDC
EMS Protection
ESD (IEC 61000-4-2)
±4 kV Contact for each Terminal
±8 kV Air for Random Point
Power
Power Consumption
2 W Max.
Mechanical
Dimension (L x W x H)
129 mm × 31 mm × 114 mm
144 mm x 30.3 mm x 134 mm
Environment
Operating Temperature
-25 ~ +75°C
Storage Temperature
-40 ~ +85°C
Humidity
10 ~ 90% RH, non-condensing
I-8024UW/I-8028UW/I-9024U/I-9028U Module Linux API User Manual, v2.0.1
P. 7
1.2. Pin Assignments
I-8024UW I-8028UW
I-8024UW/I-8028UW/I-9024U/I-9028U Module Linux API User Manual, v2.0.1
P. 8
I-9024U I-9028U
I-8024UW/I-8028UW/I-9024U/I-9028U Module Linux API User Manual, v2.0.1
P. 9
1.3. Jumper Setting
Voltage output
Current output
I-8024U
I-8028U
I-8024UW/I-8028UW/I-9024U/I-9028U Module Linux API User Manual, v2.0.1
P. 10
1.4. Wire Connections
Voltage Output Wiring
Current Output Wiring
I-8024UW/I-8028UW/I-9024U/I-9028U Module Linux API User Manual, v2.0.1
P. 11
1.5. Block Diagram
I-8024UW/I-8028UW/I-9024U/I-9028U Module Linux API User Manual, v2.0.1
P. 12
1.6. Dimensions
All dimensions are in millimeters.
I-9024U /I-9028U with Spring clamp terminal connector
I-8024UW /I-8028UW with Spring clamp terminal connector
I-8024UW/I-8028UW/I-9024U/I-9028U Module Linux API User Manual, v2.0.1
P. 13
2. Quick Start
Check PWR on
Status
Power On Value Or
Retentive Output
Normal Activity
Turn power on
WDT active
Output safe value(11)
Enable WDT
Refresh
Not Refreshed
DAC Command
The following is an illustration of the operating procedure for the I-8024UW/I-8028UW/I-9024U/I-9028U
module:
I-8024UW/I-8028UW/I-9024U/I-9028U Module Linux API User Manual, v2.0.1
P. 14
ICP DAS provides a range of demo programs for different platforms that can be used to verify the
PRRODUCT
CPU
DOWNLOAD LINK
LP-8x4x
PXA270
http://www.icpdas.com/en/download/show.php?num=982&model=LP-8441-EN
LP-8x2x/9x2x
AM335x
http://www.icpdas.com/en/download/show.php?num=915&model=LP-8421
LX-8000/9000
x86/E38xx
http://www.icpdas.com/en/download/show.php?num=904&model=LX-9381
functions of the I-8024UW/I-8028UW/I-9024U/I-9028U. The source code contained in these programs
can also be reused in your own custom programs if needed.
We need to check the following steps before running the program.
1. First, user need to download LinPAC SDK, which is includes GNU toolchain, Libraries, header,
examples files, etc.
2. Check the power cable, Ethernet cable, VGA monitor, the communication cable between controller
and PC has been connected well, and then check the I-8024UW/I-8028UW/I-9024U/I-9028U has
been plugged in the controller.
3. Next, check the communication between controller and PC is fine, and download the demo
program files to the controller.
4. The following is a list of the locations where both the demo programs and associated libraries can
be found on either the ICP DAS web site or the enclosed CD, and I-8024U/I-8028U/I-9024U/I-9028U
use the same library and demo.
User can find the related files in the product CD or below website:
I-8024UW/I-8028UW/I-9024U/I-9028U Module Linux API User Manual, v2.0.1
P. 15
3. Power-on Mode
Mode
Output
Power-on Value Mode
Ser Power On as Power on Value and reset, then the module will output as
configured power on value.
Retentive Mode
Ser Power On as Retentive and reset, then the module will output as late
output.
If the module is reset for any reason, the Analog Output will be activated in Power-on Mode so as to
avoid any unknown errors that might cause the Analog Output from the module to inflict damage on
other devices. This ensures that the output from the I-8024UW/I-8028UW/I-9024U/I-9028U module can
be anticipated and guarantees that the output will not damage other devices when the system fail or be
reset for any reason.
Two types of Power-on Mode are provided on the I-8024UW/I-8028UW/I-9024U/I-9028U module.
1. Power-on Value Mode
2. Retentive Mode
Power On mode does not support hot plug functionality. When hot plug on PAC Power On mode will not
be affected, it only apply on the others cases caused by PAC power reset.
Configuring Power-on Mode
Power-on Mode included Power-on Value Mode and Retentive Mode. Below is a description of the
conditions in each mode will apply when an abnormality be encountered and causes the Power-on
Mode to be activated.
If either the PAC or the module encounters an event that causes the hardware reset or the software
reset, the Output will be set to those configured for the specific mode.
I-8024UW/I-8028UW/I-9024U/I-9028U Module Linux API User Manual, v2.0.1
P. 16
The following is an overview of the Analog Output value that will be set for the I-9028U module in each
Mode
Hardware Reset
Software Reset
Power-on Value Mode
AO = Configured Power-on value
AO = Configured Power-on value
Retentive Mode
AO = Previous AO value
AO = Previous AO value
Configure the
Power-on Mode
Power-on Value
Mode
Retentive Mode
Hardware
Reset
Software
Reset
Hardware
Reset
Software
Reset
AO=Power
on Value
AO=Last
output
AO=Power
on Value
AO=Last
output
of the Power-on Mode conditions:
Note: Previous AO value means that after the module reset, the AO value will be retained. For example,
if the Power-on Mode is set as Retentive Mode and a hardware reset happened, then the AO value will
be the same as the value that existed prior to the hardware reset.
The following is a flowchart that illustrates the outcome of each Power-on Mode:
I-8024UW/I-8028UW/I-9024U/I-9028U Module Linux API User Manual, v2.0.1
P. 17
3.1. Power-on Value Mode
PAC
AO = Power on Value
I-9028U
Reset
Power-on Value Mode is used to set the output value to the preconfigured Value after an unknown
condition has caused the module reset.
I-8024UW/I-8028UW/I-9024U/I-9028U Module Linux API User Manual, v2.0.1
P. 18
3.2. Retentive Mode
AO = Last Output
I-9028U
Reset
Retentive Mode, also known as Virtual Battery Backup Mode, is used to ensure that the previous AO
value is retained if an unknown condition has caused the I-9028U module to be reset.
I-8024UW/I-8028UW/I-9024U/I-9028U Module Linux API User Manual, v2.0.1
P. 19
4. Watchdog
Program
Refresh WDT
Safe Value
I-9028U
OS WDT reset
System
Safe
Value
I-9028U
Hang
The Watchdog Timer (WDT) on the I-9028U module is a software function that monitors the operating
status of the module. Its purpose is to prevent problems due to network or communication errors, or
host malfunctions, such as situations where the device is affected by noise, or the program is not stable,
etc. When the “refresh WDT” function fails and a Watchdog timeout happened, all output values on the
module will be set to the Safe Value state in order to prevent the controlled target from performing any
erroneous operations.
A common application is provided as an example below. If the system encounters an even that causes it
to become unresponsive for any reason, the I-9028U WDT and the WDT provided by the operating
system for the 9000-series PAC can be used in combination, thereby preventing the system from hang
becoming unresponsive, which may cause the Analog Output to be uncontrolled and result in damage to
the device. The WDT on the 9000-series PAC will reset the PAC to solve the unresponsiveness problem,
and then the Safe Value will be set for the I-9028U module to prevent the AO from becoming
uncontrolled.
I-8024UW/I-8028UW/I-9024U/I-9028U Module Linux API User Manual, v2.0.1
P. 20
Loading...