background image

 
 

 

WERMA SIGNALTECHNIK 

Version 1.2.0 - 0911 

15  

6.

 

Operation with Dynamic Link Library (DLL) 

6.1

 

Introduction 

The USB terminal element provides connectivity for a signal tower to the PC via USB. 

The user controls the USB module by using a specified dynamic link library (DLL) file found on 
the CD provided with the USB terminal element. The DLL contains several functions to set and 

retrieve the light module status. 
The control over the light module is generally carried out by a customer application. The 

control over the module from the user application is achieved via a specific DLL which shares 
all the commonly needed functions. The DLL library is a standard windows functions library 

which can be easily used with the most common application development tools such as 
Visual Basic, Visual C++ etc.   

6.2

 

Related files and executables 

Runtime files: 

The DLL Library should reside in a file located in the same folder with user project .EXE file. This 

file communicates with the USB module. 

slma.dll 

Contains functions which provide control over the USB module 

6.3

 

DLL Functions 

6.3.1

 

Function Overview 

 

1

 Please note that Linux, Mac OS X and Windows CE do not support location IDs. 

2

 Please note that these two functions cover the further functions (see next page). 

 
 

  

 

Basic Functions 

SetUsbDevice

 Returns 

the 

 number

 

of

 

devices 

currently found in the system 

SetDeviceStatus

2

 

Sets

 the status (ON, OFF, Blinking mode 1, Blinking mode 2) for 

all 

Outputs   

GetDeviceStatus

2

 

Gets

 the current Output status (ON, OFF, Blinking mode 1, Blinking 

mode 2) for 

all Outputs  

GetDeviceSerial 

Gets

 the specified device 

serial code

 

GetDeviceLocation

1

 

Gets

 the 

Location ID

 of the USB port, where the device is connected 

GetFirmwareVersion

 

Gets

 the specified device 

firmware version

 

GetLibVersion 

Gets

 the currently used 

library version 

Содержание KombiSIGN 71

Страница 1: ...Manual USB Terminal Element WERMA Signaltechnik GmbH Co KG Manual for USB Terminal Element KombiSIGN 71 and KOMPAKT 71 with USB Interface Version 1 2 0 2011 ...

Страница 2: ......

Страница 3: ...ds 10 5 2 1 Version 10 5 2 2 Name 10 5 2 3 Write 11 5 2 4 Read 12 5 3 HyperTerminal 12 6 Operation with Dynamic Link Library DLL 15 6 1 Introduction 15 6 2 Related files and executables 15 Runtime files 15 6 3 DLL Functions 15 6 3 1 Function Overview 15 6 3 2 Basic Functions 16 6 3 2 1 SetUsbDevice 16 6 3 2 2 SetDeviceStatus 16 6 3 2 3 GetDeviceStatus 17 6 3 2 4 GetDeviceSerial 17 6 3 2 5 GetDevic...

Страница 4: ...namic Link Library the element can also be simply commissioned by means of VCP Virtual COM Port actuation This ensures for simple integration into any customer specific software Up to five signal towers with a maximum of five signalling elements each can be connected per PC An optimized electronic circuit allows each of the elements to be triggered either as a permanent or blinking light This mean...

Страница 5: ...53 Description Quantity Pre assembled tower red yellow green with USB terminal element 1 USB cable 1 8 m 1 Software CD 1 Instruction leaflet 1 2 2 System requirements 500 MHz Pentium II processor or higher 256 MB RAM 512 MB is recommended 150 MB free hard disk space CD DVD drive USB port Windows 2000 service pack 4 Windows XP Windows Vista or Windows 7 Windows Server 2000 service Pack 4 Windows Se...

Страница 6: ...elements with max 90 mA 2 4 Technical data Operating voltage 5 V DC USB Output voltage 24 V DC 10 Current consumption Typ 500 mA Output current Max 90 mA Min operating temperature 25 C Typ operating temperature 25 C Max operating temperature 60 C The signal tower elements can be triggered directly from a PC or Laptop via a standard USB interface The USB port must deliver min 500 mA if not a USB Hu...

Страница 7: ...sta and Windows 7 Note You must have administrator rights to install the drivers 4 Manual driver installation Note Manual driver installation is only required if the USB terminal element is not recognised Windows will open the following window Close this window and open the Device Manager Computer Properties Device Manager Click with the right mouse button on USB TERMINAL ELEMENNT and then click o...

Страница 8: ... Select Brows my computer for driver software and insert the CD of the USB terminal element into your CD ROM drive Specify the location of the driver by clicking Browse Select the Driver folder in the CD ROM drive and confirm by clicking Next ...

Страница 9: ...WERMA SIGNALTECHNIK Version 1 2 0 0911 9 The driver for the USB terminal element has been successfully installed Click Close to finish the update Note The USB terminal element is now ready for operation ...

Страница 10: ...1 Parity None Flow control No 5 2 Commands Note Every command has to end with a return or line feed 5 2 1 Version Type Command Description Version V Information about the version V CR Return Information of the version Example V CR Version 1 2 0 5 2 2 Name Type Command Description Name N Information about the name N CR Return Information of the name Example N CR USB TERMINAL ELEMENT ...

Страница 11: ... mode 2 X Don t care no change on that tier WRXXXXX CR Return Tier 5 Tier 4 Tier 3 Tier 2 Tier 1 Write Example WR120X3 CR OK Tier 1 On Tier 2 Blinking mode 1 Tier 3 Off Tier 4 Don t care Tier 5 Blinking mode 2 Note Blinking mode1 and Blinking mode 2 differ by blinking alternately see diagram ON OFF Permanent ON OFF Blinking mode 1 ON OFF Blinking mode 2 Time ...

Страница 12: ...shows how the USB terminal element can be triggered Using the same settings the USB terminal element can be triggered from other applications Note As of Windows Vista HyperTerminal is no longer included But you can download this free from the Internet or use another terminal program Example with HyperTerminal 1 Connect the USB terminal element to a USB port on your computer 2 Start the HyperTermin...

Страница 13: ...0 0911 13 4 Now select the corresponding port e g COM6 5 Set the bits per second in the following window to 9600 and flow control to none 6 Open the Properties File Properties and the register Settings and press the button ASCII Setup ...

Страница 14: ...ith OK You can save these settings on your PC in order to retrieve them as required Now you can pass the commands to the USB terminal element Note the following points Make sure it is spelt correctly correct case In the event of false entries press the Return button and start again It is not possible to make corrections during the entry ...

Страница 15: ... 2 Related files and executables Runtime files The DLL Library should reside in a file located in the same folder with user project EXE file This file communicates with the USB module slma dll Contains functions which provide control over the USB module 6 3 DLL Functions 6 3 1 Function Overview 1 Please note that Linux Mac OS X and Windows CE do not support location IDs 2 Please note that these tw...

Страница 16: ...le in the system The first index is 1 Pos1 Pos2 Pos3 Pos4 Pos5 Sets port 1 2 3 4 and 5 to OFF ON Blinking mode 1 or Blinking mode 2 depending on value Macro Value As Char Value in ASCII Description OFF 0 0x30 Port off ON 1 0x31 Port on Blinking mode 1 2 0x32 Blinking mode 1 Blinking mode 2 3 0x33 Blinking mode 2 Don t Care X 0x58 No change on that port Return Value 1 if successful otherwise the re...

Страница 17: ... mode 2 3 0x33 Blinking mode 2 Return Value 1 if successful otherwise the return value is 1 6 3 2 4 GetDeviceSerial int GetDeviceSerial in int DevIdx out int TypeCode out int BatchCode out int SerialCode GetDeviceSerial gets the specified device serial code This code is unique and can be use to distinguish between various devices currently installed in the system Parameters DevIdx Index to the des...

Страница 18: ...if successful otherwise the return value is 1 Please note that Linux Mac OS X and Windows CE do not support location IDs 6 3 2 6 GetFirmwareVersion int GetFirmwareVersion in int DevIdx out int Major out int Minor out int Build GetFirmwareVersion gets the specified device firmware version Parameters DevIdx Index to the desire device currently available in the system The first index is 1 Major Point...

Страница 19: ... 3 1 SetIOStatus int SetIOStatus in int DevIdx in int IOMask SetIOStatus sets the status for all Outputs Parameters DevIdx Index to the desire device currently available in the system The first index is 1 IOMask Specifies the lights status mask of all the Outputs The value 1 at a given position in the mask indicates that the Output is set to ON status The value 0 indicates the OFF status This para...

Страница 20: ... DevIdx out int OutMask GetIOStatus gets the current Output status for all Outputs Parameters DevIdx Index to the desire device currently available in the system The first index is 1 OutMask Pointer to a variable that will contain the current Output status mask This parameter can be the sum of the following Output port indexes Macro Value Description OFF 0 No port enable O1 1 IO 1 enable also if B...

Страница 21: ...device currently available in the system The first index is 1 IOIdx Specifies the index of current desire Output This value range between 1 to 5 Status Specifies a pointer to variable that will contain the Output status The value set in the variable can be as following 0 Output is OFF 1 Output is ON 2 Output is Blinking mode 1 3 Output is Blinking mode 2 Return Value 1 if successful otherwise the ...

Страница 22: ... an error message that the DLL was not found Connect the USB terminal element to a USB port on your PC Click on Search Devices to find all connected USB terminal elements max four elements in the demo On the left side you can see all the USB terminal elements which are connected to the PC By clicking on Permanent light Blinking mode 1 or Blinking mode 2 you get different light effects for each tie...

Страница 23: ...310 640 008 0911 WERMA Signaltechnik GmbH Co KG D 78604 Rietheim Weilheim Fon 49 0 7424 9557 0 Fax 49 0 7424 9557 44 info werma com www werma com ...

Отзывы: