AliOS Things 3.0应用笔记：http client简单应用
简介
AliOS Things 3.0版本于9月27日在云栖大会正式发布，在新版本中带来了全新的应用开发框架，帮助用户快速构建自己的应用。使用户可以更专注于自身应用的开发。
AliOS Things 3.0版本新增加了httpc组件（http 客户端组件），httpc组件支持多种RESTful的API调用，包括GET、POST、PUT、HEAD等，也支持https安全协议。
本示例是基于AliOS Things 3.0应用开发框架做的一个简单的http client应用，通过http API请求获取当前的天气信息。
准备工作
参考 AliOS Things Environment Setup 和 AliOS Things 3.0 应用开发指南指南 搭建好AliOS Things 3.0的应用开发环境。
创建应用工程
参考AliOS Things 3.0 应用开发指南 > AliOS Studio中创建应用工程创建好你的应用工程。
本示例新建的应用工程名称为httpclient_app，选择的开发板为developerkit。
编写应用代码
新建好的应用工程文件如下面所示：
.httpclient_app
├── .aos # AliOS Things 3.0 应用工程描述
├── .vscode # AliOS Studio 配置文件
├── Config.in # Menuconfig 配置文件
├── README.md # 应用说明文档
├── aos.mk # 编译文件
├── app_main.c # 应用示例代码
└── k_app_config.h # 内核配置添加http组件
aos-cube会自动根据include的头文件来自动添加组件。
http组件需要用到全局宏：BUILD_AOS，所以需要在aos.mk中额外增加一个全局宏定义：
GLOBAL_DEFINES += BUILD_AOS天气API说明
本示例使用http组件，发送http get请求获取天气数据，天气的API是中国天气网提供的API：http://www.weather.com.cn/data/sk/101210101.html，其中101210101代表是杭州。
使用curl命令可以测试该API接口：
$ curl http://www.weather.com.cn/data/sk/101210101.html
{"weatherinfo":{"city":"杭州","cityid":"101210101","temp":"24.8","WD":"东北风","WS":"小于3级","SD":"81%","AP":"1000.3hPa","njd":"暂无实况","WSE":"<3","time":"17:50","sm":"2.1","isRadar":"1","Radar":"JC_RADAR_AZ9571_JB"}}%或者也可以在浏览器打开该链接测试API接口。
使用http组件
本示例主要使用到了http如下接口，详细的http对外提供的接口和参数说明请参考include/network/http/http.h：
/* httpc 初始化 */
int8_t http_client_initialize(void);
/* 创建一个httpc实例 */
httpc_handle_t httpc_init(httpc_connection_t *settings);
/* 销毁一个httpc实例 */
int8_t httpc_deinit(httpc_handle_t httpc);
/* 发送http请求 */
int8_t httpc_send_request(httpc_handle_t httpc, int8_t method, char *uri,
const char *hdr, const char *content_type,
const char *param, uint16_t param_len);
/* 构建http请求header */
int32_t httpc_construct_header(char *buf, uint16_t buf_size, const char *name, const char *data);
/* 等待接口http返回 */
int32_t httpc_recv_response(httpc_handle_t httpc, uint8_t *rsp, uint32_t rsp_size,
http_rsp_info_t *info, uint32_t timeout);
完整源码
本示例应用的工程源码点击这里下载。
注意：需要更改app_main.c中的WIFI_SSID 和 WIFI_PASSWD 为你的路由器信息。
aos.mk：
NAME := httpclient_app
$(NAME)_MBINS_TYPE := app
$(NAME)_VERSION := 1.0.0
$(NAME)_SUMMARY := httpclient_app
$(NAME)_SOURCES += app_main.c
GLOBAL_DEFINES += BUILD_AOS
GLOBAL_INCLUDES += ./
$(NAME)_COMPONENTS_CUSTOMIZED := http yloop
$(NAME)_COMPONENTS += $($(NAME)_COMPONENTS_CUSTOMIZED)app_main.c：
/*
* Copyright (C) 2015-2017 Alibaba Group Holding Limited
*/
#include <stdio.h>
#include <aos/kernel.h>
#include <aos/yloop.h>
#include <http.h>
#include <network/network.h>
#define WIFI_SSID "aiot"
#define WIFI_PASSWD "12345678"
#define REQ_BUF_SIZE 2048
#define RSP_BUF_SIZE 4096
#define HTTP_UP_HDR_SIZE 128
/* weather api hostname */
#define WEATHER_HOSTNAME "http://www.weather.com.cn/"
/* weather api uri */
#define WEATHER_URI "data/sk/101210101.html"
static httpc_handle_t httpc_handle = 0;
static httpc_connection_t settings;
/* buffer for send & receive */
static uint8_t rsp_buf[RSP_BUF_SIZE] = {0};
static uint8_t req_buf[REQ_BUF_SIZE] = {0};
/* send http get request */
char *get_weather(void)
{
int fd;
char hdr[HTTP_UP_HDR_SIZE] = {0};
int32_t ret;
http_rsp_info_t rsp_info;
http_client_initialize();
/* create socket */
if ((fd = socket(AF_INET, SOCK_STREAM, 0)) < 0) {
printf("alloc socket fd fail\n");
goto exit;
}
memset(&settings, 0, sizeof(settings));
settings.socket = fd;
settings.server_name = WEATHER_HOSTNAME;
settings.req_buf = req_buf;
settings.req_buf_size = REQ_BUF_SIZE;
/* httpc initialization */
if ((httpc_handle = httpc_init(&settings)) == 0) {
printf("http session init fail\n");
close(fd);
goto exit;
}
/* construct httc header: set accept content type */
if ((httpc_construct_header(
hdr, HTTP_UP_HDR_SIZE, "Accept",
"text/xml,text/javascript,text/html,application/json")) < 0) {
printf("http construct header fail\n");
goto exit;
}
/* send get request */
if ((httpc_send_request(httpc_handle, HTTP_GET, WEATHER_URI, hdr,
"application/json", NULL, 0)) != HTTP_SUCCESS) {
printf("httpc_send_request fail\n");
goto exit;
}
/* get response */
if ((httpc_recv_response(httpc_handle, rsp_buf, RSP_BUF_SIZE, &rsp_info,
10000)) < 0) {
printf("httpc_recv_response fail\n");
goto exit;
}
printf("http session %x, buf size %d bytes, recv %d bytes data", httpc_handle,
RSP_BUF_SIZE, rsp_info.rsp_len);
// if (rsp_info.rsp_len > 0) {
// printf("%s", rsp_buf);
// }
if (rsp_info.message_complete) {
// printf("message_complete");
close(settings.socket);
httpc_deinit(httpc_handle);
return rsp_info.body_start;
}
exit:
close(settings.socket);
httpc_deinit(httpc_handle);
return NULL;
}
/* task for get weather */
static void get_weather_task(void *arg)
{
char *weather_data = NULL;
/* get weather data */
if((weather_data = get_weather()) != NULL){
aos_msleep(200);
printf("********************** weather data **********************\r\n");
printf("%s\r\n", weather_data);
printf("**********************************************************\r\n");
return;
}
printf("weather request error\r\n");
}
/* wifi event */
static void wifi_service_event(input_event_t *event, void *priv_data)
{
static char ip[16] = {0};
static int get_weather_started = 0;
if (event->type != EV_WIFI && event->code != CODE_WIFI_ON_GOT_IP) {
return;
}
netmgr_wifi_get_ip(ip);
/* start up only once */
if (get_weather_started == 1) {
return;
}
/* check if ip is available */
if (0 == strcmp(ip, "0.0.0.0")) {
printf("ip invailable\n");
return;
}
get_weather_started = 1;
printf("wifi connected, ip:%s\n", ip);
aos_task_new("get_weather", get_weather_task, NULL, 1024 * 4);
}
/* task for connect wifi */
static void wifi_connect(void *arg)
{
/* network init */
netmgr_init();
netmgr_start(false);
aos_msleep(100);
/* connect to wifi */
printf("\r\nConnecting to wifi: ssid:[%s], passwd:[%s]\r\n", WIFI_SSID, WIFI_PASSWD);
netmgr_connect(WIFI_SSID, WIFI_PASSWD, 10 * 1000);
}
/**********************user code*************************/
int application_start(int argc, char *argv[])
{
#ifdef WITH_SAL
sal_add_dev(NULL, NULL);
sal_init();
#endif
/* register wifi event */
aos_register_event_filter(EV_WIFI, wifi_service_event, NULL);
aos_task_new("wifi_connect", wifi_connect, NULL, 2048);
/* loop for schedule */
aos_loop_run();
}编译运行
点击编译和烧录。运行后，在串口日志最后面就能看的获取到的天气信息。
运行效果：
[ 0.050]<A>AOS sensor: drv_acc_st_lsm6dsl_init successfully
[ 0.060]<A>AOS sensor: drv_gyro_st_lsm6dsl_init gyro do not need reset
[ 0.070]<A>AOS sensor: drv_gyro_st_lsm6dsl_init successfully
[ 0.080]<A>AOS sensor: drv_als_liteon_ltr553_init successfully
[ 0.090]<A>AOS sensor: drv_ps_liteon_ltr553_init successfully
[ 0.100]<A>AOS sensor: drv_baro_bosch_bmp280_init successfully
[ 0.110]<A>AOS sensor: drv_mag_memsic_mmc3680kj_init successfully
[ 0.120]<A>AOS sensor: drv_humi_sensirion_shtc1_init successfully
[ 0.130]<A>AOS sensor: drv_temp_sensirion_shtc1_init successfully
Welcome to AliOS Things
[ 0.150]<E>sal_wifi Uart dev is not configured, use the default cfg
uart 1 enter uart_receive_start_dma instance 0x40004800ip invailable
Connecting to wifi: ssid:[aiot], passwd:[12345678]
wifi connected, ip:192.168.43.111
[[hhttttppcc]][[000088665500]] hhttttppcc__sseenndd__rreeqquueesstt,, sseenndd rreeqquueesstt hheeaaddeerr
vGoErTk s/pdaactea//gsikt/h1u0b1/2A1l0i1O0S1-.Thhtimnlg sH/TbToPa/r1d./1d
2Ulsoepre-rAkgietn/ta:o sA/lbioOaSr-dH_TcTlPi-.Ccl i2e1n6t
1
Cache-Control: no-cache
Connection: close
Host: www.weather.com.cn
Accept: text/xml,text/javascript,text/html,application/json
Content-Type: application/json
socket 0, len 238
[httpc][009130] httpc_send_request, connect 0
[httpc][009160] httpc_send_request, send 238, ret 0
[httpc][019170] on_message_begin, HTTP response (headers), method GET
[httpc][019170] on_status, HTTP response status OK
[httpc][019180] print_header_field, len 4, Date
[httpc][019190] print_header_field, len 29, Wed, 09 Oct 2019 07:32:13 GMT
[httpc][019200] print_header_field, len 12, Content-Type
[httpc][019200] print_header_field, len 9, text/html
[httpc][019210] print_header_field, len 17, Transfer-Encoding
[httpc][019220] print_header_field, len 7, chunked
[httpc][019220] print_header_field, len 10, Connection
[httpc][019230] print_header_field, len 5, close
[httpc][019240] print_header_field, len 6, Server
[httpc][019240] print_header_field, len 9, openresty
[httpc][019250] print_header_field, len 16, X-Xss-Protection
[httpc][019260] print_header_field, len 1, 1
[httpc][019260] print_header_field, len 10, Set-Cookie
[httpc][019270] print_header_field, len 8, HttpOnly
[httpc][019280] print_header_field, len 3, Age
[httpc][019280] print_header_field, len 4, 2068
[httpc][019290] print_header_field, len 5, X-Via
[httpc][019300] print_header_field, len 125, 1.1 PSbjsdBGPvu28:10 (Cdn Cache Server V2.0), 1.1 zhdx147:10 (Cdn Cache Server V2.0), 1.1 huadxin69:7 (Cdn Cache Server V2.0)
[httpc][019320] on_headers_complete, headers complete
[httpc][019320] on_message_complete, HTTP GET response (complete)
http session 20002298, buf size 4096 bytes, recv 578 bytes data[ 19.340]<E>sal_wifi HAL_SAL_Close 778 failed
********************** weather data **********************
{"weatherinfo":{"city":"杭州","cityid":"101210101","temp":"24.8","WD":"东北风","WS":"小于3级","SD":"81%","AP":"1000.3hPa","njd":"暂无实况","WSE":"<3","time":"17:50","sm":"2.1","isRadar":"1","Radar":"JC_RADAR_AZ9571_JB"}}
**********************************************************
