Domoticz API文档中三相电流传感器参数格式修正说明

问题背景

在Domoticz智能家居系统的API文档中，关于三相电流传感器的数据上报格式存在一个需要修正的技术细节。三相电流传感器是用于监测三相电力系统中各相电流值的设备，在工业自动化和智能家居电力监控中具有重要作用。

原始文档错误

根据用户反馈，Domoticz官方API文档中给出的三相电流传感器数据上报格式为：

/json.htm?type=command&param=udevice&idx=IDX&nvalue=0&svalue=Ampere_1;=Ampere_2;=Ampere_3;

这种格式在实际使用中无法正常工作，因为其中包含了多余的等号(=)字符。

正确的格式

经过实际测试验证，正确的数据上报格式应为：

/json.htm?type=command&param=udevice&idx=IDX&nvalue=0&svalue=Ampere_1;Ampere_2;Ampere_3;

技术解析

1. 参数结构：

   • type=command 表示这是一个命令请求
   • param=udevice 表示更新用户自定义设备
   • idx=IDX 是设备的唯一标识符
   • nvalue=0 表示数值类型（此处为0）
   • svalue 包含实际的传感器数据

2. 三相电流值格式：

   • 正确的格式是三个电流值之间用分号(;)分隔
   • 不需要在每个值前添加等号(=)
   • 顺序应为：A相电流;B相电流;C相电流

3. 数据单位：

   • 电流值应以安培(A)为单位
   • 可以支持小数格式，如12.5表示12.5安培

实际应用建议

开发者在实现三相电流监测功能时，应当注意以下几点：

1. 确保使用正确的参数分隔符
2. 按照A、B、C三相的顺序传递电流值
3. 数值精度应根据实际传感器能力合理设置
4. 建议在代码中加入参数格式验证逻辑

总结

Domoticz作为成熟的智能家居平台，其API设计通常具有良好的一致性。这次发现的文档错误可能是编辑过程中的笔误。开发者在使用API时，除了参考文档外，也应通过实际测试验证参数格式的正确性。对于三相电力监测这类重要功能，确保数据格式正确对系统稳定性和数据准确性都至关重要。