LiteOS云端对接教程07-LiteOS基于CoAP对接华为OC平台实战

1. LiteOS OC COAP 抽象组件

概述

为了适应各种各样的使用coap接入华为OC的模式，特采用该层次接口，对上提供应用所需的接口，对下允许接入方式的灵活适配。

OC COAP AL的api接口声明在<oc_coap_al.h>中，使用相关的接口需要包含该头文件。

配置并连接

对接服务器的所有信息保存在结构体oc_config_param_t中，其定义在oc_coap_al.h中，如下：

typedef struct
{
    en_oc_boot_strap_mode_t  boot_mode;       ///< bootmode,if boot client_initialize, then the bs must be set
    oc_server_t              boot_server;     ///< which will be used by the bootstrap, if not, set NULL here
    oc_server_t              app_server;      ///< if factory or smart boot, must be set here
    fn_oc_coap_msg_deal      rcv_func;        ///< receive function caller here
    void                    *usr_data;        ///< used for the user
}oc_config_param_t;

其中boot_mode是对接模式，对应华为平台的两种模式：

typedef enum
{
    en_oc_boot_strap_mode_factory = 0,
    en_oc_boot_strap_mode_client_initialize,
    en_oc_boot_strap_mode_sequence,
}en_oc_boot_strap_mode_t;

app_server参数是服务器信息，定义如下：

typedef struct
{
    char *ep_id;                  ///< endpoint identifier, which could be recognized by the server
    char *address;                ///< server address,maybe domain name
    char *port;                   ///< server port
    char *psk_id;                 ///< server encode by psk, if not set NULL here
    char *psk;
    int   psk_len;
}oc_server_t;

参数说明如下：

• ep_id：设备标识符
• address：服务器地址
• port：服务器端口
• psk_id：DTLS使用，不使用的话设置为NULL

rcv_func是回调函数的函数指针，当设备接收到coap消息后回调：

typedef int (*fn_oc_coap_msg_deal)(void *msg, int len);

在配置结构体完成之后，调用配置函数进行配置并连接，API如下：

/**
 * @brief the application use this function to configure the coap agent
 * @param[in] param, refer to tag_oc_coap_config
 * @return oc coap handle else NULL failed
 */
void *oc_coap_config(oc_config_param_t *param);

函数参数很清楚，将存放对接信息的结构体指针传入即可，API的返回值是oc coap handle指针，后续使用。

数据上报

连接成功之后，因为平台部署了编解码插件，直接向华为云平台上报二进制数据即可，oc_coap提供的API如下：

/**
 * @brief the application use this function to send the message to the cdp
 * @param[in] hanlde:the coap handle returned by oc_coap_config
 * @param[in] report:the message to report
 *
 * @return 0 success while <0 failed
 */
int oc_coap_report(void *handle,char *msg,int len);

命令接收

当OC平台发布该主题数据时，oc_coap组件会拉起接收回调函数将数据保存，进而用户解析接收到的数据即可。

oc_coap组件自动初始化

在SDK目录中的IoT_LINK_1.0.0\iot_link\link_main.c中可以看到自动初始化函数：

2. 配置准备

Makefile配置

因为本次实验用到的组件较多：

• AT框架
• ESP8266设备驱动
• 串口驱动框架
• SAL组件
• coap组件
• oc_coap组件

这些实验代码全部编译下来，有350KB，而小熊派开发板所使用的主控芯片STM32L431RCT6的 Flash 仅有256KB，会导致编译器无法链接出可执行文件，所以要在makefile中修改优化选项，修改为-Os参数，即最大限度的优化代码尺寸，并去掉-g参数，即代码只能下载运行，无法调试，如图：

ESP8266设备配置

在工程目录中的OS_CONFIG/iot_link_config.h文件中，配置ESP8266设备的波特率和设备名称:

WIFI对接信息配置

SDK：C:\Users\Administrator\.icode\sdk\IoT_LINK_1.0.0（其中Administrator是实验电脑的用户名）。

在SDK目录中的iot_link\network\tcpip\esp8266_socket\esp8266_socket_imp.c文件中，配置连接信息：

之后修改同路径下的esp8266_socket_imp.mk文件，如图，将 TOP_DIR 改为 SDK_DIR ：

3. 上云实验

编写实验文件

在 Demo 文件夹下创建cloud_test_demo文件夹，在其中创建oc_coap_demo.c文件。

编写以下代码：

#include <osal.h>
#include <oc_coap_al.h>
#include <link_endian.h>
#include <string.h>

#define cn_endpoint_id        "654654654"
#define cn_app_server         "49.4.85.232"
#define cn_app_port           "5683"

#define cn_app_light           0
#define cn_app_ledcmd          1

#pragma pack(1)

typedef struct
{
    int8_t msgid;
    uint16_t intensity;
}app_light_intensity_t;


typedef struct
{
    int8_t msgid;
    char led[3];
}app_led_cmd_t;

#pragma pack()

#define cn_app_rcv_buf_len 128
static int8_t          s_rcv_buffer[cn_app_rcv_buf_len];
static int             s_rcv_datalen;
static osal_semp_t     s_rcv_sync;

static void           *s_coap_handle = NULL;

static int app_msg_deal(void *msg, int len)
{
    int ret = -1;

    if(len <= cn_app_rcv_buf_len)
    {
        memcpy(s_rcv_buffer,msg,len);
        s_rcv_datalen = len;

        osal_semp_post(s_rcv_sync);

        ret = 0;

    }
    return ret;
}


static int app_cmd_task_entry()
{
    int ret = -1;
    app_led_cmd_t *led_cmd;
    int8_t msgid;

    while(1)
    {
        if(osal_semp_pend(s_rcv_sync,cn_osal_timeout_forever))
        {
            msgid = s_rcv_buffer[0];
            switch (msgid)
            {
                case cn_app_ledcmd:
                    led_cmd = (app_led_cmd_t *)s_rcv_buffer;
                    printf("LEDCMD:msgid:%d msg:%s \n\r",led_cmd->msgid, led_cmd->led);
                    if (led_cmd->led[0] == 'o' && led_cmd->led[1] == 'n')
                    {
                        printf("--------------- LED ON! --------------------\r\n");
                    }

                    else if (led_cmd->led[0] == 'o' && led_cmd->led[1] == 'f' && led_cmd->led[2] == 'f')
                    {
                        printf("--------------- LED OFF! --------------------\r\n");
                    }
                    else
                    {

                    }
                    break;
                default:
                    break;
            }
        }
    }

    return ret;
}

static int app_report_task_entry()
{
    int ret = -1;
    int lux = 0;

    oc_config_param_t      oc_param;
    app_light_intensity_t  light;

    memset(&oc_param,0,sizeof(oc_param));

    oc_param.app_server.address = cn_app_server;
    oc_param.app_server.port = cn_app_port;
    oc_param.app_server.ep_id = cn_endpoint_id;
    oc_param.boot_mode = en_oc_boot_strap_mode_factory;
    oc_param.rcv_func = app_msg_deal;

    s_coap_handle = oc_coap_config(&oc_param);

    if(NULL != s_coap_handle)   
    {
        while(1)
        {
            lux++;
            lux= lux%10000;
            printf("lux is %d!\r\n",lux);

            light.msgid = cn_app_light;
            light.intensity = htons(lux);
            oc_coap_report(s_coap_handle,(char *)&light,sizeof(light));
            osal_task_sleep(5*1000);
        }
    }

    return ret;
}

int standard_app_demo_main()
{
    osal_semp_create(&s_rcv_sync,1,0);

    osal_task_create("app_report",app_report_task_entry,NULL,0x1000,NULL,2);
    osal_task_create("app_command",app_cmd_task_entry,NULL,0x1000,NULL,3);

    return 0;
}

添加路径

在user_demo.mk中添加如下：

	#example for oc_coap_demo
	ifeq ($(CONFIG_USER_DEMO), "oc_coap_demo")	
		user_demo_src  = ${wildcard $(TOP_DIR)/targets/STM32L431_BearPi/Demos/cloud_test_demo/oc_coap_demo.c}
	endif

添加位置如下：

配置.sdkconfig

上报数据实验结果

编译，下载，在云端的实验现象如下：

在本地的实验现象如下：

命令下发实验结果

在云端下发“on”命令：

在串口助手中可以看到：

下发“off”命令：

在串口助手中可以看到：