1      准备资源

1.1      开发环境

Visual Studio2017：官网下载

1.2      工具包

工具包包括两个文件，分别为：

·         网关设备配置信息：gwreginfo.json

·         平台南向设备对接证书conf文件夹下，有rootcert.pem

1.3      Demo资源

·         Agent Lite Demo：AgentLite Windows C Demo

·         网关profile文件：Gateway_Huawei_AgentLite01.zip

·         子设备profile文件：Motion_Huawei_test01.zip

2      SP Portal创建应用

注意：SP Portal的端口一般为8843

若使用开发者Portal（端口一般为8093），则下发资源时已由系统创建好应用，可以忽略此步骤。

 在调用OceanConnect平台开放的接口前，需要先登录OceanConnect平台的SP Portal界面，创建平台上的应用映射。

2.1      登录SP Portal

SP Portal登录地址：https://IP:8843（如：https://100.xx.xx.xxx:8843）。使用IoT平台资源邮件中的“平台Portal链接”和“登录账号/密码”信息登录SP Portal。

2.2      创建App

1.   进入SP Portal界面，点击“开始“

2.   创建应用

3.   进入到应用管理界面，开发者根据实际情况自行填写和选择配置。

·         应用名称：可以为字母、数字或其组合（如Apptest001）。不能与平台中已有的应用名称重复。

·         所属行业：应用的行业信息。在下拉框中选择即可。

·         消息跟踪数据授权：自行选择。

·         其他选项保持默认即可。

4.   创建成功之后会弹出应用的基本信息，请注意保存应用ID和应用密钥

如果应用密钥丢失可在系统管理 > 应用管理 > 应用列表 > 安全 > 重置 获取

3      上传profile文件至IoT平台

将下载的profile文件上传至IoT平台，具体方法如下：

在SP Portal界面，选择“设备管理 > 设备模型 > 导入设备模型”，选择需要上传的profile文件

以同样的方法完成子设备profile文件的上传

4      修改工具包文件

4.1      将三个工具包文件解压后，存放至同一路径下（如D:\SDK）。

4.2      打开gwreginfo.json文件，依次修改对应的值。

"mac":"TestTest001",（网关设备的唯一标识码，需在平台唯一，测试阶段可自定义）

"platformAddr":"100.100.100.100",（平台南向设备对接地址）

"platformPort":8943,（平台南向设备对接端口，8943一般不变）

（以下信息要与网关设备的profile文件一一对应）

"manufacturerId":"Huawei",

"deviceType":"Gateway",

"model":"AgentLite01",

"protocolType":"HuaweiM2M",

"loglevel":255

5      平台注册设备

在SP Portal界面，选择“设备管理 > 设备 > 设备注册 > 创建” 

在设备注册界面填写相关信息

注册类型：选择动态密码模式

设备识别码：与第4节中gwreginfo.json文件的mac值一致

设备定义：产品

产品选择：选择第3节中上传的网关profile文件

点击提交，会弹出注册成功之后返回的设备相关信息

在左侧菜单 点击所有设备 可以看到刚刚注册的设备，此时设备处于“离线”状态。

6      修改Demo工程代码

6.1      解压缩AgentLiteDemo_windows_C_V19.2.0.zip

双击demo.sln用vs打开

6.2      修改Demo工程demo.h文件中的常量，将#define CONFIG_PATH后的内容修改为工具包文件存放路径。

例如：#define CONFIG_PATH "D:/SDK"

6.3      先注释Demo工程demo.c文件中的代码片段

7      编译与调试 

修改完成后，运行 Demo

如果程序没报错，在平台就可以看到设备在线。

l  调用Gateway_DataReport接口上报数据

l  调用AddSensors接口添加子设备

l  调用Sensor_DataReport接口上报数据

具体的接口信息请参见文档：Agent Lite API参考(C)
程序大致结构解析：

·         调用IOTA_Init接口初始化Agent Lite资源。

·         调用IOTA_Bind接口绑定设备至IoT平台。
设备第一次接入IoT平台时需要进行绑定操作，上层应用通过调用该接口传入设备序列号或者MAC地址以及设备信息来绑定到IoT联接管理平台。在绑定前需要调用IOTA_SetConfig接口设置绑定服务器IP与端口（IoCM服务器地址与端口，Agent Lite会配置默认端口8943）。
当调用IOTA_Bind接口绑定设备成功时，会在工具包文件夹下生成一个gwbindinfo.json文。此时，SP Portal中可以看到设备变为“在线”状态。

·         调用IOTA_Login接口使设备登录。
设备在第一次绑定后，或者在设备重启后需要进行登录。

·         调用AddSensors接口添加子设备BatteryCal。

·         调用Device_ServiceDataReport接口上报数据。

·         调用Device_ServiceCommandReceive接口接收命令。

附：程序执行之后在工作路径（D:/SDK）下有以下文件

开发者一般只需关注以下两个文件

gwbindinfo.json：设备绑定成功之后生成

UGP_0.log：程序运行日志，如果连接过程中有问题，可查看此日志