Ryan Summers 9327809fe7

* Adding TCP-based NAL implementation

* Updating NAL dependency

* Updating connect to handle network errors

* Adding support for getting IP and MAC, allowing transparent access to the W5500 in the interface.

* Fixing TCP connect when not in INIT

* Adding wait after reset

* Reverting changes

* More delta reductions

* Fixing format

* Updating changelog

* Fixing docs

* Updating NAL version

* Adding debug derive

* fixing TCP write

* Updating RX receive size to allow less than 8 bytes

* Fixing clippy lints

2022-01-23 13:30:08 +01:00

3.2 KiB

Raw Blame History

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.

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> 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

Initialization and usage of owned Device:

    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]));
    device.close(socket);

    // optional
    let (spi_bus, inactive_device) = device.deactivate();

Usage of borrowed SPI-Bus and previously initialized Device:

    let mut spi = ...; // SPI interface to use
    let mut cs: OutputPin = ...; // chip select

    let mut device: Option<InactiveDevice<..>> = ...; // maybe: previously initialized device
    let mut socket: Option<Socket> = ...; // maybe: previously opened socket
    
    if let (Some(socket), Some(device)) = (socket.as_mut(), device.as_mut()) {
        let mut buffer = [0u8; 1024];
        match device
            // scoped activation & usage of the SPI bus without move
            .activate_ref(FourWireRef::new(&mut spi, &mut cs))
            .receive(socket, &mut buffer)
        {
            Ok(..) => todo!(),
            Err(..) => todo!(),
        }
    }

Todo

In no particular order, things to do to improve this driver.

Add support for TCP server implementations
Add support for DHCP

3.2 KiB Raw Blame History

W5500 Driver

Embedded-HAL

Example Usage

Todo

3.2 KiB

Raw Blame History