ICP DAS USA I-9K Series User manual

I-9048 / I-8048W Module
Linux API Reference
(For Linux platform)
V 1.0.2 April 2021
Written by Sean Hsu
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 © 2020 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: [email protected]om

Table of Contents
Table of Contents........................................................................................................................................ 3
Preface........................................................................................................................................................ 5
1. Introduction........................................................................................................................................ 6
1.1. I/O Module Dimensions .............................................................................................................. 7
1.2. Inserting the I/O Modules........................................................................................................... 8
1.3. Wire Connections...................................................................................................................... 10
1.4. Demo Programs......................................................................................................................... 11
2. I-9048 / I-8048W module features................................................................................................... 12
2.1. General Introduction................................................................................................................. 13
2.1.1. Pin Assignment for the I-9048........................................................................................ 14
2.1.2. Pin Assignment for the I-8048W .................................................................................... 15
2.1.3. Block Diagram................................................................................................................. 16
2.1.4. Isolated or TTL Input ...................................................................................................... 18
2.1.5. Digital Input & LED indicators......................................................................................... 20
2.1.6. Programmable Rising/Falling interrupt.......................................................................... 21
2.2. Software Introduction ............................................................................................................... 23
2.2.1. Software flow chart........................................................................................................ 24
2.2.2. Recognize different interrupt service requests.............................................................. 26
3. API References.................................................................................................................................. 28
3.1. Function List .............................................................................................................................. 29
3.2. I8048W_DI_ALL......................................................................................................................... 30
3.3. I8048W_DI_Ch .......................................................................................................................... 31
3.4. I8048W_ Set_RisingReg............................................................................................................. 32
3.5. I8048W_ Set_FallingReg............................................................................................................ 33
3.6. I8048W_Read_RisingReg........................................................................................................... 34
3.7. I8048W_Read_FallingReg.......................................................................................................... 35
3.8. I8048W_Read_RisingEvent ....................................................................................................... 36
3.9. I8048W_Read_FallingEvent....................................................................................................... 37
3.10. I8048W_Read_RisingEventCount............................................................................................ 38
3.11. I8048W_Read_FallingEventCount........................................................................................... 39
3.12. I8048W_Clear_RisingEventCount ........................................................................................... 40
3.13. I8048W_Clear_FallingEventCount........................................................................................... 41
3.14. I8048W_Init............................................................................................................................. 42

3.15. I8048W_InstallISR ................................................................................................................... 43
3.16. I8048W_UnInstallISR............................................................................................................... 45
3.17. I8048W_UnFreezeINT ............................................................................................................. 46
3.18. I8048W_GetLibVersion............................................................................................................ 47
Revision History........................................................................................................................................ 48

Preface
The I-9048 / I-8048W is an 8-channel digital input module with hardware interrupt capability for
real-time system application. Each channel can be programmed as an interrupt input channel to invoke
an interrupt on falling edges, rising edges or both falling and rising edges. Each channel can be eithers
Isolated or Non-isolated TTL Input, selectable by Jumper.
The module includes LED indicators are provided for monitoring DI channel status, together with±4 kV
ESD protection and 1500 Vrms intra-module isolation.
The information contained in this manual is divided into the following topics:
Chapter 1, “Introduction”–This chapter provides information related to the hardware, such as
the specifications, the jumper settings details and wiring information.
Chapter 2, “I-9048 / I-8048W features” –– This chapter introduces the features of I-9048 /
I-8048W module.
Chapter 3, “API References” –This chapter describes the functions provided in the I-9048 /
I-8048W library together with an explanation of the differences in the naming rules used for the
different Windows platforms.

1. Introduction
The I-9K/I-8K series module is based on a parallel interface with high communication speed. The
differences between the I-9K and I-8k series are listed as follows:
I/O module features comparison
Model
I-9K Series
I-8K series
Communication interface
Parallel bus
Parallel bus
Protocol
-
-
Communication speed
Fast
Fast
DI module with latched function
-
-
DI module with counter input
-
-
Power on value for DO module
Y
-
Safe value for DO module
Y
-
Programmable slew-rate for AO module
-
-
Refer to
http://www.icpdas.com/en/product/guide+Remote__I_O__Module__and__Unit+_%EF%BC%86amp;__Local__I_O__Modules+I-9K_I-97K__Series for
more details regarding of I-9K series module specification, jumper settings details and wiring
information.
Refer to
http://www.icpdas.com/en/product/guide+Remote__I_O__Module__and__Unit+_%EF%BC%86amp;__Local__I_O__Modules+I-8K_I-87K__Series__(High_
_Profile) for more details regarding of I-8K series module specification, jumper settings details and
wiring information.
Those I-9K Modules must work then plugin any slot with the following PAC:
Platform
CPU
Slot Counts
WP-9x2x-CE7 / LP-9x2x
AM335x (ARM)
2,4,8
XP-9x7x-WES7 / XP-9x8x-WES7/ LX-9x71 / LX-9x81
E3827/E3845 (X86)
1,3,7
Those I-8K Modules must work then plugin any slot with the following PAC:
Platform
CPU
Slot Counts
WP-8x4x / LP-8x4x
PXA270 (ARM)
1,4,8
WP-8x2x-CE7 / LP-8x2x
AM335x (ARM)
1,4,8
XP-8x3x-CE6 / LX-8x3x
x86 CPU,1 GHZ, dual-core
1,3,7

1.1. I/O Module Dimensions
All dimensions are in millimeters.
I-9K module with spring clamp terminal connector
Left Side View
Top View
I-8K module with screw terminals connector

1.2. Inserting the I/O Modules
Follow the procedure described below to insert the I-9048 module.
1. Insert the I/O module
2. Wiring connection
The metal part of the cord end terminal on the wire can be
direct wired to the terminal.
Note:
The I-9048 module supports spring clamp terminal connector. The spring clamp terminal connector for
the I-9048 module connector offers the advantages (anti-vibration, stable clamping and installation
easier) relative to screw terminals.

A tip on how to connect the wiring to the connector
A tip on how to remove the wiring from the connector
1. Use screwdriver to push the orange
clip in.
2. Insert the wiring into the terminal
block
1.
Keep on pushing
Insert the wire
1. Use screwdriver to push the orange
clip in.
2. Remove the wiring from the
terminal block
Keep on pushing

1.3. Wire Connections

1.4. Demo Programs
ICP DAS provides a range of demo programs for different platforms that can be used to verify the
functions of the I-8048W/9048. The source code contained in these programs can also be reused in
your own custom programs if needed.
Both I-8048W/9048 use the same library and demo.
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-8048W/I-9048 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, and I-8048W/I-9048 use the same library and demo.
User can find the related files in the below website:
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

2. I-9048 / I-8048W module features
The I-9048 / I-8048W is an 8-channel digital input module with hardware interrupt capability for
real-time system application. Each channel can be programmed as an interrupt input channel to invoke
an interrupt on falling edges, rising edges or both falling and rising edges. Each channel can be eithers
Isolated or Non-isolated TTL Input, selectable by Jumper.
The DI module includes LED indicators are provided for monitoring DI channel status, together with±4
kV ESD protection and 1500 Vrms intra-module isolation.

2.1. General Introduction
The I-9048 / I-8048W module is an 8-channel digital input module designed for interrupt
applications.
The key features of the I-9048 / I-8048W are as following:
Isolation
Intra-module Isolation
1500 Vrms
EMS Protection
ESD (IEC 61000-4-2)
± 4 kV Contact for Each Terminal
LED Indicators
Status
1 x Power and 8 x DI
Digital Input
Channels
8
Type
Dry Contact, Wet Contact
Sink/Source (NPN/PNP)
Sink, Source
Wet Contact, ON Voltage Level
Isolated: +4 ~ +30 VDC
Non-Isolated: 0 ~ +0.8 VDC
Wet Contact, OFF Voltage Level
Isolated: 0 ~ +1 VDC
Non-Isolated: +2 ~ +5 VDC
Input Impedance
2.4 kΩ, 0.5 W
Digital Input/Counter
Interrupts
8 (DI0 ~ DI7) Trigger type: Rising/falling edge programmable for
each channel Max. Interrupt frequency: 10 KHz Max.
Power
Consumption
1.75 W Max.
Environmental
Operating Temperature
-25 ~ +75 °C
Storage Temperature
-40 ~ +85 °C
Humidity
10 ~ 90% RH, Non-condensing

2.1.1. Pin Assignment for the I-9048
The pin assignment for the I-9048 is shown as follows:
Pin 1 and 11: TTL GND, ground for non-isolated inputsignals
Pins 2 ~ 9, 12~19: 8-channel digital input
Pins 10 and 20: Isolated power supply, 5V, 200mA max.

2.1.2. Pin Assignment for the I-8048W
The pin assignment for the I-8048W is shown as follows:
Pin 1: TTL GND, ground for non-isolated inputsignals
Pins 3 ~ 18: 8-channel digital input
Pins 19 and 20: Isolated power supply, 5V, 200mA max.

2.1.3. Block Diagram
The signal flow block diagram for I-9048 is shown as follows:

The signal flow block diagram for I-8048W is shown as follows:

2.1.4. Isolated or TTL Input
The input signal can be either isolated or TTL input for I-9048 as follows:
Isolated input
TTL input
Isolated input (default) TTL input
JP1
for ch0
JP2
for ch1
JP3
for ch2
JP4
for ch3
JP5
for ch4
JP6
for ch5
JP7
for ch6
JP8
for ch7
JP1 ~ JP8 in the DOWN position will
select the isolated input 1 ~ 8
V i n -
V i n +
JP1 ~ JP8 in the UP position will select
the TTL input 1 ~ 8
V i n -
V i n +

The input signal can be either isolated or TTL input for I-8048W as follows:
Isolated input
TTL input
Isolated input (default) TTL input
JP1
for ch0
JP2
for ch1
JP3
for ch2
JP4
for ch3
JP5
for ch4
JP6
for ch5
JP7
for ch6
JP8
for ch7

2.1.5. Digital Input & LED indicators
The LED status and the digital input relation are listed as follows:
Isolated:
TTL:
Input status
Digital Input( Logic level )
Electric signal
LED
OPEN
1
Low
OFF
0 ~ +0.8V
0
Low
ON
+2 ~+ 5V
1
High
OFF
Input status
Digital Input( Logic level )
Electric signal
LED
OPEN
1
Low
OFF
0 ~ +1V
1
Low
OFF
+4 ~ +30V
0
High
ON
IN7
IN0
i-9048
power LED