The tag reader is a simple to build/use NFC tag reader, specially created for Home Assistant. It is completely based on adonno/tagreader but uses a ESP32-POE in place of a D1 Mini to avoid using wireless. The firmware is built using ESPhome.
To build your own modified tag reader, you need the following components:
The 3D models are not yet available for combining the ESP32-POE and PN532 NFC Reader. This was made for a demo.
NOTE: this schematic needs to be updated to show the ESP32-POE and its pins. Instead of this weird fritzig software, use graphviz images.
There are not too many components to connect, but it does require soldering. You will need the following:
Also, make sure that you have set the switches on the PN532 to the following:
- Switch 1: On (up)
- Switch 2: Off (down)
This enables the PN532 module to communicate with the D1 over I2C, and is required for the modules to work together!
To flash the reader firmware to your ESP32-OPE you point ESPHome at tagreader.yaml.
⚠️ The tag reader requires ESPHome1.16.0.
If you're new to ESPHome, we recommend that you use the ESPHome Home Assistant add-on.
The tag reader requires Home Assistant 0.115 or later.
The tag reader will be automatically discovered by Home Assistant once the tag reader is connected to the same network. You can follow the instructions in the UI to set it up.
Scanned tags can be managed from the tags interface in Home Assistant. You can find it under config -> tags.
We use aliexpress affiliate links for the components and the tools. Some Ad-blockers might block these links and thus they seem to appear broken. You will have to temporarily disable the ad-blocker to open these links.



