ICP DAS USA LinPAC-22 Series Bedienungsanleitung

ICPDAS

LinPAC-52xx Series XV-Board API User Manual 1

C-

-2

V-

-B

V1.0.0 Apr 2019

Warranty

AllproductsmanufacturedbyICPDASarewarrantedagainstdefectivematerialsfora

periodofoneyearfromthedateofdeliverytotheoriginalpurchaser.



Warning

ICPDASassumenoliabilityfordamagesconsequentto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.



Trademarks

Namesareusedforidentificationpurposesonlyandmayberegisteredtrademarksof

theirrespectivecompanies.

ICPDAS

LinPAC-52xx Series XV-Board API User Manual 2

Table of Contents

1.Introduction.....................................................................................................3

1.1. What is the I/O Expansion Bus? ...........................................................................................3

1.2. Demo program...........................................................................................................................3

1.3. Specifications ............................................................................................................................4

2.XV-Board API functions .................................................................................5

2.1. modbusRequest........................................................................................................................5

2.2. modbusRequestXV...................................................................................................................8

2.3. getXVBitBack ...........................................................................................................................11

2.4. getXVBit.....................................................................................................................................13

2.5. getXVRegBack.........................................................................................................................15

2.6. getXVReg...................................................................................................................................17

2.7. setXVBit.....................................................................................................................................19

2.8. setXVReg...................................................................................................................................21

3.Error Codes...................................................................................................23

4.Demo for XV-Boards.....................................................................................24

4.1. AI/O, DI/O Expansion Boards...............................................................................................24

4.1.1. AIO.....................................................................................................................................24

4.1.2. DIO.....................................................................................................................................27

Appendix .............................................................................................................31

A. Revision History.........................................................................................................................31



ICPDAS

LinPAC-52xx Series XV-Board API User Manual 3

1. Introduction

This manual is intended to be used as a reference for users who need to use API functions to

communicate with XV-Boards inserted into an LP-22xx/52xx series controller via the Modbus

protocol.

1.1. What is the I/O Expansion Bus?

The LinPAC-22xx/52xx series provides an I/O expansion bus which can be used to implement

various I/O functions, such as D/I, D/O, A/I, A/O, A/D, D/A, Timer/Counter, and other I/O

functions.

However, only one XV-Board can be inserted into each PAC at a time. For more information

related to the XV-Board series, refer to:

http://www.icpdas.com/root/product/solutions/hmi_touch_monitor/touchpad/xv-board_selection.html

1.2. Demo programs

ICP DAS provides a range of demo programs that can be used to implement a variety of

functions on the LP-22xx/52xx controller. To utilize these demo programs, transfer the files to the

LP-22xx/52xx controller from the LinPAC AM335X SDK.

The demo programs can be found in either the

C:\cygwin\LinPAC_AM335x_SDK\examples\xvboard\ or the

root@LinuxPC-ICPDAS:/icpdas/linpac_am335x_sdk/i8k/examples/xvboard/ folder.

ICPDAS

LinPAC-52xx Series XV-Board API User Manual 4

1.3. Specifications

For more detailed specifications related to specific XV-Boards and the Modbus register table,

refer to:

http://ftp.icpdas.com.tw/pub/cd/linpac/napdos/lp-5000/lp-52xx/lp-5231/user_manual/xv-board_user_manual_v1.0.3.pdf

ICPDAS

LinPAC-52xx Series XV-Board API User Manual 5

2. XV-Board API functions

The following is an overview of the API functions used by the LP-22xx/52xx series controller that

contains an XV-Board.

2.1. modbusRequest

Description:

This function is used to send a Modbus protocol request.

Syntax:

[ C ]

int modbusRequest(char cPort, char cNetID, char cFunction, WORD wAddr,

WORD wCount, char szBuf, WORD wBufLen, WORD wTimeout, WORD *wT)

Parameters:

cPort: [Input] The number of the COM port for the XV-Board. 1=COM1=/dev/ttyO1.

cNetID: [Input] The NetID for the device.

The default slave address for the XV-Board is '1'.

cFunction: [Input] The Modbus RTU protocol function code.

wAddr: [Input] The channel address.

Note: Input the channel address mapping in decimal format.

wCount: [Input] The number of channels.

szBuf[ ]: [Input/Output] Used to set or read back the value from a function code.

wBufLen: [Input] The length of the szBuf[ ].

wTimeout: [Input] The Timeout setting. The normal value is 100 milliseconds.

*wT: [Output] The total duration of the send/receive interval. Unit=1 ms.

Return Values:

0: The function was successfully processed.

Other: The processing failed.

Refer to Chapter 3: “Error Codes” for details of other returned values.

ICPDAS

LinPAC-52xx Series XV-Board API User Manual 6

Example:

int RetValue, timeout=100, count=1, netid=1;

int comport=COM1; /* Refer to [Remark 1] */

int function=1; /* Refer to [Remark 2] */

int addr=33; /* Refer to [Remark 3] */

char szBuf[80];

DWORD baudrate=115200;

WORD wT;

/* Open the device file */

RetValue=Open_Com(comport, baudrate, Data8Bit, NonParity, OneStopBit);

if (RetValue > 0) {

printf("open COM%d failed!\n",comport);

return FAILURE;

}

RetValue=modbusRequest(comport, netid, function, addr, count, szBuf, sizeof(szBuf),

timeout, &wT);

Close_Com(comport);

if (RetValue==0) {

if((function==1)||(function==2))

printf("%d", szBuf[0]);

else {

RetValue=(szBuf[0]<<8)|szBuf[1];

printf("%ld", RetValue);

}

ICPDAS

LinPAC-52xx Series XV-Board API User Manual 7

Remarks:

[1] Refer to the communication port number in the table below when sending the Modbus

protocol request.

'cPort’ parameter for the XV-Board module: 1=COM1=/dev/ttyO1.

'cPort' parameter for the RS-485 serial port: 2=COM2=/dev/ttyO2, 5=COM5=/dev/ttyO5.

Note: Remote I/O modules can be remotely controlled through an RS-485 serial bus. Refer

to Chapter 4.1.2: “DIO” for details of demonstration details.

Device Name Definition in the

LP-22xx/52xx SDK Description Default

Baud Rate

- /dev/ttyO1 or COM1 Used for internal communication with the

XV-Board 115200

- Console port RS-232 (RxD, TxD and GND); Non-isolated 115200

ttyO4 /dev/ttyO4 or COM4 RS-232 (RxD, TxD and GND); Non-isolated 9600

ttyO2 /dev/ttyO2 or COM2 RS-485 (Data+, Data-); Non-isolated 9600

ttyO5 /dev/ttyO5 or COM5 RS-485 (Data+, Data-); 2500 VDC isolated 9600

[2] Modbus RTU protocol function codes.

Function Code Description Input

01 Reads the status of the Digital Output 1

02 Reads the status of the Digital Input 2

03 Reads the Analog Output channels 3

04 Reads the Analog Input channels 4

05 Writes to a single Digital Output channel 5

06 Writes to a singleAnalog Output channel 6

15 Writes to multiple Digital Output channels 15

16 Writes to multiple Analog Output channels 16

[3] This is the input value reference address mapping (Modbus register table) for the 'wAddr'

parameter. More information regarding address mapping can be found at:

http://ftp.icpdas.com.tw/pub/cd/linpac/napdos/lp-5000/lp-52xx/lp-5231/user_manual/xv-boar

d_user_manual_v1.0.3.pdf

ICPDAS

LinPAC-52xx Series XV-Board API User Manual 8

2.2. modbusRequestXV

Description:

This function is used to send a Modbus protocol request in an LP-22xx/52xx system.

Syntax:

[ C ]

int modbusRequestXV(char cPort, char cFunction, WORD wAddr, WORD wCount,

char szBuf, WORD wBufLen)

Parameters:

cPort: [Input] The number of the COM port for the XV-Board. 1=COM1=/dev/ttyO1.

cFunction: [Input] The Modbus RTU protocol function code.

wAddr: [Input] The channel address.

Note: Input the channel address mapping in decimal format.

wCount: [Input] The number of channels.

szBuf[ ]: [Input/Output] Used to set or read back the value from a function code.

wBufLen: [Input] The length of the szBuf[ ].

Return Values:

0: The function was successfully processed.

Other: The processing failed.

Refer to Chapter 3: “Error Codes” for details of other returned values.

ICPDAS

LinPAC-52xx Series XV-Board API User Manual 9

Example:

int RetValue, count=1;

int comport=COM1; /* Refer to [Remark 1] */

int function=1; /* Refer to [Remark 2] */

int addr=33; /* Refer to [Remark 3] */

char szBuf[80];

DWORD baudrate=115200;

WORD wValue;

switch(function) {

case FC05ForceSingleCoil:

case FC15ForceMultipleCoil:

szBuf[0]=wValue & 0xff;

break;

case FC06PresetSingleRegister:

case FC16PresetMultipleRegister:

szBuf[0]=(wValue >> 8) & 0xff;

szBuf[1]=wValue & 0xff;

break;

default:

return FAILURE;

}

/* Open the device file */

RetValue=Open_Com(comport, baudrate, Data8Bit, NonParity, OneStopBit);

if (RetValue >0) {

printf("open COM%d failed!\n",comport);

return FAILURE;

}

RetValue=modbusRequest(comport, netid, function, addr, count, szBuf, sizeof(szBuf),

timeout, &wT);

Close_Com(comport);

ICPDAS

LinPAC-52xx Series XV-Board API User Manual 10

Remarks:

[1] Refer to the communication port number in the table below to send the Modbus protocol

request.

'cPort’ parameter for the XV-Board module: 1=COM1=/dev/ttyO1.

'cPort' parameter for the RS-485 serial port: 2=COM2=/dev/ttyO2, 5=COM5=/dev/ttyO5.

Note: Remote I/O modules can be remotely controlled through an RS-485 serial bus. Refer

to Chapter 4.1.2: “DIO” for details of demonstration details.

Device Name Definition in the

LP-22xx/52xx SDK Description Default

Baud Rate

- /dev/ttyO1 or COM1 Used for internal communication with the

XV-Board 115200

- Console port RS-232 (RxD, TxD and GND); Non-isolated 115200

ttyO4 /dev/ttyO4 or COM4 RS-232 (RxD, TxD and GND); Non-isolated 9600

ttyO2 /dev/ttyO2 or COM2 RS-485 (Data+, Data-); Non-isolated 9600

ttyO5 /dev/ttyO5 or COM5 RS-485 (Data+, Data-); 2500 VDC isolated 9600

[2] Modbus RTU protocol function codes.

Function Code Description Input

01 Reads the status of the Digital Output 1

02 Reads the status of the Digital Input 2

03 Reads the Analog Output channels 3

04 Reads the Analog Input channels 4

05 Writes to a single Digital Output channel 5

06 Writes to a singleAnalog Output channel 6

15 Writes to multiple Digital Output channels 15

16 Writes to multiple Analog Output channels 16

[3] This is the input value reference address mapping (Modbus register table) for the 'wAddr'

parameter. More information regarding address mapping can be found at:

http://ftp.icpdas.com.tw/pub/cd/linpac/napdos/lp-5000/lp-52xx/lp-5231/user_manual/xv-boar

d_user_manual_v1.0.3.pdf

Dieses Handbuch passt für folgende Modelle

Inhaltsverzeichnis

Andere ICP DAS USA Controller Handbücher

ICP DAS USA

ICP DAS USA WISE-52 Series Bedienungsanleitung

ICP DAS USA

ICP DAS USA ALM-04-MRTU Bedienungsanleitung

ICP DAS USA

ICP DAS USA SMS-531 Bedienungsanleitung

ICP DAS USA

ICP DAS USA NMC-9181 Installationsanleitung

ICP DAS USA

ICP DAS USA WISE-224 Series Bedienungsanleitung

ICP DAS USA

ICP DAS USA WISE-52 Series Bedienungsanleitung

ICP DAS USA

ICP DAS USA PISO-CAN200 Bedienungsanleitung

ICP DAS USA

ICP DAS USA Compact Embedded Controller LinPAC-8x41 Gebrauchsanweisung

ICP DAS USA

ICP DAS USA TPD-433F Bedienungsanleitung

ICP DAS USA

ICP DAS USA I-7188XA Bedienungsanleitung

ICP DAS USA

ICP DAS USA LX-8131 Bedienungsanleitung

ICP DAS USA

ICP DAS USA WISE-5801 Benutzerhandbuch

ICP DAS USA

ICP DAS USA mPAC-7186EXD-CAN Bedienungsanleitung

ICP DAS USA

ICP DAS USA ISaGRAF PAC Series Bedienungsanleitung

ICP DAS USA

ICP DAS USA VPD Series Bedienungsanleitung

ICP DAS USA

ICP DAS USA LinPAC AM335 Series Bedienungsanleitung

ICP DAS USA

ICP DAS USA LP-22 Series Bedienungsanleitung

ICP DAS USA

ICP DAS USA LinPAC-5000 Bedienungsanleitung

ICP DAS USA

ICP DAS USA TPD-283U-H Bedienungsanleitung

ICP DAS USA

ICP DAS USA TPD-703 Bedienungsanleitung

ICP DAS USA

ICP DAS USA WP-2000-CE7 Series Bedienungsanleitung

ICP DAS USA

ICP DAS USA CAN-8124 Bedienungsanleitung

ICP DAS USA

ICP DAS USA iP-8000-MRTU Bedienungsanleitung

ICP DAS USA

ICP DAS USA TPD-433-H Bedienungsanleitung

Beliebte Controller Handbücher anderer Marken

Digiplex

Digiplex DGP-848 Betriebsanleitung

YASKAWA

YASKAWA SGM series Bedienungsanleitung

Sinope

Sinope Calypso RM3500ZB Bedienungsanleitung

Isimet

Isimet DLA Series Style 2 Installationshandbuch

LSIS

LSIS sv-ip5a Bedienungsanleitung

Rockwell Automation

Rockwell Automation 1769-L31 Bedienungsanleitung

Airflow

Airflow Uno hab Bedienungsanleitung

ABB

ABB ACS580-01 drives Bedienungsanleitung

Panasonic

Panasonic GM1 Series Bedienungsanleitung

Emerson

Emerson SW93 Bedienungsanleitung

AutoAqua

AutoAqua Smart ATO micro SATO-120P Bedienungsanleitung

Panasonic

Panasonic FP? Positioning Unit RTEX Bedienungsanleitung

Samson

Samson Type 5824 Service-Handbuch

Alpha IP

Alpha IP MIOB 21001 Bedienungsanleitung

Siemens

Siemens OpenAir GMA 1 Series Bedienungsanleitung

Surecom

Surecom SR-629 Bedienungsanleitung

Fishman

Fishman TriplePlay Bedienungsanleitung

Regulus

Regulus SRS1 T Bedienungsanleitung