#seeed #embedded-hal #no-std #wio-terminal

no-std seeed-erpc

Driver crate for interacting with seeed-studio eRPC Wifi devices

4 releases

0.1.1 Dec 31, 2020
0.1.0 Dec 6, 2020
0.0.2 Dec 2, 2020
0.0.1 Dec 2, 2020

#1314 in Embedded development

Download history 25/week @ 2023-12-04 4/week @ 2023-12-11 1/week @ 2023-12-18 15/week @ 2024-01-01 59/week @ 2024-01-08 32/week @ 2024-01-15 54/week @ 2024-01-22 4/week @ 2024-02-05 15/week @ 2024-02-12 16/week @ 2024-02-19 29/week @ 2024-02-26 51/week @ 2024-03-04 12/week @ 2024-03-11 9/week @ 2024-03-18

102 downloads per month
Used in wio_terminal

MIT/Apache

36KB
913 lines

seeed-erpc-rs

Crates.io usbd-hid

An embedded / no-std implementation of Seeed Studio's eRPC protocol, which is used to communicate with their RTL8720 firmware.

Most notably, this is the main firmware for the wifi chip in their Wio Terminal product.

WIP - most RPCs are not yet implemented.

Usage

Have a look at the Wio terminal BSP implementation for an example of how to use this.

To summarize:

  1. Generate the request bytes by combining the bytes generated by RPC::header(sequence_number) with the bytes extended from RPC::args(&mut buff).
  2. Transmit FrameHeader::new_from_msg(request_bytes) followed by request_bytes itself.
  3. Receive 4 bytes from the remote end (the frame header), and parse them using FrameHeader::parse().
  4. Receive the response payload by reading the next frame_header.msg_length bytes.
  5. Verify the CRC by calling frame_header.check_crc(&payload_bytes).
  6. Finally, get the result of the RPC by calling RPC::parse(&payload_bytes).

Handling 'callback' messages

Sometimes the remote end will send you data even if you didn't ask for it. These are the 'callback' service 'oneway' RPCs. Handling these is a little annoying. The trick is to repeat steps 3-6 above if you get the error Err::NotOurs back from RPC::parse().

Dependencies

~2MB
~41K SLoC