https://github.com/kaesaecracker/servicepoint-simulator

A simulator for the CCCB service point display.
https://github.com/kaesaecracker/servicepoint-simulator

cccb cccb-servicepoint

Last synced: about 2 months ago
JSON representation

A simulator for the CCCB service point display.

• Host: GitHub
• URL: https://github.com/kaesaecracker/servicepoint-simulator
• Owner: kaesaecracker
• License: gpl-3.0
• Created: 2024-05-08T10:43:24.000Z (8 months ago)
• Default Branch: main
• Last Pushed: 2024-09-07T13:35:33.000Z (4 months ago)
• Last Synced: 2024-09-07T15:06:16.490Z (4 months ago)
• Topics: cccb, cccb-servicepoint
• Language: Rust
• Homepage:
• Size: 373 KB
• Stars: 2
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# servicepoint-simulator

An emulator for the CCCB airport display. 

![example render](example_render.png)

In CCCB, there is a big LED matrix screen you can send images to via UDP. 

This project aims to build a working an application that can receive packages in the same binary format and display the contents to the user.

Use cases:

- getting error messages for invalid packages

- test your project when outside CCCB

- test your project while other people are using the display

Uses the [servicepoint](https://github.com/cccb/servicepoint) library for reading the packets.

The screenshot above shows the output of two example projects running in parallel (game_of_life and random_brightness).

## Running

Check out this repository and run `cargo run --release`.

## Command line arguments

The application binds to `0.0.0.0:2342` by default (`./servicepoint-simulator --bind host:port` to change this).

See [env_logger](https://docs.rs/env_logger/latest/env_logger/) to configure logging.

Because this program renders to an RGB pixel buffer, you can enjoy the following additional features not available on the real display:

- enable or disable the empty space between tile rows (`./servicepoint-simulator --spacers` to enable)

- render pixels in red, green, blue or a combination of the three (`./servicepoint-simulator -rgb` for white pixels)

## Contributing

Contributions are accepted in any form (issues, documentation, feature requests, code, reviews, ...).

All creatures welcome.

## Legal stuff

The included font is https://int10h.org/oldschool-pc-fonts/fontlist/font?ibm_bios (included in the download from https://int10h.org/oldschool-pc-fonts/download/). The font is CC BY-SA 4.0.

For everything else see the LICENSE file.