PyCalima
Simple python interface against the Pax Calima® bathroom fan created and sold by Pax®
This module provides a very simple interface against the various GATT characteristics of the Calima fan, most importantly it handles the authentication so values are actually persisted within the fan.
Uses BluePy
Installation
I did this on Raspberry Pi Zero W but it can be done on any computer which support BluePy (and has a bluetooth dongle).
- You will need to install python3 which is Python v 3.4 if you install it from apt-get repos.
- $apt install python3 python3-pip libglib2.0-dev
- Then install BluePy
- $sudo pip3 install bluepy
Clone this repo and then user run.py script to set the basic settings for your Calima. They will be applied if Calima was power cycled. Afterwards it will just poll Calima and output the data. You can pipe it to your home autmation scripts or or cronjob it to a file.
Demo usage
from Calima import Calima
fan = Calima("MA:CC:AD:DR:ES:SS", "012345")
print(fan.getAlias())Command line tool
Pretty useful command line tool which among other things can print all the characteristics of a fan. It can also search for available fans if you don't know the MAC address.
For more on using the tool, just run calima -h.
Debugging
Set this to True in pycalima/Calima.py file if want to see more verbose output.
self._debug = False
Documentation
A good readup introductory readup on BLE reverse engineering can be found here.
Some badly structured details about the protocol can be found in the Characteristics file.
There is currently no documentation on the module yet, check the Calima.py file to see available functions.
License
See LICENSE file