pysesameos2

Unofficial Python Library to communicate with SESAME 3 series products via Bluetooth connection.

Introduction

This project aims to control smart devices running Sesame OS2 via Bluetooth connection. If you want to control them via the cloud service, please check pysesame3.

To be honest, this is my first time to use Bleak which provides an asynchronous, cross-platform Bluetooth API. PRs are heavily welcome.

• Free software: MIT license
• Documentation: https://pysesameos2.readthedocs.io

Tested Environments

• macOS 10.15.7, Python 3.9.5
• Raspberry Pi Zero W (Raspbian GNU/Linux 10, Raspberry Pi reference 2021-05-07), Python 3.7.3

Features

Please note that pysesameos2 can only control SESAME 3 Smart Lock at this moment. Although all types of devices running Sesame OS2 are technically supportable, I don't actually have or need those devices. PRs are always welcome to help out!

• Scan all SESAME locks using BLE advertisements.
• Receive state changes (locked, handle position, etc.) that are actively reported from the device.
• Needless to say, locking and unlocking!

Consideration

• The results of pysesameos2 are merely from reverse engineering of the official SDK. We have implemented just a small part of it, so you might run into some issues. Please do let me know if you find any problems!
• pysesameos2 only supports devices that have already been initially configured using the official app. That is, pysesameos2 cannot configure the locking position of your device.
• pysesameos2 does not have, and will not have, any functionality related to the operation history of locks. According to the document, your lock's operation history is not stored in the lock itself, but on the cloud service. I personally recommend you to bring a Wi-Fi module to get the operation history uploaded and retrive it by the API.

Usage

Please take a look at the example directory.

Credits & Thanks

• A huge thank you to all at CANDY HOUSE.
• Many thanks to bleak and pyzerproc.