特殊库-network

blake

network — 网络配置

这个模块提供了网络驱动和程序配置。它可以驱动特定硬件的网络，配置网络接口，然后通过 socket 模块使用网络。使用网络模块必须安装带有网络驱动的固件。

例如:

configure a specific network interfacesee below for examples of specific drivers

1. import network
   
2. nic = network.Driver(…)
   
3. print(nic.ifconfig())

复制代码

now use socket as usual

1. import socket
   
2. addr = socket.getaddrinfo(‘micropython.org’, 80)[0][-1]
   
3. s = socket.socket()
   
4. s.connect(addr)
   
5. s.send(b’GET / HTTP/1.1\r\nHost: micropython.org\r\n\r\n’)
   
6. data = s.recv(1000)
   
7. s.close()

复制代码

class CC3K

提供 TI 的 CC3000 wifi 模块驱动。使用方法:

1. import network
   
2. nic = network.CC3K(pyb.SPI(2), pyb.Pin.board.Y5, pyb.Pin.board.Y4, pyb.Pin.board.Y3)
   
3. nic.connect(‘your-ssid’, ‘your-password’)
   
4. while not nic.isconnected():
   
5. pyb.delay(50)
   
6. print(nic.ifconfig())

复制代码

now use socket as usual

…

这个例子需要连接下面端口:

MOSI 连接到 Y8
MISO 连接到 Y7
CLK 连接到 Y6
CS 连接到 Y5
VBEN 连接到 Y4
IRQ 连接到 Y3

可以使用其它 SPI 总线和其它端口连接到 CS, VBEN 和 IRQ。

构造函数

class network.CC3K(spi, pin_cs, pin_en, pin_irq)
创建 CC3K 驱动对象，用指定的 spi 和 gpio 初始化 CC3000 模块，返回 CC3K 对象。

参数:

spi，连接到 CC3000 模块 的 SPI 对象 (MOSI, MISO 和 CLK 端口)。
pin_cs 连接到 CC3000 的 CS 端口。
pin_en 连接到 CC3000 的 VBEN 端口。
pin_irq 连接到 CC3000 的 IRQ 端口。

所有对象由驱动进行初始化，所以用户不用自己进行初始化。例如，你可以:

1. nic = network.CC3K(pyb.SPI(2), pyb.Pin.board.Y5, pyb.Pin.board.Y4, pyb.Pin.board.Y3)

复制代码

方法

1. cc3k.connect(ssid, key=None, *, security=WPA2, bssid=None)

复制代码

用给定的 SSID 和 密码等参数连接到 wifi 访问点。

cc3k.disconnect()
断开 wifi 连接。

cc3k.isconnected()
返回 True 如果已经连接到 wifi 并获取有效的 IP 地址，否则返回 False。

cc3k.ifconfig()
返回 7 参数元组 (ip, subnet mask, gateway, DNS server, DHCP server, MAC address, SSID)。

cc3k.patch_version()
返回补丁程序版本 (固件)。

cc3k.patch_program(‘pgm’)
上传固件到 CC3000。必须将‘pgm’做为第一个参数上传。

常数

CC3K.WEP
CC3K.WPA
CC3K.WPA2

使用的安全类型

class WIZNET5K

这个类允许控制 WIZnet5x00 使用了 W5200 或 W5500 芯片的以太网适配器 (仅测试了 W5200)。

例如:

1. import network
   
2. nic = network.WIZNET5K(pyb.SPI(1), pyb.Pin.board.X5, pyb.Pin.board.X4)
   
3. print(nic.ifconfig())

复制代码

now use socket as usual

…

这个例子中连接了下面端口到 WIZnet5x00 模块:

MOSI 连接到 X8
MISO 连接到 X7
SCLK 连接到 X6
nSS 连接到 X5
nRESET 连接到 X4

可以使用其它 SPI 总线和其它端口。

构造函数

class network.WIZNET5K(spi, pin_cs, pin_rst)

创建 WIZNET5K 对象，使用指定 SPI 和端口进行初始化，返回 WIZNET5K 对象。

参数:

spi 是连接 WIZnet5x00 的 SPI 对象 (包含 MOSI, MISO 和 SCLK 引脚)。
pin_cs 是连接 WIZnet5x00 nSS 引脚的 Pin 对象。
pin_rst 是连接到 WIZnet5x00 nRESET 的 Pin 对象。

所有这些对象由驱动进行初始化，因此无需预先初始化。例如:

1. nic = network.WIZNET5K(pyb.SPI(1), pyb.Pin.board.X5, pyb.Pin.board.X4)

复制代码

方法

1. wiznet5k.ifconfig([(ip, subnet, gateway, dns)])

复制代码

获取/设置 IP 地址, 子网掩码, 网关和 DNS。

当不带参数时，返回上述参数的 4 参数元组。设置参数时，传递 4 参数元组。例如:

1. nic.ifconfig((‘192.168.0.4’, ‘255.255.255.0’, ‘192.168.0.1’, ‘8.8.8.8’))

复制代码

wiznet5k.regs()
转储 WIZnet5x00 寄存器，通常用于调试。