LLRP helpers
Certain operations are done quite often in LLRP. For instance, it is often necessary to delete all ROSpecs and AccessSpecs which may be outstanding from a previous session. This module has helper routines to make that simple.
In general, if not 'link' related, you can factor commonly useful LLRP stuff into this module. At least, until this module needs refactoring.
decode_gpi_state ($node)This function decodes the GPI state froma GET_READER_CONFIG_RESPONSE document and returns the GPI values as an array (gpi1, gpi2, gpi3, gpi4) of zero and one values or, if called in a scalar context, the numerical equivalent (gpi1 = lsb, gpi4=msb)
delete_rospecs ($sock, %params)This function deletes all ROSpecs from the reader, or if spec_ids are
provided at the end of the argument list, it deletes the ones you ask it to.
decode_access_specs ($sock, @spec_ids)This function deletes all AccessSpecs from the reader, or if spec_ids are
provided at the end of the argument list, it deletes the ones you ask it to.
are_identical (@docs)This function attempts to normalize and compare a list of LLRP-XML DOM trees.
It returns false on the first match failure, or true if all trees appear identical.
compare_subtrees (@docs)This function attempts to normalize and compare subtrees within a list of LLRP-XML DOM trees, based upon an XPath.
It returns false on the first match failure, or true if all trees appear identical.
factory_default ($sock)This function returns the reader to ``factory default state,'' as defined
by LLRP using a SET_READER_CONFIG message.
It returns false on the first match failure, or true if all trees appear identical.
Additional parameters beyond $sock are passed through to the transact routine.
cleanup_all ($sock)This routine restores the reader to factory default state, deletes
any ROSpecs and/or AccessSpecs.
cleanup_and_die ($sock, $msg, %params)This routine restores the reader to factory default state, deletes
any ROSpecs and/or AccessSpecs, disconnects and dies with $msg.
John R. Hogerhuis Kunal Singh Joel Peshkin
None
EPCGlobal LLRP Specification
Copyright 2007, 2008 Impinj, Inc.
Licensed under the Apache License, Version 2.0 (the ``License''); you may not use this file except in compliance with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an ``AS IS'' BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.