LAP-B(PCI/C-PCI) GPF LAP-B Communications Driver Software for for Windows. Help for Windows.

Transcription

1 LAP-B(PCI/C-PCI) GPF-4115 LAP-B Communications Driver Software for for Windows Help for Windows

2 Contents Chapter 1 Introduction Overview4 1.2 Features.4 Chapter 2 Product Specifications Target Products and Operating Systems Operating Environments Functional Specifications Number of ports Maximum Transfer Rate Maximum I-Field Length Transmit/Receive Buffer Event Notification Event Mask Product Composition..9 Chapter 3 Installation Sample Programs and Other Driver Related Files Installation Driver Software Installation Windows Vista Windows XP, XP Embedded, or Server Import of the Hardware Information Files for Windows XP Embedded Windows Windows NT Windows Millennium Edition Windows Windows Chapter 4 Reference Programming Guide Initializing a Device Starting Data Transfer Transmitting Data Receiving Data Controlling Signals and Retrieving Signal Status Closing the Port Waiting for Events.22 1

3 4.2 List of DLL Functions LapbOpen LapbClose LapbSetLink LapbCutLink LapbSendFrame LapbGetFrameLength LapbGetFrameCount LapbReceiveFrame LapbGetStatus LapbGetHistory LapbSetControlLine LapbGetControlLine LapbClearBuffer LapbSetDiscMode LapbSetT2Time LapbSetEventMask LapbGetEventMask LapbEventRequestPending Structures LAPBPORTINITDATA Structure LAPBPORTSTATUS Structures LAPBHISTORY Structures Return Values Identifiers 82 Chapter 5 Utilities Interface LAP-B Terminal Application Required Items for the Terminal Application Starting the LAP-B Terminal Application Establishing Data-Link Interface LAP-B Diagnostic Program Required Items for the Diagnostic Program Starting the Diagnostic Program Chacking the LAP-B Functionality.85 2

4 Chapter 6 How to Use.NET Overview Class Library Creating the Class Library Adding Class Library Reference Note..87 Chapter 7 Sample Programs for.net Execution Procedure List of Sample Programs 89 Chapter 8 Terms of Use Prohibited Matter Limitation of Liability Warning Regarding Medical and Clinical Use of Our Products Copyrights and Intellectual Property Rights..91 3

5 Chapter 1 Introduction 1.1 Overview The GPF-4115 software controls Interface LAP-B communication interface modules with µpd72107 from your application running on Windows. The GPF-4115 contains LAP-B protocol. Therefoer, the communication with the equipment that supports LAP-B is available. Application software should link a provided dynamic link library (DLL) and control the LAP-B communication interface modules through the application programming interface (API). 1.2 Features The GPF-4115 can automatically process the LAP-B protocol. The GPF-4115 can automatically process the frame configuration, address monitoring, and CRC. The GPF-4115 can automatically resend the data. Up to 80 LAP-B ports are available. Up to 16 interface modules of a single type may be installed in the same system. Note: PCI and CompactPCI interface modules sharing the same model number are considered to be of the same type. Up to bytes per I frame of the data transfer is available. The interface module contains send buffers, so that the continual data transfer is available. The interface module contains receive buffers, so that the data transfers are available without any data loss. When events occur, the events are signaled. So you can handle interrupt events at the user mode, call back the routine, and a message is posted on the specified window. The online Help system explains how to use the supported functions. Refer to it as you develop your programs. 4

6 Chapter 2 Product Specifications 2.1 Target Products and Operating Systems Product Models PCI-4115, PCI-4156 PCI-4157, CTP-4156 CTP-4157 CPZ-4156, CPZ-4157 *Only for 32-bit version OS. Operation Systems Microsoft Windows Vista Ultimate Microsoft Windows Vista Enterprise Microsoft Windows Vista Business Microsoft Windows Vista Home Premium Microsoft Windows Vista Home Basic Microsoft Windows XP Professional Microsoft Windows XP Home Edition Microsoft Windows XP Embedded Microsoft Windows Server 2003 Microsoft Windows 2000 Microsoft Windows NT 4.0 Microsoft Windows Millennium Edition Microsoft Windows 98 Microsoft Windows 95 Microsoft Windows Vista Ultimate Microsoft Windows Vista Enterprise Microsoft Windows Vista Business Microsoft Windows Vista Home Premium Microsoft Windows Vista Home Basic Microsoft Windows XP Professional Microsoft Windows XP Home Edition Microsoft Windows XP Embedded Microsoft Windows Server 2003 Microsoft Windows

7 2.2 Operating Environments Following table shows operating environments for GPF Computer Supported Languages Interface FA computer PC/AT compatibles NEC PC/FC-9821 series Microsoft Visual C++ Ver. 4.2, 5.0, 6.0,.NET 2002,.NET 2003, 2005 Microsoft Visual C#.NET 2002,.NET 2003, 2005 Microsoft Visual Basic Ver. 4.0 (32 bit version), 5.0, 6.0, NET 2002,.NET 2003, 2005 Borland Delphi Ver. 3.0, 3.1, 4.0, 5.0, 6.0, 7.0 Borland C++Builder Ver. 1.0, 3.0, 4.0, 5.0, 6.0 Borland C++ Ver. 5.0 Note: The supported languages (version) depend on your environment or OS. A part of version may be unable to operate or the operation may become unstable by your OS. 6

8 2.3 Functional Specifications Number of ports Up to 80 LAP-B ports are available when combinations of the PCI-4115, PCI-4156, PCI-4157, CTP-4156, CTP-4157, CPZ-4156, and CPZ-4157 interface modules are used. Up to 16 interface modules of a single type may be installed in the same system. Note: PCI and CompactPCI interface modules sharing the same model number are considered to be of the same type Maximum Transfer Rate RS-232C: 1 Mbps RS-485: 2 Mbps Maximum I-Field Length bytes (The address field, the control field and FCS are not included.) Transmit/Receive Buffer Transmit buffer: 8 frames Receive buffer: 32 frames Event Notification When the following events occur, the events are signaled. So you can handle interrupt events at user mode. A data frame is retrieved. A control signal is changed. A transmission of the specified data completed. A link status is changed. A busy state of a remote station or the local station is changed. 7

9 Available operation when each event occurs depends on the event. Refer to the following table. Data receive Completion of data transmission Change of the control signal Change of the link state Change of the busy state Event Available Available Available Available Available Callback Available Available Available Available Window Message Available Available Available Available Note: As a completion of data transmission event, the event can be set up for each frame Event Mask You can selectively mask or unmask desired interrupt. 8

10 2.4 Product Composition Item File Name Description Management file GPF4115.VER Management information file for Interface use Latest information README.HTM Latest information Installer SETUP.EXE Installation program Diagnostic program DIAGLAPB.EXE Self-diagnostic Program Test program LAPBUTIL.EXE Terminal application Sample programs Visual C#.NET Send Sample program for Visual C#.NET Receive Visual C++ Send Sample program for Visual C++ (MFC) Receive Event SendMessage ReceiveMessage SetLink Visual Basic.NET Send Sample program for Visual Basic.NET Receive Visual Basic Send Sample program for Visual Basic Receive Event SendMessage ReceiveMessage SetLink Delphi Send Sample program for Delphi Receive Event SendMessage ReceiveMessage SetLink DLL FbiLapb.DLL Dynamic link library file FbiLapb.LIB Import library file MSVCRT.DLL C run-time shared DLL Device drivers CP4115.SYS Driver for Windows Vista/XP/XP Embedded/ Server 2003/2000 GPC41XXX.INF Driver for Windows Vista/XP/XP Embedded/ Server 2003/2000 GPC41XXX.SLD SDL file for Windows XP Embedded CP4115.SYS Driver for Windows NT GPC41XXX.INF Driver for Windows NT CP4115.VXD Driver for Windows Me/ 98/ Windows 95 GPC41XXX.INF Driver for Windows Me/ 98/ Windows 95 Header file FbiLapb.H Header file for Visual C++ FbiLapb.BAS Header file for Visual Basic FbiLapb.PAS Header file for Delphi Help HELP.PDF Help (PDF) 9

11 * The sample programs for Visual C#.NET, Visual Basic.NET are created with Viausl C#.NET 2003, Visual Basic.NET 2003, respectively. 10

12 Chapter 3 Installation 3.1 Sample Programs and Other Driver Related Files Installation 1. Decompress the compression file downloaded from our Web site and run the SETUP.EXE file on the decompression folder. The Help and sample program will be installed to the specified folder. 2. Follow further instructions on your screen. 3. To verify you have successfully installed the software package, check that GPF-4115 is registered in the Interface folder of the Program Files folder. 3.2 Driver Software Installation Windows Vista The driver may only be installed by a member of the System Administrators group. 1. When you log on to Windows Vista, the device driver wizard will start automatically. If you are prompted for an administrator password or confirmation, select Continue. 2. The Found New Hardware dialog box will appear, select Locate and install driver software (recommended). 3. Select Don't search online. 4. Click I don't have the disc. Show me other options. 5. Click Browse my computer for driver software (advanced). 6. Click Browse and specify the Win2000 driver folder downloaded from our Web site, and then click Next. 7. Installation will start automatically. 8. Follow further instructions on your screen. * Please repeat the procedure 2 through 8 by the number of channels. Make sure that there are no conflicts in setting up the computer resources, such as I/O addresses and interrupt request levels. After installing the device driver software, the Found New Hardware dialog box will not appear as described above in procedure 2 when the computer is turned on. 11

13 3.2.2 Windows XP, XP Embedded, or Server 2003 The driver may only be installed by a member of the System Administrators group. 1. When you log on to Windows XP Embedded *, Windows XP, or Windows Server 2003, the device driver wizard will start automatically. 2. The Found New Hardware Wizard dialog box will appear, select Install from a list or specific location [Advanced], and then click Next. 3. Select Search for the best driver in these locations, and select Include this location in the search: Then click Next. 4. Click Browse and specify the Win2000 driver folder downloaded from our Web site, and then click Next. 5. Installation will start automatically. 6. Follow further instructions on your screen. * Please repeat the procedure 2 through 6 by the number of channels. Make sure that there are no conflicts in setting up the computer resources, such as I/O addresses and interrupt request levels. After installing the device driver software, the Found New Hardware Wizard dialog box will not appear as described above in procedure 2 when the computer is turned on. Note : * For Windows XP Embedded, components for the device detection must be included in the operating system image Import of the Hardware Information Files for Windows XP Embedded <How to download driver> 1. Download driver disk of GPF Execute the program downloaded, Win2000 folder is automatically created. <How to install driver> 1. Run the Component Database Manager in the Windows XP Embedded environment. 2. Import hardware information file of our product. 3. Follow further instructions on your screen to import the GPC41xx.SLD file of Win

14 3.2.4 Windows 2000 The driver may only be installed by a member of the System Administrators group. 1. When you log on to Windows 2000, the device driver wizard will start automatically. 2. In the Found New Hardware Wizard dialog box, click Next. 3. Select Search for a suitable driver for my device [recommended], and then click Next. 4. Select Specify a location check box, and then click Next. 5. Click Browse and specify the Win2000 driver folder downloaded from our Web site, and then click OK. 6. To install the driver Windows found, click Next. 7. Follow further instructions on your screen. * Please repeat the procedure 2 through 7 by the number of channels. Make sure that there are no conflicts in setting up the computer resources, such as I/O addresses and interrupt request levels. After installing the device driver software, the Found New Hardware Wizard dialog box will not appear as described above in procedure 2 when the computer is turned on Windows NT 4.0 The driver may only be installed by a member of the System Administrators group. 1. Log on to Windows NT Right-click on the GPC4115.inf file corresponding to your interface modules in the WinNT driver folder downloaded from our Web site, and then click Install on the shortcut menu. 3. Follow further instructions on your screen Windows Millennium Edition 1. When you log on to Windows Millennium Edition, the device wizard will start automatically. 2. In the Add New Hardware Wizard dialog box, select Specify the location of the driver (Advanced), and then click Next. 3. Select Specify a location check box, and then click Browse to locate the file. 4. Specify the Win95 driver folder downloaded from our Web site, and then click Finish. 5. Follow further instructions on your screen. * Please repeat the procedure 2 through 5 by the number of channels. Make sure that there are no conflicts in setting up the computer resources, such as I/O addresses and interrupt request levels. After installing the device driver software, the Add New Hardware Wizard dialog box will not appear as described above in procedure 2 when the computer is turned on. 13

15 3.2.7 Windows When you log on to Windows 98, the device wizard will start automatically. 2. In the Add New Hardware Wizard dialog box, select Search for the best driver for your device [Recommended], and then click Next. 3. Select Specify a location check box, and then click Browse to locate the file. 4. Specify the Win95 driver folder downloaded from our Web site, and then click Finish. 5. Follow further instructions on your screen. *Please repeat the procedure 2 through 5 by the number of channels. Make sure that there are no conflicts in setting up the computer resources, such as I/O addresses and interrupt request levels. After installing the device driver software, the Add New Hardware Wizard dialog box will not appear as described above in procedure 2 when the computer is turned on Windows When you log on to Windows 95, the device driver wizard will start automatically. 2. Update Device Driver Wizard dialog box will appear, and then click Next. 3. Select Search for the best driver for your device, and then click Next. 4. If Windows does not find the adapter, select Other Locations, and then click Browse. 5. Specify the Win95 driver folder downloaded from our Web site, and then click Finish. 6. Follow further instructions on your screen. * Please repeat the procedure 2 through 6 by the number of channels. Make sure that there are no conflicts in setting up the computer resources, such as I/O addresses and interrupt request levels. After installing the device driver software, the Update Device Driver Wizard dialog box will not appear as described above in procedure 2 when the computer is turned on. 14

16 Chapter 4 Reference This section explains how to use the provided functions. Sample codes are written in C. When you use two or more identical interface modules, remember to set the RSW1 on each interface module so as not to conflict with any other before the interface module installation. The RSW1 setting value is considered as a board number. 4.1 Programming Guide Initializing a Device The LapbOpen function initializes the interface module. HANDLE DeviceHandle; // Opens FBILAPB1 DeviceHandle = LapbOpen("FBILAPB1", NULL, 0, NULL); if (DeviceHandle == INVALID_HANDLE_VALUE) { printf("failed to open a device\n"); exit(1); } else { printf("succeeded in opening device\n"); } A device handle is returned to DeviceHandle after the interface module is successfully initialized. The device handle allows you to reference the port of LAP-B interface module and must be specified when a function is called. Note: For every PCI-4156, CTP-4156 and CPZ-4156 or PCI-4157, CTP-4157 and CPZ-4157 in the same system, the RSW1 switch setting must be unique. Device names are all of the form FBILAPBxx, where the value of xx corresponds to the interface module model, RSW1 value, and connectors of the interface module to be initialized. 15

17 Therefore, the device driver functions expect to see names like the following table. PCI-4115 RSW1 Connector Device Name 0 CN1/CN2 FBILAPB1 1 CN1/CN2 FBILAPB2 : : : F CN1/CN2 FBILAPB16 PCI-4156, CTP-4156, CPZ-4156 RSW1 Connector Device Name 0 CN1 FBILAPB17 CN2 FBILAPB18 1 CN1 FBILAPB19 CN2 FBILAPB20 : : : F CN1 FBILAPB47 CN2 FBILAPB48 PCI-4157, CTP-4157, CPZ-4157 RSW1 Connector Device Name 0 CN1 FBILAPB49 CN2 FBILAPB50 1 CN1 FBILAPB51 CN2 FBILAPB52 : : : F CN1 FBILAPB79 CN2 FBILAPB80 16

18 4.1.2 Starting Data Transfer The LapbSetLink function establishes the link between the port and the remote station to transfer the data. HANDLE DeviceHandle; LAPBPORTINITDATA ini; LAPBPORTSTATUS sta LONG Ret; // Opens the FBILAPB1 DeviceHandle = LapbOpen("FBILAPB1", NULL, 0, NULL); if (DeviceHandle == INVALID_HANDLE_VALUE) { printf("failed to open a device\n"); } else { printf("succeeded in opening a device\n"); // Connects LINK ini.uformat = LAPB_FORMAT_NRZI; ini.umyaddress = 0x01; ini.uyouraddress = 0x03; ini.utxc = LAPB_SCLK_PTC; ini.urxc = LAPB_RCLK_RT; ini.usourceclock = LAPB_CLOCK_ ; ini.ubaudrate = 9600; ini.uinterface = LAPB_INTERFACE_232C; ini.ulink = LAPB_LINK_SABM; ini.ut1 = 2; ini.ut4 = 5; ini.un2 = 3; ini.uo = 7; Ret = LapbSetLink(DeviceHandle, &LapbInitData); if (Ret!= 0) { printf("lapbsetlink execiton error %xh\n",ret); } else { while (1) { Ret = LapbGetStatus(DeviceHandle, &sta); if (Ret!= 0) { printf("lapbgetstatus execiton error %x\n",ret); break; } else if (ulinkstatus == LAPB_STATUS_LINKED) { printf("established LINK\n"); break; } } } 17

19 The LapbOpen function retrieves the device handle. This function configures the communication parameters, and then opens the link between the port and the remote station. When the function call is successfully completed, the interface module will communicate with the remote station. During that, the LapbGetStatus function retrieves the link status. When the link is established, the link status, the ulinkstatus member of the LAPBPORTSTATUS structure, becomes LAPB_STATUS_LINKED. Data transfers are available Transmitting Data The LapbSendFrame function transmits the data. HANDLE DeviceHandle; LONG Ret; // Opens the FBILAPB1. DeviceHandle = LapbOpen("FBILAPB1", NULL, 0, NULL); Ret = LapbSendFrame(DeviceHandle, "Test Data.", 10); if (Ret!= 0) printf("lapbsendframe execution error %x\n",ret); The following HDLC frames are transmitted to the network. FLAG A C I FCS FLAG FLAG: Flag A: Remote station address The address is specified by uyouraddress of the LAPBPORTINITDATA structure passed to LapSetLink function. C: Control field of the HDLC frames The field is automatically generated according to the LAP-B protocol. I: Transmit data The transmit data passed to the LapbSendFrame function is set into this field. FCS: Frame check sequence obtaind by the generator polynomial (X 16 +X 12 +X 5 +1). 18

20 4.1.4 Receiving Data The LapbReceiveFrame function receives the data from the buffer. The I field of the received HDLC frame is retrieved as received data. The status of received buffer is obtained by the LapbGetFrameCount functionor the LapbGetFrameLength function. HANDLE DeviceHandle; LONG Ret; ULONG count, len; unsigned char Buffer[MAXSIZE]; // Opens FBILAPB1. DeviceHandle = LapbOpen("FBILAPB1", NULL, 0, NULL); Ret = LapbGetFrameCount(DeviceHandle, &count); if (Ret!= 0) printf("lapbgetframecount execution error %x\n",ret); else { printf("receive buffer has %ld receive frames\n", count); Ret = LapbGetFrameLength(DeviceHandle, &len); printf("lapbgetframelength execution error %x\n", Ret); else { printf("the data size of the head data in receive bufferis %ld Byte \n", len); Ret = LapbReceiveFrame(DeviceHandle, Buffer, &len); if (Ret!= 0) printf("lapbreceiveframe execution error %x\n",ret); else { printf("retrieved %ld Byte receive data and stored it in thebuffer \n", len); } } } 19

21 4.1.5 Controlling Signals and Retrieving Signal Status The LapbSetControlLine function activates or inactivates the control signals and the LapbGetControlLine function retrieves the signal status. HANDLE DeviceHandle; LONG Ret; DWORD line, change; // Opens the FBILAPB1. DeviceHandle = LapbOpen("FBILAPB1", NULL, 0, NULL); // Activates the RS(C) signal. Ret = LapbSetControlLine(DeviceHandle, 0x02); if (Ret!= 0) printf("lapbsetcontrolline execution error %x\n",ret); // Retrieves the status of the control signals. Ret = LapbGetControlLine(DeviceHandle, &line, &change); if (Ret!= 0) printf("lapbgetcontrolline execution error %x\n",ret); else { printf(" control signal status: %lx change status: %lx\n",line, change); } 20

22 4.1.6 Closing the Port The LapbCutLink function disconnects the data link. You need to wait until the link close is completed. During that process, the LapbGetStatus function retrieves the link status. When ulinkstatus becomes LAPB_STATUS_NOLINK, the link is successfully disconnected. The LapbClose function closes the port, and then the resources are released. The Devicehandle is disabled until the port is opened again by the LapbOpen function. HANDLE DeviceHandle; LAPBPORTINITDATA ini; LAPBPORTSTATUS sta LONG Ret; // Opens the FBILAPB1. DeviceHandle = LapbOpen("FBILAPB1", NULL, 0, NULL); // Disconnects LINK Ret = LapbCutLink(DeviceHandle, &LapbInitData); if (Ret!= 0) printf("lapbsetlink execution error %xh\n",ret); else { while (1) { Ret = LapbGetStatus(DeviceHandle, &sta); if (Ret!= 0) { printf("lapbgetstatus execution error %x\n",ret); break; } else if (ulinkstatus == LAPB_STATUS_NOLINK) { printf("link was disconnected \n"); break; } } } // Closes the FBILAPB1. Ret = LapbClose(DeviceHandle); if (Ret!= 0) printf("lapbclose execution error %x\n",ret); else { printf("the port was closed \n"); 21

23 4.1.7 Waiting for Events The LapbEventRequestPending function waits the events. You need to unmask the event by using the LapbSetEventMask function before waiting for the events. LapbEventRequestPending function waits for the following changes. A link status is changed. A control signal is changed. A data frame is retrieved. A busy state of the local station is changed. A busy state of a remote station is changed. An unrecoverable error occurs by the LAP-B protocol. HANDLE DeviceHandle, Event; LONG Ret; OVERLAPPED ol; // Opens the FBILAPB1. DeviceHandle = LapbOpen("FBILAPB1", NULL, 0, NULL); Ret = LapbSetEventMask(DeviceHandle, 0x100, 0); if (Ret!= 0) printf("lapbseteventmask execution error %x\n",ret); else { // Generates an event ol.hevent = CreateEvent(NULL, TRUE, FALSE, NULL); // Starts to disconnect LINK Ret = LapbCutLink(DeviceHandle, &LapbInitData); if (Ret!= 0) printf("lapbsetlink execution error %xh\n",ret); else { // Waits for an event. Ret = LapbEventRequestPending(DeviceHandle, 0x100, &ev, &ol); if(ret!= FBILAPB_ERROR_IO_PENDING) { printf("lapbeventrequestpending execution error %x\n",ret) } else { Ret = WaitForSingleObject(ol.hEvent, 10000); if (Ret == WAIT_TIMEOUT) printf("timeout error occurred \n"); else printf("completed to disconnect LINK n"); } } } 22

24 4.2 List of DLL Functions No. Function Description 1 LapbOpen Opens a port and enables to access to the port. 2 LapbClose Closes the port and releases the resources. Any subsequent accesses to the port are forbidden. 3 LapbSetLink Initializes the operational mode of the LAP-B and sets up a link between the local and remote stations. 4 LapbCutLink Disconnects the link between the local and remote stations. 5 LapbSendFrame Sends the data by using the I frame to the remote station. 6 LapbGetFrameLength Retrieves the data length stored in the head receive buffers. 7 LapbGetFrameCount Retrieves the number of frames stored in the receive buffers. 8 LapbReceiveFrame Retrieves data from the receive buffers. 9 LapbGetStatus Retrieves the current status of the LAP-B port. 10 LapbGetHistory Retrieves the LAP-B frame trace information. 11 LapbSetControlLine Sets control signals of the LAP-B port. 12 LapbGetControlLine Retrieves status of the control signals of the LAP-B port. 13 LapbClearBuffer Discards data in the receive buffers of the LAP-B port. 14 LapbSetDiscMode Configures an operation when an SABM frame is received while the link is disconnected. 15 LapbSetT2Time Configures the value of the T2 timer. 16 LapbSetEventMask Sets the event mask. 17 LapbGetEventMask Retrieves the event mask setting. 18 LapbEventRequestPending Waits for the interrupt events. 23

25 4.2.1 LapbOpen Description The LapbOpen function opens a port and enables to access to the port. Syntax C HANDLE LapbOpen( LPCTSTR DeviceName, // Device name HANDLE WindowHandle, // Window handle ULONG WindowMessage, // Window message LPLAPBCALLBACK CallBackProc // Pointer to the callback procedure ); Visual Basic Declare Function LapbOpen Lib "FbiLapb.DLL"(_ ByVal DeviceName As String, _ ' Device name ByVal WindowHandle As Long, _ ' Window handle ByVal WindowMessage As Long, _ ' Window message ByVal CallBackProc As Long _ ' Pointer to the callback ' procedure ) As Long Delphi function LapbOpen( DeviceName: String; // Device name WindowHandle: THandle; // Window handle WindowMessage: Integer; // Window message CallBackProc: Pointer // Pointer to the callback procedure ):THandle; stdcall; external 'FbiLapb.DLL'; 24

26 Parameters DeviceName Specifies the device name to open. The device names are assigned as the following table. PCI-4115 RSW1 Connector Device Name 0 CN1/CN2 FBILAPB1 1 CN/CN2 FBILAPB2 : : : F CN1/CN2 FBILAPB16 PCI-4156, CTP-4156, CPZ-4156 RSW1 Connector Device Name 0 CN1 FBILAPB17 CN2 FBILAPB18 1 CN1 FBILAPB19 CN2 FBILAPB20 : : : F CN1 FBILAPB47 CN2 FBILAPB48 PCI-4157, CTP-4157, CPZ-4157 RSW1 Connector Device Name 0 CN1 FBILAPB49 CN2 FBILAPB50 1 CN1 FBILAPB51 CN2 FBILAPB52 : : : F CN1 FBILAPB79 CN2 FBILAPB80 Note: When you use two or more interface modules of the same group in the same system, the RSW1 switch setting must be unique. WindowHandle WindowMessage CallBackProc Species a window handle to post a message. Specify a NULL (0 for Visual Basic or Delphi) if the window handle is not applicable. Specifies the message to be posted to the window specified by WindowHandle. This function is applicable only when WindowHandle is other than Null. Points to a callback routine. Specify a NULL (0 for Visual Basic, nil for Delphi) if the window handle is not applicable. Return Value The LapbOpen function returns a valid handle when the process is successfully completed. Otherwise, this function returns INVALID_HANDLE_VALUE if the process is failed. 25

27 Comment Device name In Windows Vista/XP/XP Embedded/Server 2003/2000/Me/98/95, Interface LAP-B boards names, RSW1 values, and device names are listed under FbiPciLapb in the Device Manager. You can also verify these items using the diagnostic program (DIAGLAPB.EXE). In Windows NT, use the diagnostic program (DIAGLAPB.EXE) to verify these items. Example C HANDLE DeviceHandle; DeviceHandle = LapbOpen( FBILAPB1, NULL, 0, NULL ); Visual Basic Dim DeviceName As String Dim DeviceHandle As Long DeviceName = "FBILAPB1" & Chr(0) DeviceHandle = LapbOpen(DeviceName, 0, 0, 0) Delphi var DeviceName: String; DeviceHandle: THandle; begin DeviceName := 'FBILAPB1'; DeviceHandle := LapbOpen(DeviceName, 0, 0, nil); 26

28 4.2.2 LapbClose Description The LapbClose function closes a port and releases the resources. Any subsequent accesses to the port are forbidden. Syntax C LONG LapbClose( HANDLE DeviceHandle ); // Device handle Visual Basic Declare Function LapbClose Lib "FbiLapb.DLL"(_ ByVal DeviceHandle As Long _ ' Device handle )As Long Delphi function LapbClose ( DeviceHandle: THandle // Device handle ): Integer; stdcall; external 'FbiLapb.DLL'; Parameter DeviceHandle Specifies the device handle obtained by the LapbOpen function. Return Value The LapbClose function returns 0 if the process is successfully completed. Otherwise, this function returns another code. Please refer to the Return Values. Comment Calling the LapbClose function aborts and terminates any communications. Calling the LapbClose function during data transmission results in communication errors. Prior to calling the LapbClose function, call the LapbCutLink function to release the link between the local and remote stations. 27

29 Example C HANDLE DeviceHandle; LONG Ret; DeviceHandle = LapbOpen( FBILAPB1, NULL, 0, NULL ); Ret = LapbClose(DeviceHandle); Visual Basic Dim DeviceName As String Dim DeviceHandle As Long Dim Ret As Long DeviceName = "FBILAPB1" & Chr(0) DeviceHandle = LapbOpen(DeviceName, 0, 0, 0) Ret = LapbClose(DeviceHandle) Delphi var DeviceName: String; DeviceHandle: THandle; Ret: Integer; begin DeviceName := 'FBILAPB1'; DeviceHandle := LapbOpen(DeviceName, 0, 0, nil); Ret := LapbClose(DeviceHandle); 28

30 4.2.3 LapbSetLink Description The LapbSetLink function initializes the operational mode of LAP-B and sets up a link between the local and remote stations. Syntax C LONG LapbSetLink( HANDLE DeviceHandle, // Device handle PLAPBPORTINITDATA LapbInitData // Pointer to the // LAPBPORTINITDATA structure. ); Visual Basic Declare Function LapbSetLink Lib "FbiLapb.DLL"(_ ByVal DeviceHandle As Long, _ ' Device handle ByRef LapbInitData As LAPBPORTINITDATA _ ' Reference to the ' LAPBPORTINITDATA ' sturucture )As Long Delphi function LapbSetLink ( DeviceHandle: THandle; //Device handle var LapbInitData: LAPBPORTINITDATA; //Reference to the //LAPBPORTINITDATA sturucture ): Integer; stdcall; external 'FbiLapb.DLL'; Parameters DeviceHandle LapbInitData Specifies the device handle obtained by the LapbOpen function. Points to the LAPBPORTINITDATA structure. Return Value The LapbSetLink function returns 0 if the process is successfully completed. Otherwise, this function returns another code. Please refer to the Return Values. Comment The LapbSetLink function starts to set up a link after the initialization of the operational mode of LAP-B. The successful completion of the LapbSetLink means that a link is set up, but does not mean that the set up of a link is completed and the data transfer is available. Call the LapbGetStatus function or use event or message to retrieve the status of the link connection. 29

31 Example C HANDLE DeviceHandle; LAPBPORTINITDATA ini; LONG Ret; DeviceHandle = LapbOpen( FBILAPB1, NULL, 0, NULL ); ini.uformat = LAPB_FORMAT_NRZI; ini.umyaddress = 0x01; ini.uyouraddress = 0x03; ini.utxc = LAPB_SCLK_PTC; ini.urxc = LAPB_RCLK_RT; ini.usourceclock = LAPB_CLOCK_ ; ini.ubaudrate = 9600; ini.uinterface = LAPB_INTERFACE_232C; ini.ulink = LAPB_LINK_SABM; ini.ut1 = 2; ini.ut4 = 5; ini.un2 = 3; ini.uo = 7; Ret = LapbSetLink(DeviceHandle, &ini); Visual Basic Dim DeviceName As String Dim DeviceHandle As Long Dim ini As LAPBPORTINITDATA Dim Ret As Long DeviceName = "FBILAPB1" & Chr(0) DeviceHandle = LapbOpen(DeviceName, 0, 0, 0) ini.uformat = LAPB_FORMAT_NRZI ini.umyaddress = 1 ini.uyouraddress = 3 ini.utxc = LAPB_SCLK_PTC ini.urxc = LAPB_RCLK_RT ini.usourceclock = LAPB_CLOCK_ ini.ubaudrate = 9600 ini.uinterface = LAPB_INTERFACE_232C ini.ulink = LAPB_LINK_SABM ini.ut1 = 2 ini.ut4 = 5 ini.un2 = 3 ini.uo = 7 Ret = LapbSetLink(Devicehandle, ini) 30

32 Delphi var DeviceName: String; DeviceHandle: THandle; ini: LAPBPORTINITDATA; Ret: Integer; begin DeviceName := 'FBILAPB1'; DeviceHandle := LapbOpen(DeviceName, 0, 0, nil); ini.uformat := LAPB_FORMAT_NRZI; ini.umyaddress := 1; ini.uyouraddress := 3; ini.utxc := LAPB_SCLK_PTC; ini.urxc := LAPB_RCLK_RT; ini.usourceclock := LAPB_CLOCK_ ; ini.ubaudrate := 9600; ini.uinterface := LAPB_INTERFACE_232C; ini.ulink := LAPB_LINK_SABM; ini.ut1 := 2; ini.ut4 := 5; ini.un2 := 3; ini.uo := 7; Ret := LapbSetLink(DeviceHandle, ini); 31

33 4.2.4 LapbCutLink Description The LapbCutLink function disconnects the link between the local and remote stations. Syntax C LONG LapbCutLink( HANDLE DeviceHandle ); // Device handle Visual Basic Declare Function LapbCutLink Lib "FbiLapb.DLL"(_ ByVal DeviceHandle As Long _ ' Device handle )As Long Delphi function LapbCutLink ( DeviceHandle: THandle // Device handle ): Integer; stdcall; external 'FbiLapb.DLL'; Parameter DeviceHandle Specifies the device handle obtained by the LapbOpen function. Return Value The LapbCutLink function returns 0 if the process is successfully completed. Otherwise, this function returns another code. Please refer to the Return Values. Comment The LapbCutLink function returns the processing just after the disconnection is started. Even if the LapbCutLink function is successfully completed, the disconnection of the link may not completed. Confirm the link state with the LapbGetStatus function. 32

34 Example C HANDLE DeviceHandle; LAPBPORTINITDATA ini; LONG Ret; DeviceHandle = LapbOpen( FBILAPB1, NULL, 0, NULL ); Ret = LapbSetLink(Devicehandle, &ini) Ret = LapbCutLink(DeviceHandle); Visual Basic Dim DeviceName As String Dim DeviceHandle As Long Dim ini As LAPBPORTINITDATA Dim Ret As Long DeviceName = "FBILAPB1" & Chr(0) DeviceHandle = LapbOpen(DeviceName, 0, 0, 0) Ret = LapbSetLink(Devicehandle, ini) Ret = LapbCutLink(DeviceHandle) Delphi var DeviceName: String; DeviceHandle: THandle; ini: LAPBPORTINITDATA; Ret: Integer; begin DeviceName := 'FBILAPB1'; DeviceHandle := LapbOpen(DeviceName, 0, 0, nil); Ret := LapbSetLink(DeviceHandle, ini); Ret := LapbCutLink(DeviceHandle); 33

35 4.2.5 LapbSendFrame Description The LapbSendFrame function sends the data by using the I frame to the remote stations. Syntax C LONG LapbSendFrame( HANDLE DeviceHandle, // Device handle LPVOID IField, // Pointer to the transmit data ULONG Length, // I field size LPOVERLAPPED OverLapped // Pointer to the // OVERLAPPEDstructure ); Visual Basic Declare Function LapbSendFrame Lib "FbiLapb.DLL"(_ ByVal DeviceHandle As Long, _ ' Device handle ByRef IField As Byte, _ ' Reference to the transmit data ByVal Length As Long, _ ' I field size ByRef OverLapped As OVERLAPPED _ ' Reference to the OVERLAPPED ' structure )As Long Delphi function LapbSendFrame ( DeviceHandle: THandle; // Device handle IField: pointer; // Pointer to the transmit data Length: Integer; // I field size OverLapped Poverlapped // Pointer to the // OVERLAPPEDstructure ): Integer; stdcall; external 'FbiLapb.DLL'; 34

36 Parameters DeviceHandle Specifies the device handle obtained by the LapbOpen function. IField Specifies the I field of I frame to be transmitted. The following HDLC frames to which the A, C field and FCS are automatically appended are transmitted. FLAG A C I (Data specified by IField) FCS FLAG FLAG: Flag A: Remote station address The address is specified by uyouraddress of the LAPBPORTINITDATA structure passed to LapSetLink function. C: Control field of the HDLC frames The field is automatically generated according to the LAP-B protocol. I: Transmit data The transmit data passed to the LapbSendFrame function is set into this field. FCS: Frame check sequence obtaind by the generator polynomial (X 16 +X 12 +X 5 +1). Length OverLapped Specifies the size of the I field. Point to the OVERLAPPED structure. The event object will be signaled when the transfer completes. Specify NULL when not using the event notification. Return Value The LapbSendFrame function returns 0 if the process is successfully completed. Otherwise, this function returns another code. In the asynchronous operation, the LapbSendFrame function always returns FBILAPB_ERROR_IO_PENDING or an error status. Please refer to the Return Values if another code and/or an error status is returned. Comment The LapbSendFrame function returns the processing after the completion of setting the data in transmit buffers. This operation does not affected by the specification of the OverLapped. Only I field can be specified to the Ifield and Length. The A field, C field and FCS are added automatically, and will be transmitted after an I frame is generated. 35

37 Example C HANDLE DeviceHandle; LONG Ret; DeviceHandle = LapbOpen( FBILAPB1, NULL, 0, NULL ); Ret = LapbSendFrame(DeviceHandle, " ", 10, NULL); Visual Basic Dim DeviceName As String Dim DeviceHandle As Long Dim Ret As Long DeviceName = "FBILAPB1" & Chr(0) DeviceHandle = LapbOpen(DeviceName, 0, 0, 0) Ret = LapbSendFrame(DeviceHandle, " ", 10, 0) Delphi var DeviceName: String; DeviceHandle: THandle; Ret: Integer; begin DeviceName := 'FBILAPB1'; DeviceHandle := LapbOpen(DeviceName, 0, 0, nil); Ret := LapbSendFrame(DeviceHandle, " ", 10, nil); 36

38 4.2.6 LapbGetFrameLength Description The LapbGetFrameLength function retrieves the data length stored in the head receive buffers. Syntax C LONG LapbGetFrameLength( HANDLE DeviceHandle PULONG Length ); // Device handle // Pointer to a valiable to // receive the flame length. Visual Basic Declare Function LapbGetFrameLength Lib "FbiLapb.DLL"(_ ByVal DeviceHandle As Long, _ ' Device handle ByRef Length As Long _ ' Refernce to a valiable to ' receive the flame length. )As Long Delphi function LapbGetFrameLength ( DeviceHandle: THandle; // Device handle var Length: Integer // Reference to a valiable to receive //the flame length. ): Integer; stdcall; external 'FbiLapb.DLL'; Parameters DeviceHandle Specifies the device handle obtained by the LapbOpen function. Length Points to a variable to receive data length. When the LapbGetFrameLength function is normally completed, the receive frame length is returned to this variable. Return Value The function returns 0 if the process is successfully completed. Otherwise, this function returns another code. Please refer to the Return Values. Comment If the receive buffer does not have any data, the LapbGetFrameLength fucntion is normally completed and returns 0 to the Length. 37

39 Example C HANDLE DeviceHandle; ULONG Lenght; LONG Ret; DeviceHandle = LapbOpen( FBILAPB1, NULL, 0, NULL ); Ret = LapbGetFrameLength(DeviceHandle, &Length); Visual Basic Dim DeviceName As String Dim DeviceHandle As Long Dim Length As Long Dim Ret As Long DeviceName = "FBILAPB1" & Chr(0) DeviceHandle = LapbOpen(DeviceName, 0, 0, 0) Ret = LapbGetFrameLength(DeviceHandle, Length) Delphi var DeviceName: String; DeviceHandle: THandle; Length: Integer; Ret: Integer; begin DeviceName := 'FBILAPB1'; DeviceHandle := LapbOpen(DeviceName, 0, 0, nil); Ret := LapbGetFrameLength(DeviceHandle, Length); 38

40 4.2.7 LapbGetFrameCount Syntax The LapbGetFrameCount function retrieves the number of frames stored in the receive buffers. C LONG LapbGetFrameCount( HANDLE DeviceHandle // Device handle PULONG Count // Pointer to a valiable to receive the // frame counts ); Visual Basic Declare Function LapbGetFrameCount Lib "FbiLapb.DLL"(_ ByVal DeviceHandle As Long, _ ' Device handle ByRef Count As Long _ ' Reference to a valiable to ' receive the frame counts )As Long Delphi function LapbGetFrameCount ( DeviceHandle: THandle; // Device handle var Count: Integer // Reference to a valiable to receive // the frame counts ): Integer; stdcall; external 'FbiLapb.DLL'; Parameters DeviceHandle Count Specifies the device handle obtained by the LapbOpen function. Points to a variable to receive frame counts. If the LapbGetFrameCount function is nourmally completed, the frame count is returned to this variable. Return Value The LapbGetFrameCount function returns 0 if the process is successfully completed. Otherwise, this function returns another code. Please refer to the Return Values. 39

41 Example C HANDLE DeviceHandle; ULONG Count; LONG Ret; DeviceHandle = LapbOpen( FBILAPB1, NULL, 0, NULL ); Ret = LapbGetFrameCount(DeviceHandle, & Count); Visual Basic Dim DeviceName As String Dim DeviceHandle As Long Dim Count As Long Dim Ret As Long DeviceName = "FBILAPB1" & Chr(0) DeviceHandle = LapbOpen(DeviceName, 0, 0, 0) Ret = LapbGetFrameCount(DeviceHandle, Count) Delphi var DeviceName: String; DeviceHandle: THandle; Count: Integer; Ret: Integer; begin DeviceName := 'FBILAPB1'; DeviceHandle := LapbOpen(DeviceName, 0, 0, nil); Ret := LapbGetFrameCount(DeviceHandle, Count); 40

42 4.2.8 LapbReceiveFrame The LapbReceiveFrame function retrieves data from the receive buffers. Syntax C LONG LapbReceiveFrame( HANDLE DeviceHandle, LPVOID Data, ); PULONG Length // Device handle // Pointer to a variable to // return the receive data // Pointer to the variable to return the // size Visual Basic Declare Function LapbReceiveFrame Lib "FbiLapb.DLL"(_ ByVal DeviceHandle As Long, _ ' Device handle ByRef Data As Byte, _ ' Reference to a variable to ' receive the receive data ByRef Length As Long _ ' Reference to a variable to ' receive the data size. )As Long Delphi function LapbReceiveFrame ( DeviceHandle: THandle; // Device handle Data: pointer; // Pointer to a variable to // receive the receive data var Length: Integer // Reference to a variable to receive // the size ): Integer; stdcall; external 'FbiLapb.DLL'; Parameters DeviceHandle Data Length Specifies the device handle obtained by the LapbOpen function. Points to a variable to receive the received data. If the LapbReceiveFrame function is normally completed, the Information field of receive frame is returned. Points to a variable to receive data length. If the LapbReceiveFrame function is normally completed, the length of the receive frame passed to Data is returned. Return Value The function returns 0 if the process is successfully completed. Otherwise, this function returns another code. Please refer to the Return Values. 41

43 Comment The I field of the received frame is returned to the Data. The A field, C field and FCS are not included. The returned values to the Length are the length of Ifield as well. Example C HANDLE DeviceHandle; char Data[16384]; LONG Length, Ret; DeviceHandle = LapbOpen( FBILAPB1, NULL, 0, NULL ); Ret = LapbReceiveFrame(DeviceHandle, Data, &Length); Visual Basic Dim DeviceName As String Dim DeviceHandle As Long Dim Data As String * Dim Length As Long Dim Ret As Long DeviceName = "FBILAPB1" & Chr(0) DeviceHandle = LapbOpen(DeviceName, 0, 0, 0) Ret = LapbReceiveFrame(DeviceHandle, Data, Length) Delphi var DeviceName: String; DeviceHandle: THandle; Data: array[ ] of Byte Length: Integer Ret: Integer; begin DeviceName := 'FBILAPB1'; DeviceHandle := LapbOpen(DeviceName, 0, 0, nil); Ret := Length); 42

44 4.2.9 LapbGetStatus Description The LapbGetStatus function retrieves the current status of the LAP-B port. Syntax C LONG LapbGetStatus( HANDLE DeviceHandle, // Device handle PLAPBPORTSTATUS Status // Pointer to the // LAPBPORTSTATUSstructure ); Visual Basic Declare Function LapbGetStatus Lib "FbiLapb.DLL"(_ ByVal DeviceHandle As Long, _ ' Device handle ByRef Status As LAPBPORTSTATUS _ ' Reference to the ' LAPBPORTSTATUS structure )As Long Delphi function LapbGetStatus ( DeviceHandle: THandle // Device handle var Status: LAPBPORTSTATUS // Reference to the // LAPBPORTSTATUS structure ): Integer; stdcall; external 'FbiLapb.DLL'; Parameters DeviceHandle Status Specifies the device handle obtained by the LapbOpen function. Points to the LAPBPORTSTATUS structure. Return Value The function returns 0 if the process is successfully completed. Otherwise, this function returns another code. Please refer to the Return Values. 43

45 Example C HANDLE DeviceHandle; LAPBPORTSTATUS Status; LONG Ret; DeviceHandle = LapbOpen( FBILAPB1, NULL, 0, NULL ); Ret = LapbGetStatus(DeviceHandle, &Status); Visual Basic Dim DeviceName As String Dim DeviceHandle As Long Dim Status As LAPBPORTSTATUS Dim Ret As Long DeviceName = "FBILAPB1" & Chr(0) DeviceHandle = LapbOpen(DeviceName, 0, 0, 0) Ret = LapbGetStatus(DeviceHandle, Status) Delphi var DeviceName: String; DeviceHandle: THandle; Status: LAPBPORTSTATUS; Ret: Integer; begin DeviceName := 'FBILAPB1'; DeviceHandle := LapbOpen(DeviceName, 0, 0, nil); Ret := LapbGetStatus(DeviceHandle, Status); 44

46 LapbGetHistory Description The LapbGetHistory function retrieves the LAP-B frame trace information. Syntax C LONG LapbGetHistory( HANDLE DeviceHandle // Device handle PLAPBHISTORY History // Pointer to the LAPBHISTORY structure PULONG Count // Pointer to a variable to receive the //number of histories ); Visual Basic Declare Function LapbGetLibHistory "FbiLapb.DLL"(_ ByVal DeviceHandle As Long, _ ' Device handle ByRef History As LAPBHISTORY, _ ' Reference to the ' LAPBHISTORY structure ByRef Count As Long _ ' Reference to a variable ' to receive the number of ' histories )As Long Delphi function LapbGetHistory ( DeviceHandle: THandle; // Device handle var History: LAPBHISTORY; // Pointer to the LAPBHISTORY // structure var Count: Integer // Reference to a variable to receive // the number of histories ): Integer; stdcall; external 'FbiLapb.DLL'; Parameters DeviceHandle History Count Specifies the device handle obtained by the LapbOpen function. Points to the LAPBHISTORY structure to receive the LAP-B frame trace information. Points to the variable to receive the number of the valid Lap-B frame trace information records returned to the History. Return Value The function returns 0 if the process is successfully completed. Otherwise, this function returns another code. Please refer to the Return Values. 45

47 Comment When the LapbGetHistory function is successfully completed, the LAP-B frame trace information records that the LAPB controller contains are returned to the LAPBHISTORY structure. Then, the number of transferred valid LAP-B frame trace informations is returned to the Count. The maximum number of the LAP-B frame trace information records returned to the History is 256 (The latest trace information records are returned). Example C HANDLE DeviceHandle; LAPBHISTORY History[256]; ULONG Count; LONG Ret; DeviceHandle = LapbOpen( FBILAPB1, NULL, 0, NULL ); Ret = LapbGetHistory(DeviceHandle, History, &Count); Visual Basic Dim DeviceName As String Dim DeviceHandle As Long Dim History(256) As LAPBHISTORY Dim Count As Long Dim Ret As Long DeviceName = "FBILAPB1" & Chr(0) DeviceHandle = LapbOpen(DeviceName, 0, 0, 0) Ret = LapbGetHistory(DeviceHandle, History(0), Count) Delphi var DeviceName: String; DeviceHandle: THandle; History: array[0255] of LAPBHISTORY; Count: Integer; Ret: Integer; begin DeviceName := 'FBILAPB1'; DeviceHandle := LapbOpen(DeviceName, 0, 0, nil); Ret := Count); 46

48 LapbSetControlLine Description The LapbSetControlLine function sets control signals of the LAP-B port. Syntax C LONG LapbSetControlLine( HANDLE DeviceHandle, // Device handle DWORD Control // Output status of control signals ); Visual Basic Declare Function LapbSetControlLine Lib "FbiLapb.DLL"(_ ByVal DeviceHandle As Long, _ ' Device handle ByVal Control As Long _ ' Output status of control signals )As Long Delphi function LapbSetControlLine ( DeviceHandle: THandle; // Device handle Control: Integer // Output status of control signals ): Integer; stdcall; external 'FbiLapb.DLL'; Parameters DeviceHandle Control Specifies the device handle obtained by the LapbOpen function. Specifies the state of the control signals to be output from LAP-B port. Available control signals differ depending on the interface: RS-232C or RS-485. Bit31 through bit 2 bit1 bit0 RS-232C RS ER RS-485 C 0: Inactive 1: Active Return Value The function returns 0 if the process is successfully completed. Otherwise, this function returns another code. Please refer to the Return Values. 47

49 Example C HANDLE DeviceHandle; LONG Ret; DeviceHandle = LapbOpen( FBILAPB1, NULL, 0, NULL ); Ret = LapbSetControlLine(DeviceHandle, 2); Visual Basic Dim DeviceName As String Dim DeviceHandle As Long Dim Ret As Long DeviceName = "FBILAPB1" & Chr(0) DeviceHandle = LapbOpen(DeviceName, 0, 0, 0) Ret = LapbSetControlLine(DeviceHandle, 2) Delphi var DeviceName: String; DeviceHandle: THandle; Ret: Integer; begin DeviceName := 'FBILAPB1'; DeviceHandle := LapbOpen(DeviceName, 0, 0, nil); Ret := LapbSetControlLine(DeviceHandle, 2); 48

50 LapbGetControlLine Description The LapbGetControlLine function retrieves status of the control signals of the LAP-B port. Syntax C LONG LapbGetControlLine( HANDLE DeviceHandle, // Device handle PDWORD Control, // Pointer to a variable to receivethe // current status PDWORD Change // Pointer to a variable to receive the // change information ); Visual Basic Declare Function LapbGetControlLine Lib "FbiLapb.DLL"(_ ByVal DeviceHandle As Long, _ ' Device handle ByRef Control As Long, _ ' Reference to a variable to ' receive the current status ByRef Change As Long _ ' Reference to a variable to ' receive the change information )As Long Delphi function LapbGetControlLine ( DeviceHandle: THandle; // Device handle Var Control: Integer; // Reference to a variable to receive the // current status Var Change: Integer // Reference to a variable to receive the // current status ): Integer; stdcall; external 'FbiLapb.DLL'; Parameters DeviceHandle Specifies the device handle obtained by the LapbOpen function. Control Points to a variable to receive current control signal status. Available control signals differ depending on the interface: RS-232C or RS-485. bit31 to bit8 bit7 bit6 bit5 bit4 bit3 bit2 bit1 bit0 RS-232C CI CS CD DR RS ER RS-485 I C 0: Inactive 1: Active Note: The RS, ER and C receive current output status. 49