日光热泵用易于使用的python通信模块
htheatpump的Python项目详细描述
高温热泵
heliotherm 热泵。- Github回购:https://github.com/dstrigl/htheatpump" rel="nofollow">https://github.com/dstrigl/htheatpump
- 文档:https://htheatpump.readthedocs.io rel="nofollow">https://htheatpump.readthedocs.io
- 自由软件:GNU通用公共许可证v3
简介
这个库提供了一个纯python接口来访问heliotherm 通过串行连接。它与python版本3.5、3.6和3.7兼容。
功能
-
读取热泵的制造商序列号
-
阅读热泵的软件版本
-
读写热泵的当前日期和时间
-
阅读热泵的故障列表
-
查询热泵是否有故障
-
热泵若干参数查询
-
更改热泵的参数值
-
MP数据点/参数的快速查询("网络在线")
-
读写热泵的时间程序
用 [*]
测试Heliotherm HP08S10W-WEB,软件3.0.20
Heliotherm HP10S12W-WEB,软件3.0.8
Heliotherm HP08E-K-BC,西南3.0.7B
Heliotherm HP05S07W-WEB、SW 3.0.17和SW 3.0.37
Heliotherm HP12L-M-BC,西南3.0.21
< COL/> < COL/> <正文> 感谢Kilian、Hans、Alois和Simon的贡献 <表>安装
您可以使用以下命令安装或升级htheatpump
$ pip install htheatpump --upgrade
或者您可以使用以下命令从源安装:
$ git clone https://github.com/dstrigl/htheatpump.git $cd htheatpump $ python setup.py install
入门
要在项目中使用htheatpump,请看下面的示例。建立连接后 利用太阳能热泵,人们可以通过不同的功能与之交互,比如读或写 参数。
fromhtheatpump.htheatpumpimportHtHeatpumphp=HtHeatpump("/dev/ttyUSB0",baudrate=9600)try:hp.open_connection()hp.login()# query for the outdoor temperaturetemp=hp.get_param("Temp. Aussen")print(temp)# ...finally:hp.logout()# try to logout for an ordinary cancellation (if possible)hp.close_connection()
有关支持的功能的完整列表,请参见 已阅读docs.io
日志记录
此库使用 日志记录模块。要将日志记录设置为标准输出,请输入
importlogginglogging.basicConfig(level=logging.DEBUG)
在脚本的开头。
免责声明
< div >警告
请注意,本模块的任何错误或粗心使用以及 执行中的错误可能会损坏您的热泵!
因此,作者不提供任何关于 正确性、功能性或性能,不承担任何责任 有关此模块、示例或上述信息造成的损坏。
因此,请自行承担风险!
贡献
捐款总是受欢迎的。请查看 贡献指南 开始吧。 您还可以通过报告错误来提供帮助。
学分
这个包是用cookiecutter和项目模板创建的。
历史记录
1.2.0(2019-06-10)
- 为htheatpump类添加了对python"with"语句的支持
- 添加了更多单元测试(特别是时间程序功能)
- 扩展示例脚本hthttp.py 以查询热泵的时间程序
- 添加了新的sample samples/httimeprog.py 以读取热泵的时间程序
- 添加了新的功能以写入/更改热泵的时间程序条目(请参见 htheatpump.set_time_prog… )
- 增加了读取热泵时间程序的新功能(请参见热泵时间程序…)
- 为静态类型检查添加了类型注释和提示(使用 mypy )
- 分离属性 htheatpump.verify_param 到 htheatpump.verify_param_action 以及热泵。确认参数错误
- 将exception重命名为verificationexception
- 增加了对Python3.7的支持
- 放弃了对Python3.4的支持
- 在 htparams.csv中添加了更多的热泵参数(数据点)
1.1.0(2019-02-23)
- 在 htparams.csv中添加了更多的热泵参数(数据点)
- 通过编写json/csv文件的可能性扩展示例脚本htfaultlist.py
- 添加了新的示例脚本 hthttp.py 和 htfastquery.py
- 修复了一些格式(flake8)错误
- 对htheatpump类的 login() 方法中重新连接的一些改进
- 已将 热泵的返回类型从 dict 更改为 list
- 增加了对Python3.6的支持
- 在 ~/.htheatpump/htparams.csv下添加了对用户特定参数定义文件的支持
- 扩展示例 htbackup.py 同时存储每个数据点的限制(最小值和最大值)
- 添加了一个方法来验证在高温热泵期间 htparams.csv 中的参数定义。get_param() , htheatpump.set_param() 或 htheatpump.query() ;这只是为了安全起见,以确保 htparams 中的参数定义是正确的(默认情况下禁用,但可以通过 设置属性 htheatpump.verify_param 到 true )
- 添加了新方法 htheatpump.fast_query() 以更快的方式检索"mp"数据点值("web在线")
- 扩展了htheatpump.login()方法来执行p如果需要,参数限制
1.0.0(2018-01-12)
- pypi上的第一个版本。