gomalock 1.1.2

A Python library for controlling Sesame smart locks over Bluetooth Low Energy.

gomalock

SesameスマートロックをBluetooth Low Energyで操作するPythonライブラリ

機能説明

• Sesame 5 (Pro)の施錠、開錠
• 施錠状態、電池残量などの変化をリアルタイムで受信
• Sesame Touchの電池電圧、残量の変化をリアルタイムで受信
• 周囲のSesameデバイスをスキャンして情報を取得
• 新規Sesameデバイスの登録
• 施錠、開錠角度の設定
• オートロック秒数の設定
• 共有用QRコードの作成
• 自動再接続

インストール

通常のインストール

pip install gomalock

最新のソースからインストール

pip install git+https://github.com/meronepy/gomalock.git

使用方法

開錠例

import asyncio

import gomalock

MAC_ADDRESS = "XX:XX:XX:XX:XX:XX"
SECRET_KEY = "0123456789abcdef0123456789abcdef"


async def main():
    async with gomalock.Sesame5(MAC_ADDRESS, SECRET_KEY) as sesame5:
        await sesame5.unlock("gomalock")


if __name__ == "__main__":
    asyncio.run(main())

• MAC_ADDRESSはdiscover.pyで周囲のSesameをスキャンして取得できます。
• SECRET_KEYはmochipon様作成のQR Code Reader for SESAMEを使用して、マネージャー権限以上のQRコードから抽出できます。
• 詳細な使用方法はexamplesおよびdocsをご覧ください。

MQTTとブリッジするサンプルコード

https://github.com/meronepy/ssm2mqtt

注意事項

• Raspberry Pi OSはデフォルトでBluetoothをブロックしていることがあります。
  bleak.exc.BleakBluetoothNotAvailableErrorのようなエラーが出る場合は以下のコマンドでブロックを解除してください。

  sudo rfkill unblock bluetooth
  

• Linuxで動作させる場合、 BlueZ 5.82以降が必要です。 Raspberry Pi OS BookwormのBlueZ 5.66では、Sesame 5のGATT Serviceが取得できず正常に動作しません。

• 履歴機能は公式アプリとの連携が困難であるため実装しておりません。

• 非公式のライブラリです。動作保証はありません。自己責任でご使用ください。

開発環境

• Windows 11 24H2, Python 3.13.3
• Raspberry Pi Zero 2W, Raspberry Pi OS Trixie (64bit), Python 3.13.3
• Sesame 5, 3.0-5-18a8e4
• Sesame 5 Pro, 3.0-7-848a2d

対応機種

対応状況	機種
✅	Sesame 5
✅	Sesame 5 Pro
⚠️	Sesame 5 USA (未検証)
❌	Sesame 4以前

対応状況	機種
✅	Sesame Touch
⚠️	Sesame Touch Pro (未検証)
❌	Sesame Face
❌	Sesame Face Pro

対応環境

OS

対応状況	OS
✅	Windows 11 version 22000 以降
✅	Linux with BlueZ 5.82 以降
⚠️	macOS 10.15 以降 (未検証)

Python

Python 3.12以降が必要です。