etherdream 0.1.1

An EtherDream (laser projector DAC) library.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45

// Copyright (c) 2016 Brandon Thomas <bt@brand.io>, <echelon@gmail.com>
// Etherdream.rs, a library for the EtherDream laser projector DAC.

//! This module contains network-related functions unrelated to DAC control.

use error::EtherdreamError;
use net2::UdpBuilder;
use protocol::Broadcast;
use std::net::IpAddr;

/// The primary port for communications with the EtherDream.
pub const COMMUNICATION_PORT : u16 = 7765;

/// The port EtherDream broadcasts its availability on.
pub const BROADCAST_PORT : u16 = 7654;

/// A DAC found from listening to UDP broadcasts.
#[derive(Clone, Copy, Debug)]
pub struct SearchResult {
  /// IP address of the DAC.
  pub ip_address : IpAddr,

  /// The Broadcast that was sent.
  pub broadcast : Broadcast,
}

/// Blocking function that will return the first EtherDream DAC it finds
/// via listening for UDP broadcasts.
pub fn find_first_dac() -> Result<SearchResult, EtherdreamError> {
  let udp = UdpBuilder::new_v4()?;
  udp.reuse_address(true)?;

  let socket = udp.bind(("0.0.0.0", BROADCAST_PORT))?;

  let mut buf = [0u8; 128];
  let result = socket.recv_from(&mut buf)?;

  let broadcast = Broadcast::parse(&buf[0..36])?;

  Ok(SearchResult {
    ip_address : result.1.ip(),
    broadcast: broadcast,
  })
}