开发者中心

传感器库

传感器库包含预定义的传感器和控制能力。传感器是设备可以测量某些数量的组成部分, 控制是设备设备可以被远程控制修改的组成部分。

传感器库逻辑上根据领域相关性分成相应的子包, 应用程序可以从不同域中自由选择。 能力名称遵从 Fragment 命名约定。这些能力可以根据相应的片段名称在Java包中找到Java表示。

环境能力

环境能力包括温度, 大气湿度, 风速等测量环境属性的传感器。

温度传感器

温度传感器报告温度, 单位摄氏度(C)。

托管对象表示

在托管对象中, 温度传感器表示为一个空片段:

"c8y_TemperatureSensor" : {}
                    
测量值
测量值 单位 描述
T C 测量的温度。
"c8y_TemperatureMeasurement": {
                      "T": { "value": 23, "unit": "C" }
                    }
                  
运动传感器

运动传感器检测运动。简单的运动传感器只是根据预定义阈值检测是否运动, 而复杂的运动传感器(如警用速度雷达) 可以测量运动的实际速度。模型只测量向前或向后的速度。这种传感器的单位是公里每小时(km/h)。

托管对象表示

在托管对象中, 运动传感器表示为一个空片段:

"c8y_MotionSensor" : {}
                  
测量值
测量值 单位 描述
motionDetected none 表示检测到(非零值)或未检测到(零)运动的布尔值。
speed km/h 测量到的接近(+ve)传感器或远离传感器(-ve)的速度。
"c8y_MotionMeasurement": {
                    "motionDetected": { "value": 1.0, "unit": "", "type": "BOOLEAN" },
                    "speed": { "value": -63.2, "unit": "km/h" }
                  }
                
加速度传感器

加速传感器, 或加速度计, 是测量沿轴方向加速度的设备。这种传感器模型不定义轴的方向。单位是米每秒每秒(m/s2)。

托管对象表示

在托管对象中, 加速度传感器表示为一个空片段:

"c8y_AccelerationSensor" : {}
                
测量值
测量值 单位 描述
acceleration m/s2 沿轴方向测量的加速度(此测量值不定义传感器轴方向)。
"c8y_AccelerationMeasurement": {
                  "acceleration": { "value": 8.36, "unit": "m/s2" }
                }
              
光线传感器

光线传感器测量光强。

托管对象表示

在托管对象中, 光线传感器表示为一个空片段:

"c8y_LightSensor" : {}
              
测量值

使用两种单位测量光: 辐射度由所有波长光功率测量组成, 而光度测量人类可以感知的波长。测光可用于量化旨在供人使用的照明。

测量值 单位 描述
e lux 光度测量值
"c8y_LightMeasurement": {
                "e": { "value": 8.36, "unit": "lux" }
              }
            
大气湿度传感器

大气湿度传感器测量空气中的水分。

托管对象表示

在托管对象中, 大气湿度传感器表示为一个空片段:

"c8y_HumiditySensor" : {}
            
测量值

主要有三种大气湿度测量值: 绝对湿度, 相对湿度和比湿度。绝对湿度是空气中的水含量, 用百分号表示, 测量当前绝对湿度相对最大湿度。比湿度是混合物的水蒸气含量与基于质量的总空气含量的比率。

测量值 单位 描述
h %RH 相对湿度测量值
"c8y_HumidityMeasurement" : {
              "h" : { "value" : 13.37, "unit": "%RH"}
            }
          
水分传感器

水分传感器测量物质中水含量。

托管对象表示

在托管对象中, 水分传感器表示为一个空片段:

"c8y_MoistureSensor" : {}
          
测量值

主要有三种水分测量值: 绝对水分, 相对水分和比水分。 绝对水分是物质的绝对含水量。 相对水分(以百分比表示)测量相对于该温度的最大值的当前绝对水分。

测量值 单位 描述
moisture % 相对水分测量值
"c8y_MoistureMeasurement" : {
            "moisture" : { "value" : 13.37, "unit" : "%" }
          }
        
距离传感器

距离传感器测量特定方向最近物体的距离。

托管对象表示

在托管对象, 距离传感器表示为一个空片段:

"c8y_DistanceSensor" : {}
        
测量值
测量值 单位 描述
distance mm 距离测量值
"c8y_DistanceMeasurement" : {
          "distance" : { "value" : 13.37, "unit" : "mm" }
        }
      

能量

电传感器

在最基本的水平上,电传感器(也称为电表, 瓦时计)测量能量消耗(通常以kWh测量), 然而, 它们可以根据其复杂性, 诸如"需用功率"或瞬时功率(通常以W计), 无功功率, 谐波失真等。仪表可以测量单相(典型只用于家庭使用)或三相。

托管对象表示 - 单相电表

在托管对象中, 单相电表表示为一个空片段:

"c8y_SinglePhaseElectricitySensor" : {}
      
测量值 - 单相电表
测量值 单位 描述
A+ kWh 总有功电能, 输入
A- kWh 总有功电能, 输出
P+ W 总有功功率, 输入
P- W 总有功功率, 输出
"c8y_SinglePhaseElectricityMeasurement": {
        "A+": { "value": 123, "unit": "kWh" },
        "A-": { "value": 2, "unit": "kWh" },
        "P+": { "value": 56, "unit": "W" },
        "P-": { "value": 0, "unit": "W" }
      }
    
托管对象表示 - 三相电表

在托管对象中, 三相电表表示为一个空片段:

"c8y_ThreePhaseElectricitySensor" : {}
    
测量值 - 三相电表
测量值 单位 描述
A+ kWh Total 总有功功率输入, 累计跨相
A+:1(2, 3) kWh 1,2或3相的有功电能
A- kWh 总有功功率输出, 相位相加
A-:1(2, 3) kWh 1, 2, 3相有功能量输出
P+ W 总有功功率, 相加总和
P+:1(2, 3) W 1, 2, 3相有功功率输入
P-:1(2, 3) W 1, 2, 3相有功功率输出
Ri+ kVArh 总无功电感能, 输入
Ri- kVArh 总无功电感能, 输出
Rc+ kVArh 总无功容性能量, 输入
Rc- kVArh 总无功容性能量, 输出
Qi+ kVAr 总无功电感功率, 输入
Qi- kVAr 总无功电感功率, 输出
Qc+ kVAr 总无功容性功率, 输入
Qc- kVAr 总无功容性功率, 输出
"c8y_ThreePhaseElectricityMeasurement": {
      "A+": { "value": 435, "unit": "kWh" },
      "A-": { "value": 23, "unit": "kWh" },
      "P+": { "value": 657, "unit": "W" },
      "P-": { "value": 0, "unit": "W" },
      "A+:1": { "value": 123, "unit": "kWh" },
      "A-:1": { "value": 2, "unit": "kWh" },
      "P+:1": { "value": 56, "unit": "W" },
      "P-:1": { "value": 0, "unit": "W" },
      "A+:2": { "value": 231, "unit": "kWh" },
      "A-:2": { "value": 23, "unit": "kWh" },
      "P+:2": { "value": 516, "unit": "W" },
      "P-:2": { "value": 2, "unit": "W" },  
      "A+:3": { "value": 1423, "unit": "kWh" },
      "A-:3": { "value": 422, "unit": "kWh" },
      "P+:3": { "value": 16, "unit": "W" },
      "P-:3": { "value": 9, "unit": "W" },
      "Ri+": { "value": 231, "unit": "kVArh" },
      "Ri-": { "value": 23, "unit": "kVArh" },
      "Rc+": { "value": 342, "unit": "kVArh" },
      "Rc-": { "value": 43, "unit": "kVArh" },
      "Qi+": { "value": 234, "unit": "kVAr" },
      "Qi-": { "value": 645, "unit": "kVAr" },
      "Qc+": { "value": 76, "unit": "kVAr" },
      "Qc-": { "value": 34, "unit": "kVAr" }
    }
  
电流传感器

电流传感器测量流过它的电流。

托管对象表示

在托管对象中, 三相电表表示为一个空片段:

"c8y_CurrentSensor" : {}
  
测量值
测量值 单位 描述
current A 电流测量值
"c8y_CurrentMeasurement" : {
    "current" : { "value" : 13.37, "unit" : "A" }
  }
电压传感器

电压传感器测量电路中两点之间的电压差。

测量值
测量值 单位 描述
voltage V 电压传感器
"c8y_VoltageMeasurement" : {
  "voltage" : { "value" : 13.37, "unit" : "V" }
}

位置能力

位置

c8y_Position 按纬度, 经度和高度报告资产的地理位置。 海拔高度以米为单位。 要报告资产或设备的当前位置,"c8y_Position"将添加到表示资产或设备的托管对象。 要跟踪资产或设备的位置, "c8y_Position"作为类型为"c8y_LocationUpdate"的事件的一部分发送。

"c8y_Position": {
  "alt": 67,
  "lng": 6.15173,
  "lat": 51.211977,
  "trackingProtocol" : "TELIC",
  "reportReason" : "Time Event"
}

属性"trackingProtocol"和"reportReason"由跟踪代理使用并描述定位报告的跟踪上下文: 为什么发送报告以及在哪个协议中。

通用能力

继电器控制

继电器是一种二进制状态开关, 可以处于"打开"或"关闭"状态。 继电器可以用于许多目的, 例如通过智能能量计连接或断开消耗电源。

托管对象表示

在托管对象中, 继电器控制模型包含控制状态。当控制状态改变时, 应当更新托管对象模型以包括新状态:

"c8y_Relay" :
  {
  "relayState" : "OPEN"
}
操作
操作 状态 描述
state OPEN, CLOSED OPEN打开继电器, CLOSED关闭继电器。

操作的表示和托管对象的表示一样:

"c8y_Relay" :
  {
  "relayState" : "OPEN"
}
控制和继电器阵列

c8y_RelayArray操作提供控制多个继电器的功能。

托管对象表示

在托管对象, 继电器阵列控制模型包括每个继电器的状态。当状态改变, 要更新为新状态:

"c8y_RelayArray" : [
  "OPEN",
  "CLOSED",
  "CLOSED",
  "OPEN"
  ]
操作

操作的表示和托管对象的表示一样:

"c8y_RelayArray" : [
  "OPEN",
  "CLOSED",
  "CLOSED",
  "OPEN"
  ]
移动设备信息

c8y_Mobile包含设备的移动连接状态信息(如蜂窝信息)和sim卡(如ICCID)。状态改变后设备的片段需要更新。 对于变化频率更高的移动信息(如信号强度)应该使用测量值。

托管对象表示
"c8y_Mobile" : {
  "imsi": "..."
  "imei": "..."
  "currentOperator": "..."
  "currentBand": "..."
  "connType": "..."
  "rssi": "..."
  "ecn0": "..."
  "rcsp": "..."
  "mnc": "..."
  "lac": "..."
  "cellId": "..."
  "msisdn": "..."
  "iccid": "..."
}
测量值
测量值 单位 描述
rssi dBm RSSI测量值
"c8y_SignalStrength": {
  "rssi": {
  "unit": "dBm",
  "value": -63
}
}