# 快速上手
# 开发流程
# 创建项目
- 登录 FogCloud 平台。
- 单击创建项目。
输入项目信息。
- 项目名称:项目的名称,在系统内具有唯一性,不能重复。支持中文、英文、日文、数字、中英文括号、其他字符(_、-、@、/、\)的组合,长度不超过 30 个字符。
- 厂商标识:由蓝牙技术联盟(Bluetooth SIG)分配给联盟成员的唯一编号。支持数字或英文。(Company Identifiers (opens new window))
- 项目描述:项目的备注信息,长度不超过 100 个字符。
单击确定即可创建新项目。
# 创建产品
进入项目的产品列表。
单击创建产品。
输入产品信息。
产品名称:产品的名称,在项目内具有唯一性,不能重复。支持中文、英文、日文、数字、中英文括号、其他字符(_、-、@、/、\)的组合,长度不超过 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 个字符。
单击确认即可创建产品。
# 添加功能
- 进入项目的产品列表
- 选择相应产品,单击查看。
- 选择功能定义,单击添加功能。
输入功能信息。
- 功能类型:选择功能类型。
- 功能名称:功能的名称,同类型功能的名称在产品内具有唯一性,不能重复。支持中文、英文、日文、数字、中英文括号、其他字符(_、-、@、/、\)的组合,长度不超过 30 个字符。
- 标识符:功能的标识符,对于产品具有唯一性,不能重复。支持英文、数字、下划线(_)的组合,长度不超过 50 个字符。不能使用的系统保留字:set、get、post、time、value。
配置功能参数。
属性:
数据类型:选择属性值的数据类型。点此查看功能参数说明 (opens new window)
读写类型:云端对属性值的读写权限类型,有如下 2 种类型:
- 读写:云端可以查询、修改属性值
- 只读:云端可以查询属性值
服务:
调用方式:云端对服务的调用方式,有如下 2 种类型:
- 异步:云端调用服务后直接返回结果(暂只支持异步调用方式)
- 同步:云端调用服务后等待设备回复,设备在规定时间内返回结果,否则调用超时
参数输入:定义服务的输入参数,每个服务不超过 20 个输入参数。点此查看功能参数说明 (opens new window)
参数输出:定义服务的输出参数,每个服务不超过 20 个输出参数。点此查看功能参数说明 (opens new window)
事件:
事件类型:定选择事件的类型,有如下 3 种类型:
- 信息:设备主动上报的普通信息
- 告警:设备发生异常状况时上报的信息
- 故障:设备出现故障时主动上报的信息
参数输出:定义事件的输出参数,每个服务不超过 50 个输出参数。点此查看功能参数说明 (opens new window)
输入功能描述。
- 描述:功能做简要描述,长度不超过 100 个字符。
单击确定即可添加功能。
# 添加设备
- 在左侧导航栏单击设备。
- 单击添加设备。
输入设备信息。
- 所属产品:选择设备的所属产品。
- 备注名称:为设备添加备注名称,支持中文、英文、日文、数字、中英文括号、其他字符(_、-、@、/、\)的组合,长度不超过 50 个字符。
单击确认即可添加单个设备。
# 调试设备
- 选择需要调试的设备,单击调试。
- 选择调试类型进行调试,调试类型分为属性调试或服务调用,说明如下:
调试类型 | 操作步骤 |
属性调试 |
|
服务调用 | 在下拉框中选择要调试的服务,然后在输入框中输入调用服务的输入参数(需为标准 JSON 格式),单击发送指令按钮。 |