oBIX 全称是 Open Building Information Exchange,它是基于 RESTful Web Service 的接口的标准,用于构建控制系统。oBIX是在专为楼宇自动化设计的框架内,使用XML和URI在设备网络上读写数据的。
因项目需要使用 Python 对 Niagara 软件中的数据进行读写和控制,所以写了一个该协议的Python版本包,发布在这里:https://pypi.org/project/oBIX/
使用 pip 安装使用即可:
pip install oBIX
本文主要介绍使用 Python 通过 oBIX 协议对 Niagara 软件中的点进行读、写操作。
一、准备工作
1. 在 Niagara 软件中配置好 oBIX 协议,确保已经可以正常访问;
(1)Palette 搜 oBIX, 添加一个 ObixNetwork 到 Drivers中
(2)Palette 搜 baja, 将 AuthenticationSchemes/WebServicesSchemes/的 HTTPBasicScheme 拖拽到 Services/AuthenticationService/Authentication Schemes/
(3)UserServices 右键 View, AX User Manager下新建一个用户,配置如下:
* 用户名:oBIX
* 密码:oBIX.12345
* Authentication Schemes Name 选:HTTPBasicScheme
* Admin 权限
2. Niagara 中新建一个数值类型的可读写的点,命名为:temp1,完整路径是:/config/AHU/temp1/,后面以此为例进行访问
3. 安装python的oBIX包:pip install oBIX
二、快速开始
from oBIX.common import Point, DataType from oBIX import Client 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("point value is {0}".format(point_value))
三、基本实例
3.1 读取点
# 点的路径 point_path = "/config/AHU/temp1/" # 读取一个点的值 point_value = client.read_point_value(point_path) print("point value is {0}".format(point_value)) # 读取一个点实例 # 然后就能获取到这个点所包含的常用属性 # 例如:name, val, status, display, href, in1, in2 ... in16, fallback, out point_obj = client.read_point(point_path) print("name is {0}".format(point_obj.name)) print("fallback is {0}".format(point_obj.fallback)) print("in10 is {0}".format(point_obj.in10)) # 也可以使用下面代码直接获取 point_in10_value = client.read_point_slot(point_path, "in10") print("in10 is {0}".format(point_in10_value))
3.2 写入点
# 点的路径 point_path = "/config/AHU/temp1/" # set 一个点的值 client.write_point(point_path, 15.2, DataType.real) # set point auto client.set_point_auto(point_path, DataType.real) # override a point client.override_point(point_path, 14, DataType.real) # emergency override a point client.emergency_override_point(point_path, 15, DataType.real) # set a point emergency auto 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 中点的值发生变化后,会自动触发相应的函数。
from oBIX.common import Point, DataType from oBIX import Client def init_watch(): global client, 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 里改点的值发生变化时,会自动触发改函数 def on_watch_changed(points: [Point]): for point in points: 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() while True: 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数据的资料请关注其它相关文章!
《魔兽世界》大逃杀!60人新游玩模式《强袭风暴》3月21日上线
暴雪近日发布了《魔兽世界》10.2.6 更新内容,新游玩模式《强袭风暴》即将于3月21 日在亚服上线,届时玩家将前往阿拉希高地展开一场 60 人大逃杀对战。
艾泽拉斯的冒险者已经征服了艾泽拉斯的大地及遥远的彼岸。他们在对抗世界上最致命的敌人时展现出过人的手腕,并且成功阻止终结宇宙等级的威胁。当他们在为即将于《魔兽世界》资料片《地心之战》中来袭的萨拉塔斯势力做战斗准备时,他们还需要在熟悉的阿拉希高地面对一个全新的敌人──那就是彼此。在《巨龙崛起》10.2.6 更新的《强袭风暴》中,玩家将会进入一个全新的海盗主题大逃杀式限时活动,其中包含极高的风险和史诗级的奖励。
《强袭风暴》不是普通的战场,作为一个独立于主游戏之外的活动,玩家可以用大逃杀的风格来体验《魔兽世界》,不分职业、不分装备(除了你在赛局中捡到的),光是技巧和战略的强弱之分就能决定出谁才是能坚持到最后的赢家。本次活动将会开放单人和双人模式,玩家在加入海盗主题的预赛大厅区域前,可以从强袭风暴角色画面新增好友。游玩游戏将可以累计名望轨迹,《巨龙崛起》和《魔兽世界:巫妖王之怒 经典版》的玩家都可以获得奖励。
更新动态
- 凤飞飞《我们的主题曲》飞跃制作[正版原抓WAV+CUE]
- 刘嘉亮《亮情歌2》[WAV+CUE][1G]
- 红馆40·谭咏麟《歌者恋歌浓情30年演唱会》3CD[低速原抓WAV+CUE][1.8G]
- 刘纬武《睡眠宝宝竖琴童谣 吉卜力工作室 白噪音安抚》[320K/MP3][193.25MB]
- 【轻音乐】曼托凡尼乐团《精选辑》2CD.1998[FLAC+CUE整轨]
- 邝美云《心中有爱》1989年香港DMIJP版1MTO东芝首版[WAV+CUE]
- 群星《情叹-发烧女声DSD》天籁女声发烧碟[WAV+CUE]
- 刘纬武《睡眠宝宝竖琴童谣 吉卜力工作室 白噪音安抚》[FLAC/分轨][748.03MB]
- 理想混蛋《Origin Sessions》[320K/MP3][37.47MB]
- 公馆青少年《我其实一点都不酷》[320K/MP3][78.78MB]
- 群星《情叹-发烧男声DSD》最值得珍藏的完美男声[WAV+CUE]
- 群星《国韵飘香·贵妃醉酒HQCD黑胶王》2CD[WAV]
- 卫兰《DAUGHTER》【低速原抓WAV+CUE】
- 公馆青少年《我其实一点都不酷》[FLAC/分轨][398.22MB]
- ZWEI《迟暮的花 (Explicit)》[320K/MP3][57.16MB]