This crate is a driver for the WIZnet W5500 chip. The W5500 chip is a hardwired TCP/IP embedded Ethernet controller that enables embedded systems using SPI (Serial Peripheral Interface) to access the LAN. It is one of the more popular ethernet modules on Arduino platforms.
Embedded-HAL is a standard set of traits meant to permit communication between MCU implementations and hardware drivers
like this one. Any microcontroller that implements the
spi::FullDuplex<u8> interface can use
this driver.
This driver is built in several layers of structs.
The lowest level (and the first a program would instantiate) is the W5500 struct. It contains a reference to the
chip-select pin.
The next layer is the ActiveW5500 struct. It contains a reference to a W5500 instance, and an implementation of
the spi::FullDuplex<u8> trait. It has
the ability to actually communicate with the chip. It has general methods for reading/writing to the chip, and
higher-level functions that can set up specific configuration, like the MAC address, etc.
The last layer is the network protocol. Currently that is only Udp. Udp is a tuple struct made up of an
ActiveW5500 and a Socket. This last layer can be used to send and receive UDP packets over the network via the
receive and blocking_send methods.
Below is a basic example of listening for UDP packets and replying. An important thing to confirm is the configuration of the SPI implementation. It must be set up to work as the W5500 chip requires. That configuration is as follows:
```rust let mut spi = ...; // SPI interface to use let mut cs_w5500 : OutputPin = ...; // chip select
let mut w5500 = W5500::with_initialisation(
&mut cs_w5500, // borrowed for whole W5500 lifetime
&mut spi, // borrowed for call to `with_initialisation` only
OnWakeOnLan::Ignore,
OnPingRequest::Respond,
ConnectionType::Ethernet,
ArpResponses::Cache,
).unwrap();
let mut active = w5500.activate(&mut spi).unwrap();
// using a 'locally administered' MAC address
active.set_mac(MacAddress::new(0x02, 0x01, 0x02, 0x03, 0x04, 0x05)).unwrap();
active.set_ip(IpAddress::new(192, 168, 0, 222)).unwrap();
active.set_subnet(IpAddress::new(255, 255, 255, 0)).unwrap();
active.set_gateway(IpAddress::new(192, 168, 0, 1)).unwrap();
let socket0: UninitializedSocket = w5500.take_socket(Socket::Socket0).unwrap();
let udp_server_socket = (&mut w5500, socket0).try_into_udp_server_socket(1234).unwrap();
let mut buffer = [0u8; 256];
let response = [104, 101, 108, 108, 111, 10];// "hello" as ASCII
loop {
if let Ok(Some((ip, port, len))) = udp_server_socket.receive(&mut buffer[..]) {
udp_server_socket.blocking_send(ip, port, response[..]).unwrap();
}
}
```
In no particular order, things to do to improve this driver.