PWMP Server

This crate contains the PixelWeather Messaging Protocol Server and CLI.

Server configuration

The server will read the configuration file from ~/.config/pwmp-server/config.yml. If it doesn't exist, it'll be created. Optionally, you can provide a --config flag, with an alternative path.

Defaults

# Server binding
host: "0.0.0.0"
port: 55300

# Database connection settings.
# PostgreSQL is the only supported database.
database:
  host: "123.456.789.012"
  port: 5432
  user: "root"
  password: "root"
  name: "pixelweather"
  ssl: false

limits:
  # Maximum number of devices that can be connected at the same time.
  # This limit cannot be disabled.
  devices: 10

  # Sets how many settings can be requested using the `Message::GetSettings`  message.
  # This limit cannot be disabled.
  settings: 10

  # Maximum amount of time a client can stay connected without sending any requests. If the client stays connected for longer than this time, without communicating, it will be kicked.
  stall_time: 10

# Configuration for the built-in rate limiter.
rate_limiter:
  time_frame: 1 # second(s)
  # Maximum amount of requests a client can make within the specified time frame above.
  max_requests: 4
  # Maximum amount of connections that may be accepted within the specified time frame above.
  max_connections: 4

Database server

Only PostgreSQL is supported. It's recommended to use the latest version.

Compatibility has been verified with the following versions:

• 16.x
• 17.4

Using as a service

The CLI has a service subcommand, which allows managing a background service.

$ pwmp-server service help
Service management

Usage: pwmp-server service <COMMAND>

Commands:
  start      Start the service
  stop       Stop the service
  enable     Enable
  disable    Disable
  install    Install as service
  uninstall  Uninstall service
  check      Check if service is installed
  reinstall  Reinstall service

Service management is only supported on Linux systems with Systemd. There is a boilerplate implementation for OpenRC, but it's not supported yet.

TODO:

• Add support for Systemd services
• Add support for OpenRC services
• Add support for macOS Homebrew services

Service management on Windows is not and will not be supported.

Compiling caveats and portability

Due to some dependencies relying on glibc, you may not be able to run the binary on distributions like Alpine Linux (gcompat may not work). Furthermore, due to the PostgreSQL library (libpq) relying on pthread, you will not be able to compile for musl targets.

Platform support table

Note: This incomplete and may change in the future!

Target	Supported	cargo-cross support
x86_64-unknown-linux-gnu	✅	✅
x86_64-unknown-linux-musl	❌	❌
aarch64-unknown-linux-gnu	✅	✅
aarch64-apple-darwin	✅	❌
aarch64-unknown-linux-musl	❌	❌
armv7-unknown-linux-gnueabi	❌	❌

In general, x86 and aarch64 are well-supported with Linux. macOS should theoretically work. Windows is not supported and there are no plans for it.