Distributed Display Protocol (DDP) in Rust

This package allows you to write pixel data to a LED strip over DDP Currently implements sending but haven't gotten to implementing response parsing, works for most use cases though.

You can use this to stream pixel data to WLED or any other DDP capable reciever.

Example

use anyhow::Result;
use ddp_rs::controller;
use std::{thread, time};

fn main() -> Result<()> {
    // Create new controller, listens on UDP 4080 by default
    let mut v = controller::Controller::new()?;

    // Connect to a DDP display with default pixel settings (RGB, 24 bits, ID 1)
    let (mut c, _) = v.connect(
        "10.0.1.9:4048",
        ddp_rs::protocol::PixelConfig::default(),
        ddp_rs::protocol::ID::default(),
    )?;

    // Write 4 pixels with no offset
    c.write(
        &vec![255, 255, 255, 128, 128, 12, 128, 128, 12, 128, 255, 12],
        0,
    )?;

    // WLED clears if we close the server so keeping it open to see result
    let ten_seconds = time::Duration::from_secs(10);
    thread::sleep(ten_seconds);

    Ok(())
}

or try it by running cargo run --example dev

Why?

I wish I could tell you. I've gone back and forth on these bespoke LED protocols and DDP seems like the most "sane" one although the "specification" is not great. TPM2.net was another possible protocol which i started to implement but stopped after I realized how bad it is. Artnet and E1.31 is great but then you have framerate problem (approx 40-44 FPS) to maintain backwards compatbility with DMX. DDP sits in the middle here as "sane" but not perfect, hence why I implemented it for whatever it is I'm doing. For any future "i'm going to invent my own LED protocol" people out there, take note from the people in broadcast video instead of your jank ham radio serial protocol.

Implemented

• Multiple connections
• Data slicing for more than 1500 bytes
• JSON parsing for recieving
• Tests for most of spec
• Timecode
• Broadcast
• TCP
• Sending JSON

Contributing

m8 just open a PR with some gucchimucchi code and I'll review it.