[单片机芯片] 【CH32V317W-R0开发板】以太网测评之DHCP

[复制链接]
 楼主| abner_ma 发表于 2025-7-31 15:11 | 显示全部楼层 |阅读模式
本帖最后由 abner_ma 于 2025-7-31 17:52 编辑

     CH32V *单片机是基于青稞 RISC-V 内核设计的工业级通用微控制器。青稞(C-SKY)RISC-V4F 内核是由中天微(后被阿里巴巴收购,并入平头哥半导体)开发的基于RISC-V架构的嵌入式处理器内核,支持单精度浮点运算(F扩展),主要面向IoT、边缘计算和低功耗嵌入式市场。包括 CH32V305 连接型 MCU,CH32V307/CH32V317 互联型 MCU、CH32V208 无线型 MCU 等。CH32V30x 和 CH32V31x 系列基于青稞 V4F微处理器设计,支持单精度浮点指令和快速中断响应,支持 144MHz 主频零等待运行,提供 8 组串口、4 组电机 PWM 高级定时器、SDIO、DVP 数字图像接口、4 组模拟运放、双 ADC 单元、双 DAC 单元,内置USB2.0 高速 PHY 收发器(480Mbps)、千兆以太网 MAC 控制器及 10 兆物理层收发器、10/100 兆物理层收发器(仅适用于 CH32V317)等。
    CH32V317 支持用户选择字配置为(192K FLASH+128K SRAM)、(224K FLASH+96K SRAM)、(256KFLASH+64K SRAM)、(288K FLASH+32K SRAM)、(128K FLASH+192K SRAM)几种组合中的一种。FLASH 闪存表示的是零等待运行区域 R0WAIT,CH32V317 支持(480K-R0WAIT)字节的非零等待区域。
   串口提供了 3 组通用同步/异步串口收发器(USART1、USART2、USART3),以及 5 组通用异步收发器(UART4、UART5、UART6、UART7、UART8)。支持全双工异步通信、同步单向通信以及半双工单线通信,也支持 LIN(局部互连网),兼容 ISO7816 的智能卡协议和 IrDA SIR ENDEC 传输编解码规范,以及调制解调器(CTS/RTS 硬件流控)操作。还允许多处理器通信。其采用分数波特率发生器系统,并支持 DMA 操作连续通讯。       CH32V3xx 基于 RISC-V 指令集设计,其架构中将内核、仲裁单元、DMA 模块、SRAM 存储等部分通过多组总线实现交互。设计中集成通用 DMA 控制器以减轻 CPU 负担、提高访问效率,应用多级时钟管理机制降低了外设的运行功耗,同时兼有数据保护机制,时钟自动切换保护等措施增加了系统稳定性。
    RISC-V4F 支持 RISC-V 指令集 IMAFC 子集,增加了单精度浮点运算。处理器内部以模块化管理,包含快速可编程中断控制器(PFIC)、内存保护、分支预测模式、扩展指令支持等单元。对外多组总线与外部单元模块相连,实现外部功能模块和内核的交互。青稞微处理器以其极简指令集、多种工作模式、模块化定制扩展等特点可以灵活应用不同场景微控制器设计,例如小面积低功耗嵌入式场景、高性能应用操作系统场景等。
1.支持机器和用户特权模式
2. 快速可编程中断控制器(PFIC)
3.多级硬件中断堆栈
4..串行2线调试接口
5.标准内存保护设计
6. 静态或动态分支预测、高效跳转、冲突检测机制
7. 自定义扩展指

总体架构框图。

    QQ20250731-114020.png
    以太网收发器(ETH)
     CH32V307、CH32F207 芯片的 MAC 支持 MII/RMII/RGMII 接口且内置一个 10Mbps PHY;CH32V317 芯片支持以太网控制器 MAC 和内置 10Mbps/100Mbps PHY。以太网 MAC 通过 SMI 接口控制 PHY,接口的时序由 MAC 自动实现,无需用户通过软件生成。RGMII接口支持发送时钟相位翻转和相对数据延迟,最大延迟 4 纳秒。以太网 MAC 支持标准 IEEE802.3 协议的以太网,支持魔法帧和特定唤醒帧。以太网收发器搭配的DMA 控制器以描述符的形式进行数据的收发管理和内存搬运,描述符的数量由用户根据沟通密集程度自行确定,DMA 控制器能以 32 位宽的速度向描述符指定的内存空间写入接收到的数据或从取出将发送的数据。此外,以太网收发器的 MAC 还支持 IEEE1588 精确时间协议。   CH32V3X7作为一款集成RISC-V内核的微控制器,其以太网模块支持动态主机配置协议(DHCP),可实现自动获取IP地址、子网掩码、网关等网络参数,简化网络设备配置流程。沁恒官方提供WCHNET协议栈库,封装了DHCP客户端功能,用户仅需调用WCHNET_DHCPStart()函数即可启动DHCP服务,无需深入理解协议细节。  
    3.png

   

  1. #ifndef __WCHNET_H__
  2. #define __WCHNET_H__

  3. #include "stdint.h"
  4. #ifndef NET_LIB
  5. #include "net_config.h"
  6. #endif
  7. #ifdef __cplusplus
  8. extern "C" {
  9. #endif

  10. #define WCHNET_LIB_VER                  0x11 /* 库版本号 */
  11. #define WCHNET_CFG_VALID                0x12345678 /* 配置值有效标志 */

  12. /* LED状态 @LED_STAT */
  13. #define  LED_ON                         0
  14. #define  LED_OFF                        1

  15. /* PHY 状态 @PHY_STAT */
  16. #define PHY_LINK_SUCCESS                (1 << 2) /* PHY建立连接 */
  17. #define PHY_AUTO_SUCCESS                (1 << 5) /* PHY自动协商完成 */

  18. /* 库初始化状态 @CFG_INIT_STAT */
  19. #define  INIT_OK                        0x00
  20. #define  INIT_ERR_RX_BUF_SIZE           0x01
  21. #define  INIT_ERR_TCP_MSS               0x02
  22. #define  INIT_ERR_HEAP_SIZE             0x03
  23. #define  INIT_ERR_ARP_TABLE_NEM         0x04
  24. #define  INIT_ERR_MISC_CONFIG0          0x05
  25. #define  INIT_ERR_MISC_CONFIG1          0x06
  26. #define  INIT_ERR_FUNC_SEND             0x09
  27. #define  INIT_ERR_CHECK_VALID           0xFF

  28. /* Socket 工作模式定义,协议类型 */
  29. #define PROTO_TYPE_IP_RAW               0     /* IP层原始数据 */
  30. #define PROTO_TYPE_UDP                  2     /* UDP协议类型 */
  31. #define PROTO_TYPE_TCP                  3     /* TCP协议类型 */

  32. /* 中断状态 */
  33. /* 以下为 GLOB_INT 会产生的状态 */
  34. #define GINT_STAT_UNREACH               (1 << 0) /* 不可达中断*/
  35. #define GINT_STAT_IP_CONFLI             (1 << 1) /* IP冲突*/
  36. #define GINT_STAT_PHY_CHANGE            (1 << 2) /* PHY状态改变 */
  37. #define GINT_STAT_SOCKET                (1 << 4) /* socket 产生中断 */

  38. /*以下为 Sn_INT 会产生的状态*/
  39. #define SINT_STAT_RECV                  (1 << 2) /* socket端口接收到数据或者接收缓冲区不为空 */
  40. #define SINT_STAT_CONNECT               (1 << 3) /* 连接成功,TCP模式下产生此中断 */
  41. #define SINT_STAT_DISCONNECT            (1 << 4) /* 连接断开,TCP模式下产生此中断 */
  42. #define SINT_STAT_TIM_OUT               (1 << 6) /* ARP和TCP模式下会发生此中断 */


  43. /* Definitions for error constants. @ERR_T */
  44. #define ERR_T
  45. #define WCHNET_ERR_SUCCESS              0x00  /* No error, everything OK */
  46. #define WCHNET_ERR_BUSY                 0x10  /* busy */
  47. #define WCHNET_ERR_MEM                  0x11  /* Out of memory error */
  48. #define WCHNET_ERR_BUF                  0x12  /* Buffer error */
  49. #define WCHNET_ERR_TIMEOUT              0x13  /* Timeout */
  50. #define WCHNET_ERR_RTE                  0x14  /* Routing problem */
  51. #define WCHNET_ERR_ABRT                 0x15  /* Connection aborted */
  52. #define WCHNET_ERR_RST                  0x16  /* Connection reset */
  53. #define WCHNET_ERR_CLSD                 0x17  /* Connection closed */
  54. #define WCHNET_ERR_CONN                 0x18  /* Not connected */
  55. #define WCHNET_ERR_VAL                  0x19  /* Illegal value */
  56. #define WCHNET_ERR_ARG                  0x1a  /* Illegal argument */
  57. #define WCHNET_ERR_USE                  0x1b  /* Address in use */
  58. #define WCHNET_ERR_IF                   0x1c  /* Low-level netif error  */
  59. #define WCHNET_ERR_ISCONN               0x1d  /* Already connected */
  60. #define WCHNET_ERR_INPROGRESS           0x1e  /* Operation in progress */
  61. #define WCHNET_ERR_SOCKET_MEM           0X20  /* Socket information error */
  62. #define WCHNET_ERR_UNSUPPORT_PROTO      0X21  /* unsupported protocol type */
  63. #define WCHNET_RET_ABORT                0x5F  /* command process fail */
  64. #define WCHNET_ERR_UNKNOW               0xFA  /* unknow */

  65. /* 不可达代码 */
  66. #define UNREACH_CODE_HOST               0     /* 主机不可达 */
  67. #define UNREACH_CODE_NET                1     /* 网络不可达 */
  68. #define UNREACH_CODE_PROTOCOL           2     /* 协议不可达 */
  69. #define UNREACH_CODE_PROT               3     /* 端口不可达 */
  70. /*其他值请参考RFC792文档*/

  71. /* TCP关闭参数 */
  72. #define TCP_CLOSE_NORMAL                0     /* 正常关闭,进行4此握手 */
  73. #define TCP_CLOSE_RST                   1     /* 复位连接,并关闭  */
  74. #define TCP_CLOSE_ABANDON               2     /* 内部丢弃连接,不会发送任何终止报文 */

  75. /* socket状态 */
  76. #define SOCK_STAT_CLOSED                0X00  /* socket关闭 */
  77. #define SOCK_STAT_OPEN                  0X05  /* socket打开 */

  78. /* TCP状态 */
  79. #define TCP_CLOSED                      0     /* TCP关闭 */
  80. #define TCP_LISTEN                      1     /* TCP监听 */
  81. #define TCP_SYN_SENT                    2     /* SYN发送,连接请求 */
  82. #define TCP_SYN_RCVD                    3     /* SYN接收,接收到连接请求 */
  83. #define TCP_ESTABLISHED                 4     /* TCP连接建立 */
  84. #define TCP_FIN_WAIT_1                  5     /* WAIT_1状态 */
  85. #define TCP_FIN_WAIT_2                  6     /* WAIT_2状态 */
  86. #define TCP_CLOSE_WAIT                  7     /* 等待关闭 */
  87. #define TCP_CLOSING                     8     /* 正在关闭 */
  88. #define TCP_LAST_ACK                    9     /* LAST_ACK*/
  89. #define TCP_TIME_WAIT                   10    /* 2MSL等待 */

  90. /* 以下值为固定值不可以更改 */
  91. #define WCHNET_MEM_ALIGN_SIZE(size)    (((size) + WCHNET_MEM_ALIGNMENT - 1) & ~(WCHNET_MEM_ALIGNMENT - 1))
  92. #define WCHNET_SIZE_IPRAW_PCB          0xFF   /* IPRAW PCB大小 */
  93. #define WCHNET_SIZE_UDP_PCB            0x30   /* UDP PCB大小 */
  94. #define WCHNET_SIZE_TCP_PCB            0xFF   /* TCP PCB大小 */
  95. #define WCHNET_SIZE_TCP_PCB_LISTEN     0x40   /* TCP LISTEN PCB大小 */
  96. #define WCHNET_SIZE_IP_REASSDATA       0x40   /* IP分片管理  */
  97. #define WCHNET_SIZE_PBUF               0x40   /* Packet Buf */
  98. #define WCHNET_SIZE_TCP_SEG            0x60   /* TCP SEG结构 */
  99. #define WCHNET_SIZE_MEM                0x0c   /* sizeof(struct mem) */
  100. #define WCHNET_SIZE_ARP_TABLE          0x20   /* sizeof ARP table */

  101. #define WCHNET_SIZE_POOL_BUF           WCHNET_MEM_ALIGN_SIZE(WCHNET_TCP_MSS + 40 + 14) /* pbuf池大小 */
  102. #define WCHNET_MEMP_SIZE               ((WCHNET_MEM_ALIGNMENT - 1) +                                                 \
  103.                           (WCHNET_NUM_IPRAW * WCHNET_MEM_ALIGN_SIZE(WCHNET_SIZE_IPRAW_PCB)) +                        \
  104.                           (WCHNET_NUM_UDP * WCHNET_MEM_ALIGN_SIZE(WCHNET_SIZE_UDP_PCB)) +                            \
  105.                           (WCHNET_NUM_TCP * WCHNET_MEM_ALIGN_SIZE(WCHNET_SIZE_TCP_PCB)) +                            \
  106.                           (WCHNET_NUM_TCP_LISTEN * WCHNET_MEM_ALIGN_SIZE(WCHNET_SIZE_TCP_PCB_LISTEN)) +              \
  107.                           (WCHNET_NUM_TCP_SEG * WCHNET_MEM_ALIGN_SIZE(WCHNET_SIZE_TCP_SEG)) +                        \
  108.                           (WCHNET_NUM_IP_REASSDATA * WCHNET_MEM_ALIGN_SIZE(WCHNET_SIZE_IP_REASSDATA)) +              \
  109.                           (WCHNET_NUM_PBUF * (WCHNET_MEM_ALIGN_SIZE(WCHNET_SIZE_PBUF) + WCHNET_MEM_ALIGN_SIZE(0))) + \
  110.                           (WCHNET_NUM_POOL_BUF * (WCHNET_MEM_ALIGN_SIZE(WCHNET_SIZE_PBUF) + WCHNET_MEM_ALIGN_SIZE(WCHNET_SIZE_POOL_BUF))))

  111. #define HEAP_MEM_ALIGN_SIZE          (WCHNET_MEM_ALIGN_SIZE(WCHNET_SIZE_MEM))
  112. #define WCHNET_RAM_HEAP_SIZE         (WCHNET_MEM_HEAP_SIZE + (2 * HEAP_MEM_ALIGN_SIZE) + WCHNET_MEM_ALIGNMENT)
  113. #define WCHNET_RAM_ARP_TABLE_SIZE    (WCHNET_SIZE_ARP_TABLE * WCHNET_NUM_ARP_TABLE)

  114. /* LED回调结构体 */
  115. typedef void (*led_callback)( uint8_t setbit );

  116. /* LED回调结构体 */
  117. typedef uint32_t (*eth_tx_set )( uint16_t len, uint32_t *pBuff );

  118. /* DNS回调结构体 */
  119. typedef void (*dns_callback)( const char *name, uint8_t *ipaddr, void *callback_arg );

  120. /* DHCP回调结构体 */
  121. typedef uint8_t (*dhcp_callback)( uint8_t status, void * );

  122. // 接收回调函数
  123. struct _SCOK_INF;
  124. typedef void (*pSockRecv)( struct _SCOK_INF *, uint32_t, uint16_t, uint8_t *, uint32_t);

  125. /* sokcet信息表 */
  126. typedef struct _SCOK_INF
  127. {
  128.     uint32_t IntStatus;                       /* 中断状态 */
  129.     uint32_t SockIndex;                       /* Socket索引值 */
  130.     uint32_t RecvStartPoint;                  /* 接收缓冲区的开始指针 */
  131.     uint32_t RecvBufLen;                      /* 接收缓冲区长度 */
  132.     uint32_t RecvCurPoint;                    /* 接收缓冲区的当前指针 */
  133.     uint32_t RecvReadPoint;                   /* 接收缓冲区的读指针 */
  134.     uint32_t RecvRemLen;                      /* 接收缓冲区的剩余长度 */
  135.     uint32_t ProtoType;                       /* 协议类型 */
  136.     uint32_t ScokStatus;                      /* 低字节Socket状态,次低字节为TCP状态,仅TCP模式下有意义 */
  137.     uint32_t DesPort;                         /* 目的端口 */
  138.     uint32_t SourPort;                        /* 源端口在IPRAW模式下为协议类型 */
  139.     uint8_t  IPAddr[4];                       /* Socket目标IP地址 32bit*/
  140.     void *Resv1;                              /* 保留,内部使用,用于保存各个PCB */
  141.     void *Resv2;                              /* 保留,内部使用,TCP Server使用 */
  142.     pSockRecv AppCallBack;                    /* 接收回调函数*/
  143. } SOCK_INF;

  144. struct _WCH_CFG
  145. {
  146.   uint32_t TxBufSize;   /* MAC发送缓冲区大小,保留使用 */
  147.   uint32_t TCPMss;      /* TCP MSS大小 */
  148.   uint32_t HeapSize;    /* 堆分配内存大小 */
  149.   uint32_t ARPTableNum; /* ARP列表个数 */
  150.   uint32_t MiscConfig0; /* 杂项配置0 */
  151.   /* 位0     TCP发送缓冲区复制 1:复制,0:不复制 */
  152.   /* 位1     TCP接收复制优化,内部调试使用 */
  153.   /* 位2     删除最早的TCP连接 1:启用,0:禁用  */
  154.   /* 位3-7   IP分片的PBUF个数  */
  155.   uint32_t MiscConfig1; /* 杂项配置1 */
  156.   /* 位0-7   Socket的个数 */
  157.   /* 位8-12  保留 */
  158.   /* 位13    PING使能,1:开启  0:关闭  */
  159.   /* 位14-18 TCP重传次数  */
  160.   /* 位19-23 TCP重传周期,单位为50毫秒  */
  161.   /* 位25    发送失败重试,1:启用,0:禁用 */
  162.   /* 位26-31 保留 */
  163.   led_callback led_link; /* PHY Link状态指示灯 */
  164.   led_callback led_data; /* 以太网通信指示灯 */
  165.   eth_tx_set net_send;
  166.   uint32_t   CheckValid;/* 配置值有效标志,固定值 @WCHNET_CFG_VALID */
  167. };

  168. struct _NET_SYS
  169. {
  170.   uint8_t  IPAddr[4];        /* IP地址 32bit */
  171.   uint8_t  GWIPAddr[4];      /* 网关地址 32bit */
  172.   uint8_t  MASKAddr[4];      /* 子网掩码 32bit */
  173.   uint8_t  MacAddr[8];       /* MAC地址 48bit */
  174.   uint8_t  UnreachIPAddr[4]; /* 不可到达IP */
  175.   uint32_t RetranCount;      /* 重试次数 默认为10次 */
  176.   uint32_t RetranPeriod;     /* 重试周期,单位MS,默认500MS */
  177.   uint32_t PHYStat;          /* PHY状态码 8bit */
  178.   uint32_t NetStat;          /* 以太网的状态 ,包含是否打开等 */
  179.   uint32_t MackFilt;         /*  MAC过滤,默认为接收广播,接收本机MAC 8bit */
  180.   uint32_t GlobIntStatus;    /* 全局中断 */
  181.   uint32_t UnreachCode;      /* 不可达 */
  182.   uint32_t UnreachProto;     /* 不可达协议 */
  183.   uint32_t UnreachPort;      /* 不可到达端口 */
  184.   uint32_t SendFlag;
  185.   uint32_t Flags;
  186. };

  187. /* KEEP LIVE配置结构体 */
  188. struct _KEEP_CFG
  189. {
  190.   uint32_t KLIdle;  /* KEEPLIVE空闲时间,单位ms */
  191.   uint32_t KLIntvl; /* KEEPLIVE周期,单位ms */
  192.   uint32_t KLCount; /* KEEPLIVE次数 */
  193. };

  194. /**
  195. * [url=home.php?mod=space&uid=247401]@brief[/url]   库初始化.
  196. *
  197. * @param   ip - IP地址
  198. * @param   gwip - 网关
  199. * @param   mask - 子网掩码
  200. * @param   macaddr - MAC地址
  201. *
  202. * [url=home.php?mod=space&uid=266161]@return[/url]  @ERR_T
  203. */
  204. uint8_t WCHNET_Init(const uint8_t *ip, const uint8_t *gwip, const uint8_t *mask, const uint8_t *macaddr);

  205. /**
  206. * [url=home.php?mod=space&uid=247401]@brief[/url]   获取版本号
  207. *
  208. * @param   None
  209. *
  210. * [url=home.php?mod=space&uid=266161]@return[/url]  库版本
  211. */
  212. uint8_t WCHNET_GetVer(void);

  213. /**
  214. * @brief   获取MAC地址
  215. *
  216. * @param(in)   macaddr - 内存地址
  217. *
  218. * @param(out)  mac地址
  219. *
  220. * @return  None
  221. */
  222. void WCHNET_GetMacAddr(uint8_t *macaddr);

  223. /**
  224. * @brief   库参数配置
  225. *
  226. * @param   cfg -配置参数 @_WCH_CFG
  227. *
  228. * @return  库配置初始化状态 @CFG_INIT_STAT
  229. */
  230. uint8_t WCHNET_ConfigLIB(struct _WCH_CFG *cfg);

  231. /**
  232. * @brief   库主任务函数,需要一直不断调用
  233. *
  234. * @param   None
  235. *
  236. * @return  None
  237. */
  238. void WCHNET_MainTask(void);

  239. /**
  240. * @brief   时钟中断服务函数,需配置时钟周期
  241. *
  242. * @param   timperiod - 时钟周期,单位ms
  243. *
  244. * @return  None
  245. */
  246. void WCHNET_TimeIsr( uint16_t timperiod);

  247. /**
  248. * @brief   以太网中断服务函数,产生以太网中断后调用
  249. *
  250. * @param   None
  251. *
  252. * @return  None
  253. */
  254. void WCHNET_ETHIsr(void);

  255. /**
  256. * @brief   Get PHY status
  257. *
  258. * @param   None
  259. *
  260. * @return  PHY 状态 @PHY_STAT
  261. */
  262. uint8_t WCHNET_GetPHYStatus(void);

  263. /**
  264. * @brief   查询全局中断
  265. *
  266. * @param   None
  267. *
  268. * @return  GLOB_INT
  269. */
  270. uint8_t WCHNET_QueryGlobalInt(void);

  271. /**
  272. * @brief   读全局中断并将全局中断清零
  273. *
  274. * @param   None
  275. *
  276. * @return  GLOB_INT
  277. */
  278. uint8_t WCHNET_GetGlobalInt(void);

  279. /**
  280. * @brief   创建socket
  281. *
  282. * @param(in)   *socketid - 内存地址
  283. * @param       socinf - 创建socket的配置参数 @SOCK_INF
  284. *
  285. * @param(out)  *socketid - socketID值
  286. *
  287. * @return  @ERR_T
  288. */
  289. uint8_t WCHNET_SocketCreat( uint8_t *socketid, SOCK_INF *socinf);

  290. /**
  291. * @brief   Socket发送数据
  292. *
  293. * @param       socketid - socketID值
  294. * @param       *buf - 发送数据首地址
  295. * @param(in)   *len - 内存地址及期望发送的数据长度
  296. *
  297. * @param(out)  *len - 实际发送的数据长度
  298. *
  299. * @return  @ERR_T
  300. */
  301. uint8_t WCHNET_SocketSend( uint8_t socketid, uint8_t *buf, uint32_t *len);

  302. /**
  303. * @brief   Socket接收数据
  304. *
  305. * @param       socketid - socketID值
  306. * @param       *buf - 接收数据首地址
  307. * @param(in)   *len - 内存地址及期望读取的数据长度
  308. *
  309. * @param(out)  *buf - 写入读取到的数据内容
  310. * @param(out)  *len - 实际读取的数据长度
  311. *
  312. * @return  @ERR_T
  313. */
  314. uint8_t WCHNET_SocketRecv( uint8_t socketid, uint8_t *buf, uint32_t *len);

  315. /**
  316. * @brief   获取socket中断并清零
  317. *
  318. * @param   socketid - socketID值
  319. *
  320. * @return  Sn_INT
  321. */
  322. uint8_t WCHNET_GetSocketInt( uint8_t socketid );

  323. /**
  324. * @brief   获取socket接收长度
  325. *
  326. * @param       socketid - socketID值
  327. * @param(in)   *bufaddr - 内存地址
  328. *
  329. * @param(out)  *bufaddr - socket数据的首地址
  330. *
  331. * @return  数据长度
  332. */
  333. uint32_t WCHNET_SocketRecvLen( uint8_t socketid, uint32_t *bufaddr);

  334. /**
  335. * @brief   TCP连接
  336. *
  337. * @param   socketid - socketID值
  338. *
  339. * @return  @ERR_T
  340. */
  341. uint8_t WCHNET_SocketConnect( uint8_t socketid);

  342. /**
  343. * @brief   TCP监听
  344. *
  345. * @param   socketid - socketID值
  346. *
  347. * @return  @ERR_T
  348. */
  349. uint8_t WCHNET_SocketListen( uint8_t socketid);

  350. /**
  351. * @brief   关闭socket
  352. *
  353. * @param   socketid - socketID值
  354. * @param   mode - socket为TCP连接,参数为关闭的方式 @TCP关闭参数
  355. *
  356. * @return  @ERR_T
  357. */
  358. uint8_t WCHNET_SocketClose( uint8_t socketid, uint8_t mode );

  359. /**
  360. * @brief   修改接收缓冲区
  361. *
  362. * @param   socketid - socketID值
  363. * @param   bufaddr - 接收缓冲区地址
  364. * @param   bufsize - 接收缓冲区大小
  365. *
  366. * @return  None
  367. */
  368. void WCHNET_ModifyRecvBuf( uint8_t socketid, uint32_t bufaddr, uint32_t bufsize);

  369. /**
  370. * @brief   UDP发送,指定目的IP、目的端口
  371. *
  372. * @param       socketid - socketID值
  373. * @param       *buf - 发送数据的地址
  374. * @param(in)   *slen - 期望发送的长度地址
  375. * @param       *sip - 目的IP地址
  376. * @param       port - 目的端口号
  377. *
  378. * @param(out)  *slen - 实际发送的长度
  379. *
  380. * @return  @ERR_T
  381. */
  382. uint8_t WCHNET_SocketUdpSendTo( uint8_t socketid, uint8_t *buf, uint32_t *slen, uint8_t *sip, uint16_t port);

  383. /**
  384. * @brief   ASCII码地址转网络地址
  385. *
  386. * @param       *cp - 需转换的ASCII码地址
  387. * @param(in)   *addr - 转换后网络地址存放的内存首地址
  388. *
  389. * @param(out)  *addr - 转换后的网络地址
  390. *
  391. * @return  0:转换成功  1:转换失败
  392. */
  393. uint8_t WCHNET_Aton(const char *cp, uint8_t *addr);

  394. /**
  395. * @brief   网络地址转ASCII地址
  396. *
  397. * @param   *ipaddr - socketID值
  398. *
  399. * @return  转换后的ASCII地址
  400. */
  401. uint8_t *WCHNET_Ntoa( uint8_t *ipaddr);

  402. /**
  403. * @brief   设置socket的TTL
  404. *
  405. * @param   socketid - socketID值
  406. * @param   ttl - TTL值
  407. *
  408. * @return  @ERR_T
  409. */
  410. uint8_t WCHNET_SetSocketTTL( uint8_t socketid, uint8_t ttl);

  411. /**
  412. * @brief   立即启动TCP重传
  413. *
  414. * @param   socketid - socketID值
  415. *
  416. * @return  None
  417. */
  418. void WCHNET_RetrySendUnack( uint8_t socketid);

  419. /**
  420. * @brief   查询未发送成功的数据包
  421. *
  422. * @param       socketid - socketID值
  423. * @param(in)   *addrlist - 存放的内存首地址
  424. * @param       lislen - 存放的内存大小
  425. *
  426. * @param(out)  *addrlist - 未发送成功的数据包地址列表
  427. *
  428. * @return  未发送和未应答的数据段的个数
  429. */
  430. uint8_t WCHNET_QueryUnack( uint8_t socketid, uint32_t *addrlist, uint16_t lislen );

  431. /**
  432. * @brief   DHCP启动
  433. *
  434. * @param   dhcp - 应用层回调函数
  435. *
  436. * @return  @ERR_T
  437. */
  438. uint8_t WCHNET_DHCPStart( dhcp_callback dhcp );

  439. /**
  440. * @brief   DHCP停止
  441. *
  442. * @param   None
  443. *
  444. * @return  @ERR_T
  445. */
  446. uint8_t WCHNET_DHCPStop( void );

  447. /**
  448. * @brief   配置DHCP主机名
  449. *
  450. * @param   *name - DHCP主机名首地址
  451. *
  452. * @return  0成功,否则失败
  453. */
  454. uint8_t WCHNET_DHCPSetHostname(char *name);

  455. /**
  456. * @brief   Initialize the resolver: set up the UDP pcb and configure the default server
  457. *
  458. * @param   *dnsip - dns服务器IP地址
  459. * @param   port - dns服务器端口号
  460. *
  461. * @return  None
  462. */
  463. void WCHNET_InitDNS( uint8_t *dnsip, uint16_t port);

  464. /**
  465. * Resolve a hostname (string) into an IP address.
  466. *
  467. * @param   hostname - the hostname that is to be queried
  468. * @param   addr     - pointer to a struct ip_addr where to store the address if it is already
  469. *                     cached in the dns_table (only valid if ERR_OK is returned!)
  470. * @param   found    - a callback function to be called on success, failure or timeout (only if
  471. *                     ERR_INPROGRESS is returned!)
  472. * @param   arg      - argument to pass to the callback function
  473. *
  474. * @return  @ERR_T
  475. *   WCHNET_ERR_SUCCESS if hostname is a valid IP address string or the host name is already in the local names table.
  476. *   ERR_INPROGRESS     enqueue a request to be sent to the DNS server for resolution if no errors are present.
  477. */
  478. uint8_t WCHNET_HostNameGetIp( const char *hostname, uint8_t *addr, dns_callback found, void *arg );

  479. /**
  480. * @brief   配置库KEEP LIVE参数
  481. *
  482. * @param   *cfg - KEEPLIVE配置参数
  483. *
  484. * @return  None
  485. */
  486. void WCHNET_ConfigKeepLive( struct _KEEP_CFG *cfg );

  487. /**
  488. * @brief   配置socket KEEP LIVE使能
  489. *
  490. * @param   socketid - socketID值
  491. * @param   enable - 1:启用  0:关闭
  492. *
  493. * @return  @ERR_T
  494. */
  495. uint8_t WCHNET_SocketSetKeepLive( uint8_t socketid, uint8_t enable );

  496. /**
  497. * @brief   PHY状态改变配置
  498. *
  499. * @param   phy_stat - PHY状态值
  500. *
  501. * @return  None
  502. */
  503. void WCHNET_PhyStatus( uint32_t phy_stat );


  504. #ifdef __cplusplus
  505. }
  506. #endif
  507. #endif
main.c
  1. void WCHNET_HandleGlobalInt(void)
  2. {
  3.     u8  initstat;
  4.     u16 i;
  5.     u8  socketinit;

  6.     initstat = WCHNET_GetGlobalInt(); /* 获取全局中断标志*/
  7.     if(initstat & GINT_STAT_UNREACH){/* 不可达中断 */
  8.         debug_printf("GINT_STAT_UNREACH\r\n");
  9.     }
  10.     if(initstat & GINT_STAT_IP_CONFLI){/* IP冲突中断 */
  11.         debug_printf("GINT_STAT_IP_CONFLI\r\n");
  12.     }
  13.     if(initstat & GINT_STAT_PHY_CHANGE){/* PHY状态变化中断 */
  14.         i = WCHNET_GetPHYStatus(); /* 获取PHY连接状态*/
  15.         if(i & PHY_Linked_Status) {
  16.             debug_printf("PHY Link connected\r\n");
  17.         }
  18.         else {
  19.             debug_printf("PHY Link disconnected\r\n");
  20.         }
  21.     }
  22.     if(initstat & GINT_STAT_SOCKET){//socket通信
  23.         for(i = 0; i < WCHNET_MAX_SOCKET_NUM; i++){
  24.             socketinit = WCHNET_GetSocketInt(i);
  25.             if(socketinit){//有事件需要处理

  26.             }
  27.         }
  28.     }
  29. }

  30. /*********************************************************************
  31. * @fn      WCHNET_DHCPCallBack
  32. *
  33. * @brief   DHCPCallBack
  34. *
  35. * @return  DHCP status
  36. */
  37. u8 WCHNET_DHCPCallBack(u8 status, void *arg)
  38. {
  39.     u8 *p;
  40.     if(!status){
  41.         p = arg;
  42.         printf("DHCP Success\r\n");
  43.         memcpy(eth_ip_addr, p, 4);
  44.         memcpy(eth_gwip_addr, &p[4], 4);
  45.         memcpy(eth_ip_mask, &p[8], 4);
  46.         debug_printf("eth_ip_addr: %d.%d.%d.%d\r\n",eth_ip_addr[0],eth_ip_addr[1],eth_ip_addr[2],eth_ip_addr[3]);
  47.         debug_printf("eth_gwip_addr: %d.%d.%d.%d\r\n",eth_gwip_addr[0],eth_gwip_addr[1],eth_gwip_addr[2],eth_gwip_addr[3]);
  48.         debug_printf("eth_ip_mask: %d.%d.%d.%d\r\n",eth_ip_mask[0],eth_ip_mask[1],eth_ip_mask[2],eth_ip_mask[3]);
  49.         debug_printf("DNS1: %d.%d.%d.%d \r\n", p[12], p[13], p[14], p[15]);
  50.         debug_printf("DNS2: %d.%d.%d.%d \r\n", p[16], p[17], p[18], p[19]);
  51.         return 0;
  52.     }
  53.     else{
  54.         debug_printf("DHCP Fail %02x \r\n", status);
  55.         return 1;
  56.     }
  57. }

  58. int main(void)
  59. {
  60.         NVIC_PriorityGroupConfig(NVIC_PriorityGroup_2);
  61.         delay_init();
  62.         uart_init(115200, 115200);

  63.         //初始化以太网
  64.         if (eth_init()!=0) {
  65.             debug_printf("eth_init err\r\n");
  66.             delay_ms(100);
  67.         __disable_irq();
  68.         NVIC_SystemReset();//重启
  69.     }
  70.         WCHNET_DHCPStart(WCHNET_DHCPCallBack);                 /*开始DHCP,返回结果在WCHNET_DHCPCallBack函数中*/

  71.         printf("start\r\n");
  72.         while(1)
  73.     {
  74.         WCHNET_MainTask();           /*以太网库主任务函数,需要循环调用*/
  75.         if(WCHNET_QueryGlobalInt())  /*查询以太网全局中断,如果有中断,调用全局中断处理函数*/
  76.         {
  77.             WCHNET_HandleGlobalInt();
  78.         }
  79.         }
  80. }

  MAC地址:需唯一,可通过WCHNET_GetMacAddr()获取芯片内置地址或手动设置。
  回调函数:通过WCHNET_DHCPStart()注册,用于接收DHCP事件(成功/失败/超时)。
  主机名:可选配置,便于在路由器设备列表中识别设备。


应用场景:
  • 物联网设备
    CH32V307作为边缘节点,通过DHCP快速接入局域网,实现数据上传至云端(如MQTT协议)。例如,智能家居中的温湿度传感器,通电后自动获取IP并连接服务器。
  • 工业自动化
    在工厂网络中,设备需频繁更换位置或IP地址。DHCP功能可避免手动配置错误,提升部署效率。例如,PLC模块通过DHCP获取临时IP,完成调试后恢复静态IP。
  • 开发调试阶段
    使用DHCP可快速验证网络功能,无需预先规划IP地址。结合ping命令或网络调试助手,可快速定位连接问题。


微信图片_20250731175108.jpg

风之呢喃 发表于 2025-8-1 13:46 | 显示全部楼层
能ping通对吧。楼主是否可以把工程文件打包一份上传一下。
寂静之回响 发表于 2025-8-4 19:57 | 显示全部楼层
风之呢喃 发表于 2025-8-1 13:46
能ping通对吧。楼主是否可以把工程文件打包一份上传一下。

对的对的,我也想要工程代码,可以借鉴学习一下
您需要登录后才可以回帖 登录 | 注册

本版积分规则

认证:项目经理
简介:资深嵌入式开发工程师

95

主题

181

帖子

3

粉丝
快速回复 在线客服 返回列表 返回顶部