56 lines
2.3 KiB
Markdown
56 lines
2.3 KiB
Markdown
# W5500 Driver
|
|
|
|
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.
|
|
|
|
|
|
[](https://github.com/kellerkindt/w5500/actions?query=workflow%3ARust)
|
|
[](https://github.com/kellerkindt/w5500)
|
|
[](https://crates.io/crates/w5500)
|
|
[](https://docs.rs/w5500)
|
|
[](https://github.com/kellerkindt/w5500/issues/new)
|
|
|
|
|
|
## Embedded-HAL
|
|
|
|
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>`](https://docs.rs/embedded-hal/0.2.3/embedded_hal/spi/trait.FullDuplex.html) interface can use
|
|
this driver.
|
|
|
|
# Example Usage
|
|
|
|
Below is a basic example of sending UDP packets to a remote host. 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:
|
|
|
|
* Data Order: Most significant bit first
|
|
* Clock Polarity: Idle low
|
|
* Clock Phase: Sample leading edge
|
|
* Clock speed: 33MHz maximum
|
|
|
|
```rust
|
|
let mut spi = ...; // SPI interface to use
|
|
let mut cs : OutputPin = ...; // chip select
|
|
|
|
// alternative FourWireRef::new(&mut spi, &mut cs)
|
|
let device = UninitializedDevice::new(FourWire::new(spi, cs))
|
|
.initialize_manual(
|
|
MacAddress::new(0, 1, 2, 3, 4, 5),
|
|
Ipv4Addr::new(192, 168, 86, 79),
|
|
Mode::default()
|
|
).unwrap();
|
|
let socket = device.socket();
|
|
socket.connect(
|
|
SocketAddr::new(IpAddr::V4(Ipv4Addr::new(192, 168, 86, 38)), 8000),
|
|
).unwrap();
|
|
block!(interface.send(&mut socket, &[104, 101, 108, 108, 111, 10]));
|
|
interface.close(socket);
|
|
```
|
|
|
|
## Todo
|
|
|
|
In no particular order, things to do to improve this driver.
|
|
|
|
* Add support for TCP
|
|
* Add support for DHCP
|