README.md
1# BearPi-HM_Nano开发板智慧物流案例开发
2本示例将演示如何在BearPi-HM_Nano开发板上使用MQTT协议连接华为IoT平台，使用E53_ST1 智慧物流扩展板与 BearPi-HM_Nano 开发板实现智慧物流的案例，设备安装如下图所示。
3
4
5
6
7## 软件设计
8
9
10### 连接平台
11在连接平台前需要设置CONFIG_APP_DEVICEID、CONFIG_APP_DEVICEPWD、CONFIG_APP_SERVERIP、CONFIG_APP_SERVERPORT，通过oc_mqtt_profile_connect()函数连接平台。
12```c
13 WifiConnect(CONFIG_WIFI_SSID, CONFIG_WIFI_PWD);
14 dtls_al_init();
15 mqtt_al_init();
16 oc_mqtt_init();
17
18 g_app_cb.app_msg = queue_create("queue_rcvmsg",10,1);
19 if(g_app_cb.app_msg == NULL){
20 printf("Create receive msg queue failed");
21
22 }
23 oc_mqtt_profile_connect_t connect_para;
24 (void) memset( &connect_para, 0, sizeof(connect_para));
25
26 connect_para.boostrap = 0;
27 connect_para.device_id = CONFIG_APP_DEVICEID;
28 connect_para.device_passwd = CONFIG_APP_DEVICEPWD;
29 connect_para.server_addr = CONFIG_APP_SERVERIP;
30 connect_para.server_port = CONFIG_APP_SERVERPORT;
31 connect_para.life_time = CONFIG_APP_LIFETIME;
32 connect_para.rcvfunc = msg_rcv_callback;
33 connect_para.security.type = EN_DTLS_AL_SECURITY_TYPE_NONE;
34 //连接平台
35 ret = oc_mqtt_profile_connect(&connect_para);
36 if((ret == (int)en_oc_mqtt_err_ok)){
37 g_app_cb.connected = 1;
38 printf("oc_mqtt_profile_connect succeed!\r\n");
39 }
40 else
41 {
42 printf("oc_mqtt_profile_connect failed!\r\n");
43 }
44```
45
46### 推送数据
47
48当需要上传数据时，需要先拼装数据，让后通过oc_mqtt_profile_propertyreport上报数据。代码示例如下：
49
50```c
51static void deal_report_msg(report_t *report)
52{
53 oc_mqtt_profile_service_t service;
54 oc_mqtt_profile_kv_t Longitude_value;
55 oc_mqtt_profile_kv_t Latitude_value;
56 oc_mqtt_profile_kv_t beep;
57
58 if (g_app_cb.connected != 1) {
59 return;
60 }
61
62 service.event_time = NULL;
63 service.service_id = "Track";
64 service.service_property = &Longitude_value;
65 service.nxt = NULL;
66
67 Longitude_value.key = "Longitude";
68 Longitude_value.value = &report->Longitude;
69 Longitude_value.type = EN_OC_MQTT_PROFILE_VALUE_STRING;
70 Longitude_value.nxt = &Latitude_value;
71
72 Latitude_value.key = "Latitude";
73 Latitude_value.value = &report->Latitude;
74 Latitude_value.type = EN_OC_MQTT_PROFILE_VALUE_STRING;
75 Latitude_value.nxt = &beep;
76
77 beep.key = "BeepStatus";
78 beep.value = g_app_cb.beep ? "ON" : "OFF";
79 beep.type = EN_OC_MQTT_PROFILE_VALUE_STRING;
80 beep.nxt = NULL;
81 //发送数据
82 oc_mqtt_profile_propertyreport(NULL,&service);
83 return;
84}
85```
86
87## 编译调试
88
89
90### 登录
91
92设备接入华为云平台之前，需要在平台注册用户账号，华为云地址：<https://www.huaweicloud.com/>
93
94在华为云首页单击产品，找到IoT物联网，单击设备接入IoTDA 并单击立即使用，如下图所示。
95
96
97
98
99
100### 创建产品
101
102在设备接入页面可看到总览界面，展示了华为云平台接入的协议与域名信息，根据需要选取MQTT通讯必要的信息备用，如下图所示。
103
104接入协议（端口号）：MQTT 1883
105
106域名：iot-mqtts.cn-north-4.myhuaweicloud.com
107
108
109
110
111
112选中侧边栏产品页，单击右上角“创建产品”，在页面中选中所属资源空间，并且按要求填写产品名称，选中MQTT协议，数据格式为JSON，并填写厂商名称，在下方模型定义栏中选择所属行业以及添加设备类型，并单击右下角“确定”，如下图所示。
113
114
115
116创建完成后，在产品页会自动生成刚刚创建的产品，单击“查看”可查看创建的具体信息，如下图所示。
117
118
119
120
121单击产品详情页的自定义模型，在弹出页面中新增服务，如下图所示。
122
123服务ID：`Track`(必须一致)
124
125服务类型：`Senser`(可自定义)
126
127
128在“Track”的下拉菜单下点击“添加属性”填写“Longitude、Latitude、BeepStatus”相关信息，如下图所示。
129
130
131
132
133
134
135
136
137
138
139在“Track”的下拉菜单下点击“添加命令”填写相关信息，如下图所示。
140
141命令名称：`Track_Control_Beep`
142
143参数名称：`Beep`
144
145数据类型：`string`
146
147长度：`3`
148
149枚举值：`ON,OFF`
150
151
152
153#### 注册设备
154
155在侧边栏中单击“设备”，进入设备页面，单击右上角“注册设备”，勾选对应所属资源空间并选中刚刚创建的产品，注意设备认证类型选择“秘钥”，按要求填写秘钥，如下图所示。
156
157
158
159记录下设备ID和设备密钥，如下图所示。
160
161
162注册完成后，在设备页面单击“所有设备”，即可看到新建的设备，同时设备处于未激活状态，如下图所示。
163
164
165
166
167### 修改代码中设备信息
168修改`iot_cloud_oc_sample.c`中第31行附近的wifi的ssid和pwd，以及设备的DEVICEID和DEVICEPWD（这两个参数是在平台注册设备时产生的），如下图所示。
169
170
171
172### 修改 BUILD.gn 文件
173
174修改 `device\board\bearpi\bearpi_hm_nano\app`路径下 BUILD.gn 文件，指定 `cloud_oc_gps` 参与编译。
175
176```r
177#"D7_iot_cloud_oc_smoke:cloud_oc_smoke",
178#"D8_iot_cloud_oc_light:cloud_oc_light",
179#"D9_iot_cloud_oc_manhole_cover:cloud_oc_manhole_cover",
180#"D10_iot_cloud_oc_infrared:cloud_oc_infrared",
181#"D11_iot_cloud_oc_agriculture:cloud_oc_agriculture",
182"D12_iot_cloud_oc_gps:cloud_oc_gps",
183```
184### 测试
185示例代码编译烧录代码后，按下开发板的RESET按键，通过串口助手查看日志，平台上的设备显示为在线状态，如下图所示。
186
187
188
189点击设备右侧的“查看”，进入设备详情页面，可看到上报的数据，如下图所示。
190
191
192
193
