Repository navigation
RFID Management
The OpenEVSE integration provides full RFID tag management, allowing you to control which RFID cards or fobs can start a charging session, and associating each tag with a Home Assistant person entity or a friendly name.
| Feature | Minimum Firmware |
|---|---|
| Enable/disable RFID access | 4.1.4+ |
| Learn (pair) a new RFID tag | 4.0.0+ |
| Assign users to RFID tags | 5.0.0+ |
| Delete RFID tag mappings | 5.0.0+ |
| Retrieve all RFID tag mappings | 5.0.0+ |
Before any RFID features work, ensure the RFID Access switch is turned on:
- Find the RFID Access switch entity in: Settings → Devices & Services → OpenEVSE → (device)
- Toggle it on.
Or use an automation:
action: switch.turn_on
target:
entity_id: switch.openevse_rfid_accessUse the Learn RFID Tag button or service to put the charger into pairing mode:
Press the Learn RFID Tag button entity. The charger will enter pairing mode and the next card/fob scanned will be registered.
action: openevse.add_rfid_tag
target:
entity_id: sensor.openevse_charging_statusAfter calling this service, scan the RFID card or fob on the charger reader within the timeout period to complete pairing.
Once a tag is paired, you can associate it with a Home Assistant person entity or a friendly name string:
action: openevse.set_rfid_user
target:
entity_id: sensor.openevse_charging_status
data:
rfid: "01020304" # The RFID tag ID (visible in charger logs or web UI)
person: person.john_doeaction: openevse.set_rfid_user
target:
entity_id: sensor.openevse_charging_status
data:
rfid: "01020304"
name: "John Doe"Note
You can provide both person and name. If person is provided, the integration resolves the display name automatically from the person entity's friendly name.
To see all currently registered RFID tag → user mappings:
action: openevse.get_rfid_users
target:
entity_id: sensor.openevse_charging_status
response_variable: rfid_usersThe rfid_users variable will contain a dictionary of tag IDs and their associated user names.
To remove an RFID tag and its user association from the charger:
action: openevse.delete_rfid_user
target:
entity_id: sensor.openevse_charging_status
data:
rfid: "01020304"script:
onboard_rfid_tag:
alias: "Onboard New RFID Tag"
sequence:
# Step 1: Put charger in learn mode
- action: openevse.add_rfid_tag
target:
entity_id: sensor.openevse_charging_status
# Step 2: Wait for user to scan their card (15 seconds)
- delay: "00:00:15"
# Step 3: Assign the scanned tag to a person (update rfid value accordingly)
- action: openevse.set_rfid_user
target:
entity_id: sensor.openevse_charging_status
data:
rfid: "01020304"
person: person.jane_doe| Problem | Solution |
|---|---|
| "RFID Access" switch not visible | Firmware is older than 4.1.4 — update the charger firmware |
add_rfid_tag service fails |
Firmware must be 4.0.0+; confirm in the Controller Firmware sensor |
set_rfid_user / get_rfid_users unavailable |
Requires firmware 5.0.0+; check the Controller Firmware sensor |
| Tag scanned but not registered | Ensure you scanned within the pairing timeout window; try again |
| RFID not allowing charging | Confirm the RFID Access switch is enabled and the tag ID matches |