Manuel en français des PASSERELLES 433 / 868 MHz AIRSEND ET AIRSEND 2 DUO

Principe de fonctionnement

Mise en service du AirSend / AirSend 2 Duo

• Connectez le câble réseau fourni entre la prise RJ45 du AirSend ou AirSend 2 Duo et un des ports RJ45 disponibles de votre Box Internet ou routeur.
• Alimentez le AirSend ou AirSend 2 Duo à l'aide de l'alimentation fournie
• Avec un navigateur Internet (de préférence, celui de votre smartphone), allez sur le site https://airsend.cloud
• Appuyez/Cliquez sur  puis sur " Interfaces"
• Ajoutez votre passerelle
• Soit à l'aide de l'appareil photo de votre smartphone et du QR Code se trouvant à l'arrière du AirSend / AirSend 2 Duo, en cliquant/appuyant sur  :

• Soit en saisissant :
• le "Local IP" indiqué sur l'étiquette derrière le AirSend / AirSend 2 Duo (ex: fe80::dcf6:e5ff:fexx:1234)
• et le mot de passe "Password" lui aussi indiqué sur l'étiquette à l'arrière du AirSend (attention de bien respecter les minuscules et majuscules)

Ajouter des équipements (volets, portails, prises, etc.)

• Appuyez/Cliquez sur  puis sur " Accueil"
• En haut à droite, cliquez sur 
• Si vous avez une télécommande fonctionnelle avec l'appareil à commander,
• (1) choisissez "J'ai une télécommande"

• (2) Sélectionnez la marque (ex : Chacon) puis (3) le protocole utilisé par votre appareil (ex: DiO).
• Si vous ne la trouvez pas, essayer avec la fonction de "Recherche générique" qui va essayer de reconnaitre votre télécommande en fonction des données que celle-ci transmettra.
• (4) Appuyez sur  et, sur la télécommande d'origine, appuyez pendant quelques secondes sur le bouton que vous voulez "copier"
• Une fois la télécommande détectée et apprise,
• (5) Sélectionnez le type de bouton ("1 bouton", "ON/OFF" ou Volet roulant")
• (6) Vous pouvez tester le bon fonctionnement en appuyant sur la/les touche(s) sous "Test de compatibilité et portée" 
• (7) Donnez un nom (le choix du nom est particulièrement important en cas d'utilisation avec un assistant vocal)
• (8) Puis sauvegardez en appuyant/cliquant sur la disquette 

• Si vous n'avez pas la télécommande d'origine ou que celle-ci n'est plus fonctionnelle, appuyez/cliquez sur "(1) Je n'ai pas la télécommande"

• Tapez la marque (ex : Somfy) ou le nom du protocole (ex : RTS) (2)
• (3) Choisissez un nom (le choix du nom est particulièrement important en cas d'utilisation avec un assistant vocal)
• (4) Sélectionnez le type de télécommande ("1 bouton", "ON/OFF" ou Volet roulant")
• (5) Sauvegardez en appuyant/cliquant sur la disquette 
• Suivez les instructions indiquées à l'écran afin d'associer (ou appairer) la télécommande virtuelle qui a été créée (cette procédure varie en fonction de la marque et du protocole).

Commande par assistants vocaux Amazon Alexa ou Google Home

• Appuyez/Cliquez sur  puis sur " Services Web"
• Choisissez l'assistant vocal (Amazon Alexa ou Google Assistant / Home) ou le service Web (IFTTT) auquel vous voulez associer votre AirSend / AirSend 2 Duo
• Suivez les instructions indiquées à l'écran
• Une fois votre ou vos assistant(s) vocal/vocaux associé(s), vous pourrez commander vos équipements avec :

[OK Google / Alexa] [Allume / Éteint / Ouvre / Ferme] [Nom donné à votre équipement]

Utilisation avec l'application pour smartphone

• Installez l'application AirSend

• Application AirSend pour Android
• Application AirSend pour iOS (iPhone / iPad)

• Ajoutez votre passerelle

• Soit à l'aide de l'appareil photo de votre smartphone et du QR Code se trouvant à l'arrière du AirSend / AirSend 2 Duo, en cliquant/appuyant sur  :

• Soit en saisissant :
• le "Local IP" indiqué sur l'étiquette derrière le AirSend / AirSend 2 Duo (ex: fe80::dcf6:e5ff:fexx:1234)
• et le mot de passe "Password" lui aussi indiqué sur l'étiquette à l'arrière du AirSend (attention de bien respecter les minuscules et majuscules)
• Activez le bouton  "AirSend Duo" si vous avez un AirSend 2 Duo
• Appuyez sur "Ajouter"
• Importez les télécommandes précédemment créées sur le site airsend.cloud :

• Appuyez sur le  en bas à droite
• Sélectionnez "Synchroniser vos télécommandes avec AirSend.cloud"
• Sélectionnez-la ou les télécommandes que vous voulez importer en les touchant une à une (la  indique que la télécommande est sélectionnée)
• Importez en appuyant sur "Ajouter"

Utilisation avec une eedomus+

Vous devez, dans un premier temps, avoir ajouté vos équipementsb 433 et/ou 868 MHz via le site AirSend.cloud (voir plus haut, le paragraphe dédié).

Ensuite, pour ajouter sur la eedomus un équipement déjà créé sur AirSend.cloud, procédez comme suit :

• Cliquez sur "Configurer" puis " Ajouter ou supprimer un périphérique"

• Cliquez sur " Ajouter un autre type de périphérique"

• Dans la catégorie "Objets connectés", cliquez sur "Devmel AirSend" puis, un peu plus bas, dans le cadre "Piloter votre AirSend...", cliquez sur "  Créer"

• Si c'est le premier équipement que vous ajoutez :
• Un nouvel onglet va s'ouvrir et vous demander les adresse IPv6 et Mot de passe du AirSend
• Si ce n'est pas le cas (ou si vous avez changé de passerelle AirSend), cliquez sur "Cliquez ici pour lister les identifiants de périphérique" puis, à droite de l'adresse IPv6 du AirSend, sur "Changer"
• Entrez l'adresse "Local IP" se trouvant sur l'étiquette à l'arrière de votre AirSend dans la case "Adresse IPV6 AirSend" ainsi que le mot de passe du AirSend (indiqué "password" sur l'étiquette).
• Cliquez sur le bouton "Lister les périphériques" (cela va interroger le AirSend adfin de récupérer les identifiants de tous les périphériques déjà configurés à l'aide du site AirSend.cloud).
• Si vous avez déjà configuré votre AirSend lors d'un ajout précédent, cliquez sur "Cliquez ici pour lister les identifiants de périphérique".

• A l'aide de votre souris, copiez l'indentifiant à 5 chiffres de l'appareil que vous voulez ajouter (ou notez le). 
• Retournez à l'onglet précédent de votre navigateur affichant l'interface de la eedomus (onglet "Configuration du périphérique"), 

• Donnez un nom au périphérique que vous coulez créer et sélectionnez la pièce dans lequel il se trouve.
• Dans "Affichage"
• Dans "Identifiant du péripéhrique à créer", collez (ou tapez) l'identifiant à 5 chiffres du périphérique à ajouter
• Dans "Usage", sélectionnez le type de périphérque (ici, nous avons choisi "Volet/Store"
• Dans "Créer le capteur de température et d'humidité". Cela sert à créer un équipement qui affichera la température et la luminosité captés par le AirSend 433 (oui, il ne s'agit pas d'humidité mais de luminosité, c'est une erreur des développeurs eedomus).  Mettez "Oui" uniquement si vous avez un AirSend 433 MHz (pas si vous avez le AirSend 2 Duo 433 + 868 MHz car il ne contient pas de sonde) et si vous n'avez pas encore créé un équipement intégrant la fonction température et luminosité du AirSend.
• Cliquez sur "  Créer"
• Ensuite, cherchez l'équipement dans la pièce à lmaquelle vous l'avez associé et cliquez sur son nom afin d'éditer le périphérique

• Vérifiez si l'usage correspond bien à votre périphérique (ici : "Volet / Store" est le bon) et si vous le modifiez (ou si vous modifiez le nom ou la pièce, cliquez sur " Sauver et continuer à éditer".
• En haut de la fenêtre, cliquez sur l'onglet "Valeurs".

• Si nécessaire, changez les icônes et les noms des commandes en cliquant dessus. (en revcanche, ne changez pas les "Valeurs brutes".
• 0 correspond normalement à OFF pour un éclairage ou appareil, ou Fermer pour un volet et 100 à ON ou Ouvrir.
• Cliquez sur " Sauver"

• Le "Widget" de votre périphérique proposera alors les icônes et noms choisis pour ses actions. 

Utilisation avec Jeedom

Vous devez, dans un premier temps, avoir ajouté vos équipementsb 433 et/ou 868 MHz via le site AirSend.cloud (voir plus haut, le paragraphe dédié).

1 - INSTALLER LE PLUGIN "AirSend"

• Si vous n'avez pas encore lu l'article "installation des plugins Jeedom", nous vous recommandons de le faire avant de continuer.
• Allez sur le Market Jeedom (Plugins > Gestion des plugins > Market), puis cherchez le plugin AirSend en tappant "AirSend" dans le champ de recherche et en tapant sur entrée. Enfin, cliquez sur l'icône du plugin "AirSend" développé par Devmel.

• Cliquez sur   Installer stable 
• Quand Jeedom vous propose d'aller sur la page de configuration du plugin AirSend, acceptez en cliquant sur  OK 
• Activez le plugin en cliquant sur   Activer  dans le cadre   État 
• Une fois le plugin activé, dans le cadre   Dépendances  , cliquez sur   Relancer   (sauf si une installation de dépendance est déjà en cours, celle-ci pouvant aussi se lancer automatiquement dans les minutes qui suivent l'installation du plugin).

• L'installation des dépendances peut prendre quelques minutes suivant la rapidité de votre connexion Internet.

• Une fois les dépendances correctement installées, dans le cadre   Dépendances   le status doit passer à  OK  , si c'est bien le cas, vous pouvez passer aux étapes suivantes.

• Dans le cadre   Démon  , "Configuration" et "Status" devraient afficher  OK  , si tel est bien le cas, vous pouvez passer à l'étape suivante. Sinon, cliquez sur "(Re)Démarrer" 

2 - Ajouter la passerelle AirSend dans les équipements

• Allez dans le plugin AirSend :  Plugins > Protocoles domotiques > AirSend
• Cliquez sur  Ajouter 
• Nommez l'équipement "AirSend" et appuyez sur   OK 

• Cliquez sur l'équipement "AirSendé" créé et
• Sélectionnez un objet parent
• Activez l'équipement et s'il s'agit d'un AirSend 433, cochez "Visible" : Cela permettra de visualiser la température et la luminosité mesurés par le boitier. En revanche, cela n'est pas nécessaire avec le AirSend 2 Duo, car il ne dispose pas de ces fonctions.
• Type d'appareil doit être réglé sur "Boitier AirSend"
• Ajoutez la "LocalIP" du AirSend ainsi que son mot de passe ("password") tels qu'indiqués sur l'étiquette à l'arrière du boitier.
• Options facultatives : 
  • Cochez “Passerelle Internet” si votre AirSend n’est pas sur le réseau local.
  • Renseignez “Adresse Secondaire” par l’ipv4 du AirSend si la communication ipv6 locale ne fonctionne pas (avec docker par exemple).
  • Cochez “Écoute permanente” si vous souhaitez basculer en mode réception radio permanente (voir ci-dessous).
  • Cochez “Inclusion automatique” pour que les appareils détectés soient ajoutés directement.
• Cliquez sur   Sauver / Générer 

3 - Importation des équipements depuis AirSend.cloud

Le plus simple pour ajouter les équipements 433 / 868 MHz sur Jeedom est de les configurer via le site AirSend.cloud puis de les exporter sous forme de fichier et enfin d'importer ce fichier dans le plugin AirSend de Jeedom.

Pour importer, sur le site AirSend.cloud,

• cliquez sur  Importer / Exporter,
• sélectionnez les équipements que vous voulez exporter,
• puis appuyez sur exporter,
• enfin, si votre navigateur vous le demande, acceptez le téléchargement du fichier généré.

Pour importer les équipements,

• allez dans le plugin AirSend de Jeedom,
• cliquez sur   Import fichier,
• cliquez sur le bouton "Choisir un fichier" et allez chercher le fichier AirSend.cloud_date-heure.json précédemment téléchargé,
• cliquez sur   Importer 
• Il vous restera à cliquer sur les équipements créés pour les activer, les rendre visibles, les renommer si besoin, les lier à un objet, etc.

4 - Fonctionnement du mode "écoute permanente"

Avec ce mode le AirSend bascule en mode réception radio permanente et remonte vers jeedom les informations transmises par des éméetteurs 433 / 868 MHz.
Ainsi il est possible d’avoir un état des télécommandes réelles, capteurs et sondes compatibles.

Inclusion automatique

Pour ajouter dans jeedom ces télécommandes réelles (ou sondes) il faut activer temporairement le mode “inclusion automatique” deuis le plugin "AirSend", dans la configuration de l'équipement "AirSend".
A chaque réception d'une communicatiobn provenant d'une télécommande (ou ligne de touches d'une télécommande) ou d'un capteur supportés, un équipement sera créé. Il faudra ensuite l'éditer et lui affecter le type de télécommande le plus pertinent (1 touche, ON/OFF ou volet roulant) ou le mode capteur.
Certaines télécommandes de volet roulant seront reconnues comme 3 télécommandes 1-bouton.

Le mode “inclusion automatique” peut vite encombrer le plugin de nouvelles télécommandes, il vaut mieux l’activer temporairement.

Propagation de l’état

Dans la configuration de l'équipement télécommande créé, l’option “Propager l’état vers” permet d'afficher cet état sur la télécommande virtuelle (créée avec AirSend.cloud puis importée) et qui pilote l'appareil concerné.

Ce mode permet d’avoir un état très proche de l’état réel ainsi que les informations provenant de sondes et capteurs.
Le déclenchement de scénarios est également possible à partir du nouvel état ou informations reçus.