WIZnet-io6Library下载及使用

概观

io6Library是一个IPv6集成库，可以轻松集成和管理使用WIZnet硬连线双TCP / IP堆栈控制器（WIZCHIP）产品系列的用户应用程序。

io6Library用于管理依赖于用户特定MCU的代码，因此用户无需根据用户MCU执行io6Library的移植操作。（有关更多信息，请参见如何使用）

内容

io6Library可分为以下三种类型。

• Reigsters Defintion

　　　　通用寄存器：定义通用寄存器，如网络信息，模式，中断等。

　　　　套接字寄存器：定义SOCKET寄存器，如套接字模式，套接字通信，套接字中断等。

• 每个WIZCHIP I / O访问功能

　　　　基本I / O功能：通过WIZCHIP定义的HOST接口（SPI，BUS等）访问输入/输出的基本单元功能

　　　　公共寄存器访问功能：基于基本I / O功能访问公共寄存器的功能

　　　　SOCKET寄存器访问功能：基于基本I / O功能访问SOCKET寄存器的功能

• WIZCHIP控制API，用于用户应用程序集成，管理和迁移

　　　　SOCKET API：与BSD SOCKET API一样，SOCKET API提供可以与socket socket commuuincation相关的函数集

　　　　额外的API：它提供支持用户应用程序集成的功能，无论WIZCHIP特定的Regiter / Memory，Address Map，Features等等。：对于User Application的小占用空间，可以使用WIZCHIP I / O Access功能替换它。

有关更多详细信息，请参阅io6Library.chm

https://github.com/Wiznet/io6Library/blob/master/Doxygen/doc/io6Library.chm。

io6Library.chm可能不是最新的，所以请参考doxygen程序程序使用Doxyfile.dox项目制作的文档。如果您愿意，Doxygen程序可以将文档设置为chm，html或pdf。

目录

ioLibrary具有与上图相同的目录结构，主目录如下。

• 以太网络

　　　 WIZCHIP特定目录（EX>  W6100 - w6100.h，w6100.c）

　　　 SOCKET API：socket.h，socket.c

ioLibrary配置文件：wizchip_conf.h，wizchip_conf.c

• 互联网

　　　用于IP配置的Protcols（EX> DHCP，DNS）

　　　将添加一些协议

• 应用

　　　应用程序套接字模式定义：Application.h

Loopback：TCP，UDP Basic Skeleton Code，loopback.h，loopback.c

io6Library用户可以通过在wizchip_conf.h中仅修改一些定义来立即使用它。有关更多信息，请参见如何使用。

如何使用

io6Library配置

定义wizchip_conf.h中定义的WIZCHIP的类型和接口，以满足您的预期用途。

• 选择要使用的硬连线双TCP / IP堆栈控制器。在下图中，选择蓝色框中的列表之一，并将其​​选定为_WIZCHIP_，如红框。

• 选择用户将用于WIZCHIP Access的主机接口（并行总线，串行总线模式等）。在下图中，选择蓝色框中的列表之一，并将其​​选定为_WIZCHIP_IO_MODE_，如红框。

　　　　仅当使用并行总线模式时，必须将HOST的存储区基地址设置为WIZCHIPCHIP，如红色框。

　　　　

• WIZCHIP PHY访问模式配置如下图所示，选择蓝色框中定义的以太网PHY访问模式的两种方法之一，并将其​​定义为红色框。

　　　　 _PHY_IO_MODE_PHYCR_：它通过PHY命令和状态寄存器提供对WIZCHIP的以太网PHY的简单控制，如PHY操作模式和链路状态。

　　　　 _PHY__IO_MODE_MII_：通过MDC / MDIO信号直接控制WIZCHIP PHY的以太网PHY寄存器。

为WIZCHIP I / O访问创建用户定义的功能

根据您的HOST界面自行创建基本的Access I / O功能。这是因为每个用户HOST的接口控制方法不同。所以，你应该成功。

例如，如果您使用STM32FXXX的SPI1定义以下内容并控制WIZCHIP

＃定义 _WIZCHIP_IO_MODE_        _WIZCHIP_IO_MODE_SPI_VDM_

通过SPI接口创建基本单元功能，如WIZCHIP选择/取消选择，1字节读/写，临界区进入/退出等，如下所示。

通过SPI接口进行基本I / O访问功能，如WIZCHIP选择/取消选择，1字节读/写和临界区进入/退出，如下所示。

• WIZCHIP选择/取消选择：用于设置/复位与WIZCHIP的CSn引脚相连的STM32FXXX的任何GPIO的功能

void  your_wizchip_enable（void）

{

   / * void HAL_GPIO_WritePin（GPIO_TypeDef * GPIOx，uint16_t GPIO_Pin，GPIO_PinState PinState）* /

    HAL_GPIO_WritePin（GPIOD，GPIO_PIN_7，GPIO_PIN_RESET）

}

void  your_wizchip_disable（void）

{

   HAL_GPIO_WritePin（GPIOD，GPIO_PIN_7，GPIO_PIN_SET）

}

• WIZCHIP 1字节读/写：通过SPI接口读写1字节的功能

/ *通过SPI读取1个字节* /

 uint8_t  your_spi_read_byte（）

{

   uint8_t ret;

   / * HAL_StatusTypeDef HAL_SPI_Receive（SPI_HandleTypeDef * HSPI，uint8_t * pData所，uint16_t尺寸，uint32_t的超时）* /

    HAL_SPI_Receive（SPI1，＆RET，1，1000）;

   返回 ;

}

/ *通过SPI写入1个字节* /

 void  your_spi_wite_byte（ uint8_t wd）

{

  / * HAL_StatusTypeDef HAL_SPI_Transmit（SPI_HandleTypeDef * hspi，uint8_t * pData，uint16_t Size，uint32_t Timeout）; * /

   HAL_SPI_Transmit（SPI1，＆WD， 1， 1000）;

}

• WIZCHIP关键部分进入/退出：在WIZCHIP访问时防止诸如interupts和任务切换等事件的功能

void  your_critical_enter（void）

{

  __disable_irq（）;

}

void  your_critical_exit（void）

{

  __enable_irq（）;

}

• WIZCHIP N字节读/写功能：不是强制性的。：但是，如果要使用WIZCHIP使用DMA等外设进行高速访问，请按以下步骤进行操作。：即使不这样做，也可以使用N字节读/写访问，因为它是通过重复您的1字节读/写功能来执行的。

void  your_spi_dma_write_buf（uint8_t * pbuf，iodata_t len）

{

  / * HAL_StatusTypeDef HAL_SPI_Transmit_DMA（SPI_HandleTypeDef * hspi，uint8_t * pData，uint16_t Size）* /

   HAL_SPI_Transmit_DMA（SPI1，pbuf，（ uint16_t）len）;

}

void  your_spi_dma_read_buf（uint8_t * pbuf，iodata_t len）

{

  / * HAL_StatusTypeDef HAL_SPI_Receive_DMA（SPI_HandleTypeDef * hspi，uint8_t * pData，uint16_t Size）* /

   HAL_SPI_Receive_DMA（SPI1，pbuf，（ uint16_t）len）;

}

将您定义的函数注册到io6Library

在WIZCHIP初始化之前注册您在上述示例中制作的定义代码，如下所示。

＃包括 “ wizchip_conf.h ”   //仅仅只包括使用ioLibrary

void  main（void）

{

   uint16_t chip_id;

   wiz_NetTimeout tmp_timeout = 0 ;

   / *

    //初始化目标系统，如SPI，UART，DMA等。

* /   

   / *将您的基本访问功能注册到io6Library * /

   // WIZCHIP启用/禁用

   reg_wizchip_cs_cbfunc（your_wizchip_enable，your_wizchip_disable）;

   // WIZCHIP Critical Section 

   reg_wizchip_cris_cbfunc（your_critical_enter，your_critical_exit）;

   // WIZCHIP读/写功能

   reg_wizchip_spi_cbfunc（your_spi_read_byte，your_spi_write_byte， 0， 0）;

   //如果您为读/写功能设置了DMA功能，可以注册如下

   // reg_wizchip_spi_cbfunc（your_spi_read_byte，your_spi_write_byte，your_spi_dma_read_buf，your_spi_dma_write_buf）; 

   / *对于io6Library读/写测试* /

   //读取测试

   ctlwizchip（CW_GET_ID，＆chip_id）;
 //如果（chip_id！= 0x6100） printf（ “ ERROR：HOST I / F READ \ r \ n ”）检查读取测试的WIZCHIP ID值//这只是W6100的示例

   //写测试

   ctlwizchip（CW_PHY_RESET， 0）;  //检查物理PHY Link Led关闭然后再打开。

   // /////////////////////////////// 

   //欣赏，WIZCHIP＆io6Library // 

   //谢谢// 

   // /////////////////////////////// 

}