跳转到主要内容

与Dingz设备交互的Python API

项目描述

Dingz设备交互的Python API。

此模块非官方,未由iolo AG或myStrom AG开发、支持或认可。有关问题和其它查询,请使用此存储库中的问题跟踪器。

没有iolo AG和myStrom AG的支持,创建此模块需要更长的时间,这是集成到Home Assistant的基础。这两家公司提供了硬件、宝贵的反馈和建议。他们的持续支持使此模块的进一步开发成为可能。

有关API详情,请参阅api.dingz.ch

限制

目前此模块仅限于消耗传感器数据、设备详情、设备配置和状态。前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)

命令行界面使用

该软件包包含一个命令行工具,支持一些基本任务。

$ dingz discover

许可证

python-dingz 基于 ASL 2.0 许可,更多详情请查看 LICENSE。

项目详情


下载文件

下载适用于您平台的文件。如果您不确定选择哪个,请了解更多关于 安装软件包 的信息。

源代码分发

python-dingz-0.4.0.tar.gz (16.6 kB 查看哈希值)

上传时间 源代码

构建分发

python_dingz-0.4.0-py3-none-any.whl (18.2 kB 查看哈希值)

上传时间 Python 3

由以下机构支持