# 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
.. code:: python
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 <https://medium.com/@urish/reverse-engineering-a-bluetooth-lightbulb-56580fcb7546#.9ltnsvdsn>`_.
Some badly structured details about the protocol can be found in the
`Characteristics file <characteristics.md>`_.
There is currently no documentation on the module yet, check the
Calima.py file to see available functions.
Raw data
{
"_id": null,
"home_page": "https://github.com/PotatisGrizen/pycalima",
"name": "CalimaPython",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "pax calima fan bluetooth ble",
"author": "Super",
"author_email": "unknown@unknown.com",
"download_url": "https://files.pythonhosted.org/packages/df/24/a5a7833141e00895ee2d1d2c5aa3b98a9914d0cb8c70b7ddaac770a71cf0/CalimaPython-2.2.0.tar.gz",
"platform": null,
"description": "# Pycalima\r\n\r\nSimple python interface against the Pax Calima\u00c2\u00ae bathroom fan created and sold by Pax\u00c2\u00ae\r\n\r\nThis 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.\r\n\r\nUses Bleak\r\n\r\n## Installation\r\n\r\nInstall calima\r\n $sudo python3 -m pip install calima\r\n\r\n## Demo usage\r\n\r\n.. code:: python\r\n\r\n from Calima import Calima\r\n\r\n fan = Calima(\"MA:CC:AD:DR:ES:SS\", \"012345\")\r\n print(fan.getAlias())\r\n\r\n## Find MAC address\r\n\r\n $sudo python3 cmdline.py -l\r\n\r\n\r\n## Home Assistant integration\r\n\r\nPlease visit '<https://github.com/timutta/homeassistant-paxcalima>'_.\r\n\r\n## Command Line Tool\r\n\r\nPretty useful command line tool which among other things can print all\r\nthe characteristics of a fan. It can also search for available fans \r\nif you don't know the MAC address.\r\n\r\nFor more on using the tool, just run `calima -h`.\r\n\r\n## Debugging\r\n\r\nSet this to True in pycalima/Calima.py file if want to see more verbose output.\r\n\r\n self._debug = False\r\n\r\n## Documentation\r\n\r\nA good readup introductory readup on BLE reverse engineering can be found\r\n`here <https://medium.com/@urish/reverse-engineering-a-bluetooth-lightbulb-56580fcb7546#.9ltnsvdsn>`_.\r\n\r\nSome badly structured details about the protocol can be found in the\r\n`Characteristics file <characteristics.md>`_.\r\n\r\nThere is currently no documentation on the module yet, check the\r\nCalima.py file to see available functions.\r\n",
"bugtrack_url": null,
"license": "Apache 2.0",
"summary": "Python interface for Pax Calima Fan",
"version": "2.2.0",
"split_keywords": [
"pax",
"calima",
"fan",
"bluetooth",
"ble"
],
"urls": [
{
"comment_text": "",
"digests": {
"md5": "d02216f57e0059d6ac5d6eaa10c2a7ce",
"sha256": "343a9c6300e2d89b76d463a6c9b10dbf4934ee056e6f2a1a9a467919104effcd"
},
"downloads": -1,
"filename": "CalimaPython-2.2.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "d02216f57e0059d6ac5d6eaa10c2a7ce",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 9076,
"upload_time": "2022-12-20T00:29:24",
"upload_time_iso_8601": "2022-12-20T00:29:24.703199Z",
"url": "https://files.pythonhosted.org/packages/cc/bc/3dfd2cf9f1664ce3a7def2451b64fac0dcfcf74309d8950b8c7b00aa1ce7/CalimaPython-2.2.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"md5": "50573d9a22a07e2b0824c7438df0da94",
"sha256": "8b72a2ba866dea6e2cf4d02bcb264a265934a0d15a30fbfd933f1d4e99f98778"
},
"downloads": -1,
"filename": "CalimaPython-2.2.0.tar.gz",
"has_sig": false,
"md5_digest": "50573d9a22a07e2b0824c7438df0da94",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 8162,
"upload_time": "2022-12-20T00:29:26",
"upload_time_iso_8601": "2022-12-20T00:29:26.648669Z",
"url": "https://files.pythonhosted.org/packages/df/24/a5a7833141e00895ee2d1d2c5aa3b98a9914d0cb8c70b7ddaac770a71cf0/CalimaPython-2.2.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2022-12-20 00:29:26",
"github": true,
"gitlab": false,
"bitbucket": false,
"github_user": "PotatisGrizen",
"github_project": "pycalima",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "calimapython"
}
JSON
