Tutoriel complet nspanel pro et jeedom

Bonjour à tous,

Voici un tutoriel détaillé pour configurer un NSPanel Pro pour une utilisation avec Jeedom (Jeedom Connect ou Jeemate). Ce guide vous permettra de :

  1. Mettre à jour votre NSPanel Pro en version 3 (ROM).
  2. Basculer le NSPanel Pro en mode routeur Zigbee pour améliorer le routage.
  3. Supprimer des applications inutiles pour gagner en puissance et en espace sur le NSPanel Pro.
  4. Installer Jeedom Connect en mode launcher (possible aussi pour Jeemate en adaptant le point 4).

Ensuite, vous pouvez vous tourner cers ce tuto pour administrer votre NSPanel pro de Jeedom : Tuto - management et surveillance de son NSPanel Pro via Jeedom

UPDATE DU 17/09
1 - Rajout des procédures pour Jeemate en point 3 et 4 (merci @sagitaz)
2 - Rajout des commandes pour mettre à jour JeedomConnect

Pré-requis

  • Un Sonoff NSPanel Pro
  • Une connexion Wi-Fi
  • Un smartphone avec l’application eWeLink installée
  • Un ordinateur sous Windows ou Linux avec adb installé et opérationnel

Étape 1 : Déballage et Configuration Initiale

  1. Déballer le NSPanel Pro

    • Sortez le NSPanel Pro de son emballage.
    • Effectuez la configuration initiale : choix de la langue, connexion Wi-Fi, etc.
  2. Connexion au Wi-Fi et Intégration à eWeLink

    • Ouvrez l’application eWeLink sur votre smartphone.
    • Scannez le QR code affiché sur le NSPanel Pro pour l’ajouter à votre application.
    • Remarque : Inutile de faire les mises à jour.

Étape 2 : Activer le Mode Développeur

  1. Activer le Mode Développeur sur le NSPanel Pro
    • Sur le NSPanel Pro, allez dans les paramètres (Settings).
    • Cliquez 7 fois sur DEVICE ID pour activer le mode développeur.
      OU
    • Appuyer 7 fois sur l’ID du NSPANEL sur l’objet NSpanel dans l’application eWeLink.

Attention : Cette action annulera définitivement la garantie et il n’y a pas de retour en arrière possible.

  1. Activer ADB dans eWeLink
    • Sur l’application eWeLink, allez dans les paramètres du NSPanel Pro.
    • Allez dans Mode développeur et activez ADB.

Étape 3 : Télécharger tous les outils nécessaires

  • Sur le site GitHub de seaky:
    • nspanel_pro_tools_apk
    • nspanel_pro_roottool_apk
  • Sur le site GitLab de svanrossem:
    • Les 6 scripts (les mettre dans un répertoire spécifique sonoff-nspanelpro-scripts)
  • La ROM à jour : CoolKit_Sonoff_480P_20240306_3.0.0-ota.zip
    • La renommer en system_update.zip
  • L’apk Jeedom Connect ou Jeemate
    • Pour Jeedom Connect : JeedomConnect releases - Attention à bien prendre la release correspondant à votre installation (beta ou stable)
    • Pour JeeMate : prendre l’apk sur le site ou sur apk-pure. Préparer votre interface depuis un smartphone ou l’app windows, sauvegarder et passer là en partagée.

Étape 4 : Installation de Jeedom Connect en mode Launcher

  1. Installer Jeedom Connect
    adb connect [ip_address]
    adb install JC_XXXXXX.apk (en fonction de la release récupérée)
    
  2. Rebooter le NSPanel Pro
    • Au redémarrage, il doit vous demander de sélectionner le launcher par défaut. Sélectionnez Jeedom et cochez « Toujours ».
    • Connectez-vous à Jeedom Connect (voir documentation Jeedom pour la création d’équipement côté plugin).
    • Configurez Jeedom Connect pour afficher le lanceur d’applications dans la barre du haut (Préférences >> Barre du haut >> Bouton de la barre du haut).

Le minimum est fait côté Jeedom Connect. Passons aux mises à jour et à l’optimisation du Sonoff NSPanel Pro.

Étape 4BIS : Installation de Jeemate en mode Launcher

  1. Installer JeeMate
adb connect [ip_address]
adb install jeemate.apk (en fonction de la release récupérée)
  1. Rebooter le NSPanel Pro

Au redémarrage, il doit vous demander de sélectionner le launcher par défaut. Sélectionnez JeeMate et cochez « Toujours ».

Dans le plugin → créer u nouveau equipement et lancer la procédure d’appairage automatique.
Ouvrez l’application sur le NSPanel, selectionner votre Jeedom et valider l’appairage automatique.

Installer la sauvegarde.

Attention : il n'est pas possible d'effectuer la mise a jour de l'application defini comme launcher, donc installer un autre launcher pour basculer dessus si vous souhaiter maj JeeMate. j'ai de mon coté installé ultra-small-launcher.

Étape 5 : Mise à Jour du NSPanel Pro en Version 3.0.0

Cette opération peut être faite à l’étape 1-2 pour upgrader en toute derniere version (3.5 au 22/09), Attention néanmoins, je ne connais pas le fonctionnement des outils avec une version autre que le FW 3.0 fourni ici

  1. Installation des Outils nécessaires

    adb connect [ip_address]
    adb install nspanel-pro-roottools-1.0-release.apk
    adb reboot
    
  2. Téléchargement et Transfert de la Mise à Jour

    adb push system_update.zip /storage/emulated/0/
    
  3. Mise à Jour via l’Application sur le NSPanel Pro

    • Ouvrez l’application nspanel_pro_roottool via le lanceur d’application sur le NSPanel Pro et lancez la mise à jour.
    • Après le redémarrage, l’outil indiquera que vous êtes en version 3.0.

Étape 6 : Bascule du NSPanel Pro en Mode Répéteur Zigbee

  1. Connexion et Accès Root

    adb connect [ip_address]
    adb root
    adb shell
    
  2. Montage du Système en Écriture

    mount -o remount,rw /vendor
    exit
    
  3. Clonage du Dépôt et Transfert des Scripts

Sous linux :

cd sonoff-nspanelpro-scripts
find *.sh -exec adb push {} /vendor/bin/siliconlabs_host/ \;
adb shell  chmod +x /vendor/bin/siliconlabs_host/mod-*
exit

Sous windows (en powershell) :

cd sonoff-nspanelpro-scripts
Get-ChildItem -Filter *.sh | ForEach-Object { adb push $_.FullName /vendor/bin/siliconlabs_host/ }
adb shell chmod +x /vendor/bin/siliconlabs_host/mod-*
exit

Étape 7 : Exécution des Scripts de Configuration Zigbee

  1. Écoute des Topics MQTT

    adb shell /vendor/bin/siliconlabs_host/mod-mqtt_listen.sh
    

    Sur un autre terminal pour laisser le script précédent tourner :

  2. Configuration du Module Zigbee en Mode Répéteur

    adb shell /vendor/bin/siliconlabs_host/mod-set_zigbee_repeater_mode.sh
    
  3. Activation du Mode Pairing en Mode Répéteur

    • Activez le mode appairage sur votre plugin Zigbee préféré (ex : z2m).
    • Exécutez la commande suivante :
    adb shell /vendor/bin/siliconlabs_host/mod-set_zigbee_repeater_pairing_mode.sh
    
    • Vous verrez ainsi votre NSPanel Pro apparaître dans la liste des équipements (sans commandes associées, il ne fera que du routage).
  4. Activation du Mode Turbo Zigbee

    • Vous pouvez modifier la puissance d’émission Zigbee (impact inconnu) :
    adb shell /vendor/bin/siliconlabs_host/mod-set_zigbee_turbo_mode.sh 10
    adb shell /vendor/bin/siliconlabs_host/mod-set_zigbee_turbo_mode.sh 20
    

Étape 8 : Suppression des Applications Inutiles

  1. Gagner en Fluidité sur le NSPanel Pro
    adb shell /vendor/bin/siliconlabs_host/mod-debloat_nspanelpro.sh
    

Étape 9 : Installer les Outils de Paramétrage du NSPanel Pro

  1. Installer nspanel_pro_tools
    adb install nspanel_pro_tools_apk
    adb reboot
    
  2. Lancer nspanel_pro_tools
    • Via le lanceur d’application sur Jeedom Connect, lancez nspanel_pro_tools et découvrez les paramétrages possibles.

Étape 10 : Utilisation de scrcpy

  1. Installer et Configurer scrcpy
    • Téléchargez et installez scrcpy depuis GitHub.
    • Configurez un fichier de lancement de scrcpy (scrcpy-console.bat) avec le contenu suivant :
    @echo off
    adb connect [ip_address]
    scrcpy -e --video-codec=h264 --video-encoder='OMX.google.h264.encoder' --pause-on-exit=if-error %*
    
  2. Lancer scrcpy
    • Lancez scrcpy via le fichier scrcpy-console.bat créé pour travailler graphiquement sur le NSPanel Pro depuis votre ordinateur.

Mise à jour de Jeedom Connect

Après avoir télécharger l’apk :

adb connect [ip_address]
adb install -r JC_XXXXXX.apk (en fonction de la release récupérée)

Attention, soyez vigilant à bien prendre la bonne version (beta ou stable) pour fair ela MAJ, vous ne pourrez pas revenir en arrière en cas d’erreur, nécessité de complètement désinstaller JC pour le réinstaller et restaurer une save


Merci de vos retours.

Norbert.

23 « J'aime »

Salut.
Super tuto, merci.
Pourquoi ne pas proposer Fully Kiosk Browser en plus de JC et JM ?
Il s’adapte à toutes les résolutions et c’est plutot efficace avec les Designs de jeedom.
Il existe aussi un plugins jeedom pour piloter Fully Kiosk.

N’hésite pas à m’indiquer les éléments à rajouter pour intégrer fullykiosk (en sachant qu’il faut intégrer un launcher). Ce n’est pas indiqué parceque je ne connais pas.

Il en est de même pour plugin-mobile et plugin-jeemate . Si quelqu’un veut me donner les billes pour intégrer dans le NSpanel pro, je suis preneur.

Norbert

La tout de suite, je ne sais pas. Je vais creuser le sujet.
Pourquoi installer la rom V3.0 alors que le dernier upgrade est en 3.3 ?

Parceque c’est la dernière rom disponible (sauf si tu m’en trouve une autre :sweat_smile:). Je pense que la 3.3 concerne le.client/launcher eweelink (qui s’appuie sur la rom 3.0)

1 « J'aime »

Selon le site Sonoff NSPanel Pro Secrets, Tips and Tricks | Blakadder's Smarthome Shenanigans Il existe une app (Target Home Launcher) qui permet de choisir un app de son choix en démarrage par défaut.

Après l’étape 5.1 j’ai du faire un reboot pour voir l’application dans le lanceur d’application.

Idem en 9.1

Je corrigerai.

Pour target home launcher, je n’en vois pas l’ intérêt. Un fois le launcher JC installé (ou un autre, on ne change pas(

Norbert

Tu as raison, d’autant plus qu’il est possible de le faire avec nspanel-pro-tools.

Bonjour,

Pour info sur différents forum des personnes utilisent apparemment ,ce launcher : ultra-small-launcher si vous souhaitez tester autre chose qu’avec JC.

Fully Kiosk je l’utilise également sur ma tablette 10 pouces, je ne sais pas s’il serait adapté à la taille de l’écran du NsPanel.

J’ai une questions complémentaire j’avais lu que le NSpanel Pro était sous Andoid 8, vous pouvez confirmer ? Avec le firmware 3.0 peut etre une évolution ? J’espère car bientôt des applications via d’anciens apk ne pourront plus être installés (j’ai eu le cas avec fully Kiosk et ma tablette qui était en Android 7… j’ai du changer alors que cela était suffisant juste pour de l’affichage de Design)

Je confirme. Avec l’upgrade 3.0, c’est la version 8 d’android.

Oui, c’est bien Android 8 et je pense que ça ne changera pas.

Norbert

Et mince je pense aussi. Merci

Super tuto!
Merci beaucoup @ngrataloup .
J’hésitais à m’acheter un second NSPANEL PRO au vu des soucis rencontrés par certains avec les nouvelles versions de firmwares.

Je sens que je vais me (re)lancer!

Lionel

Ai de mon côté eu des soucis sur le premier (avec nécessité de le rebrancher à l’USB pour réactiver adb) mais zéro soucis avec les nouveaux qui arrivent en firmware 2.2.

Norbert

1 « J'aime »

Merci beaucoup pour le tutos, ça va m’être utile, surtout le debloating… parce que sans JC est lent même sans rien d’exceptionnel dessus.
A force de bidouiller j’étais quand même parvenu à installer JC sur mon NSpanelPro, la méthode utilisée ressemblait beaucoup à la tienne.
La différence c’est que j’ai mis NSpanelPro-tool en launcher, et c’est lui qui lance JC avec le watchdog activé au cas où. Mais ça doit pas changer grand chose.

Pour la connexion de JC à Jeedom, j’ai utilisé le QRcode : enregistrer-sous dans jeedom, puis push avec ADB et dans JC ouvrir le fichier du QRcode, ça fonctionne nickel et c’est plus pratique que de rentrer les identifiants à la main.

Salut.
Pour pouvoir utiliser les commandes (TTS, allumer l’écran,…) du plugin Jeedom Connect et éviter le message « No token defined. Please connect your device first » dans les logs du plugin, il semble qu’il faille installer les services google (ou equivalent MicroG)

J’apporte une précision. C’est nécessaire pour lancer les commandes quand l’écran est en veille.

Si le pb est juste l’écran en veille, on peut contourner ceci en allumant l’ecran via adb.

C’est justement, mon test en cours « adb shell input keyevent KEYCODE_WAKEUP » et ca fonctionne.
Par contre j’aimerais bien le lancer depuis la commande shell du plugins