TOC

  1. Intro
  2. TagModel
  3. Structure
  4. TimeZones
  5. Units
    1. 概述
    2. 单位系统
    3. 数据库
    4. 常用单位
      1. 杂项
      2. 面积
      3. 货币
      4. 能源
      5. 功率
      6. 压力
      7. 温度
      8. 温差
      9. 时间
      10. 体积流量
  6. Grids
  7. Filters
  8. Zinc
  9. Json
  10. Trio
  11. Csv
  12. Rest
  13. Ops
  14. Auth
  15. VFDs
  16. Networks
  17. Energy
  18. Zones
  19. AHUs
  20. VAVs
  21. UnitaryEquips
  22. Chillers
  23. Boilers
  24. Tanks
  25. ElecPanels
  26. Lighting
  27. Builds
  28. Bacnet
  29. ChangeLog
  30. License

Units

概述

所有数字标签值都可以用一个可单位进行标注。此外,需要使用 unit 标签对每个数字 point 进行标注。在这两种情况下,单位必须是由标准单位数据库定义的标识符。

单位系统

作为一般原则,与给定站点相关联的所有数据应仅使用SI(国际单位制)度量系统或美国习惯系统(美式英制单位)。在同一个站点内混合使用不同的度量系统会引发很多麻烦。

数据库

Project Haystack 使用的单位数据由 Fantom 开源社区管理,作为 sys::Unit API的一部分。该数据库最初基于 oBIX,但是已经被扩展到允许每个单位使用多个别名。

每个测量单位都有全名,以及零个或多个符号,这些符号作为该单位的别名。例如,“square_meter”是全名,符号别名是“m²”。某些单位可能有多个符号,例如“hour”有符号“hr”和“h”。有些单位如“day”没有符号。

所有单位标识符仅限于以下字符:

按照惯例,符号是首选的单位表示方法。如果有多个符号,则将单位数据库中定义的最后一个作为首选符号。

常用单位

以下是一些常用的单位。您可以从 Downloads 或从 Fantom 网站下载完整的数据库。

杂项

percent, %(百分比)

面积

square_meter, m²(平方米)
square_foot, ft²(平方英尺)

货币

australian_dollar, AUD(澳元)
british_pound, GBP, £(英镑)
canadian_dollar, CAD(加拿大元)
chinese_yuan, CNY, 元
euro, EUR, €(欧元)
us_dollar, USD, $(美元)

能源

kilowatt_hour, kWh(千瓦时)

功率

kilowatt, kW(千瓦)

压力

kilopascal, kPa(千帕)
pounds_per_square_inch, psi(磅/平方英寸)
inches_of_water, inH₂O(英寸水柱)
inches_of_mercury, inHg(英寸汞柱)

温度

fahrenheit, °F(华氏度)
celsius, °C(摄氏度)

温差

fahrenheit_degrees, Δ°F(华氏度)
celsius_degrees, Δ°C(摄氏度)

时间

millisecond, ms(毫秒)
second, sec(秒)
minute, min(分钟)
hour, hr, h(小时)
day(天)
week, wk(周)
julian_month, mo(朱利安月)
year, yr(年)

体积流量

liters_per_second, L/s(升/秒)
cubic_feet_per_minute, cfm(立方英尺每分钟)