Jeedom est un serveur domotique Open Source Français très simple d’utilisation et disons le, très beau. Open Source ne signifie par toujours gratuit, Jeedom dispose de son Market et il faudra sortir sa carte bancaire de temps en temps lorsqu’on craque pour un module. Les prix sont toutefois très raisonnables (quelques euros). Dans ce tutoriel, nous allons préparer une box Jeedom DIY à base de Raspberry Pi 3, configurer le clavier en Français, la connexion WiFi intégrée et activer la connexion SSH.

Attention : ce tutoriel est obsolète depuis la version 3 de Jeedom

Récupérer l’image Jeedom Netinstall

La première étape consiste à aller récupérer l’image la plus récente pour Raspberry ici.

L’image se nomme Jeedom-rpi-2.0.0.1.rar et pèse environ 581Mo  Raspberrypi_Debian_jessie_4.4_jeedom_netinstall_20160924_rc1.rar. La date pourra changer dans le futur.

Préparer la carte SD avec Etcher

J’utilise toujours une carte SD de bonne qualité (SDHC classe 10) pour garantir une vitesse de fonctionnement optimale. Pour Jeedom, une carte de 8Go est suffisante mais compte tenu de la différence de prix, n’hésitez pas à opter pour 16Go ou 32Go.

Disons le clairement, je suis devenu fan d’Etcher (article de présentation) pour préparer mes cartes SD !

Avec Etcher, la préparation de la carte SD est un jeu d’enfant. Décompressez l’archive Rar (avec Stuffit sur macOS X ou WinRar sous Windows).

Lancez Etcher et indiquez le chemin de l’image qui se trouve dans le répertoire qui vient d’être créé. Insérez la carte SD et appuyez sur Flash! Après quelques minutes de patiente, votre carte SD est prête.

Configuration typique d’une box Jeedom 100%DIY

Si vous vous lancez dans la fabrication de votre Box domotique Jeedom, voici une configuration à base de Raspberry Pi 3 très bien adaptée. Vous pouvez également consulter ce guide d’achat sur le comparateur de prix.

	Raspberry Pi 3 Environ 40€
	Adaptateur vidéo (optionnel, pour l’installation) Adaptateur HDMI vers DSUB (VGA), environ 13€ Adaptateur HDMI vers DVI, environ 7€
	Boitier pour Raspberry Pi 3 A partir de 6,99€
	Carte SD 8 Go SDHC Classe 10 A partir de 6,90€
	Alimentation 5V – 3000mA Environ 11€

Il est bien souvent plus économique d’acheter le Raspberry Pi sous la forme d’un kit. On en trouve pour environ 55€ sur Amazon.

Pour piloter vos appareils sans fils depuis Jeedom, vous pouvez ajouter une passerelle domotique.

	RFXCom Environ 110€ Module payant 4€
	Clé Z-Wave Environ 34€ Module gratuit
	Passerelle Open Source RFLink Tutoriel pour fabriquer une passerelle RFLink 100% DIY pour 10,50€ Module payant 4€. Liste du matériel à acheter

Configuration du clavier, Wi-Fi et de la connexion SSH

Au premier démarrage, une connexion internet est nécessaire pour mettre à jour la distribution Raspbian et terminer l’installation de Jeedom. Si vous disposez d’un switch ou de routeur Ethernet à proximité, vous pouvez connecter le Raspberry Pi à internet à l’aide d’un câble ethernet. Si vous souhaité utiliser le Wi-Fi pour connecter la box domotique à internet, nous allons voir un peu plus bas comment configurer la connexion Wi-Fi du Raspberry Pi 3. Nous allons en profiter pour faire quelques réglages qui pourront être utiles au quotidien.

L’image de Jeedom est construite sur Raspbian, la distribution Linux officielle du Raspberry Pi. Vous allez donc rapidement retrouver vos marques. Si vous voulez en savoir plus, lisez cet article.

Branchez un clavier et un écran au Raspberry Pi et mettez le sous tension après avoir inséré la carte SD préparée avec Etcher.

Identifiez vous avec le login (root) et le mot de passe par défaut (Mjeedom96). Attention au premier démarrage le clavier est en qwerty. Le “M” se trouve sur la virgule (,). Le clavier numérique est désactivé.

Configurer Raspbian en Français

Avant toute chose, il est préférable de configurer le clavier en français

Clavier

Lancez raspi-config avec la commande

sudo raspi-config

Allez dans l’option (5) Internationalisation Options puis sur Change Locale. Dans la liste choisissez fr_FR.UTF-8 puis validez 2 fois.

Pour mettre le clavier en Français, retournez dans Internationalisation Options puis allez dans Change Keyboard Layout. Dans la liste sélectionnez PC Generic (intl) puis dans la disposition du clavier Français – Français (variante). Si vous ne savez pas quel modèle de clavier choisir, ne changer rien aux options proposées.

La zone Wi-Fi

Retournez enfin dans l’option (5) puis Change Wi-Fi Country. Dans la liste choisissez FR France. Validez et quittez raspi-config

Configurer le Wi-Fi du Raspberry Pi 3

Ouvrez le fichier d’interfaces

sudo nano /etc/network/interfaces

Vérifiez que l’interface wlan0 ressemble à ceci

allow-hotplug wlan0
iface wlan0 inet manual
   wpa-conf /etc/wpa_supplicant/wpa_supplicant.conf #(dans certains tutos on trouve également les options "iface default inet dhcp")

Enregistrez en appuyant sur CTRL+X puis Y

Si vous voulez vérifier les SSID disponibles (et la casse), exécutez la commande

sudo iwlist wlan0 scan

Maintenant éditez le fichier wpa_supplicant.conf

sudo nano /etc/wpa_supplicant/wpa_supplicant.conf

Modifiez la configuration en fonction de votre réseau. Si votre configuration n’est pas classique, vous devriez trouver des réponses sur cet article.

country=FR
ctrl_interface=DIR=/var/run/wpa_supplicant GROUP=netdev
update_config=1
network={
  ssid="SSID"
  psk="MOT_DE_PASSE"
  key_mgmt=WPA-PSK #optionnel
}

Enregistrez en appuyant sur CTRL+X puis Y. Vous pouvez redémarrez le Pi

sudo reboot

Comment trouver l’ip de Jeedom sur le réseau

Une fois redémarré, authentifiez vous et exécutez la commande ifconfig wlan0  pour connaitre l’adresse IP de la box Jeedom. Elle se trouve à coté de l’étiquette inet addr

Vous pouvez également allez sur votre box internet.

Par contre, Jeedom Finder n’est plus proposé au téléchargement depuis 16 décembre 2016.

Enfin si vous n’avez pas l’habitude des commandes linux, vous pouvez utiliser Jeedom Finder (lien de téléchargement).  Jeedom Finder est disponible pour Windows, Linux et macOS. Le mode automatique fonctionne très bien pour une installation domestique. 

Ecran d’accueil de Jeedom Finder sur macOS

Box Jeedom trouvées sur le réseau local.

Connexion SSH

Si vous débutez avec Linux, lisez cet article pour en savoir plus sur la connexion sécurisée SSH et le Raspberry Pi.

Pour pouvoir vous connecter en SSH à Jeedom, il faut tout d’abord ouvrir le port. Dans le Terminal, exécutez

sudo raspi-config

Allez dans Advanced Options puis SSH et enfin Enable. N’acceptez pas le redémarrage. Redémarrez le Raspberry Pi depuis l’interface Web de Jeedom pour plus de sécurité. En effet, il est préférable de laisser Jeedom fermer les fichiers temporaires, la connexion à la base de données… avant de redémarrer.

Depuis un autre ordinateur (ou depuis une tablette ou un smartphone), ouvrez un Terminal (ou un client SSH) et connectez vous soit avec ssh pi@jeedom ou ssh pi@ADRESSE_IP_PI. Le mot de passe est raspberry, le mot de passe par défaut de Raspbian ssh root@jeedom ou ssh root@IP_BOX_JEEDOM. Le mot de passe est Mjeedom96.

Connexion sécurisée à la box domotique en SSH

Image netinstall : Premier démarrage de Jeedom

Maintenant que l’on dispose d’une connexion internet, la première fois qu’on démarre Jeedom sur une nouvelle carte SD préparée à partir de l’image netinstall, un script termine l’installation de Jeedom et commence par faire une mise à jour de Raspbian. Cette opération peut prendre pas mal de temps (environ 45 minutes).

Durant cette phase, ne faites aucune autre installation ou mise à jour. Evitez de l’éteindre ou de le redémarrer. Bref attendez… Suivez la progression de l’installation depuis un navigateur internet depuis un autre ordinateur (tablette ou smartphone) relié au même réseau local.  

En vous connectant à Jeedom depuis un navigateur internet (http://IP_DE_VOTRE_PI/ ou http://jeedom/), vous pouvez suivre le déroulement de l’installation.

Une fois l’opération terminée, la page de connexion s’affichera. Connectez vous avec l’utilisateur admin et le mot de passe admin.

Comment mettre à jour de Jeedom ?

Pour mettre à jour Jeedom, allez dans le Centre de mise à jour qui est accessible depuis l’icône en forme d’engrenages.

Puis appuyez sur le combo Mettre à jour pour choisissez Jeedom seulement. Profitez en pour mettre à jour les plugins.

Vous pouvez suivre le déroulement de l’opération dans la fenêtre d’information. A la fin de la mise à jour, aucun redémarrage n’est nécessaire.

Arrêter correctement le Raspberry Pi

Comme le Raspberry Pi ne possède pas de bouton d’arrêt (ni de mise sous tension d’ailleurs), on est vite tenté de débrancher le câble USB pour arrêter le Raspberry Pi. Grave erreur ! C’est la première cause de mortalité de la carte SD. Même si on a l’impression qu’il n’y a pas d’activité, le système (ou Jeedom) est sans cesse en train d’écrire des choses sur la carte SD (fichiers log, point de mesure dans la base de données…). D’autre part Jeedom stocke les données dans une base de données MySQL (Maria maintenant). Il faut donc arrêter tout ça proprement avant de débrancher le Raspberry Pi du secteur.

Si vous avez un écran branché au Raspberry, il suffit d’exécuter la commande sudo poweroff . Attendez encore quelques secondes après que l’écran soit passé au noir.

Si vous n’avez pas d’écran et que vous accédé à Jeedom depuis l’interface Web, allez dans le menu utilisateur, puis Eteindre.

Une barre d’avancement indique la progression de l’arrêt mais si vous connecté un écran au Raspberry Pi, vous allez vous rendre compte que c’est un peu plus long.

Attendez encore une dizaine de secondes avant de débrancher.

Derniers conseils :

• N’hésitez pas à investir dans un onduleur pour protéger votre matériel des surtensions et des coupures de courant.
• Clonez régulièrement la carte SD et mettez à l’abris le fichier de sauvegarde créé automatiquement par Jeedom.

Erreur /tmp/jeedom-cache

Au premier démarrage, vous allez très certainement rencontrer le message d’erreur /tmp/jeedom-cache. Il apparait lors de l’activation de certains modules (par exemple MySensors). Redémarrez simplement Jeedom pour que tout rentre dans l’ordre.

https://www.jeedom.com/site/fr/

Mises à jour

• 17/08/2016 : amélioration de la configuration Wifi
• 27/10/2016 : adaptation du tutoriel suite au remplacement de l’image Jeedom-rpi-2.0.0.1 par Raspberrypi_Debian_jessie_4.4_jeedom_netinstall_20160924_rc1
• 19/12/2016 : Jeedom finder n’est plus proposé au téléchargement. Utilisez ifconfig pour connaître l’adresse ip de la box.
• 22/12/2016 : réorganisation de l’article pour clarifier le démarrage depuis netinstall
• 3/01/2017 : réécriture de l’article
• 8/10/2017 : ce tutoriel est obsolète ! Suivez ce tutoriel pour installer Jeedom v2 ou v3 sur Raspberry Pi et celui-ci sur Orange Pi (y compris sur la mémoire flash eMMC)

Vous pouvez partager vos difficultés et vos astuces sur le forum ici

• Inclure les accessoires domotiques Xiaomi Aqara ou Mijia à Jeedom avec les plugins Virtuel et MQTT
• Affichage OLED SSD1306 I2C sur Raspberry Pi. Code Python d’une mini station météo connectée à Jeedom avec la librairie Adafruit
• Station météo avec affichage ePaper (Dashboard) pour Jeedom sur Raspberry Pi (via l’API JSON RPC)
• Nouveau script d’installation de Jeedom v3.x sur Raspberry Pi (fonctionne aussi sur PC Linux Debian 8) [Màj 2018]
• Piloter le GPIO de l’ESP8266 (Serveur Web) depuis Jeedom en TCP/IP sans fil – Partie 2
• ESP8266 (Client Web) : envoyer des données à Jeedom en TCP/IP sans fil (API JSON) – Partie 1