Python API for accessing BleBox smart home devices
Project description
BleBox Python UniAPI
Python API for accessing BleBox smart home devices
Free software: Apache Software License 2.0
Documentation: https://blebox-uniapi.readthedocs.io.
Features
supports 11 BleBox smart home devices
contains functional/integration tests
every device supports at least minimum functionality for most common automation needs
insight of integration level are accesible from file box_types.py
(devices with apiLevel lower than defined in BOX_TYPE_CONF will not be supported but higher will)
Contributions are welcome!
Credits
History
2.4.2 (2024-06-04)
fix: add missing support for active power sensors on switchbox/switchboxd devices by @swistakm in https://github.com/blebox/blebox_uniapi/pull/175
2.4.1 (2024-06-04)
fix: rectify ambiguity around powerConsumption and wind sensor types
2.4.0 (2024-06-03)
Fix: Refactor sensor_factory by @Pastucha in https://github.com/blebox/blebox_uniapi/pull/163
Order in BOX_TYPES by @Pastucha in https://github.com/blebox/blebox_uniapi/pull/164
Feature: smart meter by @swistakm in https://github.com/blebox/blebox_uniapi/pull/168
Smartmeter by @pvsti in https://github.com/blebox/blebox_uniapi/pull/170
fix: resolve regressions in cover and climate due to jmespath introduction by @swistakm in https://github.com/blebox/blebox_uniapi/pull/173
2.3.0 (2024-03-13)
feat: add new methods to cover feature enabling handling of tilt open/close actions by @swistakm in https://github.com/blebox/blebox_uniapi/pull/154
add support for flood sensing for multisensors as binary moisture sensor by @swistakm in https://github.com/blebox/blebox_uniapi/pull/153
feat/fix: Add Ruff and Pre-commit Configuration, Resolve Undefined Name by @Pastucha in https://github.com/blebox/blebox_uniapi/pull/158
gatebox and shutterbox improvements: by @swistakm in https://github.com/blebox/blebox_uniapi/pull/156
BleBox Multisensor Illuminance Integration by @Pastucha in https://github.com/blebox/blebox_uniapi/pull/161
2.2.2 (2024-02-07)
fixed wind reading units to get proper raw m/s value (division by 10, see PR #150)
2.2.1 (2024-01-26)
fixed support for power measurement capabilities of switchBox and switchBoxD devices
2.2.0 (2023-08-29)
added last_reset to energy sensor class
added BasicAuth support to http client
2.1.4 (2023-01-03)
added tilt position support for
cover.Shutter
added
Wind
for wind sensor of multisensorsadded
Energy
sensor class for power consumption tracking- implementing
default_api_level
for dimmerBox
wLightBox
wLightBoxS
- implementing
2.1.3 (2022-10-27)
thermoBox boost mode doesn’t corrupt state
2.1.2 (2022-10-17)
fixed CCT, CCTx2 modes for wLightBox v1 & v2
2.1.1 (2022-10-11)
- added support for thermoBox devices:
added thermoBox config to
BOX_TYPE_CONFIG
Climate
uses factory method implementationadded test coverage
2.1.0 (2022-08-05)
- added support for multiSensor API:
airQuality
moved to sensor modulenew binary_sensor module, introducing
Rain
class
2.0.2 (2022-07-06)
added
query_string
property inButton
classfixed test assertions after changes in error raised ValueError
2.0.1 (2022-06-01)
used
ValueError
type instead ofBadOnValueError
in methods:evaluate_brightness_from_rgb
apply_brightness
normalise_elements_of_rgb
_set_last_on_value
async_on
2.0.0 (2022-06-21)
extended support for color modes in wLightBox devices
initial support for tvLiftBox device
major backward-incompatible architectural changes to enable dynamic configuration of devices
removed products.py module and replaced with factory method on Box class
general overhaul of public interfaces
1.3.3 (2021-05-12)
fix support for wLightBoxS with wLightBox API
fix state detection in gateBox
1.3.2 (2020-04-2)
use proper module-level logger by default
fix formatting
1.3.1 (2020-04-2)
never skip command requests
improve error messages
1.2.0 (2020-03-30)
expose device info
always add ip/port in connection errors
fixed gateController support
support for sauna min/max temp
1.1.0 (2020-03-24)
fix bad wLightBox API path
wrap api calls in semaphore (to serialize reqests to each box)
throttle updates to 2/second (to avoid unnecessary requests)
rework error handling and hierarchy (for cleaner usage)
use actual device name (to help recognize the device)
handle asyncio.TimeoutError (to handle timeout-related errors nicely)
properly re-raise exceptions (to avoid lengthy call stacktraces)
rename wLightBoxS feature to “brightness”
1.1.0 (2020-03-24)
fix switchBox support
fix minimum position handling
drop Python 3.6 support (still may work)
misc fixes, cleanup and increased test coverage
1.0.0 (2020-03-24)
Fixed wLightBox issues
Fixed wLightBoxS issues
Fixed shutterBox issues
Handle unknown shutterBox position
Improved error handling + lots of new diagnostics
Increased tests and test coverage (almost 100%)
Lots of rework
0.1.1 (2020-03-15)
Fixed switchBox support (newer API versions)
0.1.0 (2020-03-10)
First release on PyPI.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for blebox_uniapi-2.4.2-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 2d5594633f534552174d59df2dccfe3d6cc6b09b43ea94cec19fe117d54a5ed8 |
|
MD5 | 851e43843f28815a9f761eb3d5b9f4b5 |
|
BLAKE2b-256 | ad09713ad8bd3c99c7c7b0c55126e70a5332723c79e485adea26d81617aaac6e |