Skip to content

RFID Management

firstof9 edited this page Sep 28, 2026 · 1 revision

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.


Firmware Requirements

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+

Step 1: Enable RFID Access

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_access

Step 2: Pair a New RFID Tag

Use the Learn RFID Tag button or service to put the charger into pairing mode:

Via the UI

Press the Learn RFID Tag button entity. The charger will enter pairing mode and the next card/fob scanned will be registered.

Via a Service

action: openevse.add_rfid_tag
target:
  entity_id: sensor.openevse_charging_status

After calling this service, scan the RFID card or fob on the charger reader within the timeout period to complete pairing.


Step 3: Assign a User to an RFID Tag (firmware 5.0.0+)

Once a tag is paired, you can associate it with a Home Assistant person entity or a friendly name string:

Assign a Home Assistant Person

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_doe

Assign a Friendly Name Only

action: 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.


Retrieve All RFID Mappings (firmware 5.0.0+)

To see all currently registered RFID tag → user mappings:

action: openevse.get_rfid_users
target:
  entity_id: sensor.openevse_charging_status
response_variable: rfid_users

The rfid_users variable will contain a dictionary of tag IDs and their associated user names.


Delete an RFID Tag Mapping (firmware 5.0.0+)

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"

Example: Full RFID Onboarding Script

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

Troubleshooting

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

Clone this wiki locally