class W5500 - W5500以太网卡控制

该类用于控制W5500型号以太网网卡设备。

当前仅支持EC600N/EC600U/EC600M/EC800M/EG912N/EG915N/EC200U/EG915U系列

构造函数

ethernet.W5500

class ethernet.W5500(mac, ip='', subnet='', gateway='', spi_port=-1, spi_cs_pin=-1, extint_pin=-1, reset_pin=-1, work_mode=0)

加载W5500驱动,初始化W5500以太网卡,并返回W5500网卡对象。

参数描述:

  • mac - 字节流,6字节长度的 mac 地址。
  • ip - 以太网卡的 ip 地址,若值为空字符串'',表示使用默认值192.168.1.100
  • subnet - 以太网卡的子网掩码地址,若值为空字符串'',表示使用默认值255.255.255.0
  • gateway - 以太网卡的网关地址,若值为空字符串'',表示将 ip 地址的最后一位替换成1作为网关。
  • spi_port - 连接W5500SPI端口,默认值为-1,表示使用上次配置的值,程序中默认配置为 SPI1 端口。
  • spi_cs_pin - 连接W5500SPI 片选GPIO管脚,默认值为-1,表示使用上次配置的值,程序中默认配置为 Pin.GPIO34
  • extint_pin - 连接W5500的外部中断GPIO管脚,默认值为-1,表示上次配置的值,程序中默认配置为 Pin.GPIO19
  • reset_pin - 连接W5500的重置GPIO管脚,默认值为-1, 表示上次配置的值,程序中默认配置为 Pin.GPIO17
  • work_mode - 以太网工作模式配置,默认为终端模式,0/1 分别表示终端模式/网关模式。终端模式表示该模块作为终端设备连接供网设备上网。网关模式表示该模块作为网关,为外部设备提供网络访问,通过4G上网。

方法

W5500.set_addr

nic.set_addr(ip, subnet, gateway)

网卡静态ip地址配置。

参数描述:

  • ip - 以太网卡的 ip 地址,若值为空字符串'',表示使用默认值192.168.1.100
  • subnet - 以太网卡的子网掩码地址,若值为空字符串'',表示使用默认值255.255.255.0
  • gateway - 以太网卡的网关地址,若值为空字符串'',表示将 ip 地址的最后一位替换成1作为网关。

返回值描述:

成功返回整型值0,失败返回整型值-1。

示例:

nic.set_addr('192.168.1.100', '', '')

W5500.set_dns

nic.set_dns(primary_dns, secondary_dns)

网卡dns服务器配置。

参数描述:

  • primary_dns - DNS服务器主地址。
  • secondary_dns - DNS服务器辅地址。

返回值描述:

成功返回整型值0,失败返回整型值-1。

示例:

nic.set_dns('8.8.8.8', '114.114.114.114')

W5500.set_up

nic.set_up()

网卡启动,启动后网卡正常处理网口网络报文。

返回值描述:

成功返回整型值0,失败返回整型值-1。

W5500.set_down

nic.set_down()

网卡禁用,禁用后网卡不再处理网口网络报文。

返回值描述:

成功返回整型值0,失败返回整型值-1。

W5500.dhcp

nic.dhcp()

动态ip获取,此方法是作为终端模式下使用,从而自动获取ip信息。

返回值描述:

成功返回整型值0,失败返回整型值-1。

W5500.ipconfig

nic.ipconfig()

获取网卡网络信息,通过该方法获取到mac地址、主机名、IP地址类型、IP地址、子网掩码、网关地址和DNS服务器地址。

返回值描述:

返回list类型。

格式如下:
[(mac, hostname), (iptype, ip, subnet, gateway, primary_dns,secondary_dns)]

参数 类型 说明
mac str mac地址,格式为'XX-XX-XX-XX-XX-XX'
hostname str 网卡名称
iptype str ip类型,4表示ipv46表示ipv6,目前仅支持ip4
ip str ip地址
subnet str 子网掩码
gateway str 网关
primary_dns str DNS服务器主地址
secondary_dns str DNS服务器辅地址

W5500.set_default_NIC

nic.set_default_NIC(ip)

默认网卡配置。

参数描述:

  • ip - 默认网卡ip地址。

返回值描述:

成功返回整型值0,失败返回整型值-1。

示例:

nic.set_default_NIC('192.168.1.100')