wireless-sensor


Namewireless-sensor JSON
Version 1.0.0 PyPI version JSON
download
home_pagehttps://github.com/fphammerle/wireless-sensor
SummaryReceive & decode signals of FT017TH thermo/hygrometers
upload_time2024-11-22 13:42:37
maintainerNone
docs_urlNone
authorFabian Peter Hammerle
requires_python>=3.9
licenseGPLv3+
keywords ft017th iot cc1101 climate decode home-automation humidity hygrometer raspberry-pi sensor thermometer wireless
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls. 
            # wireless-sensor 🌡

[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
[![CI Pipeline Status](https://github.com/fphammerle/wireless-sensor/workflows/tests/badge.svg)](https://github.com/fphammerle/wireless-sensor/actions)
![Coverage Status](https://ipfs.io/ipfs/QmP8k5H4MkfspFxQxdL2kEZ4QQWQjF8xwPYD35KvNH4CA6/20230429T090002+0200/s3.amazonaws.com/assets.coveralls.io/badges/coveralls_100.svg)
[![Last Release](https://img.shields.io/pypi/v/wireless-sensor.svg)](https://pypi.org/project/wireless-sensor/#history)
[![Compatible Python Versions](https://img.shields.io/pypi/pyversions/wireless-sensor.svg)](https://pypi.org/project/wireless-sensor/)
[![DOI](https://zenodo.org/badge/319298583.svg)](https://zenodo.org/badge/latestdoi/319298583)

Command-line tool & python library to receive & decode signals of FT017TH wireless thermo/hygrometers

## Requirements

* [FT017TH](https://github.com/fphammerle/FT017TH-wireless-thermometer-hygrometer-signal#product-details) sensor
* [CC1101 transceiver](https://www.ti.com/product/CC1101)
* Linux machine with CC1101 connected to SPI port & `GDO0` connected to some GPIO pin
  ([wiring instructions](https://github.com/fphammerle/python-cc1101#wiring-raspberry-pi)
  for raspberry pi)

## Setup

```sh
$ pip3 install --user --upgrade wireless-sensor
```

## Usage

### Command-line

```sh
$ wireless-sensor-receive
2020-12-07T10:40:16+0100 23.9°C 46.9%
2020-12-07T10:41:04+0100 23.9°C 46.9%
2020-12-07T10:42:01+0100 23.8°C 47.0%
```

### Python Library

```python
import asyncio

import wireless_sensor

async def _main():
    sensor = wireless_sensor.FT017TH(gdo0_gpio_line_name=b'GPIO24')
    async for measurement in sensor.receive(timeout_seconds=600):
        print(
            measurement.decoding_timestamp,
            measurement.temperature_degrees_celsius,
            measurement.relative_humidity,
        )

asyncio.run(_main())
```

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/fphammerle/wireless-sensor",
    "name": "wireless-sensor",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.9",
    "maintainer_email": null,
    "keywords": "FT017TH, IoT, cc1101, climate, decode, home-automation, humidity, hygrometer, raspberry-pi, sensor, thermometer, wireless",
    "author": "Fabian Peter Hammerle",
    "author_email": "fabian@hammerle.me",
    "download_url": "https://files.pythonhosted.org/packages/36/75/3728398bf0a2713503fe54aeb14935b081f2726132862aa7b356be2a5771/wireless-sensor-1.0.0.tar.gz",
    "platform": null,
    "description": "# wireless-sensor \ud83c\udf21\n\n[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)\n[![CI Pipeline Status](https://github.com/fphammerle/wireless-sensor/workflows/tests/badge.svg)](https://github.com/fphammerle/wireless-sensor/actions)\n![Coverage Status](https://ipfs.io/ipfs/QmP8k5H4MkfspFxQxdL2kEZ4QQWQjF8xwPYD35KvNH4CA6/20230429T090002+0200/s3.amazonaws.com/assets.coveralls.io/badges/coveralls_100.svg)\n[![Last Release](https://img.shields.io/pypi/v/wireless-sensor.svg)](https://pypi.org/project/wireless-sensor/#history)\n[![Compatible Python Versions](https://img.shields.io/pypi/pyversions/wireless-sensor.svg)](https://pypi.org/project/wireless-sensor/)\n[![DOI](https://zenodo.org/badge/319298583.svg)](https://zenodo.org/badge/latestdoi/319298583)\n\nCommand-line tool & python library to receive & decode signals of FT017TH wireless thermo/hygrometers\n\n## Requirements\n\n* [FT017TH](https://github.com/fphammerle/FT017TH-wireless-thermometer-hygrometer-signal#product-details) sensor\n* [CC1101 transceiver](https://www.ti.com/product/CC1101)\n* Linux machine with CC1101 connected to SPI port & `GDO0` connected to some GPIO pin\n  ([wiring instructions](https://github.com/fphammerle/python-cc1101#wiring-raspberry-pi)\n  for raspberry pi)\n\n## Setup\n\n```sh\n$ pip3 install --user --upgrade wireless-sensor\n```\n\n## Usage\n\n### Command-line\n\n```sh\n$ wireless-sensor-receive\n2020-12-07T10:40:16+0100 23.9\u00b0C 46.9%\n2020-12-07T10:41:04+0100 23.9\u00b0C 46.9%\n2020-12-07T10:42:01+0100 23.8\u00b0C 47.0%\n```\n\n### Python Library\n\n```python\nimport asyncio\n\nimport wireless_sensor\n\nasync def _main():\n    sensor = wireless_sensor.FT017TH(gdo0_gpio_line_name=b'GPIO24')\n    async for measurement in sensor.receive(timeout_seconds=600):\n        print(\n            measurement.decoding_timestamp,\n            measurement.temperature_degrees_celsius,\n            measurement.relative_humidity,\n        )\n\nasyncio.run(_main())\n```\n",
    "bugtrack_url": null,
    "license": "GPLv3+",
    "summary": "Receive & decode signals of FT017TH thermo/hygrometers",
    "version": "1.0.0",
    "project_urls": {
        "Changelog": "https://github.com/fphammerle/wireless-sensor/blob/master/CHANGELOG.md",
        "Homepage": "https://github.com/fphammerle/wireless-sensor"
    },
    "split_keywords": [
        "ft017th",
        " iot",
        " cc1101",
        " climate",
        " decode",
        " home-automation",
        " humidity",
        " hygrometer",
        " raspberry-pi",
        " sensor",
        " thermometer",
        " wireless"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "deba212bda84b0570939d549f073af9cc5b8e0591f241421cb4d924d5c558ccc",
                "md5": "662beef088af659c10f8e233365b643b",
                "sha256": "b3367a5977eba7fd15e7b8b9d2b6fe7b07fa79f07c9e9612674604e12d5577ab"
            },
            "downloads": -1,
            "filename": "wireless_sensor-1.0.0-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "662beef088af659c10f8e233365b643b",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.9",
            "size": 19420,
            "upload_time": "2024-11-22T13:42:35",
            "upload_time_iso_8601": "2024-11-22T13:42:35.741268Z",
            "url": "https://files.pythonhosted.org/packages/de/ba/212bda84b0570939d549f073af9cc5b8e0591f241421cb4d924d5c558ccc/wireless_sensor-1.0.0-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "36753728398bf0a2713503fe54aeb14935b081f2726132862aa7b356be2a5771",
                "md5": "660bd3c016ee02219f43d7bafecd797d",
                "sha256": "232b9d56a766fe8d665da13104bf88437ce98d9e996270f675b2e16956d9fd68"
            },
            "downloads": -1,
            "filename": "wireless-sensor-1.0.0.tar.gz",
            "has_sig": false,
            "md5_digest": "660bd3c016ee02219f43d7bafecd797d",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.9",
            "size": 35494,
            "upload_time": "2024-11-22T13:42:37",
            "upload_time_iso_8601": "2024-11-22T13:42:37.271082Z",
            "url": "https://files.pythonhosted.org/packages/36/75/3728398bf0a2713503fe54aeb14935b081f2726132862aa7b356be2a5771/wireless-sensor-1.0.0.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-11-22 13:42:37",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "fphammerle",
    "github_project": "wireless-sensor",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "lcname": "wireless-sensor"
}
Fabian Peter Hammerle
Elapsed time: 0.41153s