class YT8512H - YT8512H PHY控制

该类用于控制YT8512H/SZ18201型号以太网网卡设备。

当前仅支持EC200A系列

构造函数

ethernet.YT8512H

class ethernet.YT8512H(mac, ip='', subnet='', gateway='')

加载YT8512H驱动,初始化YT8512H phy设备,并返回YT8512H网卡对象。

参数描述:

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

方法

YT8512H.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', '', '')

YT8512H.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')

YT8512H.set_up

nic.set_up()

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

返回值描述:

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

YT8512H.set_down

nic.set_down()

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

返回值描述:

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

YT8512H.dhcp

nic.dhcp()

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

返回值描述:

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

YT8512H.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服务器辅地址

YT8512H.set_default_NIC

nic.set_default_NIC(ip)

默认网卡配置。

参数描述:

  • ip - 默认网卡ip地址。

返回值描述:

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

示例:

nic.set_default_NIC('192.168.1.100')

YT8512H.status

nic.status()

获取网卡当前状态。

返回值描述:

返回tuble类型。

格式内容如下:
(dev, active, link)

参数 类型 说明
dev bool 表示网卡设备是否连接正常,True/False表示有连接/未连接
active bool 表示网卡是否激活使用,True/False表示启用/禁用,与set_up/set_down对应
link bool 表示网卡网线是否连接,True/False表示已连接/未连接

YT8512H.speed

nic.speed()

获取网卡当前上下行速率。

返回值描述:

返回tuble类型。

格式内容如下:
(tx, rx)

参数 类型 说明
tx int 表示网卡当前发送数据速率,单位bps
rx int 表示网卡当前接收数据速率,单位bps

YT8512H.node

nic.node()

获取网卡当前已连接终端列表。

返回值描述:

返回list类型。

格式内容如下:
[(mac, ip, time),]

参数 类型 说明
mac byte 终端mac地址
ip str 终端ip地址
time int 终端已连接时长,单位秒