Siemens SIMATIC RF610M Function Manual Download Page 10 | Manualshive

Page: 10 / 80

background image

RFID Reader Interface User's Guide

2.2 How Do I Use the Reader Interface?

Mobile Readers

10

Function Manual, 12/2010, J31069-D0198-U001-A2-7618

2.2

How Do I Use the Reader Interface?

So far, so good. We have learned that there is an easy way to access the RFID features of a

handheld device. But how do we do this?

2.2.1

Tools Needed

First, we will create a small sample application that only reads tags.
What tools will you need?
The interface is a .Net CompactFramework 2.0 SP2 assembly. Logically this requires a

derivate of the Microsoft Visual Studio 2005 as its starting point. Remember that the Express

versions will not be sufficient because they do not allow the installation of additional device

packages. You will need at least the Standard or Professional version of Visual Studio 2005.
Next comes the installation of the software development kit (SDK) from PSION Teklogix.

This software kit is available from developer resources on the PSION TEKLOGIX website

) after registration.

These are all the development tools you need to get started. Although you can now create

applications targeting a handheld device such as the RF610M, you will also need to transfer

the developed software to the handheld device. This means that Microsoft ActiveSync must

also be installed.
Moreover, in order to utilize the RFID features you will also need to reference the RFID

Reader Interface assembly within your applications. This assembly is available on your

handheld device. You can retrieve the file

Siemens.Simatic.RfReaderApi.dll

via

ActiveSync from the handheld device (\Flash Disk\SIMATIC

xxx\Support\RFID_AP\RFID_API.ZIP) and store it to reference the assembly.
You should now be able to create, deploy and run your custom applications.
The table below summarizes the required components for the Reader Interface Version V1.3

and higher.
Be aware that the handheld device must also support at least Reader Interface Version V1.3.

The Reader Interface Version will be displayed as "API Version" with the handheld device

application via the menu "Tools -> Reader Status".

Tool / Component

Description

Vendor

Microsoft Visual Studio 2005
(at least Standard edition)
(at least CompactFramework 2.0 SP2)

The basic development environment

Microsoft

PSION TEKLOGIX Mobile Devices Software

Development Kit (SDK)

Enables creation of applications for Windows CE

devices

PSION

Microsoft ActiveSync

Enables communication between your

development PC and a handheld device

Microsoft

Siemens.Simatic.RfReaderApi.dll

RFIDDriver.dll
PsionTeklogicNet.dll
Siemens.Simatic.RfReaderApi.dll.config

The RFID Reader Interface assembly
Even if this assembly is enough to compile, don’t

forget to provide RFIDDriver.dll,

PsionTeklogicNet.dll and

Siemens.Simatic.RfReaderApi.dll.config for

executing your own application.

All of these components

are provided on the

device’s flash memory

within a compressed

archive.

Moreover, the sample code of the small demo application developed within the following

chapters is also available on the device’s flash disk.

«
...
8
9
10
11
12
...
»

Summary of Contents for SIMATIC RF610M

Page 1: ...Answers for industry SIMATIC Ident RFID SYSTEMS Mobile Readers Function Manual 12 2010 Valid for the following products SIMATIC RF310M SIMATIC RF610M SIMATIC RF680M ...

Page 2: ......

Page 3: ...Interface User s Guide 2 RFID Reader Interface Reference 3 SIMATIC Ident RFID Systems Mobile Readers Function Manual 12 2010 J31069 D0198 U001 A2 7618 Valid for the following products SIMATIC RF310M SIMATIC RF610M SIMATIC RF680M ...

Page 4: ...umentation for the specific task in particular its warning notices and safety instructions Qualified personnel are those who based on their training and experience are capable of identifying risks and avoiding potential hazards when working with these products systems Proper use of Siemens products Note the following WARNING Siemens products may only be used for the applications described in the c...

Page 5: ...ake me up before you go 25 2 3 4 We are started What to make out of it 29 2 3 5 Jerry s tag monitoring scenario revisited 30 2 3 6 I m all ears 31 2 3 7 Not without my approval 34 2 3 8 Make it fun Working keys 36 2 3 9 Summary 39 3 RFID Reader Interface Reference 41 3 1 The Interface 41 3 2 RfReaderApi Current 42 3 3 RfReaderApiException 42 3 4 IRfReaderApi 43 3 4 1 Version 43 3 4 2 StartReader 4...

Page 6: ...ag 61 3 4 20 LockEPCGen2Tag 62 3 4 21 LockIsoTag 65 3 4 22 SetTrigger 66 3 4 23 SubscribeForNotifications 67 3 4 24 UnsubscribeForNotifications 68 3 4 25 SetTagEvents 69 3 4 26 SubscribeForAlarms 70 3 4 27 UnsubscribeForAlarms 71 3 4 28 GetConfigParameter 72 3 4 29 TagEventNotification 74 3 4 30 Alarms 76 3 4 31 Information 77 3 5 References 78 ...

Page 7: ...itself are used You have to directly contact the device vendor PSION in order to get software and support for these features You get an overview regarding topics such as WLAN and barcode by consulting the handheld device manual Detailed developer information however is still to be retrieved from the device vendor PSION directly This version of the RFID Reader Interface will also be integrated in t...

Page 8: ...Introduction Mobile Readers 8 Function Manual 12 2010 J31069 D0198 U001 A2 7618 ...

Page 9: ... information on the special requirements or the business processes of end customers Since a single application can almost never meet every need of every customer another approach is used Instead of inflating the application with a large number of possible options while still missing others only the basic features are supported To facilitate the end user s needs these basic functions are provided b...

Page 10: ...your applications This assembly is available on your handheld device You can retrieve the file Siemens Simatic RfReaderApi dll via ActiveSync from the handheld device Flash Disk SIMATIC xxx Support RFID_AP RFID_API ZIP and store it to reference the assembly You should now be able to create deploy and run your custom applications The table below summarizes the required components for the Reader Int...

Page 11: ... project of type Visual C Smart Device Windows CE 5 0 DeviceApplication since handheld devices currently run under Windows CE 5 0 Figure 2 2 Type of application to create for a handheld device You will need menu items to start and stop the reader and to trigger a read command Moreover you will provide a textbox to display the results This gives you a simple GUI as shown in the following figure Fig...

Page 12: ...tions First you will need a parameter to provide initialization data This is done by creating an object of type RfReaderInitData The only parameters necessary is the reader type and the reader mode which we set to standalone for now For all other members of RfReaderInitData we accept the defaults The StartReader function also offers other options that allow you to specify other instance names or I...

Page 13: ... instance or initiate the creation of a new instance StartReader connects to an existing reader service or creates a new reader service RfReaderApi Current StartReader initData catch RfReaderApiException rfidException Something went wrong while starting the reader More information is available by inspecting the RfReaderApiException s members ResultCode Error Cause and Description Stopping a runnin...

Page 14: ... has to comply with the following prototype that defines the special RfAlarmArgs parameters public void AlarmHandler object sender RfAlarmArgs alarmArgs Before starting the reader we add the alarm handler RfReaderApi Current Alarms new RfAlarmHandler this AlarmHandler Once installed our AlarmHandler function gives us a chance to notice a successful startup or restart by catching the Reconfiguratio...

Page 15: ...ID reader interface for a handheld device with a default name RfReaderInitData initData new RfReaderInitData Initialize the appropriate reader type RF680M RF610M RF310M and reader mode initData Type RF680M initData Mode RfReaderInitData ReaderMode Standalone With RfReaderApi Current we address the current RFID reader interface instance or initiate the creation of a new instance StartReader connect...

Page 16: ...p of the application Now we can access RFID reader WriteInformationLine INFO Initial reconfiguration private void WriteInformationLine string message WriteInformation message r n private void WriteInformation string message Add the information to the existing text this textBoxInfo Text this textBoxInfo Text message this textBoxInfo SelectionStart this textBoxInfo Text Length this textBoxInfo Scrol...

Page 17: ...ARMV4I_Release as a target device Regardless of how you deploy your application ensure that all needed system components are located beneath your application This means you must provide the RFID Reader Interface assembly Siemens Simatic RfReaderApi dll and its configuration file Siemens Simatic RfReaderApi dll config You also must provide the following Psion specific files RFIDDriver dll PsionTekl...

Page 18: ...ate void menuItemReadIDs_Click object sender EventArgs e string tagIDs null try Request all tags that are currently within reach tagIDs RfReaderApi Current GetTagIDs catch RfReaderApiException rfidException Something went wrong while reading tags More information is available by inspecting the RfReaderApiException s members ResultCode Error Cause and Description WriteInformationLine string Format ...

Page 19: ...ted length Be sure to check for a null reference which is returned if no data could be read When you request additional data from EPC Gen2 tags the tag to be addressed must always be specified by giving its tag ID Only if a EPC Gen2 tag with a matching ID is detected will the operation succeed Reading additional tag data byte buffer null try Code for invoking a dialog and retrieving the data enter...

Page 20: ... be supplied together with the new ID and a password if needed and an instance of an object must be used that implements the IRfReaderApi which is always available via RfReaderApi Current Figure 2 6 Write TagID Below is the code for accomplishing this writing a new tag ID to a tag try Code for invoking a dialog and retrieving the data entered left out for brevity check sample code for details Requ...

Page 21: ...ase make sure you always place the following files beneath your application so that it is able to run Siemens Simatic RfReaderApi dll Siemens Simatic RfReaderApi dll config RFIDDriver dll PsionTeklogicNet dll With these simple guidelines and the description of the RFID Reader Interface s member functions you should be able to implement your own business logic for a standalone RFID client applicati...

Page 22: ...g into SIMATIC RF MANAGER configured environments Please bear in mind that both the communication and synchronization among devices and usage of configuration data relies on a working RF MANAGER infrastructure More precisely we are talking of integrating into a SIMATIC RF MANAGER system only Consider an integration scenario as given in the figure below Ethernet WLAN WLAN 2IILFH 5 0 5 5 DWH 5 5 DWH...

Page 23: ...y a parcel service This second parcel however did not pass the gates but arrived directly at the office counter There Molly the soul of the office used another RFxxxM device to scan the ID of the delivered goods Contrary to Jerry s scanning the data she acquired was not only used for monitoring but as additional input to the system just as it would be a third gate However Molly s desk is crowded a...

Page 24: ...nitData catch RfReaderApiException rfidException Something went wrong while starting the reader More information is available by inspecting the RfReaderApiException s members ResultCode Error Cause and Description As a result the RFID reader interface starts the underlying reader service in such a way that it waits for a connection with an RF MANAGER runtime As long as no connection to an RF MANAG...

Page 25: ...e and disables access For you as a client this means you should disable functions that use the interface until reconfiguration has finished After the reconfiguration of the system has finished the RFID reader interface changes its state to valid and a second notification containing either the changed configuration items as parameters or just Reconfiguraiton Nochange is sent t2 t4 Now that is the t...

Page 26: ... are again without a trigger to start working The good news is that the RFID reader interface knows that a reader service was already running before and initiates a Reconfiguration Reconnect notification So you as a client can react and reinitialize your application And again you can rely on always receiving an event during the RFID reader interface startup Back to practice So much for the theory ...

Page 27: ...R runtime Figure 2 10 RFID Network Settings When starting up our application on the RFxxxM and the RF MANAGER runtime on the host PC our AlarmHandler is called three times Fine Wait Did you say three times Ok when the RF MANAGER configuration is transmitted to the RFxxxM device there will be the start reconfiguration event which is signaled by the Boolean RfAlarmArgs member IsConfigStart as well A...

Page 28: ...ems null Reconfiguration has finished if alarmArgs InfoItems 0 Name Reconfiguration alarmArgs InfoItems 0 Value Initial This is the very first startup of the application where no configuration data is available else if alarmArgs InfoItems 0 Name Reconfiguration alarmArgs InfoItems 0 Value Reconnect The reader service was already running and we only reconnected reinitialize e g by rereading configu...

Page 29: ...lues Description MobileOperatingModeEnabled This parameter tells you if the device is working in remote mode FALSE or mobile mode TRUE Whenever this parameter is false you may only monitor tag events Only if this parameter is true filtering is enabled and tag events might be changed and can be fed in again with the SetTagEvents API function EditTagEnable This parameter could be used by your applic...

Page 30: ...on SetTrigger to change the state of the application trigger As we learned from the configuration parameter settings this trigger acts as a on off button and we take that into account by toggling the trigger s state with every invocation of the menu item that is what our internal Boolean flag fAppTriggerState is for private void menuItemAppTrigger_Click object sender EventArgs e private void menuI...

Page 31: ...r RfNotificationArgs notificationArgs if null notificationArgs TagEvents foreach RfTagEvent tagEvent in notificationArgs TagEvents this mainFormRef WriteInformationLine Tag Event tagEvent EventTimeUTC this mainFormRef WriteInformationLine ID tagEvent TagID this mainFormRef WriteInformationLine Type tagEvent EventType else this mainFormRef WriteInformationLine Tag Event No tags Let s give it a try ...

Page 32: ... fSubscriptionActive false As you can see by looking at the code snippets above there is an SubscribeForNotifications member within the RFID reader interface It needs two parameter the first one specifying the data source and the second whether we only want to monitor or to filter the tag event data As we are still on the way to let Jerry monitor the tags the second paramter is set to false For th...

Page 33: ...is the safest option Running the application again now gives us what we wanted Whenever we are not subscribed toggling the trigger will show tag events only at the RF MANAGER runtime As soon as we subscribe tag events are also shown within our test application directly on the RFxxxM device After unsubscribing tag events are still shown within the RF MANAGER runtime but no longer within our test ap...

Page 34: ...in mind subscribing and unsubscribing for our Molly scenario is just a duplicate of what we already have whereas only the filtering parameter is changed private void menuItemSubscribeFilter_Click object sender EventArgs e Subscribe for all data sources with filtering bool fResult RfReaderApi Current SubscribeForNotifications RfReaderApi NC_ALL true In order to make it easier for us to test our cod...

Page 35: ... RfReaderApi Current SetTagEvents RfReaderApi NC_RFID this bufferedTagEvents ToArray Notice that the second parameter for the SetTagEvents function is just a list of tag events In the code above simply all buffered tag event items are passed on to the function The only other information needed is the name of the data source within our reader service that will receive the tag events Again we can sa...

Page 36: ...de this KeyDown new System Windows Forms KeyEventHandler this KeyDownHandler this KeyUp new System Windows Forms KeyUpHandler this KeyDownHandler However this code will only work as long as the main form has the focus Whenever a control residing on this main form has the focus we will not get the key events Therefore our demo application uses a simply intercept all controls mechanism starting at t...

Page 37: ...m on top of it What if you do want to distinguish among all of those scan keys It is not always desireable using the same function for all keys But if they all send the same keycode it is impossible Luckily PSION provides a way to change this There is an interface assembly PsionTeklogixNet dll that offers you a PsionTeklogix Keyboard namespace containing a KeyRemapper class This class allows redef...

Page 38: ...ey VK_F26 pistol grip key pressed break case int PsionTeklogix Keyboard VirtualKey VK_F27 left scan key pressed break case int PsionTeklogix Keyboard VirtualKey VK_F28 top scan key pressed break Now we know which key was pressed and can implement a different behavior for each of them if wanted The key mapping stays active until a cold reset a redefinition or if we manually remove the key mapping a...

Page 39: ...sics of monitoring and filtering of tag events You know how to eliminate unwanted data or even create data artificially You learned about the possibilities to find out what is configured under the hood by exploring the configuration parameters and about the considerations necessary when starting up or shutting down This manual can in no way cover all aspects and details of creating client applicat...

Page 40: ...RFID Reader Interface User s Guide 2 3 Extending the Reach Mobile Readers 40 Function Manual 12 2010 J31069 D0198 U001 A2 7618 ...

Page 41: ...te an instance of the RFID Reader Interface Starting with RFID Reader Interface V1 1 notifications and alarms are supported which led to some new helper classes Supported in RFID reader interface since v1 0 RfReaderApiException Helper class to wrap exception information RfReaderInitData Helper class for initialization purposes IRfReaderApi The interface class RfReaderApi Creation of an RFID Reader...

Page 42: ...calling the underlying reader service or the physical RFID reader device these exceptions are wrapped within an instance of the RfReaderApiException class However this does not prevent general exceptions such as out of memory or out of range to occur either So be prepared to catch those kind of exceptions as well This class provides additional information about the source or cause of an exception ...

Page 43: ...pported by a certain version of the RFID Reader Interface When checking for function compatibility using the major and the minor version is sufficient A sample version number is V01 01 00 00_01 12 00 01 Version information Supported in RFID Reader Interface since V1 0 3 4 2 StartReader StartReader initData RfReaderInitData void Parameters initData Information about how to configure the reader and ...

Page 44: ...r future use 1 since Reader interface V1 2 2 since Reader Interface V1 3 Return value s None Exceptions ArgumentOutOfRangeException Validation of the contents of initData failed Check the values provided RfReaderApiException Error while starting the communication with the reader Check the Error member for more information Note Initiates the communication to an underlying reader service application...

Page 45: ...e values The parameter names are used as keys Exceptions RfReaderApiException Error while communicating with the reader service Check the Error member for more information Note Returns information about the state of the reader as a list of name values within a hash table Currently supported entries are ReaderModel Returns the current model Valid values are RF610 EU for the European version of RF61...

Page 46: ...formation Supported in RFID Reader Interface since V1 0 3 4 5 AirProtocol AirProtocol string get set Property A string identifying the current or desired air protocol Exceptions RfReaderApiException Error while communicating with the reader service Check the Error member for more information Note Sets a new air protocol type or returns the air protocol type currently in use Valid protocol types ar...

Page 47: ...alue s None Exceptions RfReaderApiException Error while communicating with the reader service Check the Error member for more information Note This method is an alternate choice instead of the AirProtocol property described earlier In contrast to the property it allows an additional parameter initialQ to be specified for the EPC Class1 Gen2 protocol Version information Supported in RFID Reader Int...

Page 48: ...tAntennaPower GetAntennaPower uint Parameters None Return value s This functions returns the current antanna power Exceptions RfReaderApiException Error while starting the communication with the reader Check the Error member for more information Note The handheld devices have limited settings for the antenna power Valid ranges for the RF680M are 10 25 50 100 200 300 400 and 500 mW Due to physical ...

Page 49: ...exchange rate between reader and tag The possible modulation scheme depends on the used radio profile ETSI or FCC Valid ranges for the RF680M are FCC 2 DSB ASK 40kHz FM0 40kHz 4 DSB ASK 160kHz FM0 400kHz 6 PR ASK 40kHz M4 250kHz 8 PR ASK 40kHz M2 250kHz ETSI 2 DSB ASK 40kHz FM0 40kHz 5 DSB ASK 40kHz M2 160kHz 6 PR ASK 40kHz M4 250kHz 7 PR ASK 40kHz M4 300kHz Version information Supported in RFID R...

Page 50: ...F680M are FCC 2 DSB ASK 40kHz FM0 40kHz 4 DSB ASK 160kHz FM0 400kHz 6 PR ASK 40kHz M4 250kHz 8 PR ASK 40kHz M2 250kHz ETSI 2 DSB ASK 40kHz FM0 40kHz 5 DSB ASK 40kHz M2 160kHz 6 PR ASK 40kHz M4 250kHz 7 PR ASK 40kHz M4 300kHz Version information Supported in RFID Reader Interface since V1 3 3 4 11 SetChannelList SetChannelList channelList string void Parameters channelList Set used ETSI channels Co...

Page 51: ...ID Reader Interface since V1 3 3 4 12 GetChannelList GetChannelList string Parameters None Return value s This function returns the used ETSI channels as a coma separated list Valid channels are 103 106 109 112 Exceptions RfReaderApiException Error while starting the communication with the reader Check the Error member for more information Note ETSI channels are only relevant for reader with ETSI ...

Page 52: ...s None Exceptions RfReaderApiException Error while communicating with the reader service Check the Error member for more information Note This method writes a new tag ID to an existing tag A valid tag ID must be specified for a tag currently within the field before you can write a new ID or if no tag ID is specified the first tag within the field will be written All tag IDs are given in a plain he...

Page 53: ...he tag IDs are returned in a plain hexadecimal encoded string i e each byte is represented by a two letter hexadecimal number Exceptions RfReaderApiException Error while communicating with the reader service Check the Error member for more information Note This method executes a read operation on the reader and returns the IDs of all the recognized tags as an array of strings Version information S...

Page 54: ...re 0 Reserved 1 EPC 2 TID and 3 USER MEM Valid values for the air protocol RF300 are 0 Memory Valid values for the air protocol ISO15693 are 0 Memory startAddress The base address within the memory bank from which to read data Base addresses are specified in bytes dataLength The length in bytes of the data to be read Password An access password if needed The ISO18000 6B protocol e g does not suppo...

Page 55: ...5 Note Reads tag data whereby both internal and user specific areas may be accessed A valid tag ID must be specified for a tag currently within the field before you can read data or if no tag ID is specified the first tag within the field will be read Version information Supported in RFID Reader Interface since V1 0 ...

Page 56: ...Reserved 1 EPC 2 TID and 3 USER MEM Valid values for the air protocol RF300 are 0 Memory Valid values for the air protocol ISO15693 are 0 Memory startAddress The base address within the memory bank to which data are to be written Base addresses are specified in bytes dataLength The length in bytes of the data to be written Password An access password if needed The ISO18000 6B e g protocol does not...

Page 57: ...er specific areas may be accessed RF310 specific banks UID and CONFIG Data are not writeable and will return with error exception A valid tag ID must be specified for a tag currently within the field before you can write data or if no tag ID is specified the first tag within the field will be written Version information Supported in RFID Reader Interface since V1 0 ...

Page 58: ...ons RfReaderApiException Error while communicating with the reader service Check the Error member for more information Note A valid tag ID must be specified for a tag currently within the field before you can get the status data or if no tag ID is specified the first tag within the field will be read Returns information about the state of the tag as a list of named values within a hash table Curre...

Page 59: ... FF88 FF8B Block 3 FF8C FF8F Block 4 FF90 FF93 Block 5 7 reserviert ASICVersion Returns the Version string of the tag ASIC BlockSize Returns the BlockSize of the Transponder NumberOfBlocks Returns the number of Blocks of the Transponder Only valid for ISO15693 Tags TagID The ID of a tag Limitations This function is only valid when the protocol type is set to RF300 or ISO15693 Invoking this functio...

Page 60: ...n Base addresses are specified in bytes dataLength The length in bytes of the data to be written Password An access password if needed If none needed use an empty string A password is a hexadecimal encoded string of up to eight characters initData The data to be initialized Return value s None Exceptions RfReaderApiException Error while communicating with the reader service Check the Error member ...

Page 61: ...y string A password is a hexadecimal encoded string of up to eight characters Return value s None Exceptions RfReaderApiException Error while communicating with the reader service Check the Error member for more information Note Kills a tag with the given ID i e the tag can no longer be used Limitations This function is only valid when the protocol type is set to EPCC1GEN2 Invoking this function w...

Page 62: ...If the length of the lockAction is less than 10 characters e g 111 the value defines the MSB i e it is interpreted as 11 1000 0000 epcGen2LockMask The lock mask is a binary string as defined in the EPC Radio Frequency Identity Protocols Standard Specification The mask is a value ranging from 000 to 11 1111 1111 If the length of the lockMask is less than 10 characters e g 11 the value defines the M...

Page 63: ...s a password lock for read write The flag w defines a password lock for write read access allowed The p flag defines a permanent lock The following tables list possible combinations of r w and w flags with p flags and their combined meanings for one memory bank The tag is in the open state if it is identified and in the secured state if its access password is verified w p Description 0 0 Associate...

Page 64: ...an be read and write accessed from the secured state but not from the open state The Access Password of the tag must be known before the kill password can be read or changed EPC Memory Bank Can be write accessed from the secured state but not from the open state The Access Password must be known before a new ID can be written to the tag For detailed information about the epcGen2LockAction and epcG...

Page 65: ... of 0 to 255 iso6BTagDataLength The length in bytes of the ISO tag memory block that is to be locked Return value s None Exceptions RfReaderApiException Error while communicating with the reader service Check the Error member for more information Note Locks an ISO tag against further write accesses For detailed information about the iso6BTagAddress and iso6BTagDataLength see the ISO Standard 18000...

Page 66: ...evice Application Specifies a virtual trigger that is only available within the software configured with RF MANAGER triggerState This parameter sets the level state of a trigger Return value s None Exceptions RfReaderApiException Error while communicating with the reader service Check the Error member for more information Note This function allows setting or resetting a trigger value which in turn...

Page 67: ...itoring data i e isFilter is false or intercepts data before it is passed on to other clients Return value s A boolean value telling whether the subscription succeeded true or failed false Exceptions RfReaderApiException Error while communicating with the reader service Check the Error member for more information Note This function registers for asynchronous notifications of tag events Users have ...

Page 68: ... all configured data sources within a project Return value s None Exceptions RfReaderApiException Error while communicating with the reader service Check the Error member for more information Note This function stops notifications about tag events via the TagEventNotification event of the reader interface The given notification channel name specifies which notification to terminate An empty string...

Page 69: ...ents A list of all tag events that are to be created Return value s None Exceptions RfReaderApiException Error while communicating with the reader service Check the Error member for more information Note This function forwards a list of tag events to the underlying reader service The function will only succeed if clients previously subscribed as a filtering client isFilter true Unless filtering is...

Page 70: ... communicating with the reader service Check the Error member for more information Note This function registers for asynchronous notifications of RFID alarms Users have to either specify the name of the alarm channel which depends on the underlying configuration or use an empty string or ALL in order to subscribe to all available alarm channels Notifications from the underlying reader service are ...

Page 71: ...h the reader service Check the Error member for more information Note This function unregisters for asynchronous notifications of RFID alarms Users have to either specify the name of the alarm channel which depends on the underlying configuration or use an empty string or ALL in order to subscribe to all available alarm Limitations RF MANAGER mode only If there is no configuration data available o...

Page 72: ... RfInfoItem structure contains both the name and the value for a parameter Moreover it provides information to which feature set the configuration parameter applies Each parameter might apply to either RFID barcode or global configuration A parameter can apply to both RFID and barcode as well If a parameter with a given name is not available null is returned For known parameters their current valu...

Page 73: ...ime Info All of the following configuration parameters give information on how certain triggers are configured On the one hand they specify whether a configured trigger is only valid as long as the associated key is pressed KEY_PRESSED or whether the trigger implements an ON OFF toggling START_STOP This information is for information only Moreover depending on the configuration each trigger is ass...

Page 74: ...nt will not provide any data Whenever tag event data is available the notification arguments will contain an array of RfTagEvent objects Each RfTagEvent object provides information about the tag id the tag type i e barcode or RFID the event type e g glimpsed or observed the time an event occurred as well as information about the source of the data the notification channel which sends the events an...

Page 75: ...k The time when the event occurent in time ticks must correspond with EventTimeUTC x EventTrigger The name of the trigger which caused the event SourceName The name of the data source at which the tag event was created x NotifyTriggerName The notification channel trigger that caused the event to be sent NotifyChannelName The name of the notification channel which sends the event x ReaderNowUTC The...

Page 76: ...ever a system error or warning isissued it is contained in one or more RfAlarm structures in this member If the alarm is a notification only this member is null InfoItems RfInfoItem This member contains information about configuration changes or the current system state packed in RFInfoItem structures If the alarm signals an error or warning this member is null AlarmMessage string If an alarm occu...

Page 77: ...ions RfReaderApiException Error while communicating with the reader service Check the Error member for more information Note Provides categorized information about internal actions and status changes The arguments InformationArgs consist of Type InformationType Categorizes the information given Valid categories are Debug Info Notice Warning Error Critical Alert Emergency Message string The message...

Page 78: ...Translation TDT 1 0 Ratified Standard Specification January 21 2006 EPCglobal EPC Radio Frequency Identity Protocols Class 1 Generation 2 UHF RFID Protocol for Communications at 860 MHz 960 MHz Version 1 0 9 EPC Standard Specification December 2005 ISO Information Technology Radio Frequency Identification RFID for Item Management Part 6 Parameters for Air Interface Communications at 860 930 MHz IS...

Page 79: ......

Page 80: ... com automation subject to change J31069 D0198 U001 A2 7618 Siemens AG 2010 Siemens AG Industry Sector Sensors and Communication Postfach 48 48 90026 NÜRNBERG DEUTSCHLAND www siemens com ident Get more information ...

Reviews:

No comments

Related manuals for SIMATIC RF610M

QuickScan QBT21 Series

Brand: Datalogic Pages: 56

Brand: Kathrein Pages: 12

Brand: Hama Pages: 10

Brand: Honeywell Pages: 44

SCRIBA 150 White 2 GB

Brand: WOXTER Pages: 1

Brand: Datamars Pages: 30

Brand: SICK Pages: 40

Brand: MicroVision Pages: 2

Energy eReader Slim

Brand: ENERGY SISTEM Pages: 9

Energy eReader max

Brand: ENERGY SISTEM Pages: 15

Energy eReader Pro

Brand: ENERGY SISTEM Pages: 16

Brand: ENERGY SISTEM Pages: 20

Color Book 2074

Brand: ENERGY SISTEM Pages: 20

Brand: Square Pages: 5

Brand: PerkinElmer Pages: 2

Brand: Star Micronics Pages: 74

Brand: RIOTEC Pages: 5

Brand: GMW Pages: 46

Brands by name

0 1 2 3 4 5 6 7 8 9 A B C D E F G H I J K L M N O P Q R S T U V W X Y Z

Popular brands

Load more brands