package Biblio::RFID::RFID501; use warnings; use strict; use Data::Dump qw(dump); =head1 NAME Biblio::RFID::RFID501 - RFID Standard for Libraries =head1 DESCRIPTION This module tries to decode tag format as described in document RFID 501: RFID Standards for Libraries L Goal is to be compatible with existing 3M Alphanumeric tag format which, as far as I know, isn't specificed anywhere. My documentation about this format is available at L =head1 Data model =head2 3M Alphanumeric tag 0 04 is 00 tt i [4 bit] = number of item in set [1 .. i .. s] s [4 bit] = total items in set tt [8 bit] = item type 1 dd dd dd dd dd [16 bytes] = barcode data 2 dd dd dd dd 3 dd dd dd dd 4 dd dd dd dd 5 bb bl ll ll b [12 bit] = branch [unsigned] l [20 bit] = library [unsigned] 6 cc cc cc cc c [32 bit] = custom signed integer =head2 3M Manufacturing Blank 0 55 55 55 55 1 55 55 55 55 2 55 55 55 55 3 55 55 55 55 4 55 55 55 55 5 55 55 55 55 6 00 00 00 00 =head2 Generic blank 0 00 00 00 00 1 00 00 00 00 2 00 00 00 00 =head1 Security AFI byte on RFID tag is used for security. In my case, we have RFID door which can only read AFI bytes from tag and issue alarm sound or ignore it depending on value of byte. =over 8 =item 0xD7 214 secured item (door will beep) =item 0xDA 218 unsecured (door will ignore it) =back =head1 METHODS =head2 to_hash my $hash = Biblio::RFID::Decode::RFID501->to_hash( $bytes ); my $hash = Biblio::RFID::Decode::RFID501->to_hash( [ 'blk1', 'blk2', ... , 'blk7' ] ); =head2 from_hash my $blocks = Biblio::RFID::Decode::RFID->from_hash({ content => "1301234567" }); =head2 blank_3m =head2 blank my $blocks = Biblio::RFID::Decode::RFID->blank; =cut my $item_type = { 1 => 'Book', 6 => 'CD/CD ROM', 2 => 'Magazine', 13 => 'Book with Audio Tape', 9 => 'Book with CD/CD ROM', 0 => 'Other', 5 => 'Video', 4 => 'Audio Tape', 3 => 'Bound Journal', 8 => 'Book with Diskette', 7 => 'Diskette', }; sub to_hash { my ( $self, $data ) = @_; return unless $data; $data = join('', @$data) if ref $data eq 'ARRAY'; if ( length($data) < 24 ) { die "short data from tag ", length($data), " < 24 bytes"; } warn "## to_hash ",dump($data); my ( $u1, $set_item, $u2, $type, $content, $br_lib, $custom, $zero ) = unpack('C4Z16Nl>l',$data); my $hash = { u1 => $u1, # FIXME 0x04 set => ( $set_item & 0xf0 ) >> 4, total => ( $set_item & 0x0f ), u2 => $u2, # FIXME 0x00 type => $type, type_label => $item_type->{$type}, content => $content, branch => $br_lib >> 20, library => $br_lib & 0x000fffff, custom => $custom, }; warn "expected first byte to be 0x04, not $u1\n" if $u1 != 4; warn "expected third byte to be 0x00, not $u2\n" if $u2 != 0; warn "expected last block to be zero, not $zero\n" if $zero != 0; return $hash; } sub from_hash { my ( $self, $hash ) = @_; warn "## from_hash ",dump($hash); $hash->{$_} ||= 0 foreach ( qw( set total type branch library ) ); return pack('C4Z16Nl>l', 0x04, ( $hash->{set} << 4 ) | ( $hash->{total} & 0x0f ), 0x00, $hash->{type}, $hash->{content}, ( $hash->{branch} << 20 ) | ( $hash->{library} & 0x000fffff ), $hash->{custom}, 0x00, ); } sub blank_3m { return ( "\x55" x ( 6 * 4 ) ) . ( "\x00" x 4 ); } sub blank { return "\x00" x ( 4 * 3 ); } 1;