使用Python通过oBIX协议访问Niagara数据的示例
oBIX全称是OpenBuildingInformationExchange，它是基于RESTfulWebService的接口的标准，用于构建控制系统。oBIX是在专为楼宇自动化设计的框架内，使用XML和URI在设备网络上读写数据的。
因项目需要使用Python对Niagara软件中的数据进行读写和控制，所以写了一个该协议的Python版本包，发布在这里：https://pypi.org/project/oBIX/
使用pip安装使用即可：
pipinstalloBIX
本文主要介绍使用Python通过oBIX协议对Niagara软件中的点进行读、写操作。
一、准备工作
1.在Niagara软件中配置好oBIX协议，确保已经可以正常访问；
（1）Palette搜oBIX,添加一个ObixNetwork到Drivers中
（2）Palette搜baja,将AuthenticationSchemes/WebServicesSchemes/的HTTPBasicScheme拖拽到Services/AuthenticationService/AuthenticationSchemes/
（3）UserServices右键View,AXUserManager下新建一个用户，配置如下：
*用户名：oBIX
*密码：oBIX.12345
*AuthenticationSchemesName选：HTTPBasicScheme
*Admin权限
2.Niagara中新建一个数值类型的可读写的点，命名为：temp1，完整路径是：/config/AHU/temp1/，后面以此为例进行访问
3.安装python的oBIX包：pipinstalloBIX
二、快速开始
fromoBIX.commonimportPoint,DataType
fromoBIXimportClient
if__name__=='__main__':
#ip,userName,password
#可选项:
#port:端口号，如：8080
#https:是否使用https，默认：True
client=Client("127.0.0.1","oBIX","oBIX.12345")
#点的路径
point_path="/config/AHU/temp1/"
#读取一个点的值
point_value=client.read_point_value(point_path)
print("pointvalueis{0}".format(point_value))
三、基本实例
3.1读取点
#点的路径
point_path="/config/AHU/temp1/"
#读取一个点的值
point_value=client.read_point_value(point_path)
print("pointvalueis{0}".format(point_value))
#读取一个点实例
#然后就能获取到这个点所包含的常用属性
#例如：name,val,status,display,href,in1,in2...in16,fallback,out
point_obj=client.read_point(point_path)
print("nameis{0}".format(point_obj.name))
print("fallbackis{0}".format(point_obj.fallback))
print("in10is{0}".format(point_obj.in10))
#也可以使用下面代码直接获取
point_in10_value=client.read_point_slot(point_path,"in10")
print("in10is{0}".format(point_in10_value))
3.2写入点
#点的路径 point_path="/config/AHU/temp1/" #set一个点的值 client.write_point(point_path,15.2,DataType.real) #setpointauto client.set_point_auto(point_path,DataType.real) #overrideapoint client.override_point(point_path,14,DataType.real) #emergencyoverrideapoint client.emergency_override_point(point_path,15,DataType.real) #setapointemergencyauto client.set_point_emergency_auto(point_path,DataType.real)
四、高级应用
4.1读取历史数据
#起始时间
start_time=datetime.now(tz=timezone(timedelta(hours=8)))-timedelta(minutes=10)
#结束时间
end_time=datetime.now(tz=timezone(timedelta(hours=8)))
#读取该断时间内的历史数据
history=client.read_history("Station01","OutDoorTemp",start_time,end_time)
#取起始时间往后指定个数的历史数据
limit_num=1
history=client.read_history("Station01","OutDoorTemp",start_time=start_time,limit=limit_num)
4.2读取报警数据
#起始时间
start_time=datetime.now(tz=timezone(timedelta(hours=8)))-timedelta(minutes=10)
#结束时间
end_time=datetime.now(tz=timezone(timedelta(hours=8)))
#读取该段时间内的报警数据
alarms=client.read_alarms("Station01","OutDoorTemp",start_time,end_time)
#取起始时间往后指定个数的报警数据
limit_num=1
alarms=client.read_alarms("Station01","OutDoorTemp",start_time=start_time,limit=limit_num)
4.3监控点的数据变化
监控点的数据变化时oBIX协议的一部分。添加想要监控的点，然后当Niagara中点的值发生变化后，会自动触发相应的函数。
fromoBIX.commonimportPoint,DataType
fromoBIXimportClient
definit_watch():
globalclient,point_path
#添加监控
point_path_list=[point_path]#这里可以是多个点
result=client.add_watch_points(point_path_list)
client.watch_changed_handler.on_change+=on_watch_changed
#Niagara里改点的值发生变化时，会自动触发改函数
defon_watch_changed(points:[Point]):
forpointinpoints:
val=point.val
print(f"on_watch_changed:{val}")
if__name__=='__main__':
#ip,userName,password
#可选项:
#port:端口号，如：8080
#https:是否使用https，默认：True
client=Client("127.0.0.1","oBIX","oBIX.12345")
#点的路径
point_path="/config/AHU/temp1/"
init_watch()
client.start_watch()
whileTrue:
i=0
4.4导出所有点的信息
如果一个项目中有大量的目录和点，手动挨个去写比较麻烦，所以这里提供了一个导出点信息的函数。将点的信息保存文件后，再直接从文件中读取点的信息就会方便很多。
#导出所有点的信息 export_result=client.export_points() #folder_path[optional]:想要导出的目录，如："/config/xxx/"，默认会导出所有点的信息 #export_file_name[optional]:导出文件的名称，默认："all_points.json" #export_type[optional]: #0:JSON格式，嵌套格式并保留目录信息 #1:JSON格式,只保留点的信息，不保留目录信息 #2:字符串列表格式,只输出点的路径信息 export_result=client.export_points(folder_path="/config/AHU/",export_file_name="output.json",export_type=1)
以上就是使用Python通过oBIX协议访问Niagara数据的示例的详细内容，更多关于Python通过oBIX协议访问Niagara数据的资料请关注毛票票其它相关文章！