class YT8512H - YT8512H PHY控制
2023-08-31
该类用于控制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 表示ipv4 ,6 表示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 |
终端已连接时长,单位秒 |