{ "info": { "author": "Marcel Hoppe", "author_email": "hoppe.marcel@gmail.com", "bugtrack_url": null, "classifiers": [ "Development Status :: 5 - Production/Stable", "Intended Audience :: Developers", "License :: OSI Approved :: MIT License", "Programming Language :: Python :: 3", "Programming Language :: Python :: 3.4", "Programming Language :: Python :: 3.5", "Topic :: System :: Hardware :: Hardware Drivers" ], "description": "# mithermometer - Library for Xiaomi Aqara temperature and humidity sensor\n\n[![PyPI](https://img.shields.io/pypi/v/mithermometer.svg)](https://pypi.python.org/pypi/mithermometer)\n[![PyPI](https://img.shields.io/pypi/status/mithermometer.svg)](https://pypi.python.org/pypi/mithermometer)\n[![PyPI](https://img.shields.io/pypi/format/mithermometer.svg)](https://pypi.python.org/pypi/mithermometer)\n[![GitHub license](https://img.shields.io/github/license/hobbypunk90/mithermometer.svg)](https://github.com/hobbypunk90/mithermometer/blob/master/LICENSE)\n\nThis library lets you read sensor data from a Xiaomi Aqara temperature and humidity sensor.\n\n* Latest release download: https://pypi.python.org/pypi/mithermometer\n\nthe mithermometer library is based on the [miflora library](https://github.com/open-homeautomation/miflora). Thanks for this great lib.\n\n## Functionality \nIt supports reading the different measurements from the sensor\n- temperature\n- humidity\n\nTo use this library you will need a Bluetooth Low Energy dongle attached to your computer. You will also need a\n Xiaomi Aqara thermometer. \n\n## Backends\nAs there is unfortunately no universally working Bluetooth Low Energy library for Python, the project currently \noffers support for two Bluetooth implementations:\n\n* bluepy library\n* bluez tools (via a wrapper around gatttool)\n* pygatt library\n\n\n### bluepy\nTo use the [bluepy](https://github.com/IanHarvey/bluepy) library you have to install it on your machine, in most cases this can be done via: \n```pip3 install bluepy``` \n\nExample to use the bluepy backend:\n```python\nfrom mithermometer.mithermometer_poller import MiThermometerPoller\nfrom btlewrap.bluepy import BluepyBackend\n\npoller = MiThermometerPoller('some mac address', BluepyBackend)\n```\nThis is the backend library to be used.\n\n### bluez/gatttool wrapper\nTo use the bluez wrapper, you need to install the bluez tools on your machine. No additional python \nlibraries are required. Some distrubutions moved the gatttool binary to a separate package. Make sure you have this \nbinaray available on your machine.\n\nExample to use the bluez/gatttool wrapper:\n```python\nfrom mithermometer.mithermometer_poller import MiThermometerPoller\nfrom btlewrap.gatttool import GatttoolBackend\n\npoller = MiThermometerPoller('some mac address', GatttoolBackend)\n```\n\nThis backend should only be used, if your platform is not supported by bluepy. \nNote: gatttool is depracated in many Linux distributions.\n\n### pygatt\nIf you have a Blue Giga based device that is supported by [pygatt](https://github.com/peplin/pygatt), you have to\ninstall the bluepy library on your machine. In most cases this can be done via: \n```pip3 install pygatt``` \n\nExample to use the pygatt backend:\n```python\nfrom mithermometer.mithermometer_poller import MiThermometerPoller\nfrom btlewrap.pygatt import PygattBackend\n\npoller = MiThermometerPoller('some mac address', PygattBackend)\n```\n# Dependencies\nmithermometer depends on the [btlewrap](https://github.com/ChristianKuehnel/btlewrap) library. If you install mithermometer via PIP btlewrap will automatically be installed. If not, you will have to install btlewrap manually:\n\n```pip3 install btlewrap``` \n\n## Conttributing\nplease have a look at [CONTRIBUTING.md](CONTRIBUTING.md)\n\n## Projects Depending on `mithermometer`\n\nThe following shows a selected list of projects using this library:\n\n* https://github.com/zewelor/bt-mqtt-gateway - A BT to MQTT gateway which support MiThermometer sensors + other devices\n\n\n", "description_content_type": "text/markdown", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/hobbypunk90/mithermometer", "keywords": "thermometer temperature humidity sensor bluetooth low-energy ble", "license": "MIT", "maintainer": "", "maintainer_email": "", "name": "mithermometer", "package_url": "https://pypi.org/project/mithermometer/", "platform": "", "project_url": "https://pypi.org/project/mithermometer/", "project_urls": { "Homepage": "https://github.com/hobbypunk90/mithermometer" }, "release_url": "https://pypi.org/project/mithermometer/0.1.3/", "requires_dist": [ "btlewrap (==0.0.4)", "pytest ; extra == 'testing'" ], "requires_python": "", "summary": "Library to read data from Xiaomi Aqara thermometer", "version": "0.1.3" }, "last_serial": 5004593, "releases": { "0.1.1": [ { "comment_text": "", "digests": { "md5": "0466bb2fc3e36996499fb183c47f6148", "sha256": "7fc4259a022d47b8ae2c796f7b2304589a6be17e2dedf2f420465229d5dd6741" }, "downloads": -1, "filename": "mithermometer-0.1.1.tar.gz", "has_sig": false, "md5_digest": "0466bb2fc3e36996499fb183c47f6148", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 10329, "upload_time": "2018-08-06T12:13:10", "url": "https://files.pythonhosted.org/packages/1e/74/ca96fed3e9826a1c3ba1a15b95936013672006fe26a7c6c62ecf08c227a2/mithermometer-0.1.1.tar.gz" } ], "0.1.2": [ { "comment_text": "", "digests": { "md5": "15489a86ac5a6b14afdffbc6be4c0d2c", "sha256": "6eb2ceaa054f53bcc128cc47553d1c101733e5d8b4a254c2e83616d856c285b6" }, "downloads": -1, "filename": "mithermometer-0.1.2-py3-none-any.whl", "has_sig": false, "md5_digest": "15489a86ac5a6b14afdffbc6be4c0d2c", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 15782, "upload_time": "2018-08-11T11:52:51", "url": "https://files.pythonhosted.org/packages/b0/db/a3595d18b6b007e812c96e3050ea83c0499120d790873703200aacb3b7a4/mithermometer-0.1.2-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "ea083d95cf99e260db48ddcec46d02ec", "sha256": "56f245c5bc290e62ce4cff626244941d720d52aad1e3b0e5e9941b0ba1f747b3" }, "downloads": -1, "filename": "mithermometer-0.1.2.tar.gz", "has_sig": false, "md5_digest": "ea083d95cf99e260db48ddcec46d02ec", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 10327, "upload_time": "2018-08-11T11:52:53", "url": "https://files.pythonhosted.org/packages/94/1d/9a2abcd714c34835dffcd1fafe25219a29a8e9672c2b79944db18ef2a4a9/mithermometer-0.1.2.tar.gz" } ], "0.1.3": [ { "comment_text": "", "digests": { "md5": "bdc6c71ce87048ccfb28d276749623a8", "sha256": "762ae2a8f706b6a72fe5d5aceb4f0d2bb047bc35a030d0cd36c582e6121d605f" }, "downloads": -1, "filename": "mithermometer-0.1.3-py3-none-any.whl", "has_sig": false, "md5_digest": "bdc6c71ce87048ccfb28d276749623a8", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 16600, "upload_time": "2019-03-29T18:44:39", "url": "https://files.pythonhosted.org/packages/8c/20/8022d9bc04077ef22e3afdd837ff78c1502338e68902753b4b45ddaf3756/mithermometer-0.1.3-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "c306016108cfe3ff00e400a374d27a58", "sha256": "3ff3a3fca65c02ddd8ad2d0f4f24a6c560c158d5ea755d761ac5c9c2602d9ba0" }, "downloads": -1, "filename": "mithermometer-0.1.3.tar.gz", "has_sig": false, "md5_digest": "c306016108cfe3ff00e400a374d27a58", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 10332, "upload_time": "2019-03-29T18:44:42", "url": "https://files.pythonhosted.org/packages/52/f8/61ea0deb2081e825cad0f468be98c5463ae21a32ec62815a0091c70d4244/mithermometer-0.1.3.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "bdc6c71ce87048ccfb28d276749623a8", "sha256": "762ae2a8f706b6a72fe5d5aceb4f0d2bb047bc35a030d0cd36c582e6121d605f" }, "downloads": -1, "filename": "mithermometer-0.1.3-py3-none-any.whl", "has_sig": false, "md5_digest": "bdc6c71ce87048ccfb28d276749623a8", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 16600, "upload_time": "2019-03-29T18:44:39", "url": "https://files.pythonhosted.org/packages/8c/20/8022d9bc04077ef22e3afdd837ff78c1502338e68902753b4b45ddaf3756/mithermometer-0.1.3-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "c306016108cfe3ff00e400a374d27a58", "sha256": "3ff3a3fca65c02ddd8ad2d0f4f24a6c560c158d5ea755d761ac5c9c2602d9ba0" }, "downloads": -1, "filename": "mithermometer-0.1.3.tar.gz", "has_sig": false, "md5_digest": "c306016108cfe3ff00e400a374d27a58", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 10332, "upload_time": "2019-03-29T18:44:42", "url": "https://files.pythonhosted.org/packages/52/f8/61ea0deb2081e825cad0f468be98c5463ae21a32ec62815a0091c70d4244/mithermometer-0.1.3.tar.gz" } ] }