一、简介
WebClient软件包由RT-Thread自主研发,基于HTTP协议客户端的实现。它提供了设备与 HTTP Server 之间通信的基本功能。
WebClient软件包的特点如下:
支持IPV4/IPV6地址;
支持GET/POST请求方式;
支持文件上传下载功能;
支持HTTPS加密传输;
完整的头数据添加和处理方法。
1.1 目录结构
WebClient软件包的目录结构如下:
1.2 许可证
WebClient 软件包符合 Apache-2.0 许可证,详细信息请参见 LICENSE 文件。
1.3 依赖
RT_Thread 3.0+
mbedtls 包(如果启用了 HTTPS 支持)
2.获取软件包
要使用 WebClient 软件包,需要在 RT-Thread 软件包管理中选择它。具体路径如下:
启用 webclient GET/POST 示例:添加示例代码;
选择 TLS 模式:配置启用 HTTPS 支持并选择支持的模式;
不支持:不支持TLS功能;
SAL TLS 支持:在 SAL 组件中配置 TLS 功能支持,并在 SAL 组件中抽象 TLS 操作。用户还需要手动配置使用的 TLS 软件包类型(目前仅支持 MbedTLS 软件包);
MbedTLS 支持:配置 MbedTLS 功能支持;
版本:配置软件包版本。
配置完成后,让 RT-Thread 包管理器自动更新,或者使用 pkgs --update 命令将包更新到 BSP。
3.使用WebClient软件包
四、注意事项
WebClient软件包连接HTTPS服务器时,需要在WebClient中开启TLS功能支持。
WebClient软件包版本更新( V1.0.0 -> the current latest version V2.0.0)后,软件包中的功能界面和使用流程发生了变化。如果开发者代码中使用之前的接口,可以适配最新版本接口,或者V1.0.0在版本号配置中选择版本,具体修改方法可以参考软件包迁移指南。
原作者:RT-Thread网络客户端
|