scy/fhz

访问ELV FHZ系列设备的库

0.2.0 2018-11-06 23:10 UTC

This package is auto-updated.

Last update: 2024-09-29 04:49:47 UTC


README

这是一个PHP包,用于访问FHZ 1000系列SRD860收发器,并解析来自传感器的消息。

至少目前是这样。功能限于作者当前的需求

  • 从Linux连接到FHZ 1000 PC(已在WSL上测试过)
  • 从几个HMS100T和HMS100TF传感器接收温度和湿度读数,并将它们作为PHP对象提供

安装

composer require scy/fhz 应该足够。如果您想尝试 示例脚本,请确保安装开发依赖项。Composer的最新版本会自动执行此操作,较旧的版本需要--dev开关。

使用方法

创建一个 new Connection,将FHZ连接到的串行设备的路径作为参数传递。您可以可选地提供一个PSR-3日志记录器作为第二个参数。

调用结果对象的 read($seconds) 将监听传入的传输并返回第一条传入的消息。如果在 $seconds(一个浮点数)后没有消息到达,该方法将返回 false。当您的 read() 没有运行时到达的消息将被操作系统的IO缓冲区缓冲,并在您下次调用 read() 时逐个返回。(该缓冲区是有限的,所以不要太过分。)

消息以 Message 对象或其子类返回。

目前,只实现了单个子类:TemperatureMessage。它代表HMS100T(温度)或HMS100TF(温度/湿度)传感器的单个读数。使用如 getTemperature() 之类的函数访问数据。

您还可以查看一些示例代码,这可能会更好地解释它。

状态

我目前正在将这个库集成到我的货车管理和日志接口中。API尚不稳定,但也不会变化太多。

文档、错误处理和代码结构需要一些改进。

元数据

这个库是免费软件,根据MIT许可证发布。它由Tim Weber编写和维护,其源代码托管在https://github.com/scy/php-fhz