Aller au contenu

Elina MQTT Simulator (Beta)

Vue d'ensemble

Elina MQTT Simulator est une application Cradlepoint NCOS SDK qui simule une flotte d'appareils IoT indépendants — drones, UGV, capteurs ou tout autre type d'appareil parlant MQTT — directement sur votre CPE. Chaque appareil simulé maintient sa propre session client MQTT authentique et publie selon un modèle de trafic configurable, ce qui vous permet de générer une charge MQTT réaliste et conforme au protocole depuis le point exact du réseau où le trafic de votre flotte réelle d'appareils serait émis.

Elina MQTT Simulator est conçu spécifiquement pour valider la capacité du réseau et de la RAN sous une densité réaliste de flotte IoT ou robotique — un essaim de drones, une flotte de véhicules terrestres, un ensemble de capteurs — plutôt qu'un seul flux de bande passante synthétique. Il complète QoS Agent (qui surveille la qualité réseau de base) et Elina-TG (qui génère du trafic applicatif polyvalent depuis un hôte ou une VM) en apportant une simulation MQTT authentique, par appareil, directement sur le CPE.

Chaque appareil simulé est une connexion MQTT réelle et autonome — ce n'est pas un seul flux de trafic mis à l'échelle, mais N sessions véritablement distinctes, chacune avec son propre cycle de vie de connexion, son comportement de keepalive et son planning de publication.

Prérequis

  • Un appareil Cradlepoint NCOS avec support d'applications SDK, inscrit dans NetCloud Manager (NCM). Plateformes validées : S700, E3000. Les R890, R980 et R2400 sont des cibles prévues, pas encore validées matériellement.
  • Le package elina_mq (.tar.gz), disponible auprès de votre représentant LatenceTech.
  • Un broker MQTT accessible depuis l'appareil — un Reflector LatenceTech, un broker on-premises (Mosquitto, EMQX, HiveMQ, etc.), ou un service MQTT tiers. Notez son hôte, son port, et s'il nécessite TLS.

Fonctionnalités clés

  • MQTT conforme au protocole, pas une approximation — trafic CONNECT / PUBLISH / ACK réel aux QoS 0, 1 ou 2, avec la prise en charge de la poignée de main complète en quatre étapes du QoS 2.
  • MQTT v3.1.1 et v5, sélectionnables par exécution.
  • TLS, avec les certificats serveur résolus via le Certificate Manager propre à NCOS — aucun certificat n'est inclus dans le package.
  • Last Will and Testament (LWT) par appareil simulé, afin qu'un broker voie un statut « offline » réaliste en cas de déconnexion non propre.
  • Une bibliothèque de profils d'appareils intégrée et évolutive — 12 profils aujourd'hui, couvrant des appareils civils/IoT (drones, UGV, véhicules connectés, capteurs industriels, robots quadrupèdes et humanoïdes, caméras intelligentes) et des appareils représentatifs de la défense (essaims d'UAV tactiques, wearables soldats, capteurs et UGV de reconnaissance, nœuds de capteurs acoustiques).
  • Quatre types de déclencheurs de flux de publication — débit constant, aligné sur l'horloge murale (synchronisé sur toute une flotte), en rafales, et avec jitter — afin qu'un profil puisse représenter un trafic événementiel ou aléatoire, et pas seulement un métronome.
  • Modèles de flotte prêts à l'emploi (default, iot, industrial, defense) pour démarrer une flotte mixte réaliste sans écrire une configuration à la main.
  • Configuration entièrement pilotée par NCM — la cible du broker, TLS, la version du protocole, la composition de la flotte et la durée d'exécution sont tous réglables via les champs App Data de NetCloud Manager, sans push de fichier requis pour les changements courants.

Fonctionnement

À partir d'une composition de flotte (combien d'appareils de chaque type simuler) et d'un ou plusieurs profils d'appareils (à quoi ressemble le trafic MQTT de chaque type d'appareil), Elina MQTT Simulator :

  1. Construit un appareil simulé indépendant par unité dans la flotte.
  2. Connecte la propre session client MQTT de chaque appareil au broker choisi, en échelonant légèrement les connexions pour éviter une rafale de connexions artificielle.
  3. Exécute les flux de publication configurés de chaque appareil selon leur propre planning — un profil d'appareil peut combiner, par exemple, une télémétrie haute fréquence avec des mises à jour de statut à fréquence plus basse, chacun s'exécutant indépendamment.
  4. Signale en direct des statistiques de flotte agrégées — nombre de messages, débit en octets, santé des connexions — visibles via les logs du routeur et NetCloud Manager.
  5. S'arrête proprement à la fin d'une durée de test configurée, en déconnectant chaque appareil et en rapportant les statistiques finales.

Téléchargement et installation

  1. Obtenez le package (elina_mq_v<version>.tar.gz) auprès de votre représentant LatenceTech, ou téléchargez avec :
wget https://api.latence.ca/software/elina_mq_v1.0.1_release.zip
  1. Uploadez via NetCloud Manager :
  2. Dans NCM, allez dans Apps & SDK pour l'appareil ou le groupe d'appareils cible.
  3. Uploadez le package.
  4. Assignez-le aux appareil(s) ou au groupe sur lesquels vous souhaitez l'exécuter.
  5. Laissez l'application arrêtée jusqu'à ce que vous ayez défini les champs App Data ci-dessous — la configuration est lue une seule fois au démarrage, il est donc plus simple de configurer d'abord, puis de démarrer.

Votre premier test

  1. Dans NCM, ouvrez les SDK Application Data (App Data) de l'appareil pour elina_mq et définissez :
Key Example value
LTI_broker_host your broker's hostname or IP
LTI_broker_port 1883
LTI_use_tls false
LTI_duration_seconds 60
  1. Laissez pour l'instant les champs de composition de flotte (LTI_fleet_config, LTI_template) non définis — sans rien de défini, l'application exécute une petite flotte par défaut intégrée, afin que vous puissiez confirmer la connectivité avant de choisir une composition réelle.
  2. Démarrez l'application depuis NCM ou l'interface d'administration du routeur.
  3. Surveillez le log du routeur (log show -f -s elina_mq) pour voir les appareils signaler connected, puis des statistiques de flotte périodiques, puis un arrêt propre une fois que LTI_duration_seconds s'est écoulé.

Une fois que cela fonctionne, choisissez un modèle de flotte (le plus rapide) ou une chaîne LTI_fleet_config personnalisée pour exécuter une composition représentative de votre cas d'usage réel — voir le User Guide ci-dessous pour les deux.

Utiliser Elina MQTT Simulator avec QoS Agent

Elina MQTT Simulator est conçu pour fonctionner aux côtés de QoS Agent sur le même CPE :

  • QoS Agent surveille en continu la qualité réseau de base (latence, perte, débit) sur la connexion.
  • Elina MQTT Simulator génère en même temps la charge de trafic MQTT de la flotte IoT.

Exécuter les deux ensemble vous permet de corréler directement les métriques de qualité réseau avec une charge de flotte IoT réaliste et configurable — plutôt que d'observer la santé réseau de base et la charge applicative de façon isolée.

Déploiement recommandé : exécutez QoS Agent et Elina MQTT Simulator ensemble sur un modèle de CPE plus grand et plus capable. Chaque application a sa propre empreinte CPU et mémoire, et les exécuter simultanément — en plus du fonctionnement normal du routeur — utilise nettement plus de ressources de la plateforme que l'une ou l'autre seule. Contactez votre représentant LatenceTech pour des conseils sur le choix du modèle de CPE adapté à l'échelle de déploiement combiné prévue.

Documentation complémentaire

Cette page couvre les bases. Pour une vraie campagne de tests, consultez :

  • User Guide — chaque champ App Data, la bibliothèque complète de profils, la configuration TLS/Certificate Manager, le monitoring et le dépannage, et les conseils de capacité de plateforme.
  • Profile library reference — chiffres flux par flux, unités et notes de sourcing pour chaque profil intégré, civil et défense.
  • Fleet templates — la composition exacte derrière chaque modèle intégré (default, iot, industrial, defense), comme point de départ pour le vôtre.

Les retours sur les profils, les fonctionnalités ou le comportement de la plateforme sont toujours bienvenus — partagez-les via votre représentant LatenceTech, ou le Support client.