Nerves.IO.RC522

Nerves support for the RC522 RFID reader.

The RC522 is a cheap RFID module which can be used to read MIFARE-compatible tags at 13.56Mhz.

Limitations

Currently, only Raspberry PI is supported as the host platform due to the usage of the BCM2835 library in the Port driver.

Furthermore, this library currently only reads the tag UID. The RC522 supports reading and writing MIFARE tag data, but this library does not yet support it.

Installation

1. Add nerves_io_rc522 to your list of dependencies in mix.exs:

```elixir
def deps do
  [{:nerves_io_rc522, "~> 0.1.0"}]
end
```

1. Ensure nerves_io_rc522 is started before your application:

```elixir
def application do
  [applications: [:nerves_io_rc522]]
end
```

Usage

Add the Nerves.IO.RC522 GenServer to your supervision tree:

worker(Nerves.IO.RC522, [{RfidReader.Handler, :tag_scanned}])

When a tag is scanned the function RfidReader.Handler.tag_scanned() function will now be called with the hex-encoded serial number (UID) of the scanned tag as its single argument.

Connecting the hardware

Connecting RC522 module to SPI is pretty easy. You can use this neat website for reference.

License

This library is distributed under the Apache license. The rc522 port driver, however, is distributed as GPLv2, as it incorporates the (BCM2835)[http://www.airspayce.com/mikem/bcm2835/] driver library. See src/ COPYING for details.