Skip to main content

Python interface for Pax Calima Fan

Project description

# 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 Bleak

## Installation

Install calima

$sudo python3 -m pip install calima

## Demo usage

from Calima import Calima

fan = Calima("MA:CC:AD:DR:ES:SS", "012345")
print(fan.getAlias())

## Find MAC address

$sudo python3 cmdline.py -l

## Home Assistant integration

Please visit ‘<https://github.com/timutta/homeassistant-paxcalima>’_.

## 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.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

CalimaCalima2-2.0.2.tar.gz (8.2 kB view hashes)

Uploaded Source

Built Distribution

CalimaCalima2-2.0.2-py3-none-any.whl (9.1 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page