ESP32-C3入门教程网络篇①——TCP Socket Client 客户端应用示例

╰+哭是因爲堅強的太久メ 2022-09-14 03:09 953阅读 1赞

### 文章目录 ###

*  一、前言
 *  二、Socket模式
 *  三、快速运行
 *  四、运行效果
 *  五、程序流程
 *  六、关键函数
 *   *  6.1 Socket创建
     *  6.2 Socket连接
     *  6.3 发送数据
     *  6.4 接收数据
     *  6.5 Socket关闭
     *  6.6 Socket释放
 *  七、参考

# 一、前言 #

> 本文基于VS Code IDE进行编程、编译、下载、运行等操作  
> 基础知识点请查阅：[ESP32-C3入门教程 基础篇①——基于VS Code构建Hello World][ESP32-C3_ _VS Code_Hello World]

# 二、Socket模式 #

Socket有两种模式

*  Server客户端，连接到别人的Socket Server，然后进行通信
 *  Client服务器，开个Socket Server，供其他Client连接，然后进行通信。

本博文描述ESP32-C3作为TCP Socket Client 客户端，与Socket Server进行通信的示例。

# 三、快速运行 #

*  示例项目中，选择`protocols`—>`sockets`\->`tcp_server`
 *  `menuconfig`配置`ESP32C3-Specific`—>`Rec 0`
 *  芯片选择`ESP32-C3(Built-in USB JTAG)`
 *  快速运行`ESP-IDF Build, Flash and Monitor`（左下角）  
    ![在这里插入图片描述][watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBA5bCP5bq35biI5YWE_size_20_color_FFFFFF_t_70_g_se_x_16]

# 四、运行效果 #

*  用网络调试助手创建TCP Server
 *  修改WiFi AP的`SSID`和`password`
 *  修改Socket的`IP Address`和`Port`
 *  通过网络调试助手发送`hello`

![在这里插入图片描述][watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBA5bCP5bq35biI5YWE_size_20_color_FFFFFF_t_70_g_se_x_16 1]

![在这里插入图片描述][watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBA5bCP5bq35biI5YWE_size_20_color_FFFFFF_t_70_g_se_x_16 2]  
![在这里插入图片描述][watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBA5bCP5bq35biI5YWE_size_20_color_FFFFFF_t_70_g_se_x_16 3]

# 五、程序流程 #

*  `nvs_flash_init`，初始化默认 NVS 分区
 *  `esp_netif_init`，初始化底层TCP/IP堆栈
 *  `esp_event_loop_create_default`，创建默认事件循环
 *  `example_connect`，连接到指定WiFi
 *  `socket`，同`lwip_socket`，创建一个socket
 *  `connect`，同`lwip_connect`，连接到指定socket和指定ip端口
 *  `send`，同`lwip_send`，发送数据`Message from ESP32 @小康师兄`
 *  `recv`，同`lwip_recv`，堵塞接收数据
 *  `shutdown`，同`lwip_shutdown`，关闭Socket的发送和接收
 *  `close`，同`lwip_close`，释放Socket资源

# 六、关键函数 #

## 6.1 Socket创建 ##

*  `domain`：创建Socket的领域，`AF_UNIX`/`AF_INET`
 *  `type`：创建Socket的类型，`SOCK_STREAM`/`SOCK_DGRAM`/`SOCK_SEQPACKET`
    
     *  `[SOCK_STREAM=TCP]`提供有序的、可靠的、双向的、连接模式的字节流，并且可以为带外数据提供传输机制。
     *  `[SOCK_DGRAM=UDP]`提供数据报，它们是无连接模式、固定最大长度的不可靠消息。
     *  `[SOCK_SEQPACKET=RAW]`为记录提供有序的、可靠的、双向的、连接模式的传输路径。
 *  `protocol`：创建Socket的协议

int     socket(int domain, int type, int protocol);

## 6.2 Socket连接 ##

*  `socket`，socket的文件描述符
 *  `address`，连接的地址
 *  `address_len`，连接的地址长度

int connect(int socket, const struct sockaddr *address, socklen_t address_len);

## 6.3 发送数据 ##

*  `socket`，socket的文件描述符
 *  `buffer`，指向包含要发送的消息的缓冲区。
 *  `length`，以字节为单位指定消息的长度。
 *  `flags`，指定消息传输的类型

ssize_t send(int socket, const void *buffer, size_t length, int flags);

## 6.4 接收数据 ##

*  `socket`，socket的文件描述符
 *  `buffer`，指向应存储消息的缓冲区。
 *  `length`，指定缓冲区参数指向的缓冲区的长度（以字节为单位） 。
 *  `flags`，指定消息接收的类型。

ssize_t recv(int socket, void *buffer, size_t length, int flags);

## 6.5 Socket关闭 ##

*  `socket`，socket的文件描述符
 *  `how`，`SHUT_RD`/`SHUT_WR`/`SHUT_RDWR`
    
     *  `SHUT_RD`，禁用进一步的接收操作。
     *  `SHUT_WR`，禁用进一步的发送操作。
     *  `SHUT_RDWR`，禁用进一步的发送和接收操作。

int shutdown(int socket, int how);

## 6.6 Socket释放 ##

*  `socket`，socket的文件描述符

int close(int socket)

# 七、参考 #

[lwIP - ESP32-C3 - —ESP-IDF 编程指南 latest 文档][lwIP - ESP32-C3 - _ESP-IDF _ latest]

***觉得好，就一键三连呗（点赞+收藏+关注）***

[ESP32-C3_ _VS Code_Hello World]: https://blog.csdn.net/kangweijian/article/details/120284617
[watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBA5bCP5bq35biI5YWE_size_20_color_FFFFFF_t_70_g_se_x_16]: /images/20220828/55392837dca64822be46cd676f2b3b4d.png
[watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBA5bCP5bq35biI5YWE_size_20_color_FFFFFF_t_70_g_se_x_16 1]: /images/20220828/95109fba57ee4a9cb75a13df9b0fd699.png
[watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBA5bCP5bq35biI5YWE_size_20_color_FFFFFF_t_70_g_se_x_16 2]: /images/20220828/d88544ec70af4ce5a96e822c74adad06.png
[watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBA5bCP5bq35biI5YWE_size_20_color_FFFFFF_t_70_g_se_x_16 3]: /images/20220828/9c66ef0f93ad497da44191f33d6de147.png
[lwIP - ESP32-C3 - _ESP-IDF _ latest]: https://docs.espressif.com/projects/esp-idf/zh_CN/latest/esp32c3/api-guides/lwip.html?highlight=shutdown#bsd-sockets-api