An ESP32 based BLE client for the Gainsborough Freestyle Trilock smart door lock (Made by Gainsborough/Allegion), this client may also work with other Allegion locks.
Developed for Ethernet-based boards to improve BLE connection consistency, as the ESP32 can't run both WiFi and BLE simultaneously.
Using this client, you can lock/unlock the door in under 2 seconds, compared to the cloud API's 20-30 second reaction time.
This can also remove the need for cloud connectivity for your lock.
Designed for the WT32-ETH01 development board (an ESP32 module with Ethernet). Other boards using the same PHY will work, other hardware may with some adaptations.
-
Open the project with Visual Studio Code and PlatformIO to fetch dependencies and build.
-
Connect WT32 (TX, RX, GND & VCC) to a 3.3V TTL USB UART adapter.
-
Connect GPIO0 to GND while powering on the board to enter programming mode.
-
Hit the upload button in PlatformIO.
-
Network Connection:
- Connect the RJ45 port to a DHCP-enabled LAN and power on the WT32.
- The IP address will be shown in the serial log.
-
Web Configuration:
- Open the IP address in a browser.
- If prompted for a username and password, leave them blank.
- Navigate to the setup page and fill in the configuration details.
| Option | Description |
|---|---|
| Hostname | Any name for this device |
| AES Key | The base64 encoded value of the Offline Key for your lock* |
| BLE Mac | The Bluetooth MAC address of your lock* |
| MQTT Server | MQTT server IP address |
| MQTT Topic | Topic to use, defaults to trilock |
| HTTP Username | Username for web/api/ota, default is blank |
| HTTP Password | Password for web/api/ota, default is blank |
| Syslog Server | Optional Syslog server IP address (udp/514) |
- Improve this README
- Support repurposing the Freestyle Bridge (built on ESP8266 + EFR32)
- Retrieve keys to decrypt Sync channel messages (e.g., door open/closed notifications, config etc)
- Support fragmented packets (not needed for lock/unlock)
This is a reverse engineered project and is not affiliated with Gainsborough or Allegion.