fellow-py
Huge thanks to emlove for paving the way on using Bleak in a library used in implementing a custom bluetooth component in HA. Any similarities my library may take to hers are not deliberate copying and pasting, but her library was an awesome example to follow and so my patterns were likely heavily influenced by her work.
Also huge thanks to u/bobobalooga on Reddit. They posted a fantastic breakdown of their discovery of how the Fellow kettle app talked to the kettle over BLE which enabled me to implement the logic in Python. Definitely standing on their shoulders here.
fellow-py is a library for controlling Fellow bluetooth devices (of which I am only aware of one at this time). So, more precisely speaking, it is a library for controlling their Stagg EKG+ Kettle.
This library currently supports connecting, turning on, setting the target temperature, turning off, and disconnecting. The library automatically subscribes to the 2a80 characteristic of the 1820 service on the kettle. The handler for the notifications the device sends to the connecting device will set the current and target temperature properties on the kettle object for the user to observe. The kettle object also implements a temperature graph that helps determine an average warming rate of the kettle. The purpose of this is to be able to identify if there's not enough water in the kettle. The library currently doesn't support device discovery, but it easily could in the near future. For now it simply implements a discover module that allows for obtaining a kettle given a mac address so as to instantiate the StaggEKGPlusKettle class.
Usage
import asyncio
import fellow
async def main()
kettle = fellow.StaggEKGPlusKettle("MA:CA:DD:RE:SS:01")
try:
await kettle.connect()
await kettle.turn_on()
await asyncio.sleep(5)
print(kettle.current_temperature, kettle.target_temperature)
await kettle.set_target_temperature(206)
await asyncio.sleep(2)
print(kettle.current_temperature, kettle.target_temperature)
await kettle.turn_off()
await kettle.disconnect()
if __name__ == "__main__":
loop = asyncio.get_event_loop()
loop.run_until_complete(main())
Tests coming soon :)
Metadata
Release files for fellow-py 0.2.3
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| fellow-py-0.2.3.tar.gz | 5.8 kB | Without provenance | Details for fellow-py-0.2.3.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| fellow_py-0.2.3-py3-none-any.whl | Python 3 | none | any | Details for fellow_py-0.2.3-py3-none-any.whl |
Total release size: 12.3 kB
Release files / fellow-py-0.2.3.tar.gz
| Download URL | fellow-py-0.2.3.tar.gz |
|---|---|
| Size | 5.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
34162d99927ef3a7e9c253cf679f839a9a3f1e8eb91611c1f5a1b5cd5349880f
|
|
BLAKE2b-256 checksum How to use checksums |
0ac323a7f617658889422a1ddc09bfe67f1fc3d3526e5d9cf5038f65011139aa
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/3.4.2 importlib_metadata/4.8.1 pkginfo/1.7.1 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/3.8.10
|
Release files / fellow_py-0.2.3-py3-none-any.whl
| Download URL | fellow_py-0.2.3-py3-none-any.whl |
|---|---|
| Size | 6.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
2cf34436df6c02000f8fe906881b59cf06047e0ed3434eee2fea67aff65d323a
|
|
BLAKE2b-256 checksum How to use checksums |
44d1ef824dd9da6c5ac7480243c9642b92f38d1ef193e0614fbd427e9fa56eeb
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/3.4.2 importlib_metadata/4.8.1 pkginfo/1.7.1 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/3.8.10
|
Security for fellow-py 0.2.3
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.