# 快速上手

# 开发流程

# 创建项目

  1. 登录 FogCloud 平台。
  2. 单击创建项目

  1. 输入项目信息。

    • 项目名称项目的名称,在系统内具有唯一性,不能重复。支持中文、英文、日文、数字、中英文括号、其他字符(_、-、@、/、\)的组合,长度不超过 30 个字符。
    • 厂商标识由蓝牙技术联盟(Bluetooth SIG)分配给联盟成员的唯一编号。支持数字或英文。Company Identifiers (opens new window)
    • 项目描述项目的备注信息,长度不超过 100 个字符。
  2. 单击确定即可创建新项目。

# 创建产品

  1. 进入项目的产品列表。

  2. 单击创建产品

  3. 输入产品信息。

    • 产品名称:产品的名称,在项目内具有唯一性,不能重复。支持中文、英文、日文、数字、中英文括号、其他字符(_、-、@、/、\)的组合,长度不超过 50 个字符。

    • 产品图片:产品的图片。图片尺寸必须为 400*400px,图片格式必须为 png 或 jpg。

    • 节点类型:设备的类型,有如下 3 种类型:

      • 直连设备:可直接接入平台的设备,不能挂载子设备。
      • 网关设备:可直接接入平台且能挂载子设备的设备。支持子设备拓扑关系管理和云端同步。
      • 网关子设备:必须通过挂载到网关设备上接入物联网平台的设备。支持网关信息查询。
    • 连接方式:

      • 若节点类型为直连设备,在此选择设备连网方式,有如下 4 种方式:

        • WiFi
        • 以太网
        • 蜂窝(2G/3G/4G/5G)
        • LoRaWAN
      • 节点类型为网关设备,在此选择设备连网方式,有如下 5 种方式:

        • WiFi
        • 以太网
        • 蜂窝(2G/3G/4G/5G)
        • LoRaWAN
        • Wi-Fi+BLE-Mesh
    • 接入网关协议:若节点类型为网关子设备,在此选择子设备与网关设备的通讯协议类型,有如下 2 种类型:

      • ZigBee
      • BLE
      • BLE-Mesh
    • 数据格式:设备上下行的数据格式,有如下 2 种格式:

      • JSON
      • 透传/自定义
    • 认证方式:设备接入平台时的鉴权认证方式,暂有如下 1 种方式:

      • 三元组密钥认证
    • 产品描述:产品的备注信息,长度不超过 100 个字符。

  4. 单击确认即可创建产品。

# 添加功能

  1. 进入项目的产品列表
  2. 选择相应产品,单击查看

  1. 选择功能定义,单击添加功能

  1. 输入功能信息。

    • 功能类型:选择功能类型。
    • 功能名称:功能的名称,同类型功能的名称在产品内具有唯一性,不能重复。支持中文、英文、日文、数字、中英文括号、其他字符(_、-、@、/、\)的组合,长度不超过 30 个字符。
    • 标识符:功能的标识符,对于产品具有唯一性,不能重复。支持英文、数字、下划线(_)的组合,长度不超过 50 个字符。不能使用的系统保留字:set、get、post、time、value。
  2. 配置功能参数。

    1. 属性:

      • 数据类型:选择属性值的数据类型。点此查看功能参数说明 (opens new window)

      • 读写类型:云端对属性值的读写权限类型,有如下 2 种类型:

        • 读写:云端可以查询、修改属性值
        • 只读:云端可以查询属性值
    2. 服务:

      • 调用方式:云端对服务的调用方式,有如下 2 种类型:

        • 异步:云端调用服务后直接返回结果(暂只支持异步调用方式)
        • 同步:云端调用服务后等待设备回复,设备在规定时间内返回结果,否则调用超时
      • 参数输入:定义服务的输入参数,每个服务不超过 20 个输入参数。点此查看功能参数说明 (opens new window)

      • 参数输出:定义服务的输出参数,每个服务不超过 20 个输出参数。点此查看功能参数说明 (opens new window)

    3. 事件:

      • 事件类型:定选择事件的类型,有如下 3 种类型:

        • 信息:设备主动上报的普通信息
        • 告警:设备发生异常状况时上报的信息
        • 故障:设备出现故障时主动上报的信息
      • 参数输出:定义事件的输出参数,每个服务不超过 50 个输出参数。点此查看功能参数说明 (opens new window)

  3. 输入功能描述。

    • 描述:功能做简要描述,长度不超过 100 个字符。
  4. 单击确定即可添加功能。

# 添加设备

  1. 在左侧导航栏单击设备
  2. 单击添加设备

  1. 输入设备信息。

    • 所属产品:选择设备的所属产品。
    • 备注名称:为设备添加备注名称,支持中文、英文、日文、数字、中英文括号、其他字符(_、-、@、/、\)的组合,长度不超过 50 个字符。
  2. 单击确认即可添加单个设备。

# 调试设备

  1. 选择需要调试的设备,单击调试

  1. 选择调试类型进行调试,调试类型分为属性调试服务调用,说明如下:

调试类型

操作步骤

属性调试

  • 获取:单击获取按钮,属性输入框中将显示从设备端获取的最新属性值,若设备端没有该属性值,则输入框为空。
  • 设置:在属性输入框中输入属性值,单击设置按钮,输入的属性值将下发到设备端,在线设备接收并处理属性值。

服务调用

在下拉框中选择要调试的服务,然后在输入框中输入调用服务的输入参数(需为标准 JSON 格式),单击发送指令按钮。

更新时间: 2022/6/9 下午5:42:23