websocket-serial-server (wsss)

Connect to and read / write serial ports over websockets. In Rust

There is a need for a way to interface with hardware for software running in web browsers. WebUSB and the HTML5 serial spec are still immature.

Alpha, but works for me

Currently there is no security, the connection is NOT encrypted

Features

Written in Rust, so robust and memory safe.
All requests and responses are JSON based
Supports sending and receiving binary data, as base64 encoded strings
Clients can subscribe to multiple ports
Clients can write lock ports, so they are the only one who can send data to it. Writing to a port can not happen till port is write locked. This prevents corruption
Ports are only closed when all clients have closed it
Data read from port is broadcast to all clients who opeoned it.
Ports are automatically cleaned up if read/write errors occur
Opening the same port twice will not cause corruption of data send to a client ( as seen in SPJS ).
Supports port enumeration.
simple programming model consisting of threads and event loops, which is fine for dozens of clients and ports.
1. As the async paradigm in rust matures, will move to that model
Simple architecture and code base.

Documentation

Limitations

Currently Websocket-rs is not tokio based, so it spawns a thread per connection. For having a few clients talk to a 3D printer, CNC machine, or other such use case, this is fine.

Once Websocket-rs moves to tokio, this limitation can be removed

There is no support for custom protocol or buffer handlers. That should be handled by client libraries. The purpose of wsss is to simply get data from a serial port to clients and vice-versa.

Developing

Dependencies

Linux

sudo apt-get install libudev-dev
sudo apt-get install libssl-dev
sudo apt-get install pkg-config

Windows

Unknown, help appreciated.

OSX

Unknown, help appreciated.

Vscode-Rust setup

If you are using the vscode rust plugin, here is an example of the settings I am using

The rust.rls is the most important one.

// Place your settings in this file to overwrite the default settings
{
    "rust.rls": {
        "executable": "rustup",
        "args": [
            "run",
            "nightly",
            "rls"
        ]
    },
    //"editor.formatOnSave": true,
    //"editor.fontFamily": "Fira Code"
}

Running

build:

cargo build or cargo build --release

run:

./target/debug/wsss, or if built with --release, ./target/release/wsss

use -p or --port to set http port (default is 8080)

then browse to http://localhost:PORT to find the test page.

Logging

Wsss makes extensive use of logging and the env_logger crate

Please read the env_logger docs for more information, but here is a quick example:

RUST_LOG=debug ./target/debug/wsss

Microtome/websocket-serial-server