Siemens SIMATIC Ident Installation Manual

Siemens SIMATIC Ident Installation Manual

Simatic 3964r protocol for windows 9x/xp/7
Hide thumbs Also See for SIMATIC Ident:

Quick Links

SIMATIC 3964R protocol
for Windows 9x/XP/7
SIMATIC Ident
RFID systems
SIMATIC 3964R protocol
for Windows 9x/XP/7
Installation Manual
01/2013
J31069-D0131-U001-A2-7218
___________________
Introduction
___________________
Installation
___________________
Parameter assignment
___________________
Programming interface
1
2
3
4
Table of Contents
loading

Summary of Contents for Siemens SIMATIC Ident

  • Page 1 ___________________ SIMATIC 3964R protocol Introduction for Windows 9x/XP/7 ___________________ Installation ___________________ Parameter assignment SIMATIC Ident ___________________ Programming interface RFID systems SIMATIC 3964R protocol for Windows 9x/XP/7 Installation Manual 01/2013 J31069-D0131-U001-A2-7218...
  • Page 2 Note the following: WARNING Siemens products may only be used for the applications described in the catalog and in the relevant technical documentation. If products and components from other manufacturers are used, these must be recommended or approved by Siemens. Proper transport, storage, installation, assembly, commissioning, operation and maintenance are required to ensure that the products operate safely and without any problems.
  • Page 3: Table Of Contents

    Table of contents Introduction..............................5 Range of functions .........................6 System requirements ........................6 Installation ..............................7 Installing the driver.........................7 Adapting the registry ........................9 Linking in the header file ........................9 Linking in the library file .........................9 Parameter assignment..........................11 Programming interface ..........................13 Functions of the serial interface ....................13 Error and status messages ......................23 Linking the driver into your own programs...................26...
  • Page 4 Table of contents SIMATIC 3964R protocol for Windows 9x/XP/7 Installation Manual, 01/2013, J31069-D0131-U001-A2-7218...
  • Page 5: Introduction

    Introduction Purpose of this document This manual contains information on the installation and parameter assignment of the "3964R" driver and on programming applications based on the supplied files. With the help of the driver and the supplied header and library files, you can program your own applications to allow communication between Windows PCs and the connected RFID systems.
  • Page 6: Range Of Functions

    Introduction 1.1 Range of functions Range of functions The 3964R driver supports the following functions: ● Support of Windows 9x, XP and Windows 7 ● 3964R master/slave protocol or Lauf protocol can be selected ● Any COM port can be set in the parameters (COM1 ... COM255). Up to 4 serial interfaces can be operated parallel to each other.
  • Page 7: Installation

    Installation Installing the driver You will find the installation files on the DVD "RFID Systems, Software & Documentation" (order number: 6GT2080-2AA20). Follow the steps below to install the driver: 1. Start the setup program by double-clicking on the ""MOBYAPI.MSI" or "SETUP.EXE" file in the DVD folder "daten/Moby_lib/MOBY_API".
  • Page 8 Installation 2.1 Installing the driver 3. Decide whether the driver will be set up for the current user "Just me" or for all users "Everyone". Figure 2-2 Selection of the user group 4. Click the "Next" button to install the driver. 5.
  • Page 9: Adapting The Registry

    Installation 2.2 Adapting the registry Adapting the registry When installing the driver, information about the existing interfaces and their configuration is adapted to the Windows Registry and a new registry entry is made. The installation program handles the settings required for this automatically. Linking in the header file If you want to use the function library for program development, you will need to link the header file into the development project.
  • Page 10 Installation 2.4 Linking in the library file SIMATIC 3964R protocol for Windows 9x/XP/7 Installation Manual, 01/2013, J31069-D0131-U001-A2-7218...
  • Page 11: Parameter Assignment

    Parameter assignment With the help of the configuration program, you can make parameter settings for the serial interfaces (COM ports). After installation of the driver a new entry "3964R/Lauf" is created in the Control Panel. Follow the steps below to make settings for the freely selectable interfaces and protocols: 1.
  • Page 12 Parameter assignment 3. Enter the name of the interface in the "Name" input box. The name must match the name specified in the device manager for the connected hardware (integrated serial interface or external adapter, e.g. USB). 4. Select the "Apply configuration immediately" check box to adopt all the data immediately in the configuration.
  • Page 13: Programming Interface

    Programming interface Functions of the serial interface Note You will find all the error messages listed in this section in the section "Error and status messages (Page 23)". ComOpen comInt (LPCSTR com_name, ComOpen int read_number, int write_number, HWND hwnd) This function is used to open an interface and to prepare for data transfer. It must be called before all other functions.
  • Page 14 Programming interface 4.1 Functions of the serial interface Notes ● If "COM_OPEN_STD_PUF" is transferred as the buffer size, the buffer size from the parameter assignment dialog is adopted. ● The returned handle must be transferred as a parameter with all further calls. ●...
  • Page 15 Programming interface 4.1 Functions of the serial interface ComWrite comInt (int com_handle, ComWrite void *write_data, int write_number, long options) This function is used to send an asynchronous send job. Parameter com_handle interface handle from ComOpen write_data Pointer to the send buffer of the caller write_number Length of the send buffer options...
  • Page 16 Programming interface 4.1 Functions of the serial interface Parameter com_handle interface handle from ComOpen com_event Event to be enabled possible functions: COM_READ_EVENT, COM_WRITE_EVENT (both ORed) user_id ID to be assigned by the user Message number to be assigned by the user Return value Screen with the current events prior to the call Notes...
  • Page 17 Programming interface 4.1 Functions of the serial interface ComGetNotify comInt (WPARAM wParam, ComGetNotify LPARAM lParam, int *user_id, int *event_ptr, int *state_ptr, init *handle_ptr) Messages that are sent to the application at the end of communications operations (if they have been enabled with "COMEnableEvent") contain further information about the triggering operation.
  • Page 18 Programming interface 4.1 Functions of the serial interface ComSetNotification comInt (comHandle_t com_handle, ComSetNotification comNotifCall p_callback, int userID) With this function, a callback routine can be specified that is called if events occur in the driver (e.g. received frame). If the "NULL" is transferred as the parameter, the routine is disabled.
  • Page 19 Programming interface 4.1 Functions of the serial interface ComGetWriteState comInt (int com_handle) ComGetWriteState This function is used to query the current status of the send routine and then to reset it. Parameter com_handle interface handle from ComOpen Return value COM_ST_FREE Send routine is not busy COM_ST_BUSY A frame is currently being sent...
  • Page 20 Programming interface 4.1 Functions of the serial interface ComGetVersion comInt (char *ver_string) ComGetVersion This function returns the version number of the DLL being used and an expanded version string (if required). Parameter ver_string Buffer for the expanded version string No expanded version information if "NULL". Return value Version number (version x.y →...
  • Page 21 Programming interface 4.1 Functions of the serial interface Return value Notes The transferred buffer should have a minimum size of 500 characters. ComReadConfig comInt (LPCSTR devName, ComReadConfig devConfig_p conf) This function reads the configuration data for a specified port from the registry and returns it in an edited form.
  • Page 22 Programming interface 4.1 Functions of the serial interface ComWriteConfig comInt (LPCSTR devName, ComWriteConfig devConfig_p conf, BOOL force) This function writes the configuration data for a specified port to the registry. The port does not need to be opened. Parameter devName Interface name as string possible values: "COM1 ...
  • Page 23: Error And Status Messages

    Programming interface 4.2 Error and status messages Error and status messages Messages returned by the functions described in the previous section can be divided into three classes: ● Positive status messages ● Status error messages ● System error messages The following error codes are defined in the header file "3964r.h". Positive status messages Used by: •...
  • Page 24 Programming interface 4.2 Error and status messages Status error messages Used by: • ComReadState • ComWriteState These messages signal status errors that occurred during the transfer of frames. They mostly relate to the interface or local system resources. Each message can include several individual messages. This is achieved by ORing the individual error messages.
  • Page 25 Programming interface 4.2 Error and status messages System error messages Used by: • ComOpen • ComRead • ComWrite • ComGetNotify • ComClose Messages of this class show that function calls have failed and usually mean a serious error in the system and/or in the configuration settings. This protocol implementation uses only a subset of the error messages listed in the header file.
  • Page 26: Linking The Driver Into Your Own Programs

    Programming interface 4.3 Linking the driver into your own programs Linking the driver into your own programs To use this programming interface for the 3964R protocol in your own programs, note the following two steps: ● The "3964R.H" header file must be linked into your own source code using the "#include" preprocessor command.

Table of Contents