Intermec IF2 Basic Reader Interface Programmer's Reference Manual (BRI version - Page 40

TAGTYPE, TIME, Data Conditions

Page 40 highlights

Chapter 3 - Understanding BRI Programming Elements The length parameter can range from zero to the length of the data space minus the address. The length parameter is required. When a STRING data type is written to a tag, only the requested characters are written. The NULL character is not stored in tag memory at the end of a STRING data type. For example: STRING(10,5)="HELLO" The data stored in tag memory starting at address 10 is H, E, L, L, O for a total of five characters. When STRING data types are specified in READ commands, the data returned is equal to length specified in the READ command. Unprintable characters are returned in a HEX format \xYY where YY is the data representing the hex value. When writing string fields, you can enter binary values using the \xxx notation. However, do not try to use this method to enter a NULL character into a string field. BRI returns ERR if you enter \000 into a string field. TAGTYPE TAGTYPE is a string representation of the type of tag being returned for the current tag operation. Possible values for TAGTYPE consist of all of the supported TAGTYPE attribute values. This data field cannot be used in a WHERE clause. For more information, see "TAGTYPE" on page 96. TIME TIME is a positive integer data type associated with the tag and indicates the time when the tag was primarily located. Time is a read-only data field, and cannot be used in a WHERE clause. TIME is a reserved keyword which, when specified in a READ or WRITE command, returns a time value indicating when the READ command was completed. The time value is returned as an integer value with 1 millisecond (ms) resolution. The time base value returned is reset to zero when a reader is first powered up. Readers do not provide real time clock capabilities, so time is relative to the reader powering up or being reset. The range of the TIME parameter is returned as the number of milliseconds since power-up of the reader and ranges from 0 to 4294967295 ms. This represents approximately 49.7 days before the time rolls over if the reader is on continuously and the BRI session is maintained. The TIME information is returned as an integer in the following format: 1234 The value 1234 represents a time of 1.234 seconds. Data Conditions Data conditions are used to select tags that have data matching a defined constant value. The data conditions can be as simple or complex as necessary to uniquely identify a specific group of tags to operate on. 28 Basic Reader Interface Programmer Reference Manual

  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
  • 23
  • 24
  • 25
  • 26
  • 27
  • 28
  • 29
  • 30
  • 31
  • 32
  • 33
  • 34
  • 35
  • 36
  • 37
  • 38
  • 39
  • 40
  • 41
  • 42
  • 43
  • 44
  • 45
  • 46
  • 47
  • 48
  • 49
  • 50
  • 51
  • 52
  • 53
  • 54
  • 55
  • 56
  • 57
  • 58
  • 59
  • 60
  • 61
  • 62
  • 63
  • 64
  • 65
  • 66
  • 67
  • 68
  • 69
  • 70
  • 71
  • 72
  • 73
  • 74
  • 75
  • 76
  • 77
  • 78
  • 79
  • 80
  • 81
  • 82
  • 83
  • 84
  • 85
  • 86
  • 87
  • 88
  • 89
  • 90
  • 91
  • 92
  • 93
  • 94
  • 95
  • 96
  • 97
  • 98
  • 99
  • 100
  • 101
  • 102
  • 103
  • 104
  • 105
  • 106
  • 107
  • 108
  • 109
  • 110
  • 111
  • 112
  • 113
  • 114
  • 115
  • 116
  • 117
  • 118
  • 119
  • 120
  • 121
  • 122
  • 123
  • 124
  • 125
  • 126
  • 127
  • 128
  • 129
  • 130
  • 131
  • 132
  • 133
  • 134
  • 135
  • 136
  • 137
  • 138
  • 139
  • 140
  • 141
  • 142
  • 143
  • 144
  • 145
  • 146

Chapter 3 — Understanding BRI Programming Elements
28
Basic Reader Interface Programmer Reference Manual
The
length
parameter can range from zero to the length of the data space minus the
address. The
length
parameter is required.
When a STRING data type is written to a tag, only the requested characters are
written. The NULL character is not stored in tag memory at the end of a STRING
data type. For example:
STRING(10,5)=”HELLO”
The data stored in tag memory starting at address 10 is
H
,
E
,
L
,
L
,
O
for a total of five
characters.
When STRING data types are specified in READ commands, the data returned is
equal to length specified in the READ command. Unprintable characters are
returned in a HEX format \xYY where YY is the data representing the hex value.
When writing string fields, you can enter binary values using the
\
xxx
notation.
However, do not try to use this method to enter a NULL character into a string field.
BRI returns ERR if you enter
\000
into a string field.
TAGTYPE
TAGTYPE is a string representation of the type of tag being returned for the current
tag operation. Possible values for TAGTYPE consist of all of the supported
TAGTYPE attribute values. This data field cannot be used in a WHERE clause. For
more information, see
“TAGTYPE” on page 96
.
TIME
TIME is a positive integer data type associated with the tag and indicates the time
when the tag was primarily located. Time is a read-only data field, and cannot be
used in a WHERE clause.
TIME is a reserved keyword which, when specified in a READ or WRITE command,
returns a time value indicating when the READ command was completed. The time
value is returned as an integer value with 1 millisecond (ms) resolution.
The time base value returned is reset to zero when a reader is first powered up.
Readers do not provide real time clock capabilities, so time is relative to the reader
powering up or being reset. The range of the TIME parameter is returned as the
number of milliseconds since power-up of the reader and ranges from 0 to
4294967295 ms. This represents approximately 49.7 days before the time rolls over
if the reader is on continuously and the BRI session is maintained.
The TIME information is returned as an integer in the following format:
1234
The value 1234 represents a time of 1.234 seconds.
Data Conditions
Data conditions are used to select tags that have data matching a defined constant
value. The data conditions can be as simple or complex as necessary to uniquely
identify a specific group of tags to operate on.