快捷導(dǎo)航

使用Python通過oBIX協(xié)議訪問Niagara數(shù)據(jù)的示例

更新時間：2020年12月04日 09:15:30 作者：IUpdatable

這篇文章主要介紹了使用Python通過oBIX協(xié)議訪問Niagara數(shù)據(jù)的示例，幫助大家更好的理解和學(xué)習(xí)python，感興趣的朋友可以了解下

oBIX 全稱是 Open Building Information Exchange，它是基于 RESTful Web Service 的接口的標(biāo)準(zhǔn)，用于構(gòu)建控制系統(tǒng)。oBIX是在專為樓宇自動化設(shè)計的框架內(nèi)，使用XML和URI在設(shè)備網(wǎng)絡(luò)上讀寫數(shù)據(jù)的。

因項目需要使用 Python 對 Niagara 軟件中的數(shù)據(jù)進(jìn)行讀寫和控制，所以寫了一個該協(xié)議的Python版本包，發(fā)布在這里：https://pypi.org/project/oBIX/

使用 pip 安裝使用即可：

pip install oBIX

本文主要介紹使用 Python 通過 oBIX 協(xié)議對 Niagara 軟件中的點進(jìn)行讀、寫操作。

一、準(zhǔn)備工作

1. 在 Niagara 軟件中配置好 oBIX 協(xié)議，確保已經(jīng)可以正常訪問；

（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 權(quán)限
2. Niagara 中新建一個數(shù)值類型的可讀寫的點，命名為：temp1，完整路徑是：/config/AHU/temp1/，后面以此為例進(jìn)行訪問

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，默認(rèn)：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)

四、高級應(yīng)用

4.1 讀取歷史數(shù)據(jù)

# 起始時間
  start_time = datetime.now(tz=timezone(timedelta(hours=8))) - timedelta(minutes=10)
  # 結(jié)束時間
  end_time = datetime.now(tz=timezone(timedelta(hours=8)))

  # 讀取該斷時間內(nèi)的歷史數(shù)據(jù)
  history = client.read_history("Station01", "OutDoorTemp", start_time, end_time)

  # 取起始時間往后指定個數(shù)的歷史數(shù)據(jù)
  limit_num = 1
  history = client.read_history("Station01", "OutDoorTemp", start_time=start_time, limit=limit_num)

4.2 讀取報警數(shù)據(jù)

# 起始時間
  start_time = datetime.now(tz=timezone(timedelta(hours=8))) - timedelta(minutes=10)
  # 結(jié)束時間
  end_time = datetime.now(tz=timezone(timedelta(hours=8)))

  # 讀取該段時間內(nèi)的報警數(shù)據(jù)
  alarms = client.read_alarms("Station01", "OutDoorTemp", start_time, end_time)

  # 取起始時間往后指定個數(shù)的報警數(shù)據(jù)
  limit_num = 1
  alarms = client.read_alarms("Station01", "OutDoorTemp", start_time=start_time, limit=limit_num)

4.3 監(jiān)控點的數(shù)據(jù)變化
監(jiān)控點的數(shù)據(jù)變化時 oBIX 協(xié)議的一部分。添加想要監(jiān)控的點，然后當(dāng) Niagara 中點的值發(fā)生變化后，會自動觸發(fā)相應(yīng)的函數(shù)。

from oBIX.common import Point, DataType
from oBIX import Client


def init_watch():
  global client, point_path
  # 添加監(jiān)控
  point_path_list = [point_path] # 這里可以是多個點
  result = client.add_watch_points(point_path_list)
  client.watch_changed_handler.on_change += on_watch_changed


# Niagara 里改點的值發(fā)生變化時，會自動觸發(fā)改函數(shù)
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，默認(rèn)：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 導(dǎo)出所有點的信息
如果一個項目中有大量的目錄和點，手動挨個去寫比較麻煩，所以這里提供了一個導(dǎo)出點信息的函數(shù)。將點的信息保存文件后，再直接從文件中讀取點的信息就會方便很多。

# 導(dǎo)出所有點的信息
export_result = client.export_points()

# folder_path [optional]: 想要導(dǎo)出的目錄，如： "/config/xxx/"，默認(rèn)會導(dǎo)出所有點的信息
# export_file_name [optional]: 導(dǎo)出文件的名稱，默認(rèn)： "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協(xié)議訪問Niagara數(shù)據(jù)的示例的詳細(xì)內(nèi)容，更多關(guān)于Python通過oBIX協(xié)議訪問Niagara數(shù)據(jù)的資料請關(guān)注腳本之家其它相關(guān)文章！

您可能感興趣的文章: