#display #udp #pixel #point #matrix #service #cccb

servicepoint

A rust library for the CCCB Service Point Display

11 releases (breaking)

new 0.13.0 Jan 16, 2025
0.12.0 Nov 23, 2024
0.11.0 Nov 13, 2024
0.7.0 Jun 27, 2024

#164 in Compression


Used in servicepoint_binding_c

GPL-3.0-or-later

125KB
2.5K SLoC

servicepoint

crates.io Crates.io Total Downloads docs.rs GPLv3 licensed

In CCCB, there is a big pixel matrix hanging on the wall. It is called "Service Point Display" or "Airport Display". This crate contains a library for parsing, encoding and sending packets to this display via UDP.

Installation

cargo add servicepoint

or

[dependencies]
servicepoint = "0.13.0"

Examples

fn main() {
    // establish connection
    let connection = servicepoint::Connection::open("172.23.42.29:2342")
        .expect("connection failed");

    // clear screen content
    connection.send(servicepoint::Command::Clear)
        .expect("send failed");
}

More examples are available in the crate. Execute cargo run --example for a list of available examples and cargo run --example <name> to run one.

Note on stability

This library can be used for creative project or just to play around with the display. A decent coverage by unit tests prevents major problems and I also test this with my own projects, which mostly use up-to-date versions.

That being said, the API is still being worked on. Expect minor breaking changes with every version bump. Please specify the full version including patch in your Cargo.toml until 1.0 is released.

Features

This library has multiple optional dependencies. You can choose to (not) include them by toggling the related features.

Name Default Description
compression_zlib false Enable additional compression algo
compression_bzip2 false Enable additional compression algo
compression_lzma true Enable additional compression algo
compression_zstd false Enable additional compression algo
protocol_udp true Connection::Udp
protocol_websocket false Connection::WebSocket
rand false impl Distribution for Standard
cp437 true Conversion to and from CP-437

Everything else

Look at the main project README for further information.

Dependencies

~1.2–2.5MB
~54K SLoC