Add remote lock status sensor and physical lock control #43
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Features added: - Modbus remote lock status sensor (always available from register 259) - Optional physical lock control via GPIO relay (with ENABLE_LOCK_RELAY flag) - Home Assistant auto-discovery for both binary sensor and lock entities - Build flag system for optional relay control compilation - GPIO pin configuration (GPIO25 for ESP32, GPIO18 for LILYGO) - Fail-safe default to locked state on ESP32 power loss - Comprehensive documentation including wiring guide Build environments: - Standard builds: esp32, lilygo, dummy (Modbus sensor only) - Relay builds: esp32_with_lock_relay, lilygo_with_lock_relay, dummy_with_lock_relay Documentation: - Remote lock status sensor and lock control implementation guide - Physical lock control benefits and use cases - Detailed relay wiring guide with diagrams and safety notes Technical details: - New LockController component with singleton pattern - Board abstraction updated for conditional GPIO pin support - MQTT integration with Home Assistant lock entity discovery - Error handling with safe defaults (unlocked state on Modbus read failure) - Conditional compilation for memory efficiency without relay hardware
|
This is how it looks when wired up. The other side of the relay would connect to the remote lock connector of the wallbox. In Home Assistant, this will add a control element and a (modbus) sensor like this: 
I tested with the Lilygo board and a regular esp32. |
|
The remote lock status sensor does not report correct values. |
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Overview
This PR implements a comprehensive remote lock control system with two components:
Key Features
🔍 Core Functionality
ENABLE_LOCK_RELAY) for optional compilation🏗️ Build Environments
Standard (sensor only):
esp32,lilygo,dummyWith relay control:
esp32_with_lock_relay,lilygo_with_lock_relay,dummy_with_lock_relay🏠 Home Assistant Integration
binary_sensor.{device}_remote_lock_status(always available)lock.{device}_lock_control(with relay builds only)📖 Documentation
Safety & Reliability
✅ Fail-safe default: locks when ESP32 loses power
✅ Conditional compilation for memory efficiency
✅ No impact on existing installations
✅ Comprehensive error handling
Ready for testing and deployment!