ICP DAS USA LinPAC-22 Series Manuale utente

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

Questo manuale è adatto per i seguenti modelli

Indice

Altri manuali ICP DAS USA Controllori

ICP DAS USA

ICP DAS USA I-8091 Manuale utente

ICP DAS USA

ICP DAS USA 7188E Istruzioni per l’uso

ICP DAS USA

ICP DAS USA WinCon 8000 Istruzioni per l’uso

ICP DAS USA

ICP DAS USA WISE-52 Series Manuale utente

ICP DAS USA

ICP DAS USA CAN-8124 Manuale utente

ICP DAS USA

ICP DAS USA WISE-224 Series Manuale utente

ICP DAS USA

ICP DAS USA SMS-531 Manuale utente

ICP DAS USA

ICP DAS USA LinPAC-5000 Manuale utente

ICP DAS USA

ICP DAS USA LP-9821 Manuale utente

ICP DAS USA

ICP DAS USA TPD-280-H Manuale utente

ICP DAS USA

ICP DAS USA TPD-283U-M1 Manuale utente

ICP DAS USA

ICP DAS USA WISE-52 Series Manuale utente

ICP DAS USA

ICP DAS USA ALM-06-WF Manuale utente

ICP DAS USA

ICP DAS USA Compact Embedded Controller LinCon-8000 Istruzioni per l’uso

ICP DAS USA

ICP DAS USA CAN-8123 Manuale utente

ICP DAS USA

ICP DAS USA WP-2000-CE7 Series Manuale utente

ICP DAS USA

ICP DAS USA Compact Embedded Controller LinPAC-8x41 Istruzioni per l’uso

ICP DAS USA

ICP DAS USA NMC-9181 Guida all'installazione

ICP DAS USA

ICP DAS USA i8094A Manuale utente

ICP DAS USA

ICP DAS USA WinPAC-5000 Manuale utente

ICP DAS USA

ICP DAS USA GRP-2841M-5GE Manuale utente

ICP DAS USA

ICP DAS USA TPD-433-H Manuale utente

ICP DAS USA

ICP DAS USA WISE-2841 Series Manuale utente

ICP DAS USA

ICP DAS USA I-8431 Manuale utente

Manuali Controllori popolari di altre marche

Digiplex

Digiplex DGP-848 Istruzioni operative

YASKAWA

YASKAWA SGM series Manuale utente

Sinope

Sinope Calypso RM3500ZB Manuale utente

Isimet

Isimet DLA Series Style 2 Manuale di installazione

LSIS

LSIS sv-ip5a Manuale utente

Rockwell Automation

Rockwell Automation 1769-L31 Manuale utente

Airflow

Airflow Uno hab Manuale utente

ABB

ABB ACS580-01 drives Manuale utente

Panasonic

Panasonic GM1 Series Manuale utente

Emerson

Emerson SW93 Manuale utente

AutoAqua

AutoAqua Smart ATO micro SATO-120P Manuale utente

Panasonic

Panasonic FP? Positioning Unit RTEX Manuale utente

Samson

Samson Type 5824 Manuale di servizio

Alpha IP

Alpha IP MIOB 21001 Manuale utente

Siemens

Siemens OpenAir GMA 1 Series Manuale utente

Surecom

Surecom SR-629 Manuale utente

Fishman

Fishman TriplePlay Manuale utente

Regulus

Regulus SRS1 T Manuale utente