Skip to main content

API设备接入

tip

所有类型的设备都可以通过 API 方式接入到 Neuron 平台。

1. 选择接入方式

设备管理列表页点击“添加”按钮,进入设备接入流程

device_list

接入方式选择 API,点击下一步

deviceAccess

2. 选择令牌

tip

使用API推送设备数据,需要在Neuron平台先申请令牌,根据提供的Demo算法,调用API接口完成设备接入。

选择已存在的令牌

选择所需的令牌后点击下一步,进入物模型的配置。

支持通过令牌名称快速检索,点击右侧红框处可以下载令牌文本。

api_add_device_token

新增令牌

点击新增令牌,进入新增界面,填写令牌名称(系统内不可重复)。

api_add_token_name

3. 配置物模型

tip

物模型定义:在 Neuron 平台内,将某一类具有相同能力或特征的设备的合集被称为一款物模型。详见【物模型管理

可以选择已存在的物模型或创建新的物模型

选择已存在的物模型

选择所需的物模型后点击下一步,进入设备注册页面。

支持通过物模型名称/类型/品牌快速检索。

api_checked_device_twins

新增物模型

点击新增物模型按钮,进入新增界面,填写物模型信息后,点击“提交”按钮创建物模型。

api_add_device_twins_name

注意:物模型名称不可重复,信息提交时系统会验证名称唯一性,名称重复则添加不成功。

配置Function Type (点)

创建物模型成功后,可直接进行该物模型下的 Function Type 配置。

点击图中所指的*“加号”按钮*,进入 Function Type 新增页。

lora_add_device_twins_functions

点击 Function type 输入框,选择/新增一个 Function type。其余配置说明详见【物模型管理

lora_adding_device_twins_functions

如该物模型有多个 Function Type 可重复上面步骤,添加多个 Function Type。配置完成后,点击下一步,进入设备注册页面。

api_added_device_twins_functions

4. 设备注册

支持两种录入方式:在线编辑下载 Excel 批量录入

设备绑定平台项目

注册设备前,请先选择设备所属的项目。点击项目下拉框选择现有项目。如尚未创建项目,请先新建一个,操作详见【创建项目】。

lora_add_device_binding_project

批量 Excel

操作步骤:下载模板 -> 填写 Excel -> 上传 Excel -> 如有错误则进行在线编辑 -> 点击下一步完成设备注册。

下载模板

在设备注册页,点击下图红框处,下载模板文件。

api_add_device_download_temp_iot

填写 Excel

将需要录入的设备信息填入 Excel。

lora_add_device_download_temp_csv

  • DevEUI:IoT 设备唯一标识,通常填写设备上的 DevEUI 即可,必填。
  • deviceName:设备名称,不可重复,必填。
  • buildingName:楼宇位置信息,必填。
  • location:设备位置,非必填。

上传 Excel

点击/拖拽下图红框处,将填写好的 Excel 上传至平台。上传的设备信息将会展示在在线表格中,如有错误可以继续增删改。

api_add_device_upload_temp_iot

在线编辑

在页面上填写设备信息,点击新增按钮添加新一行,继续录入设备信息。

lora_add_device_ui_add

设备信息填写完成后,点击提交按钮,出现确认窗口,确认后即可完成设备注册。

lora_add_device_submit_confirm

注册完成后会跳转到设备注册页,平台接收到规范的上报数据后,设备即接入成功。

api_add_device_submit_success_iot

设备注册成功后,可在设备管理界面查看设备信息及数据,具体操作详见【设备管理】。

API调用方法

完成设备注册后,需在您的系统内完成API调用,操作详见【Open API 指南】。

注意:设备注册成功表示已在 Neuron 平台登记,状态为已登记,但未接通实时数据。系统接收到上报的数据并清洗入库后,设备状态更新为已连接,并显示在设备列表中。

API代码示例下载

JAVA示例文件

Golang示例文件

.Net示例文件