Appareils virtuels

Un appareil virtuel est un appareil sur la plateforme HAM sans matériel. Ses mesures viennent de votre propre système par l’API, pas d’un capteur HAM.

Ensuite, l’appareil virtuel fonctionne comme tous les autres appareils : graphiques, historique, règles, rapports et partage.

Quand l’utiliser

• Vous avez un capteur ou un système d’un autre fabricant et vous voulez ses valeurs dans l’application HAM.
• Vous voulez des règles et des notifications pour des valeurs que votre propre logiciel calcule.

Notions de base

Élément	Valeur
Famille	v (Virtual HAM). Le numéro de série est, par exemple, v:123.
Mesures	Jusqu’à 6, avec les codes u0, u1, u2, u3, u4, u5
Sorties	Aucune
Maintien de connexion	Aucun. L’appareil change seulement quand vous envoyez des valeurs.

L’application n’a pas d’écran pour créer un appareil virtuel. Pour un nouvel appareil virtuel, contactez le support.

Envoyer des valeurs

Envoyez un POST à virtual_device_update.php. Vous avez besoin de la permission d’administrateur sur l’appareil.

curl -X POST https://api.hamsystems.eu/virtual_device_update.php \
  -H "Authorization: Bearer-API YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"serialno": "v:123", "R": {"u0": 2150, "u1": 48}}'

Champ	Contenu
serialno	Le numéro de série de l’appareil virtuel
R	Les mesures, avec le code comme clé (u0 à u5)
untime	Facultatif. L’heure de la mesure en secondes unix. Sans ce champ, le serveur utilise l’heure actuelle.

Le serveur garde seulement les champs serialno, R et untime. Il ignore tous les autres champs.

La réponse est du JSON avec messages et response.

Message d’erreur	Cause
Invalid arguments	serialno est absent.
Invalid login	La clé ou le jeton n’est pas correct.
Access denied to device	Vous n’avez pas la permission d’administrateur sur l’appareil.

Lire

Vous lisez les valeurs de la même façon que pour tous les appareils :

• API REST pour l’état actuel.
• Télécharger les données historiques pour l’historique.
• WebSocket pour les changements en direct.