pmossdp (0.1.2)
Installation
[registries.forgejo]
index = "sparse+ " # Sparse index
# index = " " # Git
[net]
git-fetch-with-cli = truecargo add pmossdp@0.1.2 --registry forgejoAbout this package
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.1", 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 |