用于与Dingz设备交互的Python API
项目描述
Python API用于与Dingz设备交互。
本模块非官方,未由iolo AG或myStrom AG开发、支持或认可。有关问题和其它咨询,请使用此存储库的问题跟踪器。
没有iolo AG和myStrom AG的支持,创建此模块将会花费更长的时间,该模块是集成到Home Assistant的基础。这两家公司已经并提供硬件、宝贵的反馈和建议。他们的持续支持使本模块的进一步开发成为可能。
请参阅api.dingz.ch以获取API详情。
限制
目前此模块仅限于消费传感器数据、设备详情、设备配置和状态。可以控制前置LED,但按钮需要您自行编程。
不支持设置定时器和计划。
要求
您需要安装Python 3。
dingz设备
网络连接
连接到您网络的设备
您需要知道设备的IP地址。请查阅路由器文档以获取此信息或使用dingz CLI工具。
安装
该软件包可在Python包索引中找到。
$ pip install dingz
在基于Fedora的系统上或在已启用EPEL的CentOS/RHEL机器上。
$ sudo dnf -y install python3-dingz
模块使用
每个单元都有自己的网络界面: http://IP_ADDRESS。
有关模块的详细信息,请参阅 example.py。
如何操作调光器/调光开关
d = Dingz("ip_address_or_host")
# Fetch config, this has to be done once to fetch all details about the shades/dimmers
await d.get_devices_config()
# Fetch the current state of the lights/vers
await d.get_state()
# Get details about shade
shade_0 = d.shades.get(0)
print("Blinds: %s Lamella: %s" % (shade_0.current_blind_level(), shade_0.current_lamella_level()))
# Operate shade
shade_0.shade_down()
# Turn on light
d.dimmers.get(2).turn_on(brightness_pct=70)
CLI 使用方法
该软件包包含一个支持一些基本任务的命令行工具。
$ dingz discover
许可
python-dingz 依据 ASL 2.0 许可,更多详情请查看 LICENSE。
项目详情
下载文件
下载适用于您的平台的文件。如果您不确定该选择哪个,请了解更多关于 安装包 的信息。
源代码分发
dingz-0.5.0.tar.gz (16.6 kB 查看哈希值)
构建分发
dingz-0.5.0-py3-none-any.whl (18.1 kB 查看哈希值)
关闭
dingz-0.5.0.tar.gz 的哈希值
算法 | 哈希摘要 | |
---|---|---|
SHA256 | 6aeea86a1302be018b9f12eed4011ecf3cac9712c2c1e7f0fe1ceeab51aff067 |
|
MD5 | 7c263e25e5395ea347dfca323a384ced |
|
BLAKE2b-256 | de9d16d017e1b9f4d1318ffec7f23c5faed55229371c51935e8bf44173964663 |
关闭
dingz-0.5.0-py3-none-any.whl 的哈希值
算法 | 哈希摘要 | |
---|---|---|
SHA256 | 1f2c48c24c45243f83cb51f1b2b25f5ffac4a06af55de0c6de3d6f52209be3e4 |
|
MD5 | 89aff5bc778823c9dc155a5e68e943aa |
|
BLAKE2b-256 | 9ddf3e1db297f09e1bdea7655f05c8ea38eaa083af7ec57de4ac45b13533b7d1 |