Once your NFC-1 is in Home Assistant, its device page has controls, sensors, and settings for reading, writing, and emulating tags. Use the tabs below to see what each entity does.
Control
What it does
Mode
What the NFC-1 does with the next tag: Read, Write, Clean, or Format. Picking Write, Clean, or Format arms that task, and the NFC-1 goes back to Read once the task is done, cancelled, or timed out. Write writes the Write URL.
Write URL Tag
Arms a write of the Write URL setting to the next tag you present.
Write New HA Tag
Arms a write of a new Home Assistant tag with a random ID to the next tag you present.
Clean Tag
Arms a clean of the next tag you present, which removes the data on it so you can reuse it.
Format Tag
Arms a format of the next tag you present. On NTAG and MIFARE Ultralight tags, format does the same as clean.
Cancel Tag Operation
Cancels an armed write, clean, or format and puts the NFC-1 back in Read mode.
RGB Light
The NFC-1's RGB LED, with Slow Pulse, Fast Pulse, and Armed Pulse effects. While LED Feedback is on, scans and tag tasks take over the LED. Turn LED Feedback off to use it as a regular light.
Sensor
What it reports
Tag Present
On while a tag is on the reader.
Last Tag
The Home Assistant tag ID of the last tag scanned, or its UID when the tag doesn't carry a Home Assistant tag. This is the ID the tag shows under Settings → Tags.
Last Tag UID
The UID of the last tag scanned.
Last Tag Content
The content of the first record on the last tag scanned, such as a URL or a line of text. Up to 250 characters.
Last Operation
The result of the last write, clean, format, or card emulation change, such as Waiting for tag, Write verified, Write mismatch, Timed out, or Cancelled. See Read and write tags.
NFC Event
Fires an event for each scan, removal, and step of a tag task. See NFC Event types.
Online
Connection status of the device to Home Assistant.
ESP Temperature
Internal temperature of the ESP32-C6 chip. Runs warmer than the room because of the processor and Wi-Fi radio.
Uptime
How long the device has been running since its last restart.
Setting
Default
What it does
Write URL
Empty
The URL that Write URL Tag and Mode: Write write to a tag. Up to 120 characters.
Mode Timeout
30 s
How long the NFC-1 waits for a tag after you arm a write, clean, or format, from 5 to 300 seconds.
Card Emulation
Off
Makes the NFC-1 act as a tag that holds the Emulation URL, so a phone tapped on it opens that link. It turns itself off if Emulation URL is empty. See Card emulation.
Emulation URL
Empty
The URL the NFC-1 hands to a phone while Card Emulation is on. Up to 120 characters.
HA App Record
On
Adds an Android app record to Home Assistant tag URLs that the NFC-1 writes or emulates, so Android phones open the Home Assistant app. Other URLs never get it.
Buzzer
On
Turns the beeps for scans, tasks, and errors on or off.
Volume
50%
Buzzer volume, from 0 to 100%.
LED Feedback
On
Turns the LED flashes for scans, tasks, and errors on or off. While it's off, the NFC-1 leaves the RGB Light alone.
Feedback Brightness
80%
How bright the LED feedback flashes are, from 1 to 100%.
Bluetooth Proxy
Off
Lets the NFC-1 act as a Bluetooth proxy for Home Assistant, extending Bluetooth range to nearby devices.
Tag Polling
On
Turns tag reading on or off. The entity is disabled in Home Assistant by default; enable it to see it.
Firmware Channel
Stable
Which firmware channel the NFC-1 updates from. Beta gets new features earlier but is less tested than Stable. See Switch to beta firmware.
Firmware Update
n/a
Shows whether a newer firmware is available on the selected channel and installs it, straight from Home Assistant. See Updating firmware.
Reinstall Firmware
n/a
Installs the firmware from the selected channel, even if it's the version you already have. Press it after you change Firmware Channel.
Entity
What it shows
NFC Reader
Whether the NFC reader chip is working. It only reads disconnected after the chip fails to start more than 10 times in a row.
Last Tag Type
The type of the last tag scanned. Disabled by default.
RSSI
Wi-Fi signal strength.
IP Address, Connected SSID, Connected BSSID, MAC Address
Wi-Fi connection details. Disabled by default.
ESPHome Version
The ESPHome version the firmware was compiled with.
Apollo Firmware Version
The Apollo firmware build installed on the device (for example, 26.10.13.2).
Restart
Restarts the device. Helpful for troubleshooting or refreshing the connection.
Restart (Safe Mode)
Restarts into safe mode for 5 minutes, which skips the device's normal setup so you can recover it over the network. Disabled by default.
Factory Reset
Erases settings and Wi-Fi details and returns the device to its firmware defaults. Disabled by default.