跳转到主要内容

用于与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 查看哈希值)

上传时间 Python 3

由以下机构支持