pmo

pmossdp (0.2.0)

Published 2026-11-08 07:22:42 +01:00 by eric

Installation

[registries.forgejo]
index = "sparse+" # Sparse index
# index = "" # Git

[net]
git-fetch-with-cli = true
cargo add pmossdp@0.2.0 --registry forgejo

About this package

SSDP (Simple Service Discovery Protocol) : annonces NOTIFY, M-SEARCH, écoute. Autonome et léger : utilisable depuis un agent embarqué.

pmossdp

SSDP (Simple Service Discovery Protocol) pour UPnP : annonces NOTIFY, réponses et envois M-SEARCH, écoute des annonces. Autonome et léger : utilisable depuis un agent embarqué.

Contenu

Élément Rôle
SsdpServer Mode appareil : annonce des SsdpDevice (alive périodique, byebye à l'arrêt) et répond aux M-SEARCH
SsdpDevice Identité d'un appareil annoncé (UUID, type, LOCATION, SERVER, types de notification)
SsdpClient Mode point de contrôle : envoie des M-SEARCH, reçoit les annonces et les réponses (SsdpEvent)

Le client utilise un port éphémère pour ses recherches (les réponses arrivent en unicast) et écoute séparément le port 1900, partagé avec le serveur, pour les annonces alive / byebye. Voir la documentation de SsdpClient (rustdoc).

Utilisation

[dependencies]
pmossdp = { version = "0.2", registry = "pmo" }
use pmossdp::{SsdpDevice, SsdpServer};

let device = SsdpDevice::new(
    "0f3c…".into(),
    "urn:schemas-upnp-org:device:MediaRenderer:1".into(),
    "http://192.168.1.10:8080/desc.xml".into(),
    "Linux UPnP/1.1 MonApp/1.0".into(),
);
let mut ssdp = SsdpServer::new();
ssdp.start()?;
ssdp.add_device(device);
# Ok::<(), std::io::Error>(())

Adresse locale

Pour choisir l'interface multicast de sortie, le serveur et le client appellent pmoutils::guess_local_ip(). Si elle échoue (aucune route, machine hors ligne), ils continuent avec l'interface multicast par défaut et le signalent par un avertissement (tracing::warn!).

Développement

make help   # commandes (kit crate-kit)
make ci     # fmt-check + clippy + tests + doc

Plateformes : Unix et Windows (SO_REUSEPORT positionné sous Unix par socket2).

Licence

CeCILL v2.1 (voir LICENSE, traduction anglaise : LICENSE.en).

Dependencies

ID Version
get_if_addrs ^0.5
pmoutils ^0.2
socket2 ^0.5
tracing ^0.1

Keywords

ssdp upnp discovery network multicast
Details
Cargo
2026-11-08 07:22:42 +01:00
1
CECILL-2.1
403 KiB
Assets (1)
Versions (7) View all
0.2.4 2026-11-14
0.2.3 2026-11-12
0.2.2 2026-11-12
0.2.1 2026-11-08
0.2.0 2026-11-08