1# OpenHarmony驱动子系统开发—ETH驱动 2 3## 配置说明 4 5 1. 在lwip_adapter/include/app_ethernet.h中： 6 7 #define USE_DHCP： 当此宏被定义时，表示开启DHCP功能，若需使用静态IP，则注释此宏定义即可 8 9 #define DHCP_TIMEOUT_S：当DHCP功能开启时，此宏定义值表示DHCP超时时间设置 10 11 #define ETH_THREAD_PRIORITY：此宏定义值表示ETH初始化线程的优先级 12 13 以下定义使用静态IP时的IP地址设置: 14 /* STATIC IP */ 15 #define IP_ADDR0 (uint8_t) 192 16 #define IP_ADDR1 (uint8_t) 168 17 #define IP_ADDR2 (uint8_t) 8 18 #define IP_ADDR3 (uint8_t) 200 19 20 /*NETMASK*/ 21 #define NETMASK_ADDR0 (uint8_t) 255 22 #define NETMASK_ADDR1 (uint8_t) 255 23 #define NETMASK_ADDR2 (uint8_t) 255 24 #define NETMASK_ADDR3 (uint8_t) 0 25 26 /*GATEWAY*/ 27 #define GW_ADDR0 (uint8_t) 192 28 #define GW_ADDR1 (uint8_t) 168 29 #define GW_ADDR2 (uint8_t) 8 30 #define GW_ADDR3 (uint8_t) 1 31 32 2. 在lwip_adapter/include/lwipopts.h中： 33 34 此头文件中定义了LWIP的一些基本选项设置，有几个比较重要的参数设置，如下: 35 36 #define MEM_SIZE: 此宏定义了LWIP协议栈使用的内存堆大小 37 38 #define PBUF_POOL_SIZE： 定义了数据收发时的pbuf数量 39 #define PBUF_POOL_BUFSIZE：定义了每个pbuf的大小 40 41 LWIP总内存占用基本 = MEM_SIZE + PBUF_POOL_SIZE*PBUF_POOL_BUFSIZE 42 43 #define TCPIP_THREAD_NAME "TCP/IP" 44 #define TCPIP_THREAD_STACKSIZE 4096 ： 这两个宏定义了TCPIP线程运行时的任务名以及栈大小 45 46## 初始化接口说明 47 48 ETH驱动的初始化接口: void ethernet_enable(eth_state_callBack callback); 49 50 此函数实现于：lwip_adapter/src/app_ethernet.c中 51 52 参数callback: 此参数为ETH初始化状态回调函数。 53 54 当调用 ethernet_enable函数，并且注册了状态回调函数后，ETH connect/disConnect状态都会通过此回调返回！ 55 56 57## 具体使用步骤 58 59 1. 在main函数中调用 ethernet_enable(eth_callBack)函数，初始化ETH驱动接口，并注册状态回调函数eth_callBack； 60 61 2. 实现回调函数，在回调函数中处理应用程序，例: 62 63 void eth_callBack(EthLinkState state) 64 { 65 static osThreadId_t tcp_client_id = NULL; 66 67 /* ETH连接断开*/ 68 if (state == STATE_UPDATE_LINK_DOWN){ 69 printf("ETH LINK STATE: DisConnected!\r\n"); 70 71 // 断开ETH连接时删除TCP线程 72 osThreadTerminate(tcp_client_id); 73 tcp_client_id = NULL; 74 } 75 /* ETH连接成功*/ 76 else if (state == STATE_UPDATE_LINK_UP){ 77 printf("ETH LINK STATE: Connected!\r\n"); 78 79 // ETH连接成功后 创建TCP线程 80 osThreadAttr_t attr; 81 attr.name = "tcp_client"; 82 attr.attr_bits = 0U; 83 attr.cb_mem = NULL; 84 attr.cb_size = 0U; 85 attr.stack_mem = NULL; 86 attr.stack_size = 1024 * 4; 87 attr.priority = 25; 88 tcp_client_id = osThreadNew((osThreadFunc_t)tcp_client, NULL, &attr); 89 if (tcp_client_id == NULL) 90 { 91 printf("Failed to create tcp_client thread!\n"); 92 } 93 } 94 } 95 96 回调函数原型位于: lwip_adapter/include/app_ethernet.h中 97 98 注意: 回调函数实现时，当ETH连接时创建线程，ETH断开后务必记得删除线程。防止多次连接/断开时，创建多个线程而没有释放，导致程序崩溃！ 99 100 101 102