On this page

• 1.设备服务
• 2.设备配置文件
• 3.设备资源
• 4.资源属性（Attributes）
• 5.资源属性（Properties）
• 6.设备命令
• 7.资源操作
• 8.REST 命令端点
• 9.推送事件

1.设备服务

设备服务是与传感器/设备或物联网对象(“物”)交互的边缘连接器，其中包括机器、机器人、无人机、HVAC 设备、相机等。通过利用可用的连接器，可以控制设备并/或传输数据至 EdgeX 或从其传输数据。您还可以使用设备服务 SDK 来创建您自己的 EdgeX 设备服务。

设备配置文件描述了EdgeX 系统内的一种设备类型。设备服务管理的每个设备都与设备配置文件关联，设备配置文件根据其支持的操作定义该设备类型。

通常，设备配置文件由设备服务从文件加载，并在首次启动时推送到核心元数据进行存储。一旦存储在核心元数据中，设备配置文件就会在后续启动时从核心元数据加载。

2.设备配置文件

设备配置文件由以下字段组成

DeviceProfile定义了设备的值和操作方法，可以是Read或Write。

创建名为 的设备配置文件my.custom.device.profile.yml，其中包含以下内容：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
name: "my-custom-device-profile"
manufacturer: "iot"
model: "MQTT-DEVICE"
description: "Test device profile"
labels:
  - "mqtt"
  - "test"
deviceResources:
  -
    name: randnum
    isHidden: true
    description: "device random number"
    properties:
      valueType: "Float32"
      readWrite: "R"
  -
    name: ping
    isHidden: true
    description: "device awake"
    properties:
      valueType: "String"
      readWrite: "R"
  -
    name: message
    isHidden: false
    description: "device message"
    properties:
      valueType: "String"
      readWrite: "RW"
  -
    name: json
    isHidden: false
    description: "JSON message"
    properties:
      valueType: "Object"
      readWrite: "RW"
      mediaType: "application/json"

deviceCommands:
  -
    name: values
    readWrite: "R"
    isHidden: false
    resourceOperations:
        - { deviceResource: "randnum" }
        - { deviceResource: "ping" }
        - { deviceResource: "message" }

3.设备资源

设备资源指定设备内的传感器值，可以单独或作为设备命令的一部分读取或写入该值。它具有用于识别的名称和用于提供信息的描述。

设备资源由以下字段组成：

The device resource consists of the following fields:

4.资源属性（Attributes）

设备资源中的attributes参数是访问设备上的特定值所需的设备服务特定参数。每个设备服务实现都有自己的一组所需的命名值，例如，BACnet 设备服务可能需要对象标识符和属性标识符，而蓝牙设备服务可以使用 UUID 来标识值。

设备 ONVIF 摄像头的资源属性示例

1
2
3
4
    attributes:
      service: "Device"
      getFunction: "GetDNS"
      setFunction: "SetDNS"

5.资源属性（Properties）

设备资源properties的 描述了值以及要对其执行的可选简单处理。

资源属性由以下字段组成：

The resource properties consists of the following fields:

6.设备命令

设备命令定义同时访问多个资源。每个命名设备命令应包含多个resource operations.具有单个资源操作的设备命令不会比 SDK 为同一设备资源创建的隐式设备命令增加任何值。

当读数在逻辑上相关时，设备命令可能很有用，例如，对于 3 轴加速度计，一起读取所有轴会很有帮助。

每个设备命令由以下字段组成：

Each device command consists of the following fields:

7.资源操作

资源操作由以下字段组成：

A resource operation consists of the following fields:

8.REST 命令端点

命令端点是在服务上为设备配置文件中指定的每个设备资源和每个设备命令隐式创建的。有关更多详细信息，请参阅设备服务 API 参考中的 GET 和 SET 设备命令 API 。

9.推送事件

SDK 应实现除了收到设备 GET 请求之外生成事件的方法。 AutoEvent 机制提供以固定时间间隔生成事件的功能。异步事件队列使设备服务能够根据特定于实现的逻辑在任意时间生成事件。

自动事件

AutoEvents每个设备可以具有与其关联的多个元数据作为其定义的一部分。 AnAutoEvent具有以下字段：

• resource：deviceResource 或 deviceCommand 的名称，指示要读取的内容。
• Frequency：一个字符串，表示读取事件之间等待的时间，表示为整数后跟 ms、s、m 或 h 单位。
• onchange：布尔值：如果设置为 true，则仅当自上次事件以来包含的一个或多个读数发生更改时才生成新事件。

设备 SDK 应根据这些AutoEvent定义从实现中安排设备读取。它应该使用与通过 REST 请求读数时相同的逻辑。

异步事件队列

SDK 应提供一种机制，使实现可以随时提交设备读数而不会阻塞。这可以以适合于实现语言的方式来完成，例如，Go SDK提供可以在其上推送读数的通道，C SDK提供将读数提交到工作队列的功能。