/pycalima

Python interface for Pax Calima Fan via Bluetooth LE

Primary LanguagePythonApache License 2.0Apache-2.0

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