Skip to content
Andrew Grimberg edited this page Feb 26, 2026 · 3 revisions

How it works

Each code slot has an Active binary sensor and a Sync Status sensor.

Keymaster writes a PIN to the physical lock only when the slot is active.
If a slot becomes inactive, disabled, or cleared, Keymaster removes that PIN from the lock.

What makes a slot Active

A slot is active when all enabled rules pass:

  • Enabled is on
  • PIN exists (PIN entry from the UI requires numeric values with 4+ digits)
  • Limit by Number of Uses is either off, or Uses Remaining is greater than 0
  • Limit by Date Range (if enabled) is currently in range
  • Limit by Day of Week (if enabled) allows the current day/time

If a slot unlocks the door and Limit by Number of Uses is enabled, Uses Remaining is decremented.

For day/time limits, each day supports:

  • enable/disable the day
  • optionally enforce a time window
  • include or exclude that time window

PIN Status

Code Slot X: Sync Status reflects whether Home Assistant and the lock agree on the PIN state.

Status Meaning
Adding PIN is being written to the lock
Deleting PIN is being cleared from the lock
Synced Keymaster and lock are in sync
Out of Sync The lock reported a different numeric PIN than expected
Disconnected Slot is inactive/cleared or lock connection is unavailable