Management Component Transport Protocol (MCTP) support for Rust

This workspace repository contains a set of crates providing MCTP support, primarily for use in embedded applications.

Component Crates

• mctp implements base type and trait definitions

• mctp-linux implements a transport implementation, using the Linux kernel MCTP sockets support for message send/receive

• pldm provides Platform Level Data Model (PLDM) base definitions on top of the generic MCTP support

• pldm-fw uses the pldm base definitions to implement the PLDM for Firmware Update protocol as a library, as well as a command-line firmware update utility

Examples

There's a small example MCTP requester in mctp-linux/examples:

    // Create a new endpoint using the linux socket support
    let mut ep = MctpLinuxEp::new(EID, MCTP_NET_ANY)?;

    // for subsequent use of `ep`, we're just interacting with the
    // mctp::Endpoint trait, which are independent of the socket support

    // Get Endpoint ID message: command 0x02, no data. Allow the MCTP stack
    // to allocate an owned tag.
    let tx_buf = vec![0x02u8];
    ep.send(MCTP_TYPE_CONTROL, Tag::OwnedAuto, &tx_buf)?;

    // Receive a response. We create a 16-byte vec to read into; ep.recv()
    // will return the sub-slice containing just the response data.
    let mut rx_buf = vec![0u8; 16];
    let (rx_buf, eid, tag) = ep.recv(&mut rx_buf)?;