1 package Biblio::RFID::Reader;
6 use Data::Dump qw(dump);
14 Biblio::RFID::Reader - simple way to write RFID applications in perl
18 This module will probe all available readers and use calls from
19 L<Biblio::RFID::Reader::API> to invoke correct reader.
25 my $rfid = Biblio::RFID::Reader->new( 'optional reader filter' );
30 my ( $class, $filter ) = @_;
33 $self->{_readers} = [ $self->_available( $filter ) ];
39 my @visible = $rfid->tags(
40 enter => sub { my $tag = shift; },
41 leave => sub { my $tag = shift; },
50 $self->{_tags} ||= {};
51 $self->{_tags}->{$_}->{time} = 0 foreach keys %{$self->{_tags}};
54 foreach my $rfid ( @{ $self->{_readers} } ) {
55 warn "# inventory on $rfid";
56 my @tags = $rfid->inventory;
58 foreach my $tag ( @tags ) {
60 if ( ! exists $self->{_tags}->{$tag} ) {
62 my $blocks = $rfid->read_blocks($tag);
63 $self->{_tags}->{$tag}->{blocks} = $blocks->{$tag} || die "no $tag in ",dump($blocks);
64 my $afi = $rfid->read_afi($tag);
65 $self->{_tags}->{$tag}->{afi} = $afi;
66 $self->{_tags}->{$tag}->{type} = $rfid->tag_type( $tag );
67 $self->{_tags}->{$tag}->{reader} = ref $rfid; # save reader info
71 warn "ERROR reading $tag: $@\n";
72 $self->_invalidate_tag( $tag );
76 $triggers->{enter}->( $tag ) if $triggers->{enter};
79 $self->{_tags}->{$tag}->{time} = $t;
85 foreach my $tag ( grep { $self->{_tags}->{$_}->{time} == 0 } keys %{ $self->{_tags} } ) {
86 $triggers->{leave}->( $tag ) if $triggers->{leave};
87 $self->_invalidate_tag( $tag );
90 warn "## _tags ",dump( $self->{_tags} );
92 return grep { $self->{_tags}->{$_}->{time} } keys %{ $self->{_tags} };
97 my $blocks_arrayref = $rfid->blocks( $tag );
101 my $afi = $rfid->afi( $tag );
105 sub blocks { $_[0]->{_tags}->{$_[1]}->{ 'blocks' } || confess "no blocks for $_[1]"; };
106 sub afi { $_[0]->{_tags}->{$_[1]}->{ 'afi' } || confess "no afi for $_[1]"; };
110 $self->to_hash( $tag );
115 my ( $self, $tag ) = @_;
116 return unless exists $self->{_tags}->{$tag};
117 my $type = $self->{_tags}->{$tag}->{type} || confess "can't find type for tag $tag ",dump( $self->{_tags} );
118 my $decode = 'Biblio::RFID::' . $type;
119 my $hash = $decode->to_hash( $self->blocks( $tag ) );
120 $hash->{tag_type} = $type;
126 $self->debug(1); # or more
131 my ( $self, $level ) = @_;
132 $debug = $level if $level > $debug;
133 warn "debug level $level\n" if $level;
138 my $reader = $self->from_reader( $tag );
143 my ( $self, $tag ) = @_;
144 return unless exists $self->{_tags}->{$tag};
145 my $reader = $self->{_tags}->{$tag}->{reader};
146 $reader =~ s/^.*:://; # strip module prefix
152 =head2 _invalidate_tag
154 $rfid->_invalidate_tag( $tag );
158 sub _invalidate_tag {
159 my ( $self, $tag ) = @_;
160 my @caller = caller(0);
161 warn "## _invalidate_tag caller $caller[0] $caller[1] +$caller[2]\n";
162 my $old = delete $self->{_tags}->{$tag};
163 warn "# _invalidate_tag $tag ", dump($old);
168 Probe each RFID reader supported and returns succefull ones
170 my $rfid_readers = Biblio::RFID::Reader->_available( $regex_filter );
174 #my @readers = ( '3M810', 'CPRM02', 'librfid' );
175 my @readers = ( '3M810', 'librfid' );
178 my ( $self, $filter ) = @_;
180 $filter = '' unless defined $filter;
182 warn "# filter: $filter";
186 foreach my $reader ( @readers ) {
187 next if $filter && $reader !~ /$filter/i;
188 my $module = "Biblio::RFID::Reader::$reader";
191 if ( my $rfid = $module->new ) {
193 warn "# added $module\n";
195 warn "# ignored $module\n";
199 die "no readers found" unless @rfid;
206 On any other function calls, we just marshall to all readers
210 # we don't want DESTROY to fallback into AUTOLOAD
216 my $command = $AUTOLOAD;
221 foreach my $r ( @{ $self->{_readers} } ) {
222 push @out, $r->$command(@_);
225 $self->_invalidate_tag( $_[0] ) if $command =~ m/write/;
235 =head2 RFID reader implementations
237 L<Biblio::RFID::Reader::3M810>
239 L<Biblio::RFID::Reader::CPRM02>
241 L<Biblio::RFID::Reader::librfid>