Plugin SMS

Le plugin SMS permet de dialoguer avec Jeedom par l’intermédiaire des SMS. Il permet également à Jeedom de vous envoyer un SMS en cas d’alerte (plugin alarme, scénario, etc…​).

IMPORTANT

Pour dialoguer avec Jeedom, il faut avoir configuré des interactions.

Configuration du plugin

Après téléchargement du plugin, il suffit de l’activer et de configurer le port. Après sauvegarde le démon devrait se lancer. Le plugin est déjà configuré par défaut, vous n’avez donc rien à faire de plus. Cependant vous pouvez modifier cette configuration, voici le détail :

• Port SMS : le port USB sur lequel votre clef GSM est connecté (par exemple ce peut être /dev/ttyUSB0, pour le voir il suffit de lancer dmesg puis de brancher le modem).

ASTUCE

Si vous ne savez pas quel port USB est utilisé, vous pouvez simplement indiquer “Auto”. Attention le mode auto ne marche qu’avec les clefs Huawei E220.

IMPORTANT

Attention certaines clefs 3G sont en mode modem par défaut et non GSM. Il faut, à l’aide du logiciel de votre fabricant de clef, changer le mode de la clef sur GSM (ou texte, ou série).

• Vitesse de communication : les clefs récentes fonctionnent en 115200 bauds. Vous avez la possibilité de passer en 9600 bauds au cas où votre matériel l’exigerait.
• Code pin : Permet d’indiquer le code pin de la carte SIM, à laisser vide si vous n’en avez pas.
• Texte mode : Mode de compatibilité étendu, à n’utiliser que si l’envoi et/ou la réception des messages ne fonctionne pas.
• Découper les messages par paquet de caractères : Indique le nombre de caractères maximum par message texte.
• Passerelle SMS / SMS Gateway (modifier en cas d’erreur : CMS 330 SMSC number not set) : A ne changer que si vous avez l’erreur CMS 330 SMSC number not set, dans ce cas il faut indiquer le numéro de passerelle SMS de votre opérateur téléphonique.
• Force du signal : Force de réception du signal de votre clef GSM.
• Réseau : Réseau téléphonique de votre clef GSM (peut être à “None” si Jeedom n’arrive pas à le récupérer).
• Port socket interne (modification dangereuse) : permet de modifier le port de communication interne du démon.
• Cycle (s) : cycle de scrutation du démon pour l’envoi et la réception des SMS. Un chiffre trop bas peut amener à une certaine instabilité.

Configuration des équipements

La configuration des équipements SMS est accessible à partir du menu Plugins → Communication.

Vous retrouvez ici toute la configuration de votre équipement :

• Nom de l’équipement : nom de votre équipement SMS.
• Objet parent : indique l’objet parent auquel appartient l’équipement.
• Activer : permet de rendre votre équipement actif.
• Visible : rend votre équipement visible sur le dashboard.

En dessous vous retrouvez quelques paramètres spécifiques:

• Désactiver les interactions: permet d’interdire les interactions pour tous les numéros de cet équipement (si vous voulez interdire les interactions pour certains numéros et pas pour d’autres, vous pouvez créer plusieurs équipements)
• Autoriser les messages de numéros inconnus: permet d’accepter les messages en provenance de numéro inconnu. Le message reçu ainsi que le numéro de l’expérditeur seront disponnibles via les commandes comme pour tout autre message. Les interactions sont toujours désactivées pour ces numéros
• Ajouter les numéros inconnus: permet d’ajouter automatiquement le numéro à la liste des commandes (donc de créer un nouvelle commande) lors de la réception d’un message d’un numéro inconnu

ATTENTION

Cette option peut être dangereuse à utiliser car cela va ajouter automatiquement une commande correspondante au numéro lors de la réception d’un message en provenance d’un numéro inconnu. Si sur le même équipement vous activez les interactions, cela veut dire que n’importe qui pourra commencer à interagir avec votre Jeedom. N’activez cette option que si vous êtes certain d’accepter ce risque.

Les commandes

Chaque équipement dispose des commandes suivantes:

• Signal: donne la force du signal;
• Message: contient le dernier message sms reçu;
• Expediteur: contient le nom du dernier expéditeur si celui-ci est connu, le numéro dans le cas contraire;
• Envoyer message à: une commande action permettant d’envoyer un message d’envoyer un sms à un numéro personnalisé sans devoir créer la commande du contact. Cela permet d’envoyer un sms à un numéro obtenu via une commande info d’un autre équipement sous Jeedom par exemple. Attention, aucune vérification du numéro n’est effectuée, il faut fournir les numéros au format international.

De plus, vous pouvez créer autant d’autres commandes actions que souhaité correspondantes à vos contacts, pour chacune d’elle il faudra renseigner:

• Nom: le nom de la commande;
• Utilisateur: utilisateur correspondant dans Jeedom (permet de restreindre certaines interactions à certains utilisateurs);
• Numéro: numéro de téléphone à qui envoyer les messages. Vous pouvez mettre plusieurs numéros en les séparant avec des ; (exemple: +33612345678;+33698765432). IMPORTANT : il faut mettre les numéros au format international (+33 pour la France par exemple).

IMPORTANT

Seuls les numéros de téléphone déclarés dans un équipement pourront utiliser les interactions car seuls eux seront autorisés.

Utilisation du plugin

Celui-ci est assez standard dans son fonctionnement, il faut donc ajouter un nouvel équipement puis configurer:

• Le nom de celui-ci,
• S’il est actif ou non,

Puis il faut ajouter les commandes qui seront composées d’un nom et d’un numéro, seuls les numéros listés dans la liste des commandes peuvent recevoir une réponse de Jeedom (cela permet de sécuriser, tout en évitant de mettre un mot de passe à chaque début de SMS envoyé à Jeedom). Vous pouvez aussi indiquer quel utilisateur est lié à ce numéro (pour la gestion des droits au niveau des interactions).

Pour communiquer avec Jeedom, il suffira ensuite de lui envoyer un message à partir d’un numéro autorisé, toutes les interactions venant du système d’interactions.

EXEMPLE D’INTERACTION :

• Question : “Quelle est la température de la chambre ?”
• Réponse : “16.3°C”

Liste des clefs compatibles

• HUAWEI E220
• Alcatel one touch X220L
• HSDPA 7.2MBPS 3G Wireless
• HUAWEI E3372
• USB SIM800C (vitesse 9600)

FAQ

Je ne reçois rien avec une clef huwaei e160.

Il faut installer minicom (sudo apt-get install -y minicom), lancer celui-ci et se connecter au modem, puis faire :

AT^CURC=0
AT^U2DIAG=0

Et sur le plugin faire :

• Choisir premier port USB et non le second
• Vitesse : 9600
• Mode texte désactivé

Je ne vois pas le port USB de ma clef

Vérifiez que vous n’avez pas brltty d’installé (sudo apt-get remove brltty pour le supprimer).

Au bout de quelques heures/jours je ne reçois plus de SMS et ne peux plus en envoyer, une relance du démon corrige

Vérifiez votre cable USB (un mauvais cable USB entraîne souvent ce genre de souci, il ne faut pas qu’il soit trop long non plus), vérifiez aussi votre alimentation, un hub USB est fortement conseillé.

J’ai une erreur CME XX

Vous pouvez trouver ici la description des différentes erreurs CME.

Configuration de la clef Alcatel one touch X220L

Lorsque l’on insère la clef, on a ceci :

root@jeedom:# lsusb
Bus 002 Device 003: ID 1bbb:f000 T & A Mobile Phones

Attention si vous n’avez pas 1bbb:f000 il ne faut surtout pas faire la suite de cette documentation il faut ajouter les lignes suivantes à la fin du fichier /etc/usb\_modeswitch.conf :

########################################################
# Alcatel X220L
DefaultVendor= 0x1bbb
DefaultProduct= 0xf000
MessageContent="55534243123456788000000080000606f50402527000000000000000000000"
########################################################

Puis lancer la commande suivante pour tester :

/usr/sbin/usb_modeswitch -c
/etc/usb_modeswitch.conf

On obtient ceci :

root@jeedom:~# lsusb
Bus 002 Device 003: ID 1bbb:0017 T & A Mobile Phones

et les liens sous /dev sont bien ajoutés :

root@jeedom:~# ls /dev/ttyUSB*
/dev/ttyUSB0 /dev/ttyUSB1 /dev/ttyUSB2 /dev/ttyUSB3 /dev/ttyUSB4

Maintenant il faut automatiser le lancement de la commande précédente via udev :

root@jeedom:# vi /etc/udev/rules.d99-usb_modeswitch.rules
SUBSYSTEM=="usb", ATTRS{idVendor}=="1bbb", ATTRS{idProduct}=="f000", RUN+="/usr/sbin/usb_modeswitch -c /etc/usb_modeswitch.conf"

Sous Jeedom dans le plugin SMS, il faut (dans mon cas) utiliser le “port SMS” suivant : /dev/ttyUSB3. En gros il faut essayer chaque port pour trouver le bon…

Le démons SMS est bien démarré, mais vous ne recevez aucun SMS

Une des causes probables est la mauvaise configuration réseau. Dans “Réglages” → “Système” → “Configuration” → “Réseaux”, vérifier le contenu du champ “Adresse URL ou IP”. Ce dernier ne doit pas être localhost ou 127.0.0.1 mais l’adresse IP de votre Jeedom ou son nom DNS.

En mode debug j’ai l’erreur “timeout” qui apparaît

Cette erreur arrive quand la clef ne répond pas dans les 10 secondes qui suivent une demande. Les causes connues peuvent être :

• incompatibilité de la clef GSM,
• problème avec la version du firmware de la clef.

Lors du démarrage en mode debug j’ai : “socket already in use”

Cela veut dire que le démon est démarré mais que Jeedom n’arrive pas à le stopper. Vous pouvez soit redémarrer tout le système, soit en SSH faire killall -9 refxcmd.py.

Le démon refuse de démarrer

Essayez de le démarrer en mode debug pour voir l’erreur.

J’ai plusieurs ports USB pour ma clef GSM alors que je n’en ai qu’une

C’est normal, pour une raison inconnue les clef GSM créent 2 (voire plus) ports USB au niveau système. Il suffit d’en choisir un, peut importe lequel.

Jeedom n’envoie plus et ne reçoit plus de SMS

Ceci arrive en général si la clef GSM n’arrive plus à se connecter au réseau. Essayez de la déplacer pour voir si ça revient au bout de quelques minutes.

J’ai des soucis de réception qui marche quelques heures puis plus rien

Mettez la carte SIM sur un téléphone portable et videz tous les sms de la carte (envoyés et reçus).