pguyot/cr14

STMicroelectronics CR14 Driver for Linux

CR14 RFID reader driver for Linux (Raspbian)

Datasheet and technical documents

Chipset:

• CR14

PICC:

• SRIX4K
• SRI512
• SRT512
• SRI4K
• SRI2K
• ST25TB512-AC
• ST25TB04K
• ST25TB512-AT
• ST25TB02K

This driver may be compatible with CRX14 as well. Tested with CR14 and SRI512/SRT512 PICCs.

Installation

Install requirements

sudo apt-get install raspberrypi-kernel-headers

Clone source code.

git clone https://github.com/pguyot/cr14

Compile and install with

cd cr14
make
sudo make install

Makefile will automatically edit /boot/config.txt and add/enable if required the following params and overlays:

dtparam=i2c_arm=on
dtoverlay=cr14

You might want to review changes before rebooting.

Reboot.

Interface

Driver creates device /dev/rfid0

Several modes are available, see the sample Python scripts in examples.

Simplest mode consists in opening device read-only. The CR14 will be polled every 0.5 second, printing detected tag UIDs preceeded by 'u' (UIDs are printed in little endian, LSB first).

More complex interactions are possible by opening device r/w and sending commands, for example to read or write EEPROM.

cr14's Issues

armv7l version of driver seems broken

CR14 driver seems broken with armv7l kernel.
See nabaztag2018/pynab#315.

Driver build fails with kernel 5.15.xx

/usr/bin/git pull -v
From https://github.com/pguyot/cr14
 = [up to date]      release    -> origin/release
 = [up to date]      master     -> origin/master
Already up to date.
Building cr14 driver for kernel 5.15.30+.
/usr/bin/make KERNELRELEASE=5.15.30+ clean && /usr/bin/make KERNELRELEASE=5.15.30+ && /usr/bin/sudo /usr/bin/make KERNELRELEASE=5.15.30+ install && /usr/bin/make KERNELRELEASE=5.15.30+ clean
make -C /lib/modules/5.15.30+/build M=/home/pi/cr14 clean
make[1]: Entering directory '/usr/src/linux-headers-5.15.30+'
make[1]: Leaving directory '/usr/src/linux-headers-5.15.30+'
make -C /lib/modules/5.15.30+/build M=/home/pi/cr14 modules
make[1]: Entering directory '/usr/src/linux-headers-5.15.30+'
  CC [M]  /home/pi/cr14/cr14.o
  MODPOST /home/pi/cr14/Module.symvers
  CC [M]  /home/pi/cr14/cr14.mod.o
  LD [M]  /home/pi/cr14/cr14.ko
make[1]: Leaving directory '/usr/src/linux-headers-5.15.30+'
make: *** No rule to make target 'cr14.dtbo', needed by 'install'.  Stop.

Tags would be useful on cr14 branches

This would ease version tracking from Nabaztag (Pynab).

Release 1.0.1 not fully functional

Release 1.0.1 does not fully fix compatibility with 64 bits OSes, as advertised.
It does fix the build issue, but not the runtime issue (later fixed in 50bc172).

Suggestion: have a release branch

... and use it in Pynab install: this would be less confusing to Pynab users, given what they are told about release and master branches.