ICP DAS USA LinPAC-22 Series Manual de usuario

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

Este manual sirve para los siguientes modelos

Tabla de contenidos

Otros manuales de Controladores de ICP DAS USA

ICP DAS USA

ICP DAS USA WISE-52 Series Manual de usuario

ICP DAS USA

ICP DAS USA GT-530 Manual de usuario

ICP DAS USA

ICP DAS USA TPD-433-H Manual de usuario

ICP DAS USA

ICP DAS USA Compact Embedded Controller LinCon-8000 Instrucciones de uso

ICP DAS USA

ICP DAS USA WISE-52 Series Manual de usuario

ICP DAS USA

ICP DAS USA TPD-283U-H Manual de usuario

ICP DAS USA

ICP DAS USA iP-8000-MRTU Manual de usuario

ICP DAS USA

ICP DAS USA ISaGRAF I-8437-80 Manual de usuario

ICP DAS USA

ICP DAS USA LX-8131 Manual de usuario

ICP DAS USA

ICP DAS USA WinPAC-5000 Manual de usuario

ICP DAS USA

ICP DAS USA LP-22 Series Manual de usuario

ICP DAS USA

ICP DAS USA I-7188E3 Manual de usuario

ICP DAS USA

ICP DAS USA WISE-52 Series Manual de usuario

ICP DAS USA

ICP DAS USA TPD-283U-M1 Manual de usuario

ICP DAS USA

ICP DAS USA CAN-8123 Manual de usuario

ICP DAS USA

ICP DAS USA WISE-75 M Series Manual de usuario

ICP DAS USA

ICP DAS USA 7188E Instrucciones de uso

ICP DAS USA

ICP DAS USA 7188XA Manual de usuario

ICP DAS USA

ICP DAS USA XP-9 88-IoT Series Manual de usuario

ICP DAS USA

ICP DAS USA ET-M8194H Manual de instrucciones

ICP DAS USA

ICP DAS USA SMS-531 Manual de usuario

ICP DAS USA

ICP DAS USA WinPAC-8000 Series Manual de usuario

ICP DAS USA

ICP DAS USA I-7188XB Series Manual de usuario

ICP DAS USA

ICP DAS USA NMC-9181 Guía de instalación

Manuales populares de Controladores de otras marcas

Digiplex

Digiplex DGP-848 Instrucciones de funcionamiento

YASKAWA

YASKAWA SGM series Manual de usuario

Sinope

Sinope Calypso RM3500ZB Manual de usuario

Isimet

Isimet DLA Series Style 2 Manual de instalación

LSIS

LSIS sv-ip5a Manual de usuario

Rockwell Automation

Rockwell Automation 1769-L31 Manual de usuario

Airflow

Airflow Uno hab Manual de usuario

ABB

ABB ACS580-01 drives Manual de usuario

Panasonic

Panasonic GM1 Series Manual de usuario

Emerson

Emerson SW93 Manual de usuario

AutoAqua

AutoAqua Smart ATO micro SATO-120P Manual de usuario

Panasonic

Panasonic FP? Positioning Unit RTEX Manual de usuario

Samson

Samson Type 5824 Manual de servicio

Alpha IP

Alpha IP MIOB 21001 Manual de usuario

Siemens

Siemens OpenAir GMA 1 Series Manual de usuario

Surecom

Surecom SR-629 Manual de usuario

Fishman

Fishman TriplePlay Manual de usuario

Regulus

Regulus SRS1 T Manual de usuario