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; },
42 reader => sub { my $reader = shift; ref($reader) =~ m/something/ },
51 $self->{_tags} ||= {};
52 $self->{_tags}->{$_}->{time} = 0 foreach keys %{$self->{_tags}};
55 foreach my $rfid ( @{ $self->{_readers} } ) {
57 if ( exists $triggers->{reader} ) {
58 next unless $triggers->{reader}->($rfid);
61 warn "# inventory on $rfid";
62 my @tags = $rfid->inventory;
64 foreach my $tag ( @tags ) {
66 if ( ! exists $self->{_tags}->{$tag} ) {
68 my $blocks = $rfid->read_blocks($tag);
69 $self->{_tags}->{$tag}->{blocks} = $blocks->{$tag} || die "no $tag in ",dump($blocks);
70 my $afi = $rfid->read_afi($tag);
71 $self->{_tags}->{$tag}->{afi} = $afi;
72 $self->{_tags}->{$tag}->{type} = $rfid->tag_type( $tag );
73 $self->{_tags}->{$tag}->{reader} = ref $rfid; # save reader info
77 warn "ERROR reading $tag: $@\n";
78 $self->_invalidate_tag( $tag );
82 $triggers->{enter}->( $tag ) if $triggers->{enter};
85 $self->{_tags}->{$tag}->{time} = $t;
91 foreach my $tag ( grep { $self->{_tags}->{$_}->{time} == 0 } keys %{ $self->{_tags} } ) {
92 $triggers->{leave}->( $tag ) if $triggers->{leave};
93 $self->_invalidate_tag( $tag );
96 warn "## _tags ",dump( $self->{_tags} );
98 return grep { $self->{_tags}->{$_}->{time} } keys %{ $self->{_tags} };
103 my $blocks_arrayref = $rfid->blocks( $tag );
107 my $afi = $rfid->afi( $tag );
111 sub blocks { $_[0]->{_tags}->{$_[1]}->{ 'blocks' } || confess "no blocks for $_[1]"; };
112 sub afi { $_[0]->{_tags}->{$_[1]}->{ 'afi' } || confess "no afi for $_[1]"; };
116 $self->to_hash( $tag );
121 my ( $self, $tag ) = @_;
122 return unless exists $self->{_tags}->{$tag};
123 my $type = $self->{_tags}->{$tag}->{type} || confess "can't find type for tag $tag ",dump( $self->{_tags} );
124 my $decode = 'Biblio::RFID::' . $type;
125 my $hash = $decode->to_hash( $self->blocks( $tag ) );
126 $hash->{tag_type} = $type;
132 $self->debug(1); # or more
137 my ( $self, $level ) = @_;
138 $debug = $level if $level > $debug;
139 warn "debug level $level\n" if $level;
144 my $reader = $self->from_reader( $tag );
149 my ( $self, $tag ) = @_;
150 return unless exists $self->{_tags}->{$tag};
151 my $reader = $self->{_tags}->{$tag}->{reader};
152 $reader =~ s/^.*:://; # strip module prefix
158 =head2 _invalidate_tag
160 $rfid->_invalidate_tag( $tag );
164 sub _invalidate_tag {
165 my ( $self, $tag ) = @_;
166 my @caller = caller(0);
167 warn "## _invalidate_tag caller $caller[0] $caller[1] +$caller[2]\n";
168 my $old = delete $self->{_tags}->{$tag};
169 warn "# _invalidate_tag $tag ", dump($old);
174 Probe each RFID reader supported and returns succefull ones
176 my $rfid_readers = Biblio::RFID::Reader->_available( $regex_filter );
180 #my @readers = ( '3M810', 'CPRM02', 'librfid' );
181 my @readers = ( '3M810', 'librfid' );
184 my ( $self, $filter ) = @_;
186 $filter = '' unless defined $filter;
188 warn "# filter: $filter";
192 foreach my $reader ( @readers ) {
193 next if $filter && $reader !~ /$filter/i;
194 my $module = "Biblio::RFID::Reader::$reader";
197 if ( my $rfid = $module->new ) {
199 warn "# added $module\n";
201 warn "# ignored $module\n";
205 die "no readers found" unless @rfid;
212 On any other function calls, we just marshall to all readers
216 # we don't want DESTROY to fallback into AUTOLOAD
222 my $command = $AUTOLOAD;
227 foreach my $r ( @{ $self->{_readers} } ) {
228 push @out, $r->$command(@_);
231 $self->_invalidate_tag( $_[0] ) if $command =~ m/write/;
241 =head2 RFID reader implementations
243 L<Biblio::RFID::Reader::3M810>
245 L<Biblio::RFID::Reader::CPRM02>
247 L<Biblio::RFID::Reader::librfid>