Crate artnet_protocol

source ·
Expand description

Contains the ArtCommand enum which holds the entire ArtNet protocol v4, as per https://artisticlicence.com/WebSiteMaster/User%20Guides/art-net.pdf

use artnet_protocol::*;
use std::net::{UdpSocket, ToSocketAddrs};

let socket = UdpSocket::bind(("0.0.0.0", 6454)).unwrap();
let broadcast_addr = ("255.255.255.255", 6454).to_socket_addrs().unwrap().next().unwrap();
socket.set_broadcast(true).unwrap();
let buff = ArtCommand::Poll(Poll::default()).write_to_buffer().unwrap();
socket.send_to(&buff, &broadcast_addr).unwrap();

loop {
    let mut buffer = [0u8; 1024];
    let (length, addr) = socket.recv_from(&mut buffer).unwrap();
    let command = ArtCommand::from_buffer(&buffer[..length]).unwrap();
     
    println!("Received {:?}", command);
    match command {
        ArtCommand::Poll(poll) => {
            // This will most likely be our own poll request, as this is broadcast to all devices on the network
        },
        ArtCommand::PollReply(reply) => {
            // This is an ArtNet node on the network. We can send commands to it like this:
            let command = ArtCommand::Output(Output {
                data: vec![1, 2, 3, 4, 5].into(), // The data we're sending to the node
                ..Output::default()
            });
            let bytes = command.write_to_buffer().unwrap();
            socket.send_to(&bytes, &addr).unwrap();
        },
        _ => {}
    }
}

Re-exports

Structs

  • The TalkToMe flag, as to be used in the Poll and PollReply message
  • ArtDmx is the data packet used to transfer DMX512 data. The format is identical for Node to Controller, Node to Node and Controller to Node.
  • Data in an ArtDmx data packet.
  • Used to poll the nodes in the network
  • Gets send by the nodes in the network as a response to the Poll message
  • A PortAddress is an unsigned integer from 0 to 32_767 (15-bit).

Enums

  • The ArtCommand, to be used for ArtNet.
  • All the possible errors this crate can encounter

Constants

  • The ArtNet header. This is the first 8 bytes of each message, and contains the text “Art-Net\0”
  • The protocol version. Anything above [4, 0] seems to work for the devices that this library was tested on.

Type Aliases

  • The result that this crate uses