Cet article décrit la connexion d'un modem FX30 avec ALERT.
Les modems FX30 de Sierra Wireless sont des équipements qui se connectent au réseau LTE grâce à un abonnement souscrit auprès d'un opérateur mobile (carte SIM à se procurer chez l'opérateur). Les FX30 disposent également d'une interface réseau IP via une prise RJ45.
ALERT va se connecter au FX30 en IP afin d'envoyer des SMS et afin d'effectuer des appel vocaux.
Pour réaliser cette connexion entre le modem et ALERT, nous devrons tout d'abord vérifier les prérequis nécessaires, puis insérer la carte SIM, alimenter le modem et le connecter au réseau. Ensuite, il faudra fixer l'adresse IP du modem et rentrer le code PIN de la carte SIM. Nous pourrons alors paramétrer ALERT pour se connecter en SMPP et en SIP sur le modem.
Il sera possible ensuite de modifier les paramètres par défaut et de configurer un watchdog pour que le modem contrôle le lien avec ALERT.
A partir de la version 1.0.7 du FX30, une application surveille les connexions en mode data. Si une connexion est établie, elle est automatiquement stoppée et un SMS peut être envoyé comme pour le watchdog.
Prérequis
Le logiciel ALERT doit être installé. Lors du setup de la Solution Micromedia, veiller à installer également SiwiUpdate. Cet outil est nécessaire pour la configuration des modems FX30. La version 2.0.0.7 au minimum de SiwiUpdate est requise.
Une carte SIM au format standard est nécessaire pour connecter le FX30 au réseau cellulaire.
Une adresse IP doit être réservée pour le FX30 sur le réseau interne. Les routes entre ALERT et le FX30 doivent être ouvertes : par défaut, les ports TCP 22 (SSH), TCP 2775 (SMPP) et UDP 5060 (SIP), UDP 4000-4010 (RTP) de Alert vers le FX30 doivent être ouverts.
Note : Les version du modem SMS seul utilisent le port 8888 part défaut pour les connections SMPP.
Versions ALERT requises
Pour la version SMS seul, le FX30 est compatible à partir de la version 4.0 Rev 2 Build 86, la version 4.0 Rev 2 Build 238 est toutefois recommandée.
La version vocale nécessite au minimum la version 4.0 Rev 2 Build 238.
Pour les versions antérieures (3.6 rev 2), merci de nous contacter pour vérifier la compatibilité.
Insertion de la carte SIM
Tout d'abord, dévisser le couvercle à l'aide d'un tournevis cruciforme.
Orienter la carte SIM, connecteurs vers le haut comme le montre le schéma suivant.
Insérer la carte jusqu'au clic. ( Pour la retirer, appuyer et relâcher, après le clic, retirez là doucement. )
Refermer alors le couvercle.
Connecter le modem
Avant d'alimenter le modem, il faut connecter l'antenne GSM sur le connecteur "CELL". L'autre connecteur "GNSS" est pour la localisation par satellite.
Le modem peut ensuite être connecté au réseau IP via l'interface Ethernet.
Il reste enfin à alimenter le modem électriquement. (Alimentation et câble fournis).
Les LEDs présentes sur le modem donnent une indication de l'état de ce dernier.
La LED d'alimentation (Power LED) dispose de trois états :
- Eteinte : Pas d'alimentation ou alimentation > 32 VDC ou < 4.75 VDC.
- Rouge fixe : Le module est alimenté mais pas connecté au réseau cellulaire.
- Ambre fixe : Connecté au réseau cellulaire.
Configuration du modem : adresse IP et code PIN
Dans sa configuration usine, le modem est configuré avec l'adresse IP : 192.168.13.31.
L'outil SiwiUpdate (téléchargement) peut être utilisé pour définir une nouvelle adresse IP et renseigner le code PIN.
Changer l'adresse IP
Il faut lancer SiwiUpdate sur une machine qui peut accéder au FX30 connecté sur le réseau avec son adresse usine (192.168.13.31).
Une fois l'outil lancé, il faut se connecter au modem. La connexion se fait en IP via SSH. Les informations nécessaires à renseigner si situent dans la rubrique "Legato SSH". (Voir capture ci dessous. (PI : Legato est le nom de la plateforme logicielle utilisée par Sierra Wireless dans le modem).
Le mot de passe programmé avant expédition est l'IMEI du modem.
Une fois connecté, les propriétés du modem s'affichent dans l'écran "Modem properties".
C'est dans l'écran "Network connection" que l'adresse IP peut être changée.
Il faut renseigner l'adresse IP et le masque de sous-réseau, puis presser "Set".
L'image ci-dessous montre un réglage d'adresse IP effectué avec succès pour l'IP "192.168.38.44".
Une fois le réglage effectué, un reboot du modem est nécessaire pour que la nouvelle IP soit effective.
L'outil affiche cette boite d'avertissement :
Un bouton 'Reboot" se trouve sur l'onglet "Modem properties".
Définir le code PIN
C'est encore sur l'onglet "Network connection" que le code PIN peut être renseigné. Le code PIN est stocké ensuite dans la mémoire du modem et sera utilisé à chaque redémarrage du modem.
La capture suivante montre un réglage effectué avec succès. Dans le cas contraire, une erreur serait affichée (Par exemple si le code PIN est erroné).
Une fois tous ces réglages effectués, il est alors possible de configurer ALERT.
Configuration d'ALERT
Avant de commencer la configuration d'ALERT, nous allons étudier les paramètres de configuration par défaut du modem pour savoir quelles valeurs utiliser dans ALERT.
Paramètres par défaut
Les paramètres du modem sont consultables et modifiables dans l'onglet "Applications config" de SiwiUpdate.
Nous allons laisser les paramètres par défaut pour la connexion d'ALERT.
Driver SMPP
Pour envoyer des SMS avec le FX30, ALERT utilise un protocole normalisé : le SMPP.
Les opérateurs d'ALERT devront donc utiliser le driver SMPP. Comment configurer ce dernier avec les paramètres par défaut du FX30.
Dans ce cas, la seule configuration à effectuer est dans l'onglet "Connexion" du driver SMPP : il faut ajouter une connexion, puis renseigner l'adresse du FX30 et le port à utiliser (2775 par défaut). Les images suivantes illustrent cette configuration.
Une fois ces paramètres validés, ALERT doit se connecter au serveur SMPP du FX30.
Il est alors possible d'effectuer des appels avec le driver SMPP affecté aux opérateurs comme suit :
Configuration du SIP
Les appels vocaux via le FX30 utilisent le protocole SIP. Il faut donc configurer une connexion SIP dans ALERT. Pour cela, aller dans le menu "Configuration/Communication ...". Puis sélectionner l'onglet "Connexions SIP".
Ensuite, il faut ajouter une connexion comme suit :
L'image suivante montre la configuration de la connexion SIP avec les paramètres par défaut pour un modem à l'adresse IP 192.168.38.44.
Une fois la connexion configurée, il faut ajouter un port SIP qui va utiliser cette connexion dans Alert. Ceci via l'onglet "Ports" de la boite de configuration des communications.
Voici la configuration d'un port SIP utilisant la connexion précédemment définie. Ce port accepte les appels entrants. Pour cela, ajouter "*" à la liste des numéros appelés.
Pour effectuer les appels vocaux, il reste à configurer un opérateur dans ALERT avec le driver "Vocal" comme suit :
Exemple d'une configuration SIP :
Configuration du service d'alarme
Le FX30 dispose d'un service d'alarme qui permet de notifier des utilisateurs en cas de dysfonctionnements. Ce service d'alarme est utilisé par le serveur SMPP pour la fonctionnalité de watchdog et par le superviseur des connexions data (à partir de la version 1.0.7).
Chaque alarme dispose :
- D'un nom
- D'une donnée propre au contexte de déclenchement
- D'un scénario d'envoi de message
Les données des alarmes sont définies par l'application émettrice et ne sont pas paramétrables.
Le scénario quant à lui définit:
- Un texte à envoyer
- Un format de message qui est une combinaison du texte du scénario (&M), du nom du scénario (&N), du nom de l'alarme (&A) et de la donnée du contexte de l'alarme (&U)
- Une liste de numéros de téléphones destinataires des SMS
- Le nombre de répétitions du message envoyé à chaque destinataire
- Le temps d'attente entre chaque répétition du message
Les paramètres de scénario sont réglables dans l'onglet "Applications config" de SiwiUpdate. Pour le moment le scénario "watchdog" est utilisé par le smppService. Le scénario "Dataconnection" est lui utilisé par le service datacnxService.
Dans le tableau suivant XXX est le nom du scénario. SiwiUpdate affiche les paramètres pour chacun des scénarios définis.
Option | Type | Valeur | Description |
alarmScenario.XXX.message | string | link issue | Texte du scénario (&M dans le format) |
alarmScenario.XXX.format | string | &N &M &A | Le format du message envoyé |
alarmScenario.XXX.address | string | +336xxxx-+32yyyyy | La liste des numéros de téléphones destinataires séparés par "-". Max. 511 caractères. |
alarmScenario.XXX.repeat | int | 3 | Le nombre de répétitions du message (en plus du message initial) |
alarmScenario.XXX.repeatdelaysec | int | 30 | Le temps (en sec) entre chaque répétition |
Quelles sont les alarmes possibles selon les applications ?
Watchdog (SMPP)
Cette fonctionnalité de sécurité, configurée par défaut permet de contrôler le lien entre ALERT et le FX30.
Le serveur SMPP utilise le service d'alarme pour 2 alarmes :
- "ServerStopped" qui se déclenche à l'arrêt du service SMPP. La donnée du contexte de l'alarme est toujours "SMPP server stopped"
- "x.x.x.x" qui est l'adresse IP du client SMPP (ALERT en ce qui nous concerne) qui génère l'alarme. La donnée du contexte peut être "Disconnection" si le client SMPP se déconnecte, ou "Enquirelink timeout" si ALERT n'a pas envoyé le bit de vie (Enquire link) pendant smppServer.restart.enquireLinkTimeout. (Voir Paramètres du service SMPP)
Ces deux alarmes utilisent le scénario "Watchdog" pour notifier d'un problème.
Dans l'exemple suivant, nous avons configuré deux numéros destinataires du SMS envoyé en cas de perte du lien avec ALERT.
Il est possible de modifier le scénario réalisé lors de la détection du défaut de communication avec ALERT.
Alarme de connexion
L'application datacnxService contrôle les connexions du FX30 en mode data et peut utiliser le service d'alarme pour 2 alarmes :
- "cnxServerStopped" qui se déclenche à l'arrêt du service datacnxService. La donnée du contexte de l'alarme est toujours "No more cnx supervision"
- "Connected" qui apparait lorsqu'une tentative de connexion data est détectée. La donnée du contexte est toujours "Data connection is UP, trying to stop it"
Ces deux alarmes utilisent le scénario "DataConnection" pour notifier d'un problème. Comme pour le watchdog, il est possible de personnaliser le scénario pour ces alarmes.
Paramètres du service SMPP
Option | Type | Valeur | Description |
smppServer.editor | string | Micromedia | RAS - Ne pas modifier |
smppServer.restart.listeningIPPort | int | 2775 | Le port d'écoute SMPP |
smppServer.restart.useSSL | bool | false | true si la connexion utilisée est sécurisée |
smppServer.restart.enquireLinkTimeout | int | 60 |
Le temps max d'attente (en sec) de la trame de vie.
Si la valeur est modifiée, elle ne sera prise en compte qu'à la prochaine connexion du client.
|
smppServer.restart.clientStopAlarmDelay | int | 30 |
Retard (en sec) au déclenchement de l'alarme arrêt client SMPP (ALERT)
|
smppServer.restart.serverStopAlarmDelay | int | 30 | Retard (en sec) au déclenchement de l'alarme arrêt serveur SMPP. |
smppServer.needLogin | bool | false |
true si la connexion nécessite login et mot de passe
|
smppServer.userName | string | Le login attendu si "needLogin" est à true | |
smppServer.password | string | Le mot de passe associé au "userName" (9 caractères maximum) | |
smppServer.WDactive | bool | true |
true si le modem déclenche une alarme sur défaut SMPP.
Trois types d'alarmes : fin de connexion client, expiration du délai de trame de vie et arrêt du serveur SMPP.
|
Paramètres du serveur SIP
Différentes options sont disponibles (dans l'onglet "Applications config" de SiwiUpdate) :
Option | Type | Valeur | Description |
sipServer.restart.listeningIPPort | int | 5060 | Le port d'écoute SIP du modem |
sipServer.restart.transport | string | udp | C'est le protocole utilisé pour la connexion SIP (Valeurs possibles : udp ou tcp) |
sipServer.restart.localAddress | string | "" | L'adresse IP de l'interface réseau utilisée. Si elle est vide, le modem utilisera l'interface eth0 |
sipServer.restart.pjsipLogLevel | int | 3 | Niveau de trace de la librairie PJSIP |
sipServer.restart.RTPStartPort | int | 4000 | Premier port RTP d'écoute. Ce port et port+1 (protocole RTCP) sont nécessaires et doivent donc être accessibles (Ports UDP) |
sipServer.restart.allowedUser | string | alertuser | L'utilisateur autorisé à s'enregistrer sur le serveur SIP. A renseigner dans l'uri de l'UA |
sipServer.restart.needAuthentication | bool | true | Le contact doit t'il s'authentifier lors de l'enregistrement ? |
sipServer.restart.authLogin | string | alert | Le login pour l'authentification |
sipServer.restart.authPwd | string | changeit | Le mot de passe pour l'authentification |
sipServer.maxCalls | int | 1 | Nombre maximum d'appels simultanés (1 est la seule valeur possible actuellement) |
sipServer.maxCallDuration | int | 0 | Durée maximale d'un appel en secondes (0 pour pas de limite) |
Les options dont le nom contient la valeur "restart" nécessitent un redémarrage de l'application pour que l'option soit prise en compte.
Paramètres de supervision des connexions
Différentes options sont disponibles (dans l'onglet "Applications config" de SiwiUpdate):
Option | Type | Valeur | Description |
dataCnx.editor | string | Micromedia | RAS - Ne pas modifier |
dataCnx.alarmNotification | bool | false | Passer à true si une alarme doit être envoyée en cas de tentative de connexion |
dataCnx.alarmDelay | int | 5 | Temporisation en secondes avant l'envoi de l'alarme de connexion |