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
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148

//! A basic server implementation for [Serial Studio](https://github.com/Serial-Studio/Serial-Studio)
//!
//! ## Basic usage
//!
//! ```
//! use serialstudio::SerialStudioSource;
//!
//! // Create server
//! let mut server = SerialStudioSource::new();
//! 
//! // Start
//! server.start("localhost:8019".to_string());
//! 
//! loop {
//!     // Do stuff 
//!     // ...
//! }
//! 
//! // Stop
//! server.stop();
//! ```

use std::{
    io::Write,
    net::TcpListener,
    sync::mpsc::{self, Sender},
};

pub mod data;
pub mod friendly;

use data::TelemetryFrame;
use std::thread;

struct State {
    new_frame: Option<TelemetryFrame>,
    running: bool,
}

/// A single-connection server for SerialStudio
pub struct SerialStudioSource {
    running: bool,
    chan_to_thread: Option<Sender<State>>,
}

impl SerialStudioSource {
    pub fn new() -> Self {
        Self {
            running: false,
            chan_to_thread: None,
        }
    }

    /// Start the server
    pub fn start(&mut self, bind_addr: String) {
        // Build a thread-safe channel for sending data
        let (tx, rx) = mpsc::channel();
        self.chan_to_thread = Some(tx);

        // Send initial state to the thread
        let _ = self
            .chan_to_thread
            .as_ref()
            .unwrap()
            .send(State {
                new_frame: None,
                running: true,
            })
            .unwrap();
        self.running = true;

        // Execution thread
        thread::spawn(move || {
            // Create a listener
            let listener = TcpListener::bind(bind_addr).unwrap();

            loop {
                println!("Waiting for a SerialStudio session to attach");

                // Get a stream
                let stream = listener.accept();

                if stream.is_ok() {
                    let mut stream = stream.unwrap();
                    println!("Connection established!");

                    // Event loop
                    loop {
                        let new_data: State = rx.recv().unwrap();

                        // Kill on stop
                        if !new_data.running {
                            return;
                        }

                        // Send frame
                        if new_data.new_frame.is_some() {
                            // Get data
                            let obj = new_data.new_frame.unwrap();

                            // Serialize
                            let json = serde_json::to_string(&obj).unwrap();

                            // Send
                            let result = stream.0.write(format!("/*{}*/\n", json).as_bytes());

                            if result.is_err() {
                                println!("Failed to write telemetry update over TCP");
                                break;
                            }
                        }
                    }
                }

                println!("SerialStudio disconnected");
            }
        });
    }

    /// Stop the server
    pub fn stop(&mut self) {
        self.running = false;
        let _ = self
            .chan_to_thread
            .as_ref()
            .unwrap()
            .send(State {
                new_frame: None,
                running: false,
            })
            .unwrap();
    }

    /// Publish a new frame
    pub fn publish(&mut self, frame: TelemetryFrame) {
        if self.running && self.chan_to_thread.is_some() {
            let _ = self
                .chan_to_thread
                .as_ref()
                .unwrap()
                .send(State {
                    new_frame: Some(frame),
                    running: true,
                })
                .unwrap();
        }
    }
}