Scott Gifford > RFID-EPC-0.002 > RFID::EPC::Tag

Download:
RFID-EPC-0.002.tar.gz

Dependencies

Annotate this POD

View/Report Bugs
Module Version: 0.002   Source  

NAME ^

RFID::EPC::Tag - An EPC tag.

SYNOPSIS ^

This class implements an EPC tag based on RFID::Tag. It allows tags to be created based on the fields of the various EPC tag types, and allows tag IDs to be parsed into their EPC components.

Generally, you'll get these objects returend from an EPC RFID reader:

    use RFID::Gumbo::Reader::TCP;
    my $reader = 
      RFID::Gumbo::Reader::TCP->new(PeerAddr => 10.20.30.40,
                                    PeerPort => 4001)
        or die "Couldn't create Blammo reader";
    my @tags = $reader->readtags();
    foreach my $tag (@tags)
    {
        if ($tag->type eq 'epc')
        {
            my $epc_type = $tag->get('epc_type');
            print "I see EPC tag ",$tag->id," of type $epc_type\n";
        }
    }

But you can also create a tag yourself, either with an ID string:

    my $tag = RFID::EPC::Tag->new(id => '357777777666666999999999');

or with the various componenets:

    my $tag =
      RFID::EPC::Tag->new(epc_serial => '999999999',
                          epc_manager => '7777777',
                          epc_class => '666666',
                          epc_type => 'GID-96');
    print "Tag ID is ",$tag->id,"\n";

DESCRIPTION ^

The parsing and tag creation in this module are based on the specifications in EPCGlobal's EPC Tag Data Standards Version 1.1 Rev.1.24, from April 1st 2004 (although it doesn't appear to be a joke...). See http://www.epcglobalinc.com/ for more information.

Constructor

new

Creates a new EPC tag object with the requested properties.

There are two general ways to create an EPC tag. First, you can pass in the tag ID number as a hex string with the parameter name id. Second, you can pass in various components specific to your Tag Type, including at least epc_type.

    my $tag1 = RFID::EPC::Tag->new(id => '357777777666666999999999');

    my $tag2 =
      RFID::EPC::Tag->new(epc_serial => '999999999',
                          epc_manager => '7777777',
                          epc_class => '666666',
                          epc_type => 'GID-96');

    print "The two tags are ",
          ($tag1->tagcmp($tag2)==0?"the same":"different"),
          "\n";

Methods

The following methods are supported. In addition, methods from RFID::Tag are inherited.

get

Get a property of this tag. In addition to the properties inherited from RFID::Tag, the following fields are supported. Note that whether a particular field is supported depends on the tag type. All fields are represented as hex strings.

epc_type

The EPC type of this tag.

epc_serial

The EPC serial number of this tag.

epc_manager

The EPC manager number of this tag.

epc_class

The EPC class of this tag.

epc_header

The EPC header bits for this tag.

epc_filter

The EPC filter for this tag.

epc_partition

The EPC partition number for this tag. This field determines the size of later fields; see the EPC specification for more information.

epc_item

The EPC item number for this tag.

epc_company

The EPC company number for this tag.

epc_asset_type

The EPC asset type number for this tag.

epc_location

The EPC location number for this tag.

epc_asset

The EPC asset number for this tag.

epc_unknown

For tags of unrecognized type, all of the bytes that could not be parsed.

type

This method returns the general type of this tag (always epc).

Tag Types

The EPC Tag Data Standards document defines many specific types of EPC tags. We do our best to parse these out, and return the appropriate fields. This isn't very well tested, since we don't have access to a large number of different types of EPC tags, but it tries to follow the spec, and should be easy to correct if any errors are found.

The purpose of the fields is beyond the scope of this document; we assume you know what the fields are for, and just want to know what names they are given in this code. Mostly that's because it took EPC 78 pages to describe exactly what the tag types are, and I don't want to repeat that here. Look up the EPC Tag Data Standards document referenced at the top of this documentation for more information.

GIAI-64

64-bit Global Individual Asset Identifier. Fields are epc_header, epc_filter, epc_company, epc_asset.

GIAI-96

96-bit Global Individual Asset Identifier. Fields are epc_header, epc_filter, epc_partition, epc_company, epc_asset.

GID-96

96-bit General Identifier. Fields are epc_header, epc_manager, epc_class, epc_serial.

GRAI-64

64-bit Global Returnable Asset Identifier. Fields are epc_header, epc_filter, epc_company, epc_asset_type, epc_serial.

GRAI-96

96-bit Global Returnable Asset Identifier. Fields are epc_header, epc_filter, epc_partition, epc_company, epc_asset_type, epc_serial.

SGLN-64

64-bit Serialized Global Location Number. Fields are epc_header, epc_filter, epc_company, epc_location, epc_serial.

SGLN-96

96-bit Serialized Global Location Number. Fields are epc_header, epc_filter, epc_partition, epc_company, epc_location, epc_serial.

SGTIN-64

64-bit Serialized Global Trade Identification Number. Fields are epc_header, epc_filter, epc_company, epc_item, epc_serial.

SGTIN-96

96-bit Serialized Global Trade Identification Number. Fields are epc_header, epc_filter, epc_partition, epc_company, epc_item, epc_serial.

SSCC-64

64-bit Serial Shipping Container Code. Fields are epc_header, epc_filter, epc_company, epc_serial.

SSCC-96

96-bit Serial Shipping Container Code. Fields are epc_header, epc_filter, epc_partition, epc_company, epc_serial, epc_unallocated.

UNKNOWNx-64

64-bit tag without any type recognized by this software, but with a header indicating it is 64 bits. Fields are epc_header and epc_unknown.

UNKNOWN-96

96-bit tag without any type recognized by this software, but with a header indicating it is 96 bits. Fields are epc_header and epc_unknown.

UNKNOWN

Tag without any type recognized by this software, and with no indication of its size in the header. Fields are epc_header and epc_unknown.

SEE ALSO ^

RFID::Tag, RFID::Reader, http://www.eecs.umich.edu/~wherefid/code/rfid-perl/, http://www.epcglobalinc.com/, The manual for your particular RFID reader.

AUTHOR ^

Scott Gifford <gifford@umich.edu>, <sgifford@suspectclass.com>

Copyright (C) 2004 The Regents of the University of Michigan.

See the file LICENSE included with the distribution for license information.

syntax highlighting: