MCHobby - Wiki - Contributions de l’utilisateur [fr]

Modèle:Link-product-pi3plus

2025-08-12T13:23:24Z

AntoineWrt :

[https://shop.mchobby.be/fr/177-raspberry-pi-tous-modeles Raspberry Pi 5 et Raspberry Pi 4]

Modèle:Link-product-pi3bplus

2025-08-12T13:23:16Z

AntoineWrt :

[https://shop.mchobby.be/fr/177-raspberry-pi-tous-modeles Raspberry Pi 5 et Raspberry Pi 4]

Modèle:Link-product-pi3

2025-08-12T13:23:10Z

AntoineWrt :

[https://shop.mchobby.be/fr/177-raspberry-pi-tous-modeles Raspberry Pi 5 et Raspberry Pi 4]

Modèle:Link-product-pi2

2025-08-12T13:23:01Z

AntoineWrt :

[https://shop.mchobby.be/fr/177-raspberry-pi-tous-modeles Raspberry Pi 5 et Raspberry Pi 4]

Modèle:Link-product-pi

2025-08-12T13:22:19Z

AntoineWrt :

[https://shop.mchobby.be/fr/177-raspberry-pi-tous-modeles Raspberry Pi 5 et Raspberry Pi 4]

RaspberryPi-Accueil

2025-08-12T13:21:01Z

AntoineWrt : /* Bienvenue */

{{device-links}}

== Bienvenue ==
{{bloc-etroit|text=
<div class="noprint" style="margin-bottom: 15px; padding: 5px 5px 5px 5px; border-radius: 10px 10px 10px 10px; border: 1px solid rgb(229,229,299);">
Bienvenue sur la page d'accueil [http://www.mchobby.be MicroControleur Hobby] alias MCHobby dédiée au {{link-product-pi}}.<br />Vous pouvez bien entendu trouver ces produits sur le [https://shop.mchobby.be Shop de MCHobby]<br />
Vous y trouverez l'information et/ou traductions que nous avons accumulé à propos du Raspberry Pi.</div>
}}

== Découverte & système d'exploitation ==
{{ttuto-begin}}

{{ttuto
|label=Mise-à-jour EEPROM
|descr=Mise à jour de la Boot EEPROM du Pi 5 ET installation d'un disque NVMe
|img=tlogo-pi-boot-rom.jpg
|link=RASP-BOOT-ROM-UPGRADE
}}

{{ttuto
|label=Hat M.2
|descr=Installer le Hat M.2 sur un Raspberry-Pi 5
|img=tlogo-pi-hat-m2.jpg
|url=https://arduino103.blogspot.com/2024/05/hat-m2-officiel-pour-raspberry-pi.html
}}

{{ttuto
|label=Tour Pi 3
|descr=Venez découvrir les nouveautés du Raspberry Pi 3
|img=tlogo-rasp-pi-3.jpg
|link=RASP-PI3
}}

{{ttuto
|label=Pi Zero Tour
|descr=Venez découvrir le Pi Zero et ses possibilités. Un joujou incroyable pour les Makers et Hackers.
|img=tlogo-rasp-pi-zero.jpg
|link=RASP-PIZERO
}}

{{ttuto
|label=Pi Zero W Tour
|descr=Venez découvrir le Pi Zero W. Un joujou incroyable pour les Makers et Hackers.
|img=tlogo-rasp-pi-zero-w.jpg
|link=RASP-PIZERO-W
}}

{{ttuto
|label=Pi Zero Headless
|descr=Donner une étincelle de vie à votre Pi Zero, Pi Zero W avec le minimum d'effort et de matériel.
|img=tlogo-pi-headless.png
|link=Pi-Zero-Headless
}}

{{ttuto
|label=Whezzy Raspbian
|descr=Distribution de la fondation Raspberry Pi. Dérivé de Debian et utilise XCFE comme environnement graphique
|img=tlogo-rasp-Os-Wheezy.jpg
|link=Rasp-Os-Whezzy
}}

{{ttuto
|label=Moniteur DVI
|descr=Raccordez votre Raspberry sur moniteur.
|img=tlogo-dvi.jpg
|link=Rasp-Moniteur-DVI
}}

{{ttuto
|label=Périphériques USB et Pi
|descr=Les périphériques USB et le Raspberry Pi.
|img=tlogo-Rasp_USB.jpg
|link=Rasp-Usb-Warning
}}

{{ttuto
|label=Pi2: Boot et LEDs
|descr=<strong><font color="red">Help!!! Mon Pi ne démarre pas</font></strong>.
|img=tlogo-Rasp-Pi2-Boot-et-LED.jpg
|link=Rasp-Pi2-Boot-et-LED
}}

{{ttuto
|label=Kill or not kill the SD
|descr=Apprenez comment préserver la durée de vie de votre carte SD.
|img=tlogo-SD-Killer.jpg
|link=Rasp-SD-Preserver
}}

{{ttuto
|label=Démarrage automatique
|descr=Démarrer automatiquement un script Python sous Raspbian.
|img=tlogo-autostart-script.jpg
|link=Rasp-AutoStart-Script
}}

{{ttuto
|label=Pi Desktop
|descr=Un boîtier type NUC et disque SSD pour Raspberry-Pi 3. Transformer le Pi en nano ordinateur de bureau.
|img=tlogo-pi-desktop.jpg
|link=Pi-Desktop-Assemblage
}}

{{ttuto
|label=Ressources
|descr=Quelques liens utiles pour exploiter votre Pi.
|img=tlogo-pi-ressources.jpg
|link=Pi-Ressources
}}

{{ttuto
|label=Objectifs HQ-CAM
|descr=Quels objectif choisir pour sa HQCam
|img=tlogo-pi-hqcam.jpg
|link=Pi-HQ-CAM-LENS
}}

{{ttuto
|label=SuperPI
|descr=Créer un SuperCalculateur à base de Raspberry-Pi
|img=tlogo-superpi.jpg
|traduction=1
|link=SuperPi-Accueil
}}

{{ttuto-end}}

== Tutoriels ==
=== Prise en main ===
{{Ambox
| type = delete
| image = [[File:StopHand.png|40px|alt=Stop]]
| textstyle = color: red; font-weight: bold; font-style: italic;
| text = Nous n'insisterons jamais assez sur le fait qu'une fois connecté sur un réseau, votre Raspberry peut facilement devenir un serveur pirate si vous ne modifiez pas le mot de passe administrateur.<br />Changer le mode de passe de l'administrateur "pi" avec la commande '''passwd'''... c'est capital pour la sécurité de votre réseau !
}}

{{ttuto-begin}}

{{ttuto
|label=Agrandir la partition
|descr=Agrandissez la partition principale de Wheezy Raspbian et Occidentalis
|img=tlogo-rasp-partition.jpg
|link=PI-Etendre-Partition
}}

{{ttuto
|label=Clavier Belge
|descr=Comment configurer un clavier Belge sur Pi.
|img=tlogo-Rasp-ClavierBe.jpg
|link=Rasp-Clavier-BE
}}

{{ttuto
|label=Config Réseau & WiFi
|descr=Comment se connecter sur Internet via WiFi ou réseau Ethernet, via interface graphique ou en ligne de commande
|img=tlogo-Rasp-Network.jpg
|link=Rasp-Config-Reseau
}}

{{ttuto
|label=Changer Hostname
|descr=Modifier le nom réseau de votre Raspberry-Pi pour qu'elle s'annonce avec un nom différent sur le réseau.
|img=tlogo-Rasp-Hostname.jpg
|link=Rasp-Config-Hostname
}}

{{ttuto
|label=apt.adafruit.com
|descr=Ajoutez le dépôt Adafruit et facilitez l'installation de vos logiciels.
|img=tlogo-apt-adafruit-com.jpg
|link=Rasp-APT-ADAFRUIT-COM
}}

{{ttuto
|label=Overclocking
|descr=Augmentez la vitesse de votre PI (Whezzy Raspian) en utilisant une méthode d'Overclocking.
|img=tlogo-rasp-overclocking.jpg
|link=PI-Overclocking
}}

{{ttuto
|label=SSH
|descr=Commander son PI en SSH... ou comment profiter du confort de son PC tout en prenant les rênes de son PI à distance :-).
|img=tlogo-rasp-ssh.jpg
|link=PI-SSH
}}

{{ttuto
|label=Pi-Copier/Pi-Coller
|descr=Copier/Coller super facile pour copier du code python vers un Raspberry super facilement.
|img=tlogo-rasp-easycopypaste.jpg
|link=PI-Easy-Copy-Paste
}}

{{ttuto
|label=Préparer Python
|descr=Préparation de Python pour faire de hacking électronique.
|img=tlogo-rasp-python-update.jpg
|link=Pi-Python-Prepa
}}

{{ttuto
|label=Debuggeur Python
|descr=<strong>PuDB</strong> est un déboggeur Python qui fonctionne en SSH!.
|img=tlogo-rasp-python-pudb.jpg
|link=Pi-Python-PuDB
}}

{{ttuto
|label=Utiliser VNC
|descr=Comment prendre le contrôle à distance de votre Pi grâce à VNC. Très utile pour faire des capture d'écran.
|img=tlogo-Pi-Vnc.jpg
|link=Pi-VNC
}}

{{ttuto
|label=webIDE
|descr=webIde permet de coder et exécuter des programmes depuis un navigateur Web (supporte Python, Ruby, JavaScript, ...).
|img=tlogo-WebIde.jpg
|link=Pi-WebIde
}}

{{ttuto
|label=WiringPi
|descr=Libraire d'accès GPIO en C, fort semblable à l'environnement Arduino, disposant de Wrapper en Python, Ruby, Java, ... et son célèbre utilitaire '''gpio'''
|img=tlogo-WiringPi.jpg
|link=Pi-WiringPi
}}

{{ttuto
|label=USB Audio
|descr=Module Audio USB pour Raspberry Pi
|img=tlogo-USB-Audio.jpg
|link=Pi-USB-Audio
}}

{{ttuto
|label=MP3 sur Pi
|descr=Utiliser mpg321 pour jouer des fichiers MP3 (sur notre blog)
|img=tlogo-Audio-MP3.jpg
|link=PI-Audio-MP3
}}

{{ttuto
|label=PiFace
|descr=Interface entrée/sortie pour Raspberry Pi destiné aux débutants et écoles. <b>Inclus contrôle avec Scratch.</b>
|img=tlogo-piface.jpg
|link=PiFace-Manuel
}}

{{ttuto
|label=PiFace 2
|descr=Interface entrée/sortie pour Raspberry Pi 2/3 destiné aux débutants et écoles.
|img=tlogo-piface2.jpg
|link=PiFace2-Manuel
}}

{{ttuto
|label=UniPi
|descr=Carte d'extension pour réaliser un automate programmage à partir d'un Raspberry-Pi.
|img=tlogo-unipi.jpg
|link=UniPi-Manuel
}}

{{ttuto
|label=PiBrella
|descr=Carte d'interface super simple pour Raspberry
|img=tlogo-Pibrella.jpg
|link=PiBrella
}}

{{ttuto
|label=RTC PCF8523
|descr=Une horloge temps réel pour Raspberry-Pi
|img=tlogo-PCF8523.jpg
|link=RASP-PCF8523
}}

{{ttuto
|label=PI Remote Screen
|descr=Le Pi 3 autonome avec une tablette comme terminal
|img=tlogo-pi-remote-screen.png
|link=RASP-PI-REMOTE-SCREEN
}}

{{ttuto
|label=HAT TV
|descr=Configurer et utiliser le HAT TV
|img=tlogo-hat-tv.jpg
|link=RASP-HAT-TV
}}

{{ttuto-end}}

=== Projets ===

{{ttuto-begin}}

{{ttuto
|label=Projet DOMO
|descr=Domotiser sa maison avec OpenRemote + Raspberry + Arduino. Un magnifique tutoriel de D. Swinnen
|img=tlogo-projet-domo.jpg
|link=PROJET-DOMO
}}

{{ttuto-small
|label=Retro-gaming avec PI
|descr=Simuler une frappe clavier depuis le GPIO = Un vrai Retro-Gaming
|img=tlogo-Retro-Games.jpg
|link=Rasp-Retro-Games
}}

{{ttuto-small
|label=PiGRRL 2
|descr=Réaliser un émulateur de jeu portable avec un Pi 2 ou Pi 3, un PiTFT et un amplificateur audio.
|img=tlogo-pigrrl-2.png
|link=Rasp-PiGRRL-2
}}

{{ttuto-small
|label=Node-Red
|descr=Utiliser Node-Red sur Raspberry-Pi. Gérer facilement vos flux, événements et actions avec un éditeur visuel.
|img=tlogo-rasp-node-red.jpg
|link=Rasp-Node-Red
}}

{{ttuto-small
|label=RPi UMPC
|descr=Réaliser et imprimer un UMPC Raspberry-Pi en imprimant les différents éléments.
|img=tlogo-RPi-UMPC.jpg
|link=Rasp-UMPC
}}

{{ttuto-end}}

=== Programmation ===

Un Raspberry peut se programmer avec de nombreux langages. Parmi la foule de langage, nous pouvons relever Python bien adapté à la découverte de la programmation, Scratch qui est un environnement graphique très attrayant et le langage C plutôt destiné au développeurs expérimentés.

Voici quelques références utilisées par MCHobby, elles vous aiderons à apprendre Python. Nul doute que vous en trouverez de nombreuses autres sur le Net... mais cette sélection est de qualité.

{{ttuto-begin}}

{{ttuto
|label=Progr. en Python
|descr=Apprendre a programmer en Python (en-ligne). Par Vincent le Goff.
|img=tlogo-rasp-Python-Programmer-LeGoff.jpg
|link=PI-Python-Apprendre-en-Python
}}

{{ttuto
|label=Progr. Python
|descr=Programmation Python - Conception et optimisation de Tarek Ziadé.
|img=tlogo-rasp-Python-Programmer-Ziade.jpg
|link=PI-Python-Programmation-Python
}}

{{ttuto
|label=Apprendre Python
|descr=Apprendre a programmer Python et Python 3 (PDF, Gratuit) via un parcours académique. Par Gérard Swinnen.
|img=tlogo-rasp-Python-Programmer.jpg
|link=PI-Python-Apprendre-Python
}}

{{ttuto
|label=UTF8, Unicode et encoding
|descr=UnicodeDecodeError peut être votre pire cauchemar. Comprenez le afin qu'il ne soit plus un problème.
|img=tlogo-Python-Encoding.jpg
|link=PI-Python-Encoding
}}

{{ttuto
|label=Python et Tkinter
|descr=Des interfaces graphiques en Python avec Tkinter
|img=tlogo-Python-tkinter-programming.jpg
|link=PI-Python-TkInter-Programming
}}

{{ttuto
|label=Pygubu
|descr=Form Designer pour Tkinter. Liens vers vidéos d'apprentissage
|img=tlogo-Python-pygugu.jpg
|url=https://arduino103.blogspot.com/2023/09/pygubu-form-designer-pour-python.html
}}

{{ttuto
|label=Python Turtle
|descr=Apprendre Python avec Turtle en faisant du '''Logo en Python'''.
|img=tlogo-Python-turtle.jpg
|link=Python-Turtle-Online
}}

{{ttuto-end}}

Quelques références:
* [http://fr.wikipedia.org/wiki/Python_%28langage%29 Le langage Python] sur Wikipedia.fr.
* L'[http://www.afpy.org/ Association Francophone Python] (AFPY)
* [http://fr.openclassrooms.com/informatique/cours/apprenez-a-programmer-en-python Apprenez à programmer en Python] par Prolixe, sur fr.openclassrooms.com.
* Les [http://docs.python.org/2/ pages de documentation sur Python 2.7] (''Anglais'', Pyhton.org).
* La section [http://python.developpez.com/ Python sur Developpez.com]
* [http://effbot.org/imagingbook/imagedraw.htm PIL - Python Image Library] - les commandes de dessins (''effbot.org'', anglais)

=== Tutoriels - Hacking électronique ===
Pour tous ces tutoriels, assurez vous d'avoir accomplit la section"préparation Python" ci-avant.

{{ttuto-begin}}

{{ttuto-small
|label=Raspberry GPIO
|descr=Le GPIO du Raspberry B ou '''Pi 3''', Pi 2, Pi B+, Pi Zero, '''Pi Zero W''' en détail avec utilisation GPIO, I2C, etc
|img=tlogo-Rasp-Hack-GPIO40.jpg
|link=Rasp-Hack-GPIO
}}

{{ttuto-small
|label=Pi Cobbler
|descr=Raccordez un PI sur une plaque de prototypage
|img=RASP-ADFCOBBLER (mini).jpg
|link=PI-Cobbler
}}

{{ttuto-small
|label=Pi LEDs
|descr=Commander des LEDs avec votre PI
|img=Rasp-Hack-LED (mini).jpg
|link=Rasp-Hack-LED
}}

{{ttuto-small
|label=Pi GMail LED
|descr=Vérifier les e-mails en attente sur GMail et allumer une LED
|img=Rasp-Hack-GMAIL-LED (mini).jpg
|link=Rasp-Hack-GMAIL-LED
}}

{{ttuto-small
|label=Pi Button
|descr=Détecter l'état d'un bouton avec PI et allumer une LED.
|img=Rasp-Hack-PiButton (mini).jpg
|link=Rasp-Hack-PiButton
}}

{{ttuto-small
|label=Senseur PIR
|descr=Détecteur de proximité de type PIR (alarme)
|img=Rasp-Hack-PiPir (mini).jpg
|link=Rasp-Hack-PiPir
}}

{{ttuto-small
|label=Lecture Analogique MCP3008
|descr=Réaliser une lecture analogique à l'aide d'un MCP3008.
|img=Rasp-Hack-PiAnalog (mini).jpg
|link=Rasp-Hack-PiAnalog
}}

{{ttuto-small
|label=MCP23017 pour ajouter des I/O
|descr=Ajouter des entrées/sorties avec un MCP23017.
|img=Rasp-Hack-MCP23017.jpg
|link=Rasp-Hack-MCP230XX
}}

{{ttuto-small
|label=Senseur à Effet Hall
|descr=Utiliser un senseur digital US5851LUA (populaire chez Arduino).
|img=Rasp-Hack-Hall (mini).jpg
|link=Rasp-Hack-Hall
}}

{{ttuto-small
|label=DHT11, DHT22
|descr=Utiliser le senseur d'humidité DHT11, DHT22 ou AM2302 sur votre Pi.
|img=Rasp-Hack-DHT22.jpg
|link=Rasp-Hack-DHT22
}}

{{ttuto-small
|label=Câble Console
|descr=Câble Console USB-Série TTL, connectez vous à votre PI sans souris, clavier et écran.
|img=Rasp-Hack-USB-Serie-TTL (mini).jpg
|link=Rasp-Hack-USB-Serie-TTL
}}

{{ttuto-small
|label=Serveur HDMI
|descr=Transformer un Raspberry Pi en serveur d'affichage HDMI pour Arduino... un '''HDMI Shield''' abordable
|img=Rasp-Hack-HDMI-Serveur (mini).jpg
|link=Rasp-Hack-HDMI-Serveur
}}

{{ttuto-small
|label=Afficheur LCD
|descr=Afficher des informations sur votre PI avec LCD Monochrome, RGB et GPIO Extender + LCD
|img=Rasp-Hack-Afficheur-LCD (mini).jpg
|link=Rasp-Hack-Afficheur-LCD
}}

{{ttuto-small
|label=Contrôleur Led
|descr=contrôler une matrice LED ou un afficheur 7 segments d'AdaFruit avec votre PI.
|img=Rasp-Hack-Led-Backpack (mini).jpg
|link=Rasp-Hack-Led-Backpack
}}

{{ttuto-small
|label=Pont-H L293
|descr=Contrôler des moteurs a courant continu (sens et vitesse) avec un Pont-H, PWM et votre PI.
|img=Rasp-Hack-L293 (mini).jpg
|link=Rasp-Hack-L293
}}

{{ttuto-small
|label=Moteur Pas-à-Pas
|descr=Contrôler un moteur pas-à-pas avec votre Pi à l'aide des circuit-intégrés L293D ou ULN2803.
|img=Rasp-Hack-Stepper (mini).jpg
|link=Rasp-Hack-Stepper
}}

{{ttuto-small
|label=Hat Moteur
|descr=Contrôler des moteurs continus ou moteurs pas-à-pas avec votre Raspberry-Pi et la Hat Moteur / Motor Hat.
|img=Rasp-Hat-Moteur.jpg
|link=Rasp-Hat-Moteur
}}

{{ttuto-small
|label=ArduPi-I2C
|descr=<strong>Raspberry-Pi et Arduino qui communiquent via le bus I2C</strong>... de la dynamite!
|img=tlogo-ArduPi-I2C.jpg
|link=ArduPi-I2C
}}

{{ttuto-small
|label=Pi-Shield LCD 2x16 RGB + Keypad
|descr=Afficheur 2x16 caractères, rétro-éclairage RGB + Keypad sous forme de <strong>Pi-shield pour Raspberry</strong> via le bus I2C!
|img=RASP-LCD-RGB.jpg
|link=RASP-LCD-RGB
}}

{{ttuto-small
|label=GPS pour Raspberry
|descr=Utiliser le câble console (ou l'UART) et le GPS ultime pour traquer votre Pi!
|img=tlogo-RASP-GPS-ULTIME.jpg
|link=RASP-GPS-ULTIME
}}

{{ttuto-small
|label=Pi TFT
|descr=Un TFT 320x240 2.8 pouce + écran tactile pour Raspberry Pi!
|img=tlogo-PiTFT.jpg
|link=RASP-PiTFT
}}

{{ttuto-small
|label=Pi TFT PLUS
|descr=Un TFT 480x320 3.5 pouce + écran tactile pour Raspberry Pi 2, A+, B+!
|img=tlogo-PiTFT-Plus.jpg
|link=RASP-PiTFT-PLUS
}}

{{ttuto-small
|label=RPi ShieldBridge
|descr=Un Arduino sur un Pi... le meilleur des deux mondes!
|img=tlogo-RPi-ShieldBridge.jpg
|link=RPI-ShieldBridge
}}

{{ttuto-small
|label=Mesurer la Pression
|descr=Mesurer la pression avec un BMP0180 ou BMP085 via le bus I2C.
|img=tlogo-Rasp-Hack-BMP085.jpg
|link=Rasp-Hack-BMP085
}}

{{ttuto-small
|label=Pont-H L298 avec Pi
|descr=Piloter des moteurs puissants avec un Raspberry-Pi et un Breakout L298.
|img=tlogo-l298.jpg
|link=Rasp-Hack-L298
}}

{{ttuto-small
|label=EZ-Link - Appairage avec Android
|descr=EZ-Link établit une connexion série(SPP) via Bluetooth vers l'hôte. Tuto de liaison PC/Raspberry <-> Android.
|img=tlogo-EZLink-Test-Serie.jpg
|link=EZ-LINK-TEST-SERIE
}}

{{ttuto-small
|label=Afficheur LCD USB
|descr=Afficheur LCD USB super simple d'emploi pour votre Pi.
|img=LCD-USB-TTL.jpg
|link=LCD-USB-TTL-Raspberry
}}

{{ttuto-small
|label=Contrôleur Moteur DRV8835
|descr=Contrôler facilement deux moteurs en Python avec cette carte Pi 2 et Pi B+.
|img=tlogo-RASP-DRV8835.jpg
|link=RASP-DRV8835
}}

{{ttuto-small
|label=HAT matrice RGB
|descr=Contrôlez une matrice RGB avec votre Pi
|img=tlogo-RASP-HAT-MATRIX-RGB.jpg
|link=RASP-HAT-MATRIX-RGB
}}

{{ttuto-small
|label=MCP9808 - Température
|descr=Senseur de température I2C de Précision pour Pi et BeagleBone en Python.
|img=Tlogo-senseur-MCP9808.jpg
|link=RASP-MCP9808
}}

{{ttuto-small
|label=Hat Sense et Astro-Pi
|descr=La carte Hat Sense est un véritable mini-labo. Voici comment l'utiliser
|img=tlogo-astro-pi.jpg
|link=RASP-SENSE-HAT-ASTRO-PI
}}

{{ttuto-small
|label=Fona et Pi
|descr=Utiliser la carte Fona avec Raspberry-Pi. <font color="red">Démonstration de faisabilité.</font>
|img=tlogo-fona-pi.jpg
|link=RASP-FONA-PI
}}

{{ttuto-small
|label=Module 3G (HSDPA) et Pi-3
|descr=Utiliser un module 3G pour obtenir une connexion internet (ou envoyer des SMS) avec son Pi 3.
|img=tlogo-pi-3G.jpg
|link=RASP-PI-3G
}}

{{ttuto-small
|label=Radio WiFi sur Pi
|descr=Du streaming audio partout dans la maison !
|img=tlogo-rdiowifi-pi.jpg
|link=RASP-RDIOWIFI-PI
}}

{{ttuto-small
|label=PyGameUI
|descr=Les bases pour réaliser une interface graphique avec PyGameUI (y compris Thread, callable, SIGINT signal handler)
|img=tlogo-pygame-gui.jpg
|link=RASP-PYGAME-GUI
}}

{{ttuto-small
|label=Plex Media Server
|descr=Utiliser un Raspberry-Pi 3 pour réaliser un Plex Media Server
|img=tlogo-plex-media-server.jpg
|link=RASP-PLEX-MEDIA-SERVER
}}

{{ttuto-small
|label=Breakout FT232H
|descr=Ajouter un bus SPI, I2C, UART et GPIO via USB sur votre ordinateur (Win,Mac,Linux)
|img=tlogo-ft232h.jpg
|link=RASP-FT232H
}}

{{ttuto-small
|label=PiOLED
|descr=Un petit écran OLED 128x32 I2C pour créer une mini interface utilisateur pour les Pi sans écran.
|img=tlogo-PiOled.png
|link=RASP-PiOLED
}}

{{ttuto-end}}

Autres tutoriels:
* [[RASP-GOF-GSM-GPRS|GSM/GPRS pour Raspberry]] - Utiliser un module GSM/GPRS avec votre Pi!

=== Tutoriels - HiFiBerry ===

{{ttuto-begin}}

{{ttuto-small
|label=HiFiBerry Présentation
|descr=Du son HiFi pour votre Pi. Présentation de la gamme HiFiBerry
|img=tlogo-HiFiBerry.jpg
|link=Rasp-HiFiBerry
}}

{{ttuto-small
|label=HiFiBerry Linux 3.18.x
|descr=Configurer Linux 3.18.x pour HiFiBerry
|img=tlogo-HiFiBerry-Linux-3.18.x.jpg
|link=Rasp-HiFiBerry-Linux-3-18-x
}}

{{ttuto-small
|label=Logiciels supportés
|descr=Logiciels supportés par HiFiBerry
|img=tlogo-HiFiBerry-Logiciels.jpg
|link=Rasp-HiFiBerry-Logiciels
}}

{{ttuto-small
|label=Installation Raspbian
|descr=Sous-tutoriel: Mise-à-jour du noyau Raspbien (et autres distributions) pour une utilisation avec HiFiBerry.
|img=tlogo-HiFiBerry-Upgrade-Kernel.jpg
|link=Rasp HiFiBerry-Upgrade-Kernel
}}

{{ttuto-small
|label=Installation OpenElec
|descr=Sous-tutoriel: Mise-à-jour OpenElec pour une utilisation avec HiFiBerry.
|img=tlogo-HiFiBerry-Activation-OpenElec.jpg
|link=Rasp-HiFiBerry-OpenElec
}}

{{ttuto-small
|label=Installation OpenElec 5
|descr=Sous-tutoriel: Mise-à-jour OpenElec 5 pour une utilisation avec HiFiBerry.
|img=tlogo-HiFiBerry-Activation-OpenElec5.jpg
|link=Rasp-HiFiBerry-OpenElec5
}}

{{ttuto-small
|label=Installation OSMC
|descr=Sous-tutoriel: Mise-à-jour OSMC pour une utilisation avec HiFiBerry.
|img=tlogo-HiFiBerry-Activation-OSMC.jpg
|link=Rasp-HiFiBerry-OSMC
}}

{{ttuto-small
|label=Player HiFi''-berry'' RuneAudio
|descr=Création d'un lecteur audio connecté avec Pi 3 et mettez en oeuvre le Raspberry Pi AudioPhile Kit.
|img=tlogo-Rasp-Hifi-Player.jpg
|link=Rasp-Hifi-Player
}}

{{ttuto-small
|label=Player HiFi''-berry'' Volumio
|descr=Création d'un lecteur audio connecté avec Pi 2/Pi 3 et une carte HiFiBerry. Un kit pour les AudioPhiles.
|img=tlogo-Rasp-volumio.jpg
|link=Rasp-Hifi-volumio
}}

{{ttuto-end}}

Note:
* [http://arduino103.blogspot.be/2015/08/voici-un-petit-article-qui-explique.html Tutoriel d'assemblage du boitier Métal pour HiFiBerry DAC+] ([http://blog.mchobby.be blog.mchobby.be])
* réaliser une puissante musique box à l'aide de HiFiBerry Amp+ et MusicPicker

== Ressources ==
=== AdaFruit Learning System ===
Adafruit propose de nombreux tutoriels relatifs a Raspberry PI mettant en oeuvre ses produits.<br />
MC Hobby est justement un distributeur AdaFruit, vous pourriez donc retrouver [http://www.mchobby.be ce/ces produits sur notre WebShop].<br />
Ces derniers sont malheureusement en anglais mais nous pouvons toujours en traduire l'un ou l'autre sur demande (''nous avons justement des accords de traduction avec adaFruit :-)))'').
* [http://learn.adafruit.com/category/raspberry-pi AdaFruit Learning System for Raspberry PI]
=== Générale ===
* [http://www.themagpi.com/ The MagPi magazine] (en anglais mais libre)
* [http://www.pobot.org/spip.php?page=recherche&recherche=raspberry Raspberry Pi sur PoBot.Org] (En Français, avec l'aimable autorisation de Julien h./PoBot.org)
* Utiliser le GPIO sans avoir besoin d'être sudo ou Root.<br />Des articles trouvés sur le Net:
** [http://dissectionbydavid.wordpress.com/2013/10/21/raspberry-pi-using-gpio-wiringpi-without-root-sudo-access/ Raspberry Pi – using GPIO / WiringPi without root (sudo) access] (''dissectionbydavid, anglais'')
** [http://www.raspberrypi.org/forums/viewtopic.php?f=32&t=32177 Tutorial: Elro remote power switch without root] (''RaspberryPi.org, anglais'')
{{MCH-Accord}}

RaspberryPi-Accueil

2025-08-12T13:18:34Z

AntoineWrt : /* Bienvenue */

{{device-links}}

== Bienvenue ==
{{bloc-etroit|text=
<div class="noprint" style="margin-bottom: 15px; padding: 5px 5px 5px 5px; border-radius: 10px 10px 10px 10px; border: 1px solid rgb(229,229,299);">
Bienvenue sur la page d'accueil [http://www.mchobby.be MicroControleur Hobby] alias MCHobby dédiée au {{link-product-pi5}}, {{link-product-pi4}}, {{link-product-pi3}}, {{link-product-pi2}} et {{link-product-piplus}}.<br />Vous pouvez bien entendu trouver ces produits sur le [http://shop.mchobby.be Shop de MCHobby]<br />
Vous y trouverez l'information et/ou traductions que nous avons accumulé à propos du Raspberry Pi.</div>
}}

== Découverte & système d'exploitation ==
{{ttuto-begin}}

{{ttuto
|label=Mise-à-jour EEPROM
|descr=Mise à jour de la Boot EEPROM du Pi 5 ET installation d'un disque NVMe
|img=tlogo-pi-boot-rom.jpg
|link=RASP-BOOT-ROM-UPGRADE
}}

{{ttuto
|label=Hat M.2
|descr=Installer le Hat M.2 sur un Raspberry-Pi 5
|img=tlogo-pi-hat-m2.jpg
|url=https://arduino103.blogspot.com/2024/05/hat-m2-officiel-pour-raspberry-pi.html
}}

{{ttuto
|label=Tour Pi 3
|descr=Venez découvrir les nouveautés du Raspberry Pi 3
|img=tlogo-rasp-pi-3.jpg
|link=RASP-PI3
}}

{{ttuto
|label=Pi Zero Tour
|descr=Venez découvrir le Pi Zero et ses possibilités. Un joujou incroyable pour les Makers et Hackers.
|img=tlogo-rasp-pi-zero.jpg
|link=RASP-PIZERO
}}

{{ttuto
|label=Pi Zero W Tour
|descr=Venez découvrir le Pi Zero W. Un joujou incroyable pour les Makers et Hackers.
|img=tlogo-rasp-pi-zero-w.jpg
|link=RASP-PIZERO-W
}}

{{ttuto
|label=Pi Zero Headless
|descr=Donner une étincelle de vie à votre Pi Zero, Pi Zero W avec le minimum d'effort et de matériel.
|img=tlogo-pi-headless.png
|link=Pi-Zero-Headless
}}

{{ttuto
|label=Whezzy Raspbian
|descr=Distribution de la fondation Raspberry Pi. Dérivé de Debian et utilise XCFE comme environnement graphique
|img=tlogo-rasp-Os-Wheezy.jpg
|link=Rasp-Os-Whezzy
}}

{{ttuto
|label=Moniteur DVI
|descr=Raccordez votre Raspberry sur moniteur.
|img=tlogo-dvi.jpg
|link=Rasp-Moniteur-DVI
}}

{{ttuto
|label=Périphériques USB et Pi
|descr=Les périphériques USB et le Raspberry Pi.
|img=tlogo-Rasp_USB.jpg
|link=Rasp-Usb-Warning
}}

{{ttuto
|label=Pi2: Boot et LEDs
|descr=<strong><font color="red">Help!!! Mon Pi ne démarre pas</font></strong>.
|img=tlogo-Rasp-Pi2-Boot-et-LED.jpg
|link=Rasp-Pi2-Boot-et-LED
}}

{{ttuto
|label=Kill or not kill the SD
|descr=Apprenez comment préserver la durée de vie de votre carte SD.
|img=tlogo-SD-Killer.jpg
|link=Rasp-SD-Preserver
}}

{{ttuto
|label=Démarrage automatique
|descr=Démarrer automatiquement un script Python sous Raspbian.
|img=tlogo-autostart-script.jpg
|link=Rasp-AutoStart-Script
}}

{{ttuto
|label=Pi Desktop
|descr=Un boîtier type NUC et disque SSD pour Raspberry-Pi 3. Transformer le Pi en nano ordinateur de bureau.
|img=tlogo-pi-desktop.jpg
|link=Pi-Desktop-Assemblage
}}

{{ttuto
|label=Ressources
|descr=Quelques liens utiles pour exploiter votre Pi.
|img=tlogo-pi-ressources.jpg
|link=Pi-Ressources
}}

{{ttuto
|label=Objectifs HQ-CAM
|descr=Quels objectif choisir pour sa HQCam
|img=tlogo-pi-hqcam.jpg
|link=Pi-HQ-CAM-LENS
}}

{{ttuto
|label=SuperPI
|descr=Créer un SuperCalculateur à base de Raspberry-Pi
|img=tlogo-superpi.jpg
|traduction=1
|link=SuperPi-Accueil
}}

{{ttuto-end}}

== Tutoriels ==
=== Prise en main ===
{{Ambox
| type = delete
| image = [[File:StopHand.png|40px|alt=Stop]]
| textstyle = color: red; font-weight: bold; font-style: italic;
| text = Nous n'insisterons jamais assez sur le fait qu'une fois connecté sur un réseau, votre Raspberry peut facilement devenir un serveur pirate si vous ne modifiez pas le mot de passe administrateur.<br />Changer le mode de passe de l'administrateur "pi" avec la commande '''passwd'''... c'est capital pour la sécurité de votre réseau !
}}

{{ttuto-begin}}

{{ttuto
|label=Agrandir la partition
|descr=Agrandissez la partition principale de Wheezy Raspbian et Occidentalis
|img=tlogo-rasp-partition.jpg
|link=PI-Etendre-Partition
}}

{{ttuto
|label=Clavier Belge
|descr=Comment configurer un clavier Belge sur Pi.
|img=tlogo-Rasp-ClavierBe.jpg
|link=Rasp-Clavier-BE
}}

{{ttuto
|label=Config Réseau & WiFi
|descr=Comment se connecter sur Internet via WiFi ou réseau Ethernet, via interface graphique ou en ligne de commande
|img=tlogo-Rasp-Network.jpg
|link=Rasp-Config-Reseau
}}

{{ttuto
|label=Changer Hostname
|descr=Modifier le nom réseau de votre Raspberry-Pi pour qu'elle s'annonce avec un nom différent sur le réseau.
|img=tlogo-Rasp-Hostname.jpg
|link=Rasp-Config-Hostname
}}

{{ttuto
|label=apt.adafruit.com
|descr=Ajoutez le dépôt Adafruit et facilitez l'installation de vos logiciels.
|img=tlogo-apt-adafruit-com.jpg
|link=Rasp-APT-ADAFRUIT-COM
}}

{{ttuto
|label=Overclocking
|descr=Augmentez la vitesse de votre PI (Whezzy Raspian) en utilisant une méthode d'Overclocking.
|img=tlogo-rasp-overclocking.jpg
|link=PI-Overclocking
}}

{{ttuto
|label=SSH
|descr=Commander son PI en SSH... ou comment profiter du confort de son PC tout en prenant les rênes de son PI à distance :-).
|img=tlogo-rasp-ssh.jpg
|link=PI-SSH
}}

{{ttuto
|label=Pi-Copier/Pi-Coller
|descr=Copier/Coller super facile pour copier du code python vers un Raspberry super facilement.
|img=tlogo-rasp-easycopypaste.jpg
|link=PI-Easy-Copy-Paste
}}

{{ttuto
|label=Préparer Python
|descr=Préparation de Python pour faire de hacking électronique.
|img=tlogo-rasp-python-update.jpg
|link=Pi-Python-Prepa
}}

{{ttuto
|label=Debuggeur Python
|descr=<strong>PuDB</strong> est un déboggeur Python qui fonctionne en SSH!.
|img=tlogo-rasp-python-pudb.jpg
|link=Pi-Python-PuDB
}}

{{ttuto
|label=Utiliser VNC
|descr=Comment prendre le contrôle à distance de votre Pi grâce à VNC. Très utile pour faire des capture d'écran.
|img=tlogo-Pi-Vnc.jpg
|link=Pi-VNC
}}

{{ttuto
|label=webIDE
|descr=webIde permet de coder et exécuter des programmes depuis un navigateur Web (supporte Python, Ruby, JavaScript, ...).
|img=tlogo-WebIde.jpg
|link=Pi-WebIde
}}

{{ttuto
|label=WiringPi
|descr=Libraire d'accès GPIO en C, fort semblable à l'environnement Arduino, disposant de Wrapper en Python, Ruby, Java, ... et son célèbre utilitaire '''gpio'''
|img=tlogo-WiringPi.jpg
|link=Pi-WiringPi
}}

{{ttuto
|label=USB Audio
|descr=Module Audio USB pour Raspberry Pi
|img=tlogo-USB-Audio.jpg
|link=Pi-USB-Audio
}}

{{ttuto
|label=MP3 sur Pi
|descr=Utiliser mpg321 pour jouer des fichiers MP3 (sur notre blog)
|img=tlogo-Audio-MP3.jpg
|link=PI-Audio-MP3
}}

{{ttuto
|label=PiFace
|descr=Interface entrée/sortie pour Raspberry Pi destiné aux débutants et écoles. <b>Inclus contrôle avec Scratch.</b>
|img=tlogo-piface.jpg
|link=PiFace-Manuel
}}

{{ttuto
|label=PiFace 2
|descr=Interface entrée/sortie pour Raspberry Pi 2/3 destiné aux débutants et écoles.
|img=tlogo-piface2.jpg
|link=PiFace2-Manuel
}}

{{ttuto
|label=UniPi
|descr=Carte d'extension pour réaliser un automate programmage à partir d'un Raspberry-Pi.
|img=tlogo-unipi.jpg
|link=UniPi-Manuel
}}

{{ttuto
|label=PiBrella
|descr=Carte d'interface super simple pour Raspberry
|img=tlogo-Pibrella.jpg
|link=PiBrella
}}

{{ttuto
|label=RTC PCF8523
|descr=Une horloge temps réel pour Raspberry-Pi
|img=tlogo-PCF8523.jpg
|link=RASP-PCF8523
}}

{{ttuto
|label=PI Remote Screen
|descr=Le Pi 3 autonome avec une tablette comme terminal
|img=tlogo-pi-remote-screen.png
|link=RASP-PI-REMOTE-SCREEN
}}

{{ttuto
|label=HAT TV
|descr=Configurer et utiliser le HAT TV
|img=tlogo-hat-tv.jpg
|link=RASP-HAT-TV
}}

{{ttuto-end}}

=== Projets ===

{{ttuto-begin}}

{{ttuto
|label=Projet DOMO
|descr=Domotiser sa maison avec OpenRemote + Raspberry + Arduino. Un magnifique tutoriel de D. Swinnen
|img=tlogo-projet-domo.jpg
|link=PROJET-DOMO
}}

{{ttuto-small
|label=Retro-gaming avec PI
|descr=Simuler une frappe clavier depuis le GPIO = Un vrai Retro-Gaming
|img=tlogo-Retro-Games.jpg
|link=Rasp-Retro-Games
}}

{{ttuto-small
|label=PiGRRL 2
|descr=Réaliser un émulateur de jeu portable avec un Pi 2 ou Pi 3, un PiTFT et un amplificateur audio.
|img=tlogo-pigrrl-2.png
|link=Rasp-PiGRRL-2
}}

{{ttuto-small
|label=Node-Red
|descr=Utiliser Node-Red sur Raspberry-Pi. Gérer facilement vos flux, événements et actions avec un éditeur visuel.
|img=tlogo-rasp-node-red.jpg
|link=Rasp-Node-Red
}}

{{ttuto-small
|label=RPi UMPC
|descr=Réaliser et imprimer un UMPC Raspberry-Pi en imprimant les différents éléments.
|img=tlogo-RPi-UMPC.jpg
|link=Rasp-UMPC
}}

{{ttuto-end}}

=== Programmation ===

Un Raspberry peut se programmer avec de nombreux langages. Parmi la foule de langage, nous pouvons relever Python bien adapté à la découverte de la programmation, Scratch qui est un environnement graphique très attrayant et le langage C plutôt destiné au développeurs expérimentés.

Voici quelques références utilisées par MCHobby, elles vous aiderons à apprendre Python. Nul doute que vous en trouverez de nombreuses autres sur le Net... mais cette sélection est de qualité.

{{ttuto-begin}}

{{ttuto
|label=Progr. en Python
|descr=Apprendre a programmer en Python (en-ligne). Par Vincent le Goff.
|img=tlogo-rasp-Python-Programmer-LeGoff.jpg
|link=PI-Python-Apprendre-en-Python
}}

{{ttuto
|label=Progr. Python
|descr=Programmation Python - Conception et optimisation de Tarek Ziadé.
|img=tlogo-rasp-Python-Programmer-Ziade.jpg
|link=PI-Python-Programmation-Python
}}

{{ttuto
|label=Apprendre Python
|descr=Apprendre a programmer Python et Python 3 (PDF, Gratuit) via un parcours académique. Par Gérard Swinnen.
|img=tlogo-rasp-Python-Programmer.jpg
|link=PI-Python-Apprendre-Python
}}

{{ttuto
|label=UTF8, Unicode et encoding
|descr=UnicodeDecodeError peut être votre pire cauchemar. Comprenez le afin qu'il ne soit plus un problème.
|img=tlogo-Python-Encoding.jpg
|link=PI-Python-Encoding
}}

{{ttuto
|label=Python et Tkinter
|descr=Des interfaces graphiques en Python avec Tkinter
|img=tlogo-Python-tkinter-programming.jpg
|link=PI-Python-TkInter-Programming
}}

{{ttuto
|label=Pygubu
|descr=Form Designer pour Tkinter. Liens vers vidéos d'apprentissage
|img=tlogo-Python-pygugu.jpg
|url=https://arduino103.blogspot.com/2023/09/pygubu-form-designer-pour-python.html
}}

{{ttuto
|label=Python Turtle
|descr=Apprendre Python avec Turtle en faisant du '''Logo en Python'''.
|img=tlogo-Python-turtle.jpg
|link=Python-Turtle-Online
}}

{{ttuto-end}}

Quelques références:
* [http://fr.wikipedia.org/wiki/Python_%28langage%29 Le langage Python] sur Wikipedia.fr.
* L'[http://www.afpy.org/ Association Francophone Python] (AFPY)
* [http://fr.openclassrooms.com/informatique/cours/apprenez-a-programmer-en-python Apprenez à programmer en Python] par Prolixe, sur fr.openclassrooms.com.
* Les [http://docs.python.org/2/ pages de documentation sur Python 2.7] (''Anglais'', Pyhton.org).
* La section [http://python.developpez.com/ Python sur Developpez.com]
* [http://effbot.org/imagingbook/imagedraw.htm PIL - Python Image Library] - les commandes de dessins (''effbot.org'', anglais)

=== Tutoriels - Hacking électronique ===
Pour tous ces tutoriels, assurez vous d'avoir accomplit la section"préparation Python" ci-avant.

{{ttuto-begin}}

{{ttuto-small
|label=Raspberry GPIO
|descr=Le GPIO du Raspberry B ou '''Pi 3''', Pi 2, Pi B+, Pi Zero, '''Pi Zero W''' en détail avec utilisation GPIO, I2C, etc
|img=tlogo-Rasp-Hack-GPIO40.jpg
|link=Rasp-Hack-GPIO
}}

{{ttuto-small
|label=Pi Cobbler
|descr=Raccordez un PI sur une plaque de prototypage
|img=RASP-ADFCOBBLER (mini).jpg
|link=PI-Cobbler
}}

{{ttuto-small
|label=Pi LEDs
|descr=Commander des LEDs avec votre PI
|img=Rasp-Hack-LED (mini).jpg
|link=Rasp-Hack-LED
}}

{{ttuto-small
|label=Pi GMail LED
|descr=Vérifier les e-mails en attente sur GMail et allumer une LED
|img=Rasp-Hack-GMAIL-LED (mini).jpg
|link=Rasp-Hack-GMAIL-LED
}}

{{ttuto-small
|label=Pi Button
|descr=Détecter l'état d'un bouton avec PI et allumer une LED.
|img=Rasp-Hack-PiButton (mini).jpg
|link=Rasp-Hack-PiButton
}}

{{ttuto-small
|label=Senseur PIR
|descr=Détecteur de proximité de type PIR (alarme)
|img=Rasp-Hack-PiPir (mini).jpg
|link=Rasp-Hack-PiPir
}}

{{ttuto-small
|label=Lecture Analogique MCP3008
|descr=Réaliser une lecture analogique à l'aide d'un MCP3008.
|img=Rasp-Hack-PiAnalog (mini).jpg
|link=Rasp-Hack-PiAnalog
}}

{{ttuto-small
|label=MCP23017 pour ajouter des I/O
|descr=Ajouter des entrées/sorties avec un MCP23017.
|img=Rasp-Hack-MCP23017.jpg
|link=Rasp-Hack-MCP230XX
}}

{{ttuto-small
|label=Senseur à Effet Hall
|descr=Utiliser un senseur digital US5851LUA (populaire chez Arduino).
|img=Rasp-Hack-Hall (mini).jpg
|link=Rasp-Hack-Hall
}}

{{ttuto-small
|label=DHT11, DHT22
|descr=Utiliser le senseur d'humidité DHT11, DHT22 ou AM2302 sur votre Pi.
|img=Rasp-Hack-DHT22.jpg
|link=Rasp-Hack-DHT22
}}

{{ttuto-small
|label=Câble Console
|descr=Câble Console USB-Série TTL, connectez vous à votre PI sans souris, clavier et écran.
|img=Rasp-Hack-USB-Serie-TTL (mini).jpg
|link=Rasp-Hack-USB-Serie-TTL
}}

{{ttuto-small
|label=Serveur HDMI
|descr=Transformer un Raspberry Pi en serveur d'affichage HDMI pour Arduino... un '''HDMI Shield''' abordable
|img=Rasp-Hack-HDMI-Serveur (mini).jpg
|link=Rasp-Hack-HDMI-Serveur
}}

{{ttuto-small
|label=Afficheur LCD
|descr=Afficher des informations sur votre PI avec LCD Monochrome, RGB et GPIO Extender + LCD
|img=Rasp-Hack-Afficheur-LCD (mini).jpg
|link=Rasp-Hack-Afficheur-LCD
}}

{{ttuto-small
|label=Contrôleur Led
|descr=contrôler une matrice LED ou un afficheur 7 segments d'AdaFruit avec votre PI.
|img=Rasp-Hack-Led-Backpack (mini).jpg
|link=Rasp-Hack-Led-Backpack
}}

{{ttuto-small
|label=Pont-H L293
|descr=Contrôler des moteurs a courant continu (sens et vitesse) avec un Pont-H, PWM et votre PI.
|img=Rasp-Hack-L293 (mini).jpg
|link=Rasp-Hack-L293
}}

{{ttuto-small
|label=Moteur Pas-à-Pas
|descr=Contrôler un moteur pas-à-pas avec votre Pi à l'aide des circuit-intégrés L293D ou ULN2803.
|img=Rasp-Hack-Stepper (mini).jpg
|link=Rasp-Hack-Stepper
}}

{{ttuto-small
|label=Hat Moteur
|descr=Contrôler des moteurs continus ou moteurs pas-à-pas avec votre Raspberry-Pi et la Hat Moteur / Motor Hat.
|img=Rasp-Hat-Moteur.jpg
|link=Rasp-Hat-Moteur
}}

{{ttuto-small
|label=ArduPi-I2C
|descr=<strong>Raspberry-Pi et Arduino qui communiquent via le bus I2C</strong>... de la dynamite!
|img=tlogo-ArduPi-I2C.jpg
|link=ArduPi-I2C
}}

{{ttuto-small
|label=Pi-Shield LCD 2x16 RGB + Keypad
|descr=Afficheur 2x16 caractères, rétro-éclairage RGB + Keypad sous forme de <strong>Pi-shield pour Raspberry</strong> via le bus I2C!
|img=RASP-LCD-RGB.jpg
|link=RASP-LCD-RGB
}}

{{ttuto-small
|label=GPS pour Raspberry
|descr=Utiliser le câble console (ou l'UART) et le GPS ultime pour traquer votre Pi!
|img=tlogo-RASP-GPS-ULTIME.jpg
|link=RASP-GPS-ULTIME
}}

{{ttuto-small
|label=Pi TFT
|descr=Un TFT 320x240 2.8 pouce + écran tactile pour Raspberry Pi!
|img=tlogo-PiTFT.jpg
|link=RASP-PiTFT
}}

{{ttuto-small
|label=Pi TFT PLUS
|descr=Un TFT 480x320 3.5 pouce + écran tactile pour Raspberry Pi 2, A+, B+!
|img=tlogo-PiTFT-Plus.jpg
|link=RASP-PiTFT-PLUS
}}

{{ttuto-small
|label=RPi ShieldBridge
|descr=Un Arduino sur un Pi... le meilleur des deux mondes!
|img=tlogo-RPi-ShieldBridge.jpg
|link=RPI-ShieldBridge
}}

{{ttuto-small
|label=Mesurer la Pression
|descr=Mesurer la pression avec un BMP0180 ou BMP085 via le bus I2C.
|img=tlogo-Rasp-Hack-BMP085.jpg
|link=Rasp-Hack-BMP085
}}

{{ttuto-small
|label=Pont-H L298 avec Pi
|descr=Piloter des moteurs puissants avec un Raspberry-Pi et un Breakout L298.
|img=tlogo-l298.jpg
|link=Rasp-Hack-L298
}}

{{ttuto-small
|label=EZ-Link - Appairage avec Android
|descr=EZ-Link établit une connexion série(SPP) via Bluetooth vers l'hôte. Tuto de liaison PC/Raspberry <-> Android.
|img=tlogo-EZLink-Test-Serie.jpg
|link=EZ-LINK-TEST-SERIE
}}

{{ttuto-small
|label=Afficheur LCD USB
|descr=Afficheur LCD USB super simple d'emploi pour votre Pi.
|img=LCD-USB-TTL.jpg
|link=LCD-USB-TTL-Raspberry
}}

{{ttuto-small
|label=Contrôleur Moteur DRV8835
|descr=Contrôler facilement deux moteurs en Python avec cette carte Pi 2 et Pi B+.
|img=tlogo-RASP-DRV8835.jpg
|link=RASP-DRV8835
}}

{{ttuto-small
|label=HAT matrice RGB
|descr=Contrôlez une matrice RGB avec votre Pi
|img=tlogo-RASP-HAT-MATRIX-RGB.jpg
|link=RASP-HAT-MATRIX-RGB
}}

{{ttuto-small
|label=MCP9808 - Température
|descr=Senseur de température I2C de Précision pour Pi et BeagleBone en Python.
|img=Tlogo-senseur-MCP9808.jpg
|link=RASP-MCP9808
}}

{{ttuto-small
|label=Hat Sense et Astro-Pi
|descr=La carte Hat Sense est un véritable mini-labo. Voici comment l'utiliser
|img=tlogo-astro-pi.jpg
|link=RASP-SENSE-HAT-ASTRO-PI
}}

{{ttuto-small
|label=Fona et Pi
|descr=Utiliser la carte Fona avec Raspberry-Pi. <font color="red">Démonstration de faisabilité.</font>
|img=tlogo-fona-pi.jpg
|link=RASP-FONA-PI
}}

{{ttuto-small
|label=Module 3G (HSDPA) et Pi-3
|descr=Utiliser un module 3G pour obtenir une connexion internet (ou envoyer des SMS) avec son Pi 3.
|img=tlogo-pi-3G.jpg
|link=RASP-PI-3G
}}

{{ttuto-small
|label=Radio WiFi sur Pi
|descr=Du streaming audio partout dans la maison !
|img=tlogo-rdiowifi-pi.jpg
|link=RASP-RDIOWIFI-PI
}}

{{ttuto-small
|label=PyGameUI
|descr=Les bases pour réaliser une interface graphique avec PyGameUI (y compris Thread, callable, SIGINT signal handler)
|img=tlogo-pygame-gui.jpg
|link=RASP-PYGAME-GUI
}}

{{ttuto-small
|label=Plex Media Server
|descr=Utiliser un Raspberry-Pi 3 pour réaliser un Plex Media Server
|img=tlogo-plex-media-server.jpg
|link=RASP-PLEX-MEDIA-SERVER
}}

{{ttuto-small
|label=Breakout FT232H
|descr=Ajouter un bus SPI, I2C, UART et GPIO via USB sur votre ordinateur (Win,Mac,Linux)
|img=tlogo-ft232h.jpg
|link=RASP-FT232H
}}

{{ttuto-small
|label=PiOLED
|descr=Un petit écran OLED 128x32 I2C pour créer une mini interface utilisateur pour les Pi sans écran.
|img=tlogo-PiOled.png
|link=RASP-PiOLED
}}

{{ttuto-end}}

Autres tutoriels:
* [[RASP-GOF-GSM-GPRS|GSM/GPRS pour Raspberry]] - Utiliser un module GSM/GPRS avec votre Pi!

=== Tutoriels - HiFiBerry ===

{{ttuto-begin}}

{{ttuto-small
|label=HiFiBerry Présentation
|descr=Du son HiFi pour votre Pi. Présentation de la gamme HiFiBerry
|img=tlogo-HiFiBerry.jpg
|link=Rasp-HiFiBerry
}}

{{ttuto-small
|label=HiFiBerry Linux 3.18.x
|descr=Configurer Linux 3.18.x pour HiFiBerry
|img=tlogo-HiFiBerry-Linux-3.18.x.jpg
|link=Rasp-HiFiBerry-Linux-3-18-x
}}

{{ttuto-small
|label=Logiciels supportés
|descr=Logiciels supportés par HiFiBerry
|img=tlogo-HiFiBerry-Logiciels.jpg
|link=Rasp-HiFiBerry-Logiciels
}}

{{ttuto-small
|label=Installation Raspbian
|descr=Sous-tutoriel: Mise-à-jour du noyau Raspbien (et autres distributions) pour une utilisation avec HiFiBerry.
|img=tlogo-HiFiBerry-Upgrade-Kernel.jpg
|link=Rasp HiFiBerry-Upgrade-Kernel
}}

{{ttuto-small
|label=Installation OpenElec
|descr=Sous-tutoriel: Mise-à-jour OpenElec pour une utilisation avec HiFiBerry.
|img=tlogo-HiFiBerry-Activation-OpenElec.jpg
|link=Rasp-HiFiBerry-OpenElec
}}

{{ttuto-small
|label=Installation OpenElec 5
|descr=Sous-tutoriel: Mise-à-jour OpenElec 5 pour une utilisation avec HiFiBerry.
|img=tlogo-HiFiBerry-Activation-OpenElec5.jpg
|link=Rasp-HiFiBerry-OpenElec5
}}

{{ttuto-small
|label=Installation OSMC
|descr=Sous-tutoriel: Mise-à-jour OSMC pour une utilisation avec HiFiBerry.
|img=tlogo-HiFiBerry-Activation-OSMC.jpg
|link=Rasp-HiFiBerry-OSMC
}}

{{ttuto-small
|label=Player HiFi''-berry'' RuneAudio
|descr=Création d'un lecteur audio connecté avec Pi 3 et mettez en oeuvre le Raspberry Pi AudioPhile Kit.
|img=tlogo-Rasp-Hifi-Player.jpg
|link=Rasp-Hifi-Player
}}

{{ttuto-small
|label=Player HiFi''-berry'' Volumio
|descr=Création d'un lecteur audio connecté avec Pi 2/Pi 3 et une carte HiFiBerry. Un kit pour les AudioPhiles.
|img=tlogo-Rasp-volumio.jpg
|link=Rasp-Hifi-volumio
}}

{{ttuto-end}}

Note:
* [http://arduino103.blogspot.be/2015/08/voici-un-petit-article-qui-explique.html Tutoriel d'assemblage du boitier Métal pour HiFiBerry DAC+] ([http://blog.mchobby.be blog.mchobby.be])
* réaliser une puissante musique box à l'aide de HiFiBerry Amp+ et MusicPicker

== Ressources ==
=== AdaFruit Learning System ===
Adafruit propose de nombreux tutoriels relatifs a Raspberry PI mettant en oeuvre ses produits.<br />
MC Hobby est justement un distributeur AdaFruit, vous pourriez donc retrouver [http://www.mchobby.be ce/ces produits sur notre WebShop].<br />
Ces derniers sont malheureusement en anglais mais nous pouvons toujours en traduire l'un ou l'autre sur demande (''nous avons justement des accords de traduction avec adaFruit :-)))'').
* [http://learn.adafruit.com/category/raspberry-pi AdaFruit Learning System for Raspberry PI]
=== Générale ===
* [http://www.themagpi.com/ The MagPi magazine] (en anglais mais libre)
* [http://www.pobot.org/spip.php?page=recherche&recherche=raspberry Raspberry Pi sur PoBot.Org] (En Français, avec l'aimable autorisation de Julien h./PoBot.org)
* Utiliser le GPIO sans avoir besoin d'être sudo ou Root.<br />Des articles trouvés sur le Net:
** [http://dissectionbydavid.wordpress.com/2013/10/21/raspberry-pi-using-gpio-wiringpi-without-root-sudo-access/ Raspberry Pi – using GPIO / WiringPi without root (sudo) access] (''dissectionbydavid, anglais'')
** [http://www.raspberrypi.org/forums/viewtopic.php?f=32&t=32177 Tutorial: Elro remote power switch without root] (''RaspberryPi.org, anglais'')
{{MCH-Accord}}

Modèle:MCH-Aider

2017-12-04T19:36:48Z

AntoineWrt :

<br /><div class="{{#if:{{{force_print|}}}|alwaysprint|noprint}}" style="border:1px solid #43b086; background:#eff;padding:2px 10px 2px 8px; margin-bottom:10px; color:green;">MCHobby investit du temps et de l'argent dans la réalisation de traduction et/ou documentation. C'est un travail long et fastidieux réalisé dans l'esprit Open-Source... donc gratuit et librement accessible.<br />
'''SI vous aimez nos traductions et documentations ALORS aidez nous à en produire plus en achetant vos produits chez [https://shop.mchobby.be MCHobby].'''</div>

Modèle:Cl

2017-12-04T19:28:22Z

AntoineWrt :

[https://shop.mchobby.be/category.php?id_category={{{1}}} {{{2}}}]

Modèle:Pl

2017-12-04T19:28:08Z

AntoineWrt :

[https://shop.mchobby.be/product.php?id_product={{{1}}} {{{2}}}]

RASP-PIZERO-W

2017-12-04T19:24:32Z

AntoineWrt :

{{RASP-PIZERO-W-NAV}}
{{RASP-PIZERO-W-RES}}
{{RASP-PIZERO-W-PL}}

== Introduction ==
Passons un peu de temps à décortiquer le Pi-Zero W avec, je l'espère, quelques apports supplémentaires.

Ce tuto s'oriente clairement vers les Makers avec des MODs, Hack et documentations des "Testings Points" que vous pouvons parfois réutiliser à notre avantage. [[RASP-PIZERO|Pour des infos plus générales, trucs & astuces, vous pencher sur la création de la carte OS, etc nous vous proposons le tutoriel Pi Zero]].

== Tour du Pi Zero W ==
[[Fichier:RASP-PIZERO-W.jpg|773px]]

Le Pi Zero W, c'est un SoC (System on Chip, système sur une puce) BCM2835 déjà utilisé dans les premiers modèles de Raspberry-Pi. Ce SoC est cadencé à 1 Ghz (max) et dispose d'une RAM de 512 Mb. C'est déjà pas si mal pour une carte qui fait seulement 6.5 x 3.0 cm sans compter qu'elle embarque:
* Connexion HDMI (micro HDMI pour l'affichage).
* Connexion USB (micro USB mais permet d'y connecter des périphériques)
* Connexion DSI pour la caméra Pi (avec {{pl|899|un câble adapté}})
* Connexion RCA (même si c'est un peu dépassé) et Reset (plus utile).
* Une antenne WiFi
* Le célèbre GPIO Raspberry-Pi ... et ça c'est vraiment top.

Deux choses ont attirés notre attention:
* L'antenne du Pi Zero W
* L'emplacement pour connecteur µFl

== Antenne du PiZero W ==
Cette antenne est fort différente de l'antenne céramique du Pi 3.

Sur le Pi Zero W, elle présente une conception franchement innovante.

[[Fichier:RASP-PIZERO-W-Antenne-onboard.jpg]]

Cette nouvelle antenne (sous licence) est le résultat du travail de la [http://www.proant.se/|société Suédoise Proant AB], un spécialise des antennes.

Cette forme triangulaire est en fait un "trou" traversant les 6 couches cuivrées de la carte Pi Zero W. Cette structure entourée de ''via'' (connexions traversantes au travers des 6 couches de la carte) fait un peu l'effet d'une chambre d'écho pour les signaux WiFi.

La chambre couplée à de petites capacités permet de réaliser une antenne très performante.

{{ambox|text=De façon surprenante, cette mini-antenne serait plus performante que l'antenne céramique du Pi 3. En tout cas, c'est ce qu'affirme la fondation.}}

== L'emplacement pour connecter µFl ==
L'un des premiers éléments ayant attiré notre attention est un emplacement destiné à recevoir un connecteur µFl (micro Fl).

Si vous avez un l'âme d'un bricoleur, il y a une modification intéressante [http://www.briandorey.com/post/Raspberry-Pi-Zero-W-external-antenna-mod documentée par Brian Dorey] permettant de remplacer l'antenne par défaut.

[[Fichier:RASP-PIZERO-W-Antenne-UFl.png|640px]]<small><br />Ajouter un connecteur µFL (aussi dit U.FL ou uFL) sur un PiZero W<br />
Source: [http://www.briandorey.com/post/Raspberry-Pi-Zero-W-external-antenna-mod blog de Brian Dorey]</small>

L'utilisation du connecteur uFL permet de brancher une antenne WiFi extérieure. Sachez néanmoins que cette modification invalide la certification FCC.

[[Fichier:RASP-PIZERO-W-Antenne-ufl-exemple.png|640px]]<small><br />Source: [http://www.briandorey.com/post/Raspberry-Pi-Zero-W-external-antenna-mod blog de Brian Dorey]</small>

== UART Logiciel ==
Le GPIO propose des broches UARTs (voir ci-dessous). Attention cependant, comme tous les modèles WiFi du Raspberry-Pi, ce port série '''n'est plus un UART matériel''' mais un '''UART logiciel'''.

{{ADFImage|RASP-PIZERO-Console-2.png|260px}}<small><br /><font color="red>'''Ne pas brancher le +5V si le Pi-Zero est alimenté via microUSB.'''</font></small>

En effet, l'UART matériel est utilisé par la carte Pi 3 (et Pi Zero) pour le support du module Bluetooth.

L'utilisation de l'UART logiciel sur le Pi 3 ou Pi Zero W nécessite une modification de la configuration (voyez la section "[[Rasp-Hack-USB-Serie-TTL-WiFi-Modele|Pi Modèle WiFi et UART]]" de notre tutoriel consacré au câble console USB-Série)

== Mystérieux connecteur J5 ==
Un autre connecteur ayant retenu notre attention depuis un moment (également disponible sur le Pi 3 et Pi 2) est le connecteur J5.

Ce connecteur est visible sous la carte micro SD (sur un Pi Zero W).

[[Fichier:RASP-PIZERO-W-J5-01.jpg|150px]]

Je pensais, par erreur, qu'il s'agissait d'une future extension pour le Pi mais quelques recherchent tentent à laisser penser qu'il s'agit d'un connecteur "type" JTAG (pour programmer le BCM). Ce connecteur était semble t'il partiellement annoté sur un Pi B+.

[[Fichier:RASP-PIZERO-W-J5-02.png]]<small><br />Source: [http://www.sheffieldhardwarehackers.org.uk/wordpress/2015/12/the-hunt-for-j5/ The Hunt for J5]</small>

Voyez l'article "[http://www.sheffieldhardwarehackers.org.uk/wordpress/2015/12/the-hunt-for-j5/ The Hunt for J5]" de Andy Kirby pour plus d'information.

{{PI-ZERO-W-TRAILER}}

Fichier:Rasp-Node-Red-picam-mail-46.png

2017-05-08T14:07:25Z

AntoineWrt :

Rasp-Node-Red-picam-mail

2017-05-08T14:04:21Z

AntoineWrt : /* PiCamRED - Envoi périodique de photos par email avec PiCam et NodeRED */

{{Rasp-Node-Red-NAV}}

{{traduction}}

== PiCamRED - Envoi périodique de photos par email avec PiCam et NodeRED ==

[[fichier:Rasp-Node-Red-picam-mail-01.png|900px]]

{{ambox|text="Les blocs (noeuds) sont liés entre-eux en cliquant et en maintenant le clic du point du bloc précédent (en réalité ils sont carrés ;) ) et en glissant sur le point du bloc suivant que l'on souhaite relier/connecter. Seules des entrées et des sorties peuvent être reliées, NodeRED refusera des liaisons incompatibles du type "entrée sur entrée ou sortie sur sortie."}}

=== Description du projet ===

Dans ce tutoriel, nous allons réaliser des photos à l'aide de la caméra du RaspBerry Pi 2/3 et envoyer ces clichés par email de manière périodique grâce à NodeRED.
Nous allons donc utiliser plusieurs blocs et décrire de manière détaillée le déroulement de chaque étape de la réalisation de ce projet.

Dans NodeRED, il est important de bien identifier la finalité de notre projet afin de connaître au préalable tous les éléments qu'il faudra créer et fournir à l'action finale (celle qui enverra un email).

=== Quels sont les besoins du noeud email ===

==== Composants nécessaires pour constituer un email ====

Un email est composé des éléments suivants:

* Un expéditeur
* Un destinataire
* Un sujet
* Le corps du message

Tous ces éléments vont donc devoir être préparés afin de pouvoir construire le message à envoyer par le noeud final.

Le noeud final aura aussi besoin d'un serveur SMTP (serveur d'envoi d'emails) et éventuellement de paramètres d'identification pour ce serveur d'envoi d'emails.

==== Détail des besoins du noeud email ====

La liste des éléments nécessaires s'affiche lorsque le bloc est dans la zone de travail (Schema).
Commençons donc par sélectionner le bloc email, et de le glisser dans la zone de travail.

Commençons par cliquer sur le bloc email et nous maintenons le clic pour le glisser à droite dans l'espace de travail.

(on choisit celui qui a son point de liaison à gauche, car nous voulons un bloc de sortie)

[[fichier:Rasp-Node-Red-picam-mail-36.png]]

Glissons le dans l'espace de travail, et cliquons un clic simple pour le sélectionner.

[[fichier:Rasp-Node-Red-picam-mail-37.png]]

Ensuite, dans la colonne à droite de cet espace de travail, nous cliquons sur info et nous pourrons découvrir les éléments nécessaires à la constitution d'un bloc email.

[[fichier:Rasp-Node-Red-picam-mail-38.png]]

===== Nous utiliserons les champs suivants =====

* '''msg.payload''' --> Ce champ contient le corps de l'email
* '''msg.topic''' --> Ce champ contient le sujet de l'email
* '''msg.from''' --> Ce champ contient l'email de l'expéditeur
* '''msg.to''' --> Ce champ contient l'email du destinataire

Les autres champs ne seront pas utilisés dans notre cas, mais vous pourrez constater que le bloc email est complet de part ses fonctionnalités et possibilités.

Les données de serveur et d'identification seront abordées en fin de tuto lors de la configuration finale du bloc.

Nous allons maintenant passer à la réalisation du flux en commençant par le début de celui-ci.

=== Création d'une action périodique ===

Dans la colonne de gauche de NodeRED, se trouvent une liste de blocs à utiliser pour réaliser vos projets. Ils sont classés par "types".

Ainsi nous retrouvons les "types" suivants:

* '''Input''' qui contient tous les blocs d'entrées
* '''Ouput''' qui contient tous les blocs de sortie
* '''Function''' qui contient des blocs de fonctions javascript etc...
* '''Social''' qui sont des blocs d'entrée ou sorties depuis ou vers les réseaux sociaux
* '''Storage''' qui sont des fonctions de lecture ou d'écriture de fichiers
* '''Analysis''' ->> Sentiment interprète du texte et détermine un score sur base d'un dictionnaire anglais, renvoie le texte avec ce score de -5 à +5, déterminant ainsi l'émotion susceptible d'être procuré par ce texte
* '''Advanced''' possède des outils permettant de détecter des changements dans des fichiers ou dossiers, de lire des flux RSS ou encore EXEC qui permet d'exécuter directement des commandes sous linux !
* '''Raspberry Pi''' contient des outils pour piloter/lire le GPIO du raspberry Pi
* '''Network''' qui contient un outil réseau de Ping

Nous allons créer une action périodique, c'est à dire paramétrer un bloc '''"INJECT"''' de manière à déclencher régulièrement une chaine d'actions que nous allons accrocher à la suite les unes après les autres.
Nous allons donc cliquer sur le bloc '''"Inject"''' dans la liste "Input" et maintenir ce clic pour le déplacer vers la zone de travail.

[[fichier:Rasp-Node-Red-picam-mail-02.png]]

Nous obtiendrons donc une nouvelle instance "inject" qui portera le nom '''"Timestamp"''' (ce nom est attribué par défaut par NodeRED) comme dans la capture ci-dessous

[[fichier:Rasp-Node-Red-picam-mail-03.png]]

Nous allons maintenant double-cliquer sur celle-ci fin de l'éditer pour voir apparaitre le menu ci-dessous

[[fichier:Rasp-Node-Red-picam-mail-04.png]]

Il va falloir configurer ce bloc, mais avant tout voici une explication de celui-ci:

==== Payload ====

Le champs PayLoad est en fait le champ de données qui sera suivi d'un noeud à l'autre jusque à la fin de la chaine.
Dans ce module '''"inject"''', nous allons donc déterminer quel type de données contiendra le '''"PayLoad"''' jusqu'à la fin de la chaine que l'on va réaliser.

Dans notre cas, nous souhaitons construire un email, donc du contenu textuel, nous allons donc choisir '''"String"''' ce qui correspond à une chaine de caractères (du texte).

[[fichier:Rasp-Node-Red-picam-mail-05.png]]

==== Topic ====

Le champs "Topic" est un champs de texte dans lequel nous allons mettre un sujet succinct décrivant notre chaine.
Dans notre cas, ce sujet fera office de sujet au mail que nous expédierons.
Nous allons donc être précis en un minimum de mots pour que le destinataire de l'email puisse facilement deviner le contenu de celui-ci.

[[fichier:Rasp-Node-Red-picam-mail-06.png]]

==== Repeat ====

Nous allons ensuite choisir l'intervalle de déclenchement de notre action, sachant que nous avons le choix entre:

* '''none''' : pas de déclenchement périodique programmé
* '''interval''' : nous fixons un temps de déclenchement à partir du lancement du programme, l'action se réalisera à chaque fois que ce temps sera écoulé de manière répétée jusqu'à l'interruption manuelle du programme
* '''interval between times''' : nous fixons ici le déclenchement par interval, mais nous fixons aussi une fourchette d'heures et des jours pendant lesquels nous exécutons cet interval
* '''at a specific time''' : nous fixons une heure d'exécution, et un ou plusieurs jours d'exécution. Dans ce cas l'action n'est pas répétée en continu mais éxécutée une seule fois par jour à l'heure programmée

Dans notre exemple, nous allons fixer un intervalle de 15 secondes pour commencer. Nous pourrons ensuite augmenter cette valeur pour éviter de recevoir trop d'emails avec des photos :D

[[fichier:Rasp-Node-Red-picam-mail-07.png]]

La case '''"inject once at start"''' permet de ne pas attendre le premier cycle avant d'exécuter une première fois l'action. Elle se lancera dès le lancement du programme, puis périodiquement selon les cycles déterminés par l'intervalle.

[[fichier:Rasp-Node-Red-picam-mail-08.png]]

==== Name ====

Le champs Name va déterminer le nom que portera le bloc dans l'espace de travail et dans les logs (si nous créons des blocs de log ensuite pour contrôler des étapes).
Il est important de bien établir ce nom de manière explicite, car le nom des blocs permettra de comprendre et retrouver facilement la logique du schéma construit, même si l'on a pas consulté celui-ci pendant une longue période.

[[fichier:Rasp-Node-Red-picam-mail-09.png]]

=== Capture d'une image depuis la PiCam ===

Nous allons aller à l'essentiel en ce qui concerne la capture photo en utilisant une commande simple pour prendre un cliché et renvoyer celui-ci dans le flux NodeRED grâce à un bloc permettant d'exécuter des commandes bash.

{{ambox | text = Vous trouverez un TUTO détaillé sur la PiCam vous permettant de prendre la main, ou de la paramétrer si vous n'avez pas encore utilisé celle-ci auparavant: ....___TUTO___...}}

Nous allons tout d'abord cliquer sur le bloc "Exec" dans la section "Advanced" de la colonne de gauche et glisser l'élément dans la zone de travail.

[[fichier:Rasp-Node-Red-picam-mail-10.png]]

Ensuite, cliquer sur le bloc nouvellement créé et configurer celui-ci.

[[fichier:Rasp-Node-Red-picam-mail-11.png]]

Le menu suivant s'affichera, et nous pourrons configurer le bloc "Exec" nouvellement créé.

==== Command ====

Nous allons y ajouter la commande à exécuter pour prendre une photo avec la caméra du Raspberry Pi et la stocker dans un fichier jpg dans le dossier /tmp/ de linux.

<syntaxhighlight lang="python">
raspistill -o /tmp/cam.jpg -w 640 -h 480
</syntaxhighlight>

Nous prenons soin de limiter la hauteur et la largeur de l'image afin de réduire son poids pour l'envoi par email.

[[fichier:Rasp-Node-Red-picam-mail-12.png]]

==== +Append ====

Ensuite, nous allons décocher la case "msg.payload" si elle est cochée par défaut.

[[fichier:Rasp-Node-Red-picam-mail-13.png]]

==== Extra input parameters et Timeout ====

Nous n'aurons pas besoin de compléter ces champs pour notre projet.

Si vous cochez le champ "Use spawn() instead of exec()?", votre commande sera réalisée sous forme d'un processus résident et continuera de s'exécuter jusqu'à ce qu'elle se termine par elle-même (sauf si elle ne se termine jamais).
Cette solution implique que le programme n'attendra pas que cette commande soit réalisée pour passer aux étapes suivantes.
Si la suite de l'exécution de votre flux est susceptible d'utiliser le résultat de cette commande, nous vous déconseillons d'utiliser cette option sous peine de provoquer des erreurs à la suite du traitement du flux.

Le champ "Timeout" permet de définir un temps d'attente maximum avant de mettre un terme à l'exécution de la commande.
Cela permet de débloquer la situation si la commande exécutée prends un temps anormalement long à s'exécuter.

==== Name ====

Nous allons ensuite compléter le champs nom, celui-ci sera utilisé pour nommer le bloc dans le "schéma", mais aussi de nommer les logs comme pour le bloc "Exec".

[[fichier:Rasp-Node-Red-picam-mail-14.png]]

=== Encodage de l'image en base64 ===

Nous allons convertir la photo prise juste avant en utilisant une commande de conversion en base64.
Cela facilitera son injection dans un template HTML que nous allons créer ensuite pour construire un email.

Nous allons tout d'abord cliquer sur le bloc "Exec" dans la section "Advanced" de la colonne de gauche et glisser l'élément dans la zone de travail.

[[fichier:Rasp-Node-Red-picam-mail-10.png]]

Ensuite, cliquer sur le bloc nouvellement créé et configurer celui-ci.

[[fichier:Rasp-Node-Red-picam-mail-11.png]]

Le menu suivant s'affichera, et nous pourrons configurer le bloc "Exec" nouvellement créé.

[[fichier:Rasp-Node-Red-picam-mail-15.png]]

==== Command ====

Nous allons y ajouter la commande à exécuter pour encoder en base 64 la photo prise précédemment avec la caméra du Raspberry Pi.

<syntaxhighlight lang="python">
base64 -i "/tmp/cam.jpg"
</syntaxhighlight>

[[fichier:Rasp-Node-Red-picam-mail-16.png]]

==== +Append ====

Ensuite, nous allons cocher la case "msg.payload" si elle n'est pas cochée par défaut pour que le résultat soit directement renvoyé par cette commande dans le "PayLoad" du flux.

[[fichier:Rasp-Node-Red-picam-mail-17.png]]

==== Extra input parameters et Timeout ====

Nous n'aurons pas besoin de compléter ces champs pour notre projet.

Si vous cochez le champ "Use spawn() instead of exec()?", votre commande sera réalisée sous forme d'un processus résident et continuera de s'exécuter jusqu'à ce qu'elle se termine par elle-même (sauf si elle ne se termine jamais).
Cette solution implique que le programme n'attendra pas que cette commande soit réalisée pour passer aux étapes suivantes.
Si la suite de l'exécution de votre flux est susceptible d'utiliser le résultat de cette commande, nous vous déconseillons d'utiliser cette option sous peine de provoquer des erreurs à la suite du traitement du flux.

[[fichier:Rasp-Node-Red-picam-mail-18.png]]

Le champ "Timeout" permet de définir un temps d'attente maximum avant de mettre un terme à l'exécution de la commande.
Cela permet de débloquer la situation si la commande exécutée prends un temps anormalement long à s'exécuter.

[[fichier:Rasp-Node-Red-picam-mail-19.png]]

==== Name ====

Nous allons ensuite compléter le champs nom, celui-ci sera utilisé pour nommer le bloc dans le "schéma", mais aussi de nommer les logs comme pour le bloc "Exec".

[[fichier:Rasp-Node-Red-picam-mail-20.png]]

=== Création d'un email au format HTML ===

Nous allons maintenant créer un template d'email au format HTML afin de mettre en forme le message que nous enverrons ensuite.
Nous allons pour cela utiliser un bloc "Template".

[[fichier:Rasp-Node-Red-picam-mail-21.png]]

==== Name ====

Nous allons attribuer un nom au bloc afin de l'identifier plus facilement dans le flux.
Nous allons donc le nommer "Contenu du mail" puisque nous créons le contenu du mail que nous enverrons ensuite.

[[fichier:Rasp-Node-Red-picam-mail-22.png]]

==== Set property ====

La propriété que nous souhaitons créer dans le flux est le "PayLoad".
Ce PayLoad existe déjà, il contient pour le moment l'image au format "Base64" précédemment encodé.
Cela n'est pas un problème, après notre noeud (notre bloc), le PayLoad sera intégralement remplacé par le template que nous sommes en train de créer.

[[fichier:Rasp-Node-Red-picam-mail-23.png]]

==== Template ====

Dans ce template, nous allons créer une structure HTML de base minimum afin que la structure soit interprétée par la majorité des clients/webmail.
Vous pouvez la personnaliser à votre guise si vous avez les connaissances en HTML.

Voici la structure de base pour notre projet:

<syntaxhighlight lang="html">
<html>
<head>
<meta charset="utf8"/>
</head>
<body>
<h1>Projet Photo par email</h1>
<img src="data:image/jpg;base64,{{payload}}"/>
</body>
</html>
</syntaxhighlight>

Vous pourrez remarquer que nous intégrons l'image en appelant le PayLoad à 'intérieur du code HTML dans la balise <img>.
C'est le PayLoad créé précédemment par le bloc "Exec" qui est récupéré à ce moment précis.
Ce PayLoad est remplacé dans le flux par le PayLoad complet avec notre template dans le flux par notre bloc Template.

[[fichier:Rasp-Node-Red-picam-mail-24.png]]

=== Création d'un bloc (noeud) "Debug" ===

Nous allons ajouter la notion d'expéditeur dans le flux que nous avons créé à travers nos blocs (noeuds).
Pour rappel, actuellement nous avons deux propriétés avec des données dans notre flux.
Si nous voulons observer ce que nous avons créé jusque là, nous pouvons faire appel à un bloc "Debug".

==== Création du bloc "Debug" ====

Comme pour les blocs précédents, nous allons glisser/déposer un bloc débug dans l'espace de travail.

[[fichier:Rasp-Node-Red-picam-mail-25.png]]

Celui-ci s'appelle msg/payload par défaut

[[fichier:Rasp-Node-Red-picam-mail-26.png]]

Nous allons double-cliquer sur ce bloc pour le configurer.

[[fichier:Rasp-Node-Red-picam-mail-27.png]]

==== Output ====

Dans ce champs, nous allons choisir la partie du flux que nous souhaitons afficher, ou nous allons sélectionner le flux entier.

[[fichier:Rasp-Node-Red-picam-mail-28.png]]

Sélectionner le flux entier, nous affichera le flux complet incluant toutes ses propriétés.

[[fichier:Rasp-Node-Red-picam-mail-29.png]]

==== To =====

La propriété "To" nous permet de choisir ou nous souhaitons afficher les données que nous récupérons.
Soit nous les affichons uniquement dans l'onglet "Debug" à droite de l'espace de travail, soit nous l'affichons dans cet onglet mais aussi dans la console de NodeJS.
Dans notre cas, nous allons nous contenter d'afficher nos éléments dans l'onglet de "Debug" à droite de notre espace de travail.

[[fichier:Rasp-Node-Red-picam-mail-30.png]]

==== Name ====

Le champs Name nous servira à identifier quel bloc de "Debug" affiche les données en console ou dans l'onglet "Debug".
Il faut donc le nommer efficacement pour bien attacher et comprendre les données que nous récupérons, surtout si nous en plaçons plusieurs dans le flux.

[[fichier:Rasp-Node-Red-picam-mail-31.png]]

==== Exploitation et compréhension des données récupérées ====

Nous avons placé notre bloc "Debug" à la suite du flux en dernière position.

[[fichier:Rasp-Node-Red-picam-mail-32.png]]

Nous allons donc déployer le programme en cliquant sur "Deploy" en haut à droite de la page.

[[fichier:Rasp-Node-Red-picam-mail-33.png]]

Ensuite, nous allons exécuter manuellement le programme en cliquant sur le bouton se trouvant en début de chaîne:

[[fichier:Rasp-Node-Red-picam-mail-34.png]]

Nous allons ensuite afficher l'onglet "Debug" sur le coté droit de la page et analyser les données récupérées:

[[fichier:Rasp-Node-Red-picam-mail-35.png]]

==== Analyse des données récupérées dans l'onglet "Debug" ====

<syntaxhighlight lang="bash">
08/05/2017 à 12:54:31 node: FORMATAGE
MCHobby - Photo bureau : msg : Object
object
_msgid: "81efe35c.3208d"
topic: "MCHobby - Photo bureau"
payload: "<html>↵ <head>↵ <meta charset="utf8"/>↵ ↵ </head>↵ <body>↵ <h1>MCHobby - Photo bureau</h1>↵ <p>Cette photo est un instantané pris dans les bureaux de MCHobby.</p>↵
<img src="data:image/jpg;base64,/9j/4WP6x2.../>"
</syntaxhighlight>

Comme vous pourrez le constater, chaque élément du noeud est détaillé.
Les données sont cependant tronquées, le noeud "Debug" ne nous fourni pas la totalité du "PayLoad" mais nous avons déjà un bon aperçu des données qu'il contient.

* '''_msgid:''' est un Id unique de message
* '''topic:''' est le sujet du mail, nous l'avons déterminé dans le premier bloc
* '''payload:''' contient les données du message formatées par le template que nous avons créé et complété par l'image en base64.

{{tmbox | text = Les noeuds "Debug" sont pratiques. Ils nous permettent d'afficher une partie ou la totalité du flux tel qu'il est à l'endroit ou ils sont placés. Cela peut permettre d'identifier et de résoudre plus facilement des problèmes dans des opérations plus complexes et dans notre cas, cela nous permet de mieux comprendre comment fonctionne le noeud et comment les données sont transmises d'un bloc à l'autre.}}

=== Création d'un expéditeur ===

Nous avons construit petit à petit un message avec un sujet, mais il manque encore un détail: l'expéditeur de l'email que nous allons envoyer: le fameux "msg.from" que nous avons évoqué au début de tuto !

Si vous avez bien suivi les étapes précédentes du tuto, jusqu'au noeud "Debug" et à son résultat, vous comprendrez facilement la démarche ci après pour ajouter un expéditeur dans le flux.

Nous allons ajouter un nouveau noeud "Template" dans la zone de travail et double cliquer dessus pour afficher sa page de configuration:

[[fichier:Rasp-Node-Red-picam-mail-39.png]]

Nous allons ensuite sélectionner le type de propriété que nous souhaitons injecter dans le flux: '''"msg.from"'''

[[fichier:Rasp-Node-Red-picam-mail-40.png]]

Cette propriété étant une adresse email, nous allons choisir le type '''"plaintext"''' comme type de données.

[[fichier:Rasp-Node-Red-picam-mail-41.png]]

Nous allons enfin donner un nom explicite à notre bloc afin d'identifier facilement sa fonctionnalité parmi les autres blocs.

[[fichier:Rasp-Node-Red-picam-mail-42.png]]

=== Création du bloc d'envoi d'email ===

==== To : destinataire ====

Simplement, l'adresse email du destinataire du message.

[[fichier:Rasp-Node-Red-picam-mail-43.png]]

==== Server, port, secure connection ====

Dans ce champ, nous allons mettre un serveur SMTP (serveur email) pour permettre l'envoi de l'email. Dans la plupart des cas, le SMTP de votre FAI (fournisseur d'accès à internet) pourra servir d'intermédiaire.
Nous vous invitons à consulter les paramètres propres à votre fournisseur d'accès pour paramétrer ce bloc.

[[fichier:Rasp-Node-Red-picam-mail-44.png]]

==== UserID et Password ====

Ces champs resteront vides si votre FAI ne nécessite pas d'authentification pour envoyer des emails.
Si vous utilisez un autre fournisseur, tel que GMAIL par exemple, il faudra mettre votre adresse email et votre mot de passe pour vous identifier.

{{ambox-stop|text="Attention: votre compte gmail devra être configuré au préalable afin d'autoriser un "client email" à utiliser votre compte pour envoyer/recevoir des emails par ce biais. Nous vous invitons à consulter la documentation de Gmail pour en savoir plus."}}

[[fichier:Rasp-Node-Red-picam-mail-45.png]]

==== Name ====

Enfin, le champ "Name" qui vous permet de donner un nom au bloc d'envoi d'email.

[[fichier:Rasp-Node-Red-picam-mail-46.png]]

=== Déploiement et premiers tests ===

Afin de "lancer le programme" que nous venons de créer, il suffit de cliquer sur le bouton "Deploy" en haut à droite de la page.

===== La photo ne se réalise pas =====

Si la photo ne se réalise pas, il faut commencer par vérifier la commande dans le bloc de prise de photo.
Nous vous invitons vivement à tester la commande directement dans le terminal afin de vous assurer que celle-ci soit d'une syntaxe correcte et ne rencontre pas de problème d'exécution.
Les problèmes d'exécution de commandes externes dans le bloc '''"command"''' peuvent amener à des blocages dans l'exécution et empêcher NodeRED de continuer à exécuter le '''"Schéma"'''.

===== La photo se réalise mais l'encodage en base64 bloque =====

Si le programme bloque à l'encodage, comme précédemment, nous vous invitons à vérifier votre commande en l'exécutant directement dans le terminal.
Vous pourrez identifier directement le problème et le résoudre le cas échéant.

===== L'encodage fonctionne, mais le PayLoad reste vide =====

N'auriez-vous pas oublié de cocher la case '''"+ Append : msg.payload"''' dans le bloc qui lance la commande de conversion en base64 ?

===== Mon email arrive vide =====

Retournez à l'étape de mise en forme du message afin de vérifier si vous n'avez pas omis un paramètre ou une fonctionnalité.

===== L'image ne s'affiche pas dans l'email reçu =====

Si l'image ne s'affiche pas, il faudrait vérifier si vous avez bien lié vos blocs sur la première sortie des blocs '''"Exec"'''.
Les deux autres sorties étant destinées à d'autres états d'exécution/erreur.

===== Le sujet de l'email est vide =====

Dans notre cas, le sujet est fixé dans le premier bloc dans le champ '''"Topic"'''.
Vous pouvez-donc ré-éditer ce bloc afin de vérifier si celui-ci n'est pas resté vide.

{{Rasp-Node-Red-TRAILER}}

Rasp-Node-Red-picam-mail

2017-05-08T14:03:15Z

AntoineWrt : /* PiCamRED - Envoi périodique de photos par email avec PiCam et NodeRED */

{{Rasp-Node-Red-NAV}}

{{traduction}}

== PiCamRED - Envoi périodique de photos par email avec PiCam et NodeRED ==

[[fichier:Rasp-Node-Red-picam-mail-01.png|900px]]

{{ambox|text="Les blocs (noeuds) sont liés entre-eux en cliquant et en maintenant le clic du point du bloc précédent (en réalité il est carré) et en glissant sur le carré du bloc suivant que l'on veut relier. Seules des entrées et des sorties peuvent être reliées, NodeRED refusera des liaisons incompatibles."}}

=== Description du projet ===

Dans ce tutoriel, nous allons réaliser des photos à l'aide de la caméra du RaspBerry Pi 2/3 et envoyer ces clichés par email de manière périodique grâce à NodeRED.
Nous allons donc utiliser plusieurs blocs et décrire de manière détaillée le déroulement de chaque étape de la réalisation de ce projet.

Dans NodeRED, il est important de bien identifier la finalité de notre projet afin de connaître au préalable tous les éléments qu'il faudra créer et fournir à l'action finale (celle qui enverra un email).

=== Quels sont les besoins du noeud email ===

==== Composants nécessaires pour constituer un email ====

Un email est composé des éléments suivants:

* Un expéditeur
* Un destinataire
* Un sujet
* Le corps du message

Tous ces éléments vont donc devoir être préparés afin de pouvoir construire le message à envoyer par le noeud final.

Le noeud final aura aussi besoin d'un serveur SMTP (serveur d'envoi d'emails) et éventuellement de paramètres d'identification pour ce serveur d'envoi d'emails.

==== Détail des besoins du noeud email ====

La liste des éléments nécessaires s'affiche lorsque le bloc est dans la zone de travail (Schema).
Commençons donc par sélectionner le bloc email, et de le glisser dans la zone de travail.

Commençons par cliquer sur le bloc email et nous maintenons le clic pour le glisser à droite dans l'espace de travail.

(on choisit celui qui a son point de liaison à gauche, car nous voulons un bloc de sortie)

[[fichier:Rasp-Node-Red-picam-mail-36.png]]

Glissons le dans l'espace de travail, et cliquons un clic simple pour le sélectionner.

[[fichier:Rasp-Node-Red-picam-mail-37.png]]

Ensuite, dans la colonne à droite de cet espace de travail, nous cliquons sur info et nous pourrons découvrir les éléments nécessaires à la constitution d'un bloc email.

[[fichier:Rasp-Node-Red-picam-mail-38.png]]

===== Nous utiliserons les champs suivants =====

* '''msg.payload''' --> Ce champ contient le corps de l'email
* '''msg.topic''' --> Ce champ contient le sujet de l'email
* '''msg.from''' --> Ce champ contient l'email de l'expéditeur
* '''msg.to''' --> Ce champ contient l'email du destinataire

Les autres champs ne seront pas utilisés dans notre cas, mais vous pourrez constater que le bloc email est complet de part ses fonctionnalités et possibilités.

Les données de serveur et d'identification seront abordées en fin de tuto lors de la configuration finale du bloc.

Nous allons maintenant passer à la réalisation du flux en commençant par le début de celui-ci.

=== Création d'une action périodique ===

Dans la colonne de gauche de NodeRED, se trouvent une liste de blocs à utiliser pour réaliser vos projets. Ils sont classés par "types".

Ainsi nous retrouvons les "types" suivants:

* '''Input''' qui contient tous les blocs d'entrées
* '''Ouput''' qui contient tous les blocs de sortie
* '''Function''' qui contient des blocs de fonctions javascript etc...
* '''Social''' qui sont des blocs d'entrée ou sorties depuis ou vers les réseaux sociaux
* '''Storage''' qui sont des fonctions de lecture ou d'écriture de fichiers
* '''Analysis''' ->> Sentiment interprète du texte et détermine un score sur base d'un dictionnaire anglais, renvoie le texte avec ce score de -5 à +5, déterminant ainsi l'émotion susceptible d'être procuré par ce texte
* '''Advanced''' possède des outils permettant de détecter des changements dans des fichiers ou dossiers, de lire des flux RSS ou encore EXEC qui permet d'exécuter directement des commandes sous linux !
* '''Raspberry Pi''' contient des outils pour piloter/lire le GPIO du raspberry Pi
* '''Network''' qui contient un outil réseau de Ping

Nous allons créer une action périodique, c'est à dire paramétrer un bloc '''"INJECT"''' de manière à déclencher régulièrement une chaine d'actions que nous allons accrocher à la suite les unes après les autres.
Nous allons donc cliquer sur le bloc '''"Inject"''' dans la liste "Input" et maintenir ce clic pour le déplacer vers la zone de travail.

[[fichier:Rasp-Node-Red-picam-mail-02.png]]

Nous obtiendrons donc une nouvelle instance "inject" qui portera le nom '''"Timestamp"''' (ce nom est attribué par défaut par NodeRED) comme dans la capture ci-dessous

[[fichier:Rasp-Node-Red-picam-mail-03.png]]

Nous allons maintenant double-cliquer sur celle-ci fin de l'éditer pour voir apparaitre le menu ci-dessous

[[fichier:Rasp-Node-Red-picam-mail-04.png]]

Il va falloir configurer ce bloc, mais avant tout voici une explication de celui-ci:

==== Payload ====

Le champs PayLoad est en fait le champ de données qui sera suivi d'un noeud à l'autre jusque à la fin de la chaine.
Dans ce module '''"inject"''', nous allons donc déterminer quel type de données contiendra le '''"PayLoad"''' jusqu'à la fin de la chaine que l'on va réaliser.

Dans notre cas, nous souhaitons construire un email, donc du contenu textuel, nous allons donc choisir '''"String"''' ce qui correspond à une chaine de caractères (du texte).

[[fichier:Rasp-Node-Red-picam-mail-05.png]]

==== Topic ====

Le champs "Topic" est un champs de texte dans lequel nous allons mettre un sujet succinct décrivant notre chaine.
Dans notre cas, ce sujet fera office de sujet au mail que nous expédierons.
Nous allons donc être précis en un minimum de mots pour que le destinataire de l'email puisse facilement deviner le contenu de celui-ci.

[[fichier:Rasp-Node-Red-picam-mail-06.png]]

==== Repeat ====

Nous allons ensuite choisir l'intervalle de déclenchement de notre action, sachant que nous avons le choix entre:

* '''none''' : pas de déclenchement périodique programmé
* '''interval''' : nous fixons un temps de déclenchement à partir du lancement du programme, l'action se réalisera à chaque fois que ce temps sera écoulé de manière répétée jusqu'à l'interruption manuelle du programme
* '''interval between times''' : nous fixons ici le déclenchement par interval, mais nous fixons aussi une fourchette d'heures et des jours pendant lesquels nous exécutons cet interval
* '''at a specific time''' : nous fixons une heure d'exécution, et un ou plusieurs jours d'exécution. Dans ce cas l'action n'est pas répétée en continu mais éxécutée une seule fois par jour à l'heure programmée

Dans notre exemple, nous allons fixer un intervalle de 15 secondes pour commencer. Nous pourrons ensuite augmenter cette valeur pour éviter de recevoir trop d'emails avec des photos :D

[[fichier:Rasp-Node-Red-picam-mail-07.png]]

La case '''"inject once at start"''' permet de ne pas attendre le premier cycle avant d'exécuter une première fois l'action. Elle se lancera dès le lancement du programme, puis périodiquement selon les cycles déterminés par l'intervalle.

[[fichier:Rasp-Node-Red-picam-mail-08.png]]

==== Name ====

Le champs Name va déterminer le nom que portera le bloc dans l'espace de travail et dans les logs (si nous créons des blocs de log ensuite pour contrôler des étapes).
Il est important de bien établir ce nom de manière explicite, car le nom des blocs permettra de comprendre et retrouver facilement la logique du schéma construit, même si l'on a pas consulté celui-ci pendant une longue période.

[[fichier:Rasp-Node-Red-picam-mail-09.png]]

=== Capture d'une image depuis la PiCam ===

Nous allons aller à l'essentiel en ce qui concerne la capture photo en utilisant une commande simple pour prendre un cliché et renvoyer celui-ci dans le flux NodeRED grâce à un bloc permettant d'exécuter des commandes bash.

{{ambox | text = Vous trouverez un TUTO détaillé sur la PiCam vous permettant de prendre la main, ou de la paramétrer si vous n'avez pas encore utilisé celle-ci auparavant: ....___TUTO___...}}

Nous allons tout d'abord cliquer sur le bloc "Exec" dans la section "Advanced" de la colonne de gauche et glisser l'élément dans la zone de travail.

[[fichier:Rasp-Node-Red-picam-mail-10.png]]

Ensuite, cliquer sur le bloc nouvellement créé et configurer celui-ci.

[[fichier:Rasp-Node-Red-picam-mail-11.png]]

Le menu suivant s'affichera, et nous pourrons configurer le bloc "Exec" nouvellement créé.

==== Command ====

Nous allons y ajouter la commande à exécuter pour prendre une photo avec la caméra du Raspberry Pi et la stocker dans un fichier jpg dans le dossier /tmp/ de linux.

<syntaxhighlight lang="python">
raspistill -o /tmp/cam.jpg -w 640 -h 480
</syntaxhighlight>

Nous prenons soin de limiter la hauteur et la largeur de l'image afin de réduire son poids pour l'envoi par email.

[[fichier:Rasp-Node-Red-picam-mail-12.png]]

==== +Append ====

Ensuite, nous allons décocher la case "msg.payload" si elle est cochée par défaut.

[[fichier:Rasp-Node-Red-picam-mail-13.png]]

==== Extra input parameters et Timeout ====

Nous n'aurons pas besoin de compléter ces champs pour notre projet.

Si vous cochez le champ "Use spawn() instead of exec()?", votre commande sera réalisée sous forme d'un processus résident et continuera de s'exécuter jusqu'à ce qu'elle se termine par elle-même (sauf si elle ne se termine jamais).
Cette solution implique que le programme n'attendra pas que cette commande soit réalisée pour passer aux étapes suivantes.
Si la suite de l'exécution de votre flux est susceptible d'utiliser le résultat de cette commande, nous vous déconseillons d'utiliser cette option sous peine de provoquer des erreurs à la suite du traitement du flux.

Le champ "Timeout" permet de définir un temps d'attente maximum avant de mettre un terme à l'exécution de la commande.
Cela permet de débloquer la situation si la commande exécutée prends un temps anormalement long à s'exécuter.

==== Name ====

Nous allons ensuite compléter le champs nom, celui-ci sera utilisé pour nommer le bloc dans le "schéma", mais aussi de nommer les logs comme pour le bloc "Exec".

[[fichier:Rasp-Node-Red-picam-mail-14.png]]

=== Encodage de l'image en base64 ===

Nous allons convertir la photo prise juste avant en utilisant une commande de conversion en base64.
Cela facilitera son injection dans un template HTML que nous allons créer ensuite pour construire un email.

Nous allons tout d'abord cliquer sur le bloc "Exec" dans la section "Advanced" de la colonne de gauche et glisser l'élément dans la zone de travail.

[[fichier:Rasp-Node-Red-picam-mail-10.png]]

Ensuite, cliquer sur le bloc nouvellement créé et configurer celui-ci.

[[fichier:Rasp-Node-Red-picam-mail-11.png]]

Le menu suivant s'affichera, et nous pourrons configurer le bloc "Exec" nouvellement créé.

[[fichier:Rasp-Node-Red-picam-mail-15.png]]

==== Command ====

Nous allons y ajouter la commande à exécuter pour encoder en base 64 la photo prise précédemment avec la caméra du Raspberry Pi.

<syntaxhighlight lang="python">
base64 -i "/tmp/cam.jpg"
</syntaxhighlight>

[[fichier:Rasp-Node-Red-picam-mail-16.png]]

==== +Append ====

Ensuite, nous allons cocher la case "msg.payload" si elle n'est pas cochée par défaut pour que le résultat soit directement renvoyé par cette commande dans le "PayLoad" du flux.

[[fichier:Rasp-Node-Red-picam-mail-17.png]]

==== Extra input parameters et Timeout ====

Nous n'aurons pas besoin de compléter ces champs pour notre projet.

Si vous cochez le champ "Use spawn() instead of exec()?", votre commande sera réalisée sous forme d'un processus résident et continuera de s'exécuter jusqu'à ce qu'elle se termine par elle-même (sauf si elle ne se termine jamais).
Cette solution implique que le programme n'attendra pas que cette commande soit réalisée pour passer aux étapes suivantes.
Si la suite de l'exécution de votre flux est susceptible d'utiliser le résultat de cette commande, nous vous déconseillons d'utiliser cette option sous peine de provoquer des erreurs à la suite du traitement du flux.

[[fichier:Rasp-Node-Red-picam-mail-18.png]]

Le champ "Timeout" permet de définir un temps d'attente maximum avant de mettre un terme à l'exécution de la commande.
Cela permet de débloquer la situation si la commande exécutée prends un temps anormalement long à s'exécuter.

[[fichier:Rasp-Node-Red-picam-mail-19.png]]

==== Name ====

Nous allons ensuite compléter le champs nom, celui-ci sera utilisé pour nommer le bloc dans le "schéma", mais aussi de nommer les logs comme pour le bloc "Exec".

[[fichier:Rasp-Node-Red-picam-mail-20.png]]

=== Création d'un email au format HTML ===

Nous allons maintenant créer un template d'email au format HTML afin de mettre en forme le message que nous enverrons ensuite.
Nous allons pour cela utiliser un bloc "Template".

[[fichier:Rasp-Node-Red-picam-mail-21.png]]

==== Name ====

Nous allons attribuer un nom au bloc afin de l'identifier plus facilement dans le flux.
Nous allons donc le nommer "Contenu du mail" puisque nous créons le contenu du mail que nous enverrons ensuite.

[[fichier:Rasp-Node-Red-picam-mail-22.png]]

==== Set property ====

La propriété que nous souhaitons créer dans le flux est le "PayLoad".
Ce PayLoad existe déjà, il contient pour le moment l'image au format "Base64" précédemment encodé.
Cela n'est pas un problème, après notre noeud (notre bloc), le PayLoad sera intégralement remplacé par le template que nous sommes en train de créer.

[[fichier:Rasp-Node-Red-picam-mail-23.png]]

==== Template ====

Dans ce template, nous allons créer une structure HTML de base minimum afin que la structure soit interprétée par la majorité des clients/webmail.
Vous pouvez la personnaliser à votre guise si vous avez les connaissances en HTML.

Voici la structure de base pour notre projet:

<syntaxhighlight lang="html">
<html>
<head>
<meta charset="utf8"/>
</head>
<body>
<h1>Projet Photo par email</h1>
<img src="data:image/jpg;base64,{{payload}}"/>
</body>
</html>
</syntaxhighlight>

Vous pourrez remarquer que nous intégrons l'image en appelant le PayLoad à 'intérieur du code HTML dans la balise <img>.
C'est le PayLoad créé précédemment par le bloc "Exec" qui est récupéré à ce moment précis.
Ce PayLoad est remplacé dans le flux par le PayLoad complet avec notre template dans le flux par notre bloc Template.

[[fichier:Rasp-Node-Red-picam-mail-24.png]]

=== Création d'un bloc (noeud) "Debug" ===

Nous allons ajouter la notion d'expéditeur dans le flux que nous avons créé à travers nos blocs (noeuds).
Pour rappel, actuellement nous avons deux propriétés avec des données dans notre flux.
Si nous voulons observer ce que nous avons créé jusque là, nous pouvons faire appel à un bloc "Debug".

==== Création du bloc "Debug" ====

Comme pour les blocs précédents, nous allons glisser/déposer un bloc débug dans l'espace de travail.

[[fichier:Rasp-Node-Red-picam-mail-25.png]]

Celui-ci s'appelle msg/payload par défaut

[[fichier:Rasp-Node-Red-picam-mail-26.png]]

Nous allons double-cliquer sur ce bloc pour le configurer.

[[fichier:Rasp-Node-Red-picam-mail-27.png]]

==== Output ====

Dans ce champs, nous allons choisir la partie du flux que nous souhaitons afficher, ou nous allons sélectionner le flux entier.

[[fichier:Rasp-Node-Red-picam-mail-28.png]]

Sélectionner le flux entier, nous affichera le flux complet incluant toutes ses propriétés.

[[fichier:Rasp-Node-Red-picam-mail-29.png]]

==== To =====

La propriété "To" nous permet de choisir ou nous souhaitons afficher les données que nous récupérons.
Soit nous les affichons uniquement dans l'onglet "Debug" à droite de l'espace de travail, soit nous l'affichons dans cet onglet mais aussi dans la console de NodeJS.
Dans notre cas, nous allons nous contenter d'afficher nos éléments dans l'onglet de "Debug" à droite de notre espace de travail.

[[fichier:Rasp-Node-Red-picam-mail-30.png]]

==== Name ====

Le champs Name nous servira à identifier quel bloc de "Debug" affiche les données en console ou dans l'onglet "Debug".
Il faut donc le nommer efficacement pour bien attacher et comprendre les données que nous récupérons, surtout si nous en plaçons plusieurs dans le flux.

[[fichier:Rasp-Node-Red-picam-mail-31.png]]

==== Exploitation et compréhension des données récupérées ====

Nous avons placé notre bloc "Debug" à la suite du flux en dernière position.

[[fichier:Rasp-Node-Red-picam-mail-32.png]]

Nous allons donc déployer le programme en cliquant sur "Deploy" en haut à droite de la page.

[[fichier:Rasp-Node-Red-picam-mail-33.png]]

Ensuite, nous allons exécuter manuellement le programme en cliquant sur le bouton se trouvant en début de chaîne:

[[fichier:Rasp-Node-Red-picam-mail-34.png]]

Nous allons ensuite afficher l'onglet "Debug" sur le coté droit de la page et analyser les données récupérées:

[[fichier:Rasp-Node-Red-picam-mail-35.png]]

==== Analyse des données récupérées dans l'onglet "Debug" ====

<syntaxhighlight lang="bash">
08/05/2017 à 12:54:31 node: FORMATAGE
MCHobby - Photo bureau : msg : Object
object
_msgid: "81efe35c.3208d"
topic: "MCHobby - Photo bureau"
payload: "<html>↵ <head>↵ <meta charset="utf8"/>↵ ↵ </head>↵ <body>↵ <h1>MCHobby - Photo bureau</h1>↵ <p>Cette photo est un instantané pris dans les bureaux de MCHobby.</p>↵
<img src="data:image/jpg;base64,/9j/4WP6x2.../>"
</syntaxhighlight>

Comme vous pourrez le constater, chaque élément du noeud est détaillé.
Les données sont cependant tronquées, le noeud "Debug" ne nous fourni pas la totalité du "PayLoad" mais nous avons déjà un bon aperçu des données qu'il contient.

* '''_msgid:''' est un Id unique de message
* '''topic:''' est le sujet du mail, nous l'avons déterminé dans le premier bloc
* '''payload:''' contient les données du message formatées par le template que nous avons créé et complété par l'image en base64.

{{tmbox | text = Les noeuds "Debug" sont pratiques. Ils nous permettent d'afficher une partie ou la totalité du flux tel qu'il est à l'endroit ou ils sont placés. Cela peut permettre d'identifier et de résoudre plus facilement des problèmes dans des opérations plus complexes et dans notre cas, cela nous permet de mieux comprendre comment fonctionne le noeud et comment les données sont transmises d'un bloc à l'autre.}}

=== Création d'un expéditeur ===

Nous avons construit petit à petit un message avec un sujet, mais il manque encore un détail: l'expéditeur de l'email que nous allons envoyer: le fameux "msg.from" que nous avons évoqué au début de tuto !

Si vous avez bien suivi les étapes précédentes du tuto, jusqu'au noeud "Debug" et à son résultat, vous comprendrez facilement la démarche ci après pour ajouter un expéditeur dans le flux.

Nous allons ajouter un nouveau noeud "Template" dans la zone de travail et double cliquer dessus pour afficher sa page de configuration:

[[fichier:Rasp-Node-Red-picam-mail-39.png]]

Nous allons ensuite sélectionner le type de propriété que nous souhaitons injecter dans le flux: '''"msg.from"'''

[[fichier:Rasp-Node-Red-picam-mail-40.png]]

Cette propriété étant une adresse email, nous allons choisir le type '''"plaintext"''' comme type de données.

[[fichier:Rasp-Node-Red-picam-mail-41.png]]

Nous allons enfin donner un nom explicite à notre bloc afin d'identifier facilement sa fonctionnalité parmi les autres blocs.

[[fichier:Rasp-Node-Red-picam-mail-42.png]]

=== Création du bloc d'envoi d'email ===

==== To : destinataire ====

Simplement, l'adresse email du destinataire du message.

[[fichier:Rasp-Node-Red-picam-mail-43.png]]

==== Server, port, secure connection ====

Dans ce champ, nous allons mettre un serveur SMTP (serveur email) pour permettre l'envoi de l'email. Dans la plupart des cas, le SMTP de votre FAI (fournisseur d'accès à internet) pourra servir d'intermédiaire.
Nous vous invitons à consulter les paramètres propres à votre fournisseur d'accès pour paramétrer ce bloc.

[[fichier:Rasp-Node-Red-picam-mail-44.png]]

==== UserID et Password ====

Ces champs resteront vides si votre FAI ne nécessite pas d'authentification pour envoyer des emails.
Si vous utilisez un autre fournisseur, tel que GMAIL par exemple, il faudra mettre votre adresse email et votre mot de passe pour vous identifier.

{{ambox-stop|text="Attention: votre compte gmail devra être configuré au préalable afin d'autoriser un "client email" à utiliser votre compte pour envoyer/recevoir des emails par ce biais. Nous vous invitons à consulter la documentation de Gmail pour en savoir plus."}}

[[fichier:Rasp-Node-Red-picam-mail-45.png]]

==== Name ====

Enfin, le champ "Name" qui vous permet de donner un nom au bloc d'envoi d'email.

[[fichier:Rasp-Node-Red-picam-mail-46.png]]

=== Déploiement et premiers tests ===

Afin de "lancer le programme" que nous venons de créer, il suffit de cliquer sur le bouton "Deploy" en haut à droite de la page.

===== La photo ne se réalise pas =====

Si la photo ne se réalise pas, il faut commencer par vérifier la commande dans le bloc de prise de photo.
Nous vous invitons vivement à tester la commande directement dans le terminal afin de vous assurer que celle-ci soit d'une syntaxe correcte et ne rencontre pas de problème d'exécution.
Les problèmes d'exécution de commandes externes dans le bloc '''"command"''' peuvent amener à des blocages dans l'exécution et empêcher NodeRED de continuer à exécuter le '''"Schéma"'''.

===== La photo se réalise mais l'encodage en base64 bloque =====

Si le programme bloque à l'encodage, comme précédemment, nous vous invitons à vérifier votre commande en l'exécutant directement dans le terminal.
Vous pourrez identifier directement le problème et le résoudre le cas échéant.

===== L'encodage fonctionne, mais le PayLoad reste vide =====

N'auriez-vous pas oublié de cocher la case '''"+ Append : msg.payload"''' dans le bloc qui lance la commande de conversion en base64 ?

===== Mon email arrive vide =====

Retournez à l'étape de mise en forme du message afin de vérifier si vous n'avez pas omis un paramètre ou une fonctionnalité.

===== L'image ne s'affiche pas dans l'email reçu =====

Si l'image ne s'affiche pas, il faudrait vérifier si vous avez bien lié vos blocs sur la première sortie des blocs '''"Exec"'''.
Les deux autres sorties étant destinées à d'autres états d'exécution/erreur.

===== Le sujet de l'email est vide =====

Dans notre cas, le sujet est fixé dans le premier bloc dans le champ '''"Topic"'''.
Vous pouvez-donc ré-éditer ce bloc afin de vérifier si celui-ci n'est pas resté vide.

{{Rasp-Node-Red-TRAILER}}

Rasp-Node-Red-picam-mail

2017-05-08T13:58:18Z

AntoineWrt : /* Déploiement et premiers tests */

{{Rasp-Node-Red-NAV}}

{{traduction}}

== PiCamRED - Envoi périodique de photos par email avec PiCam et NodeRED ==

[[fichier:Rasp-Node-Red-picam-mail-01.png|900px]]

=== Description du projet ===

Dans ce tutoriel, nous allons réaliser des photos à l'aide de la caméra du RaspBerry Pi 2/3 et envoyer ces clichés par email de manière périodique grâce à NodeRED.
Nous allons donc utiliser plusieurs blocs et décrire de manière détaillée le déroulement de chaque étape de la réalisation de ce projet.

Dans NodeRED, il est important de bien identifier la finalité de notre projet afin de connaître au préalable tous les éléments qu'il faudra créer et fournir à l'action finale (celle qui enverra un email).

=== Quels sont les besoins du noeud email ===

==== Composants nécessaires pour constituer un email ====

Un email est composé des éléments suivants:

* Un expéditeur
* Un destinataire
* Un sujet
* Le corps du message

Tous ces éléments vont donc devoir être préparés afin de pouvoir construire le message à envoyer par le noeud final.

Le noeud final aura aussi besoin d'un serveur SMTP (serveur d'envoi d'emails) et éventuellement de paramètres d'identification pour ce serveur d'envoi d'emails.

==== Détail des besoins du noeud email ====

La liste des éléments nécessaires s'affiche lorsque le bloc est dans la zone de travail (Schema).
Commençons donc par sélectionner le bloc email, et de le glisser dans la zone de travail.

Commençons par cliquer sur le bloc email et nous maintenons le clic pour le glisser à droite dans l'espace de travail.

(on choisit celui qui a son point de liaison à gauche, car nous voulons un bloc de sortie)

[[fichier:Rasp-Node-Red-picam-mail-36.png]]

Glissons le dans l'espace de travail, et cliquons un clic simple pour le sélectionner.

[[fichier:Rasp-Node-Red-picam-mail-37.png]]

Ensuite, dans la colonne à droite de cet espace de travail, nous cliquons sur info et nous pourrons découvrir les éléments nécessaires à la constitution d'un bloc email.

[[fichier:Rasp-Node-Red-picam-mail-38.png]]

===== Nous utiliserons les champs suivants =====

* '''msg.payload''' --> Ce champ contient le corps de l'email
* '''msg.topic''' --> Ce champ contient le sujet de l'email
* '''msg.from''' --> Ce champ contient l'email de l'expéditeur
* '''msg.to''' --> Ce champ contient l'email du destinataire

Les autres champs ne seront pas utilisés dans notre cas, mais vous pourrez constater que le bloc email est complet de part ses fonctionnalités et possibilités.

Les données de serveur et d'identification seront abordées en fin de tuto lors de la configuration finale du bloc.

Nous allons maintenant passer à la réalisation du flux en commençant par le début de celui-ci.

=== Création d'une action périodique ===

Dans la colonne de gauche de NodeRED, se trouvent une liste de blocs à utiliser pour réaliser vos projets. Ils sont classés par "types".

Ainsi nous retrouvons les "types" suivants:

* '''Input''' qui contient tous les blocs d'entrées
* '''Ouput''' qui contient tous les blocs de sortie
* '''Function''' qui contient des blocs de fonctions javascript etc...
* '''Social''' qui sont des blocs d'entrée ou sorties depuis ou vers les réseaux sociaux
* '''Storage''' qui sont des fonctions de lecture ou d'écriture de fichiers
* '''Analysis''' ->> Sentiment interprète du texte et détermine un score sur base d'un dictionnaire anglais, renvoie le texte avec ce score de -5 à +5, déterminant ainsi l'émotion susceptible d'être procuré par ce texte
* '''Advanced''' possède des outils permettant de détecter des changements dans des fichiers ou dossiers, de lire des flux RSS ou encore EXEC qui permet d'exécuter directement des commandes sous linux !
* '''Raspberry Pi''' contient des outils pour piloter/lire le GPIO du raspberry Pi
* '''Network''' qui contient un outil réseau de Ping

Nous allons créer une action périodique, c'est à dire paramétrer un bloc '''"INJECT"''' de manière à déclencher régulièrement une chaine d'actions que nous allons accrocher à la suite les unes après les autres.
Nous allons donc cliquer sur le bloc '''"Inject"''' dans la liste "Input" et maintenir ce clic pour le déplacer vers la zone de travail.

[[fichier:Rasp-Node-Red-picam-mail-02.png]]

Nous obtiendrons donc une nouvelle instance "inject" qui portera le nom '''"Timestamp"''' (ce nom est attribué par défaut par NodeRED) comme dans la capture ci-dessous

[[fichier:Rasp-Node-Red-picam-mail-03.png]]

Nous allons maintenant double-cliquer sur celle-ci fin de l'éditer pour voir apparaitre le menu ci-dessous

[[fichier:Rasp-Node-Red-picam-mail-04.png]]

Il va falloir configurer ce bloc, mais avant tout voici une explication de celui-ci:

==== Payload ====

Le champs PayLoad est en fait le champ de données qui sera suivi d'un noeud à l'autre jusque à la fin de la chaine.
Dans ce module '''"inject"''', nous allons donc déterminer quel type de données contiendra le '''"PayLoad"''' jusqu'à la fin de la chaine que l'on va réaliser.

Dans notre cas, nous souhaitons construire un email, donc du contenu textuel, nous allons donc choisir '''"String"''' ce qui correspond à une chaine de caractères (du texte).

[[fichier:Rasp-Node-Red-picam-mail-05.png]]

==== Topic ====

Le champs "Topic" est un champs de texte dans lequel nous allons mettre un sujet succinct décrivant notre chaine.
Dans notre cas, ce sujet fera office de sujet au mail que nous expédierons.
Nous allons donc être précis en un minimum de mots pour que le destinataire de l'email puisse facilement deviner le contenu de celui-ci.

[[fichier:Rasp-Node-Red-picam-mail-06.png]]

==== Repeat ====

Nous allons ensuite choisir l'intervalle de déclenchement de notre action, sachant que nous avons le choix entre:

* '''none''' : pas de déclenchement périodique programmé
* '''interval''' : nous fixons un temps de déclenchement à partir du lancement du programme, l'action se réalisera à chaque fois que ce temps sera écoulé de manière répétée jusqu'à l'interruption manuelle du programme
* '''interval between times''' : nous fixons ici le déclenchement par interval, mais nous fixons aussi une fourchette d'heures et des jours pendant lesquels nous exécutons cet interval
* '''at a specific time''' : nous fixons une heure d'exécution, et un ou plusieurs jours d'exécution. Dans ce cas l'action n'est pas répétée en continu mais éxécutée une seule fois par jour à l'heure programmée

Dans notre exemple, nous allons fixer un intervalle de 15 secondes pour commencer. Nous pourrons ensuite augmenter cette valeur pour éviter de recevoir trop d'emails avec des photos :D

[[fichier:Rasp-Node-Red-picam-mail-07.png]]

La case '''"inject once at start"''' permet de ne pas attendre le premier cycle avant d'exécuter une première fois l'action. Elle se lancera dès le lancement du programme, puis périodiquement selon les cycles déterminés par l'intervalle.

[[fichier:Rasp-Node-Red-picam-mail-08.png]]

==== Name ====

Le champs Name va déterminer le nom que portera le bloc dans l'espace de travail et dans les logs (si nous créons des blocs de log ensuite pour contrôler des étapes).
Il est important de bien établir ce nom de manière explicite, car le nom des blocs permettra de comprendre et retrouver facilement la logique du schéma construit, même si l'on a pas consulté celui-ci pendant une longue période.

[[fichier:Rasp-Node-Red-picam-mail-09.png]]

=== Capture d'une image depuis la PiCam ===

Nous allons aller à l'essentiel en ce qui concerne la capture photo en utilisant une commande simple pour prendre un cliché et renvoyer celui-ci dans le flux NodeRED grâce à un bloc permettant d'exécuter des commandes bash.

{{ambox | text = Vous trouverez un TUTO détaillé sur la PiCam vous permettant de prendre la main, ou de la paramétrer si vous n'avez pas encore utilisé celle-ci auparavant: ....___TUTO___...}}

Nous allons tout d'abord cliquer sur le bloc "Exec" dans la section "Advanced" de la colonne de gauche et glisser l'élément dans la zone de travail.

[[fichier:Rasp-Node-Red-picam-mail-10.png]]

Ensuite, cliquer sur le bloc nouvellement créé et configurer celui-ci.

[[fichier:Rasp-Node-Red-picam-mail-11.png]]

Le menu suivant s'affichera, et nous pourrons configurer le bloc "Exec" nouvellement créé.

==== Command ====

Nous allons y ajouter la commande à exécuter pour prendre une photo avec la caméra du Raspberry Pi et la stocker dans un fichier jpg dans le dossier /tmp/ de linux.

<syntaxhighlight lang="python">
raspistill -o /tmp/cam.jpg -w 640 -h 480
</syntaxhighlight>

Nous prenons soin de limiter la hauteur et la largeur de l'image afin de réduire son poids pour l'envoi par email.

[[fichier:Rasp-Node-Red-picam-mail-12.png]]

==== +Append ====

Ensuite, nous allons décocher la case "msg.payload" si elle est cochée par défaut.

[[fichier:Rasp-Node-Red-picam-mail-13.png]]

==== Extra input parameters et Timeout ====

Nous n'aurons pas besoin de compléter ces champs pour notre projet.

Si vous cochez le champ "Use spawn() instead of exec()?", votre commande sera réalisée sous forme d'un processus résident et continuera de s'exécuter jusqu'à ce qu'elle se termine par elle-même (sauf si elle ne se termine jamais).
Cette solution implique que le programme n'attendra pas que cette commande soit réalisée pour passer aux étapes suivantes.
Si la suite de l'exécution de votre flux est susceptible d'utiliser le résultat de cette commande, nous vous déconseillons d'utiliser cette option sous peine de provoquer des erreurs à la suite du traitement du flux.

Le champ "Timeout" permet de définir un temps d'attente maximum avant de mettre un terme à l'exécution de la commande.
Cela permet de débloquer la situation si la commande exécutée prends un temps anormalement long à s'exécuter.

==== Name ====

Nous allons ensuite compléter le champs nom, celui-ci sera utilisé pour nommer le bloc dans le "schéma", mais aussi de nommer les logs comme pour le bloc "Exec".

[[fichier:Rasp-Node-Red-picam-mail-14.png]]

=== Encodage de l'image en base64 ===

Nous allons convertir la photo prise juste avant en utilisant une commande de conversion en base64.
Cela facilitera son injection dans un template HTML que nous allons créer ensuite pour construire un email.

Nous allons tout d'abord cliquer sur le bloc "Exec" dans la section "Advanced" de la colonne de gauche et glisser l'élément dans la zone de travail.

[[fichier:Rasp-Node-Red-picam-mail-10.png]]

Ensuite, cliquer sur le bloc nouvellement créé et configurer celui-ci.

[[fichier:Rasp-Node-Red-picam-mail-11.png]]

Le menu suivant s'affichera, et nous pourrons configurer le bloc "Exec" nouvellement créé.

[[fichier:Rasp-Node-Red-picam-mail-15.png]]

==== Command ====

Nous allons y ajouter la commande à exécuter pour encoder en base 64 la photo prise précédemment avec la caméra du Raspberry Pi.

<syntaxhighlight lang="python">
base64 -i "/tmp/cam.jpg"
</syntaxhighlight>

[[fichier:Rasp-Node-Red-picam-mail-16.png]]

==== +Append ====

Ensuite, nous allons cocher la case "msg.payload" si elle n'est pas cochée par défaut pour que le résultat soit directement renvoyé par cette commande dans le "PayLoad" du flux.

[[fichier:Rasp-Node-Red-picam-mail-17.png]]

==== Extra input parameters et Timeout ====

Nous n'aurons pas besoin de compléter ces champs pour notre projet.

Si vous cochez le champ "Use spawn() instead of exec()?", votre commande sera réalisée sous forme d'un processus résident et continuera de s'exécuter jusqu'à ce qu'elle se termine par elle-même (sauf si elle ne se termine jamais).
Cette solution implique que le programme n'attendra pas que cette commande soit réalisée pour passer aux étapes suivantes.
Si la suite de l'exécution de votre flux est susceptible d'utiliser le résultat de cette commande, nous vous déconseillons d'utiliser cette option sous peine de provoquer des erreurs à la suite du traitement du flux.

[[fichier:Rasp-Node-Red-picam-mail-18.png]]

Le champ "Timeout" permet de définir un temps d'attente maximum avant de mettre un terme à l'exécution de la commande.
Cela permet de débloquer la situation si la commande exécutée prends un temps anormalement long à s'exécuter.

[[fichier:Rasp-Node-Red-picam-mail-19.png]]

==== Name ====

Nous allons ensuite compléter le champs nom, celui-ci sera utilisé pour nommer le bloc dans le "schéma", mais aussi de nommer les logs comme pour le bloc "Exec".

[[fichier:Rasp-Node-Red-picam-mail-20.png]]

=== Création d'un email au format HTML ===

Nous allons maintenant créer un template d'email au format HTML afin de mettre en forme le message que nous enverrons ensuite.
Nous allons pour cela utiliser un bloc "Template".

[[fichier:Rasp-Node-Red-picam-mail-21.png]]

==== Name ====

Nous allons attribuer un nom au bloc afin de l'identifier plus facilement dans le flux.
Nous allons donc le nommer "Contenu du mail" puisque nous créons le contenu du mail que nous enverrons ensuite.

[[fichier:Rasp-Node-Red-picam-mail-22.png]]

==== Set property ====

La propriété que nous souhaitons créer dans le flux est le "PayLoad".
Ce PayLoad existe déjà, il contient pour le moment l'image au format "Base64" précédemment encodé.
Cela n'est pas un problème, après notre noeud (notre bloc), le PayLoad sera intégralement remplacé par le template que nous sommes en train de créer.

[[fichier:Rasp-Node-Red-picam-mail-23.png]]

==== Template ====

Dans ce template, nous allons créer une structure HTML de base minimum afin que la structure soit interprétée par la majorité des clients/webmail.
Vous pouvez la personnaliser à votre guise si vous avez les connaissances en HTML.

Voici la structure de base pour notre projet:

<syntaxhighlight lang="html">
<html>
<head>
<meta charset="utf8"/>
</head>
<body>
<h1>Projet Photo par email</h1>
<img src="data:image/jpg;base64,{{payload}}"/>
</body>
</html>
</syntaxhighlight>

Vous pourrez remarquer que nous intégrons l'image en appelant le PayLoad à 'intérieur du code HTML dans la balise <img>.
C'est le PayLoad créé précédemment par le bloc "Exec" qui est récupéré à ce moment précis.
Ce PayLoad est remplacé dans le flux par le PayLoad complet avec notre template dans le flux par notre bloc Template.

[[fichier:Rasp-Node-Red-picam-mail-24.png]]

=== Création d'un bloc (noeud) "Debug" ===

Nous allons ajouter la notion d'expéditeur dans le flux que nous avons créé à travers nos blocs (noeuds).
Pour rappel, actuellement nous avons deux propriétés avec des données dans notre flux.
Si nous voulons observer ce que nous avons créé jusque là, nous pouvons faire appel à un bloc "Debug".

==== Création du bloc "Debug" ====

Comme pour les blocs précédents, nous allons glisser/déposer un bloc débug dans l'espace de travail.

[[fichier:Rasp-Node-Red-picam-mail-25.png]]

Celui-ci s'appelle msg/payload par défaut

[[fichier:Rasp-Node-Red-picam-mail-26.png]]

Nous allons double-cliquer sur ce bloc pour le configurer.

[[fichier:Rasp-Node-Red-picam-mail-27.png]]

==== Output ====

Dans ce champs, nous allons choisir la partie du flux que nous souhaitons afficher, ou nous allons sélectionner le flux entier.

[[fichier:Rasp-Node-Red-picam-mail-28.png]]

Sélectionner le flux entier, nous affichera le flux complet incluant toutes ses propriétés.

[[fichier:Rasp-Node-Red-picam-mail-29.png]]

==== To =====

La propriété "To" nous permet de choisir ou nous souhaitons afficher les données que nous récupérons.
Soit nous les affichons uniquement dans l'onglet "Debug" à droite de l'espace de travail, soit nous l'affichons dans cet onglet mais aussi dans la console de NodeJS.
Dans notre cas, nous allons nous contenter d'afficher nos éléments dans l'onglet de "Debug" à droite de notre espace de travail.

[[fichier:Rasp-Node-Red-picam-mail-30.png]]

==== Name ====

Le champs Name nous servira à identifier quel bloc de "Debug" affiche les données en console ou dans l'onglet "Debug".
Il faut donc le nommer efficacement pour bien attacher et comprendre les données que nous récupérons, surtout si nous en plaçons plusieurs dans le flux.

[[fichier:Rasp-Node-Red-picam-mail-31.png]]

==== Exploitation et compréhension des données récupérées ====

Nous avons placé notre bloc "Debug" à la suite du flux en dernière position.

[[fichier:Rasp-Node-Red-picam-mail-32.png]]

Nous allons donc déployer le programme en cliquant sur "Deploy" en haut à droite de la page.

[[fichier:Rasp-Node-Red-picam-mail-33.png]]

Ensuite, nous allons exécuter manuellement le programme en cliquant sur le bouton se trouvant en début de chaîne:

[[fichier:Rasp-Node-Red-picam-mail-34.png]]

Nous allons ensuite afficher l'onglet "Debug" sur le coté droit de la page et analyser les données récupérées:

[[fichier:Rasp-Node-Red-picam-mail-35.png]]

==== Analyse des données récupérées dans l'onglet "Debug" ====

<syntaxhighlight lang="bash">
08/05/2017 à 12:54:31 node: FORMATAGE
MCHobby - Photo bureau : msg : Object
object
_msgid: "81efe35c.3208d"
topic: "MCHobby - Photo bureau"
payload: "<html>↵ <head>↵ <meta charset="utf8"/>↵ ↵ </head>↵ <body>↵ <h1>MCHobby - Photo bureau</h1>↵ <p>Cette photo est un instantané pris dans les bureaux de MCHobby.</p>↵
<img src="data:image/jpg;base64,/9j/4WP6x2.../>"
</syntaxhighlight>

Comme vous pourrez le constater, chaque élément du noeud est détaillé.
Les données sont cependant tronquées, le noeud "Debug" ne nous fourni pas la totalité du "PayLoad" mais nous avons déjà un bon aperçu des données qu'il contient.

* '''_msgid:''' est un Id unique de message
* '''topic:''' est le sujet du mail, nous l'avons déterminé dans le premier bloc
* '''payload:''' contient les données du message formatées par le template que nous avons créé et complété par l'image en base64.

{{tmbox | text = Les noeuds "Debug" sont pratiques. Ils nous permettent d'afficher une partie ou la totalité du flux tel qu'il est à l'endroit ou ils sont placés. Cela peut permettre d'identifier et de résoudre plus facilement des problèmes dans des opérations plus complexes et dans notre cas, cela nous permet de mieux comprendre comment fonctionne le noeud et comment les données sont transmises d'un bloc à l'autre.}}

=== Création d'un expéditeur ===

Nous avons construit petit à petit un message avec un sujet, mais il manque encore un détail: l'expéditeur de l'email que nous allons envoyer: le fameux "msg.from" que nous avons évoqué au début de tuto !

Si vous avez bien suivi les étapes précédentes du tuto, jusqu'au noeud "Debug" et à son résultat, vous comprendrez facilement la démarche ci après pour ajouter un expéditeur dans le flux.

Nous allons ajouter un nouveau noeud "Template" dans la zone de travail et double cliquer dessus pour afficher sa page de configuration:

[[fichier:Rasp-Node-Red-picam-mail-39.png]]

Nous allons ensuite sélectionner le type de propriété que nous souhaitons injecter dans le flux: '''"msg.from"'''

[[fichier:Rasp-Node-Red-picam-mail-40.png]]

Cette propriété étant une adresse email, nous allons choisir le type '''"plaintext"''' comme type de données.

[[fichier:Rasp-Node-Red-picam-mail-41.png]]

Nous allons enfin donner un nom explicite à notre bloc afin d'identifier facilement sa fonctionnalité parmi les autres blocs.

[[fichier:Rasp-Node-Red-picam-mail-42.png]]

=== Création du bloc d'envoi d'email ===

==== To : destinataire ====

Simplement, l'adresse email du destinataire du message.

[[fichier:Rasp-Node-Red-picam-mail-43.png]]

==== Server, port, secure connection ====

Dans ce champ, nous allons mettre un serveur SMTP (serveur email) pour permettre l'envoi de l'email. Dans la plupart des cas, le SMTP de votre FAI (fournisseur d'accès à internet) pourra servir d'intermédiaire.
Nous vous invitons à consulter les paramètres propres à votre fournisseur d'accès pour paramétrer ce bloc.

[[fichier:Rasp-Node-Red-picam-mail-44.png]]

==== UserID et Password ====

Ces champs resteront vides si votre FAI ne nécessite pas d'authentification pour envoyer des emails.
Si vous utilisez un autre fournisseur, tel que GMAIL par exemple, il faudra mettre votre adresse email et votre mot de passe pour vous identifier.

{{ambox-stop|text="Attention: votre compte gmail devra être configuré au préalable afin d'autoriser un "client email" à utiliser votre compte pour envoyer/recevoir des emails par ce biais. Nous vous invitons à consulter la documentation de Gmail pour en savoir plus."}}

[[fichier:Rasp-Node-Red-picam-mail-45.png]]

==== Name ====

Enfin, le champ "Name" qui vous permet de donner un nom au bloc d'envoi d'email.

[[fichier:Rasp-Node-Red-picam-mail-46.png]]

=== Déploiement et premiers tests ===

Afin de "lancer le programme" que nous venons de créer, il suffit de cliquer sur le bouton "Deploy" en haut à droite de la page.

===== La photo ne se réalise pas =====

Si la photo ne se réalise pas, il faut commencer par vérifier la commande dans le bloc de prise de photo.
Nous vous invitons vivement à tester la commande directement dans le terminal afin de vous assurer que celle-ci soit d'une syntaxe correcte et ne rencontre pas de problème d'exécution.
Les problèmes d'exécution de commandes externes dans le bloc '''"command"''' peuvent amener à des blocages dans l'exécution et empêcher NodeRED de continuer à exécuter le '''"Schéma"'''.

===== La photo se réalise mais l'encodage en base64 bloque =====

Si le programme bloque à l'encodage, comme précédemment, nous vous invitons à vérifier votre commande en l'exécutant directement dans le terminal.
Vous pourrez identifier directement le problème et le résoudre le cas échéant.

===== L'encodage fonctionne, mais le PayLoad reste vide =====

N'auriez-vous pas oublié de cocher la case '''"+ Append : msg.payload"''' dans le bloc qui lance la commande de conversion en base64 ?

===== Mon email arrive vide =====

Retournez à l'étape de mise en forme du message afin de vérifier si vous n'avez pas omis un paramètre ou une fonctionnalité.

===== L'image ne s'affiche pas dans l'email reçu =====

Si l'image ne s'affiche pas, il faudrait vérifier si vous avez bien lié vos blocs sur la première sortie des blocs '''"Exec"'''.
Les deux autres sorties étant destinées à d'autres états d'exécution/erreur.

===== Le sujet de l'email est vide =====

Dans notre cas, le sujet est fixé dans le premier bloc dans le champ '''"Topic"'''.
Vous pouvez-donc ré-éditer ce bloc afin de vérifier si celui-ci n'est pas resté vide.

{{Rasp-Node-Red-TRAILER}}

Rasp-Node-Red-picam-mail

2017-05-08T13:57:51Z

AntoineWrt : /* Création du bloc d'envoi d'email */

{{Rasp-Node-Red-NAV}}

{{traduction}}

== PiCamRED - Envoi périodique de photos par email avec PiCam et NodeRED ==

[[fichier:Rasp-Node-Red-picam-mail-01.png|900px]]

=== Description du projet ===

Dans ce tutoriel, nous allons réaliser des photos à l'aide de la caméra du RaspBerry Pi 2/3 et envoyer ces clichés par email de manière périodique grâce à NodeRED.
Nous allons donc utiliser plusieurs blocs et décrire de manière détaillée le déroulement de chaque étape de la réalisation de ce projet.

Dans NodeRED, il est important de bien identifier la finalité de notre projet afin de connaître au préalable tous les éléments qu'il faudra créer et fournir à l'action finale (celle qui enverra un email).

=== Quels sont les besoins du noeud email ===

==== Composants nécessaires pour constituer un email ====

Un email est composé des éléments suivants:

* Un expéditeur
* Un destinataire
* Un sujet
* Le corps du message

Tous ces éléments vont donc devoir être préparés afin de pouvoir construire le message à envoyer par le noeud final.

Le noeud final aura aussi besoin d'un serveur SMTP (serveur d'envoi d'emails) et éventuellement de paramètres d'identification pour ce serveur d'envoi d'emails.

==== Détail des besoins du noeud email ====

La liste des éléments nécessaires s'affiche lorsque le bloc est dans la zone de travail (Schema).
Commençons donc par sélectionner le bloc email, et de le glisser dans la zone de travail.

Commençons par cliquer sur le bloc email et nous maintenons le clic pour le glisser à droite dans l'espace de travail.

(on choisit celui qui a son point de liaison à gauche, car nous voulons un bloc de sortie)

[[fichier:Rasp-Node-Red-picam-mail-36.png]]

Glissons le dans l'espace de travail, et cliquons un clic simple pour le sélectionner.

[[fichier:Rasp-Node-Red-picam-mail-37.png]]

Ensuite, dans la colonne à droite de cet espace de travail, nous cliquons sur info et nous pourrons découvrir les éléments nécessaires à la constitution d'un bloc email.

[[fichier:Rasp-Node-Red-picam-mail-38.png]]

===== Nous utiliserons les champs suivants =====

* '''msg.payload''' --> Ce champ contient le corps de l'email
* '''msg.topic''' --> Ce champ contient le sujet de l'email
* '''msg.from''' --> Ce champ contient l'email de l'expéditeur
* '''msg.to''' --> Ce champ contient l'email du destinataire

Les autres champs ne seront pas utilisés dans notre cas, mais vous pourrez constater que le bloc email est complet de part ses fonctionnalités et possibilités.

Les données de serveur et d'identification seront abordées en fin de tuto lors de la configuration finale du bloc.

Nous allons maintenant passer à la réalisation du flux en commençant par le début de celui-ci.

=== Création d'une action périodique ===

Dans la colonne de gauche de NodeRED, se trouvent une liste de blocs à utiliser pour réaliser vos projets. Ils sont classés par "types".

Ainsi nous retrouvons les "types" suivants:

* '''Input''' qui contient tous les blocs d'entrées
* '''Ouput''' qui contient tous les blocs de sortie
* '''Function''' qui contient des blocs de fonctions javascript etc...
* '''Social''' qui sont des blocs d'entrée ou sorties depuis ou vers les réseaux sociaux
* '''Storage''' qui sont des fonctions de lecture ou d'écriture de fichiers
* '''Analysis''' ->> Sentiment interprète du texte et détermine un score sur base d'un dictionnaire anglais, renvoie le texte avec ce score de -5 à +5, déterminant ainsi l'émotion susceptible d'être procuré par ce texte
* '''Advanced''' possède des outils permettant de détecter des changements dans des fichiers ou dossiers, de lire des flux RSS ou encore EXEC qui permet d'exécuter directement des commandes sous linux !
* '''Raspberry Pi''' contient des outils pour piloter/lire le GPIO du raspberry Pi
* '''Network''' qui contient un outil réseau de Ping

Nous allons créer une action périodique, c'est à dire paramétrer un bloc '''"INJECT"''' de manière à déclencher régulièrement une chaine d'actions que nous allons accrocher à la suite les unes après les autres.
Nous allons donc cliquer sur le bloc '''"Inject"''' dans la liste "Input" et maintenir ce clic pour le déplacer vers la zone de travail.

[[fichier:Rasp-Node-Red-picam-mail-02.png]]

Nous obtiendrons donc une nouvelle instance "inject" qui portera le nom '''"Timestamp"''' (ce nom est attribué par défaut par NodeRED) comme dans la capture ci-dessous

[[fichier:Rasp-Node-Red-picam-mail-03.png]]

Nous allons maintenant double-cliquer sur celle-ci fin de l'éditer pour voir apparaitre le menu ci-dessous

[[fichier:Rasp-Node-Red-picam-mail-04.png]]

Il va falloir configurer ce bloc, mais avant tout voici une explication de celui-ci:

==== Payload ====

Le champs PayLoad est en fait le champ de données qui sera suivi d'un noeud à l'autre jusque à la fin de la chaine.
Dans ce module '''"inject"''', nous allons donc déterminer quel type de données contiendra le '''"PayLoad"''' jusqu'à la fin de la chaine que l'on va réaliser.

Dans notre cas, nous souhaitons construire un email, donc du contenu textuel, nous allons donc choisir '''"String"''' ce qui correspond à une chaine de caractères (du texte).

[[fichier:Rasp-Node-Red-picam-mail-05.png]]

==== Topic ====

Le champs "Topic" est un champs de texte dans lequel nous allons mettre un sujet succinct décrivant notre chaine.
Dans notre cas, ce sujet fera office de sujet au mail que nous expédierons.
Nous allons donc être précis en un minimum de mots pour que le destinataire de l'email puisse facilement deviner le contenu de celui-ci.

[[fichier:Rasp-Node-Red-picam-mail-06.png]]

==== Repeat ====

Nous allons ensuite choisir l'intervalle de déclenchement de notre action, sachant que nous avons le choix entre:

* '''none''' : pas de déclenchement périodique programmé
* '''interval''' : nous fixons un temps de déclenchement à partir du lancement du programme, l'action se réalisera à chaque fois que ce temps sera écoulé de manière répétée jusqu'à l'interruption manuelle du programme
* '''interval between times''' : nous fixons ici le déclenchement par interval, mais nous fixons aussi une fourchette d'heures et des jours pendant lesquels nous exécutons cet interval
* '''at a specific time''' : nous fixons une heure d'exécution, et un ou plusieurs jours d'exécution. Dans ce cas l'action n'est pas répétée en continu mais éxécutée une seule fois par jour à l'heure programmée

Dans notre exemple, nous allons fixer un intervalle de 15 secondes pour commencer. Nous pourrons ensuite augmenter cette valeur pour éviter de recevoir trop d'emails avec des photos :D

[[fichier:Rasp-Node-Red-picam-mail-07.png]]

La case '''"inject once at start"''' permet de ne pas attendre le premier cycle avant d'exécuter une première fois l'action. Elle se lancera dès le lancement du programme, puis périodiquement selon les cycles déterminés par l'intervalle.

[[fichier:Rasp-Node-Red-picam-mail-08.png]]

==== Name ====

Le champs Name va déterminer le nom que portera le bloc dans l'espace de travail et dans les logs (si nous créons des blocs de log ensuite pour contrôler des étapes).
Il est important de bien établir ce nom de manière explicite, car le nom des blocs permettra de comprendre et retrouver facilement la logique du schéma construit, même si l'on a pas consulté celui-ci pendant une longue période.

[[fichier:Rasp-Node-Red-picam-mail-09.png]]

=== Capture d'une image depuis la PiCam ===

Nous allons aller à l'essentiel en ce qui concerne la capture photo en utilisant une commande simple pour prendre un cliché et renvoyer celui-ci dans le flux NodeRED grâce à un bloc permettant d'exécuter des commandes bash.

{{ambox | text = Vous trouverez un TUTO détaillé sur la PiCam vous permettant de prendre la main, ou de la paramétrer si vous n'avez pas encore utilisé celle-ci auparavant: ....___TUTO___...}}

Nous allons tout d'abord cliquer sur le bloc "Exec" dans la section "Advanced" de la colonne de gauche et glisser l'élément dans la zone de travail.

[[fichier:Rasp-Node-Red-picam-mail-10.png]]

Ensuite, cliquer sur le bloc nouvellement créé et configurer celui-ci.

[[fichier:Rasp-Node-Red-picam-mail-11.png]]

Le menu suivant s'affichera, et nous pourrons configurer le bloc "Exec" nouvellement créé.

==== Command ====

Nous allons y ajouter la commande à exécuter pour prendre une photo avec la caméra du Raspberry Pi et la stocker dans un fichier jpg dans le dossier /tmp/ de linux.

<syntaxhighlight lang="python">
raspistill -o /tmp/cam.jpg -w 640 -h 480
</syntaxhighlight>

Nous prenons soin de limiter la hauteur et la largeur de l'image afin de réduire son poids pour l'envoi par email.

[[fichier:Rasp-Node-Red-picam-mail-12.png]]

==== +Append ====

Ensuite, nous allons décocher la case "msg.payload" si elle est cochée par défaut.

[[fichier:Rasp-Node-Red-picam-mail-13.png]]

==== Extra input parameters et Timeout ====

Nous n'aurons pas besoin de compléter ces champs pour notre projet.

Si vous cochez le champ "Use spawn() instead of exec()?", votre commande sera réalisée sous forme d'un processus résident et continuera de s'exécuter jusqu'à ce qu'elle se termine par elle-même (sauf si elle ne se termine jamais).
Cette solution implique que le programme n'attendra pas que cette commande soit réalisée pour passer aux étapes suivantes.
Si la suite de l'exécution de votre flux est susceptible d'utiliser le résultat de cette commande, nous vous déconseillons d'utiliser cette option sous peine de provoquer des erreurs à la suite du traitement du flux.

Le champ "Timeout" permet de définir un temps d'attente maximum avant de mettre un terme à l'exécution de la commande.
Cela permet de débloquer la situation si la commande exécutée prends un temps anormalement long à s'exécuter.

==== Name ====

Nous allons ensuite compléter le champs nom, celui-ci sera utilisé pour nommer le bloc dans le "schéma", mais aussi de nommer les logs comme pour le bloc "Exec".

[[fichier:Rasp-Node-Red-picam-mail-14.png]]

=== Encodage de l'image en base64 ===

Nous allons convertir la photo prise juste avant en utilisant une commande de conversion en base64.
Cela facilitera son injection dans un template HTML que nous allons créer ensuite pour construire un email.

Nous allons tout d'abord cliquer sur le bloc "Exec" dans la section "Advanced" de la colonne de gauche et glisser l'élément dans la zone de travail.

[[fichier:Rasp-Node-Red-picam-mail-10.png]]

Ensuite, cliquer sur le bloc nouvellement créé et configurer celui-ci.

[[fichier:Rasp-Node-Red-picam-mail-11.png]]

Le menu suivant s'affichera, et nous pourrons configurer le bloc "Exec" nouvellement créé.

[[fichier:Rasp-Node-Red-picam-mail-15.png]]

==== Command ====

Nous allons y ajouter la commande à exécuter pour encoder en base 64 la photo prise précédemment avec la caméra du Raspberry Pi.

<syntaxhighlight lang="python">
base64 -i "/tmp/cam.jpg"
</syntaxhighlight>

[[fichier:Rasp-Node-Red-picam-mail-16.png]]

==== +Append ====

Ensuite, nous allons cocher la case "msg.payload" si elle n'est pas cochée par défaut pour que le résultat soit directement renvoyé par cette commande dans le "PayLoad" du flux.

[[fichier:Rasp-Node-Red-picam-mail-17.png]]

==== Extra input parameters et Timeout ====

Nous n'aurons pas besoin de compléter ces champs pour notre projet.

Si vous cochez le champ "Use spawn() instead of exec()?", votre commande sera réalisée sous forme d'un processus résident et continuera de s'exécuter jusqu'à ce qu'elle se termine par elle-même (sauf si elle ne se termine jamais).
Cette solution implique que le programme n'attendra pas que cette commande soit réalisée pour passer aux étapes suivantes.
Si la suite de l'exécution de votre flux est susceptible d'utiliser le résultat de cette commande, nous vous déconseillons d'utiliser cette option sous peine de provoquer des erreurs à la suite du traitement du flux.

[[fichier:Rasp-Node-Red-picam-mail-18.png]]

Le champ "Timeout" permet de définir un temps d'attente maximum avant de mettre un terme à l'exécution de la commande.
Cela permet de débloquer la situation si la commande exécutée prends un temps anormalement long à s'exécuter.

[[fichier:Rasp-Node-Red-picam-mail-19.png]]

==== Name ====

Nous allons ensuite compléter le champs nom, celui-ci sera utilisé pour nommer le bloc dans le "schéma", mais aussi de nommer les logs comme pour le bloc "Exec".

[[fichier:Rasp-Node-Red-picam-mail-20.png]]

=== Création d'un email au format HTML ===

Nous allons maintenant créer un template d'email au format HTML afin de mettre en forme le message que nous enverrons ensuite.
Nous allons pour cela utiliser un bloc "Template".

[[fichier:Rasp-Node-Red-picam-mail-21.png]]

==== Name ====

Nous allons attribuer un nom au bloc afin de l'identifier plus facilement dans le flux.
Nous allons donc le nommer "Contenu du mail" puisque nous créons le contenu du mail que nous enverrons ensuite.

[[fichier:Rasp-Node-Red-picam-mail-22.png]]

==== Set property ====

La propriété que nous souhaitons créer dans le flux est le "PayLoad".
Ce PayLoad existe déjà, il contient pour le moment l'image au format "Base64" précédemment encodé.
Cela n'est pas un problème, après notre noeud (notre bloc), le PayLoad sera intégralement remplacé par le template que nous sommes en train de créer.

[[fichier:Rasp-Node-Red-picam-mail-23.png]]

==== Template ====

Dans ce template, nous allons créer une structure HTML de base minimum afin que la structure soit interprétée par la majorité des clients/webmail.
Vous pouvez la personnaliser à votre guise si vous avez les connaissances en HTML.

Voici la structure de base pour notre projet:

<syntaxhighlight lang="html">
<html>
<head>
<meta charset="utf8"/>
</head>
<body>
<h1>Projet Photo par email</h1>
<img src="data:image/jpg;base64,{{payload}}"/>
</body>
</html>
</syntaxhighlight>

Vous pourrez remarquer que nous intégrons l'image en appelant le PayLoad à 'intérieur du code HTML dans la balise <img>.
C'est le PayLoad créé précédemment par le bloc "Exec" qui est récupéré à ce moment précis.
Ce PayLoad est remplacé dans le flux par le PayLoad complet avec notre template dans le flux par notre bloc Template.

[[fichier:Rasp-Node-Red-picam-mail-24.png]]

=== Création d'un bloc (noeud) "Debug" ===

Nous allons ajouter la notion d'expéditeur dans le flux que nous avons créé à travers nos blocs (noeuds).
Pour rappel, actuellement nous avons deux propriétés avec des données dans notre flux.
Si nous voulons observer ce que nous avons créé jusque là, nous pouvons faire appel à un bloc "Debug".

==== Création du bloc "Debug" ====

Comme pour les blocs précédents, nous allons glisser/déposer un bloc débug dans l'espace de travail.

[[fichier:Rasp-Node-Red-picam-mail-25.png]]

Celui-ci s'appelle msg/payload par défaut

[[fichier:Rasp-Node-Red-picam-mail-26.png]]

Nous allons double-cliquer sur ce bloc pour le configurer.

[[fichier:Rasp-Node-Red-picam-mail-27.png]]

==== Output ====

Dans ce champs, nous allons choisir la partie du flux que nous souhaitons afficher, ou nous allons sélectionner le flux entier.

[[fichier:Rasp-Node-Red-picam-mail-28.png]]

Sélectionner le flux entier, nous affichera le flux complet incluant toutes ses propriétés.

[[fichier:Rasp-Node-Red-picam-mail-29.png]]

==== To =====

La propriété "To" nous permet de choisir ou nous souhaitons afficher les données que nous récupérons.
Soit nous les affichons uniquement dans l'onglet "Debug" à droite de l'espace de travail, soit nous l'affichons dans cet onglet mais aussi dans la console de NodeJS.
Dans notre cas, nous allons nous contenter d'afficher nos éléments dans l'onglet de "Debug" à droite de notre espace de travail.

[[fichier:Rasp-Node-Red-picam-mail-30.png]]

==== Name ====

Le champs Name nous servira à identifier quel bloc de "Debug" affiche les données en console ou dans l'onglet "Debug".
Il faut donc le nommer efficacement pour bien attacher et comprendre les données que nous récupérons, surtout si nous en plaçons plusieurs dans le flux.

[[fichier:Rasp-Node-Red-picam-mail-31.png]]

==== Exploitation et compréhension des données récupérées ====

Nous avons placé notre bloc "Debug" à la suite du flux en dernière position.

[[fichier:Rasp-Node-Red-picam-mail-32.png]]

Nous allons donc déployer le programme en cliquant sur "Deploy" en haut à droite de la page.

[[fichier:Rasp-Node-Red-picam-mail-33.png]]

Ensuite, nous allons exécuter manuellement le programme en cliquant sur le bouton se trouvant en début de chaîne:

[[fichier:Rasp-Node-Red-picam-mail-34.png]]

Nous allons ensuite afficher l'onglet "Debug" sur le coté droit de la page et analyser les données récupérées:

[[fichier:Rasp-Node-Red-picam-mail-35.png]]

==== Analyse des données récupérées dans l'onglet "Debug" ====

<syntaxhighlight lang="bash">
08/05/2017 à 12:54:31 node: FORMATAGE
MCHobby - Photo bureau : msg : Object
object
_msgid: "81efe35c.3208d"
topic: "MCHobby - Photo bureau"
payload: "<html>↵ <head>↵ <meta charset="utf8"/>↵ ↵ </head>↵ <body>↵ <h1>MCHobby - Photo bureau</h1>↵ <p>Cette photo est un instantané pris dans les bureaux de MCHobby.</p>↵
<img src="data:image/jpg;base64,/9j/4WP6x2.../>"
</syntaxhighlight>

Comme vous pourrez le constater, chaque élément du noeud est détaillé.
Les données sont cependant tronquées, le noeud "Debug" ne nous fourni pas la totalité du "PayLoad" mais nous avons déjà un bon aperçu des données qu'il contient.

* '''_msgid:''' est un Id unique de message
* '''topic:''' est le sujet du mail, nous l'avons déterminé dans le premier bloc
* '''payload:''' contient les données du message formatées par le template que nous avons créé et complété par l'image en base64.

{{tmbox | text = Les noeuds "Debug" sont pratiques. Ils nous permettent d'afficher une partie ou la totalité du flux tel qu'il est à l'endroit ou ils sont placés. Cela peut permettre d'identifier et de résoudre plus facilement des problèmes dans des opérations plus complexes et dans notre cas, cela nous permet de mieux comprendre comment fonctionne le noeud et comment les données sont transmises d'un bloc à l'autre.}}

=== Création d'un expéditeur ===

Nous avons construit petit à petit un message avec un sujet, mais il manque encore un détail: l'expéditeur de l'email que nous allons envoyer: le fameux "msg.from" que nous avons évoqué au début de tuto !

Si vous avez bien suivi les étapes précédentes du tuto, jusqu'au noeud "Debug" et à son résultat, vous comprendrez facilement la démarche ci après pour ajouter un expéditeur dans le flux.

Nous allons ajouter un nouveau noeud "Template" dans la zone de travail et double cliquer dessus pour afficher sa page de configuration:

[[fichier:Rasp-Node-Red-picam-mail-39.png]]

Nous allons ensuite sélectionner le type de propriété que nous souhaitons injecter dans le flux: '''"msg.from"'''

[[fichier:Rasp-Node-Red-picam-mail-40.png]]

Cette propriété étant une adresse email, nous allons choisir le type '''"plaintext"''' comme type de données.

[[fichier:Rasp-Node-Red-picam-mail-41.png]]

Nous allons enfin donner un nom explicite à notre bloc afin d'identifier facilement sa fonctionnalité parmi les autres blocs.

[[fichier:Rasp-Node-Red-picam-mail-42.png]]

=== Création du bloc d'envoi d'email ===

==== To : destinataire ====

Simplement, l'adresse email du destinataire du message.

[[fichier:Rasp-Node-Red-picam-mail-43.png]]

==== Server, port, secure connection ====

Dans ce champ, nous allons mettre un serveur SMTP (serveur email) pour permettre l'envoi de l'email. Dans la plupart des cas, le SMTP de votre FAI (fournisseur d'accès à internet) pourra servir d'intermédiaire.
Nous vous invitons à consulter les paramètres propres à votre fournisseur d'accès pour paramétrer ce bloc.

[[fichier:Rasp-Node-Red-picam-mail-44.png]]

==== UserID et Password ====

Ces champs resteront vides si votre FAI ne nécessite pas d'authentification pour envoyer des emails.
Si vous utilisez un autre fournisseur, tel que GMAIL par exemple, il faudra mettre votre adresse email et votre mot de passe pour vous identifier.

{{ambox-stop|text="Attention: votre compte gmail devra être configuré au préalable afin d'autoriser un "client email" à utiliser votre compte pour envoyer/recevoir des emails par ce biais. Nous vous invitons à consulter la documentation de Gmail pour en savoir plus."}}

[[fichier:Rasp-Node-Red-picam-mail-45.png]]

==== Name ====

Enfin, le champ "Name" qui vous permet de donner un nom au bloc d'envoi d'email.

[[fichier:Rasp-Node-Red-picam-mail-46.png]]

=== Déploiement et premiers tests ===

Afin de "lancer le programme" que nous venons de créer, il suffit de cliquer sur le bouton "Deploy" en haut à droite de la page.

==== Déploiement et débug ====

===== La photo ne se réalise pas =====

Si la photo ne se réalise pas, il faut commencer par vérifier la commande dans le bloc de prise de photo.
Nous vous invitons vivement à tester la commande directement dans le terminal afin de vous assurer que celle-ci soit d'une syntaxe correcte et ne rencontre pas de problème d'exécution.
Les problèmes d'exécution de commandes externes dans le bloc '''"command"''' peuvent amener à des blocages dans l'exécution et empêcher NodeRED de continuer à exécuter le '''"Schéma"'''.

===== La photo se réalise mais l'encodage en base64 bloque =====

Si le programme bloque à l'encodage, comme précédemment, nous vous invitons à vérifier votre commande en l'exécutant directement dans le terminal.
Vous pourrez identifier directement le problème et le résoudre le cas échéant.

===== L'encodage fonctionne, mais le PayLoad reste vide =====

N'auriez-vous pas oublié de cocher la case '''"+ Append : msg.payload"''' dans le bloc qui lance la commande de conversion en base64 ?

===== Mon email arrive vide =====

Retournez à l'étape de mise en forme du message afin de vérifier si vous n'avez pas omis un paramètre ou une fonctionnalité.

===== L'image ne s'affiche pas dans l'email reçu =====

Si l'image ne s'affiche pas, il faudrait vérifier si vous avez bien lié vos blocs sur la première sortie des blocs '''"Exec"'''.
Les deux autres sorties étant destinées à d'autres états d'exécution/erreur.

===== Le sujet de l'email est vide =====

Dans notre cas, le sujet est fixé dans le premier bloc dans le champ '''"Topic"'''.
Vous pouvez-donc ré-éditer ce bloc afin de vérifier si celui-ci n'est pas resté vide.

{{Rasp-Node-Red-TRAILER}}

Fichier:Rasp-Node-Red-picam-mail-45.png

2017-05-08T13:42:26Z

AntoineWrt :

Fichier:Rasp-Node-Red-picam-mail-44.png

2017-05-08T13:41:49Z

AntoineWrt :

Fichier:Rasp-Node-Red-picam-mail-43.png

2017-05-08T13:41:33Z

AntoineWrt :

Rasp-Node-Red-picam-mail

2017-05-08T13:41:23Z

AntoineWrt : /* Création du bloc d'envoi d'email */

Rasp-Node-Red-picam-mail

2017-05-08T13:40:57Z

AntoineWrt : /* UserID et Password */

{{Rasp-Node-Red-NAV}}

{{traduction}}

== PiCamRED - Envoi périodique de photos par email avec PiCam et NodeRED ==

[[fichier:Rasp-Node-Red-picam-mail-01.png|900px]]

=== Description du projet ===

Dans ce tutoriel, nous allons réaliser des photos à l'aide de la caméra du RaspBerry Pi 2/3 et envoyer ces clichés par email de manière périodique grâce à NodeRED.
Nous allons donc utiliser plusieurs blocs et décrire de manière détaillée le déroulement de chaque étape de la réalisation de ce projet.

Dans NodeRED, il est important de bien identifier la finalité de notre projet afin de connaître au préalable tous les éléments qu'il faudra créer et fournir à l'action finale (celle qui enverra un email).

=== Quels sont les besoins du noeud email ===

==== Composants nécessaires pour constituer un email ====

Un email est composé des éléments suivants:

* Un expéditeur
* Un destinataire
* Un sujet
* Le corps du message

Tous ces éléments vont donc devoir être préparés afin de pouvoir construire le message à envoyer par le noeud final.

Le noeud final aura aussi besoin d'un serveur SMTP (serveur d'envoi d'emails) et éventuellement de paramètres d'identification pour ce serveur d'envoi d'emails.

==== Détail des besoins du noeud email ====

La liste des éléments nécessaires s'affiche lorsque le bloc est dans la zone de travail (Schema).
Commençons donc par sélectionner le bloc email, et de le glisser dans la zone de travail.

Commençons par cliquer sur le bloc email et nous maintenons le clic pour le glisser à droite dans l'espace de travail.

(on choisit celui qui a son point de liaison à gauche, car nous voulons un bloc de sortie)

[[fichier:Rasp-Node-Red-picam-mail-36.png]]

Glissons le dans l'espace de travail, et cliquons un clic simple pour le sélectionner.

[[fichier:Rasp-Node-Red-picam-mail-37.png]]

Ensuite, dans la colonne à droite de cet espace de travail, nous cliquons sur info et nous pourrons découvrir les éléments nécessaires à la constitution d'un bloc email.

[[fichier:Rasp-Node-Red-picam-mail-38.png]]

===== Nous utiliserons les champs suivants =====

* '''msg.payload''' --> Ce champ contient le corps de l'email
* '''msg.topic''' --> Ce champ contient le sujet de l'email
* '''msg.from''' --> Ce champ contient l'email de l'expéditeur
* '''msg.to''' --> Ce champ contient l'email du destinataire

Les autres champs ne seront pas utilisés dans notre cas, mais vous pourrez constater que le bloc email est complet de part ses fonctionnalités et possibilités.

Les données de serveur et d'identification seront abordées en fin de tuto lors de la configuration finale du bloc.

Nous allons maintenant passer à la réalisation du flux en commençant par le début de celui-ci.

=== Création d'une action périodique ===

Dans la colonne de gauche de NodeRED, se trouvent une liste de blocs à utiliser pour réaliser vos projets. Ils sont classés par "types".

Ainsi nous retrouvons les "types" suivants:

* '''Input''' qui contient tous les blocs d'entrées
* '''Ouput''' qui contient tous les blocs de sortie
* '''Function''' qui contient des blocs de fonctions javascript etc...
* '''Social''' qui sont des blocs d'entrée ou sorties depuis ou vers les réseaux sociaux
* '''Storage''' qui sont des fonctions de lecture ou d'écriture de fichiers
* '''Analysis''' ->> Sentiment interprète du texte et détermine un score sur base d'un dictionnaire anglais, renvoie le texte avec ce score de -5 à +5, déterminant ainsi l'émotion susceptible d'être procuré par ce texte
* '''Advanced''' possède des outils permettant de détecter des changements dans des fichiers ou dossiers, de lire des flux RSS ou encore EXEC qui permet d'exécuter directement des commandes sous linux !
* '''Raspberry Pi''' contient des outils pour piloter/lire le GPIO du raspberry Pi
* '''Network''' qui contient un outil réseau de Ping

Nous allons créer une action périodique, c'est à dire paramétrer un bloc '''"INJECT"''' de manière à déclencher régulièrement une chaine d'actions que nous allons accrocher à la suite les unes après les autres.
Nous allons donc cliquer sur le bloc '''"Inject"''' dans la liste "Input" et maintenir ce clic pour le déplacer vers la zone de travail.

[[fichier:Rasp-Node-Red-picam-mail-02.png]]

Nous obtiendrons donc une nouvelle instance "inject" qui portera le nom '''"Timestamp"''' (ce nom est attribué par défaut par NodeRED) comme dans la capture ci-dessous

[[fichier:Rasp-Node-Red-picam-mail-03.png]]

Nous allons maintenant double-cliquer sur celle-ci fin de l'éditer pour voir apparaitre le menu ci-dessous

[[fichier:Rasp-Node-Red-picam-mail-04.png]]

Il va falloir configurer ce bloc, mais avant tout voici une explication de celui-ci:

==== Payload ====

Le champs PayLoad est en fait le champ de données qui sera suivi d'un noeud à l'autre jusque à la fin de la chaine.
Dans ce module '''"inject"''', nous allons donc déterminer quel type de données contiendra le '''"PayLoad"''' jusqu'à la fin de la chaine que l'on va réaliser.

Dans notre cas, nous souhaitons construire un email, donc du contenu textuel, nous allons donc choisir '''"String"''' ce qui correspond à une chaine de caractères (du texte).

[[fichier:Rasp-Node-Red-picam-mail-05.png]]

==== Topic ====

Le champs "Topic" est un champs de texte dans lequel nous allons mettre un sujet succinct décrivant notre chaine.
Dans notre cas, ce sujet fera office de sujet au mail que nous expédierons.
Nous allons donc être précis en un minimum de mots pour que le destinataire de l'email puisse facilement deviner le contenu de celui-ci.

[[fichier:Rasp-Node-Red-picam-mail-06.png]]

==== Repeat ====

Nous allons ensuite choisir l'intervalle de déclenchement de notre action, sachant que nous avons le choix entre:

* '''none''' : pas de déclenchement périodique programmé
* '''interval''' : nous fixons un temps de déclenchement à partir du lancement du programme, l'action se réalisera à chaque fois que ce temps sera écoulé de manière répétée jusqu'à l'interruption manuelle du programme
* '''interval between times''' : nous fixons ici le déclenchement par interval, mais nous fixons aussi une fourchette d'heures et des jours pendant lesquels nous exécutons cet interval
* '''at a specific time''' : nous fixons une heure d'exécution, et un ou plusieurs jours d'exécution. Dans ce cas l'action n'est pas répétée en continu mais éxécutée une seule fois par jour à l'heure programmée

Dans notre exemple, nous allons fixer un intervalle de 15 secondes pour commencer. Nous pourrons ensuite augmenter cette valeur pour éviter de recevoir trop d'emails avec des photos :D

[[fichier:Rasp-Node-Red-picam-mail-07.png]]

La case '''"inject once at start"''' permet de ne pas attendre le premier cycle avant d'exécuter une première fois l'action. Elle se lancera dès le lancement du programme, puis périodiquement selon les cycles déterminés par l'intervalle.

[[fichier:Rasp-Node-Red-picam-mail-08.png]]

==== Name ====

Le champs Name va déterminer le nom que portera le bloc dans l'espace de travail et dans les logs (si nous créons des blocs de log ensuite pour contrôler des étapes).
Il est important de bien établir ce nom de manière explicite, car le nom des blocs permettra de comprendre et retrouver facilement la logique du schéma construit, même si l'on a pas consulté celui-ci pendant une longue période.

[[fichier:Rasp-Node-Red-picam-mail-09.png]]

=== Capture d'une image depuis la PiCam ===

Nous allons aller à l'essentiel en ce qui concerne la capture photo en utilisant une commande simple pour prendre un cliché et renvoyer celui-ci dans le flux NodeRED grâce à un bloc permettant d'exécuter des commandes bash.

{{ambox | text = Vous trouverez un TUTO détaillé sur la PiCam vous permettant de prendre la main, ou de la paramétrer si vous n'avez pas encore utilisé celle-ci auparavant: ....___TUTO___...}}

Nous allons tout d'abord cliquer sur le bloc "Exec" dans la section "Advanced" de la colonne de gauche et glisser l'élément dans la zone de travail.

[[fichier:Rasp-Node-Red-picam-mail-10.png]]

Ensuite, cliquer sur le bloc nouvellement créé et configurer celui-ci.

[[fichier:Rasp-Node-Red-picam-mail-11.png]]

Le menu suivant s'affichera, et nous pourrons configurer le bloc "Exec" nouvellement créé.

==== Command ====

Nous allons y ajouter la commande à exécuter pour prendre une photo avec la caméra du Raspberry Pi et la stocker dans un fichier jpg dans le dossier /tmp/ de linux.

<syntaxhighlight lang="python">
raspistill -o /tmp/cam.jpg -w 640 -h 480
</syntaxhighlight>

Nous prenons soin de limiter la hauteur et la largeur de l'image afin de réduire son poids pour l'envoi par email.

[[fichier:Rasp-Node-Red-picam-mail-12.png]]

==== +Append ====

Ensuite, nous allons décocher la case "msg.payload" si elle est cochée par défaut.

[[fichier:Rasp-Node-Red-picam-mail-13.png]]

==== Extra input parameters et Timeout ====

Nous n'aurons pas besoin de compléter ces champs pour notre projet.

Si vous cochez le champ "Use spawn() instead of exec()?", votre commande sera réalisée sous forme d'un processus résident et continuera de s'exécuter jusqu'à ce qu'elle se termine par elle-même (sauf si elle ne se termine jamais).
Cette solution implique que le programme n'attendra pas que cette commande soit réalisée pour passer aux étapes suivantes.
Si la suite de l'exécution de votre flux est susceptible d'utiliser le résultat de cette commande, nous vous déconseillons d'utiliser cette option sous peine de provoquer des erreurs à la suite du traitement du flux.

Le champ "Timeout" permet de définir un temps d'attente maximum avant de mettre un terme à l'exécution de la commande.
Cela permet de débloquer la situation si la commande exécutée prends un temps anormalement long à s'exécuter.

==== Name ====

Nous allons ensuite compléter le champs nom, celui-ci sera utilisé pour nommer le bloc dans le "schéma", mais aussi de nommer les logs comme pour le bloc "Exec".

[[fichier:Rasp-Node-Red-picam-mail-14.png]]

=== Encodage de l'image en base64 ===

Nous allons convertir la photo prise juste avant en utilisant une commande de conversion en base64.
Cela facilitera son injection dans un template HTML que nous allons créer ensuite pour construire un email.

Nous allons tout d'abord cliquer sur le bloc "Exec" dans la section "Advanced" de la colonne de gauche et glisser l'élément dans la zone de travail.

[[fichier:Rasp-Node-Red-picam-mail-10.png]]

Ensuite, cliquer sur le bloc nouvellement créé et configurer celui-ci.

[[fichier:Rasp-Node-Red-picam-mail-11.png]]

Le menu suivant s'affichera, et nous pourrons configurer le bloc "Exec" nouvellement créé.

[[fichier:Rasp-Node-Red-picam-mail-15.png]]

==== Command ====

Nous allons y ajouter la commande à exécuter pour encoder en base 64 la photo prise précédemment avec la caméra du Raspberry Pi.

<syntaxhighlight lang="python">
base64 -i "/tmp/cam.jpg"
</syntaxhighlight>

[[fichier:Rasp-Node-Red-picam-mail-16.png]]

==== +Append ====

Ensuite, nous allons cocher la case "msg.payload" si elle n'est pas cochée par défaut pour que le résultat soit directement renvoyé par cette commande dans le "PayLoad" du flux.

[[fichier:Rasp-Node-Red-picam-mail-17.png]]

==== Extra input parameters et Timeout ====

Nous n'aurons pas besoin de compléter ces champs pour notre projet.

Si vous cochez le champ "Use spawn() instead of exec()?", votre commande sera réalisée sous forme d'un processus résident et continuera de s'exécuter jusqu'à ce qu'elle se termine par elle-même (sauf si elle ne se termine jamais).
Cette solution implique que le programme n'attendra pas que cette commande soit réalisée pour passer aux étapes suivantes.
Si la suite de l'exécution de votre flux est susceptible d'utiliser le résultat de cette commande, nous vous déconseillons d'utiliser cette option sous peine de provoquer des erreurs à la suite du traitement du flux.

[[fichier:Rasp-Node-Red-picam-mail-18.png]]

Le champ "Timeout" permet de définir un temps d'attente maximum avant de mettre un terme à l'exécution de la commande.
Cela permet de débloquer la situation si la commande exécutée prends un temps anormalement long à s'exécuter.

[[fichier:Rasp-Node-Red-picam-mail-19.png]]

==== Name ====

Nous allons ensuite compléter le champs nom, celui-ci sera utilisé pour nommer le bloc dans le "schéma", mais aussi de nommer les logs comme pour le bloc "Exec".

[[fichier:Rasp-Node-Red-picam-mail-20.png]]

=== Création d'un email au format HTML ===

Nous allons maintenant créer un template d'email au format HTML afin de mettre en forme le message que nous enverrons ensuite.
Nous allons pour cela utiliser un bloc "Template".

[[fichier:Rasp-Node-Red-picam-mail-21.png]]

==== Name ====

Nous allons attribuer un nom au bloc afin de l'identifier plus facilement dans le flux.
Nous allons donc le nommer "Contenu du mail" puisque nous créons le contenu du mail que nous enverrons ensuite.

[[fichier:Rasp-Node-Red-picam-mail-22.png]]

==== Set property ====

La propriété que nous souhaitons créer dans le flux est le "PayLoad".
Ce PayLoad existe déjà, il contient pour le moment l'image au format "Base64" précédemment encodé.
Cela n'est pas un problème, après notre noeud (notre bloc), le PayLoad sera intégralement remplacé par le template que nous sommes en train de créer.

[[fichier:Rasp-Node-Red-picam-mail-23.png]]

==== Template ====

Dans ce template, nous allons créer une structure HTML de base minimum afin que la structure soit interprétée par la majorité des clients/webmail.
Vous pouvez la personnaliser à votre guise si vous avez les connaissances en HTML.

Voici la structure de base pour notre projet:

<syntaxhighlight lang="html">
<html>
<head>
<meta charset="utf8"/>
</head>
<body>
<h1>Projet Photo par email</h1>
<img src="data:image/jpg;base64,{{payload}}"/>
</body>
</html>
</syntaxhighlight>

Vous pourrez remarquer que nous intégrons l'image en appelant le PayLoad à 'intérieur du code HTML dans la balise <img>.
C'est le PayLoad créé précédemment par le bloc "Exec" qui est récupéré à ce moment précis.
Ce PayLoad est remplacé dans le flux par le PayLoad complet avec notre template dans le flux par notre bloc Template.

[[fichier:Rasp-Node-Red-picam-mail-24.png]]

=== Création d'un bloc (noeud) "Debug" ===

Nous allons ajouter la notion d'expéditeur dans le flux que nous avons créé à travers nos blocs (noeuds).
Pour rappel, actuellement nous avons deux propriétés avec des données dans notre flux.
Si nous voulons observer ce que nous avons créé jusque là, nous pouvons faire appel à un bloc "Debug".

==== Création du bloc "Debug" ====

Comme pour les blocs précédents, nous allons glisser/déposer un bloc débug dans l'espace de travail.

[[fichier:Rasp-Node-Red-picam-mail-25.png]]

Celui-ci s'appelle msg/payload par défaut

[[fichier:Rasp-Node-Red-picam-mail-26.png]]

Nous allons double-cliquer sur ce bloc pour le configurer.

[[fichier:Rasp-Node-Red-picam-mail-27.png]]

==== Output ====

Dans ce champs, nous allons choisir la partie du flux que nous souhaitons afficher, ou nous allons sélectionner le flux entier.

[[fichier:Rasp-Node-Red-picam-mail-28.png]]

Sélectionner le flux entier, nous affichera le flux complet incluant toutes ses propriétés.

[[fichier:Rasp-Node-Red-picam-mail-29.png]]

==== To =====

La propriété "To" nous permet de choisir ou nous souhaitons afficher les données que nous récupérons.
Soit nous les affichons uniquement dans l'onglet "Debug" à droite de l'espace de travail, soit nous l'affichons dans cet onglet mais aussi dans la console de NodeJS.
Dans notre cas, nous allons nous contenter d'afficher nos éléments dans l'onglet de "Debug" à droite de notre espace de travail.

[[fichier:Rasp-Node-Red-picam-mail-30.png]]

==== Name ====

Le champs Name nous servira à identifier quel bloc de "Debug" affiche les données en console ou dans l'onglet "Debug".
Il faut donc le nommer efficacement pour bien attacher et comprendre les données que nous récupérons, surtout si nous en plaçons plusieurs dans le flux.

[[fichier:Rasp-Node-Red-picam-mail-31.png]]

==== Exploitation et compréhension des données récupérées ====

Nous avons placé notre bloc "Debug" à la suite du flux en dernière position.

[[fichier:Rasp-Node-Red-picam-mail-32.png]]

Nous allons donc déployer le programme en cliquant sur "Deploy" en haut à droite de la page.

[[fichier:Rasp-Node-Red-picam-mail-33.png]]

Ensuite, nous allons exécuter manuellement le programme en cliquant sur le bouton se trouvant en début de chaîne:

[[fichier:Rasp-Node-Red-picam-mail-34.png]]

Nous allons ensuite afficher l'onglet "Debug" sur le coté droit de la page et analyser les données récupérées:

[[fichier:Rasp-Node-Red-picam-mail-35.png]]

==== Analyse des données récupérées dans l'onglet "Debug" ====

<syntaxhighlight lang="bash">
08/05/2017 à 12:54:31 node: FORMATAGE
MCHobby - Photo bureau : msg : Object
object
_msgid: "81efe35c.3208d"
topic: "MCHobby - Photo bureau"
payload: "<html>↵ <head>↵ <meta charset="utf8"/>↵ ↵ </head>↵ <body>↵ <h1>MCHobby - Photo bureau</h1>↵ <p>Cette photo est un instantané pris dans les bureaux de MCHobby.</p>↵
<img src="data:image/jpg;base64,/9j/4WP6x2.../>"
</syntaxhighlight>

Comme vous pourrez le constater, chaque élément du noeud est détaillé.
Les données sont cependant tronquées, le noeud "Debug" ne nous fourni pas la totalité du "PayLoad" mais nous avons déjà un bon aperçu des données qu'il contient.

* '''_msgid:''' est un Id unique de message
* '''topic:''' est le sujet du mail, nous l'avons déterminé dans le premier bloc
* '''payload:''' contient les données du message formatées par le template que nous avons créé et complété par l'image en base64.

{{tmbox | text = Les noeuds "Debug" sont pratiques. Ils nous permettent d'afficher une partie ou la totalité du flux tel qu'il est à l'endroit ou ils sont placés. Cela peut permettre d'identifier et de résoudre plus facilement des problèmes dans des opérations plus complexes et dans notre cas, cela nous permet de mieux comprendre comment fonctionne le noeud et comment les données sont transmises d'un bloc à l'autre.}}

=== Création d'un expéditeur ===

Nous avons construit petit à petit un message avec un sujet, mais il manque encore un détail: l'expéditeur de l'email que nous allons envoyer: le fameux "msg.from" que nous avons évoqué au début de tuto !

Si vous avez bien suivi les étapes précédentes du tuto, jusqu'au noeud "Debug" et à son résultat, vous comprendrez facilement la démarche ci après pour ajouter un expéditeur dans le flux.

Nous allons ajouter un nouveau noeud "Template" dans la zone de travail et double cliquer dessus pour afficher sa page de configuration:

[[fichier:Rasp-Node-Red-picam-mail-39.png]]

Nous allons ensuite sélectionner le type de propriété que nous souhaitons injecter dans le flux: '''"msg.from"'''

[[fichier:Rasp-Node-Red-picam-mail-40.png]]

Cette propriété étant une adresse email, nous allons choisir le type '''"plaintext"''' comme type de données.

[[fichier:Rasp-Node-Red-picam-mail-41.png]]

Nous allons enfin donner un nom explicite à notre bloc afin d'identifier facilement sa fonctionnalité parmi les autres blocs.

[[fichier:Rasp-Node-Red-picam-mail-42.png]]

=== Création du bloc d'envoi d'email ===

==== To : destinataire ====

Simplement, l'adresse email du destinataire du message.

[[fichier:Rasp-Node-Red-picam-mail-43.png]]

==== Server, port, secure connection ====

Dans ce champ, nous allons mettre un serveur SMTP (serveur email) pour permettre l'envoi de l'email. Dans la plupart des cas, le SMTP de votre FAI (fournisseur d'accès à internet) pourra servir d'intermédiaire.
Nous vous invitons à consulter les paramètres propres à votre fournisseur d'accès pour paramétrer ce bloc.

[[fichier:Rasp-Node-Red-picam-mail-43.png]]

==== UserID et Password ====

Ces champs resteront vides si votre FAI ne nécessite pas d'authentification pour envoyer des emails.
Si vous utilisez un autre fournisseur, tel que GMAIL par exemple, il faudra mettre votre adresse email et votre mot de passe pour vous identifier.

{{ambox-stop|text="Attention: votre compte gmail devra être configuré au préalable afin d'autoriser un "client email" à utiliser votre compte pour envoyer/recevoir des emails par ce biais. Nous vous invitons à consulter la documentation de Gmail pour en savoir plus."}}

{{Rasp-Node-Red-TRAILER}}

Rasp-Node-Red-picam-mail

2017-05-08T13:40:11Z

AntoineWrt : /* UserID et Password */

{{Rasp-Node-Red-NAV}}

{{traduction}}

== PiCamRED - Envoi périodique de photos par email avec PiCam et NodeRED ==

[[fichier:Rasp-Node-Red-picam-mail-01.png|900px]]

=== Description du projet ===

Dans ce tutoriel, nous allons réaliser des photos à l'aide de la caméra du RaspBerry Pi 2/3 et envoyer ces clichés par email de manière périodique grâce à NodeRED.
Nous allons donc utiliser plusieurs blocs et décrire de manière détaillée le déroulement de chaque étape de la réalisation de ce projet.

Dans NodeRED, il est important de bien identifier la finalité de notre projet afin de connaître au préalable tous les éléments qu'il faudra créer et fournir à l'action finale (celle qui enverra un email).

=== Quels sont les besoins du noeud email ===

==== Composants nécessaires pour constituer un email ====

Un email est composé des éléments suivants:

* Un expéditeur
* Un destinataire
* Un sujet
* Le corps du message

Tous ces éléments vont donc devoir être préparés afin de pouvoir construire le message à envoyer par le noeud final.

Le noeud final aura aussi besoin d'un serveur SMTP (serveur d'envoi d'emails) et éventuellement de paramètres d'identification pour ce serveur d'envoi d'emails.

==== Détail des besoins du noeud email ====

La liste des éléments nécessaires s'affiche lorsque le bloc est dans la zone de travail (Schema).
Commençons donc par sélectionner le bloc email, et de le glisser dans la zone de travail.

Commençons par cliquer sur le bloc email et nous maintenons le clic pour le glisser à droite dans l'espace de travail.

(on choisit celui qui a son point de liaison à gauche, car nous voulons un bloc de sortie)

[[fichier:Rasp-Node-Red-picam-mail-36.png]]

Glissons le dans l'espace de travail, et cliquons un clic simple pour le sélectionner.

[[fichier:Rasp-Node-Red-picam-mail-37.png]]

Ensuite, dans la colonne à droite de cet espace de travail, nous cliquons sur info et nous pourrons découvrir les éléments nécessaires à la constitution d'un bloc email.

[[fichier:Rasp-Node-Red-picam-mail-38.png]]

===== Nous utiliserons les champs suivants =====

* '''msg.payload''' --> Ce champ contient le corps de l'email
* '''msg.topic''' --> Ce champ contient le sujet de l'email
* '''msg.from''' --> Ce champ contient l'email de l'expéditeur
* '''msg.to''' --> Ce champ contient l'email du destinataire

Les autres champs ne seront pas utilisés dans notre cas, mais vous pourrez constater que le bloc email est complet de part ses fonctionnalités et possibilités.

Les données de serveur et d'identification seront abordées en fin de tuto lors de la configuration finale du bloc.

Nous allons maintenant passer à la réalisation du flux en commençant par le début de celui-ci.

=== Création d'une action périodique ===

Dans la colonne de gauche de NodeRED, se trouvent une liste de blocs à utiliser pour réaliser vos projets. Ils sont classés par "types".

Ainsi nous retrouvons les "types" suivants:

* '''Input''' qui contient tous les blocs d'entrées
* '''Ouput''' qui contient tous les blocs de sortie
* '''Function''' qui contient des blocs de fonctions javascript etc...
* '''Social''' qui sont des blocs d'entrée ou sorties depuis ou vers les réseaux sociaux
* '''Storage''' qui sont des fonctions de lecture ou d'écriture de fichiers
* '''Analysis''' ->> Sentiment interprète du texte et détermine un score sur base d'un dictionnaire anglais, renvoie le texte avec ce score de -5 à +5, déterminant ainsi l'émotion susceptible d'être procuré par ce texte
* '''Advanced''' possède des outils permettant de détecter des changements dans des fichiers ou dossiers, de lire des flux RSS ou encore EXEC qui permet d'exécuter directement des commandes sous linux !
* '''Raspberry Pi''' contient des outils pour piloter/lire le GPIO du raspberry Pi
* '''Network''' qui contient un outil réseau de Ping

Nous allons créer une action périodique, c'est à dire paramétrer un bloc '''"INJECT"''' de manière à déclencher régulièrement une chaine d'actions que nous allons accrocher à la suite les unes après les autres.
Nous allons donc cliquer sur le bloc '''"Inject"''' dans la liste "Input" et maintenir ce clic pour le déplacer vers la zone de travail.

[[fichier:Rasp-Node-Red-picam-mail-02.png]]

Nous obtiendrons donc une nouvelle instance "inject" qui portera le nom '''"Timestamp"''' (ce nom est attribué par défaut par NodeRED) comme dans la capture ci-dessous

[[fichier:Rasp-Node-Red-picam-mail-03.png]]

Nous allons maintenant double-cliquer sur celle-ci fin de l'éditer pour voir apparaitre le menu ci-dessous

[[fichier:Rasp-Node-Red-picam-mail-04.png]]

Il va falloir configurer ce bloc, mais avant tout voici une explication de celui-ci:

==== Payload ====

Le champs PayLoad est en fait le champ de données qui sera suivi d'un noeud à l'autre jusque à la fin de la chaine.
Dans ce module '''"inject"''', nous allons donc déterminer quel type de données contiendra le '''"PayLoad"''' jusqu'à la fin de la chaine que l'on va réaliser.

Dans notre cas, nous souhaitons construire un email, donc du contenu textuel, nous allons donc choisir '''"String"''' ce qui correspond à une chaine de caractères (du texte).

[[fichier:Rasp-Node-Red-picam-mail-05.png]]

==== Topic ====

Le champs "Topic" est un champs de texte dans lequel nous allons mettre un sujet succinct décrivant notre chaine.
Dans notre cas, ce sujet fera office de sujet au mail que nous expédierons.
Nous allons donc être précis en un minimum de mots pour que le destinataire de l'email puisse facilement deviner le contenu de celui-ci.

[[fichier:Rasp-Node-Red-picam-mail-06.png]]

==== Repeat ====

Nous allons ensuite choisir l'intervalle de déclenchement de notre action, sachant que nous avons le choix entre:

* '''none''' : pas de déclenchement périodique programmé
* '''interval''' : nous fixons un temps de déclenchement à partir du lancement du programme, l'action se réalisera à chaque fois que ce temps sera écoulé de manière répétée jusqu'à l'interruption manuelle du programme
* '''interval between times''' : nous fixons ici le déclenchement par interval, mais nous fixons aussi une fourchette d'heures et des jours pendant lesquels nous exécutons cet interval
* '''at a specific time''' : nous fixons une heure d'exécution, et un ou plusieurs jours d'exécution. Dans ce cas l'action n'est pas répétée en continu mais éxécutée une seule fois par jour à l'heure programmée

Dans notre exemple, nous allons fixer un intervalle de 15 secondes pour commencer. Nous pourrons ensuite augmenter cette valeur pour éviter de recevoir trop d'emails avec des photos :D

[[fichier:Rasp-Node-Red-picam-mail-07.png]]

La case '''"inject once at start"''' permet de ne pas attendre le premier cycle avant d'exécuter une première fois l'action. Elle se lancera dès le lancement du programme, puis périodiquement selon les cycles déterminés par l'intervalle.

[[fichier:Rasp-Node-Red-picam-mail-08.png]]

==== Name ====

Le champs Name va déterminer le nom que portera le bloc dans l'espace de travail et dans les logs (si nous créons des blocs de log ensuite pour contrôler des étapes).
Il est important de bien établir ce nom de manière explicite, car le nom des blocs permettra de comprendre et retrouver facilement la logique du schéma construit, même si l'on a pas consulté celui-ci pendant une longue période.

[[fichier:Rasp-Node-Red-picam-mail-09.png]]

=== Capture d'une image depuis la PiCam ===

Nous allons aller à l'essentiel en ce qui concerne la capture photo en utilisant une commande simple pour prendre un cliché et renvoyer celui-ci dans le flux NodeRED grâce à un bloc permettant d'exécuter des commandes bash.

{{ambox | text = Vous trouverez un TUTO détaillé sur la PiCam vous permettant de prendre la main, ou de la paramétrer si vous n'avez pas encore utilisé celle-ci auparavant: ....___TUTO___...}}

Nous allons tout d'abord cliquer sur le bloc "Exec" dans la section "Advanced" de la colonne de gauche et glisser l'élément dans la zone de travail.

[[fichier:Rasp-Node-Red-picam-mail-10.png]]

Ensuite, cliquer sur le bloc nouvellement créé et configurer celui-ci.

[[fichier:Rasp-Node-Red-picam-mail-11.png]]

Le menu suivant s'affichera, et nous pourrons configurer le bloc "Exec" nouvellement créé.

==== Command ====

Nous allons y ajouter la commande à exécuter pour prendre une photo avec la caméra du Raspberry Pi et la stocker dans un fichier jpg dans le dossier /tmp/ de linux.

<syntaxhighlight lang="python">
raspistill -o /tmp/cam.jpg -w 640 -h 480
</syntaxhighlight>

Nous prenons soin de limiter la hauteur et la largeur de l'image afin de réduire son poids pour l'envoi par email.

[[fichier:Rasp-Node-Red-picam-mail-12.png]]

==== +Append ====

Ensuite, nous allons décocher la case "msg.payload" si elle est cochée par défaut.

[[fichier:Rasp-Node-Red-picam-mail-13.png]]

==== Extra input parameters et Timeout ====

Nous n'aurons pas besoin de compléter ces champs pour notre projet.

Si vous cochez le champ "Use spawn() instead of exec()?", votre commande sera réalisée sous forme d'un processus résident et continuera de s'exécuter jusqu'à ce qu'elle se termine par elle-même (sauf si elle ne se termine jamais).
Cette solution implique que le programme n'attendra pas que cette commande soit réalisée pour passer aux étapes suivantes.
Si la suite de l'exécution de votre flux est susceptible d'utiliser le résultat de cette commande, nous vous déconseillons d'utiliser cette option sous peine de provoquer des erreurs à la suite du traitement du flux.

Le champ "Timeout" permet de définir un temps d'attente maximum avant de mettre un terme à l'exécution de la commande.
Cela permet de débloquer la situation si la commande exécutée prends un temps anormalement long à s'exécuter.

==== Name ====

Nous allons ensuite compléter le champs nom, celui-ci sera utilisé pour nommer le bloc dans le "schéma", mais aussi de nommer les logs comme pour le bloc "Exec".

[[fichier:Rasp-Node-Red-picam-mail-14.png]]

=== Encodage de l'image en base64 ===

Nous allons convertir la photo prise juste avant en utilisant une commande de conversion en base64.
Cela facilitera son injection dans un template HTML que nous allons créer ensuite pour construire un email.

Nous allons tout d'abord cliquer sur le bloc "Exec" dans la section "Advanced" de la colonne de gauche et glisser l'élément dans la zone de travail.

[[fichier:Rasp-Node-Red-picam-mail-10.png]]

Ensuite, cliquer sur le bloc nouvellement créé et configurer celui-ci.

[[fichier:Rasp-Node-Red-picam-mail-11.png]]

Le menu suivant s'affichera, et nous pourrons configurer le bloc "Exec" nouvellement créé.

[[fichier:Rasp-Node-Red-picam-mail-15.png]]

==== Command ====

Nous allons y ajouter la commande à exécuter pour encoder en base 64 la photo prise précédemment avec la caméra du Raspberry Pi.

<syntaxhighlight lang="python">
base64 -i "/tmp/cam.jpg"
</syntaxhighlight>

[[fichier:Rasp-Node-Red-picam-mail-16.png]]

==== +Append ====

Ensuite, nous allons cocher la case "msg.payload" si elle n'est pas cochée par défaut pour que le résultat soit directement renvoyé par cette commande dans le "PayLoad" du flux.

[[fichier:Rasp-Node-Red-picam-mail-17.png]]

==== Extra input parameters et Timeout ====

Nous n'aurons pas besoin de compléter ces champs pour notre projet.

Si vous cochez le champ "Use spawn() instead of exec()?", votre commande sera réalisée sous forme d'un processus résident et continuera de s'exécuter jusqu'à ce qu'elle se termine par elle-même (sauf si elle ne se termine jamais).
Cette solution implique que le programme n'attendra pas que cette commande soit réalisée pour passer aux étapes suivantes.
Si la suite de l'exécution de votre flux est susceptible d'utiliser le résultat de cette commande, nous vous déconseillons d'utiliser cette option sous peine de provoquer des erreurs à la suite du traitement du flux.

[[fichier:Rasp-Node-Red-picam-mail-18.png]]

Le champ "Timeout" permet de définir un temps d'attente maximum avant de mettre un terme à l'exécution de la commande.
Cela permet de débloquer la situation si la commande exécutée prends un temps anormalement long à s'exécuter.

[[fichier:Rasp-Node-Red-picam-mail-19.png]]

==== Name ====

Nous allons ensuite compléter le champs nom, celui-ci sera utilisé pour nommer le bloc dans le "schéma", mais aussi de nommer les logs comme pour le bloc "Exec".

[[fichier:Rasp-Node-Red-picam-mail-20.png]]

=== Création d'un email au format HTML ===

Nous allons maintenant créer un template d'email au format HTML afin de mettre en forme le message que nous enverrons ensuite.
Nous allons pour cela utiliser un bloc "Template".

[[fichier:Rasp-Node-Red-picam-mail-21.png]]

==== Name ====

Nous allons attribuer un nom au bloc afin de l'identifier plus facilement dans le flux.
Nous allons donc le nommer "Contenu du mail" puisque nous créons le contenu du mail que nous enverrons ensuite.

[[fichier:Rasp-Node-Red-picam-mail-22.png]]

==== Set property ====

La propriété que nous souhaitons créer dans le flux est le "PayLoad".
Ce PayLoad existe déjà, il contient pour le moment l'image au format "Base64" précédemment encodé.
Cela n'est pas un problème, après notre noeud (notre bloc), le PayLoad sera intégralement remplacé par le template que nous sommes en train de créer.

[[fichier:Rasp-Node-Red-picam-mail-23.png]]

==== Template ====

Dans ce template, nous allons créer une structure HTML de base minimum afin que la structure soit interprétée par la majorité des clients/webmail.
Vous pouvez la personnaliser à votre guise si vous avez les connaissances en HTML.

Voici la structure de base pour notre projet:

<syntaxhighlight lang="html">
<html>
<head>
<meta charset="utf8"/>
</head>
<body>
<h1>Projet Photo par email</h1>
<img src="data:image/jpg;base64,{{payload}}"/>
</body>
</html>
</syntaxhighlight>

Vous pourrez remarquer que nous intégrons l'image en appelant le PayLoad à 'intérieur du code HTML dans la balise <img>.
C'est le PayLoad créé précédemment par le bloc "Exec" qui est récupéré à ce moment précis.
Ce PayLoad est remplacé dans le flux par le PayLoad complet avec notre template dans le flux par notre bloc Template.

[[fichier:Rasp-Node-Red-picam-mail-24.png]]

=== Création d'un bloc (noeud) "Debug" ===

Nous allons ajouter la notion d'expéditeur dans le flux que nous avons créé à travers nos blocs (noeuds).
Pour rappel, actuellement nous avons deux propriétés avec des données dans notre flux.
Si nous voulons observer ce que nous avons créé jusque là, nous pouvons faire appel à un bloc "Debug".

==== Création du bloc "Debug" ====

Comme pour les blocs précédents, nous allons glisser/déposer un bloc débug dans l'espace de travail.

[[fichier:Rasp-Node-Red-picam-mail-25.png]]

Celui-ci s'appelle msg/payload par défaut

[[fichier:Rasp-Node-Red-picam-mail-26.png]]

Nous allons double-cliquer sur ce bloc pour le configurer.

[[fichier:Rasp-Node-Red-picam-mail-27.png]]

==== Output ====

Dans ce champs, nous allons choisir la partie du flux que nous souhaitons afficher, ou nous allons sélectionner le flux entier.

[[fichier:Rasp-Node-Red-picam-mail-28.png]]

Sélectionner le flux entier, nous affichera le flux complet incluant toutes ses propriétés.

[[fichier:Rasp-Node-Red-picam-mail-29.png]]

==== To =====

La propriété "To" nous permet de choisir ou nous souhaitons afficher les données que nous récupérons.
Soit nous les affichons uniquement dans l'onglet "Debug" à droite de l'espace de travail, soit nous l'affichons dans cet onglet mais aussi dans la console de NodeJS.
Dans notre cas, nous allons nous contenter d'afficher nos éléments dans l'onglet de "Debug" à droite de notre espace de travail.

[[fichier:Rasp-Node-Red-picam-mail-30.png]]

==== Name ====

Le champs Name nous servira à identifier quel bloc de "Debug" affiche les données en console ou dans l'onglet "Debug".
Il faut donc le nommer efficacement pour bien attacher et comprendre les données que nous récupérons, surtout si nous en plaçons plusieurs dans le flux.

[[fichier:Rasp-Node-Red-picam-mail-31.png]]

==== Exploitation et compréhension des données récupérées ====

Nous avons placé notre bloc "Debug" à la suite du flux en dernière position.

[[fichier:Rasp-Node-Red-picam-mail-32.png]]

Nous allons donc déployer le programme en cliquant sur "Deploy" en haut à droite de la page.

[[fichier:Rasp-Node-Red-picam-mail-33.png]]

Ensuite, nous allons exécuter manuellement le programme en cliquant sur le bouton se trouvant en début de chaîne:

[[fichier:Rasp-Node-Red-picam-mail-34.png]]

Nous allons ensuite afficher l'onglet "Debug" sur le coté droit de la page et analyser les données récupérées:

[[fichier:Rasp-Node-Red-picam-mail-35.png]]

==== Analyse des données récupérées dans l'onglet "Debug" ====

<syntaxhighlight lang="bash">
08/05/2017 à 12:54:31 node: FORMATAGE
MCHobby - Photo bureau : msg : Object
object
_msgid: "81efe35c.3208d"
topic: "MCHobby - Photo bureau"
payload: "<html>↵ <head>↵ <meta charset="utf8"/>↵ ↵ </head>↵ <body>↵ <h1>MCHobby - Photo bureau</h1>↵ <p>Cette photo est un instantané pris dans les bureaux de MCHobby.</p>↵
<img src="data:image/jpg;base64,/9j/4WP6x2.../>"
</syntaxhighlight>

Comme vous pourrez le constater, chaque élément du noeud est détaillé.
Les données sont cependant tronquées, le noeud "Debug" ne nous fourni pas la totalité du "PayLoad" mais nous avons déjà un bon aperçu des données qu'il contient.

* '''_msgid:''' est un Id unique de message
* '''topic:''' est le sujet du mail, nous l'avons déterminé dans le premier bloc
* '''payload:''' contient les données du message formatées par le template que nous avons créé et complété par l'image en base64.

{{tmbox | text = Les noeuds "Debug" sont pratiques. Ils nous permettent d'afficher une partie ou la totalité du flux tel qu'il est à l'endroit ou ils sont placés. Cela peut permettre d'identifier et de résoudre plus facilement des problèmes dans des opérations plus complexes et dans notre cas, cela nous permet de mieux comprendre comment fonctionne le noeud et comment les données sont transmises d'un bloc à l'autre.}}

=== Création d'un expéditeur ===

Nous avons construit petit à petit un message avec un sujet, mais il manque encore un détail: l'expéditeur de l'email que nous allons envoyer: le fameux "msg.from" que nous avons évoqué au début de tuto !

Si vous avez bien suivi les étapes précédentes du tuto, jusqu'au noeud "Debug" et à son résultat, vous comprendrez facilement la démarche ci après pour ajouter un expéditeur dans le flux.

Nous allons ajouter un nouveau noeud "Template" dans la zone de travail et double cliquer dessus pour afficher sa page de configuration:

[[fichier:Rasp-Node-Red-picam-mail-39.png]]

Nous allons ensuite sélectionner le type de propriété que nous souhaitons injecter dans le flux: '''"msg.from"'''

[[fichier:Rasp-Node-Red-picam-mail-40.png]]

Cette propriété étant une adresse email, nous allons choisir le type '''"plaintext"''' comme type de données.

[[fichier:Rasp-Node-Red-picam-mail-41.png]]

Nous allons enfin donner un nom explicite à notre bloc afin d'identifier facilement sa fonctionnalité parmi les autres blocs.

[[fichier:Rasp-Node-Red-picam-mail-42.png]]

=== Création du bloc d'envoi d'email ===

==== To : destinataire ====

Simplement, l'adresse email du destinataire du message.

[[fichier:Rasp-Node-Red-picam-mail-43.png]]

==== Server, port, secure connection ====

Dans ce champ, nous allons mettre un serveur SMTP (serveur email) pour permettre l'envoi de l'email. Dans la plupart des cas, le SMTP de votre FAI (fournisseur d'accès à internet) pourra servir d'intermédiaire.
Nous vous invitons à consulter les paramètres propres à votre fournisseur d'accès pour paramétrer ce bloc.

[[fichier:Rasp-Node-Red-picam-mail-43.png]]

==== UserID et Password ====

Ces champs resteront vides si votre FAI ne nécessite pas d'authentification pour envoyer des emails.
Si vous utilisez un autre fournisseur, tel que GMAIL par exemple, il faudra mettre votre adresse email et votre mot de passe pour vous identifier.

{{tmbox|text="Attention: votre compte gmail devra être configuré au préalable afin d'autoriser un "client email" à utiliser votre compte pour envoyer/recevoir des emails par ce biais. Nous vous invitons à consulter la documentation de Gmail pour en savoir plus."}}

{{Rasp-Node-Red-TRAILER}}

Rasp-Node-Red-picam-mail

2017-05-08T13:39:48Z

AntoineWrt :

{{Rasp-Node-Red-NAV}}

{{traduction}}

== PiCamRED - Envoi périodique de photos par email avec PiCam et NodeRED ==

[[fichier:Rasp-Node-Red-picam-mail-01.png|900px]]

=== Description du projet ===

Dans ce tutoriel, nous allons réaliser des photos à l'aide de la caméra du RaspBerry Pi 2/3 et envoyer ces clichés par email de manière périodique grâce à NodeRED.
Nous allons donc utiliser plusieurs blocs et décrire de manière détaillée le déroulement de chaque étape de la réalisation de ce projet.

Dans NodeRED, il est important de bien identifier la finalité de notre projet afin de connaître au préalable tous les éléments qu'il faudra créer et fournir à l'action finale (celle qui enverra un email).

=== Quels sont les besoins du noeud email ===

==== Composants nécessaires pour constituer un email ====

Un email est composé des éléments suivants:

* Un expéditeur
* Un destinataire
* Un sujet
* Le corps du message

Tous ces éléments vont donc devoir être préparés afin de pouvoir construire le message à envoyer par le noeud final.

Le noeud final aura aussi besoin d'un serveur SMTP (serveur d'envoi d'emails) et éventuellement de paramètres d'identification pour ce serveur d'envoi d'emails.

==== Détail des besoins du noeud email ====

La liste des éléments nécessaires s'affiche lorsque le bloc est dans la zone de travail (Schema).
Commençons donc par sélectionner le bloc email, et de le glisser dans la zone de travail.

Commençons par cliquer sur le bloc email et nous maintenons le clic pour le glisser à droite dans l'espace de travail.

(on choisit celui qui a son point de liaison à gauche, car nous voulons un bloc de sortie)

[[fichier:Rasp-Node-Red-picam-mail-36.png]]

Glissons le dans l'espace de travail, et cliquons un clic simple pour le sélectionner.

[[fichier:Rasp-Node-Red-picam-mail-37.png]]

Ensuite, dans la colonne à droite de cet espace de travail, nous cliquons sur info et nous pourrons découvrir les éléments nécessaires à la constitution d'un bloc email.

[[fichier:Rasp-Node-Red-picam-mail-38.png]]

===== Nous utiliserons les champs suivants =====

* '''msg.payload''' --> Ce champ contient le corps de l'email
* '''msg.topic''' --> Ce champ contient le sujet de l'email
* '''msg.from''' --> Ce champ contient l'email de l'expéditeur
* '''msg.to''' --> Ce champ contient l'email du destinataire

Les autres champs ne seront pas utilisés dans notre cas, mais vous pourrez constater que le bloc email est complet de part ses fonctionnalités et possibilités.

Les données de serveur et d'identification seront abordées en fin de tuto lors de la configuration finale du bloc.

Nous allons maintenant passer à la réalisation du flux en commençant par le début de celui-ci.

=== Création d'une action périodique ===

Dans la colonne de gauche de NodeRED, se trouvent une liste de blocs à utiliser pour réaliser vos projets. Ils sont classés par "types".

Ainsi nous retrouvons les "types" suivants:

* '''Input''' qui contient tous les blocs d'entrées
* '''Ouput''' qui contient tous les blocs de sortie
* '''Function''' qui contient des blocs de fonctions javascript etc...
* '''Social''' qui sont des blocs d'entrée ou sorties depuis ou vers les réseaux sociaux
* '''Storage''' qui sont des fonctions de lecture ou d'écriture de fichiers
* '''Analysis''' ->> Sentiment interprète du texte et détermine un score sur base d'un dictionnaire anglais, renvoie le texte avec ce score de -5 à +5, déterminant ainsi l'émotion susceptible d'être procuré par ce texte
* '''Advanced''' possède des outils permettant de détecter des changements dans des fichiers ou dossiers, de lire des flux RSS ou encore EXEC qui permet d'exécuter directement des commandes sous linux !
* '''Raspberry Pi''' contient des outils pour piloter/lire le GPIO du raspberry Pi
* '''Network''' qui contient un outil réseau de Ping

Nous allons créer une action périodique, c'est à dire paramétrer un bloc '''"INJECT"''' de manière à déclencher régulièrement une chaine d'actions que nous allons accrocher à la suite les unes après les autres.
Nous allons donc cliquer sur le bloc '''"Inject"''' dans la liste "Input" et maintenir ce clic pour le déplacer vers la zone de travail.

[[fichier:Rasp-Node-Red-picam-mail-02.png]]

Nous obtiendrons donc une nouvelle instance "inject" qui portera le nom '''"Timestamp"''' (ce nom est attribué par défaut par NodeRED) comme dans la capture ci-dessous

[[fichier:Rasp-Node-Red-picam-mail-03.png]]

Nous allons maintenant double-cliquer sur celle-ci fin de l'éditer pour voir apparaitre le menu ci-dessous

[[fichier:Rasp-Node-Red-picam-mail-04.png]]

Il va falloir configurer ce bloc, mais avant tout voici une explication de celui-ci:

==== Payload ====

Le champs PayLoad est en fait le champ de données qui sera suivi d'un noeud à l'autre jusque à la fin de la chaine.
Dans ce module '''"inject"''', nous allons donc déterminer quel type de données contiendra le '''"PayLoad"''' jusqu'à la fin de la chaine que l'on va réaliser.

Dans notre cas, nous souhaitons construire un email, donc du contenu textuel, nous allons donc choisir '''"String"''' ce qui correspond à une chaine de caractères (du texte).

[[fichier:Rasp-Node-Red-picam-mail-05.png]]

==== Topic ====

Le champs "Topic" est un champs de texte dans lequel nous allons mettre un sujet succinct décrivant notre chaine.
Dans notre cas, ce sujet fera office de sujet au mail que nous expédierons.
Nous allons donc être précis en un minimum de mots pour que le destinataire de l'email puisse facilement deviner le contenu de celui-ci.

[[fichier:Rasp-Node-Red-picam-mail-06.png]]

==== Repeat ====

Nous allons ensuite choisir l'intervalle de déclenchement de notre action, sachant que nous avons le choix entre:

* '''none''' : pas de déclenchement périodique programmé
* '''interval''' : nous fixons un temps de déclenchement à partir du lancement du programme, l'action se réalisera à chaque fois que ce temps sera écoulé de manière répétée jusqu'à l'interruption manuelle du programme
* '''interval between times''' : nous fixons ici le déclenchement par interval, mais nous fixons aussi une fourchette d'heures et des jours pendant lesquels nous exécutons cet interval
* '''at a specific time''' : nous fixons une heure d'exécution, et un ou plusieurs jours d'exécution. Dans ce cas l'action n'est pas répétée en continu mais éxécutée une seule fois par jour à l'heure programmée

Dans notre exemple, nous allons fixer un intervalle de 15 secondes pour commencer. Nous pourrons ensuite augmenter cette valeur pour éviter de recevoir trop d'emails avec des photos :D

[[fichier:Rasp-Node-Red-picam-mail-07.png]]

La case '''"inject once at start"''' permet de ne pas attendre le premier cycle avant d'exécuter une première fois l'action. Elle se lancera dès le lancement du programme, puis périodiquement selon les cycles déterminés par l'intervalle.

[[fichier:Rasp-Node-Red-picam-mail-08.png]]

==== Name ====

Le champs Name va déterminer le nom que portera le bloc dans l'espace de travail et dans les logs (si nous créons des blocs de log ensuite pour contrôler des étapes).
Il est important de bien établir ce nom de manière explicite, car le nom des blocs permettra de comprendre et retrouver facilement la logique du schéma construit, même si l'on a pas consulté celui-ci pendant une longue période.

[[fichier:Rasp-Node-Red-picam-mail-09.png]]

=== Capture d'une image depuis la PiCam ===

Nous allons aller à l'essentiel en ce qui concerne la capture photo en utilisant une commande simple pour prendre un cliché et renvoyer celui-ci dans le flux NodeRED grâce à un bloc permettant d'exécuter des commandes bash.

{{ambox | text = Vous trouverez un TUTO détaillé sur la PiCam vous permettant de prendre la main, ou de la paramétrer si vous n'avez pas encore utilisé celle-ci auparavant: ....___TUTO___...}}

Nous allons tout d'abord cliquer sur le bloc "Exec" dans la section "Advanced" de la colonne de gauche et glisser l'élément dans la zone de travail.

[[fichier:Rasp-Node-Red-picam-mail-10.png]]

Ensuite, cliquer sur le bloc nouvellement créé et configurer celui-ci.

[[fichier:Rasp-Node-Red-picam-mail-11.png]]

Le menu suivant s'affichera, et nous pourrons configurer le bloc "Exec" nouvellement créé.

==== Command ====

Nous allons y ajouter la commande à exécuter pour prendre une photo avec la caméra du Raspberry Pi et la stocker dans un fichier jpg dans le dossier /tmp/ de linux.

<syntaxhighlight lang="python">
raspistill -o /tmp/cam.jpg -w 640 -h 480
</syntaxhighlight>

Nous prenons soin de limiter la hauteur et la largeur de l'image afin de réduire son poids pour l'envoi par email.

[[fichier:Rasp-Node-Red-picam-mail-12.png]]

==== +Append ====

Ensuite, nous allons décocher la case "msg.payload" si elle est cochée par défaut.

[[fichier:Rasp-Node-Red-picam-mail-13.png]]

==== Extra input parameters et Timeout ====

Nous n'aurons pas besoin de compléter ces champs pour notre projet.

Si vous cochez le champ "Use spawn() instead of exec()?", votre commande sera réalisée sous forme d'un processus résident et continuera de s'exécuter jusqu'à ce qu'elle se termine par elle-même (sauf si elle ne se termine jamais).
Cette solution implique que le programme n'attendra pas que cette commande soit réalisée pour passer aux étapes suivantes.
Si la suite de l'exécution de votre flux est susceptible d'utiliser le résultat de cette commande, nous vous déconseillons d'utiliser cette option sous peine de provoquer des erreurs à la suite du traitement du flux.

Le champ "Timeout" permet de définir un temps d'attente maximum avant de mettre un terme à l'exécution de la commande.
Cela permet de débloquer la situation si la commande exécutée prends un temps anormalement long à s'exécuter.

==== Name ====

Nous allons ensuite compléter le champs nom, celui-ci sera utilisé pour nommer le bloc dans le "schéma", mais aussi de nommer les logs comme pour le bloc "Exec".

[[fichier:Rasp-Node-Red-picam-mail-14.png]]

=== Encodage de l'image en base64 ===

Nous allons convertir la photo prise juste avant en utilisant une commande de conversion en base64.
Cela facilitera son injection dans un template HTML que nous allons créer ensuite pour construire un email.

Nous allons tout d'abord cliquer sur le bloc "Exec" dans la section "Advanced" de la colonne de gauche et glisser l'élément dans la zone de travail.

[[fichier:Rasp-Node-Red-picam-mail-10.png]]

Ensuite, cliquer sur le bloc nouvellement créé et configurer celui-ci.

[[fichier:Rasp-Node-Red-picam-mail-11.png]]

Le menu suivant s'affichera, et nous pourrons configurer le bloc "Exec" nouvellement créé.

[[fichier:Rasp-Node-Red-picam-mail-15.png]]

==== Command ====

Nous allons y ajouter la commande à exécuter pour encoder en base 64 la photo prise précédemment avec la caméra du Raspberry Pi.

<syntaxhighlight lang="python">
base64 -i "/tmp/cam.jpg"
</syntaxhighlight>

[[fichier:Rasp-Node-Red-picam-mail-16.png]]

==== +Append ====

Ensuite, nous allons cocher la case "msg.payload" si elle n'est pas cochée par défaut pour que le résultat soit directement renvoyé par cette commande dans le "PayLoad" du flux.

[[fichier:Rasp-Node-Red-picam-mail-17.png]]

==== Extra input parameters et Timeout ====

Nous n'aurons pas besoin de compléter ces champs pour notre projet.

Si vous cochez le champ "Use spawn() instead of exec()?", votre commande sera réalisée sous forme d'un processus résident et continuera de s'exécuter jusqu'à ce qu'elle se termine par elle-même (sauf si elle ne se termine jamais).
Cette solution implique que le programme n'attendra pas que cette commande soit réalisée pour passer aux étapes suivantes.
Si la suite de l'exécution de votre flux est susceptible d'utiliser le résultat de cette commande, nous vous déconseillons d'utiliser cette option sous peine de provoquer des erreurs à la suite du traitement du flux.

[[fichier:Rasp-Node-Red-picam-mail-18.png]]

Le champ "Timeout" permet de définir un temps d'attente maximum avant de mettre un terme à l'exécution de la commande.
Cela permet de débloquer la situation si la commande exécutée prends un temps anormalement long à s'exécuter.

[[fichier:Rasp-Node-Red-picam-mail-19.png]]

==== Name ====

Nous allons ensuite compléter le champs nom, celui-ci sera utilisé pour nommer le bloc dans le "schéma", mais aussi de nommer les logs comme pour le bloc "Exec".

[[fichier:Rasp-Node-Red-picam-mail-20.png]]

=== Création d'un email au format HTML ===

Nous allons maintenant créer un template d'email au format HTML afin de mettre en forme le message que nous enverrons ensuite.
Nous allons pour cela utiliser un bloc "Template".

[[fichier:Rasp-Node-Red-picam-mail-21.png]]

==== Name ====

Nous allons attribuer un nom au bloc afin de l'identifier plus facilement dans le flux.
Nous allons donc le nommer "Contenu du mail" puisque nous créons le contenu du mail que nous enverrons ensuite.

[[fichier:Rasp-Node-Red-picam-mail-22.png]]

==== Set property ====

La propriété que nous souhaitons créer dans le flux est le "PayLoad".
Ce PayLoad existe déjà, il contient pour le moment l'image au format "Base64" précédemment encodé.
Cela n'est pas un problème, après notre noeud (notre bloc), le PayLoad sera intégralement remplacé par le template que nous sommes en train de créer.

[[fichier:Rasp-Node-Red-picam-mail-23.png]]

==== Template ====

Dans ce template, nous allons créer une structure HTML de base minimum afin que la structure soit interprétée par la majorité des clients/webmail.
Vous pouvez la personnaliser à votre guise si vous avez les connaissances en HTML.

Voici la structure de base pour notre projet:

<syntaxhighlight lang="html">
<html>
<head>
<meta charset="utf8"/>
</head>
<body>
<h1>Projet Photo par email</h1>
<img src="data:image/jpg;base64,{{payload}}"/>
</body>
</html>
</syntaxhighlight>

Vous pourrez remarquer que nous intégrons l'image en appelant le PayLoad à 'intérieur du code HTML dans la balise <img>.
C'est le PayLoad créé précédemment par le bloc "Exec" qui est récupéré à ce moment précis.
Ce PayLoad est remplacé dans le flux par le PayLoad complet avec notre template dans le flux par notre bloc Template.

[[fichier:Rasp-Node-Red-picam-mail-24.png]]

=== Création d'un bloc (noeud) "Debug" ===

Nous allons ajouter la notion d'expéditeur dans le flux que nous avons créé à travers nos blocs (noeuds).
Pour rappel, actuellement nous avons deux propriétés avec des données dans notre flux.
Si nous voulons observer ce que nous avons créé jusque là, nous pouvons faire appel à un bloc "Debug".

==== Création du bloc "Debug" ====

Comme pour les blocs précédents, nous allons glisser/déposer un bloc débug dans l'espace de travail.

[[fichier:Rasp-Node-Red-picam-mail-25.png]]

Celui-ci s'appelle msg/payload par défaut

[[fichier:Rasp-Node-Red-picam-mail-26.png]]

Nous allons double-cliquer sur ce bloc pour le configurer.

[[fichier:Rasp-Node-Red-picam-mail-27.png]]

==== Output ====

Dans ce champs, nous allons choisir la partie du flux que nous souhaitons afficher, ou nous allons sélectionner le flux entier.

[[fichier:Rasp-Node-Red-picam-mail-28.png]]

Sélectionner le flux entier, nous affichera le flux complet incluant toutes ses propriétés.

[[fichier:Rasp-Node-Red-picam-mail-29.png]]

==== To =====

La propriété "To" nous permet de choisir ou nous souhaitons afficher les données que nous récupérons.
Soit nous les affichons uniquement dans l'onglet "Debug" à droite de l'espace de travail, soit nous l'affichons dans cet onglet mais aussi dans la console de NodeJS.
Dans notre cas, nous allons nous contenter d'afficher nos éléments dans l'onglet de "Debug" à droite de notre espace de travail.

[[fichier:Rasp-Node-Red-picam-mail-30.png]]

==== Name ====

Le champs Name nous servira à identifier quel bloc de "Debug" affiche les données en console ou dans l'onglet "Debug".
Il faut donc le nommer efficacement pour bien attacher et comprendre les données que nous récupérons, surtout si nous en plaçons plusieurs dans le flux.

[[fichier:Rasp-Node-Red-picam-mail-31.png]]

==== Exploitation et compréhension des données récupérées ====

Nous avons placé notre bloc "Debug" à la suite du flux en dernière position.

[[fichier:Rasp-Node-Red-picam-mail-32.png]]

Nous allons donc déployer le programme en cliquant sur "Deploy" en haut à droite de la page.

[[fichier:Rasp-Node-Red-picam-mail-33.png]]

Ensuite, nous allons exécuter manuellement le programme en cliquant sur le bouton se trouvant en début de chaîne:

[[fichier:Rasp-Node-Red-picam-mail-34.png]]

Nous allons ensuite afficher l'onglet "Debug" sur le coté droit de la page et analyser les données récupérées:

[[fichier:Rasp-Node-Red-picam-mail-35.png]]

==== Analyse des données récupérées dans l'onglet "Debug" ====

<syntaxhighlight lang="bash">
08/05/2017 à 12:54:31 node: FORMATAGE
MCHobby - Photo bureau : msg : Object
object
_msgid: "81efe35c.3208d"
topic: "MCHobby - Photo bureau"
payload: "<html>↵ <head>↵ <meta charset="utf8"/>↵ ↵ </head>↵ <body>↵ <h1>MCHobby - Photo bureau</h1>↵ <p>Cette photo est un instantané pris dans les bureaux de MCHobby.</p>↵
<img src="data:image/jpg;base64,/9j/4WP6x2.../>"
</syntaxhighlight>

Comme vous pourrez le constater, chaque élément du noeud est détaillé.
Les données sont cependant tronquées, le noeud "Debug" ne nous fourni pas la totalité du "PayLoad" mais nous avons déjà un bon aperçu des données qu'il contient.

* '''_msgid:''' est un Id unique de message
* '''topic:''' est le sujet du mail, nous l'avons déterminé dans le premier bloc
* '''payload:''' contient les données du message formatées par le template que nous avons créé et complété par l'image en base64.

{{tmbox | text = Les noeuds "Debug" sont pratiques. Ils nous permettent d'afficher une partie ou la totalité du flux tel qu'il est à l'endroit ou ils sont placés. Cela peut permettre d'identifier et de résoudre plus facilement des problèmes dans des opérations plus complexes et dans notre cas, cela nous permet de mieux comprendre comment fonctionne le noeud et comment les données sont transmises d'un bloc à l'autre.}}

=== Création d'un expéditeur ===

Nous avons construit petit à petit un message avec un sujet, mais il manque encore un détail: l'expéditeur de l'email que nous allons envoyer: le fameux "msg.from" que nous avons évoqué au début de tuto !

Si vous avez bien suivi les étapes précédentes du tuto, jusqu'au noeud "Debug" et à son résultat, vous comprendrez facilement la démarche ci après pour ajouter un expéditeur dans le flux.

Nous allons ajouter un nouveau noeud "Template" dans la zone de travail et double cliquer dessus pour afficher sa page de configuration:

[[fichier:Rasp-Node-Red-picam-mail-39.png]]

Nous allons ensuite sélectionner le type de propriété que nous souhaitons injecter dans le flux: '''"msg.from"'''

[[fichier:Rasp-Node-Red-picam-mail-40.png]]

Cette propriété étant une adresse email, nous allons choisir le type '''"plaintext"''' comme type de données.

[[fichier:Rasp-Node-Red-picam-mail-41.png]]

Nous allons enfin donner un nom explicite à notre bloc afin d'identifier facilement sa fonctionnalité parmi les autres blocs.

[[fichier:Rasp-Node-Red-picam-mail-42.png]]

=== Création du bloc d'envoi d'email ===

==== To : destinataire ====

Simplement, l'adresse email du destinataire du message.

[[fichier:Rasp-Node-Red-picam-mail-43.png]]

==== Server, port, secure connection ====

Dans ce champ, nous allons mettre un serveur SMTP (serveur email) pour permettre l'envoi de l'email. Dans la plupart des cas, le SMTP de votre FAI (fournisseur d'accès à internet) pourra servir d'intermédiaire.
Nous vous invitons à consulter les paramètres propres à votre fournisseur d'accès pour paramétrer ce bloc.

[[fichier:Rasp-Node-Red-picam-mail-43.png]]

==== UserID et Password ====

Ces champs resteront vides si votre FAI ne nécessite pas d'authentification pour envoyer des emails.
Si vous utilisez un autre fournisseur, tel que GMAIL par exemple, il faudra mettre votre adresse email et votre mot de passe pour vous identifier.

{{ambox|text="Attention: votre compte gmail devra être configuré au préalable afin d'autoriser un "client email" à utiliser votre compte pour envoyer/recevoir des emails par ce biais. Nous vous invitons à consulter la documentation de Gmail pour en savoir plus."}}

{{Rasp-Node-Red-TRAILER}}

Rasp-Node-Red-picam-mail

2017-05-08T13:23:30Z

AntoineWrt : /* Création d'une action périodique */

Rasp-Node-Red-picam-mail

2017-05-08T13:22:04Z

AntoineWrt : /* Création d'une action périodique */

{{Rasp-Node-Red-NAV}}

{{traduction}}

== PiCamRED - Envoi périodique de photos par email avec PiCam et NodeRED ==

[[fichier:Rasp-Node-Red-picam-mail-01.png|900px]]

=== Description du projet ===

Dans ce tutoriel, nous allons réaliser des photos à l'aide de la caméra du RaspBerry Pi 2/3 et envoyer ces clichés par email de manière périodique grâce à NodeRED.
Nous allons donc utiliser plusieurs blocs et décrire de manière détaillée le déroulement de chaque étape de la réalisation de ce projet.

Dans NodeRED, il est important de bien identifier la finalité de notre projet afin de connaître au préalable tous les éléments qu'il faudra créer et fournir à l'action finale (celle qui enverra un email).

=== Quels sont les besoins du noeud email ===

==== Composants nécessaires pour constituer un email ====

Un email est composé des éléments suivants:

* Un expéditeur
* Un destinataire
* Un sujet
* Le corps du message

Tous ces éléments vont donc devoir être préparés afin de pouvoir construire le message à envoyer par le noeud final.

Le noeud final aura aussi besoin d'un serveur SMTP (serveur d'envoi d'emails) et éventuellement de paramètres d'identification pour ce serveur d'envoi d'emails.

==== Détail des besoins du noeud email ====

La liste des éléments nécessaires s'affiche lorsque le bloc est dans la zone de travail (Schema).
Commençons donc par sélectionner le bloc email, et de le glisser dans la zone de travail.

Commençons par cliquer sur le bloc email et nous maintenons le clic pour le glisser à droite dans l'espace de travail.

(on choisit celui qui a son point de liaison à gauche, car nous voulons un bloc de sortie)

[[fichier:Rasp-Node-Red-picam-mail-36.png]]

Glissons le dans l'espace de travail, et cliquons un clic simple pour le sélectionner.

[[fichier:Rasp-Node-Red-picam-mail-37.png]]

Ensuite, dans la colonne à droite de cet espace de travail, nous cliquons sur info et nous pourrons découvrir les éléments nécessaires à la constitution d'un bloc email.

[[fichier:Rasp-Node-Red-picam-mail-38.png]]

===== Nous utiliserons les champs suivants =====

* '''msg.payload''' --> Ce champ contient le corps de l'email
* '''msg.topic''' --> Ce champ contient le sujet de l'email
* '''msg.from''' --> Ce champ contient l'email de l'expéditeur
* '''msg.to''' --> Ce champ contient l'email du destinataire

Les autres champs ne seront pas utilisés dans notre cas, mais vous pourrez constater que le bloc email est complet de part ses fonctionnalités et possibilités.

Les données de serveur et d'identification seront abordées en fin de tuto lors de la configuration finale du bloc.

Nous allons maintenant passer à la réalisation du flux en commençant par le début de celui-ci.

=== Création d'une action périodique ===

Dans la colonne de gauche de NodeRED, se trouvent une liste de blocs à utiliser pour réaliser vos projets. Ils sont classés par "types".

Ainsi nous retrouvons les "types" suivants:

* '''Input''' qui contient tous les blocs d'entrées
* '''Ouput''' qui contient tous les blocs de sortie
* '''Function''' qui contient des blocs de fonctions javascript etc...
* '''Social''' qui sont des blocs d'entrée ou sorties depuis ou vers les réseaux sociaux
* '''Storage''' qui sont des fonctions de lecture ou d'écriture de fichiers
* '''Analysis''' ->> Sentiment interprète du texte et détermine un score sur base d'un dictionnaire anglais, renvoie le texte avec ce score de -5 à +5, déterminant ainsi l'émotion susceptible d'être procuré par ce texte
* '''Advanced''' possède des outils permettant de détecter des changements dans des fichiers ou dossiers, de lire des flux RSS ou encore EXEC qui permet d'exécuter directement des commandes sous linux !
* '''Raspberry Pi''' contient des outils pour piloter/lire le GPIO du raspberry Pi
* '''Network''' qui contient un outil réseau de Ping

Nous allons créer une action périodique, c'est à dire paramétrer un bloc "INJECT" de manière à déclencher régulièrement une chaine d'actions que nous allons accrocher à la suite les unes après les autres.
Nous allons donc cliquer sur le bloc "Inject" dans la liste "Input" et maintenir ce clic pour le déplacer vers la zone de travail.

[[fichier:Rasp-Node-Red-picam-mail-02.png]]

Nous obtiendrons donc une nouvelle instance "inject" qui portera le nom "Timestamp" (ce nom est attribué par défaut par NodeRED) comme dans la capture ci-dessous

[[fichier:Rasp-Node-Red-picam-mail-03.png]]

Nous allons maintenant double-cliquer sur celle-ci fin de l'éditer pour voir apparaitre le menu ci-dessous

[[fichier:Rasp-Node-Red-picam-mail-04.png]]

Il va falloir configurer ce bloc, mais avant tout voici une explication de celui-ci:

==== Payload ====

Le champs PayLoad est en fait le champ de données qui sera suivi d'un noeud à l'autre jusque à la fin de la chaine.
Dans ce module "inject", nous allons donc déterminer quel type de données contiendra le "PayLoad" jusqu'à la fin de la chaine que l'on va réaliser.

Dans notre cas, nous souhaitons construire un email, donc du contenu textuel, nous allons donc choisir "String" ce qui correspond à une chaine de caractères (du texte).

[[fichier:Rasp-Node-Red-picam-mail-05.png]]

==== Topic ====

Le champs "Topic" est un champs de texte dans lequel nous allons mettre un sujet succinct décrivant notre chaine.
Dans notre cas, ce sujet fera office de sujet au mail que nous expédierons.
Nous allons donc être précis en un minimum de mots pour que le destinataire de l'email puisse facilement deviner le contenu de celui-ci.

[[fichier:Rasp-Node-Red-picam-mail-06.png]]

==== Repeat ====

Nous allons ensuite choisir l'intervalle de déclenchement de notre action, sachant que nous avons le choix entre:

* none : pas de déclenchement périodique programmé
* interval : nous fixons un temps de déclenchement à partir du lancement du programme, l'action se réalisera à chaque fois que ce temps sera écoulé de manière répétée jusqu'à l'interruption manuelle du programme
* interval between times : nous fixons ici le déclenchement par interval, mais nous fixons aussi une fourchette d'heures et des jours pendant lesquels nous exécutons cet interval
* at a specific time : nous fixons une heure d'exécution, et un ou plusieurs jours d'exécution. Dans ce cas l'action n'est pas répétée en continu mais éxécutée une seule fois par jour à l'heure programmée

Dans notre exemple, nous allons fixer un intervalle de 15 secondes pour commencer. Nous pourrons ensuite augmenter cette valeur pour éviter de recevoir trop d'emails avec des photos :D

[[fichier:Rasp-Node-Red-picam-mail-07.png]]

La case "inject once at start" permet de ne pas attendre le premier cycle avant d'exécuter une première fois l'action. Elle se lancera dès le lancement du programme, puis périodiquement selon les cycles déterminés par l'intervalle.

[[fichier:Rasp-Node-Red-picam-mail-08.png]]

==== Name ====

Le champs Name va déterminer le nom que portera le bloc dans l'espace de travail et dans les logs (si nous créons des blocs de log ensuite pour contrôler des étapes).
Il est important de bien établir ce nom de manière explicite, car le nom des blocs permettra de comprendre et retrouver facilement la logique du schéma construit, même si l'on a pas consulté celui-ci pendant une longue période.

[[fichier:Rasp-Node-Red-picam-mail-09.png]]

=== Capture d'une image depuis la PiCam ===

Nous allons aller à l'essentiel en ce qui concerne la capture photo en utilisant une commande simple pour prendre un cliché et renvoyer celui-ci dans le flux NodeRED grâce à un bloc permettant d'exécuter des commandes bash.

{{ambox | text = Vous trouverez un TUTO détaillé sur la PiCam vous permettant de prendre la main, ou de la paramétrer si vous n'avez pas encore utilisé celle-ci auparavant: ....___TUTO___...}}

Nous allons tout d'abord cliquer sur le bloc "Exec" dans la section "Advanced" de la colonne de gauche et glisser l'élément dans la zone de travail.

[[fichier:Rasp-Node-Red-picam-mail-10.png]]

Ensuite, cliquer sur le bloc nouvellement créé et configurer celui-ci.

[[fichier:Rasp-Node-Red-picam-mail-11.png]]

Le menu suivant s'affichera, et nous pourrons configurer le bloc "Exec" nouvellement créé.

==== Command ====

Nous allons y ajouter la commande à exécuter pour prendre une photo avec la caméra du Raspberry Pi et la stocker dans un fichier jpg dans le dossier /tmp/ de linux.

<syntaxhighlight lang="python">
raspistill -o /tmp/cam.jpg -w 640 -h 480
</syntaxhighlight>

Nous prenons soin de limiter la hauteur et la largeur de l'image afin de réduire son poids pour l'envoi par email.

[[fichier:Rasp-Node-Red-picam-mail-12.png]]

==== +Append ====

Ensuite, nous allons décocher la case "msg.payload" si elle est cochée par défaut.

[[fichier:Rasp-Node-Red-picam-mail-13.png]]

==== Extra input parameters et Timeout ====

Nous n'aurons pas besoin de compléter ces champs pour notre projet.

Si vous cochez le champ "Use spawn() instead of exec()?", votre commande sera réalisée sous forme d'un processus résident et continuera de s'exécuter jusqu'à ce qu'elle se termine par elle-même (sauf si elle ne se termine jamais).
Cette solution implique que le programme n'attendra pas que cette commande soit réalisée pour passer aux étapes suivantes.
Si la suite de l'exécution de votre flux est susceptible d'utiliser le résultat de cette commande, nous vous déconseillons d'utiliser cette option sous peine de provoquer des erreurs à la suite du traitement du flux.

Le champ "Timeout" permet de définir un temps d'attente maximum avant de mettre un terme à l'exécution de la commande.
Cela permet de débloquer la situation si la commande exécutée prends un temps anormalement long à s'exécuter.

==== Name ====

Nous allons ensuite compléter le champs nom, celui-ci sera utilisé pour nommer le bloc dans le "schéma", mais aussi de nommer les logs comme pour le bloc "Exec".

[[fichier:Rasp-Node-Red-picam-mail-14.png]]

=== Encodage de l'image en base64 ===

Nous allons convertir la photo prise juste avant en utilisant une commande de conversion en base64.
Cela facilitera son injection dans un template HTML que nous allons créer ensuite pour construire un email.

Nous allons tout d'abord cliquer sur le bloc "Exec" dans la section "Advanced" de la colonne de gauche et glisser l'élément dans la zone de travail.

[[fichier:Rasp-Node-Red-picam-mail-10.png]]

Ensuite, cliquer sur le bloc nouvellement créé et configurer celui-ci.

[[fichier:Rasp-Node-Red-picam-mail-11.png]]

Le menu suivant s'affichera, et nous pourrons configurer le bloc "Exec" nouvellement créé.

[[fichier:Rasp-Node-Red-picam-mail-15.png]]

==== Command ====

Nous allons y ajouter la commande à exécuter pour encoder en base 64 la photo prise précédemment avec la caméra du Raspberry Pi.

<syntaxhighlight lang="python">
base64 -i "/tmp/cam.jpg"
</syntaxhighlight>

[[fichier:Rasp-Node-Red-picam-mail-16.png]]

==== +Append ====

Ensuite, nous allons cocher la case "msg.payload" si elle n'est pas cochée par défaut pour que le résultat soit directement renvoyé par cette commande dans le "PayLoad" du flux.

[[fichier:Rasp-Node-Red-picam-mail-17.png]]

==== Extra input parameters et Timeout ====

Nous n'aurons pas besoin de compléter ces champs pour notre projet.

Si vous cochez le champ "Use spawn() instead of exec()?", votre commande sera réalisée sous forme d'un processus résident et continuera de s'exécuter jusqu'à ce qu'elle se termine par elle-même (sauf si elle ne se termine jamais).
Cette solution implique que le programme n'attendra pas que cette commande soit réalisée pour passer aux étapes suivantes.
Si la suite de l'exécution de votre flux est susceptible d'utiliser le résultat de cette commande, nous vous déconseillons d'utiliser cette option sous peine de provoquer des erreurs à la suite du traitement du flux.

[[fichier:Rasp-Node-Red-picam-mail-18.png]]

Le champ "Timeout" permet de définir un temps d'attente maximum avant de mettre un terme à l'exécution de la commande.
Cela permet de débloquer la situation si la commande exécutée prends un temps anormalement long à s'exécuter.

[[fichier:Rasp-Node-Red-picam-mail-19.png]]

==== Name ====

Nous allons ensuite compléter le champs nom, celui-ci sera utilisé pour nommer le bloc dans le "schéma", mais aussi de nommer les logs comme pour le bloc "Exec".

[[fichier:Rasp-Node-Red-picam-mail-20.png]]

=== Création d'un email au format HTML ===

Nous allons maintenant créer un template d'email au format HTML afin de mettre en forme le message que nous enverrons ensuite.
Nous allons pour cela utiliser un bloc "Template".

[[fichier:Rasp-Node-Red-picam-mail-21.png]]

==== Name ====

Nous allons attribuer un nom au bloc afin de l'identifier plus facilement dans le flux.
Nous allons donc le nommer "Contenu du mail" puisque nous créons le contenu du mail que nous enverrons ensuite.

[[fichier:Rasp-Node-Red-picam-mail-22.png]]

==== Set property ====

La propriété que nous souhaitons créer dans le flux est le "PayLoad".
Ce PayLoad existe déjà, il contient pour le moment l'image au format "Base64" précédemment encodé.
Cela n'est pas un problème, après notre noeud (notre bloc), le PayLoad sera intégralement remplacé par le template que nous sommes en train de créer.

[[fichier:Rasp-Node-Red-picam-mail-23.png]]

==== Template ====

Dans ce template, nous allons créer une structure HTML de base minimum afin que la structure soit interprétée par la majorité des clients/webmail.
Vous pouvez la personnaliser à votre guise si vous avez les connaissances en HTML.

Voici la structure de base pour notre projet:

<syntaxhighlight lang="html">
<html>
<head>
<meta charset="utf8"/>
</head>
<body>
<h1>Projet Photo par email</h1>
<img src="data:image/jpg;base64,{{payload}}"/>
</body>
</html>
</syntaxhighlight>

Vous pourrez remarquer que nous intégrons l'image en appelant le PayLoad à 'intérieur du code HTML dans la balise <img>.
C'est le PayLoad créé précédemment par le bloc "Exec" qui est récupéré à ce moment précis.
Ce PayLoad est remplacé dans le flux par le PayLoad complet avec notre template dans le flux par notre bloc Template.

[[fichier:Rasp-Node-Red-picam-mail-24.png]]

=== Création d'un bloc (noeud) "Debug" ===

Nous allons ajouter la notion d'expéditeur dans le flux que nous avons créé à travers nos blocs (noeuds).
Pour rappel, actuellement nous avons deux propriétés avec des données dans notre flux.
Si nous voulons observer ce que nous avons créé jusque là, nous pouvons faire appel à un bloc "Debug".

==== Création du bloc "Debug" ====

Comme pour les blocs précédents, nous allons glisser/déposer un bloc débug dans l'espace de travail.

[[fichier:Rasp-Node-Red-picam-mail-25.png]]

Celui-ci s'appelle msg/payload par défaut

[[fichier:Rasp-Node-Red-picam-mail-26.png]]

Nous allons double-cliquer sur ce bloc pour le configurer.

[[fichier:Rasp-Node-Red-picam-mail-27.png]]

==== Output ====

Dans ce champs, nous allons choisir la partie du flux que nous souhaitons afficher, ou nous allons sélectionner le flux entier.

[[fichier:Rasp-Node-Red-picam-mail-28.png]]

Sélectionner le flux entier, nous affichera le flux complet incluant toutes ses propriétés.

[[fichier:Rasp-Node-Red-picam-mail-29.png]]

==== To =====

La propriété "To" nous permet de choisir ou nous souhaitons afficher les données que nous récupérons.
Soit nous les affichons uniquement dans l'onglet "Debug" à droite de l'espace de travail, soit nous l'affichons dans cet onglet mais aussi dans la console de NodeJS.
Dans notre cas, nous allons nous contenter d'afficher nos éléments dans l'onglet de "Debug" à droite de notre espace de travail.

[[fichier:Rasp-Node-Red-picam-mail-30.png]]

==== Name ====

Le champs Name nous servira à identifier quel bloc de "Debug" affiche les données en console ou dans l'onglet "Debug".
Il faut donc le nommer efficacement pour bien attacher et comprendre les données que nous récupérons, surtout si nous en plaçons plusieurs dans le flux.

[[fichier:Rasp-Node-Red-picam-mail-31.png]]

==== Exploitation et compréhension des données récupérées ====

Nous avons placé notre bloc "Debug" à la suite du flux en dernière position.

[[fichier:Rasp-Node-Red-picam-mail-32.png]]

Nous allons donc déployer le programme en cliquant sur "Deploy" en haut à droite de la page.

[[fichier:Rasp-Node-Red-picam-mail-33.png]]

Ensuite, nous allons exécuter manuellement le programme en cliquant sur le bouton se trouvant en début de chaîne:

[[fichier:Rasp-Node-Red-picam-mail-34.png]]

Nous allons ensuite afficher l'onglet "Debug" sur le coté droit de la page et analyser les données récupérées:

[[fichier:Rasp-Node-Red-picam-mail-35.png]]

==== Analyse des données récupérées dans l'onglet "Debug" ====

<syntaxhighlight lang="bash">
08/05/2017 à 12:54:31 node: FORMATAGE
MCHobby - Photo bureau : msg : Object
object
_msgid: "81efe35c.3208d"
topic: "MCHobby - Photo bureau"
payload: "<html>↵ <head>↵ <meta charset="utf8"/>↵ ↵ </head>↵ <body>↵ <h1>MCHobby - Photo bureau</h1>↵ <p>Cette photo est un instantané pris dans les bureaux de MCHobby.</p>↵
<img src="data:image/jpg;base64,/9j/4WP6x2.../>"
</syntaxhighlight>

Comme vous pourrez le constater, chaque élément du noeud est détaillé.
Les données sont cependant tronquées, le noeud "Debug" ne nous fourni pas la totalité du "PayLoad" mais nous avons déjà un bon aperçu des données qu'il contient.

* '''_msgid:''' est un Id unique de message
* '''topic:''' est le sujet du mail, nous l'avons déterminé dans le premier bloc
* '''payload:''' contient les données du message formatées par le template que nous avons créé et complété par l'image en base64.

{{tmbox | text = Les noeuds "Debug" sont pratiques. Ils nous permettent d'afficher une partie ou la totalité du flux tel qu'il est à l'endroit ou ils sont placés. Cela peut permettre d'identifier et de résoudre plus facilement des problèmes dans des opérations plus complexes et dans notre cas, cela nous permet de mieux comprendre comment fonctionne le noeud et comment les données sont transmises d'un bloc à l'autre.}}

=== Création d'un expéditeur ===

Nous avons construit petit à petit un message avec un sujet, mais il manque encore un détail: l'expéditeur de l'email que nous allons envoyer: le fameux "msg.from" que nous avons évoqué au début de tuto !

Si vous avez bien suivi les étapes précédentes du tuto, jusqu'au noeud "Debug" et à son résultat, vous comprendrez facilement la démarche ci après pour ajouter un expéditeur dans le flux.

Nous allons ajouter un nouveau noeud "Template" dans la zone de travail et double cliquer dessus pour afficher sa page de configuration:

[[fichier:Rasp-Node-Red-picam-mail-39.png]]

Nous allons ensuite sélectionner le type de propriété que nous souhaitons injecter dans le flux: '''"msg.from"'''

[[fichier:Rasp-Node-Red-picam-mail-40.png]]

Cette propriété étant une adresse email, nous allons choisir le type '''"plaintext"''' comme type de données.

[[fichier:Rasp-Node-Red-picam-mail-41.png]]

Nous allons enfin donner un nom explicite à notre bloc afin d'identifier facilement sa fonctionnalité parmi les autres blocs.

[[fichier:Rasp-Node-Red-picam-mail-42.png]]

{{Rasp-Node-Red-TRAILER}}

Rasp-Node-Red-picam-mail

2017-05-08T13:18:07Z

AntoineWrt : /* Création d'un expéditeur */

{{Rasp-Node-Red-NAV}}

{{traduction}}

== PiCamRED - Envoi périodique de photos par email avec PiCam et NodeRED ==

[[fichier:Rasp-Node-Red-picam-mail-01.png|900px]]

=== Description du projet ===

Dans ce tutoriel, nous allons réaliser des photos à l'aide de la caméra du RaspBerry Pi 2/3 et envoyer ces clichés par email de manière périodique grâce à NodeRED.
Nous allons donc utiliser plusieurs blocs et décrire de manière détaillée le déroulement de chaque étape de la réalisation de ce projet.

Dans NodeRED, il est important de bien identifier la finalité de notre projet afin de connaître au préalable tous les éléments qu'il faudra créer et fournir à l'action finale (celle qui enverra un email).

=== Quels sont les besoins du noeud email ===

==== Composants nécessaires pour constituer un email ====

Un email est composé des éléments suivants:

* Un expéditeur
* Un destinataire
* Un sujet
* Le corps du message

Tous ces éléments vont donc devoir être préparés afin de pouvoir construire le message à envoyer par le noeud final.

Le noeud final aura aussi besoin d'un serveur SMTP (serveur d'envoi d'emails) et éventuellement de paramètres d'identification pour ce serveur d'envoi d'emails.

==== Détail des besoins du noeud email ====

La liste des éléments nécessaires s'affiche lorsque le bloc est dans la zone de travail (Schema).
Commençons donc par sélectionner le bloc email, et de le glisser dans la zone de travail.

Commençons par cliquer sur le bloc email et nous maintenons le clic pour le glisser à droite dans l'espace de travail.

(on choisit celui qui a son point de liaison à gauche, car nous voulons un bloc de sortie)

[[fichier:Rasp-Node-Red-picam-mail-36.png]]

Glissons le dans l'espace de travail, et cliquons un clic simple pour le sélectionner.

[[fichier:Rasp-Node-Red-picam-mail-37.png]]

Ensuite, dans la colonne à droite de cet espace de travail, nous cliquons sur info et nous pourrons découvrir les éléments nécessaires à la constitution d'un bloc email.

[[fichier:Rasp-Node-Red-picam-mail-38.png]]

===== Nous utiliserons les champs suivants =====

* '''msg.payload''' --> Ce champ contient le corps de l'email
* '''msg.topic''' --> Ce champ contient le sujet de l'email
* '''msg.from''' --> Ce champ contient l'email de l'expéditeur
* '''msg.to''' --> Ce champ contient l'email du destinataire

Les autres champs ne seront pas utilisés dans notre cas, mais vous pourrez constater que le bloc email est complet de part ses fonctionnalités et possibilités.

Les données de serveur et d'identification seront abordées en fin de tuto lors de la configuration finale du bloc.

Nous allons maintenant passer à la réalisation du flux en commençant par le début de celui-ci.

=== Création d'une action périodique ===

Dans la colonne de gauche de NodeRED, se trouvent une liste de blocs à utiliser pour réaliser vos projets. Ils sont classés par "types".

Ainsi nous retrouvons les "types" suivants:

* Input qui contient tous les blocs d'entrées
* Ouput qui contient tous les blocs de sortie
* Function qui contient des blocs de fonctions javascript etc...
* Social qui sont des blocs d'entrée ou sorties depuis ou vers les réseaux sociaux
* Storage qui sont des fonctions de lecture ou d'écriture de fichiers
* Analysis ->> Sentiment interprète du texte et détermine un score sur base d'un dictionnaire anglais, renvoie le texte avec ce score de -5 à +5, déterminant ainsi l'émotion susceptible d'être procuré par ce texte
* Advanced possède des outils permettant de détecter des changements dans des fichiers ou dossiers, de lire des flux RSS ou encore EXEC qui permet d'exécuter directement des commandes sous linux !
* Raspberry Pi contient des outils pour piloter/lire le GPIO du raspberry Pi
* Network qui contient un outil réseau de Ping

Nous allons créer une action périodique, c'est à dire paramétrer un bloc "INJECT" de manière à déclencher régulièrement une chaine d'actions que nous allons accrocher à la suite les unes après les autres.
Nous allons donc cliquer sur le bloc "Inject" dans la liste "Input" et maintenir ce clic pour le déplacer vers la zone de travail.

[[fichier:Rasp-Node-Red-picam-mail-02.png]]

Nous obtiendrons donc une nouvelle instance "inject" qui portera le nom "Timestamp" (ce nom est attribué par défaut par NodeRED) comme dans la capture ci-dessous

[[fichier:Rasp-Node-Red-picam-mail-03.png]]

Nous allons maintenant double-cliquer sur celle-ci fin de l'éditer pour voir apparaitre le menu ci-dessous

[[fichier:Rasp-Node-Red-picam-mail-04.png]]

Il va falloir configurer ce bloc, mais avant tout voici une explication de celui-ci:

==== Payload ====

Le champs PayLoad est en fait le champ de données qui sera suivi d'un noeud à l'autre jusque à la fin de la chaine.
Dans ce module "inject", nous allons donc déterminer quel type de données contiendra le "PayLoad" jusqu'à la fin de la chaine que l'on va réaliser.

Dans notre cas, nous souhaitons construire un email, donc du contenu textuel, nous allons donc choisir "String" ce qui correspond à une chaine de caractères (du texte).

[[fichier:Rasp-Node-Red-picam-mail-05.png]]

==== Topic ====

Le champs "Topic" est un champs de texte dans lequel nous allons mettre un sujet succinct décrivant notre chaine.
Dans notre cas, ce sujet fera office de sujet au mail que nous expédierons.
Nous allons donc être précis en un minimum de mots pour que le destinataire de l'email puisse facilement deviner le contenu de celui-ci.

[[fichier:Rasp-Node-Red-picam-mail-06.png]]

==== Repeat ====

Nous allons ensuite choisir l'intervalle de déclenchement de notre action, sachant que nous avons le choix entre:

* none : pas de déclenchement périodique programmé
* interval : nous fixons un temps de déclenchement à partir du lancement du programme, l'action se réalisera à chaque fois que ce temps sera écoulé de manière répétée jusqu'à l'interruption manuelle du programme
* interval between times : nous fixons ici le déclenchement par interval, mais nous fixons aussi une fourchette d'heures et des jours pendant lesquels nous exécutons cet interval
* at a specific time : nous fixons une heure d'exécution, et un ou plusieurs jours d'exécution. Dans ce cas l'action n'est pas répétée en continu mais éxécutée une seule fois par jour à l'heure programmée

Dans notre exemple, nous allons fixer un intervalle de 15 secondes pour commencer. Nous pourrons ensuite augmenter cette valeur pour éviter de recevoir trop d'emails avec des photos :D

[[fichier:Rasp-Node-Red-picam-mail-07.png]]

La case "inject once at start" permet de ne pas attendre le premier cycle avant d'exécuter une première fois l'action. Elle se lancera dès le lancement du programme, puis périodiquement selon les cycles déterminés par l'intervalle.

[[fichier:Rasp-Node-Red-picam-mail-08.png]]

==== Name ====

Le champs Name va déterminer le nom que portera le bloc dans l'espace de travail et dans les logs (si nous créons des blocs de log ensuite pour contrôler des étapes).
Il est important de bien établir ce nom de manière explicite, car le nom des blocs permettra de comprendre et retrouver facilement la logique du schéma construit, même si l'on a pas consulté celui-ci pendant une longue période.

[[fichier:Rasp-Node-Red-picam-mail-09.png]]

=== Capture d'une image depuis la PiCam ===

Nous allons aller à l'essentiel en ce qui concerne la capture photo en utilisant une commande simple pour prendre un cliché et renvoyer celui-ci dans le flux NodeRED grâce à un bloc permettant d'exécuter des commandes bash.

{{ambox | text = Vous trouverez un TUTO détaillé sur la PiCam vous permettant de prendre la main, ou de la paramétrer si vous n'avez pas encore utilisé celle-ci auparavant: ....___TUTO___...}}

Nous allons tout d'abord cliquer sur le bloc "Exec" dans la section "Advanced" de la colonne de gauche et glisser l'élément dans la zone de travail.

[[fichier:Rasp-Node-Red-picam-mail-10.png]]

Ensuite, cliquer sur le bloc nouvellement créé et configurer celui-ci.

[[fichier:Rasp-Node-Red-picam-mail-11.png]]

Le menu suivant s'affichera, et nous pourrons configurer le bloc "Exec" nouvellement créé.

==== Command ====

Nous allons y ajouter la commande à exécuter pour prendre une photo avec la caméra du Raspberry Pi et la stocker dans un fichier jpg dans le dossier /tmp/ de linux.

<syntaxhighlight lang="python">
raspistill -o /tmp/cam.jpg -w 640 -h 480
</syntaxhighlight>

Nous prenons soin de limiter la hauteur et la largeur de l'image afin de réduire son poids pour l'envoi par email.

[[fichier:Rasp-Node-Red-picam-mail-12.png]]

==== +Append ====

Ensuite, nous allons décocher la case "msg.payload" si elle est cochée par défaut.

[[fichier:Rasp-Node-Red-picam-mail-13.png]]

==== Extra input parameters et Timeout ====

Nous n'aurons pas besoin de compléter ces champs pour notre projet.

Si vous cochez le champ "Use spawn() instead of exec()?", votre commande sera réalisée sous forme d'un processus résident et continuera de s'exécuter jusqu'à ce qu'elle se termine par elle-même (sauf si elle ne se termine jamais).
Cette solution implique que le programme n'attendra pas que cette commande soit réalisée pour passer aux étapes suivantes.
Si la suite de l'exécution de votre flux est susceptible d'utiliser le résultat de cette commande, nous vous déconseillons d'utiliser cette option sous peine de provoquer des erreurs à la suite du traitement du flux.

Le champ "Timeout" permet de définir un temps d'attente maximum avant de mettre un terme à l'exécution de la commande.
Cela permet de débloquer la situation si la commande exécutée prends un temps anormalement long à s'exécuter.

==== Name ====

Nous allons ensuite compléter le champs nom, celui-ci sera utilisé pour nommer le bloc dans le "schéma", mais aussi de nommer les logs comme pour le bloc "Exec".

[[fichier:Rasp-Node-Red-picam-mail-14.png]]

=== Encodage de l'image en base64 ===

Nous allons convertir la photo prise juste avant en utilisant une commande de conversion en base64.
Cela facilitera son injection dans un template HTML que nous allons créer ensuite pour construire un email.

Nous allons tout d'abord cliquer sur le bloc "Exec" dans la section "Advanced" de la colonne de gauche et glisser l'élément dans la zone de travail.

[[fichier:Rasp-Node-Red-picam-mail-10.png]]

Ensuite, cliquer sur le bloc nouvellement créé et configurer celui-ci.

[[fichier:Rasp-Node-Red-picam-mail-11.png]]

Le menu suivant s'affichera, et nous pourrons configurer le bloc "Exec" nouvellement créé.

[[fichier:Rasp-Node-Red-picam-mail-15.png]]

==== Command ====

Nous allons y ajouter la commande à exécuter pour encoder en base 64 la photo prise précédemment avec la caméra du Raspberry Pi.

<syntaxhighlight lang="python">
base64 -i "/tmp/cam.jpg"
</syntaxhighlight>

[[fichier:Rasp-Node-Red-picam-mail-16.png]]

==== +Append ====

Ensuite, nous allons cocher la case "msg.payload" si elle n'est pas cochée par défaut pour que le résultat soit directement renvoyé par cette commande dans le "PayLoad" du flux.

[[fichier:Rasp-Node-Red-picam-mail-17.png]]

==== Extra input parameters et Timeout ====

Nous n'aurons pas besoin de compléter ces champs pour notre projet.

Si vous cochez le champ "Use spawn() instead of exec()?", votre commande sera réalisée sous forme d'un processus résident et continuera de s'exécuter jusqu'à ce qu'elle se termine par elle-même (sauf si elle ne se termine jamais).
Cette solution implique que le programme n'attendra pas que cette commande soit réalisée pour passer aux étapes suivantes.
Si la suite de l'exécution de votre flux est susceptible d'utiliser le résultat de cette commande, nous vous déconseillons d'utiliser cette option sous peine de provoquer des erreurs à la suite du traitement du flux.

[[fichier:Rasp-Node-Red-picam-mail-18.png]]

Le champ "Timeout" permet de définir un temps d'attente maximum avant de mettre un terme à l'exécution de la commande.
Cela permet de débloquer la situation si la commande exécutée prends un temps anormalement long à s'exécuter.

[[fichier:Rasp-Node-Red-picam-mail-19.png]]

==== Name ====

Nous allons ensuite compléter le champs nom, celui-ci sera utilisé pour nommer le bloc dans le "schéma", mais aussi de nommer les logs comme pour le bloc "Exec".

[[fichier:Rasp-Node-Red-picam-mail-20.png]]

=== Création d'un email au format HTML ===

Nous allons maintenant créer un template d'email au format HTML afin de mettre en forme le message que nous enverrons ensuite.
Nous allons pour cela utiliser un bloc "Template".

[[fichier:Rasp-Node-Red-picam-mail-21.png]]

==== Name ====

Nous allons attribuer un nom au bloc afin de l'identifier plus facilement dans le flux.
Nous allons donc le nommer "Contenu du mail" puisque nous créons le contenu du mail que nous enverrons ensuite.

[[fichier:Rasp-Node-Red-picam-mail-22.png]]

==== Set property ====

La propriété que nous souhaitons créer dans le flux est le "PayLoad".
Ce PayLoad existe déjà, il contient pour le moment l'image au format "Base64" précédemment encodé.
Cela n'est pas un problème, après notre noeud (notre bloc), le PayLoad sera intégralement remplacé par le template que nous sommes en train de créer.

[[fichier:Rasp-Node-Red-picam-mail-23.png]]

==== Template ====

Dans ce template, nous allons créer une structure HTML de base minimum afin que la structure soit interprétée par la majorité des clients/webmail.
Vous pouvez la personnaliser à votre guise si vous avez les connaissances en HTML.

Voici la structure de base pour notre projet:

<syntaxhighlight lang="html">
<html>
<head>
<meta charset="utf8"/>
</head>
<body>
<h1>Projet Photo par email</h1>
<img src="data:image/jpg;base64,{{payload}}"/>
</body>
</html>
</syntaxhighlight>

Vous pourrez remarquer que nous intégrons l'image en appelant le PayLoad à 'intérieur du code HTML dans la balise <img>.
C'est le PayLoad créé précédemment par le bloc "Exec" qui est récupéré à ce moment précis.
Ce PayLoad est remplacé dans le flux par le PayLoad complet avec notre template dans le flux par notre bloc Template.

[[fichier:Rasp-Node-Red-picam-mail-24.png]]

=== Création d'un bloc (noeud) "Debug" ===

Nous allons ajouter la notion d'expéditeur dans le flux que nous avons créé à travers nos blocs (noeuds).
Pour rappel, actuellement nous avons deux propriétés avec des données dans notre flux.
Si nous voulons observer ce que nous avons créé jusque là, nous pouvons faire appel à un bloc "Debug".

==== Création du bloc "Debug" ====

Comme pour les blocs précédents, nous allons glisser/déposer un bloc débug dans l'espace de travail.

[[fichier:Rasp-Node-Red-picam-mail-25.png]]

Celui-ci s'appelle msg/payload par défaut

[[fichier:Rasp-Node-Red-picam-mail-26.png]]

Nous allons double-cliquer sur ce bloc pour le configurer.

[[fichier:Rasp-Node-Red-picam-mail-27.png]]

==== Output ====

Dans ce champs, nous allons choisir la partie du flux que nous souhaitons afficher, ou nous allons sélectionner le flux entier.

[[fichier:Rasp-Node-Red-picam-mail-28.png]]

Sélectionner le flux entier, nous affichera le flux complet incluant toutes ses propriétés.

[[fichier:Rasp-Node-Red-picam-mail-29.png]]

==== To =====

La propriété "To" nous permet de choisir ou nous souhaitons afficher les données que nous récupérons.
Soit nous les affichons uniquement dans l'onglet "Debug" à droite de l'espace de travail, soit nous l'affichons dans cet onglet mais aussi dans la console de NodeJS.
Dans notre cas, nous allons nous contenter d'afficher nos éléments dans l'onglet de "Debug" à droite de notre espace de travail.

[[fichier:Rasp-Node-Red-picam-mail-30.png]]

==== Name ====

Le champs Name nous servira à identifier quel bloc de "Debug" affiche les données en console ou dans l'onglet "Debug".
Il faut donc le nommer efficacement pour bien attacher et comprendre les données que nous récupérons, surtout si nous en plaçons plusieurs dans le flux.

[[fichier:Rasp-Node-Red-picam-mail-31.png]]

==== Exploitation et compréhension des données récupérées ====

Nous avons placé notre bloc "Debug" à la suite du flux en dernière position.

[[fichier:Rasp-Node-Red-picam-mail-32.png]]

Nous allons donc déployer le programme en cliquant sur "Deploy" en haut à droite de la page.

[[fichier:Rasp-Node-Red-picam-mail-33.png]]

Ensuite, nous allons exécuter manuellement le programme en cliquant sur le bouton se trouvant en début de chaîne:

[[fichier:Rasp-Node-Red-picam-mail-34.png]]

Nous allons ensuite afficher l'onglet "Debug" sur le coté droit de la page et analyser les données récupérées:

[[fichier:Rasp-Node-Red-picam-mail-35.png]]

==== Analyse des données récupérées dans l'onglet "Debug" ====

<syntaxhighlight lang="bash">
08/05/2017 à 12:54:31 node: FORMATAGE
MCHobby - Photo bureau : msg : Object
object
_msgid: "81efe35c.3208d"
topic: "MCHobby - Photo bureau"
payload: "<html>↵ <head>↵ <meta charset="utf8"/>↵ ↵ </head>↵ <body>↵ <h1>MCHobby - Photo bureau</h1>↵ <p>Cette photo est un instantané pris dans les bureaux de MCHobby.</p>↵
<img src="data:image/jpg;base64,/9j/4WP6x2.../>"
</syntaxhighlight>

Comme vous pourrez le constater, chaque élément du noeud est détaillé.
Les données sont cependant tronquées, le noeud "Debug" ne nous fourni pas la totalité du "PayLoad" mais nous avons déjà un bon aperçu des données qu'il contient.

* '''_msgid:''' est un Id unique de message
* '''topic:''' est le sujet du mail, nous l'avons déterminé dans le premier bloc
* '''payload:''' contient les données du message formatées par le template que nous avons créé et complété par l'image en base64.

{{tmbox | text = Les noeuds "Debug" sont pratiques. Ils nous permettent d'afficher une partie ou la totalité du flux tel qu'il est à l'endroit ou ils sont placés. Cela peut permettre d'identifier et de résoudre plus facilement des problèmes dans des opérations plus complexes et dans notre cas, cela nous permet de mieux comprendre comment fonctionne le noeud et comment les données sont transmises d'un bloc à l'autre.}}

=== Création d'un expéditeur ===

Nous avons construit petit à petit un message avec un sujet, mais il manque encore un détail: l'expéditeur de l'email que nous allons envoyer: le fameux "msg.from" que nous avons évoqué au début de tuto !

Si vous avez bien suivi les étapes précédentes du tuto, jusqu'au noeud "Debug" et à son résultat, vous comprendrez facilement la démarche ci après pour ajouter un expéditeur dans le flux.

Nous allons ajouter un nouveau noeud "Template" dans la zone de travail et double cliquer dessus pour afficher sa page de configuration:

[[fichier:Rasp-Node-Red-picam-mail-39.png]]

Nous allons ensuite sélectionner le type de propriété que nous souhaitons injecter dans le flux: '''"msg.from"'''

[[fichier:Rasp-Node-Red-picam-mail-40.png]]

Cette propriété étant une adresse email, nous allons choisir le type '''"plaintext"''' comme type de données.

[[fichier:Rasp-Node-Red-picam-mail-41.png]]

Nous allons enfin donner un nom explicite à notre bloc afin d'identifier facilement sa fonctionnalité parmi les autres blocs.

[[fichier:Rasp-Node-Red-picam-mail-42.png]]

{{Rasp-Node-Red-TRAILER}}

Fichier:Rasp-Node-Red-picam-mail-42.png

2017-05-08T13:17:41Z

AntoineWrt :

Fichier:Rasp-Node-Red-picam-mail-41.png

2017-05-08T13:17:26Z

AntoineWrt :

Fichier:Rasp-Node-Red-picam-mail-40.png

2017-05-08T13:17:00Z

AntoineWrt : AntoineWrt a téléversé une nouvelle version de Fichier:Rasp-Node-Red-picam-mail-40.png

Fichier:Rasp-Node-Red-picam-mail-40.png

2017-05-08T13:15:47Z

AntoineWrt :

Fichier:Rasp-Node-Red-picam-mail-39.png

2017-05-08T13:11:51Z

AntoineWrt :

Rasp-Node-Red-picam-mail

2017-05-08T13:10:46Z

AntoineWrt :

{{Rasp-Node-Red-NAV}}

{{traduction}}

== PiCamRED - Envoi périodique de photos par email avec PiCam et NodeRED ==

[[fichier:Rasp-Node-Red-picam-mail-01.png|900px]]

=== Description du projet ===

Dans ce tutoriel, nous allons réaliser des photos à l'aide de la caméra du RaspBerry Pi 2/3 et envoyer ces clichés par email de manière périodique grâce à NodeRED.
Nous allons donc utiliser plusieurs blocs et décrire de manière détaillée le déroulement de chaque étape de la réalisation de ce projet.

Dans NodeRED, il est important de bien identifier la finalité de notre projet afin de connaître au préalable tous les éléments qu'il faudra créer et fournir à l'action finale (celle qui enverra un email).

=== Quels sont les besoins du noeud email ===

==== Composants nécessaires pour constituer un email ====

Un email est composé des éléments suivants:

* Un expéditeur
* Un destinataire
* Un sujet
* Le corps du message

Tous ces éléments vont donc devoir être préparés afin de pouvoir construire le message à envoyer par le noeud final.

Le noeud final aura aussi besoin d'un serveur SMTP (serveur d'envoi d'emails) et éventuellement de paramètres d'identification pour ce serveur d'envoi d'emails.

==== Détail des besoins du noeud email ====

La liste des éléments nécessaires s'affiche lorsque le bloc est dans la zone de travail (Schema).
Commençons donc par sélectionner le bloc email, et de le glisser dans la zone de travail.

Commençons par cliquer sur le bloc email et nous maintenons le clic pour le glisser à droite dans l'espace de travail.

(on choisit celui qui a son point de liaison à gauche, car nous voulons un bloc de sortie)

[[fichier:Rasp-Node-Red-picam-mail-36.png]]

Glissons le dans l'espace de travail, et cliquons un clic simple pour le sélectionner.

[[fichier:Rasp-Node-Red-picam-mail-37.png]]

Ensuite, dans la colonne à droite de cet espace de travail, nous cliquons sur info et nous pourrons découvrir les éléments nécessaires à la constitution d'un bloc email.

[[fichier:Rasp-Node-Red-picam-mail-38.png]]

===== Nous utiliserons les champs suivants =====

* '''msg.payload''' --> Ce champ contient le corps de l'email
* '''msg.topic''' --> Ce champ contient le sujet de l'email
* '''msg.from''' --> Ce champ contient l'email de l'expéditeur
* '''msg.to''' --> Ce champ contient l'email du destinataire

Les autres champs ne seront pas utilisés dans notre cas, mais vous pourrez constater que le bloc email est complet de part ses fonctionnalités et possibilités.

Les données de serveur et d'identification seront abordées en fin de tuto lors de la configuration finale du bloc.

Nous allons maintenant passer à la réalisation du flux en commençant par le début de celui-ci.

=== Création d'une action périodique ===

Dans la colonne de gauche de NodeRED, se trouvent une liste de blocs à utiliser pour réaliser vos projets. Ils sont classés par "types".

Ainsi nous retrouvons les "types" suivants:

* Input qui contient tous les blocs d'entrées
* Ouput qui contient tous les blocs de sortie
* Function qui contient des blocs de fonctions javascript etc...
* Social qui sont des blocs d'entrée ou sorties depuis ou vers les réseaux sociaux
* Storage qui sont des fonctions de lecture ou d'écriture de fichiers
* Analysis ->> Sentiment interprète du texte et détermine un score sur base d'un dictionnaire anglais, renvoie le texte avec ce score de -5 à +5, déterminant ainsi l'émotion susceptible d'être procuré par ce texte
* Advanced possède des outils permettant de détecter des changements dans des fichiers ou dossiers, de lire des flux RSS ou encore EXEC qui permet d'exécuter directement des commandes sous linux !
* Raspberry Pi contient des outils pour piloter/lire le GPIO du raspberry Pi
* Network qui contient un outil réseau de Ping

Nous allons créer une action périodique, c'est à dire paramétrer un bloc "INJECT" de manière à déclencher régulièrement une chaine d'actions que nous allons accrocher à la suite les unes après les autres.
Nous allons donc cliquer sur le bloc "Inject" dans la liste "Input" et maintenir ce clic pour le déplacer vers la zone de travail.

[[fichier:Rasp-Node-Red-picam-mail-02.png]]

Nous obtiendrons donc une nouvelle instance "inject" qui portera le nom "Timestamp" (ce nom est attribué par défaut par NodeRED) comme dans la capture ci-dessous

[[fichier:Rasp-Node-Red-picam-mail-03.png]]

Nous allons maintenant double-cliquer sur celle-ci fin de l'éditer pour voir apparaitre le menu ci-dessous

[[fichier:Rasp-Node-Red-picam-mail-04.png]]

Il va falloir configurer ce bloc, mais avant tout voici une explication de celui-ci:

==== Payload ====

Le champs PayLoad est en fait le champ de données qui sera suivi d'un noeud à l'autre jusque à la fin de la chaine.
Dans ce module "inject", nous allons donc déterminer quel type de données contiendra le "PayLoad" jusqu'à la fin de la chaine que l'on va réaliser.

Dans notre cas, nous souhaitons construire un email, donc du contenu textuel, nous allons donc choisir "String" ce qui correspond à une chaine de caractères (du texte).

[[fichier:Rasp-Node-Red-picam-mail-05.png]]

==== Topic ====

Le champs "Topic" est un champs de texte dans lequel nous allons mettre un sujet succinct décrivant notre chaine.
Dans notre cas, ce sujet fera office de sujet au mail que nous expédierons.
Nous allons donc être précis en un minimum de mots pour que le destinataire de l'email puisse facilement deviner le contenu de celui-ci.

[[fichier:Rasp-Node-Red-picam-mail-06.png]]

==== Repeat ====

Nous allons ensuite choisir l'intervalle de déclenchement de notre action, sachant que nous avons le choix entre:

* none : pas de déclenchement périodique programmé
* interval : nous fixons un temps de déclenchement à partir du lancement du programme, l'action se réalisera à chaque fois que ce temps sera écoulé de manière répétée jusqu'à l'interruption manuelle du programme
* interval between times : nous fixons ici le déclenchement par interval, mais nous fixons aussi une fourchette d'heures et des jours pendant lesquels nous exécutons cet interval
* at a specific time : nous fixons une heure d'exécution, et un ou plusieurs jours d'exécution. Dans ce cas l'action n'est pas répétée en continu mais éxécutée une seule fois par jour à l'heure programmée

Dans notre exemple, nous allons fixer un intervalle de 15 secondes pour commencer. Nous pourrons ensuite augmenter cette valeur pour éviter de recevoir trop d'emails avec des photos :D

[[fichier:Rasp-Node-Red-picam-mail-07.png]]

La case "inject once at start" permet de ne pas attendre le premier cycle avant d'exécuter une première fois l'action. Elle se lancera dès le lancement du programme, puis périodiquement selon les cycles déterminés par l'intervalle.

[[fichier:Rasp-Node-Red-picam-mail-08.png]]

==== Name ====

Le champs Name va déterminer le nom que portera le bloc dans l'espace de travail et dans les logs (si nous créons des blocs de log ensuite pour contrôler des étapes).
Il est important de bien établir ce nom de manière explicite, car le nom des blocs permettra de comprendre et retrouver facilement la logique du schéma construit, même si l'on a pas consulté celui-ci pendant une longue période.

[[fichier:Rasp-Node-Red-picam-mail-09.png]]

=== Capture d'une image depuis la PiCam ===

Nous allons aller à l'essentiel en ce qui concerne la capture photo en utilisant une commande simple pour prendre un cliché et renvoyer celui-ci dans le flux NodeRED grâce à un bloc permettant d'exécuter des commandes bash.

{{ambox | text = Vous trouverez un TUTO détaillé sur la PiCam vous permettant de prendre la main, ou de la paramétrer si vous n'avez pas encore utilisé celle-ci auparavant: ....___TUTO___...}}

Nous allons tout d'abord cliquer sur le bloc "Exec" dans la section "Advanced" de la colonne de gauche et glisser l'élément dans la zone de travail.

[[fichier:Rasp-Node-Red-picam-mail-10.png]]

Ensuite, cliquer sur le bloc nouvellement créé et configurer celui-ci.

[[fichier:Rasp-Node-Red-picam-mail-11.png]]

Le menu suivant s'affichera, et nous pourrons configurer le bloc "Exec" nouvellement créé.

==== Command ====

Nous allons y ajouter la commande à exécuter pour prendre une photo avec la caméra du Raspberry Pi et la stocker dans un fichier jpg dans le dossier /tmp/ de linux.

<syntaxhighlight lang="python">
raspistill -o /tmp/cam.jpg -w 640 -h 480
</syntaxhighlight>

Nous prenons soin de limiter la hauteur et la largeur de l'image afin de réduire son poids pour l'envoi par email.

[[fichier:Rasp-Node-Red-picam-mail-12.png]]

==== +Append ====

Ensuite, nous allons décocher la case "msg.payload" si elle est cochée par défaut.

[[fichier:Rasp-Node-Red-picam-mail-13.png]]

==== Extra input parameters et Timeout ====

Nous n'aurons pas besoin de compléter ces champs pour notre projet.

Si vous cochez le champ "Use spawn() instead of exec()?", votre commande sera réalisée sous forme d'un processus résident et continuera de s'exécuter jusqu'à ce qu'elle se termine par elle-même (sauf si elle ne se termine jamais).
Cette solution implique que le programme n'attendra pas que cette commande soit réalisée pour passer aux étapes suivantes.
Si la suite de l'exécution de votre flux est susceptible d'utiliser le résultat de cette commande, nous vous déconseillons d'utiliser cette option sous peine de provoquer des erreurs à la suite du traitement du flux.

Le champ "Timeout" permet de définir un temps d'attente maximum avant de mettre un terme à l'exécution de la commande.
Cela permet de débloquer la situation si la commande exécutée prends un temps anormalement long à s'exécuter.

==== Name ====

Nous allons ensuite compléter le champs nom, celui-ci sera utilisé pour nommer le bloc dans le "schéma", mais aussi de nommer les logs comme pour le bloc "Exec".

[[fichier:Rasp-Node-Red-picam-mail-14.png]]

=== Encodage de l'image en base64 ===

Nous allons convertir la photo prise juste avant en utilisant une commande de conversion en base64.
Cela facilitera son injection dans un template HTML que nous allons créer ensuite pour construire un email.

Nous allons tout d'abord cliquer sur le bloc "Exec" dans la section "Advanced" de la colonne de gauche et glisser l'élément dans la zone de travail.

[[fichier:Rasp-Node-Red-picam-mail-10.png]]

Ensuite, cliquer sur le bloc nouvellement créé et configurer celui-ci.

[[fichier:Rasp-Node-Red-picam-mail-11.png]]

Le menu suivant s'affichera, et nous pourrons configurer le bloc "Exec" nouvellement créé.

[[fichier:Rasp-Node-Red-picam-mail-15.png]]

==== Command ====

Nous allons y ajouter la commande à exécuter pour encoder en base 64 la photo prise précédemment avec la caméra du Raspberry Pi.

<syntaxhighlight lang="python">
base64 -i "/tmp/cam.jpg"
</syntaxhighlight>

[[fichier:Rasp-Node-Red-picam-mail-16.png]]

==== +Append ====

Ensuite, nous allons cocher la case "msg.payload" si elle n'est pas cochée par défaut pour que le résultat soit directement renvoyé par cette commande dans le "PayLoad" du flux.

[[fichier:Rasp-Node-Red-picam-mail-17.png]]

==== Extra input parameters et Timeout ====

Nous n'aurons pas besoin de compléter ces champs pour notre projet.

Si vous cochez le champ "Use spawn() instead of exec()?", votre commande sera réalisée sous forme d'un processus résident et continuera de s'exécuter jusqu'à ce qu'elle se termine par elle-même (sauf si elle ne se termine jamais).
Cette solution implique que le programme n'attendra pas que cette commande soit réalisée pour passer aux étapes suivantes.
Si la suite de l'exécution de votre flux est susceptible d'utiliser le résultat de cette commande, nous vous déconseillons d'utiliser cette option sous peine de provoquer des erreurs à la suite du traitement du flux.

[[fichier:Rasp-Node-Red-picam-mail-18.png]]

Le champ "Timeout" permet de définir un temps d'attente maximum avant de mettre un terme à l'exécution de la commande.
Cela permet de débloquer la situation si la commande exécutée prends un temps anormalement long à s'exécuter.

[[fichier:Rasp-Node-Red-picam-mail-19.png]]

==== Name ====

Nous allons ensuite compléter le champs nom, celui-ci sera utilisé pour nommer le bloc dans le "schéma", mais aussi de nommer les logs comme pour le bloc "Exec".

[[fichier:Rasp-Node-Red-picam-mail-20.png]]

=== Création d'un email au format HTML ===

Nous allons maintenant créer un template d'email au format HTML afin de mettre en forme le message que nous enverrons ensuite.
Nous allons pour cela utiliser un bloc "Template".

[[fichier:Rasp-Node-Red-picam-mail-21.png]]

==== Name ====

Nous allons attribuer un nom au bloc afin de l'identifier plus facilement dans le flux.
Nous allons donc le nommer "Contenu du mail" puisque nous créons le contenu du mail que nous enverrons ensuite.

[[fichier:Rasp-Node-Red-picam-mail-22.png]]

==== Set property ====

La propriété que nous souhaitons créer dans le flux est le "PayLoad".
Ce PayLoad existe déjà, il contient pour le moment l'image au format "Base64" précédemment encodé.
Cela n'est pas un problème, après notre noeud (notre bloc), le PayLoad sera intégralement remplacé par le template que nous sommes en train de créer.

[[fichier:Rasp-Node-Red-picam-mail-23.png]]

==== Template ====

Dans ce template, nous allons créer une structure HTML de base minimum afin que la structure soit interprétée par la majorité des clients/webmail.
Vous pouvez la personnaliser à votre guise si vous avez les connaissances en HTML.

Voici la structure de base pour notre projet:

<syntaxhighlight lang="html">
<html>
<head>
<meta charset="utf8"/>
</head>
<body>
<h1>Projet Photo par email</h1>
<img src="data:image/jpg;base64,{{payload}}"/>
</body>
</html>
</syntaxhighlight>

Vous pourrez remarquer que nous intégrons l'image en appelant le PayLoad à 'intérieur du code HTML dans la balise <img>.
C'est le PayLoad créé précédemment par le bloc "Exec" qui est récupéré à ce moment précis.
Ce PayLoad est remplacé dans le flux par le PayLoad complet avec notre template dans le flux par notre bloc Template.

[[fichier:Rasp-Node-Red-picam-mail-24.png]]

=== Création d'un bloc (noeud) "Debug" ===

Nous allons ajouter la notion d'expéditeur dans le flux que nous avons créé à travers nos blocs (noeuds).
Pour rappel, actuellement nous avons deux propriétés avec des données dans notre flux.
Si nous voulons observer ce que nous avons créé jusque là, nous pouvons faire appel à un bloc "Debug".

==== Création du bloc "Debug" ====

Comme pour les blocs précédents, nous allons glisser/déposer un bloc débug dans l'espace de travail.

[[fichier:Rasp-Node-Red-picam-mail-25.png]]

Celui-ci s'appelle msg/payload par défaut

[[fichier:Rasp-Node-Red-picam-mail-26.png]]

Nous allons double-cliquer sur ce bloc pour le configurer.

[[fichier:Rasp-Node-Red-picam-mail-27.png]]

==== Output ====

Dans ce champs, nous allons choisir la partie du flux que nous souhaitons afficher, ou nous allons sélectionner le flux entier.

[[fichier:Rasp-Node-Red-picam-mail-28.png]]

Sélectionner le flux entier, nous affichera le flux complet incluant toutes ses propriétés.

[[fichier:Rasp-Node-Red-picam-mail-29.png]]

==== To =====

La propriété "To" nous permet de choisir ou nous souhaitons afficher les données que nous récupérons.
Soit nous les affichons uniquement dans l'onglet "Debug" à droite de l'espace de travail, soit nous l'affichons dans cet onglet mais aussi dans la console de NodeJS.
Dans notre cas, nous allons nous contenter d'afficher nos éléments dans l'onglet de "Debug" à droite de notre espace de travail.

[[fichier:Rasp-Node-Red-picam-mail-30.png]]

==== Name ====

Le champs Name nous servira à identifier quel bloc de "Debug" affiche les données en console ou dans l'onglet "Debug".
Il faut donc le nommer efficacement pour bien attacher et comprendre les données que nous récupérons, surtout si nous en plaçons plusieurs dans le flux.

[[fichier:Rasp-Node-Red-picam-mail-31.png]]

==== Exploitation et compréhension des données récupérées ====

Nous avons placé notre bloc "Debug" à la suite du flux en dernière position.

[[fichier:Rasp-Node-Red-picam-mail-32.png]]

Nous allons donc déployer le programme en cliquant sur "Deploy" en haut à droite de la page.

[[fichier:Rasp-Node-Red-picam-mail-33.png]]

Ensuite, nous allons exécuter manuellement le programme en cliquant sur le bouton se trouvant en début de chaîne:

[[fichier:Rasp-Node-Red-picam-mail-34.png]]

Nous allons ensuite afficher l'onglet "Debug" sur le coté droit de la page et analyser les données récupérées:

[[fichier:Rasp-Node-Red-picam-mail-35.png]]

==== Analyse des données récupérées dans l'onglet "Debug" ====

<syntaxhighlight lang="bash">
08/05/2017 à 12:54:31 node: FORMATAGE
MCHobby - Photo bureau : msg : Object
object
_msgid: "81efe35c.3208d"
topic: "MCHobby - Photo bureau"
payload: "<html>↵ <head>↵ <meta charset="utf8"/>↵ ↵ </head>↵ <body>↵ <h1>MCHobby - Photo bureau</h1>↵ <p>Cette photo est un instantané pris dans les bureaux de MCHobby.</p>↵
<img src="data:image/jpg;base64,/9j/4WP6x2.../>"
</syntaxhighlight>

Comme vous pourrez le constater, chaque élément du noeud est détaillé.
Les données sont cependant tronquées, le noeud "Debug" ne nous fourni pas la totalité du "PayLoad" mais nous avons déjà un bon aperçu des données qu'il contient.

* '''_msgid:''' est un Id unique de message
* '''topic:''' est le sujet du mail, nous l'avons déterminé dans le premier bloc
* '''payload:''' contient les données du message formatées par le template que nous avons créé et complété par l'image en base64.

{{tmbox | text = Les noeuds "Debug" sont pratiques. Ils nous permettent d'afficher une partie ou la totalité du flux tel qu'il est à l'endroit ou ils sont placés. Cela peut permettre d'identifier et de résoudre plus facilement des problèmes dans des opérations plus complexes et dans notre cas, cela nous permet de mieux comprendre comment fonctionne le noeud et comment les données sont transmises d'un bloc à l'autre.}}

=== Création d'un expéditeur ===

Nous avons construit petit à petit un message avec un sujet, mais il manque encore un détail: l'expéditeur de l'email que nous allons envoyer: le fameux "msg.from" que nous avons évoqué au début de tuto !

Si vous avez bien suivi les étapes précédentes du tuto, jusqu'au noeud "Debug" et à son résultat, vous comprendrez facilement la démarche ci après pour ajouter un expéditeur dans le flux.

Nous allons ajouter un nouveau noeud "Template" dans la zone de travail et double cliquer dessus pour afficher sa page de configuration:

[[fichier:Rasp-Node-Red-picam-mail-39.png]]

Nous allons ensuite sélectionner le type de propriété que nous souhaitons injecter dans le flux: '''"msg.from"'''

[[fichier:Rasp-Node-Red-picam-mail-40.png]]

Cette propriété étant une adresse email, nous allons choisir le type '''"plaintext"''' comme type de données.

[[fichier:Rasp-Node-Red-picam-mail-41.png]]

Nous allons enfin donner un nom explicite à notre bloc afin d'identifier facilement sa fonctionnalité parmi les autres blocs.

[[fichier:Rasp-Node-Red-picam-mail-42.png]]

{{Rasp-Node-Red-TRAILER}}

Rasp-Node-Red-picam-mail

2017-05-08T13:07:17Z

AntoineWrt : /* Création d'un expéditeur */

{{Rasp-Node-Red-NAV}}

{{traduction}}

== PiCamRED - Envoi périodique de photos par email avec PiCam et NodeRED ==

[[fichier:Rasp-Node-Red-picam-mail-01.png|900px]]

=== Description du projet ===

Dans ce tutoriel, nous allons réaliser des photos à l'aide de la caméra du RaspBerry Pi 2/3 et envoyer ces clichés par email de manière périodique grâce à NodeRED.
Nous allons donc utiliser plusieurs blocs et décrire de manière détaillée le déroulement de chaque étape de la réalisation de ce projet.

Dans NodeRED, il est important de bien identifier la finalité de notre projet afin de connaître au préalable tous les éléments qu'il faudra créer et fournir à l'action finale (celle qui enverra un email).

=== Quels sont les besoins du noeud email ===

==== Composants nécessaires pour constituer un email ====

Un email est composé des éléments suivants:

* Un expéditeur
* Un destinataire
* Un sujet
* Le corps du message

Tous ces éléments vont donc devoir être préparés afin de pouvoir construire le message à envoyer par le noeud final.

Le noeud final aura aussi besoin d'un serveur SMTP (serveur d'envoi d'emails) et éventuellement de paramètres d'identification pour ce serveur d'envoi d'emails.

==== Détail des besoins du noeud email ====

La liste des éléments nécessaires s'affiche lorsque le bloc est dans la zone de travail (Schema).
Commençons donc par sélectionner le bloc email, et de le glisser dans la zone de travail.

Commençons par cliquer sur le bloc email et nous maintenons le clic pour le glisser à droite dans l'espace de travail.

(on choisit celui qui a son point de liaison à gauche, car nous voulons un bloc de sortie)

[[fichier:Rasp-Node-Red-picam-mail-36.png]]

Glissons le dans l'espace de travail, et cliquons un clic simple pour le sélectionner.

[[fichier:Rasp-Node-Red-picam-mail-37.png]]

Ensuite, dans la colonne à droite de cet espace de travail, nous cliquons sur info et nous pourrons découvrir les éléments nécessaires à la constitution d'un bloc email.

[[fichier:Rasp-Node-Red-picam-mail-38.png]]

===== Nous utiliserons les champs suivants =====

* '''msg.payload''' --> Ce champ contient le corps de l'email
* '''msg.topic''' --> Ce champ contient le sujet de l'email
* '''msg.from''' --> Ce champ contient l'email de l'expéditeur
* '''msg.to''' --> Ce champ contient l'email du destinataire

Les autres champs ne seront pas utilisés dans notre cas, mais vous pourrez constater que le bloc email est complet de part ses fonctionnalités et possibilités.

Les données de serveur et d'identification seront abordées en fin de tuto lors de la configuration finale du bloc.

Nous allons maintenant passer à la réalisation du flux en commençant par le début de celui-ci.

=== Création d'une action périodique ===

Dans la colonne de gauche de NodeRED, se trouvent une liste de blocs à utiliser pour réaliser vos projets. Ils sont classés par "types".

Ainsi nous retrouvons les "types" suivants:

* Input qui contient tous les blocs d'entrées
* Ouput qui contient tous les blocs de sortie
* Function qui contient des blocs de fonctions javascript etc...
* Social qui sont des blocs d'entrée ou sorties depuis ou vers les réseaux sociaux
* Storage qui sont des fonctions de lecture ou d'écriture de fichiers
* Analysis ->> Sentiment interprète du texte et détermine un score sur base d'un dictionnaire anglais, renvoie le texte avec ce score de -5 à +5, déterminant ainsi l'émotion susceptible d'être procuré par ce texte
* Advanced possède des outils permettant de détecter des changements dans des fichiers ou dossiers, de lire des flux RSS ou encore EXEC qui permet d'exécuter directement des commandes sous linux !
* Raspberry Pi contient des outils pour piloter/lire le GPIO du raspberry Pi
* Network qui contient un outil réseau de Ping

Nous allons créer une action périodique, c'est à dire paramétrer un bloc "INJECT" de manière à déclencher régulièrement une chaine d'actions que nous allons accrocher à la suite les unes après les autres.
Nous allons donc cliquer sur le bloc "Inject" dans la liste "Input" et maintenir ce clic pour le déplacer vers la zone de travail.

[[fichier:Rasp-Node-Red-picam-mail-02.png]]

Nous obtiendrons donc une nouvelle instance "inject" qui portera le nom "Timestamp" (ce nom est attribué par défaut par NodeRED) comme dans la capture ci-dessous

[[fichier:Rasp-Node-Red-picam-mail-03.png]]

Nous allons maintenant double-cliquer sur celle-ci fin de l'éditer pour voir apparaitre le menu ci-dessous

[[fichier:Rasp-Node-Red-picam-mail-04.png]]

Il va falloir configurer ce bloc, mais avant tout voici une explication de celui-ci:

==== Payload ====

Le champs PayLoad est en fait le champ de données qui sera suivi d'un noeud à l'autre jusque à la fin de la chaine.
Dans ce module "inject", nous allons donc déterminer quel type de données contiendra le "PayLoad" jusqu'à la fin de la chaine que l'on va réaliser.

Dans notre cas, nous souhaitons construire un email, donc du contenu textuel, nous allons donc choisir "String" ce qui correspond à une chaine de caractères (du texte).

[[fichier:Rasp-Node-Red-picam-mail-05.png]]

==== Topic ====

Le champs "Topic" est un champs de texte dans lequel nous allons mettre un sujet succinct décrivant notre chaine.
Dans notre cas, ce sujet fera office de sujet au mail que nous expédierons.
Nous allons donc être précis en un minimum de mots pour que le destinataire de l'email puisse facilement deviner le contenu de celui-ci.

[[fichier:Rasp-Node-Red-picam-mail-06.png]]

==== Repeat ====

Nous allons ensuite choisir l'intervalle de déclenchement de notre action, sachant que nous avons le choix entre:

* none : pas de déclenchement périodique programmé
* interval : nous fixons un temps de déclenchement à partir du lancement du programme, l'action se réalisera à chaque fois que ce temps sera écoulé de manière répétée jusqu'à l'interruption manuelle du programme
* interval between times : nous fixons ici le déclenchement par interval, mais nous fixons aussi une fourchette d'heures et des jours pendant lesquels nous exécutons cet interval
* at a specific time : nous fixons une heure d'exécution, et un ou plusieurs jours d'exécution. Dans ce cas l'action n'est pas répétée en continu mais éxécutée une seule fois par jour à l'heure programmée

Dans notre exemple, nous allons fixer un intervalle de 15 secondes pour commencer. Nous pourrons ensuite augmenter cette valeur pour éviter de recevoir trop d'emails avec des photos :D

[[fichier:Rasp-Node-Red-picam-mail-07.png]]

La case "inject once at start" permet de ne pas attendre le premier cycle avant d'exécuter une première fois l'action. Elle se lancera dès le lancement du programme, puis périodiquement selon les cycles déterminés par l'intervalle.

[[fichier:Rasp-Node-Red-picam-mail-08.png]]

==== Name ====

Le champs Name va déterminer le nom que portera le bloc dans l'espace de travail et dans les logs (si nous créons des blocs de log ensuite pour contrôler des étapes).
Il est important de bien établir ce nom de manière explicite, car le nom des blocs permettra de comprendre et retrouver facilement la logique du schéma construit, même si l'on a pas consulté celui-ci pendant une longue période.

[[fichier:Rasp-Node-Red-picam-mail-09.png]]

=== Capture d'une image depuis la PiCam ===

Nous allons aller à l'essentiel en ce qui concerne la capture photo en utilisant une commande simple pour prendre un cliché et renvoyer celui-ci dans le flux NodeRED grâce à un bloc permettant d'exécuter des commandes bash.

{{ambox | text = Vous trouverez un TUTO détaillé sur la PiCam vous permettant de prendre la main, ou de la paramétrer si vous n'avez pas encore utilisé celle-ci auparavant: ....___TUTO___...}}

Nous allons tout d'abord cliquer sur le bloc "Exec" dans la section "Advanced" de la colonne de gauche et glisser l'élément dans la zone de travail.

[[fichier:Rasp-Node-Red-picam-mail-10.png]]

Ensuite, cliquer sur le bloc nouvellement créé et configurer celui-ci.

[[fichier:Rasp-Node-Red-picam-mail-11.png]]

Le menu suivant s'affichera, et nous pourrons configurer le bloc "Exec" nouvellement créé.

==== Command ====

Nous allons y ajouter la commande à exécuter pour prendre une photo avec la caméra du Raspberry Pi et la stocker dans un fichier jpg dans le dossier /tmp/ de linux.

<syntaxhighlight lang="python">
raspistill -o /tmp/cam.jpg -w 640 -h 480
</syntaxhighlight>

Nous prenons soin de limiter la hauteur et la largeur de l'image afin de réduire son poids pour l'envoi par email.

[[fichier:Rasp-Node-Red-picam-mail-12.png]]

==== +Append ====

Ensuite, nous allons décocher la case "msg.payload" si elle est cochée par défaut.

[[fichier:Rasp-Node-Red-picam-mail-13.png]]

==== Extra input parameters et Timeout ====

Nous n'aurons pas besoin de compléter ces champs pour notre projet.

Si vous cochez le champ "Use spawn() instead of exec()?", votre commande sera réalisée sous forme d'un processus résident et continuera de s'exécuter jusqu'à ce qu'elle se termine par elle-même (sauf si elle ne se termine jamais).
Cette solution implique que le programme n'attendra pas que cette commande soit réalisée pour passer aux étapes suivantes.
Si la suite de l'exécution de votre flux est susceptible d'utiliser le résultat de cette commande, nous vous déconseillons d'utiliser cette option sous peine de provoquer des erreurs à la suite du traitement du flux.

Le champ "Timeout" permet de définir un temps d'attente maximum avant de mettre un terme à l'exécution de la commande.
Cela permet de débloquer la situation si la commande exécutée prends un temps anormalement long à s'exécuter.

==== Name ====

Nous allons ensuite compléter le champs nom, celui-ci sera utilisé pour nommer le bloc dans le "schéma", mais aussi de nommer les logs comme pour le bloc "Exec".

[[fichier:Rasp-Node-Red-picam-mail-14.png]]

=== Encodage de l'image en base64 ===

Nous allons convertir la photo prise juste avant en utilisant une commande de conversion en base64.
Cela facilitera son injection dans un template HTML que nous allons créer ensuite pour construire un email.

Nous allons tout d'abord cliquer sur le bloc "Exec" dans la section "Advanced" de la colonne de gauche et glisser l'élément dans la zone de travail.

[[fichier:Rasp-Node-Red-picam-mail-10.png]]

Ensuite, cliquer sur le bloc nouvellement créé et configurer celui-ci.

[[fichier:Rasp-Node-Red-picam-mail-11.png]]

Le menu suivant s'affichera, et nous pourrons configurer le bloc "Exec" nouvellement créé.

[[fichier:Rasp-Node-Red-picam-mail-15.png]]

==== Command ====

Nous allons y ajouter la commande à exécuter pour encoder en base 64 la photo prise précédemment avec la caméra du Raspberry Pi.

<syntaxhighlight lang="python">
base64 -i "/tmp/cam.jpg"
</syntaxhighlight>

[[fichier:Rasp-Node-Red-picam-mail-16.png]]

==== +Append ====

Ensuite, nous allons cocher la case "msg.payload" si elle n'est pas cochée par défaut pour que le résultat soit directement renvoyé par cette commande dans le "PayLoad" du flux.

[[fichier:Rasp-Node-Red-picam-mail-17.png]]

==== Extra input parameters et Timeout ====

Nous n'aurons pas besoin de compléter ces champs pour notre projet.

Si vous cochez le champ "Use spawn() instead of exec()?", votre commande sera réalisée sous forme d'un processus résident et continuera de s'exécuter jusqu'à ce qu'elle se termine par elle-même (sauf si elle ne se termine jamais).
Cette solution implique que le programme n'attendra pas que cette commande soit réalisée pour passer aux étapes suivantes.
Si la suite de l'exécution de votre flux est susceptible d'utiliser le résultat de cette commande, nous vous déconseillons d'utiliser cette option sous peine de provoquer des erreurs à la suite du traitement du flux.

[[fichier:Rasp-Node-Red-picam-mail-18.png]]

Le champ "Timeout" permet de définir un temps d'attente maximum avant de mettre un terme à l'exécution de la commande.
Cela permet de débloquer la situation si la commande exécutée prends un temps anormalement long à s'exécuter.

[[fichier:Rasp-Node-Red-picam-mail-19.png]]

==== Name ====

Nous allons ensuite compléter le champs nom, celui-ci sera utilisé pour nommer le bloc dans le "schéma", mais aussi de nommer les logs comme pour le bloc "Exec".

[[fichier:Rasp-Node-Red-picam-mail-20.png]]

=== Création d'un email au format HTML ===

Nous allons maintenant créer un template d'email au format HTML afin de mettre en forme le message que nous enverrons ensuite.
Nous allons pour cela utiliser un bloc "Template".

[[fichier:Rasp-Node-Red-picam-mail-21.png]]

==== Name ====

Nous allons attribuer un nom au bloc afin de l'identifier plus facilement dans le flux.
Nous allons donc le nommer "Contenu du mail" puisque nous créons le contenu du mail que nous enverrons ensuite.

[[fichier:Rasp-Node-Red-picam-mail-22.png]]

==== Set property ====

La propriété que nous souhaitons créer dans le flux est le "PayLoad".
Ce PayLoad existe déjà, il contient pour le moment l'image au format "Base64" précédemment encodé.
Cela n'est pas un problème, après notre noeud (notre bloc), le PayLoad sera intégralement remplacé par le template que nous sommes en train de créer.

[[fichier:Rasp-Node-Red-picam-mail-23.png]]

==== Template ====

Dans ce template, nous allons créer une structure HTML de base minimum afin que la structure soit interprétée par la majorité des clients/webmail.
Vous pouvez la personnaliser à votre guise si vous avez les connaissances en HTML.

Voici la structure de base pour notre projet:

<syntaxhighlight lang="html">
<html>
<head>
<meta charset="utf8"/>
</head>
<body>
<h1>Projet Photo par email</h1>
<img src="data:image/jpg;base64,{{payload}}"/>
</body>
</html>
</syntaxhighlight>

Vous pourrez remarquer que nous intégrons l'image en appelant le PayLoad à 'intérieur du code HTML dans la balise <img>.
C'est le PayLoad créé précédemment par le bloc "Exec" qui est récupéré à ce moment précis.
Ce PayLoad est remplacé dans le flux par le PayLoad complet avec notre template dans le flux par notre bloc Template.

[[fichier:Rasp-Node-Red-picam-mail-24.png]]

=== Création d'un bloc (noeud) "Debug" ===

Nous allons ajouter la notion d'expéditeur dans le flux que nous avons créé à travers nos blocs (noeuds).
Pour rappel, actuellement nous avons deux propriétés avec des données dans notre flux.
Si nous voulons observer ce que nous avons créé jusque là, nous pouvons faire appel à un bloc "Debug".

==== Création du bloc "Debug" ====

Comme pour les blocs précédents, nous allons glisser/déposer un bloc débug dans l'espace de travail.

[[fichier:Rasp-Node-Red-picam-mail-25.png]]

Celui-ci s'appelle msg/payload par défaut

[[fichier:Rasp-Node-Red-picam-mail-26.png]]

Nous allons double-cliquer sur ce bloc pour le configurer.

[[fichier:Rasp-Node-Red-picam-mail-27.png]]

==== Output ====

Dans ce champs, nous allons choisir la partie du flux que nous souhaitons afficher, ou nous allons sélectionner le flux entier.

[[fichier:Rasp-Node-Red-picam-mail-28.png]]

Sélectionner le flux entier, nous affichera le flux complet incluant toutes ses propriétés.

[[fichier:Rasp-Node-Red-picam-mail-29.png]]

==== To =====

La propriété "To" nous permet de choisir ou nous souhaitons afficher les données que nous récupérons.
Soit nous les affichons uniquement dans l'onglet "Debug" à droite de l'espace de travail, soit nous l'affichons dans cet onglet mais aussi dans la console de NodeJS.
Dans notre cas, nous allons nous contenter d'afficher nos éléments dans l'onglet de "Debug" à droite de notre espace de travail.

[[fichier:Rasp-Node-Red-picam-mail-30.png]]

==== Name ====

Le champs Name nous servira à identifier quel bloc de "Debug" affiche les données en console ou dans l'onglet "Debug".
Il faut donc le nommer efficacement pour bien attacher et comprendre les données que nous récupérons, surtout si nous en plaçons plusieurs dans le flux.

[[fichier:Rasp-Node-Red-picam-mail-31.png]]

==== Exploitation et compréhension des données récupérées ====

Nous avons placé notre bloc "Debug" à la suite du flux en dernière position.

[[fichier:Rasp-Node-Red-picam-mail-32.png]]

Nous allons donc déployer le programme en cliquant sur "Deploy" en haut à droite de la page.

[[fichier:Rasp-Node-Red-picam-mail-33.png]]

Ensuite, nous allons exécuter manuellement le programme en cliquant sur le bouton se trouvant en début de chaîne:

[[fichier:Rasp-Node-Red-picam-mail-34.png]]

Nous allons ensuite afficher l'onglet "Debug" sur le coté droit de la page et analyser les données récupérées:

[[fichier:Rasp-Node-Red-picam-mail-35.png]]

==== Analyse des données récupérées dans l'onglet "Debug" ====

<syntaxhighlight lang="bash">
08/05/2017 à 12:54:31 node: FORMATAGE
MCHobby - Photo bureau : msg : Object
object
_msgid: "81efe35c.3208d"
topic: "MCHobby - Photo bureau"
payload: "<html>↵ <head>↵ <meta charset="utf8"/>↵ ↵ </head>↵ <body>↵ <h1>MCHobby - Photo bureau</h1>↵ <p>Cette photo est un instantané pris dans les bureaux de MCHobby.</p>↵
<img src="data:image/jpg;base64,/9j/4WP6x2.../>"
</syntaxhighlight>

Comme vous pourrez le constater, chaque élément du noeud est détaillé.
Les données sont cependant tronquées, le noeud "Debug" ne nous fourni pas la totalité du "PayLoad" mais nous avons déjà un bon aperçu des données qu'il contient.

* '''_msgid:''' est un Id unique de message
* '''topic:''' est le sujet du mail, nous l'avons déterminé dans le premier bloc
* '''payload:''' contient les données du message formatées par le template que nous avons créé et complété par l'image en base64.

{{tmbox | text = Les noeuds "Debug" sont pratiques. Ils nous permettent d'afficher une partie ou la totalité du flux tel qu'il est à l'endroit ou ils sont placés. Cela peut permettre d'identifier et de résoudre plus facilement des problèmes dans des opérations plus complexes et dans notre cas, cela nous permet de mieux comprendre comment fonctionne le noeud et comment les données sont transmises d'un bloc à l'autre.}}

=== Création d'un expéditeur ===

Nous avons construit petit à petit un message avec un sujet, mais il manque encore un détail: l'expéditeur de l'email que nous allons envoyer: le fameux "msg.from" que nous avons évoqué au début de tuto !

Si vous avez bien suivi les étapes précédentes du tuto, jusqu'au noeud "Debug" et à son résultat, vous comprendrez facilement la démarche ci après pour ajouter un expéditeur dans le flux.

Nous allons ajouter un nouveau noeud "Template" dans la zone de travail et double cliquer dessus pour afficher sa page de configuration:

{{Rasp-Node-Red-TRAILER}}

Rasp-Node-Red-picam-mail

2017-05-08T13:04:49Z

AntoineWrt : /* Analyse des données récupérées dans l'onglet "Debug" */

{{Rasp-Node-Red-NAV}}

{{traduction}}

== PiCamRED - Envoi périodique de photos par email avec PiCam et NodeRED ==

[[fichier:Rasp-Node-Red-picam-mail-01.png|900px]]

=== Description du projet ===

Dans ce tutoriel, nous allons réaliser des photos à l'aide de la caméra du RaspBerry Pi 2/3 et envoyer ces clichés par email de manière périodique grâce à NodeRED.
Nous allons donc utiliser plusieurs blocs et décrire de manière détaillée le déroulement de chaque étape de la réalisation de ce projet.

Dans NodeRED, il est important de bien identifier la finalité de notre projet afin de connaître au préalable tous les éléments qu'il faudra créer et fournir à l'action finale (celle qui enverra un email).

=== Quels sont les besoins du noeud email ===

==== Composants nécessaires pour constituer un email ====

Un email est composé des éléments suivants:

* Un expéditeur
* Un destinataire
* Un sujet
* Le corps du message

Tous ces éléments vont donc devoir être préparés afin de pouvoir construire le message à envoyer par le noeud final.

Le noeud final aura aussi besoin d'un serveur SMTP (serveur d'envoi d'emails) et éventuellement de paramètres d'identification pour ce serveur d'envoi d'emails.

==== Détail des besoins du noeud email ====

La liste des éléments nécessaires s'affiche lorsque le bloc est dans la zone de travail (Schema).
Commençons donc par sélectionner le bloc email, et de le glisser dans la zone de travail.

Commençons par cliquer sur le bloc email et nous maintenons le clic pour le glisser à droite dans l'espace de travail.

(on choisit celui qui a son point de liaison à gauche, car nous voulons un bloc de sortie)

[[fichier:Rasp-Node-Red-picam-mail-36.png]]

Glissons le dans l'espace de travail, et cliquons un clic simple pour le sélectionner.

[[fichier:Rasp-Node-Red-picam-mail-37.png]]

Ensuite, dans la colonne à droite de cet espace de travail, nous cliquons sur info et nous pourrons découvrir les éléments nécessaires à la constitution d'un bloc email.

[[fichier:Rasp-Node-Red-picam-mail-38.png]]

===== Nous utiliserons les champs suivants =====

* '''msg.payload''' --> Ce champ contient le corps de l'email
* '''msg.topic''' --> Ce champ contient le sujet de l'email
* '''msg.from''' --> Ce champ contient l'email de l'expéditeur
* '''msg.to''' --> Ce champ contient l'email du destinataire

Les autres champs ne seront pas utilisés dans notre cas, mais vous pourrez constater que le bloc email est complet de part ses fonctionnalités et possibilités.

Les données de serveur et d'identification seront abordées en fin de tuto lors de la configuration finale du bloc.

Nous allons maintenant passer à la réalisation du flux en commençant par le début de celui-ci.

=== Création d'une action périodique ===

Dans la colonne de gauche de NodeRED, se trouvent une liste de blocs à utiliser pour réaliser vos projets. Ils sont classés par "types".

Ainsi nous retrouvons les "types" suivants:

* Input qui contient tous les blocs d'entrées
* Ouput qui contient tous les blocs de sortie
* Function qui contient des blocs de fonctions javascript etc...
* Social qui sont des blocs d'entrée ou sorties depuis ou vers les réseaux sociaux
* Storage qui sont des fonctions de lecture ou d'écriture de fichiers
* Analysis ->> Sentiment interprète du texte et détermine un score sur base d'un dictionnaire anglais, renvoie le texte avec ce score de -5 à +5, déterminant ainsi l'émotion susceptible d'être procuré par ce texte
* Advanced possède des outils permettant de détecter des changements dans des fichiers ou dossiers, de lire des flux RSS ou encore EXEC qui permet d'exécuter directement des commandes sous linux !
* Raspberry Pi contient des outils pour piloter/lire le GPIO du raspberry Pi
* Network qui contient un outil réseau de Ping

Nous allons créer une action périodique, c'est à dire paramétrer un bloc "INJECT" de manière à déclencher régulièrement une chaine d'actions que nous allons accrocher à la suite les unes après les autres.
Nous allons donc cliquer sur le bloc "Inject" dans la liste "Input" et maintenir ce clic pour le déplacer vers la zone de travail.

[[fichier:Rasp-Node-Red-picam-mail-02.png]]

Nous obtiendrons donc une nouvelle instance "inject" qui portera le nom "Timestamp" (ce nom est attribué par défaut par NodeRED) comme dans la capture ci-dessous

[[fichier:Rasp-Node-Red-picam-mail-03.png]]

Nous allons maintenant double-cliquer sur celle-ci fin de l'éditer pour voir apparaitre le menu ci-dessous

[[fichier:Rasp-Node-Red-picam-mail-04.png]]

Il va falloir configurer ce bloc, mais avant tout voici une explication de celui-ci:

==== Payload ====

Le champs PayLoad est en fait le champ de données qui sera suivi d'un noeud à l'autre jusque à la fin de la chaine.
Dans ce module "inject", nous allons donc déterminer quel type de données contiendra le "PayLoad" jusqu'à la fin de la chaine que l'on va réaliser.

Dans notre cas, nous souhaitons construire un email, donc du contenu textuel, nous allons donc choisir "String" ce qui correspond à une chaine de caractères (du texte).

[[fichier:Rasp-Node-Red-picam-mail-05.png]]

==== Topic ====

Le champs "Topic" est un champs de texte dans lequel nous allons mettre un sujet succinct décrivant notre chaine.
Dans notre cas, ce sujet fera office de sujet au mail que nous expédierons.
Nous allons donc être précis en un minimum de mots pour que le destinataire de l'email puisse facilement deviner le contenu de celui-ci.

[[fichier:Rasp-Node-Red-picam-mail-06.png]]

==== Repeat ====

Nous allons ensuite choisir l'intervalle de déclenchement de notre action, sachant que nous avons le choix entre:

* none : pas de déclenchement périodique programmé
* interval : nous fixons un temps de déclenchement à partir du lancement du programme, l'action se réalisera à chaque fois que ce temps sera écoulé de manière répétée jusqu'à l'interruption manuelle du programme
* interval between times : nous fixons ici le déclenchement par interval, mais nous fixons aussi une fourchette d'heures et des jours pendant lesquels nous exécutons cet interval
* at a specific time : nous fixons une heure d'exécution, et un ou plusieurs jours d'exécution. Dans ce cas l'action n'est pas répétée en continu mais éxécutée une seule fois par jour à l'heure programmée

Dans notre exemple, nous allons fixer un intervalle de 15 secondes pour commencer. Nous pourrons ensuite augmenter cette valeur pour éviter de recevoir trop d'emails avec des photos :D

[[fichier:Rasp-Node-Red-picam-mail-07.png]]

La case "inject once at start" permet de ne pas attendre le premier cycle avant d'exécuter une première fois l'action. Elle se lancera dès le lancement du programme, puis périodiquement selon les cycles déterminés par l'intervalle.

[[fichier:Rasp-Node-Red-picam-mail-08.png]]

==== Name ====

Le champs Name va déterminer le nom que portera le bloc dans l'espace de travail et dans les logs (si nous créons des blocs de log ensuite pour contrôler des étapes).
Il est important de bien établir ce nom de manière explicite, car le nom des blocs permettra de comprendre et retrouver facilement la logique du schéma construit, même si l'on a pas consulté celui-ci pendant une longue période.

[[fichier:Rasp-Node-Red-picam-mail-09.png]]

=== Capture d'une image depuis la PiCam ===

Nous allons aller à l'essentiel en ce qui concerne la capture photo en utilisant une commande simple pour prendre un cliché et renvoyer celui-ci dans le flux NodeRED grâce à un bloc permettant d'exécuter des commandes bash.

{{ambox | text = Vous trouverez un TUTO détaillé sur la PiCam vous permettant de prendre la main, ou de la paramétrer si vous n'avez pas encore utilisé celle-ci auparavant: ....___TUTO___...}}

Nous allons tout d'abord cliquer sur le bloc "Exec" dans la section "Advanced" de la colonne de gauche et glisser l'élément dans la zone de travail.

[[fichier:Rasp-Node-Red-picam-mail-10.png]]

Ensuite, cliquer sur le bloc nouvellement créé et configurer celui-ci.

[[fichier:Rasp-Node-Red-picam-mail-11.png]]

Le menu suivant s'affichera, et nous pourrons configurer le bloc "Exec" nouvellement créé.

==== Command ====

Nous allons y ajouter la commande à exécuter pour prendre une photo avec la caméra du Raspberry Pi et la stocker dans un fichier jpg dans le dossier /tmp/ de linux.

<syntaxhighlight lang="python">
raspistill -o /tmp/cam.jpg -w 640 -h 480
</syntaxhighlight>

Nous prenons soin de limiter la hauteur et la largeur de l'image afin de réduire son poids pour l'envoi par email.

[[fichier:Rasp-Node-Red-picam-mail-12.png]]

==== +Append ====

Ensuite, nous allons décocher la case "msg.payload" si elle est cochée par défaut.

[[fichier:Rasp-Node-Red-picam-mail-13.png]]

==== Extra input parameters et Timeout ====

Nous n'aurons pas besoin de compléter ces champs pour notre projet.

Si vous cochez le champ "Use spawn() instead of exec()?", votre commande sera réalisée sous forme d'un processus résident et continuera de s'exécuter jusqu'à ce qu'elle se termine par elle-même (sauf si elle ne se termine jamais).
Cette solution implique que le programme n'attendra pas que cette commande soit réalisée pour passer aux étapes suivantes.
Si la suite de l'exécution de votre flux est susceptible d'utiliser le résultat de cette commande, nous vous déconseillons d'utiliser cette option sous peine de provoquer des erreurs à la suite du traitement du flux.

Le champ "Timeout" permet de définir un temps d'attente maximum avant de mettre un terme à l'exécution de la commande.
Cela permet de débloquer la situation si la commande exécutée prends un temps anormalement long à s'exécuter.

==== Name ====

Nous allons ensuite compléter le champs nom, celui-ci sera utilisé pour nommer le bloc dans le "schéma", mais aussi de nommer les logs comme pour le bloc "Exec".

[[fichier:Rasp-Node-Red-picam-mail-14.png]]

=== Encodage de l'image en base64 ===

Nous allons convertir la photo prise juste avant en utilisant une commande de conversion en base64.
Cela facilitera son injection dans un template HTML que nous allons créer ensuite pour construire un email.

Nous allons tout d'abord cliquer sur le bloc "Exec" dans la section "Advanced" de la colonne de gauche et glisser l'élément dans la zone de travail.

[[fichier:Rasp-Node-Red-picam-mail-10.png]]

Ensuite, cliquer sur le bloc nouvellement créé et configurer celui-ci.

[[fichier:Rasp-Node-Red-picam-mail-11.png]]

Le menu suivant s'affichera, et nous pourrons configurer le bloc "Exec" nouvellement créé.

[[fichier:Rasp-Node-Red-picam-mail-15.png]]

==== Command ====

Nous allons y ajouter la commande à exécuter pour encoder en base 64 la photo prise précédemment avec la caméra du Raspberry Pi.

<syntaxhighlight lang="python">
base64 -i "/tmp/cam.jpg"
</syntaxhighlight>

[[fichier:Rasp-Node-Red-picam-mail-16.png]]

==== +Append ====

Ensuite, nous allons cocher la case "msg.payload" si elle n'est pas cochée par défaut pour que le résultat soit directement renvoyé par cette commande dans le "PayLoad" du flux.

[[fichier:Rasp-Node-Red-picam-mail-17.png]]

==== Extra input parameters et Timeout ====

Nous n'aurons pas besoin de compléter ces champs pour notre projet.

Si vous cochez le champ "Use spawn() instead of exec()?", votre commande sera réalisée sous forme d'un processus résident et continuera de s'exécuter jusqu'à ce qu'elle se termine par elle-même (sauf si elle ne se termine jamais).
Cette solution implique que le programme n'attendra pas que cette commande soit réalisée pour passer aux étapes suivantes.
Si la suite de l'exécution de votre flux est susceptible d'utiliser le résultat de cette commande, nous vous déconseillons d'utiliser cette option sous peine de provoquer des erreurs à la suite du traitement du flux.

[[fichier:Rasp-Node-Red-picam-mail-18.png]]

Le champ "Timeout" permet de définir un temps d'attente maximum avant de mettre un terme à l'exécution de la commande.
Cela permet de débloquer la situation si la commande exécutée prends un temps anormalement long à s'exécuter.

[[fichier:Rasp-Node-Red-picam-mail-19.png]]

==== Name ====

Nous allons ensuite compléter le champs nom, celui-ci sera utilisé pour nommer le bloc dans le "schéma", mais aussi de nommer les logs comme pour le bloc "Exec".

[[fichier:Rasp-Node-Red-picam-mail-20.png]]

=== Création d'un email au format HTML ===

Nous allons maintenant créer un template d'email au format HTML afin de mettre en forme le message que nous enverrons ensuite.
Nous allons pour cela utiliser un bloc "Template".

[[fichier:Rasp-Node-Red-picam-mail-21.png]]

==== Name ====

Nous allons attribuer un nom au bloc afin de l'identifier plus facilement dans le flux.
Nous allons donc le nommer "Contenu du mail" puisque nous créons le contenu du mail que nous enverrons ensuite.

[[fichier:Rasp-Node-Red-picam-mail-22.png]]

==== Set property ====

La propriété que nous souhaitons créer dans le flux est le "PayLoad".
Ce PayLoad existe déjà, il contient pour le moment l'image au format "Base64" précédemment encodé.
Cela n'est pas un problème, après notre noeud (notre bloc), le PayLoad sera intégralement remplacé par le template que nous sommes en train de créer.

[[fichier:Rasp-Node-Red-picam-mail-23.png]]

==== Template ====

Dans ce template, nous allons créer une structure HTML de base minimum afin que la structure soit interprétée par la majorité des clients/webmail.
Vous pouvez la personnaliser à votre guise si vous avez les connaissances en HTML.

Voici la structure de base pour notre projet:

<syntaxhighlight lang="html">
<html>
<head>
<meta charset="utf8"/>
</head>
<body>
<h1>Projet Photo par email</h1>
<img src="data:image/jpg;base64,{{payload}}"/>
</body>
</html>
</syntaxhighlight>

Vous pourrez remarquer que nous intégrons l'image en appelant le PayLoad à 'intérieur du code HTML dans la balise <img>.
C'est le PayLoad créé précédemment par le bloc "Exec" qui est récupéré à ce moment précis.
Ce PayLoad est remplacé dans le flux par le PayLoad complet avec notre template dans le flux par notre bloc Template.

[[fichier:Rasp-Node-Red-picam-mail-24.png]]

=== Création d'un bloc (noeud) "Debug" ===

Nous allons ajouter la notion d'expéditeur dans le flux que nous avons créé à travers nos blocs (noeuds).
Pour rappel, actuellement nous avons deux propriétés avec des données dans notre flux.
Si nous voulons observer ce que nous avons créé jusque là, nous pouvons faire appel à un bloc "Debug".

==== Création du bloc "Debug" ====

Comme pour les blocs précédents, nous allons glisser/déposer un bloc débug dans l'espace de travail.

[[fichier:Rasp-Node-Red-picam-mail-25.png]]

Celui-ci s'appelle msg/payload par défaut

[[fichier:Rasp-Node-Red-picam-mail-26.png]]

Nous allons double-cliquer sur ce bloc pour le configurer.

[[fichier:Rasp-Node-Red-picam-mail-27.png]]

==== Output ====

Dans ce champs, nous allons choisir la partie du flux que nous souhaitons afficher, ou nous allons sélectionner le flux entier.

[[fichier:Rasp-Node-Red-picam-mail-28.png]]

Sélectionner le flux entier, nous affichera le flux complet incluant toutes ses propriétés.

[[fichier:Rasp-Node-Red-picam-mail-29.png]]

==== To =====

La propriété "To" nous permet de choisir ou nous souhaitons afficher les données que nous récupérons.
Soit nous les affichons uniquement dans l'onglet "Debug" à droite de l'espace de travail, soit nous l'affichons dans cet onglet mais aussi dans la console de NodeJS.
Dans notre cas, nous allons nous contenter d'afficher nos éléments dans l'onglet de "Debug" à droite de notre espace de travail.

[[fichier:Rasp-Node-Red-picam-mail-30.png]]

==== Name ====

Le champs Name nous servira à identifier quel bloc de "Debug" affiche les données en console ou dans l'onglet "Debug".
Il faut donc le nommer efficacement pour bien attacher et comprendre les données que nous récupérons, surtout si nous en plaçons plusieurs dans le flux.

[[fichier:Rasp-Node-Red-picam-mail-31.png]]

==== Exploitation et compréhension des données récupérées ====

Nous avons placé notre bloc "Debug" à la suite du flux en dernière position.

[[fichier:Rasp-Node-Red-picam-mail-32.png]]

Nous allons donc déployer le programme en cliquant sur "Deploy" en haut à droite de la page.

[[fichier:Rasp-Node-Red-picam-mail-33.png]]

Ensuite, nous allons exécuter manuellement le programme en cliquant sur le bouton se trouvant en début de chaîne:

[[fichier:Rasp-Node-Red-picam-mail-34.png]]

Nous allons ensuite afficher l'onglet "Debug" sur le coté droit de la page et analyser les données récupérées:

[[fichier:Rasp-Node-Red-picam-mail-35.png]]

==== Analyse des données récupérées dans l'onglet "Debug" ====

<syntaxhighlight lang="bash">
08/05/2017 à 12:54:31 node: FORMATAGE
MCHobby - Photo bureau : msg : Object
object
_msgid: "81efe35c.3208d"
topic: "MCHobby - Photo bureau"
payload: "<html>↵ <head>↵ <meta charset="utf8"/>↵ ↵ </head>↵ <body>↵ <h1>MCHobby - Photo bureau</h1>↵ <p>Cette photo est un instantané pris dans les bureaux de MCHobby.</p>↵
<img src="data:image/jpg;base64,/9j/4WP6x2.../>"
</syntaxhighlight>

Comme vous pourrez le constater, chaque élément du noeud est détaillé.
Les données sont cependant tronquées, le noeud "Debug" ne nous fourni pas la totalité du "PayLoad" mais nous avons déjà un bon aperçu des données qu'il contient.

* '''_msgid:''' est un Id unique de message
* '''topic:''' est le sujet du mail, nous l'avons déterminé dans le premier bloc
* '''payload:''' contient les données du message formatées par le template que nous avons créé et complété par l'image en base64.

{{tmbox | text = Les noeuds "Debug" sont pratiques. Ils nous permettent d'afficher une partie ou la totalité du flux tel qu'il est à l'endroit ou ils sont placés. Cela peut permettre d'identifier et de résoudre plus facilement des problèmes dans des opérations plus complexes et dans notre cas, cela nous permet de mieux comprendre comment fonctionne le noeud et comment les données sont transmises d'un bloc à l'autre.}}

=== Création d'un expéditeur ===

Nous avons construit petit à petit un message avec un sujet, mais il manque encore un détail: l'expéditeur de l'email que nous allons envoyer.

Si vous avez bien suivi les étapes précédentes du tuto, jusqu'au noeud "Debug" et à son résultat, vous comprendrez facilement la démarche ci après pour ajouter un expéditeur dans le flux.

{{Rasp-Node-Red-TRAILER}}

Rasp-Node-Red-picam-mail

2017-05-08T13:04:31Z

AntoineWrt : /* Analyse des données récupérées dans l'onglet "Debug" */

{{Rasp-Node-Red-NAV}}

{{traduction}}

== PiCamRED - Envoi périodique de photos par email avec PiCam et NodeRED ==

[[fichier:Rasp-Node-Red-picam-mail-01.png|900px]]

=== Description du projet ===

Dans ce tutoriel, nous allons réaliser des photos à l'aide de la caméra du RaspBerry Pi 2/3 et envoyer ces clichés par email de manière périodique grâce à NodeRED.
Nous allons donc utiliser plusieurs blocs et décrire de manière détaillée le déroulement de chaque étape de la réalisation de ce projet.

Dans NodeRED, il est important de bien identifier la finalité de notre projet afin de connaître au préalable tous les éléments qu'il faudra créer et fournir à l'action finale (celle qui enverra un email).

=== Quels sont les besoins du noeud email ===

==== Composants nécessaires pour constituer un email ====

Un email est composé des éléments suivants:

* Un expéditeur
* Un destinataire
* Un sujet
* Le corps du message

Tous ces éléments vont donc devoir être préparés afin de pouvoir construire le message à envoyer par le noeud final.

Le noeud final aura aussi besoin d'un serveur SMTP (serveur d'envoi d'emails) et éventuellement de paramètres d'identification pour ce serveur d'envoi d'emails.

==== Détail des besoins du noeud email ====

La liste des éléments nécessaires s'affiche lorsque le bloc est dans la zone de travail (Schema).
Commençons donc par sélectionner le bloc email, et de le glisser dans la zone de travail.

Commençons par cliquer sur le bloc email et nous maintenons le clic pour le glisser à droite dans l'espace de travail.

(on choisit celui qui a son point de liaison à gauche, car nous voulons un bloc de sortie)

[[fichier:Rasp-Node-Red-picam-mail-36.png]]

Glissons le dans l'espace de travail, et cliquons un clic simple pour le sélectionner.

[[fichier:Rasp-Node-Red-picam-mail-37.png]]

Ensuite, dans la colonne à droite de cet espace de travail, nous cliquons sur info et nous pourrons découvrir les éléments nécessaires à la constitution d'un bloc email.

[[fichier:Rasp-Node-Red-picam-mail-38.png]]

===== Nous utiliserons les champs suivants =====

* '''msg.payload''' --> Ce champ contient le corps de l'email
* '''msg.topic''' --> Ce champ contient le sujet de l'email
* '''msg.from''' --> Ce champ contient l'email de l'expéditeur
* '''msg.to''' --> Ce champ contient l'email du destinataire

Les autres champs ne seront pas utilisés dans notre cas, mais vous pourrez constater que le bloc email est complet de part ses fonctionnalités et possibilités.

Les données de serveur et d'identification seront abordées en fin de tuto lors de la configuration finale du bloc.

Nous allons maintenant passer à la réalisation du flux en commençant par le début de celui-ci.

=== Création d'une action périodique ===

Dans la colonne de gauche de NodeRED, se trouvent une liste de blocs à utiliser pour réaliser vos projets. Ils sont classés par "types".

Ainsi nous retrouvons les "types" suivants:

* Input qui contient tous les blocs d'entrées
* Ouput qui contient tous les blocs de sortie
* Function qui contient des blocs de fonctions javascript etc...
* Social qui sont des blocs d'entrée ou sorties depuis ou vers les réseaux sociaux
* Storage qui sont des fonctions de lecture ou d'écriture de fichiers
* Analysis ->> Sentiment interprète du texte et détermine un score sur base d'un dictionnaire anglais, renvoie le texte avec ce score de -5 à +5, déterminant ainsi l'émotion susceptible d'être procuré par ce texte
* Advanced possède des outils permettant de détecter des changements dans des fichiers ou dossiers, de lire des flux RSS ou encore EXEC qui permet d'exécuter directement des commandes sous linux !
* Raspberry Pi contient des outils pour piloter/lire le GPIO du raspberry Pi
* Network qui contient un outil réseau de Ping

Nous allons créer une action périodique, c'est à dire paramétrer un bloc "INJECT" de manière à déclencher régulièrement une chaine d'actions que nous allons accrocher à la suite les unes après les autres.
Nous allons donc cliquer sur le bloc "Inject" dans la liste "Input" et maintenir ce clic pour le déplacer vers la zone de travail.

[[fichier:Rasp-Node-Red-picam-mail-02.png]]

Nous obtiendrons donc une nouvelle instance "inject" qui portera le nom "Timestamp" (ce nom est attribué par défaut par NodeRED) comme dans la capture ci-dessous

[[fichier:Rasp-Node-Red-picam-mail-03.png]]

Nous allons maintenant double-cliquer sur celle-ci fin de l'éditer pour voir apparaitre le menu ci-dessous

[[fichier:Rasp-Node-Red-picam-mail-04.png]]

Il va falloir configurer ce bloc, mais avant tout voici une explication de celui-ci:

==== Payload ====

Le champs PayLoad est en fait le champ de données qui sera suivi d'un noeud à l'autre jusque à la fin de la chaine.
Dans ce module "inject", nous allons donc déterminer quel type de données contiendra le "PayLoad" jusqu'à la fin de la chaine que l'on va réaliser.

Dans notre cas, nous souhaitons construire un email, donc du contenu textuel, nous allons donc choisir "String" ce qui correspond à une chaine de caractères (du texte).

[[fichier:Rasp-Node-Red-picam-mail-05.png]]

==== Topic ====

Le champs "Topic" est un champs de texte dans lequel nous allons mettre un sujet succinct décrivant notre chaine.
Dans notre cas, ce sujet fera office de sujet au mail que nous expédierons.
Nous allons donc être précis en un minimum de mots pour que le destinataire de l'email puisse facilement deviner le contenu de celui-ci.

[[fichier:Rasp-Node-Red-picam-mail-06.png]]

==== Repeat ====

Nous allons ensuite choisir l'intervalle de déclenchement de notre action, sachant que nous avons le choix entre:

* none : pas de déclenchement périodique programmé
* interval : nous fixons un temps de déclenchement à partir du lancement du programme, l'action se réalisera à chaque fois que ce temps sera écoulé de manière répétée jusqu'à l'interruption manuelle du programme
* interval between times : nous fixons ici le déclenchement par interval, mais nous fixons aussi une fourchette d'heures et des jours pendant lesquels nous exécutons cet interval
* at a specific time : nous fixons une heure d'exécution, et un ou plusieurs jours d'exécution. Dans ce cas l'action n'est pas répétée en continu mais éxécutée une seule fois par jour à l'heure programmée

Dans notre exemple, nous allons fixer un intervalle de 15 secondes pour commencer. Nous pourrons ensuite augmenter cette valeur pour éviter de recevoir trop d'emails avec des photos :D

[[fichier:Rasp-Node-Red-picam-mail-07.png]]

La case "inject once at start" permet de ne pas attendre le premier cycle avant d'exécuter une première fois l'action. Elle se lancera dès le lancement du programme, puis périodiquement selon les cycles déterminés par l'intervalle.

[[fichier:Rasp-Node-Red-picam-mail-08.png]]

==== Name ====

Le champs Name va déterminer le nom que portera le bloc dans l'espace de travail et dans les logs (si nous créons des blocs de log ensuite pour contrôler des étapes).
Il est important de bien établir ce nom de manière explicite, car le nom des blocs permettra de comprendre et retrouver facilement la logique du schéma construit, même si l'on a pas consulté celui-ci pendant une longue période.

[[fichier:Rasp-Node-Red-picam-mail-09.png]]

=== Capture d'une image depuis la PiCam ===

Nous allons aller à l'essentiel en ce qui concerne la capture photo en utilisant une commande simple pour prendre un cliché et renvoyer celui-ci dans le flux NodeRED grâce à un bloc permettant d'exécuter des commandes bash.

{{ambox | text = Vous trouverez un TUTO détaillé sur la PiCam vous permettant de prendre la main, ou de la paramétrer si vous n'avez pas encore utilisé celle-ci auparavant: ....___TUTO___...}}

Nous allons tout d'abord cliquer sur le bloc "Exec" dans la section "Advanced" de la colonne de gauche et glisser l'élément dans la zone de travail.

[[fichier:Rasp-Node-Red-picam-mail-10.png]]

Ensuite, cliquer sur le bloc nouvellement créé et configurer celui-ci.

[[fichier:Rasp-Node-Red-picam-mail-11.png]]

Le menu suivant s'affichera, et nous pourrons configurer le bloc "Exec" nouvellement créé.

==== Command ====

Nous allons y ajouter la commande à exécuter pour prendre une photo avec la caméra du Raspberry Pi et la stocker dans un fichier jpg dans le dossier /tmp/ de linux.

<syntaxhighlight lang="python">
raspistill -o /tmp/cam.jpg -w 640 -h 480
</syntaxhighlight>

Nous prenons soin de limiter la hauteur et la largeur de l'image afin de réduire son poids pour l'envoi par email.

[[fichier:Rasp-Node-Red-picam-mail-12.png]]

==== +Append ====

Ensuite, nous allons décocher la case "msg.payload" si elle est cochée par défaut.

[[fichier:Rasp-Node-Red-picam-mail-13.png]]

==== Extra input parameters et Timeout ====

Nous n'aurons pas besoin de compléter ces champs pour notre projet.

Si vous cochez le champ "Use spawn() instead of exec()?", votre commande sera réalisée sous forme d'un processus résident et continuera de s'exécuter jusqu'à ce qu'elle se termine par elle-même (sauf si elle ne se termine jamais).
Cette solution implique que le programme n'attendra pas que cette commande soit réalisée pour passer aux étapes suivantes.
Si la suite de l'exécution de votre flux est susceptible d'utiliser le résultat de cette commande, nous vous déconseillons d'utiliser cette option sous peine de provoquer des erreurs à la suite du traitement du flux.

Le champ "Timeout" permet de définir un temps d'attente maximum avant de mettre un terme à l'exécution de la commande.
Cela permet de débloquer la situation si la commande exécutée prends un temps anormalement long à s'exécuter.

==== Name ====

Nous allons ensuite compléter le champs nom, celui-ci sera utilisé pour nommer le bloc dans le "schéma", mais aussi de nommer les logs comme pour le bloc "Exec".

[[fichier:Rasp-Node-Red-picam-mail-14.png]]

=== Encodage de l'image en base64 ===

Nous allons convertir la photo prise juste avant en utilisant une commande de conversion en base64.
Cela facilitera son injection dans un template HTML que nous allons créer ensuite pour construire un email.

Nous allons tout d'abord cliquer sur le bloc "Exec" dans la section "Advanced" de la colonne de gauche et glisser l'élément dans la zone de travail.

[[fichier:Rasp-Node-Red-picam-mail-10.png]]

Ensuite, cliquer sur le bloc nouvellement créé et configurer celui-ci.

[[fichier:Rasp-Node-Red-picam-mail-11.png]]

Le menu suivant s'affichera, et nous pourrons configurer le bloc "Exec" nouvellement créé.

[[fichier:Rasp-Node-Red-picam-mail-15.png]]

==== Command ====

Nous allons y ajouter la commande à exécuter pour encoder en base 64 la photo prise précédemment avec la caméra du Raspberry Pi.

<syntaxhighlight lang="python">
base64 -i "/tmp/cam.jpg"
</syntaxhighlight>

[[fichier:Rasp-Node-Red-picam-mail-16.png]]

==== +Append ====

Ensuite, nous allons cocher la case "msg.payload" si elle n'est pas cochée par défaut pour que le résultat soit directement renvoyé par cette commande dans le "PayLoad" du flux.

[[fichier:Rasp-Node-Red-picam-mail-17.png]]

==== Extra input parameters et Timeout ====

Nous n'aurons pas besoin de compléter ces champs pour notre projet.

Si vous cochez le champ "Use spawn() instead of exec()?", votre commande sera réalisée sous forme d'un processus résident et continuera de s'exécuter jusqu'à ce qu'elle se termine par elle-même (sauf si elle ne se termine jamais).
Cette solution implique que le programme n'attendra pas que cette commande soit réalisée pour passer aux étapes suivantes.
Si la suite de l'exécution de votre flux est susceptible d'utiliser le résultat de cette commande, nous vous déconseillons d'utiliser cette option sous peine de provoquer des erreurs à la suite du traitement du flux.

[[fichier:Rasp-Node-Red-picam-mail-18.png]]

Le champ "Timeout" permet de définir un temps d'attente maximum avant de mettre un terme à l'exécution de la commande.
Cela permet de débloquer la situation si la commande exécutée prends un temps anormalement long à s'exécuter.

[[fichier:Rasp-Node-Red-picam-mail-19.png]]

==== Name ====

Nous allons ensuite compléter le champs nom, celui-ci sera utilisé pour nommer le bloc dans le "schéma", mais aussi de nommer les logs comme pour le bloc "Exec".

[[fichier:Rasp-Node-Red-picam-mail-20.png]]

=== Création d'un email au format HTML ===

Nous allons maintenant créer un template d'email au format HTML afin de mettre en forme le message que nous enverrons ensuite.
Nous allons pour cela utiliser un bloc "Template".

[[fichier:Rasp-Node-Red-picam-mail-21.png]]

==== Name ====

Nous allons attribuer un nom au bloc afin de l'identifier plus facilement dans le flux.
Nous allons donc le nommer "Contenu du mail" puisque nous créons le contenu du mail que nous enverrons ensuite.

[[fichier:Rasp-Node-Red-picam-mail-22.png]]

==== Set property ====

La propriété que nous souhaitons créer dans le flux est le "PayLoad".
Ce PayLoad existe déjà, il contient pour le moment l'image au format "Base64" précédemment encodé.
Cela n'est pas un problème, après notre noeud (notre bloc), le PayLoad sera intégralement remplacé par le template que nous sommes en train de créer.

[[fichier:Rasp-Node-Red-picam-mail-23.png]]

==== Template ====

Dans ce template, nous allons créer une structure HTML de base minimum afin que la structure soit interprétée par la majorité des clients/webmail.
Vous pouvez la personnaliser à votre guise si vous avez les connaissances en HTML.

Voici la structure de base pour notre projet:

<syntaxhighlight lang="html">
<html>
<head>
<meta charset="utf8"/>
</head>
<body>
<h1>Projet Photo par email</h1>
<img src="data:image/jpg;base64,{{payload}}"/>
</body>
</html>
</syntaxhighlight>

Vous pourrez remarquer que nous intégrons l'image en appelant le PayLoad à 'intérieur du code HTML dans la balise <img>.
C'est le PayLoad créé précédemment par le bloc "Exec" qui est récupéré à ce moment précis.
Ce PayLoad est remplacé dans le flux par le PayLoad complet avec notre template dans le flux par notre bloc Template.

[[fichier:Rasp-Node-Red-picam-mail-24.png]]

=== Création d'un bloc (noeud) "Debug" ===

Nous allons ajouter la notion d'expéditeur dans le flux que nous avons créé à travers nos blocs (noeuds).
Pour rappel, actuellement nous avons deux propriétés avec des données dans notre flux.
Si nous voulons observer ce que nous avons créé jusque là, nous pouvons faire appel à un bloc "Debug".

==== Création du bloc "Debug" ====

Comme pour les blocs précédents, nous allons glisser/déposer un bloc débug dans l'espace de travail.

[[fichier:Rasp-Node-Red-picam-mail-25.png]]

Celui-ci s'appelle msg/payload par défaut

[[fichier:Rasp-Node-Red-picam-mail-26.png]]

Nous allons double-cliquer sur ce bloc pour le configurer.

[[fichier:Rasp-Node-Red-picam-mail-27.png]]

==== Output ====

Dans ce champs, nous allons choisir la partie du flux que nous souhaitons afficher, ou nous allons sélectionner le flux entier.

[[fichier:Rasp-Node-Red-picam-mail-28.png]]

Sélectionner le flux entier, nous affichera le flux complet incluant toutes ses propriétés.

[[fichier:Rasp-Node-Red-picam-mail-29.png]]

==== To =====

La propriété "To" nous permet de choisir ou nous souhaitons afficher les données que nous récupérons.
Soit nous les affichons uniquement dans l'onglet "Debug" à droite de l'espace de travail, soit nous l'affichons dans cet onglet mais aussi dans la console de NodeJS.
Dans notre cas, nous allons nous contenter d'afficher nos éléments dans l'onglet de "Debug" à droite de notre espace de travail.

[[fichier:Rasp-Node-Red-picam-mail-30.png]]

==== Name ====

Le champs Name nous servira à identifier quel bloc de "Debug" affiche les données en console ou dans l'onglet "Debug".
Il faut donc le nommer efficacement pour bien attacher et comprendre les données que nous récupérons, surtout si nous en plaçons plusieurs dans le flux.

[[fichier:Rasp-Node-Red-picam-mail-31.png]]

==== Exploitation et compréhension des données récupérées ====

Nous avons placé notre bloc "Debug" à la suite du flux en dernière position.

[[fichier:Rasp-Node-Red-picam-mail-32.png]]

Nous allons donc déployer le programme en cliquant sur "Deploy" en haut à droite de la page.

[[fichier:Rasp-Node-Red-picam-mail-33.png]]

Ensuite, nous allons exécuter manuellement le programme en cliquant sur le bouton se trouvant en début de chaîne:

[[fichier:Rasp-Node-Red-picam-mail-34.png]]

Nous allons ensuite afficher l'onglet "Debug" sur le coté droit de la page et analyser les données récupérées:

[[fichier:Rasp-Node-Red-picam-mail-35.png]]

==== Analyse des données récupérées dans l'onglet "Debug" ====

<syntaxhighlight lang="bash">
08/05/2017 à 12:54:31 node: FORMATAGE
MCHobby - Photo bureau : msg : Object
object
_msgid: "81efe35c.3208d"
topic: "MCHobby - Photo bureau"
payload: "<html>↵ <head>↵ <meta charset="utf8"/>↵ ↵ </head>↵ <body>↵ <h1>MCHobby - Photo bureau</h1>↵ <p>Cette photo est un instantané pris dans les bureaux de MCHobby.</p>↵
<img src="data:image/jpg;base64,/9j/4WP6x2.../>"
</syntaxhighlight>

Comme vous pourrez le constater, chaque élément du noeud est détaillé.
Les données sont cependant tronquées, le noeud "Debug" ne nous fourni pas la totalité du "PayLoad" mais nous avons déjà un bon aperçu des données qu'il contient.

* '''_msgid:''' est un Id unique de message
* '''topic:''' est le sujet du mail, nous l'avons déterminé dans le premier bloc
* '''payload:''' contient les données du message formatées par le template que nous avons créé et complété par l'image en base64.

{{tmbox | text = Les noeuds "Debug" sont pratiques. Ils nous permettent d'afficher une partie ou la totalité du flux tel qu'il est à l'endroit ou ils sont placés. <br/><br/> Cela peut permettre d'identifier et de résoudre plus facilement des problèmes dans des opérations plus complexes et dans notre cas, cela nous permet de mieux comprendre comment fonctionne le noeud et comment les données sont transmises d'un bloc à l'autre.}}

=== Création d'un expéditeur ===

Nous avons construit petit à petit un message avec un sujet, mais il manque encore un détail: l'expéditeur de l'email que nous allons envoyer.

Si vous avez bien suivi les étapes précédentes du tuto, jusqu'au noeud "Debug" et à son résultat, vous comprendrez facilement la démarche ci après pour ajouter un expéditeur dans le flux.

{{Rasp-Node-Red-TRAILER}}

Rasp-Node-Red-picam-mail

2017-05-08T13:04:11Z

AntoineWrt : /* Analyse des données récupérées dans l'onglet "Debug" */

{{Rasp-Node-Red-NAV}}

{{traduction}}

== PiCamRED - Envoi périodique de photos par email avec PiCam et NodeRED ==

[[fichier:Rasp-Node-Red-picam-mail-01.png|900px]]

=== Description du projet ===

Dans ce tutoriel, nous allons réaliser des photos à l'aide de la caméra du RaspBerry Pi 2/3 et envoyer ces clichés par email de manière périodique grâce à NodeRED.
Nous allons donc utiliser plusieurs blocs et décrire de manière détaillée le déroulement de chaque étape de la réalisation de ce projet.

Dans NodeRED, il est important de bien identifier la finalité de notre projet afin de connaître au préalable tous les éléments qu'il faudra créer et fournir à l'action finale (celle qui enverra un email).

=== Quels sont les besoins du noeud email ===

==== Composants nécessaires pour constituer un email ====

Un email est composé des éléments suivants:

* Un expéditeur
* Un destinataire
* Un sujet
* Le corps du message

Tous ces éléments vont donc devoir être préparés afin de pouvoir construire le message à envoyer par le noeud final.

Le noeud final aura aussi besoin d'un serveur SMTP (serveur d'envoi d'emails) et éventuellement de paramètres d'identification pour ce serveur d'envoi d'emails.

==== Détail des besoins du noeud email ====

La liste des éléments nécessaires s'affiche lorsque le bloc est dans la zone de travail (Schema).
Commençons donc par sélectionner le bloc email, et de le glisser dans la zone de travail.

Commençons par cliquer sur le bloc email et nous maintenons le clic pour le glisser à droite dans l'espace de travail.

(on choisit celui qui a son point de liaison à gauche, car nous voulons un bloc de sortie)

[[fichier:Rasp-Node-Red-picam-mail-36.png]]

Glissons le dans l'espace de travail, et cliquons un clic simple pour le sélectionner.

[[fichier:Rasp-Node-Red-picam-mail-37.png]]

Ensuite, dans la colonne à droite de cet espace de travail, nous cliquons sur info et nous pourrons découvrir les éléments nécessaires à la constitution d'un bloc email.

[[fichier:Rasp-Node-Red-picam-mail-38.png]]

===== Nous utiliserons les champs suivants =====

* '''msg.payload''' --> Ce champ contient le corps de l'email
* '''msg.topic''' --> Ce champ contient le sujet de l'email
* '''msg.from''' --> Ce champ contient l'email de l'expéditeur
* '''msg.to''' --> Ce champ contient l'email du destinataire

Les autres champs ne seront pas utilisés dans notre cas, mais vous pourrez constater que le bloc email est complet de part ses fonctionnalités et possibilités.

Les données de serveur et d'identification seront abordées en fin de tuto lors de la configuration finale du bloc.

Nous allons maintenant passer à la réalisation du flux en commençant par le début de celui-ci.

=== Création d'une action périodique ===

Dans la colonne de gauche de NodeRED, se trouvent une liste de blocs à utiliser pour réaliser vos projets. Ils sont classés par "types".

Ainsi nous retrouvons les "types" suivants:

* Input qui contient tous les blocs d'entrées
* Ouput qui contient tous les blocs de sortie
* Function qui contient des blocs de fonctions javascript etc...
* Social qui sont des blocs d'entrée ou sorties depuis ou vers les réseaux sociaux
* Storage qui sont des fonctions de lecture ou d'écriture de fichiers
* Analysis ->> Sentiment interprète du texte et détermine un score sur base d'un dictionnaire anglais, renvoie le texte avec ce score de -5 à +5, déterminant ainsi l'émotion susceptible d'être procuré par ce texte
* Advanced possède des outils permettant de détecter des changements dans des fichiers ou dossiers, de lire des flux RSS ou encore EXEC qui permet d'exécuter directement des commandes sous linux !
* Raspberry Pi contient des outils pour piloter/lire le GPIO du raspberry Pi
* Network qui contient un outil réseau de Ping

Nous allons créer une action périodique, c'est à dire paramétrer un bloc "INJECT" de manière à déclencher régulièrement une chaine d'actions que nous allons accrocher à la suite les unes après les autres.
Nous allons donc cliquer sur le bloc "Inject" dans la liste "Input" et maintenir ce clic pour le déplacer vers la zone de travail.

[[fichier:Rasp-Node-Red-picam-mail-02.png]]

Nous obtiendrons donc une nouvelle instance "inject" qui portera le nom "Timestamp" (ce nom est attribué par défaut par NodeRED) comme dans la capture ci-dessous

[[fichier:Rasp-Node-Red-picam-mail-03.png]]

Nous allons maintenant double-cliquer sur celle-ci fin de l'éditer pour voir apparaitre le menu ci-dessous

[[fichier:Rasp-Node-Red-picam-mail-04.png]]

Il va falloir configurer ce bloc, mais avant tout voici une explication de celui-ci:

==== Payload ====

Le champs PayLoad est en fait le champ de données qui sera suivi d'un noeud à l'autre jusque à la fin de la chaine.
Dans ce module "inject", nous allons donc déterminer quel type de données contiendra le "PayLoad" jusqu'à la fin de la chaine que l'on va réaliser.

Dans notre cas, nous souhaitons construire un email, donc du contenu textuel, nous allons donc choisir "String" ce qui correspond à une chaine de caractères (du texte).

[[fichier:Rasp-Node-Red-picam-mail-05.png]]

==== Topic ====

Le champs "Topic" est un champs de texte dans lequel nous allons mettre un sujet succinct décrivant notre chaine.
Dans notre cas, ce sujet fera office de sujet au mail que nous expédierons.
Nous allons donc être précis en un minimum de mots pour que le destinataire de l'email puisse facilement deviner le contenu de celui-ci.

[[fichier:Rasp-Node-Red-picam-mail-06.png]]

==== Repeat ====

Nous allons ensuite choisir l'intervalle de déclenchement de notre action, sachant que nous avons le choix entre:

* none : pas de déclenchement périodique programmé
* interval : nous fixons un temps de déclenchement à partir du lancement du programme, l'action se réalisera à chaque fois que ce temps sera écoulé de manière répétée jusqu'à l'interruption manuelle du programme
* interval between times : nous fixons ici le déclenchement par interval, mais nous fixons aussi une fourchette d'heures et des jours pendant lesquels nous exécutons cet interval
* at a specific time : nous fixons une heure d'exécution, et un ou plusieurs jours d'exécution. Dans ce cas l'action n'est pas répétée en continu mais éxécutée une seule fois par jour à l'heure programmée

Dans notre exemple, nous allons fixer un intervalle de 15 secondes pour commencer. Nous pourrons ensuite augmenter cette valeur pour éviter de recevoir trop d'emails avec des photos :D

[[fichier:Rasp-Node-Red-picam-mail-07.png]]

La case "inject once at start" permet de ne pas attendre le premier cycle avant d'exécuter une première fois l'action. Elle se lancera dès le lancement du programme, puis périodiquement selon les cycles déterminés par l'intervalle.

[[fichier:Rasp-Node-Red-picam-mail-08.png]]

==== Name ====

Le champs Name va déterminer le nom que portera le bloc dans l'espace de travail et dans les logs (si nous créons des blocs de log ensuite pour contrôler des étapes).
Il est important de bien établir ce nom de manière explicite, car le nom des blocs permettra de comprendre et retrouver facilement la logique du schéma construit, même si l'on a pas consulté celui-ci pendant une longue période.

[[fichier:Rasp-Node-Red-picam-mail-09.png]]

=== Capture d'une image depuis la PiCam ===

Nous allons aller à l'essentiel en ce qui concerne la capture photo en utilisant une commande simple pour prendre un cliché et renvoyer celui-ci dans le flux NodeRED grâce à un bloc permettant d'exécuter des commandes bash.

{{ambox | text = Vous trouverez un TUTO détaillé sur la PiCam vous permettant de prendre la main, ou de la paramétrer si vous n'avez pas encore utilisé celle-ci auparavant: ....___TUTO___...}}

Nous allons tout d'abord cliquer sur le bloc "Exec" dans la section "Advanced" de la colonne de gauche et glisser l'élément dans la zone de travail.

[[fichier:Rasp-Node-Red-picam-mail-10.png]]

Ensuite, cliquer sur le bloc nouvellement créé et configurer celui-ci.

[[fichier:Rasp-Node-Red-picam-mail-11.png]]

Le menu suivant s'affichera, et nous pourrons configurer le bloc "Exec" nouvellement créé.

==== Command ====

Nous allons y ajouter la commande à exécuter pour prendre une photo avec la caméra du Raspberry Pi et la stocker dans un fichier jpg dans le dossier /tmp/ de linux.

<syntaxhighlight lang="python">
raspistill -o /tmp/cam.jpg -w 640 -h 480
</syntaxhighlight>

Nous prenons soin de limiter la hauteur et la largeur de l'image afin de réduire son poids pour l'envoi par email.

[[fichier:Rasp-Node-Red-picam-mail-12.png]]

==== +Append ====

Ensuite, nous allons décocher la case "msg.payload" si elle est cochée par défaut.

[[fichier:Rasp-Node-Red-picam-mail-13.png]]

==== Extra input parameters et Timeout ====

Nous n'aurons pas besoin de compléter ces champs pour notre projet.

Si vous cochez le champ "Use spawn() instead of exec()?", votre commande sera réalisée sous forme d'un processus résident et continuera de s'exécuter jusqu'à ce qu'elle se termine par elle-même (sauf si elle ne se termine jamais).
Cette solution implique que le programme n'attendra pas que cette commande soit réalisée pour passer aux étapes suivantes.
Si la suite de l'exécution de votre flux est susceptible d'utiliser le résultat de cette commande, nous vous déconseillons d'utiliser cette option sous peine de provoquer des erreurs à la suite du traitement du flux.

Le champ "Timeout" permet de définir un temps d'attente maximum avant de mettre un terme à l'exécution de la commande.
Cela permet de débloquer la situation si la commande exécutée prends un temps anormalement long à s'exécuter.

==== Name ====

Nous allons ensuite compléter le champs nom, celui-ci sera utilisé pour nommer le bloc dans le "schéma", mais aussi de nommer les logs comme pour le bloc "Exec".

[[fichier:Rasp-Node-Red-picam-mail-14.png]]

=== Encodage de l'image en base64 ===

Nous allons convertir la photo prise juste avant en utilisant une commande de conversion en base64.
Cela facilitera son injection dans un template HTML que nous allons créer ensuite pour construire un email.

Nous allons tout d'abord cliquer sur le bloc "Exec" dans la section "Advanced" de la colonne de gauche et glisser l'élément dans la zone de travail.

[[fichier:Rasp-Node-Red-picam-mail-10.png]]

Ensuite, cliquer sur le bloc nouvellement créé et configurer celui-ci.

[[fichier:Rasp-Node-Red-picam-mail-11.png]]

Le menu suivant s'affichera, et nous pourrons configurer le bloc "Exec" nouvellement créé.

[[fichier:Rasp-Node-Red-picam-mail-15.png]]

==== Command ====

Nous allons y ajouter la commande à exécuter pour encoder en base 64 la photo prise précédemment avec la caméra du Raspberry Pi.

<syntaxhighlight lang="python">
base64 -i "/tmp/cam.jpg"
</syntaxhighlight>

[[fichier:Rasp-Node-Red-picam-mail-16.png]]

==== +Append ====

Ensuite, nous allons cocher la case "msg.payload" si elle n'est pas cochée par défaut pour que le résultat soit directement renvoyé par cette commande dans le "PayLoad" du flux.

[[fichier:Rasp-Node-Red-picam-mail-17.png]]

==== Extra input parameters et Timeout ====

Nous n'aurons pas besoin de compléter ces champs pour notre projet.

Si vous cochez le champ "Use spawn() instead of exec()?", votre commande sera réalisée sous forme d'un processus résident et continuera de s'exécuter jusqu'à ce qu'elle se termine par elle-même (sauf si elle ne se termine jamais).
Cette solution implique que le programme n'attendra pas que cette commande soit réalisée pour passer aux étapes suivantes.
Si la suite de l'exécution de votre flux est susceptible d'utiliser le résultat de cette commande, nous vous déconseillons d'utiliser cette option sous peine de provoquer des erreurs à la suite du traitement du flux.

[[fichier:Rasp-Node-Red-picam-mail-18.png]]

Le champ "Timeout" permet de définir un temps d'attente maximum avant de mettre un terme à l'exécution de la commande.
Cela permet de débloquer la situation si la commande exécutée prends un temps anormalement long à s'exécuter.

[[fichier:Rasp-Node-Red-picam-mail-19.png]]

==== Name ====

Nous allons ensuite compléter le champs nom, celui-ci sera utilisé pour nommer le bloc dans le "schéma", mais aussi de nommer les logs comme pour le bloc "Exec".

[[fichier:Rasp-Node-Red-picam-mail-20.png]]

=== Création d'un email au format HTML ===

Nous allons maintenant créer un template d'email au format HTML afin de mettre en forme le message que nous enverrons ensuite.
Nous allons pour cela utiliser un bloc "Template".

[[fichier:Rasp-Node-Red-picam-mail-21.png]]

==== Name ====

Nous allons attribuer un nom au bloc afin de l'identifier plus facilement dans le flux.
Nous allons donc le nommer "Contenu du mail" puisque nous créons le contenu du mail que nous enverrons ensuite.

[[fichier:Rasp-Node-Red-picam-mail-22.png]]

==== Set property ====

La propriété que nous souhaitons créer dans le flux est le "PayLoad".
Ce PayLoad existe déjà, il contient pour le moment l'image au format "Base64" précédemment encodé.
Cela n'est pas un problème, après notre noeud (notre bloc), le PayLoad sera intégralement remplacé par le template que nous sommes en train de créer.

[[fichier:Rasp-Node-Red-picam-mail-23.png]]

==== Template ====

Dans ce template, nous allons créer une structure HTML de base minimum afin que la structure soit interprétée par la majorité des clients/webmail.
Vous pouvez la personnaliser à votre guise si vous avez les connaissances en HTML.

Voici la structure de base pour notre projet:

<syntaxhighlight lang="html">
<html>
<head>
<meta charset="utf8"/>
</head>
<body>
<h1>Projet Photo par email</h1>
<img src="data:image/jpg;base64,{{payload}}"/>
</body>
</html>
</syntaxhighlight>

Vous pourrez remarquer que nous intégrons l'image en appelant le PayLoad à 'intérieur du code HTML dans la balise <img>.
C'est le PayLoad créé précédemment par le bloc "Exec" qui est récupéré à ce moment précis.
Ce PayLoad est remplacé dans le flux par le PayLoad complet avec notre template dans le flux par notre bloc Template.

[[fichier:Rasp-Node-Red-picam-mail-24.png]]

=== Création d'un bloc (noeud) "Debug" ===

Nous allons ajouter la notion d'expéditeur dans le flux que nous avons créé à travers nos blocs (noeuds).
Pour rappel, actuellement nous avons deux propriétés avec des données dans notre flux.
Si nous voulons observer ce que nous avons créé jusque là, nous pouvons faire appel à un bloc "Debug".

==== Création du bloc "Debug" ====

Comme pour les blocs précédents, nous allons glisser/déposer un bloc débug dans l'espace de travail.

[[fichier:Rasp-Node-Red-picam-mail-25.png]]

Celui-ci s'appelle msg/payload par défaut

[[fichier:Rasp-Node-Red-picam-mail-26.png]]

Nous allons double-cliquer sur ce bloc pour le configurer.

[[fichier:Rasp-Node-Red-picam-mail-27.png]]

==== Output ====

Dans ce champs, nous allons choisir la partie du flux que nous souhaitons afficher, ou nous allons sélectionner le flux entier.

[[fichier:Rasp-Node-Red-picam-mail-28.png]]

Sélectionner le flux entier, nous affichera le flux complet incluant toutes ses propriétés.

[[fichier:Rasp-Node-Red-picam-mail-29.png]]

==== To =====

La propriété "To" nous permet de choisir ou nous souhaitons afficher les données que nous récupérons.
Soit nous les affichons uniquement dans l'onglet "Debug" à droite de l'espace de travail, soit nous l'affichons dans cet onglet mais aussi dans la console de NodeJS.
Dans notre cas, nous allons nous contenter d'afficher nos éléments dans l'onglet de "Debug" à droite de notre espace de travail.

[[fichier:Rasp-Node-Red-picam-mail-30.png]]

==== Name ====

Le champs Name nous servira à identifier quel bloc de "Debug" affiche les données en console ou dans l'onglet "Debug".
Il faut donc le nommer efficacement pour bien attacher et comprendre les données que nous récupérons, surtout si nous en plaçons plusieurs dans le flux.

[[fichier:Rasp-Node-Red-picam-mail-31.png]]

==== Exploitation et compréhension des données récupérées ====

Nous avons placé notre bloc "Debug" à la suite du flux en dernière position.

[[fichier:Rasp-Node-Red-picam-mail-32.png]]

Nous allons donc déployer le programme en cliquant sur "Deploy" en haut à droite de la page.

[[fichier:Rasp-Node-Red-picam-mail-33.png]]

Ensuite, nous allons exécuter manuellement le programme en cliquant sur le bouton se trouvant en début de chaîne:

[[fichier:Rasp-Node-Red-picam-mail-34.png]]

Nous allons ensuite afficher l'onglet "Debug" sur le coté droit de la page et analyser les données récupérées:

[[fichier:Rasp-Node-Red-picam-mail-35.png]]

==== Analyse des données récupérées dans l'onglet "Debug" ====

<syntaxhighlight lang="bash">
08/05/2017 à 12:54:31 node: FORMATAGE
MCHobby - Photo bureau : msg : Object
object
_msgid: "81efe35c.3208d"
topic: "MCHobby - Photo bureau"
payload: "<html>↵ <head>↵ <meta charset="utf8"/>↵ ↵ </head>↵ <body>↵ <h1>MCHobby - Photo bureau</h1>↵ <p>Cette photo est un instantané pris dans les bureaux de MCHobby.</p>↵
<img src="data:image/jpg;base64,/9j/4WP6x2.../>"
</syntaxhighlight>

Comme vous pourrez le constater, chaque élément du noeud est détaillé.
Les données sont cependant tronquées, le noeud "Debug" ne nous fourni pas la totalité du "PayLoad" mais nous avons déjà un bon aperçu des données qu'il contient.

* '''_msgid:''' est un Id unique de message
* '''topic:''' est le sujet du mail, nous l'avons déterminé dans le premier bloc
* '''payload:''' contient les données du message formatées par le template que nous avons créé et complété par l'image en base64.

{{tmbox | text = Les noeuds "Debug" sont pratiques. Ils nous permettent d'afficher une partie ou la totalité du flux tel qu'il est à l'endroit ou ils sont placés. <br/> Cela peut permettre d'identifier et de résoudre plus facilement des problèmes dans des opérations plus complexes et dans notre cas, cela nous permet de mieux comprendre comment fonctionne le noeud et comment les données sont transmises d'un bloc à l'autre.}}

=== Création d'un expéditeur ===

Nous avons construit petit à petit un message avec un sujet, mais il manque encore un détail: l'expéditeur de l'email que nous allons envoyer.

Si vous avez bien suivi les étapes précédentes du tuto, jusqu'au noeud "Debug" et à son résultat, vous comprendrez facilement la démarche ci après pour ajouter un expéditeur dans le flux.

{{Rasp-Node-Red-TRAILER}}

Rasp-Node-Red-picam-mail

2017-05-08T13:03:44Z

AntoineWrt : /* Analyse des données récupérées dans l'onglet "Debug" */

{{Rasp-Node-Red-NAV}}

{{traduction}}

== PiCamRED - Envoi périodique de photos par email avec PiCam et NodeRED ==

[[fichier:Rasp-Node-Red-picam-mail-01.png|900px]]

=== Description du projet ===

Dans ce tutoriel, nous allons réaliser des photos à l'aide de la caméra du RaspBerry Pi 2/3 et envoyer ces clichés par email de manière périodique grâce à NodeRED.
Nous allons donc utiliser plusieurs blocs et décrire de manière détaillée le déroulement de chaque étape de la réalisation de ce projet.

Dans NodeRED, il est important de bien identifier la finalité de notre projet afin de connaître au préalable tous les éléments qu'il faudra créer et fournir à l'action finale (celle qui enverra un email).

=== Quels sont les besoins du noeud email ===

==== Composants nécessaires pour constituer un email ====

Un email est composé des éléments suivants:

* Un expéditeur
* Un destinataire
* Un sujet
* Le corps du message

Tous ces éléments vont donc devoir être préparés afin de pouvoir construire le message à envoyer par le noeud final.

Le noeud final aura aussi besoin d'un serveur SMTP (serveur d'envoi d'emails) et éventuellement de paramètres d'identification pour ce serveur d'envoi d'emails.

==== Détail des besoins du noeud email ====

La liste des éléments nécessaires s'affiche lorsque le bloc est dans la zone de travail (Schema).
Commençons donc par sélectionner le bloc email, et de le glisser dans la zone de travail.

Commençons par cliquer sur le bloc email et nous maintenons le clic pour le glisser à droite dans l'espace de travail.

(on choisit celui qui a son point de liaison à gauche, car nous voulons un bloc de sortie)

[[fichier:Rasp-Node-Red-picam-mail-36.png]]

Glissons le dans l'espace de travail, et cliquons un clic simple pour le sélectionner.

[[fichier:Rasp-Node-Red-picam-mail-37.png]]

Ensuite, dans la colonne à droite de cet espace de travail, nous cliquons sur info et nous pourrons découvrir les éléments nécessaires à la constitution d'un bloc email.

[[fichier:Rasp-Node-Red-picam-mail-38.png]]

===== Nous utiliserons les champs suivants =====

* '''msg.payload''' --> Ce champ contient le corps de l'email
* '''msg.topic''' --> Ce champ contient le sujet de l'email
* '''msg.from''' --> Ce champ contient l'email de l'expéditeur
* '''msg.to''' --> Ce champ contient l'email du destinataire

Les autres champs ne seront pas utilisés dans notre cas, mais vous pourrez constater que le bloc email est complet de part ses fonctionnalités et possibilités.

Les données de serveur et d'identification seront abordées en fin de tuto lors de la configuration finale du bloc.

Nous allons maintenant passer à la réalisation du flux en commençant par le début de celui-ci.

=== Création d'une action périodique ===

Dans la colonne de gauche de NodeRED, se trouvent une liste de blocs à utiliser pour réaliser vos projets. Ils sont classés par "types".

Ainsi nous retrouvons les "types" suivants:

* Input qui contient tous les blocs d'entrées
* Ouput qui contient tous les blocs de sortie
* Function qui contient des blocs de fonctions javascript etc...
* Social qui sont des blocs d'entrée ou sorties depuis ou vers les réseaux sociaux
* Storage qui sont des fonctions de lecture ou d'écriture de fichiers
* Analysis ->> Sentiment interprète du texte et détermine un score sur base d'un dictionnaire anglais, renvoie le texte avec ce score de -5 à +5, déterminant ainsi l'émotion susceptible d'être procuré par ce texte
* Advanced possède des outils permettant de détecter des changements dans des fichiers ou dossiers, de lire des flux RSS ou encore EXEC qui permet d'exécuter directement des commandes sous linux !
* Raspberry Pi contient des outils pour piloter/lire le GPIO du raspberry Pi
* Network qui contient un outil réseau de Ping

Nous allons créer une action périodique, c'est à dire paramétrer un bloc "INJECT" de manière à déclencher régulièrement une chaine d'actions que nous allons accrocher à la suite les unes après les autres.
Nous allons donc cliquer sur le bloc "Inject" dans la liste "Input" et maintenir ce clic pour le déplacer vers la zone de travail.

[[fichier:Rasp-Node-Red-picam-mail-02.png]]

Nous obtiendrons donc une nouvelle instance "inject" qui portera le nom "Timestamp" (ce nom est attribué par défaut par NodeRED) comme dans la capture ci-dessous

[[fichier:Rasp-Node-Red-picam-mail-03.png]]

Nous allons maintenant double-cliquer sur celle-ci fin de l'éditer pour voir apparaitre le menu ci-dessous

[[fichier:Rasp-Node-Red-picam-mail-04.png]]

Il va falloir configurer ce bloc, mais avant tout voici une explication de celui-ci:

==== Payload ====

Le champs PayLoad est en fait le champ de données qui sera suivi d'un noeud à l'autre jusque à la fin de la chaine.
Dans ce module "inject", nous allons donc déterminer quel type de données contiendra le "PayLoad" jusqu'à la fin de la chaine que l'on va réaliser.

Dans notre cas, nous souhaitons construire un email, donc du contenu textuel, nous allons donc choisir "String" ce qui correspond à une chaine de caractères (du texte).

[[fichier:Rasp-Node-Red-picam-mail-05.png]]

==== Topic ====

Le champs "Topic" est un champs de texte dans lequel nous allons mettre un sujet succinct décrivant notre chaine.
Dans notre cas, ce sujet fera office de sujet au mail que nous expédierons.
Nous allons donc être précis en un minimum de mots pour que le destinataire de l'email puisse facilement deviner le contenu de celui-ci.

[[fichier:Rasp-Node-Red-picam-mail-06.png]]

==== Repeat ====

Nous allons ensuite choisir l'intervalle de déclenchement de notre action, sachant que nous avons le choix entre:

* none : pas de déclenchement périodique programmé
* interval : nous fixons un temps de déclenchement à partir du lancement du programme, l'action se réalisera à chaque fois que ce temps sera écoulé de manière répétée jusqu'à l'interruption manuelle du programme
* interval between times : nous fixons ici le déclenchement par interval, mais nous fixons aussi une fourchette d'heures et des jours pendant lesquels nous exécutons cet interval
* at a specific time : nous fixons une heure d'exécution, et un ou plusieurs jours d'exécution. Dans ce cas l'action n'est pas répétée en continu mais éxécutée une seule fois par jour à l'heure programmée

Dans notre exemple, nous allons fixer un intervalle de 15 secondes pour commencer. Nous pourrons ensuite augmenter cette valeur pour éviter de recevoir trop d'emails avec des photos :D

[[fichier:Rasp-Node-Red-picam-mail-07.png]]

La case "inject once at start" permet de ne pas attendre le premier cycle avant d'exécuter une première fois l'action. Elle se lancera dès le lancement du programme, puis périodiquement selon les cycles déterminés par l'intervalle.

[[fichier:Rasp-Node-Red-picam-mail-08.png]]

==== Name ====

Le champs Name va déterminer le nom que portera le bloc dans l'espace de travail et dans les logs (si nous créons des blocs de log ensuite pour contrôler des étapes).
Il est important de bien établir ce nom de manière explicite, car le nom des blocs permettra de comprendre et retrouver facilement la logique du schéma construit, même si l'on a pas consulté celui-ci pendant une longue période.

[[fichier:Rasp-Node-Red-picam-mail-09.png]]

=== Capture d'une image depuis la PiCam ===

Nous allons aller à l'essentiel en ce qui concerne la capture photo en utilisant une commande simple pour prendre un cliché et renvoyer celui-ci dans le flux NodeRED grâce à un bloc permettant d'exécuter des commandes bash.

{{ambox | text = Vous trouverez un TUTO détaillé sur la PiCam vous permettant de prendre la main, ou de la paramétrer si vous n'avez pas encore utilisé celle-ci auparavant: ....___TUTO___...}}

Nous allons tout d'abord cliquer sur le bloc "Exec" dans la section "Advanced" de la colonne de gauche et glisser l'élément dans la zone de travail.

[[fichier:Rasp-Node-Red-picam-mail-10.png]]

Ensuite, cliquer sur le bloc nouvellement créé et configurer celui-ci.

[[fichier:Rasp-Node-Red-picam-mail-11.png]]

Le menu suivant s'affichera, et nous pourrons configurer le bloc "Exec" nouvellement créé.

==== Command ====

Nous allons y ajouter la commande à exécuter pour prendre une photo avec la caméra du Raspberry Pi et la stocker dans un fichier jpg dans le dossier /tmp/ de linux.

<syntaxhighlight lang="python">
raspistill -o /tmp/cam.jpg -w 640 -h 480
</syntaxhighlight>

Nous prenons soin de limiter la hauteur et la largeur de l'image afin de réduire son poids pour l'envoi par email.

[[fichier:Rasp-Node-Red-picam-mail-12.png]]

==== +Append ====

Ensuite, nous allons décocher la case "msg.payload" si elle est cochée par défaut.

[[fichier:Rasp-Node-Red-picam-mail-13.png]]

==== Extra input parameters et Timeout ====

Nous n'aurons pas besoin de compléter ces champs pour notre projet.

Si vous cochez le champ "Use spawn() instead of exec()?", votre commande sera réalisée sous forme d'un processus résident et continuera de s'exécuter jusqu'à ce qu'elle se termine par elle-même (sauf si elle ne se termine jamais).
Cette solution implique que le programme n'attendra pas que cette commande soit réalisée pour passer aux étapes suivantes.
Si la suite de l'exécution de votre flux est susceptible d'utiliser le résultat de cette commande, nous vous déconseillons d'utiliser cette option sous peine de provoquer des erreurs à la suite du traitement du flux.

Le champ "Timeout" permet de définir un temps d'attente maximum avant de mettre un terme à l'exécution de la commande.
Cela permet de débloquer la situation si la commande exécutée prends un temps anormalement long à s'exécuter.

==== Name ====

Nous allons ensuite compléter le champs nom, celui-ci sera utilisé pour nommer le bloc dans le "schéma", mais aussi de nommer les logs comme pour le bloc "Exec".

[[fichier:Rasp-Node-Red-picam-mail-14.png]]

=== Encodage de l'image en base64 ===

Nous allons convertir la photo prise juste avant en utilisant une commande de conversion en base64.
Cela facilitera son injection dans un template HTML que nous allons créer ensuite pour construire un email.

Nous allons tout d'abord cliquer sur le bloc "Exec" dans la section "Advanced" de la colonne de gauche et glisser l'élément dans la zone de travail.

[[fichier:Rasp-Node-Red-picam-mail-10.png]]

Ensuite, cliquer sur le bloc nouvellement créé et configurer celui-ci.

[[fichier:Rasp-Node-Red-picam-mail-11.png]]

Le menu suivant s'affichera, et nous pourrons configurer le bloc "Exec" nouvellement créé.

[[fichier:Rasp-Node-Red-picam-mail-15.png]]

==== Command ====

Nous allons y ajouter la commande à exécuter pour encoder en base 64 la photo prise précédemment avec la caméra du Raspberry Pi.

<syntaxhighlight lang="python">
base64 -i "/tmp/cam.jpg"
</syntaxhighlight>

[[fichier:Rasp-Node-Red-picam-mail-16.png]]

==== +Append ====

Ensuite, nous allons cocher la case "msg.payload" si elle n'est pas cochée par défaut pour que le résultat soit directement renvoyé par cette commande dans le "PayLoad" du flux.

[[fichier:Rasp-Node-Red-picam-mail-17.png]]

==== Extra input parameters et Timeout ====

Nous n'aurons pas besoin de compléter ces champs pour notre projet.

Si vous cochez le champ "Use spawn() instead of exec()?", votre commande sera réalisée sous forme d'un processus résident et continuera de s'exécuter jusqu'à ce qu'elle se termine par elle-même (sauf si elle ne se termine jamais).
Cette solution implique que le programme n'attendra pas que cette commande soit réalisée pour passer aux étapes suivantes.
Si la suite de l'exécution de votre flux est susceptible d'utiliser le résultat de cette commande, nous vous déconseillons d'utiliser cette option sous peine de provoquer des erreurs à la suite du traitement du flux.

[[fichier:Rasp-Node-Red-picam-mail-18.png]]

Le champ "Timeout" permet de définir un temps d'attente maximum avant de mettre un terme à l'exécution de la commande.
Cela permet de débloquer la situation si la commande exécutée prends un temps anormalement long à s'exécuter.

[[fichier:Rasp-Node-Red-picam-mail-19.png]]

==== Name ====

Nous allons ensuite compléter le champs nom, celui-ci sera utilisé pour nommer le bloc dans le "schéma", mais aussi de nommer les logs comme pour le bloc "Exec".

[[fichier:Rasp-Node-Red-picam-mail-20.png]]

=== Création d'un email au format HTML ===

Nous allons maintenant créer un template d'email au format HTML afin de mettre en forme le message que nous enverrons ensuite.
Nous allons pour cela utiliser un bloc "Template".

[[fichier:Rasp-Node-Red-picam-mail-21.png]]

==== Name ====

Nous allons attribuer un nom au bloc afin de l'identifier plus facilement dans le flux.
Nous allons donc le nommer "Contenu du mail" puisque nous créons le contenu du mail que nous enverrons ensuite.

[[fichier:Rasp-Node-Red-picam-mail-22.png]]

==== Set property ====

La propriété que nous souhaitons créer dans le flux est le "PayLoad".
Ce PayLoad existe déjà, il contient pour le moment l'image au format "Base64" précédemment encodé.
Cela n'est pas un problème, après notre noeud (notre bloc), le PayLoad sera intégralement remplacé par le template que nous sommes en train de créer.

[[fichier:Rasp-Node-Red-picam-mail-23.png]]

==== Template ====

Dans ce template, nous allons créer une structure HTML de base minimum afin que la structure soit interprétée par la majorité des clients/webmail.
Vous pouvez la personnaliser à votre guise si vous avez les connaissances en HTML.

Voici la structure de base pour notre projet:

<syntaxhighlight lang="html">
<html>
<head>
<meta charset="utf8"/>
</head>
<body>
<h1>Projet Photo par email</h1>
<img src="data:image/jpg;base64,{{payload}}"/>
</body>
</html>
</syntaxhighlight>

Vous pourrez remarquer que nous intégrons l'image en appelant le PayLoad à 'intérieur du code HTML dans la balise <img>.
C'est le PayLoad créé précédemment par le bloc "Exec" qui est récupéré à ce moment précis.
Ce PayLoad est remplacé dans le flux par le PayLoad complet avec notre template dans le flux par notre bloc Template.

[[fichier:Rasp-Node-Red-picam-mail-24.png]]

=== Création d'un bloc (noeud) "Debug" ===

Nous allons ajouter la notion d'expéditeur dans le flux que nous avons créé à travers nos blocs (noeuds).
Pour rappel, actuellement nous avons deux propriétés avec des données dans notre flux.
Si nous voulons observer ce que nous avons créé jusque là, nous pouvons faire appel à un bloc "Debug".

==== Création du bloc "Debug" ====

Comme pour les blocs précédents, nous allons glisser/déposer un bloc débug dans l'espace de travail.

[[fichier:Rasp-Node-Red-picam-mail-25.png]]

Celui-ci s'appelle msg/payload par défaut

[[fichier:Rasp-Node-Red-picam-mail-26.png]]

Nous allons double-cliquer sur ce bloc pour le configurer.

[[fichier:Rasp-Node-Red-picam-mail-27.png]]

==== Output ====

Dans ce champs, nous allons choisir la partie du flux que nous souhaitons afficher, ou nous allons sélectionner le flux entier.

[[fichier:Rasp-Node-Red-picam-mail-28.png]]

Sélectionner le flux entier, nous affichera le flux complet incluant toutes ses propriétés.

[[fichier:Rasp-Node-Red-picam-mail-29.png]]

==== To =====

La propriété "To" nous permet de choisir ou nous souhaitons afficher les données que nous récupérons.
Soit nous les affichons uniquement dans l'onglet "Debug" à droite de l'espace de travail, soit nous l'affichons dans cet onglet mais aussi dans la console de NodeJS.
Dans notre cas, nous allons nous contenter d'afficher nos éléments dans l'onglet de "Debug" à droite de notre espace de travail.

[[fichier:Rasp-Node-Red-picam-mail-30.png]]

==== Name ====

Le champs Name nous servira à identifier quel bloc de "Debug" affiche les données en console ou dans l'onglet "Debug".
Il faut donc le nommer efficacement pour bien attacher et comprendre les données que nous récupérons, surtout si nous en plaçons plusieurs dans le flux.

[[fichier:Rasp-Node-Red-picam-mail-31.png]]

==== Exploitation et compréhension des données récupérées ====

Nous avons placé notre bloc "Debug" à la suite du flux en dernière position.

[[fichier:Rasp-Node-Red-picam-mail-32.png]]

Nous allons donc déployer le programme en cliquant sur "Deploy" en haut à droite de la page.

[[fichier:Rasp-Node-Red-picam-mail-33.png]]

Ensuite, nous allons exécuter manuellement le programme en cliquant sur le bouton se trouvant en début de chaîne:

[[fichier:Rasp-Node-Red-picam-mail-34.png]]

Nous allons ensuite afficher l'onglet "Debug" sur le coté droit de la page et analyser les données récupérées:

[[fichier:Rasp-Node-Red-picam-mail-35.png]]

==== Analyse des données récupérées dans l'onglet "Debug" ====

<syntaxhighlight lang="bash">
08/05/2017 à 12:54:31 node: FORMATAGE
MCHobby - Photo bureau : msg : Object
object
_msgid: "81efe35c.3208d"
topic: "MCHobby - Photo bureau"
payload: "<html>↵ <head>↵ <meta charset="utf8"/>↵ ↵ </head>↵ <body>↵ <h1>MCHobby - Photo bureau</h1>↵ <p>Cette photo est un instantané pris dans les bureaux de MCHobby.</p>↵
<img src="data:image/jpg;base64,/9j/4WP6x2.../>"
</syntaxhighlight>

Comme vous pourrez le constater, chaque élément du noeud est détaillé.
Les données sont cependant tronquées, le noeud "Debug" ne nous fourni pas la totalité du "PayLoad" mais nous avons déjà un bon aperçu des données qu'il contient.

* '''_msgid:''' est un Id unique de message
* '''topic:''' est le sujet du mail, nous l'avons déterminé dans le premier bloc
* '''payload:''' contient les données du message formatées par le template que nous avons créé et complété par l'image en base64.

{{tmbox | text = Les noeuds "Debug" sont pratiques. Ils nous permettent d'afficher une partie ou la totalité du flux tel qu'il est à l'endroit ou ils sont placés.}}

Cela peut permettre d'identifier et de résoudre plus facilement des problèmes dans des opérations plus complexes et dans notre cas, cela nous permet de mieux comprendre comment fonctionne le noeud et comment les données sont transmises d'un bloc à l'autre.

=== Création d'un expéditeur ===

Nous avons construit petit à petit un message avec un sujet, mais il manque encore un détail: l'expéditeur de l'email que nous allons envoyer.

Si vous avez bien suivi les étapes précédentes du tuto, jusqu'au noeud "Debug" et à son résultat, vous comprendrez facilement la démarche ci après pour ajouter un expéditeur dans le flux.

{{Rasp-Node-Red-TRAILER}}

Rasp-Node-Red-picam-mail

2017-05-08T13:03:26Z

AntoineWrt : /* Analyse des données récupérées dans l'onglet "Debug" */

{{Rasp-Node-Red-NAV}}

{{traduction}}

== PiCamRED - Envoi périodique de photos par email avec PiCam et NodeRED ==

[[fichier:Rasp-Node-Red-picam-mail-01.png|900px]]

=== Description du projet ===

Dans ce tutoriel, nous allons réaliser des photos à l'aide de la caméra du RaspBerry Pi 2/3 et envoyer ces clichés par email de manière périodique grâce à NodeRED.
Nous allons donc utiliser plusieurs blocs et décrire de manière détaillée le déroulement de chaque étape de la réalisation de ce projet.

Dans NodeRED, il est important de bien identifier la finalité de notre projet afin de connaître au préalable tous les éléments qu'il faudra créer et fournir à l'action finale (celle qui enverra un email).

=== Quels sont les besoins du noeud email ===

==== Composants nécessaires pour constituer un email ====

Un email est composé des éléments suivants:

* Un expéditeur
* Un destinataire
* Un sujet
* Le corps du message

Tous ces éléments vont donc devoir être préparés afin de pouvoir construire le message à envoyer par le noeud final.

Le noeud final aura aussi besoin d'un serveur SMTP (serveur d'envoi d'emails) et éventuellement de paramètres d'identification pour ce serveur d'envoi d'emails.

==== Détail des besoins du noeud email ====

La liste des éléments nécessaires s'affiche lorsque le bloc est dans la zone de travail (Schema).
Commençons donc par sélectionner le bloc email, et de le glisser dans la zone de travail.

Commençons par cliquer sur le bloc email et nous maintenons le clic pour le glisser à droite dans l'espace de travail.

(on choisit celui qui a son point de liaison à gauche, car nous voulons un bloc de sortie)

[[fichier:Rasp-Node-Red-picam-mail-36.png]]

Glissons le dans l'espace de travail, et cliquons un clic simple pour le sélectionner.

[[fichier:Rasp-Node-Red-picam-mail-37.png]]

Ensuite, dans la colonne à droite de cet espace de travail, nous cliquons sur info et nous pourrons découvrir les éléments nécessaires à la constitution d'un bloc email.

[[fichier:Rasp-Node-Red-picam-mail-38.png]]

===== Nous utiliserons les champs suivants =====

* '''msg.payload''' --> Ce champ contient le corps de l'email
* '''msg.topic''' --> Ce champ contient le sujet de l'email
* '''msg.from''' --> Ce champ contient l'email de l'expéditeur
* '''msg.to''' --> Ce champ contient l'email du destinataire

Les autres champs ne seront pas utilisés dans notre cas, mais vous pourrez constater que le bloc email est complet de part ses fonctionnalités et possibilités.

Les données de serveur et d'identification seront abordées en fin de tuto lors de la configuration finale du bloc.

Nous allons maintenant passer à la réalisation du flux en commençant par le début de celui-ci.

=== Création d'une action périodique ===

Dans la colonne de gauche de NodeRED, se trouvent une liste de blocs à utiliser pour réaliser vos projets. Ils sont classés par "types".

Ainsi nous retrouvons les "types" suivants:

* Input qui contient tous les blocs d'entrées
* Ouput qui contient tous les blocs de sortie
* Function qui contient des blocs de fonctions javascript etc...
* Social qui sont des blocs d'entrée ou sorties depuis ou vers les réseaux sociaux
* Storage qui sont des fonctions de lecture ou d'écriture de fichiers
* Analysis ->> Sentiment interprète du texte et détermine un score sur base d'un dictionnaire anglais, renvoie le texte avec ce score de -5 à +5, déterminant ainsi l'émotion susceptible d'être procuré par ce texte
* Advanced possède des outils permettant de détecter des changements dans des fichiers ou dossiers, de lire des flux RSS ou encore EXEC qui permet d'exécuter directement des commandes sous linux !
* Raspberry Pi contient des outils pour piloter/lire le GPIO du raspberry Pi
* Network qui contient un outil réseau de Ping

Nous allons créer une action périodique, c'est à dire paramétrer un bloc "INJECT" de manière à déclencher régulièrement une chaine d'actions que nous allons accrocher à la suite les unes après les autres.
Nous allons donc cliquer sur le bloc "Inject" dans la liste "Input" et maintenir ce clic pour le déplacer vers la zone de travail.

[[fichier:Rasp-Node-Red-picam-mail-02.png]]

Nous obtiendrons donc une nouvelle instance "inject" qui portera le nom "Timestamp" (ce nom est attribué par défaut par NodeRED) comme dans la capture ci-dessous

[[fichier:Rasp-Node-Red-picam-mail-03.png]]

Nous allons maintenant double-cliquer sur celle-ci fin de l'éditer pour voir apparaitre le menu ci-dessous

[[fichier:Rasp-Node-Red-picam-mail-04.png]]

Il va falloir configurer ce bloc, mais avant tout voici une explication de celui-ci:

==== Payload ====

Le champs PayLoad est en fait le champ de données qui sera suivi d'un noeud à l'autre jusque à la fin de la chaine.
Dans ce module "inject", nous allons donc déterminer quel type de données contiendra le "PayLoad" jusqu'à la fin de la chaine que l'on va réaliser.

Dans notre cas, nous souhaitons construire un email, donc du contenu textuel, nous allons donc choisir "String" ce qui correspond à une chaine de caractères (du texte).

[[fichier:Rasp-Node-Red-picam-mail-05.png]]

==== Topic ====

Le champs "Topic" est un champs de texte dans lequel nous allons mettre un sujet succinct décrivant notre chaine.
Dans notre cas, ce sujet fera office de sujet au mail que nous expédierons.
Nous allons donc être précis en un minimum de mots pour que le destinataire de l'email puisse facilement deviner le contenu de celui-ci.

[[fichier:Rasp-Node-Red-picam-mail-06.png]]

==== Repeat ====

Nous allons ensuite choisir l'intervalle de déclenchement de notre action, sachant que nous avons le choix entre:

* none : pas de déclenchement périodique programmé
* interval : nous fixons un temps de déclenchement à partir du lancement du programme, l'action se réalisera à chaque fois que ce temps sera écoulé de manière répétée jusqu'à l'interruption manuelle du programme
* interval between times : nous fixons ici le déclenchement par interval, mais nous fixons aussi une fourchette d'heures et des jours pendant lesquels nous exécutons cet interval
* at a specific time : nous fixons une heure d'exécution, et un ou plusieurs jours d'exécution. Dans ce cas l'action n'est pas répétée en continu mais éxécutée une seule fois par jour à l'heure programmée

Dans notre exemple, nous allons fixer un intervalle de 15 secondes pour commencer. Nous pourrons ensuite augmenter cette valeur pour éviter de recevoir trop d'emails avec des photos :D

[[fichier:Rasp-Node-Red-picam-mail-07.png]]

La case "inject once at start" permet de ne pas attendre le premier cycle avant d'exécuter une première fois l'action. Elle se lancera dès le lancement du programme, puis périodiquement selon les cycles déterminés par l'intervalle.

[[fichier:Rasp-Node-Red-picam-mail-08.png]]

==== Name ====

Le champs Name va déterminer le nom que portera le bloc dans l'espace de travail et dans les logs (si nous créons des blocs de log ensuite pour contrôler des étapes).
Il est important de bien établir ce nom de manière explicite, car le nom des blocs permettra de comprendre et retrouver facilement la logique du schéma construit, même si l'on a pas consulté celui-ci pendant une longue période.

[[fichier:Rasp-Node-Red-picam-mail-09.png]]

=== Capture d'une image depuis la PiCam ===

Nous allons aller à l'essentiel en ce qui concerne la capture photo en utilisant une commande simple pour prendre un cliché et renvoyer celui-ci dans le flux NodeRED grâce à un bloc permettant d'exécuter des commandes bash.

{{ambox | text = Vous trouverez un TUTO détaillé sur la PiCam vous permettant de prendre la main, ou de la paramétrer si vous n'avez pas encore utilisé celle-ci auparavant: ....___TUTO___...}}

Nous allons tout d'abord cliquer sur le bloc "Exec" dans la section "Advanced" de la colonne de gauche et glisser l'élément dans la zone de travail.

[[fichier:Rasp-Node-Red-picam-mail-10.png]]

Ensuite, cliquer sur le bloc nouvellement créé et configurer celui-ci.

[[fichier:Rasp-Node-Red-picam-mail-11.png]]

Le menu suivant s'affichera, et nous pourrons configurer le bloc "Exec" nouvellement créé.

==== Command ====

Nous allons y ajouter la commande à exécuter pour prendre une photo avec la caméra du Raspberry Pi et la stocker dans un fichier jpg dans le dossier /tmp/ de linux.

<syntaxhighlight lang="python">
raspistill -o /tmp/cam.jpg -w 640 -h 480
</syntaxhighlight>

Nous prenons soin de limiter la hauteur et la largeur de l'image afin de réduire son poids pour l'envoi par email.

[[fichier:Rasp-Node-Red-picam-mail-12.png]]

==== +Append ====

Ensuite, nous allons décocher la case "msg.payload" si elle est cochée par défaut.

[[fichier:Rasp-Node-Red-picam-mail-13.png]]

==== Extra input parameters et Timeout ====

Nous n'aurons pas besoin de compléter ces champs pour notre projet.

Si vous cochez le champ "Use spawn() instead of exec()?", votre commande sera réalisée sous forme d'un processus résident et continuera de s'exécuter jusqu'à ce qu'elle se termine par elle-même (sauf si elle ne se termine jamais).
Cette solution implique que le programme n'attendra pas que cette commande soit réalisée pour passer aux étapes suivantes.
Si la suite de l'exécution de votre flux est susceptible d'utiliser le résultat de cette commande, nous vous déconseillons d'utiliser cette option sous peine de provoquer des erreurs à la suite du traitement du flux.

Le champ "Timeout" permet de définir un temps d'attente maximum avant de mettre un terme à l'exécution de la commande.
Cela permet de débloquer la situation si la commande exécutée prends un temps anormalement long à s'exécuter.

==== Name ====

Nous allons ensuite compléter le champs nom, celui-ci sera utilisé pour nommer le bloc dans le "schéma", mais aussi de nommer les logs comme pour le bloc "Exec".

[[fichier:Rasp-Node-Red-picam-mail-14.png]]

=== Encodage de l'image en base64 ===

Nous allons convertir la photo prise juste avant en utilisant une commande de conversion en base64.
Cela facilitera son injection dans un template HTML que nous allons créer ensuite pour construire un email.

Nous allons tout d'abord cliquer sur le bloc "Exec" dans la section "Advanced" de la colonne de gauche et glisser l'élément dans la zone de travail.

[[fichier:Rasp-Node-Red-picam-mail-10.png]]

Ensuite, cliquer sur le bloc nouvellement créé et configurer celui-ci.

[[fichier:Rasp-Node-Red-picam-mail-11.png]]

Le menu suivant s'affichera, et nous pourrons configurer le bloc "Exec" nouvellement créé.

[[fichier:Rasp-Node-Red-picam-mail-15.png]]

==== Command ====

Nous allons y ajouter la commande à exécuter pour encoder en base 64 la photo prise précédemment avec la caméra du Raspberry Pi.

<syntaxhighlight lang="python">
base64 -i "/tmp/cam.jpg"
</syntaxhighlight>

[[fichier:Rasp-Node-Red-picam-mail-16.png]]

==== +Append ====

Ensuite, nous allons cocher la case "msg.payload" si elle n'est pas cochée par défaut pour que le résultat soit directement renvoyé par cette commande dans le "PayLoad" du flux.

[[fichier:Rasp-Node-Red-picam-mail-17.png]]

==== Extra input parameters et Timeout ====

Nous n'aurons pas besoin de compléter ces champs pour notre projet.

Si vous cochez le champ "Use spawn() instead of exec()?", votre commande sera réalisée sous forme d'un processus résident et continuera de s'exécuter jusqu'à ce qu'elle se termine par elle-même (sauf si elle ne se termine jamais).
Cette solution implique que le programme n'attendra pas que cette commande soit réalisée pour passer aux étapes suivantes.
Si la suite de l'exécution de votre flux est susceptible d'utiliser le résultat de cette commande, nous vous déconseillons d'utiliser cette option sous peine de provoquer des erreurs à la suite du traitement du flux.

[[fichier:Rasp-Node-Red-picam-mail-18.png]]

Le champ "Timeout" permet de définir un temps d'attente maximum avant de mettre un terme à l'exécution de la commande.
Cela permet de débloquer la situation si la commande exécutée prends un temps anormalement long à s'exécuter.

[[fichier:Rasp-Node-Red-picam-mail-19.png]]

==== Name ====

Nous allons ensuite compléter le champs nom, celui-ci sera utilisé pour nommer le bloc dans le "schéma", mais aussi de nommer les logs comme pour le bloc "Exec".

[[fichier:Rasp-Node-Red-picam-mail-20.png]]

=== Création d'un email au format HTML ===

Nous allons maintenant créer un template d'email au format HTML afin de mettre en forme le message que nous enverrons ensuite.
Nous allons pour cela utiliser un bloc "Template".

[[fichier:Rasp-Node-Red-picam-mail-21.png]]

==== Name ====

Nous allons attribuer un nom au bloc afin de l'identifier plus facilement dans le flux.
Nous allons donc le nommer "Contenu du mail" puisque nous créons le contenu du mail que nous enverrons ensuite.

[[fichier:Rasp-Node-Red-picam-mail-22.png]]

==== Set property ====

La propriété que nous souhaitons créer dans le flux est le "PayLoad".
Ce PayLoad existe déjà, il contient pour le moment l'image au format "Base64" précédemment encodé.
Cela n'est pas un problème, après notre noeud (notre bloc), le PayLoad sera intégralement remplacé par le template que nous sommes en train de créer.

[[fichier:Rasp-Node-Red-picam-mail-23.png]]

==== Template ====

Dans ce template, nous allons créer une structure HTML de base minimum afin que la structure soit interprétée par la majorité des clients/webmail.
Vous pouvez la personnaliser à votre guise si vous avez les connaissances en HTML.

Voici la structure de base pour notre projet:

<syntaxhighlight lang="html">
<html>
<head>
<meta charset="utf8"/>
</head>
<body>
<h1>Projet Photo par email</h1>
<img src="data:image/jpg;base64,{{payload}}"/>
</body>
</html>
</syntaxhighlight>

Vous pourrez remarquer que nous intégrons l'image en appelant le PayLoad à 'intérieur du code HTML dans la balise <img>.
C'est le PayLoad créé précédemment par le bloc "Exec" qui est récupéré à ce moment précis.
Ce PayLoad est remplacé dans le flux par le PayLoad complet avec notre template dans le flux par notre bloc Template.

[[fichier:Rasp-Node-Red-picam-mail-24.png]]

=== Création d'un bloc (noeud) "Debug" ===

Nous allons ajouter la notion d'expéditeur dans le flux que nous avons créé à travers nos blocs (noeuds).
Pour rappel, actuellement nous avons deux propriétés avec des données dans notre flux.
Si nous voulons observer ce que nous avons créé jusque là, nous pouvons faire appel à un bloc "Debug".

==== Création du bloc "Debug" ====

Comme pour les blocs précédents, nous allons glisser/déposer un bloc débug dans l'espace de travail.

[[fichier:Rasp-Node-Red-picam-mail-25.png]]

Celui-ci s'appelle msg/payload par défaut

[[fichier:Rasp-Node-Red-picam-mail-26.png]]

Nous allons double-cliquer sur ce bloc pour le configurer.

[[fichier:Rasp-Node-Red-picam-mail-27.png]]

==== Output ====

Dans ce champs, nous allons choisir la partie du flux que nous souhaitons afficher, ou nous allons sélectionner le flux entier.

[[fichier:Rasp-Node-Red-picam-mail-28.png]]

Sélectionner le flux entier, nous affichera le flux complet incluant toutes ses propriétés.

[[fichier:Rasp-Node-Red-picam-mail-29.png]]

==== To =====

La propriété "To" nous permet de choisir ou nous souhaitons afficher les données que nous récupérons.
Soit nous les affichons uniquement dans l'onglet "Debug" à droite de l'espace de travail, soit nous l'affichons dans cet onglet mais aussi dans la console de NodeJS.
Dans notre cas, nous allons nous contenter d'afficher nos éléments dans l'onglet de "Debug" à droite de notre espace de travail.

[[fichier:Rasp-Node-Red-picam-mail-30.png]]

==== Name ====

Le champs Name nous servira à identifier quel bloc de "Debug" affiche les données en console ou dans l'onglet "Debug".
Il faut donc le nommer efficacement pour bien attacher et comprendre les données que nous récupérons, surtout si nous en plaçons plusieurs dans le flux.

[[fichier:Rasp-Node-Red-picam-mail-31.png]]

==== Exploitation et compréhension des données récupérées ====

Nous avons placé notre bloc "Debug" à la suite du flux en dernière position.

[[fichier:Rasp-Node-Red-picam-mail-32.png]]

Nous allons donc déployer le programme en cliquant sur "Deploy" en haut à droite de la page.

[[fichier:Rasp-Node-Red-picam-mail-33.png]]

Ensuite, nous allons exécuter manuellement le programme en cliquant sur le bouton se trouvant en début de chaîne:

[[fichier:Rasp-Node-Red-picam-mail-34.png]]

Nous allons ensuite afficher l'onglet "Debug" sur le coté droit de la page et analyser les données récupérées:

[[fichier:Rasp-Node-Red-picam-mail-35.png]]

==== Analyse des données récupérées dans l'onglet "Debug" ====

<syntaxhighlight lang="bash">
08/05/2017 à 12:54:31 node: FORMATAGE
MCHobby - Photo bureau : msg : Object
object
_msgid: "81efe35c.3208d"
topic: "MCHobby - Photo bureau"
payload: "<html>↵ <head>↵ <meta charset="utf8"/>↵ ↵ </head>↵ <body>↵ <h1>MCHobby - Photo bureau</h1>↵ <p>Cette photo est un instantané pris dans les bureaux de MCHobby.</p>↵
<img src="data:image/jpg;base64,/9j/4WP6x2.../>"
</syntaxhighlight>

Comme vous pourrez le constater, chaque élément du noeud est détaillé.
Les données sont cependant tronquées, le noeud "Debug" ne nous fourni pas la totalité du "PayLoad" mais nous avons déjà un bon aperçu des données qu'il contient.

'''_msgid:''' est un Id unique de message
'''topic:''' est le sujet du mail, nous l'avons déterminé dans le premier bloc
'''payload:''' contient les données du message formatées par le template que nous avons créé et complété par l'image en base64.

{{tmbox | text = Les noeuds "Debug" sont pratiques. Ils nous permettent d'afficher une partie ou la totalité du flux tel qu'il est à l'endroit ou ils sont placés.}}

Cela peut permettre d'identifier et de résoudre plus facilement des problèmes dans des opérations plus complexes et dans notre cas, cela nous permet de mieux comprendre comment fonctionne le noeud et comment les données sont transmises d'un bloc à l'autre.

=== Création d'un expéditeur ===

Nous avons construit petit à petit un message avec un sujet, mais il manque encore un détail: l'expéditeur de l'email que nous allons envoyer.

Si vous avez bien suivi les étapes précédentes du tuto, jusqu'au noeud "Debug" et à son résultat, vous comprendrez facilement la démarche ci après pour ajouter un expéditeur dans le flux.

{{Rasp-Node-Red-TRAILER}}

Rasp-Node-Red-picam-mail

2017-05-08T12:58:19Z

AntoineWrt : /* Nous utiliserons les champs suivants */

{{Rasp-Node-Red-NAV}}

{{traduction}}

== PiCamRED - Envoi périodique de photos par email avec PiCam et NodeRED ==

[[fichier:Rasp-Node-Red-picam-mail-01.png|900px]]

=== Description du projet ===

Dans ce tutoriel, nous allons réaliser des photos à l'aide de la caméra du RaspBerry Pi 2/3 et envoyer ces clichés par email de manière périodique grâce à NodeRED.
Nous allons donc utiliser plusieurs blocs et décrire de manière détaillée le déroulement de chaque étape de la réalisation de ce projet.

Dans NodeRED, il est important de bien identifier la finalité de notre projet afin de connaître au préalable tous les éléments qu'il faudra créer et fournir à l'action finale (celle qui enverra un email).

=== Quels sont les besoins du noeud email ===

==== Composants nécessaires pour constituer un email ====

Un email est composé des éléments suivants:

* Un expéditeur
* Un destinataire
* Un sujet
* Le corps du message

Tous ces éléments vont donc devoir être préparés afin de pouvoir construire le message à envoyer par le noeud final.

Le noeud final aura aussi besoin d'un serveur SMTP (serveur d'envoi d'emails) et éventuellement de paramètres d'identification pour ce serveur d'envoi d'emails.

==== Détail des besoins du noeud email ====

La liste des éléments nécessaires s'affiche lorsque le bloc est dans la zone de travail (Schema).
Commençons donc par sélectionner le bloc email, et de le glisser dans la zone de travail.

Commençons par cliquer sur le bloc email et nous maintenons le clic pour le glisser à droite dans l'espace de travail.

(on choisit celui qui a son point de liaison à gauche, car nous voulons un bloc de sortie)

[[fichier:Rasp-Node-Red-picam-mail-36.png]]

Glissons le dans l'espace de travail, et cliquons un clic simple pour le sélectionner.

[[fichier:Rasp-Node-Red-picam-mail-37.png]]

Ensuite, dans la colonne à droite de cet espace de travail, nous cliquons sur info et nous pourrons découvrir les éléments nécessaires à la constitution d'un bloc email.

[[fichier:Rasp-Node-Red-picam-mail-38.png]]

===== Nous utiliserons les champs suivants =====

* '''msg.payload''' --> Ce champ contient le corps de l'email
* '''msg.topic''' --> Ce champ contient le sujet de l'email
* '''msg.from''' --> Ce champ contient l'email de l'expéditeur
* '''msg.to''' --> Ce champ contient l'email du destinataire

Les autres champs ne seront pas utilisés dans notre cas, mais vous pourrez constater que le bloc email est complet de part ses fonctionnalités et possibilités.

Les données de serveur et d'identification seront abordées en fin de tuto lors de la configuration finale du bloc.

Nous allons maintenant passer à la réalisation du flux en commençant par le début de celui-ci.

=== Création d'une action périodique ===

Dans la colonne de gauche de NodeRED, se trouvent une liste de blocs à utiliser pour réaliser vos projets. Ils sont classés par "types".

Ainsi nous retrouvons les "types" suivants:

* Input qui contient tous les blocs d'entrées
* Ouput qui contient tous les blocs de sortie
* Function qui contient des blocs de fonctions javascript etc...
* Social qui sont des blocs d'entrée ou sorties depuis ou vers les réseaux sociaux
* Storage qui sont des fonctions de lecture ou d'écriture de fichiers
* Analysis ->> Sentiment interprète du texte et détermine un score sur base d'un dictionnaire anglais, renvoie le texte avec ce score de -5 à +5, déterminant ainsi l'émotion susceptible d'être procuré par ce texte
* Advanced possède des outils permettant de détecter des changements dans des fichiers ou dossiers, de lire des flux RSS ou encore EXEC qui permet d'exécuter directement des commandes sous linux !
* Raspberry Pi contient des outils pour piloter/lire le GPIO du raspberry Pi
* Network qui contient un outil réseau de Ping

Nous allons créer une action périodique, c'est à dire paramétrer un bloc "INJECT" de manière à déclencher régulièrement une chaine d'actions que nous allons accrocher à la suite les unes après les autres.
Nous allons donc cliquer sur le bloc "Inject" dans la liste "Input" et maintenir ce clic pour le déplacer vers la zone de travail.

[[fichier:Rasp-Node-Red-picam-mail-02.png]]

Nous obtiendrons donc une nouvelle instance "inject" qui portera le nom "Timestamp" (ce nom est attribué par défaut par NodeRED) comme dans la capture ci-dessous

[[fichier:Rasp-Node-Red-picam-mail-03.png]]

Nous allons maintenant double-cliquer sur celle-ci fin de l'éditer pour voir apparaitre le menu ci-dessous

[[fichier:Rasp-Node-Red-picam-mail-04.png]]

Il va falloir configurer ce bloc, mais avant tout voici une explication de celui-ci:

==== Payload ====

Le champs PayLoad est en fait le champ de données qui sera suivi d'un noeud à l'autre jusque à la fin de la chaine.
Dans ce module "inject", nous allons donc déterminer quel type de données contiendra le "PayLoad" jusqu'à la fin de la chaine que l'on va réaliser.

Dans notre cas, nous souhaitons construire un email, donc du contenu textuel, nous allons donc choisir "String" ce qui correspond à une chaine de caractères (du texte).

[[fichier:Rasp-Node-Red-picam-mail-05.png]]

==== Topic ====

Le champs "Topic" est un champs de texte dans lequel nous allons mettre un sujet succinct décrivant notre chaine.
Dans notre cas, ce sujet fera office de sujet au mail que nous expédierons.
Nous allons donc être précis en un minimum de mots pour que le destinataire de l'email puisse facilement deviner le contenu de celui-ci.

[[fichier:Rasp-Node-Red-picam-mail-06.png]]

==== Repeat ====

Nous allons ensuite choisir l'intervalle de déclenchement de notre action, sachant que nous avons le choix entre:

* none : pas de déclenchement périodique programmé
* interval : nous fixons un temps de déclenchement à partir du lancement du programme, l'action se réalisera à chaque fois que ce temps sera écoulé de manière répétée jusqu'à l'interruption manuelle du programme
* interval between times : nous fixons ici le déclenchement par interval, mais nous fixons aussi une fourchette d'heures et des jours pendant lesquels nous exécutons cet interval
* at a specific time : nous fixons une heure d'exécution, et un ou plusieurs jours d'exécution. Dans ce cas l'action n'est pas répétée en continu mais éxécutée une seule fois par jour à l'heure programmée

Dans notre exemple, nous allons fixer un intervalle de 15 secondes pour commencer. Nous pourrons ensuite augmenter cette valeur pour éviter de recevoir trop d'emails avec des photos :D

[[fichier:Rasp-Node-Red-picam-mail-07.png]]

La case "inject once at start" permet de ne pas attendre le premier cycle avant d'exécuter une première fois l'action. Elle se lancera dès le lancement du programme, puis périodiquement selon les cycles déterminés par l'intervalle.

[[fichier:Rasp-Node-Red-picam-mail-08.png]]

==== Name ====

Le champs Name va déterminer le nom que portera le bloc dans l'espace de travail et dans les logs (si nous créons des blocs de log ensuite pour contrôler des étapes).
Il est important de bien établir ce nom de manière explicite, car le nom des blocs permettra de comprendre et retrouver facilement la logique du schéma construit, même si l'on a pas consulté celui-ci pendant une longue période.

[[fichier:Rasp-Node-Red-picam-mail-09.png]]

=== Capture d'une image depuis la PiCam ===

Nous allons aller à l'essentiel en ce qui concerne la capture photo en utilisant une commande simple pour prendre un cliché et renvoyer celui-ci dans le flux NodeRED grâce à un bloc permettant d'exécuter des commandes bash.

{{ambox | text = Vous trouverez un TUTO détaillé sur la PiCam vous permettant de prendre la main, ou de la paramétrer si vous n'avez pas encore utilisé celle-ci auparavant: ....___TUTO___...}}

Nous allons tout d'abord cliquer sur le bloc "Exec" dans la section "Advanced" de la colonne de gauche et glisser l'élément dans la zone de travail.

[[fichier:Rasp-Node-Red-picam-mail-10.png]]

Ensuite, cliquer sur le bloc nouvellement créé et configurer celui-ci.

[[fichier:Rasp-Node-Red-picam-mail-11.png]]

Le menu suivant s'affichera, et nous pourrons configurer le bloc "Exec" nouvellement créé.

==== Command ====

Nous allons y ajouter la commande à exécuter pour prendre une photo avec la caméra du Raspberry Pi et la stocker dans un fichier jpg dans le dossier /tmp/ de linux.

<syntaxhighlight lang="python">
raspistill -o /tmp/cam.jpg -w 640 -h 480
</syntaxhighlight>

Nous prenons soin de limiter la hauteur et la largeur de l'image afin de réduire son poids pour l'envoi par email.

[[fichier:Rasp-Node-Red-picam-mail-12.png]]

==== +Append ====

Ensuite, nous allons décocher la case "msg.payload" si elle est cochée par défaut.

[[fichier:Rasp-Node-Red-picam-mail-13.png]]

==== Extra input parameters et Timeout ====

Nous n'aurons pas besoin de compléter ces champs pour notre projet.

Si vous cochez le champ "Use spawn() instead of exec()?", votre commande sera réalisée sous forme d'un processus résident et continuera de s'exécuter jusqu'à ce qu'elle se termine par elle-même (sauf si elle ne se termine jamais).
Cette solution implique que le programme n'attendra pas que cette commande soit réalisée pour passer aux étapes suivantes.
Si la suite de l'exécution de votre flux est susceptible d'utiliser le résultat de cette commande, nous vous déconseillons d'utiliser cette option sous peine de provoquer des erreurs à la suite du traitement du flux.

Le champ "Timeout" permet de définir un temps d'attente maximum avant de mettre un terme à l'exécution de la commande.
Cela permet de débloquer la situation si la commande exécutée prends un temps anormalement long à s'exécuter.

==== Name ====

Nous allons ensuite compléter le champs nom, celui-ci sera utilisé pour nommer le bloc dans le "schéma", mais aussi de nommer les logs comme pour le bloc "Exec".

[[fichier:Rasp-Node-Red-picam-mail-14.png]]

=== Encodage de l'image en base64 ===

Nous allons convertir la photo prise juste avant en utilisant une commande de conversion en base64.
Cela facilitera son injection dans un template HTML que nous allons créer ensuite pour construire un email.

Nous allons tout d'abord cliquer sur le bloc "Exec" dans la section "Advanced" de la colonne de gauche et glisser l'élément dans la zone de travail.

[[fichier:Rasp-Node-Red-picam-mail-10.png]]

Ensuite, cliquer sur le bloc nouvellement créé et configurer celui-ci.

[[fichier:Rasp-Node-Red-picam-mail-11.png]]

Le menu suivant s'affichera, et nous pourrons configurer le bloc "Exec" nouvellement créé.

[[fichier:Rasp-Node-Red-picam-mail-15.png]]

==== Command ====

Nous allons y ajouter la commande à exécuter pour encoder en base 64 la photo prise précédemment avec la caméra du Raspberry Pi.

<syntaxhighlight lang="python">
base64 -i "/tmp/cam.jpg"
</syntaxhighlight>

[[fichier:Rasp-Node-Red-picam-mail-16.png]]

==== +Append ====

Ensuite, nous allons cocher la case "msg.payload" si elle n'est pas cochée par défaut pour que le résultat soit directement renvoyé par cette commande dans le "PayLoad" du flux.

[[fichier:Rasp-Node-Red-picam-mail-17.png]]

==== Extra input parameters et Timeout ====

Nous n'aurons pas besoin de compléter ces champs pour notre projet.

Si vous cochez le champ "Use spawn() instead of exec()?", votre commande sera réalisée sous forme d'un processus résident et continuera de s'exécuter jusqu'à ce qu'elle se termine par elle-même (sauf si elle ne se termine jamais).
Cette solution implique que le programme n'attendra pas que cette commande soit réalisée pour passer aux étapes suivantes.
Si la suite de l'exécution de votre flux est susceptible d'utiliser le résultat de cette commande, nous vous déconseillons d'utiliser cette option sous peine de provoquer des erreurs à la suite du traitement du flux.

[[fichier:Rasp-Node-Red-picam-mail-18.png]]

Le champ "Timeout" permet de définir un temps d'attente maximum avant de mettre un terme à l'exécution de la commande.
Cela permet de débloquer la situation si la commande exécutée prends un temps anormalement long à s'exécuter.

[[fichier:Rasp-Node-Red-picam-mail-19.png]]

==== Name ====

Nous allons ensuite compléter le champs nom, celui-ci sera utilisé pour nommer le bloc dans le "schéma", mais aussi de nommer les logs comme pour le bloc "Exec".

[[fichier:Rasp-Node-Red-picam-mail-20.png]]

=== Création d'un email au format HTML ===

Nous allons maintenant créer un template d'email au format HTML afin de mettre en forme le message que nous enverrons ensuite.
Nous allons pour cela utiliser un bloc "Template".

[[fichier:Rasp-Node-Red-picam-mail-21.png]]

==== Name ====

Nous allons attribuer un nom au bloc afin de l'identifier plus facilement dans le flux.
Nous allons donc le nommer "Contenu du mail" puisque nous créons le contenu du mail que nous enverrons ensuite.

[[fichier:Rasp-Node-Red-picam-mail-22.png]]

==== Set property ====

La propriété que nous souhaitons créer dans le flux est le "PayLoad".
Ce PayLoad existe déjà, il contient pour le moment l'image au format "Base64" précédemment encodé.
Cela n'est pas un problème, après notre noeud (notre bloc), le PayLoad sera intégralement remplacé par le template que nous sommes en train de créer.

[[fichier:Rasp-Node-Red-picam-mail-23.png]]

==== Template ====

Dans ce template, nous allons créer une structure HTML de base minimum afin que la structure soit interprétée par la majorité des clients/webmail.
Vous pouvez la personnaliser à votre guise si vous avez les connaissances en HTML.

Voici la structure de base pour notre projet:

<syntaxhighlight lang="html">
<html>
<head>
<meta charset="utf8"/>
</head>
<body>
<h1>Projet Photo par email</h1>
<img src="data:image/jpg;base64,{{payload}}"/>
</body>
</html>
</syntaxhighlight>

Vous pourrez remarquer que nous intégrons l'image en appelant le PayLoad à 'intérieur du code HTML dans la balise <img>.
C'est le PayLoad créé précédemment par le bloc "Exec" qui est récupéré à ce moment précis.
Ce PayLoad est remplacé dans le flux par le PayLoad complet avec notre template dans le flux par notre bloc Template.

[[fichier:Rasp-Node-Red-picam-mail-24.png]]

=== Création d'un bloc (noeud) "Debug" ===

Nous allons ajouter la notion d'expéditeur dans le flux que nous avons créé à travers nos blocs (noeuds).
Pour rappel, actuellement nous avons deux propriétés avec des données dans notre flux.
Si nous voulons observer ce que nous avons créé jusque là, nous pouvons faire appel à un bloc "Debug".

==== Création du bloc "Debug" ====

Comme pour les blocs précédents, nous allons glisser/déposer un bloc débug dans l'espace de travail.

[[fichier:Rasp-Node-Red-picam-mail-25.png]]

Celui-ci s'appelle msg/payload par défaut

[[fichier:Rasp-Node-Red-picam-mail-26.png]]

Nous allons double-cliquer sur ce bloc pour le configurer.

[[fichier:Rasp-Node-Red-picam-mail-27.png]]

==== Output ====

Dans ce champs, nous allons choisir la partie du flux que nous souhaitons afficher, ou nous allons sélectionner le flux entier.

[[fichier:Rasp-Node-Red-picam-mail-28.png]]

Sélectionner le flux entier, nous affichera le flux complet incluant toutes ses propriétés.

[[fichier:Rasp-Node-Red-picam-mail-29.png]]

==== To =====

La propriété "To" nous permet de choisir ou nous souhaitons afficher les données que nous récupérons.
Soit nous les affichons uniquement dans l'onglet "Debug" à droite de l'espace de travail, soit nous l'affichons dans cet onglet mais aussi dans la console de NodeJS.
Dans notre cas, nous allons nous contenter d'afficher nos éléments dans l'onglet de "Debug" à droite de notre espace de travail.

[[fichier:Rasp-Node-Red-picam-mail-30.png]]

==== Name ====

Le champs Name nous servira à identifier quel bloc de "Debug" affiche les données en console ou dans l'onglet "Debug".
Il faut donc le nommer efficacement pour bien attacher et comprendre les données que nous récupérons, surtout si nous en plaçons plusieurs dans le flux.

[[fichier:Rasp-Node-Red-picam-mail-31.png]]

==== Exploitation et compréhension des données récupérées ====

Nous avons placé notre bloc "Debug" à la suite du flux en dernière position.

[[fichier:Rasp-Node-Red-picam-mail-32.png]]

Nous allons donc déployer le programme en cliquant sur "Deploy" en haut à droite de la page.

[[fichier:Rasp-Node-Red-picam-mail-33.png]]

Ensuite, nous allons exécuter manuellement le programme en cliquant sur le bouton se trouvant en début de chaîne:

[[fichier:Rasp-Node-Red-picam-mail-34.png]]

Nous allons ensuite afficher l'onglet "Debug" sur le coté droit de la page et analyser les données récupérées:

[[fichier:Rasp-Node-Red-picam-mail-35.png]]

==== Analyse des données récupérées dans l'onglet "Debug" ====

<syntaxhighlight lang="bash">
08/05/2017 à 12:54:31 node: FORMATAGE
MCHobby - Photo bureau : msg : Object
object
_msgid: "81efe35c.3208d"
topic: "MCHobby - Photo bureau"
payload: "<html>↵ <head>↵ <meta charset="utf8"/>↵ ↵ </head>↵ <body>↵ <h1>MCHobby - Photo bureau</h1>↵ <p>Cette photo est un instantané pris dans les bureaux de MCHobby.</p>↵
<img src="data:image/jpg;base64,/9j/4WP6x2.../>"
</syntaxhighlight>

Comme vous pourrez le constater, chaque élément du noeud est détaillé.
Les données sont cependant tronquées, le noeud "Debug" ne nous fourni pas la totalité du "PayLoad" mais nous avons déjà un bon aperçu des données qu'il contient.

_msgid: est un Id unique de message
topic: est le sujet du mail, nous l'avons déterminé dans le premier bloc
payload: contient les données du message formatées par le template que nous avons créé et complété par l'image en base64.

Les noeuds "Debug" sont pratiques. Ils nous permettent d'afficher une partie ou la totalité du flux tel qu'il est à l'endroit ou ils sont placés.

Cela peut permettre d'identifier et de résoudre plus facilement des problèmes dans des opérations plus complexes et dans notre cas, cela nous permet de mieux comprendre comment fonctionne le noeud et comment les données sont transmises d'un bloc à l'autre.

=== Création d'un expéditeur ===

Nous avons construit petit à petit un message avec un sujet, mais il manque encore un détail: l'expéditeur de l'email que nous allons envoyer.

Si vous avez bien suivi les étapes précédentes du tuto, jusqu'au noeud "Debug" et à son résultat, vous comprendrez facilement la démarche ci après pour ajouter un expéditeur dans le flux.

{{Rasp-Node-Red-TRAILER}}

Rasp-Node-Red-picam-mail

2017-05-08T12:56:23Z

AntoineWrt : /* Nous utiliserons les champs suivants */

{{Rasp-Node-Red-NAV}}

{{traduction}}

== PiCamRED - Envoi périodique de photos par email avec PiCam et NodeRED ==

[[fichier:Rasp-Node-Red-picam-mail-01.png|900px]]

=== Description du projet ===

Dans ce tutoriel, nous allons réaliser des photos à l'aide de la caméra du RaspBerry Pi 2/3 et envoyer ces clichés par email de manière périodique grâce à NodeRED.
Nous allons donc utiliser plusieurs blocs et décrire de manière détaillée le déroulement de chaque étape de la réalisation de ce projet.

Dans NodeRED, il est important de bien identifier la finalité de notre projet afin de connaître au préalable tous les éléments qu'il faudra créer et fournir à l'action finale (celle qui enverra un email).

=== Quels sont les besoins du noeud email ===

==== Composants nécessaires pour constituer un email ====

Un email est composé des éléments suivants:

* Un expéditeur
* Un destinataire
* Un sujet
* Le corps du message

Tous ces éléments vont donc devoir être préparés afin de pouvoir construire le message à envoyer par le noeud final.

Le noeud final aura aussi besoin d'un serveur SMTP (serveur d'envoi d'emails) et éventuellement de paramètres d'identification pour ce serveur d'envoi d'emails.

==== Détail des besoins du noeud email ====

La liste des éléments nécessaires s'affiche lorsque le bloc est dans la zone de travail (Schema).
Commençons donc par sélectionner le bloc email, et de le glisser dans la zone de travail.

Commençons par cliquer sur le bloc email et nous maintenons le clic pour le glisser à droite dans l'espace de travail.

(on choisit celui qui a son point de liaison à gauche, car nous voulons un bloc de sortie)

[[fichier:Rasp-Node-Red-picam-mail-36.png]]

Glissons le dans l'espace de travail, et cliquons un clic simple pour le sélectionner.

[[fichier:Rasp-Node-Red-picam-mail-37.png]]

Ensuite, dans la colonne à droite de cet espace de travail, nous cliquons sur info et nous pourrons découvrir les éléments nécessaires à la constitution d'un bloc email.

[[fichier:Rasp-Node-Red-picam-mail-38.png]]

===== Nous utiliserons les champs suivants =====

* '''msg.payload''' --> Ce champ contient le corps de l'email
* '''msg.topic''' --> Ce champ contient le sujet de l'email
* '''msg.from''' --> Ce champ contient l'email de l'expéditeur
* '''msg.to''' --> Ce champ contient l'email du destinataire

=== Création d'une action périodique ===

Dans la colonne de gauche de NodeRED, se trouvent une liste de blocs à utiliser pour réaliser vos projets. Ils sont classés par "types".

Ainsi nous retrouvons les "types" suivants:

* Input qui contient tous les blocs d'entrées
* Ouput qui contient tous les blocs de sortie
* Function qui contient des blocs de fonctions javascript etc...
* Social qui sont des blocs d'entrée ou sorties depuis ou vers les réseaux sociaux
* Storage qui sont des fonctions de lecture ou d'écriture de fichiers
* Analysis ->> Sentiment interprète du texte et détermine un score sur base d'un dictionnaire anglais, renvoie le texte avec ce score de -5 à +5, déterminant ainsi l'émotion susceptible d'être procuré par ce texte
* Advanced possède des outils permettant de détecter des changements dans des fichiers ou dossiers, de lire des flux RSS ou encore EXEC qui permet d'exécuter directement des commandes sous linux !
* Raspberry Pi contient des outils pour piloter/lire le GPIO du raspberry Pi
* Network qui contient un outil réseau de Ping

Nous allons créer une action périodique, c'est à dire paramétrer un bloc "INJECT" de manière à déclencher régulièrement une chaine d'actions que nous allons accrocher à la suite les unes après les autres.
Nous allons donc cliquer sur le bloc "Inject" dans la liste "Input" et maintenir ce clic pour le déplacer vers la zone de travail.

[[fichier:Rasp-Node-Red-picam-mail-02.png]]

Nous obtiendrons donc une nouvelle instance "inject" qui portera le nom "Timestamp" (ce nom est attribué par défaut par NodeRED) comme dans la capture ci-dessous

[[fichier:Rasp-Node-Red-picam-mail-03.png]]

Nous allons maintenant double-cliquer sur celle-ci fin de l'éditer pour voir apparaitre le menu ci-dessous

[[fichier:Rasp-Node-Red-picam-mail-04.png]]

Il va falloir configurer ce bloc, mais avant tout voici une explication de celui-ci:

==== Payload ====

Le champs PayLoad est en fait le champ de données qui sera suivi d'un noeud à l'autre jusque à la fin de la chaine.
Dans ce module "inject", nous allons donc déterminer quel type de données contiendra le "PayLoad" jusqu'à la fin de la chaine que l'on va réaliser.

Dans notre cas, nous souhaitons construire un email, donc du contenu textuel, nous allons donc choisir "String" ce qui correspond à une chaine de caractères (du texte).

[[fichier:Rasp-Node-Red-picam-mail-05.png]]

==== Topic ====

Le champs "Topic" est un champs de texte dans lequel nous allons mettre un sujet succinct décrivant notre chaine.
Dans notre cas, ce sujet fera office de sujet au mail que nous expédierons.
Nous allons donc être précis en un minimum de mots pour que le destinataire de l'email puisse facilement deviner le contenu de celui-ci.

[[fichier:Rasp-Node-Red-picam-mail-06.png]]

==== Repeat ====

Nous allons ensuite choisir l'intervalle de déclenchement de notre action, sachant que nous avons le choix entre:

* none : pas de déclenchement périodique programmé
* interval : nous fixons un temps de déclenchement à partir du lancement du programme, l'action se réalisera à chaque fois que ce temps sera écoulé de manière répétée jusqu'à l'interruption manuelle du programme
* interval between times : nous fixons ici le déclenchement par interval, mais nous fixons aussi une fourchette d'heures et des jours pendant lesquels nous exécutons cet interval
* at a specific time : nous fixons une heure d'exécution, et un ou plusieurs jours d'exécution. Dans ce cas l'action n'est pas répétée en continu mais éxécutée une seule fois par jour à l'heure programmée

Dans notre exemple, nous allons fixer un intervalle de 15 secondes pour commencer. Nous pourrons ensuite augmenter cette valeur pour éviter de recevoir trop d'emails avec des photos :D

[[fichier:Rasp-Node-Red-picam-mail-07.png]]

La case "inject once at start" permet de ne pas attendre le premier cycle avant d'exécuter une première fois l'action. Elle se lancera dès le lancement du programme, puis périodiquement selon les cycles déterminés par l'intervalle.

[[fichier:Rasp-Node-Red-picam-mail-08.png]]

==== Name ====

Le champs Name va déterminer le nom que portera le bloc dans l'espace de travail et dans les logs (si nous créons des blocs de log ensuite pour contrôler des étapes).
Il est important de bien établir ce nom de manière explicite, car le nom des blocs permettra de comprendre et retrouver facilement la logique du schéma construit, même si l'on a pas consulté celui-ci pendant une longue période.

[[fichier:Rasp-Node-Red-picam-mail-09.png]]

=== Capture d'une image depuis la PiCam ===

Nous allons aller à l'essentiel en ce qui concerne la capture photo en utilisant une commande simple pour prendre un cliché et renvoyer celui-ci dans le flux NodeRED grâce à un bloc permettant d'exécuter des commandes bash.

{{ambox | text = Vous trouverez un TUTO détaillé sur la PiCam vous permettant de prendre la main, ou de la paramétrer si vous n'avez pas encore utilisé celle-ci auparavant: ....___TUTO___...}}

Nous allons tout d'abord cliquer sur le bloc "Exec" dans la section "Advanced" de la colonne de gauche et glisser l'élément dans la zone de travail.

[[fichier:Rasp-Node-Red-picam-mail-10.png]]

Ensuite, cliquer sur le bloc nouvellement créé et configurer celui-ci.

[[fichier:Rasp-Node-Red-picam-mail-11.png]]

Le menu suivant s'affichera, et nous pourrons configurer le bloc "Exec" nouvellement créé.

==== Command ====

Nous allons y ajouter la commande à exécuter pour prendre une photo avec la caméra du Raspberry Pi et la stocker dans un fichier jpg dans le dossier /tmp/ de linux.

<syntaxhighlight lang="python">
raspistill -o /tmp/cam.jpg -w 640 -h 480
</syntaxhighlight>

Nous prenons soin de limiter la hauteur et la largeur de l'image afin de réduire son poids pour l'envoi par email.

[[fichier:Rasp-Node-Red-picam-mail-12.png]]

==== +Append ====

Ensuite, nous allons décocher la case "msg.payload" si elle est cochée par défaut.

[[fichier:Rasp-Node-Red-picam-mail-13.png]]

==== Extra input parameters et Timeout ====

Nous n'aurons pas besoin de compléter ces champs pour notre projet.

Si vous cochez le champ "Use spawn() instead of exec()?", votre commande sera réalisée sous forme d'un processus résident et continuera de s'exécuter jusqu'à ce qu'elle se termine par elle-même (sauf si elle ne se termine jamais).
Cette solution implique que le programme n'attendra pas que cette commande soit réalisée pour passer aux étapes suivantes.
Si la suite de l'exécution de votre flux est susceptible d'utiliser le résultat de cette commande, nous vous déconseillons d'utiliser cette option sous peine de provoquer des erreurs à la suite du traitement du flux.

Le champ "Timeout" permet de définir un temps d'attente maximum avant de mettre un terme à l'exécution de la commande.
Cela permet de débloquer la situation si la commande exécutée prends un temps anormalement long à s'exécuter.

==== Name ====

Nous allons ensuite compléter le champs nom, celui-ci sera utilisé pour nommer le bloc dans le "schéma", mais aussi de nommer les logs comme pour le bloc "Exec".

[[fichier:Rasp-Node-Red-picam-mail-14.png]]

=== Encodage de l'image en base64 ===

Nous allons convertir la photo prise juste avant en utilisant une commande de conversion en base64.
Cela facilitera son injection dans un template HTML que nous allons créer ensuite pour construire un email.

Nous allons tout d'abord cliquer sur le bloc "Exec" dans la section "Advanced" de la colonne de gauche et glisser l'élément dans la zone de travail.

[[fichier:Rasp-Node-Red-picam-mail-10.png]]

Ensuite, cliquer sur le bloc nouvellement créé et configurer celui-ci.

[[fichier:Rasp-Node-Red-picam-mail-11.png]]

Le menu suivant s'affichera, et nous pourrons configurer le bloc "Exec" nouvellement créé.

[[fichier:Rasp-Node-Red-picam-mail-15.png]]

==== Command ====

Nous allons y ajouter la commande à exécuter pour encoder en base 64 la photo prise précédemment avec la caméra du Raspberry Pi.

<syntaxhighlight lang="python">
base64 -i "/tmp/cam.jpg"
</syntaxhighlight>

[[fichier:Rasp-Node-Red-picam-mail-16.png]]

==== +Append ====

Ensuite, nous allons cocher la case "msg.payload" si elle n'est pas cochée par défaut pour que le résultat soit directement renvoyé par cette commande dans le "PayLoad" du flux.

[[fichier:Rasp-Node-Red-picam-mail-17.png]]

==== Extra input parameters et Timeout ====

Nous n'aurons pas besoin de compléter ces champs pour notre projet.

Si vous cochez le champ "Use spawn() instead of exec()?", votre commande sera réalisée sous forme d'un processus résident et continuera de s'exécuter jusqu'à ce qu'elle se termine par elle-même (sauf si elle ne se termine jamais).
Cette solution implique que le programme n'attendra pas que cette commande soit réalisée pour passer aux étapes suivantes.
Si la suite de l'exécution de votre flux est susceptible d'utiliser le résultat de cette commande, nous vous déconseillons d'utiliser cette option sous peine de provoquer des erreurs à la suite du traitement du flux.

[[fichier:Rasp-Node-Red-picam-mail-18.png]]

Le champ "Timeout" permet de définir un temps d'attente maximum avant de mettre un terme à l'exécution de la commande.
Cela permet de débloquer la situation si la commande exécutée prends un temps anormalement long à s'exécuter.

[[fichier:Rasp-Node-Red-picam-mail-19.png]]

==== Name ====

Nous allons ensuite compléter le champs nom, celui-ci sera utilisé pour nommer le bloc dans le "schéma", mais aussi de nommer les logs comme pour le bloc "Exec".

[[fichier:Rasp-Node-Red-picam-mail-20.png]]

=== Création d'un email au format HTML ===

Nous allons maintenant créer un template d'email au format HTML afin de mettre en forme le message que nous enverrons ensuite.
Nous allons pour cela utiliser un bloc "Template".

[[fichier:Rasp-Node-Red-picam-mail-21.png]]

==== Name ====

Nous allons attribuer un nom au bloc afin de l'identifier plus facilement dans le flux.
Nous allons donc le nommer "Contenu du mail" puisque nous créons le contenu du mail que nous enverrons ensuite.

[[fichier:Rasp-Node-Red-picam-mail-22.png]]

==== Set property ====

La propriété que nous souhaitons créer dans le flux est le "PayLoad".
Ce PayLoad existe déjà, il contient pour le moment l'image au format "Base64" précédemment encodé.
Cela n'est pas un problème, après notre noeud (notre bloc), le PayLoad sera intégralement remplacé par le template que nous sommes en train de créer.

[[fichier:Rasp-Node-Red-picam-mail-23.png]]

==== Template ====

Dans ce template, nous allons créer une structure HTML de base minimum afin que la structure soit interprétée par la majorité des clients/webmail.
Vous pouvez la personnaliser à votre guise si vous avez les connaissances en HTML.

Voici la structure de base pour notre projet:

<syntaxhighlight lang="html">
<html>
<head>
<meta charset="utf8"/>
</head>
<body>
<h1>Projet Photo par email</h1>
<img src="data:image/jpg;base64,{{payload}}"/>
</body>
</html>
</syntaxhighlight>

Vous pourrez remarquer que nous intégrons l'image en appelant le PayLoad à 'intérieur du code HTML dans la balise <img>.
C'est le PayLoad créé précédemment par le bloc "Exec" qui est récupéré à ce moment précis.
Ce PayLoad est remplacé dans le flux par le PayLoad complet avec notre template dans le flux par notre bloc Template.

[[fichier:Rasp-Node-Red-picam-mail-24.png]]

=== Création d'un bloc (noeud) "Debug" ===

Nous allons ajouter la notion d'expéditeur dans le flux que nous avons créé à travers nos blocs (noeuds).
Pour rappel, actuellement nous avons deux propriétés avec des données dans notre flux.
Si nous voulons observer ce que nous avons créé jusque là, nous pouvons faire appel à un bloc "Debug".

==== Création du bloc "Debug" ====

Comme pour les blocs précédents, nous allons glisser/déposer un bloc débug dans l'espace de travail.

[[fichier:Rasp-Node-Red-picam-mail-25.png]]

Celui-ci s'appelle msg/payload par défaut

[[fichier:Rasp-Node-Red-picam-mail-26.png]]

Nous allons double-cliquer sur ce bloc pour le configurer.

[[fichier:Rasp-Node-Red-picam-mail-27.png]]

==== Output ====

Dans ce champs, nous allons choisir la partie du flux que nous souhaitons afficher, ou nous allons sélectionner le flux entier.

[[fichier:Rasp-Node-Red-picam-mail-28.png]]

Sélectionner le flux entier, nous affichera le flux complet incluant toutes ses propriétés.

[[fichier:Rasp-Node-Red-picam-mail-29.png]]

==== To =====

La propriété "To" nous permet de choisir ou nous souhaitons afficher les données que nous récupérons.
Soit nous les affichons uniquement dans l'onglet "Debug" à droite de l'espace de travail, soit nous l'affichons dans cet onglet mais aussi dans la console de NodeJS.
Dans notre cas, nous allons nous contenter d'afficher nos éléments dans l'onglet de "Debug" à droite de notre espace de travail.

[[fichier:Rasp-Node-Red-picam-mail-30.png]]

==== Name ====

Le champs Name nous servira à identifier quel bloc de "Debug" affiche les données en console ou dans l'onglet "Debug".
Il faut donc le nommer efficacement pour bien attacher et comprendre les données que nous récupérons, surtout si nous en plaçons plusieurs dans le flux.

[[fichier:Rasp-Node-Red-picam-mail-31.png]]

==== Exploitation et compréhension des données récupérées ====

Nous avons placé notre bloc "Debug" à la suite du flux en dernière position.

[[fichier:Rasp-Node-Red-picam-mail-32.png]]

Nous allons donc déployer le programme en cliquant sur "Deploy" en haut à droite de la page.

[[fichier:Rasp-Node-Red-picam-mail-33.png]]

Ensuite, nous allons exécuter manuellement le programme en cliquant sur le bouton se trouvant en début de chaîne:

[[fichier:Rasp-Node-Red-picam-mail-34.png]]

Nous allons ensuite afficher l'onglet "Debug" sur le coté droit de la page et analyser les données récupérées:

[[fichier:Rasp-Node-Red-picam-mail-35.png]]

==== Analyse des données récupérées dans l'onglet "Debug" ====

<syntaxhighlight lang="bash">
08/05/2017 à 12:54:31 node: FORMATAGE
MCHobby - Photo bureau : msg : Object
object
_msgid: "81efe35c.3208d"
topic: "MCHobby - Photo bureau"
payload: "<html>↵ <head>↵ <meta charset="utf8"/>↵ ↵ </head>↵ <body>↵ <h1>MCHobby - Photo bureau</h1>↵ <p>Cette photo est un instantané pris dans les bureaux de MCHobby.</p>↵
<img src="data:image/jpg;base64,/9j/4WP6x2.../>"
</syntaxhighlight>

Comme vous pourrez le constater, chaque élément du noeud est détaillé.
Les données sont cependant tronquées, le noeud "Debug" ne nous fourni pas la totalité du "PayLoad" mais nous avons déjà un bon aperçu des données qu'il contient.

_msgid: est un Id unique de message
topic: est le sujet du mail, nous l'avons déterminé dans le premier bloc
payload: contient les données du message formatées par le template que nous avons créé et complété par l'image en base64.

Les noeuds "Debug" sont pratiques. Ils nous permettent d'afficher une partie ou la totalité du flux tel qu'il est à l'endroit ou ils sont placés.

Cela peut permettre d'identifier et de résoudre plus facilement des problèmes dans des opérations plus complexes et dans notre cas, cela nous permet de mieux comprendre comment fonctionne le noeud et comment les données sont transmises d'un bloc à l'autre.

=== Création d'un expéditeur ===

Nous avons construit petit à petit un message avec un sujet, mais il manque encore un détail: l'expéditeur de l'email que nous allons envoyer.

Si vous avez bien suivi les étapes précédentes du tuto, jusqu'au noeud "Debug" et à son résultat, vous comprendrez facilement la démarche ci après pour ajouter un expéditeur dans le flux.

{{Rasp-Node-Red-TRAILER}}

Rasp-Node-Red-picam-mail

2017-05-08T12:55:56Z

AntoineWrt : /* Nous utiliserons les champs suivants */

{{Rasp-Node-Red-NAV}}

{{traduction}}

== PiCamRED - Envoi périodique de photos par email avec PiCam et NodeRED ==

[[fichier:Rasp-Node-Red-picam-mail-01.png|900px]]

=== Description du projet ===

Dans ce tutoriel, nous allons réaliser des photos à l'aide de la caméra du RaspBerry Pi 2/3 et envoyer ces clichés par email de manière périodique grâce à NodeRED.
Nous allons donc utiliser plusieurs blocs et décrire de manière détaillée le déroulement de chaque étape de la réalisation de ce projet.

Dans NodeRED, il est important de bien identifier la finalité de notre projet afin de connaître au préalable tous les éléments qu'il faudra créer et fournir à l'action finale (celle qui enverra un email).

=== Quels sont les besoins du noeud email ===

==== Composants nécessaires pour constituer un email ====

Un email est composé des éléments suivants:

* Un expéditeur
* Un destinataire
* Un sujet
* Le corps du message

Tous ces éléments vont donc devoir être préparés afin de pouvoir construire le message à envoyer par le noeud final.

Le noeud final aura aussi besoin d'un serveur SMTP (serveur d'envoi d'emails) et éventuellement de paramètres d'identification pour ce serveur d'envoi d'emails.

==== Détail des besoins du noeud email ====

La liste des éléments nécessaires s'affiche lorsque le bloc est dans la zone de travail (Schema).
Commençons donc par sélectionner le bloc email, et de le glisser dans la zone de travail.

Commençons par cliquer sur le bloc email et nous maintenons le clic pour le glisser à droite dans l'espace de travail.

(on choisit celui qui a son point de liaison à gauche, car nous voulons un bloc de sortie)

[[fichier:Rasp-Node-Red-picam-mail-36.png]]

Glissons le dans l'espace de travail, et cliquons un clic simple pour le sélectionner.

[[fichier:Rasp-Node-Red-picam-mail-37.png]]

Ensuite, dans la colonne à droite de cet espace de travail, nous cliquons sur info et nous pourrons découvrir les éléments nécessaires à la constitution d'un bloc email.

[[fichier:Rasp-Node-Red-picam-mail-38.png]]

===== Nous utiliserons les champs suivants =====

* '''msg.payload''' Ce champ contient le corps de l'email
* '''msg.topic''' Ce champ contient le sujet de l'email
* '''msg.from''' Ce champ contient l'email de l'expéditeur
* '''msg.to''' Ce champ contient l'email du destinataire

=== Création d'une action périodique ===

Dans la colonne de gauche de NodeRED, se trouvent une liste de blocs à utiliser pour réaliser vos projets. Ils sont classés par "types".

Ainsi nous retrouvons les "types" suivants:

* Input qui contient tous les blocs d'entrées
* Ouput qui contient tous les blocs de sortie
* Function qui contient des blocs de fonctions javascript etc...
* Social qui sont des blocs d'entrée ou sorties depuis ou vers les réseaux sociaux
* Storage qui sont des fonctions de lecture ou d'écriture de fichiers
* Analysis ->> Sentiment interprète du texte et détermine un score sur base d'un dictionnaire anglais, renvoie le texte avec ce score de -5 à +5, déterminant ainsi l'émotion susceptible d'être procuré par ce texte
* Advanced possède des outils permettant de détecter des changements dans des fichiers ou dossiers, de lire des flux RSS ou encore EXEC qui permet d'exécuter directement des commandes sous linux !
* Raspberry Pi contient des outils pour piloter/lire le GPIO du raspberry Pi
* Network qui contient un outil réseau de Ping

Nous allons créer une action périodique, c'est à dire paramétrer un bloc "INJECT" de manière à déclencher régulièrement une chaine d'actions que nous allons accrocher à la suite les unes après les autres.
Nous allons donc cliquer sur le bloc "Inject" dans la liste "Input" et maintenir ce clic pour le déplacer vers la zone de travail.

[[fichier:Rasp-Node-Red-picam-mail-02.png]]

Nous obtiendrons donc une nouvelle instance "inject" qui portera le nom "Timestamp" (ce nom est attribué par défaut par NodeRED) comme dans la capture ci-dessous

[[fichier:Rasp-Node-Red-picam-mail-03.png]]

Nous allons maintenant double-cliquer sur celle-ci fin de l'éditer pour voir apparaitre le menu ci-dessous

[[fichier:Rasp-Node-Red-picam-mail-04.png]]

Il va falloir configurer ce bloc, mais avant tout voici une explication de celui-ci:

==== Payload ====

Le champs PayLoad est en fait le champ de données qui sera suivi d'un noeud à l'autre jusque à la fin de la chaine.
Dans ce module "inject", nous allons donc déterminer quel type de données contiendra le "PayLoad" jusqu'à la fin de la chaine que l'on va réaliser.

Dans notre cas, nous souhaitons construire un email, donc du contenu textuel, nous allons donc choisir "String" ce qui correspond à une chaine de caractères (du texte).

[[fichier:Rasp-Node-Red-picam-mail-05.png]]

==== Topic ====

Le champs "Topic" est un champs de texte dans lequel nous allons mettre un sujet succinct décrivant notre chaine.
Dans notre cas, ce sujet fera office de sujet au mail que nous expédierons.
Nous allons donc être précis en un minimum de mots pour que le destinataire de l'email puisse facilement deviner le contenu de celui-ci.

[[fichier:Rasp-Node-Red-picam-mail-06.png]]

==== Repeat ====

Nous allons ensuite choisir l'intervalle de déclenchement de notre action, sachant que nous avons le choix entre:

* none : pas de déclenchement périodique programmé
* interval : nous fixons un temps de déclenchement à partir du lancement du programme, l'action se réalisera à chaque fois que ce temps sera écoulé de manière répétée jusqu'à l'interruption manuelle du programme
* interval between times : nous fixons ici le déclenchement par interval, mais nous fixons aussi une fourchette d'heures et des jours pendant lesquels nous exécutons cet interval
* at a specific time : nous fixons une heure d'exécution, et un ou plusieurs jours d'exécution. Dans ce cas l'action n'est pas répétée en continu mais éxécutée une seule fois par jour à l'heure programmée

Dans notre exemple, nous allons fixer un intervalle de 15 secondes pour commencer. Nous pourrons ensuite augmenter cette valeur pour éviter de recevoir trop d'emails avec des photos :D

[[fichier:Rasp-Node-Red-picam-mail-07.png]]

La case "inject once at start" permet de ne pas attendre le premier cycle avant d'exécuter une première fois l'action. Elle se lancera dès le lancement du programme, puis périodiquement selon les cycles déterminés par l'intervalle.

[[fichier:Rasp-Node-Red-picam-mail-08.png]]

==== Name ====

Le champs Name va déterminer le nom que portera le bloc dans l'espace de travail et dans les logs (si nous créons des blocs de log ensuite pour contrôler des étapes).
Il est important de bien établir ce nom de manière explicite, car le nom des blocs permettra de comprendre et retrouver facilement la logique du schéma construit, même si l'on a pas consulté celui-ci pendant une longue période.

[[fichier:Rasp-Node-Red-picam-mail-09.png]]

=== Capture d'une image depuis la PiCam ===

Nous allons aller à l'essentiel en ce qui concerne la capture photo en utilisant une commande simple pour prendre un cliché et renvoyer celui-ci dans le flux NodeRED grâce à un bloc permettant d'exécuter des commandes bash.

{{ambox | text = Vous trouverez un TUTO détaillé sur la PiCam vous permettant de prendre la main, ou de la paramétrer si vous n'avez pas encore utilisé celle-ci auparavant: ....___TUTO___...}}

Nous allons tout d'abord cliquer sur le bloc "Exec" dans la section "Advanced" de la colonne de gauche et glisser l'élément dans la zone de travail.

[[fichier:Rasp-Node-Red-picam-mail-10.png]]

Ensuite, cliquer sur le bloc nouvellement créé et configurer celui-ci.

[[fichier:Rasp-Node-Red-picam-mail-11.png]]

Le menu suivant s'affichera, et nous pourrons configurer le bloc "Exec" nouvellement créé.

==== Command ====

Nous allons y ajouter la commande à exécuter pour prendre une photo avec la caméra du Raspberry Pi et la stocker dans un fichier jpg dans le dossier /tmp/ de linux.

<syntaxhighlight lang="python">
raspistill -o /tmp/cam.jpg -w 640 -h 480
</syntaxhighlight>

Nous prenons soin de limiter la hauteur et la largeur de l'image afin de réduire son poids pour l'envoi par email.

[[fichier:Rasp-Node-Red-picam-mail-12.png]]

==== +Append ====

Ensuite, nous allons décocher la case "msg.payload" si elle est cochée par défaut.

[[fichier:Rasp-Node-Red-picam-mail-13.png]]

==== Extra input parameters et Timeout ====

Nous n'aurons pas besoin de compléter ces champs pour notre projet.

Si vous cochez le champ "Use spawn() instead of exec()?", votre commande sera réalisée sous forme d'un processus résident et continuera de s'exécuter jusqu'à ce qu'elle se termine par elle-même (sauf si elle ne se termine jamais).
Cette solution implique que le programme n'attendra pas que cette commande soit réalisée pour passer aux étapes suivantes.
Si la suite de l'exécution de votre flux est susceptible d'utiliser le résultat de cette commande, nous vous déconseillons d'utiliser cette option sous peine de provoquer des erreurs à la suite du traitement du flux.

Le champ "Timeout" permet de définir un temps d'attente maximum avant de mettre un terme à l'exécution de la commande.
Cela permet de débloquer la situation si la commande exécutée prends un temps anormalement long à s'exécuter.

==== Name ====

Nous allons ensuite compléter le champs nom, celui-ci sera utilisé pour nommer le bloc dans le "schéma", mais aussi de nommer les logs comme pour le bloc "Exec".

[[fichier:Rasp-Node-Red-picam-mail-14.png]]

=== Encodage de l'image en base64 ===

Nous allons convertir la photo prise juste avant en utilisant une commande de conversion en base64.
Cela facilitera son injection dans un template HTML que nous allons créer ensuite pour construire un email.

Nous allons tout d'abord cliquer sur le bloc "Exec" dans la section "Advanced" de la colonne de gauche et glisser l'élément dans la zone de travail.

[[fichier:Rasp-Node-Red-picam-mail-10.png]]

Ensuite, cliquer sur le bloc nouvellement créé et configurer celui-ci.

[[fichier:Rasp-Node-Red-picam-mail-11.png]]

Le menu suivant s'affichera, et nous pourrons configurer le bloc "Exec" nouvellement créé.

[[fichier:Rasp-Node-Red-picam-mail-15.png]]

==== Command ====

Nous allons y ajouter la commande à exécuter pour encoder en base 64 la photo prise précédemment avec la caméra du Raspberry Pi.

<syntaxhighlight lang="python">
base64 -i "/tmp/cam.jpg"
</syntaxhighlight>

[[fichier:Rasp-Node-Red-picam-mail-16.png]]

==== +Append ====

Ensuite, nous allons cocher la case "msg.payload" si elle n'est pas cochée par défaut pour que le résultat soit directement renvoyé par cette commande dans le "PayLoad" du flux.

[[fichier:Rasp-Node-Red-picam-mail-17.png]]

==== Extra input parameters et Timeout ====

Nous n'aurons pas besoin de compléter ces champs pour notre projet.

Si vous cochez le champ "Use spawn() instead of exec()?", votre commande sera réalisée sous forme d'un processus résident et continuera de s'exécuter jusqu'à ce qu'elle se termine par elle-même (sauf si elle ne se termine jamais).
Cette solution implique que le programme n'attendra pas que cette commande soit réalisée pour passer aux étapes suivantes.
Si la suite de l'exécution de votre flux est susceptible d'utiliser le résultat de cette commande, nous vous déconseillons d'utiliser cette option sous peine de provoquer des erreurs à la suite du traitement du flux.

[[fichier:Rasp-Node-Red-picam-mail-18.png]]

Le champ "Timeout" permet de définir un temps d'attente maximum avant de mettre un terme à l'exécution de la commande.
Cela permet de débloquer la situation si la commande exécutée prends un temps anormalement long à s'exécuter.

[[fichier:Rasp-Node-Red-picam-mail-19.png]]

==== Name ====

Nous allons ensuite compléter le champs nom, celui-ci sera utilisé pour nommer le bloc dans le "schéma", mais aussi de nommer les logs comme pour le bloc "Exec".

[[fichier:Rasp-Node-Red-picam-mail-20.png]]

=== Création d'un email au format HTML ===

Nous allons maintenant créer un template d'email au format HTML afin de mettre en forme le message que nous enverrons ensuite.
Nous allons pour cela utiliser un bloc "Template".

[[fichier:Rasp-Node-Red-picam-mail-21.png]]

==== Name ====

Nous allons attribuer un nom au bloc afin de l'identifier plus facilement dans le flux.
Nous allons donc le nommer "Contenu du mail" puisque nous créons le contenu du mail que nous enverrons ensuite.

[[fichier:Rasp-Node-Red-picam-mail-22.png]]

==== Set property ====

La propriété que nous souhaitons créer dans le flux est le "PayLoad".
Ce PayLoad existe déjà, il contient pour le moment l'image au format "Base64" précédemment encodé.
Cela n'est pas un problème, après notre noeud (notre bloc), le PayLoad sera intégralement remplacé par le template que nous sommes en train de créer.

[[fichier:Rasp-Node-Red-picam-mail-23.png]]

==== Template ====

Dans ce template, nous allons créer une structure HTML de base minimum afin que la structure soit interprétée par la majorité des clients/webmail.
Vous pouvez la personnaliser à votre guise si vous avez les connaissances en HTML.

Voici la structure de base pour notre projet:

<syntaxhighlight lang="html">
<html>
<head>
<meta charset="utf8"/>
</head>
<body>
<h1>Projet Photo par email</h1>
<img src="data:image/jpg;base64,{{payload}}"/>
</body>
</html>
</syntaxhighlight>

Vous pourrez remarquer que nous intégrons l'image en appelant le PayLoad à 'intérieur du code HTML dans la balise <img>.
C'est le PayLoad créé précédemment par le bloc "Exec" qui est récupéré à ce moment précis.
Ce PayLoad est remplacé dans le flux par le PayLoad complet avec notre template dans le flux par notre bloc Template.

[[fichier:Rasp-Node-Red-picam-mail-24.png]]

=== Création d'un bloc (noeud) "Debug" ===

Nous allons ajouter la notion d'expéditeur dans le flux que nous avons créé à travers nos blocs (noeuds).
Pour rappel, actuellement nous avons deux propriétés avec des données dans notre flux.
Si nous voulons observer ce que nous avons créé jusque là, nous pouvons faire appel à un bloc "Debug".

==== Création du bloc "Debug" ====

Comme pour les blocs précédents, nous allons glisser/déposer un bloc débug dans l'espace de travail.

[[fichier:Rasp-Node-Red-picam-mail-25.png]]

Celui-ci s'appelle msg/payload par défaut

[[fichier:Rasp-Node-Red-picam-mail-26.png]]

Nous allons double-cliquer sur ce bloc pour le configurer.

[[fichier:Rasp-Node-Red-picam-mail-27.png]]

==== Output ====

Dans ce champs, nous allons choisir la partie du flux que nous souhaitons afficher, ou nous allons sélectionner le flux entier.

[[fichier:Rasp-Node-Red-picam-mail-28.png]]

Sélectionner le flux entier, nous affichera le flux complet incluant toutes ses propriétés.

[[fichier:Rasp-Node-Red-picam-mail-29.png]]

==== To =====

La propriété "To" nous permet de choisir ou nous souhaitons afficher les données que nous récupérons.
Soit nous les affichons uniquement dans l'onglet "Debug" à droite de l'espace de travail, soit nous l'affichons dans cet onglet mais aussi dans la console de NodeJS.
Dans notre cas, nous allons nous contenter d'afficher nos éléments dans l'onglet de "Debug" à droite de notre espace de travail.

[[fichier:Rasp-Node-Red-picam-mail-30.png]]

==== Name ====

Le champs Name nous servira à identifier quel bloc de "Debug" affiche les données en console ou dans l'onglet "Debug".
Il faut donc le nommer efficacement pour bien attacher et comprendre les données que nous récupérons, surtout si nous en plaçons plusieurs dans le flux.

[[fichier:Rasp-Node-Red-picam-mail-31.png]]

==== Exploitation et compréhension des données récupérées ====

Nous avons placé notre bloc "Debug" à la suite du flux en dernière position.

[[fichier:Rasp-Node-Red-picam-mail-32.png]]

Nous allons donc déployer le programme en cliquant sur "Deploy" en haut à droite de la page.

[[fichier:Rasp-Node-Red-picam-mail-33.png]]

Ensuite, nous allons exécuter manuellement le programme en cliquant sur le bouton se trouvant en début de chaîne:

[[fichier:Rasp-Node-Red-picam-mail-34.png]]

Nous allons ensuite afficher l'onglet "Debug" sur le coté droit de la page et analyser les données récupérées:

[[fichier:Rasp-Node-Red-picam-mail-35.png]]

==== Analyse des données récupérées dans l'onglet "Debug" ====

<syntaxhighlight lang="bash">
08/05/2017 à 12:54:31 node: FORMATAGE
MCHobby - Photo bureau : msg : Object
object
_msgid: "81efe35c.3208d"
topic: "MCHobby - Photo bureau"
payload: "<html>↵ <head>↵ <meta charset="utf8"/>↵ ↵ </head>↵ <body>↵ <h1>MCHobby - Photo bureau</h1>↵ <p>Cette photo est un instantané pris dans les bureaux de MCHobby.</p>↵
<img src="data:image/jpg;base64,/9j/4WP6x2.../>"
</syntaxhighlight>

Comme vous pourrez le constater, chaque élément du noeud est détaillé.
Les données sont cependant tronquées, le noeud "Debug" ne nous fourni pas la totalité du "PayLoad" mais nous avons déjà un bon aperçu des données qu'il contient.

_msgid: est un Id unique de message
topic: est le sujet du mail, nous l'avons déterminé dans le premier bloc
payload: contient les données du message formatées par le template que nous avons créé et complété par l'image en base64.

Les noeuds "Debug" sont pratiques. Ils nous permettent d'afficher une partie ou la totalité du flux tel qu'il est à l'endroit ou ils sont placés.

Cela peut permettre d'identifier et de résoudre plus facilement des problèmes dans des opérations plus complexes et dans notre cas, cela nous permet de mieux comprendre comment fonctionne le noeud et comment les données sont transmises d'un bloc à l'autre.

=== Création d'un expéditeur ===

Nous avons construit petit à petit un message avec un sujet, mais il manque encore un détail: l'expéditeur de l'email que nous allons envoyer.

Si vous avez bien suivi les étapes précédentes du tuto, jusqu'au noeud "Debug" et à son résultat, vous comprendrez facilement la démarche ci après pour ajouter un expéditeur dans le flux.

{{Rasp-Node-Red-TRAILER}}

Rasp-Node-Red-picam-mail

2017-05-08T12:55:17Z

AntoineWrt : /* Nous utiliserons les champs suivants */

{{Rasp-Node-Red-NAV}}

{{traduction}}

== PiCamRED - Envoi périodique de photos par email avec PiCam et NodeRED ==

[[fichier:Rasp-Node-Red-picam-mail-01.png|900px]]

=== Description du projet ===

Dans ce tutoriel, nous allons réaliser des photos à l'aide de la caméra du RaspBerry Pi 2/3 et envoyer ces clichés par email de manière périodique grâce à NodeRED.
Nous allons donc utiliser plusieurs blocs et décrire de manière détaillée le déroulement de chaque étape de la réalisation de ce projet.

Dans NodeRED, il est important de bien identifier la finalité de notre projet afin de connaître au préalable tous les éléments qu'il faudra créer et fournir à l'action finale (celle qui enverra un email).

=== Quels sont les besoins du noeud email ===

==== Composants nécessaires pour constituer un email ====

Un email est composé des éléments suivants:

* Un expéditeur
* Un destinataire
* Un sujet
* Le corps du message

Tous ces éléments vont donc devoir être préparés afin de pouvoir construire le message à envoyer par le noeud final.

Le noeud final aura aussi besoin d'un serveur SMTP (serveur d'envoi d'emails) et éventuellement de paramètres d'identification pour ce serveur d'envoi d'emails.

==== Détail des besoins du noeud email ====

La liste des éléments nécessaires s'affiche lorsque le bloc est dans la zone de travail (Schema).
Commençons donc par sélectionner le bloc email, et de le glisser dans la zone de travail.

Commençons par cliquer sur le bloc email et nous maintenons le clic pour le glisser à droite dans l'espace de travail.

(on choisit celui qui a son point de liaison à gauche, car nous voulons un bloc de sortie)

[[fichier:Rasp-Node-Red-picam-mail-36.png]]

Glissons le dans l'espace de travail, et cliquons un clic simple pour le sélectionner.

[[fichier:Rasp-Node-Red-picam-mail-37.png]]

Ensuite, dans la colonne à droite de cet espace de travail, nous cliquons sur info et nous pourrons découvrir les éléments nécessaires à la constitution d'un bloc email.

[[fichier:Rasp-Node-Red-picam-mail-38.png]]

===== Nous utiliserons les champs suivants =====

* msg.payload
Ce champ contient le corps de l'email

* msg.topic
Ce champ contient le sujet de l'email

* msg.from
Ce champ contient l'email de l'expéditeur

* msg.to
Ce champ contient l'email du destinataire

=== Création d'une action périodique ===

Dans la colonne de gauche de NodeRED, se trouvent une liste de blocs à utiliser pour réaliser vos projets. Ils sont classés par "types".

Ainsi nous retrouvons les "types" suivants:

* Input qui contient tous les blocs d'entrées
* Ouput qui contient tous les blocs de sortie
* Function qui contient des blocs de fonctions javascript etc...
* Social qui sont des blocs d'entrée ou sorties depuis ou vers les réseaux sociaux
* Storage qui sont des fonctions de lecture ou d'écriture de fichiers
* Analysis ->> Sentiment interprète du texte et détermine un score sur base d'un dictionnaire anglais, renvoie le texte avec ce score de -5 à +5, déterminant ainsi l'émotion susceptible d'être procuré par ce texte
* Advanced possède des outils permettant de détecter des changements dans des fichiers ou dossiers, de lire des flux RSS ou encore EXEC qui permet d'exécuter directement des commandes sous linux !
* Raspberry Pi contient des outils pour piloter/lire le GPIO du raspberry Pi
* Network qui contient un outil réseau de Ping

Nous allons créer une action périodique, c'est à dire paramétrer un bloc "INJECT" de manière à déclencher régulièrement une chaine d'actions que nous allons accrocher à la suite les unes après les autres.
Nous allons donc cliquer sur le bloc "Inject" dans la liste "Input" et maintenir ce clic pour le déplacer vers la zone de travail.

[[fichier:Rasp-Node-Red-picam-mail-02.png]]

Nous obtiendrons donc une nouvelle instance "inject" qui portera le nom "Timestamp" (ce nom est attribué par défaut par NodeRED) comme dans la capture ci-dessous

[[fichier:Rasp-Node-Red-picam-mail-03.png]]

Nous allons maintenant double-cliquer sur celle-ci fin de l'éditer pour voir apparaitre le menu ci-dessous

[[fichier:Rasp-Node-Red-picam-mail-04.png]]

Il va falloir configurer ce bloc, mais avant tout voici une explication de celui-ci:

==== Payload ====

Le champs PayLoad est en fait le champ de données qui sera suivi d'un noeud à l'autre jusque à la fin de la chaine.
Dans ce module "inject", nous allons donc déterminer quel type de données contiendra le "PayLoad" jusqu'à la fin de la chaine que l'on va réaliser.

Dans notre cas, nous souhaitons construire un email, donc du contenu textuel, nous allons donc choisir "String" ce qui correspond à une chaine de caractères (du texte).

[[fichier:Rasp-Node-Red-picam-mail-05.png]]

==== Topic ====

Le champs "Topic" est un champs de texte dans lequel nous allons mettre un sujet succinct décrivant notre chaine.
Dans notre cas, ce sujet fera office de sujet au mail que nous expédierons.
Nous allons donc être précis en un minimum de mots pour que le destinataire de l'email puisse facilement deviner le contenu de celui-ci.

[[fichier:Rasp-Node-Red-picam-mail-06.png]]

==== Repeat ====

Nous allons ensuite choisir l'intervalle de déclenchement de notre action, sachant que nous avons le choix entre:

* none : pas de déclenchement périodique programmé
* interval : nous fixons un temps de déclenchement à partir du lancement du programme, l'action se réalisera à chaque fois que ce temps sera écoulé de manière répétée jusqu'à l'interruption manuelle du programme
* interval between times : nous fixons ici le déclenchement par interval, mais nous fixons aussi une fourchette d'heures et des jours pendant lesquels nous exécutons cet interval
* at a specific time : nous fixons une heure d'exécution, et un ou plusieurs jours d'exécution. Dans ce cas l'action n'est pas répétée en continu mais éxécutée une seule fois par jour à l'heure programmée

Dans notre exemple, nous allons fixer un intervalle de 15 secondes pour commencer. Nous pourrons ensuite augmenter cette valeur pour éviter de recevoir trop d'emails avec des photos :D

[[fichier:Rasp-Node-Red-picam-mail-07.png]]

La case "inject once at start" permet de ne pas attendre le premier cycle avant d'exécuter une première fois l'action. Elle se lancera dès le lancement du programme, puis périodiquement selon les cycles déterminés par l'intervalle.

[[fichier:Rasp-Node-Red-picam-mail-08.png]]

==== Name ====

Le champs Name va déterminer le nom que portera le bloc dans l'espace de travail et dans les logs (si nous créons des blocs de log ensuite pour contrôler des étapes).
Il est important de bien établir ce nom de manière explicite, car le nom des blocs permettra de comprendre et retrouver facilement la logique du schéma construit, même si l'on a pas consulté celui-ci pendant une longue période.

[[fichier:Rasp-Node-Red-picam-mail-09.png]]

=== Capture d'une image depuis la PiCam ===

Nous allons aller à l'essentiel en ce qui concerne la capture photo en utilisant une commande simple pour prendre un cliché et renvoyer celui-ci dans le flux NodeRED grâce à un bloc permettant d'exécuter des commandes bash.

{{ambox | text = Vous trouverez un TUTO détaillé sur la PiCam vous permettant de prendre la main, ou de la paramétrer si vous n'avez pas encore utilisé celle-ci auparavant: ....___TUTO___...}}

Nous allons tout d'abord cliquer sur le bloc "Exec" dans la section "Advanced" de la colonne de gauche et glisser l'élément dans la zone de travail.

[[fichier:Rasp-Node-Red-picam-mail-10.png]]

Ensuite, cliquer sur le bloc nouvellement créé et configurer celui-ci.

[[fichier:Rasp-Node-Red-picam-mail-11.png]]

Le menu suivant s'affichera, et nous pourrons configurer le bloc "Exec" nouvellement créé.

==== Command ====

Nous allons y ajouter la commande à exécuter pour prendre une photo avec la caméra du Raspberry Pi et la stocker dans un fichier jpg dans le dossier /tmp/ de linux.

<syntaxhighlight lang="python">
raspistill -o /tmp/cam.jpg -w 640 -h 480
</syntaxhighlight>

Nous prenons soin de limiter la hauteur et la largeur de l'image afin de réduire son poids pour l'envoi par email.

[[fichier:Rasp-Node-Red-picam-mail-12.png]]

==== +Append ====

Ensuite, nous allons décocher la case "msg.payload" si elle est cochée par défaut.

[[fichier:Rasp-Node-Red-picam-mail-13.png]]

==== Extra input parameters et Timeout ====

Nous n'aurons pas besoin de compléter ces champs pour notre projet.

Si vous cochez le champ "Use spawn() instead of exec()?", votre commande sera réalisée sous forme d'un processus résident et continuera de s'exécuter jusqu'à ce qu'elle se termine par elle-même (sauf si elle ne se termine jamais).
Cette solution implique que le programme n'attendra pas que cette commande soit réalisée pour passer aux étapes suivantes.
Si la suite de l'exécution de votre flux est susceptible d'utiliser le résultat de cette commande, nous vous déconseillons d'utiliser cette option sous peine de provoquer des erreurs à la suite du traitement du flux.

Le champ "Timeout" permet de définir un temps d'attente maximum avant de mettre un terme à l'exécution de la commande.
Cela permet de débloquer la situation si la commande exécutée prends un temps anormalement long à s'exécuter.

==== Name ====

Nous allons ensuite compléter le champs nom, celui-ci sera utilisé pour nommer le bloc dans le "schéma", mais aussi de nommer les logs comme pour le bloc "Exec".

[[fichier:Rasp-Node-Red-picam-mail-14.png]]

=== Encodage de l'image en base64 ===

Nous allons convertir la photo prise juste avant en utilisant une commande de conversion en base64.
Cela facilitera son injection dans un template HTML que nous allons créer ensuite pour construire un email.

Nous allons tout d'abord cliquer sur le bloc "Exec" dans la section "Advanced" de la colonne de gauche et glisser l'élément dans la zone de travail.

[[fichier:Rasp-Node-Red-picam-mail-10.png]]

Ensuite, cliquer sur le bloc nouvellement créé et configurer celui-ci.

[[fichier:Rasp-Node-Red-picam-mail-11.png]]

Le menu suivant s'affichera, et nous pourrons configurer le bloc "Exec" nouvellement créé.

[[fichier:Rasp-Node-Red-picam-mail-15.png]]

==== Command ====

Nous allons y ajouter la commande à exécuter pour encoder en base 64 la photo prise précédemment avec la caméra du Raspberry Pi.

<syntaxhighlight lang="python">
base64 -i "/tmp/cam.jpg"
</syntaxhighlight>

[[fichier:Rasp-Node-Red-picam-mail-16.png]]

==== +Append ====

Ensuite, nous allons cocher la case "msg.payload" si elle n'est pas cochée par défaut pour que le résultat soit directement renvoyé par cette commande dans le "PayLoad" du flux.

[[fichier:Rasp-Node-Red-picam-mail-17.png]]

==== Extra input parameters et Timeout ====

Nous n'aurons pas besoin de compléter ces champs pour notre projet.

Si vous cochez le champ "Use spawn() instead of exec()?", votre commande sera réalisée sous forme d'un processus résident et continuera de s'exécuter jusqu'à ce qu'elle se termine par elle-même (sauf si elle ne se termine jamais).
Cette solution implique que le programme n'attendra pas que cette commande soit réalisée pour passer aux étapes suivantes.
Si la suite de l'exécution de votre flux est susceptible d'utiliser le résultat de cette commande, nous vous déconseillons d'utiliser cette option sous peine de provoquer des erreurs à la suite du traitement du flux.

[[fichier:Rasp-Node-Red-picam-mail-18.png]]

Le champ "Timeout" permet de définir un temps d'attente maximum avant de mettre un terme à l'exécution de la commande.
Cela permet de débloquer la situation si la commande exécutée prends un temps anormalement long à s'exécuter.

[[fichier:Rasp-Node-Red-picam-mail-19.png]]

==== Name ====

Nous allons ensuite compléter le champs nom, celui-ci sera utilisé pour nommer le bloc dans le "schéma", mais aussi de nommer les logs comme pour le bloc "Exec".

[[fichier:Rasp-Node-Red-picam-mail-20.png]]

=== Création d'un email au format HTML ===

Nous allons maintenant créer un template d'email au format HTML afin de mettre en forme le message que nous enverrons ensuite.
Nous allons pour cela utiliser un bloc "Template".

[[fichier:Rasp-Node-Red-picam-mail-21.png]]

==== Name ====

Nous allons attribuer un nom au bloc afin de l'identifier plus facilement dans le flux.
Nous allons donc le nommer "Contenu du mail" puisque nous créons le contenu du mail que nous enverrons ensuite.

[[fichier:Rasp-Node-Red-picam-mail-22.png]]

==== Set property ====

La propriété que nous souhaitons créer dans le flux est le "PayLoad".
Ce PayLoad existe déjà, il contient pour le moment l'image au format "Base64" précédemment encodé.
Cela n'est pas un problème, après notre noeud (notre bloc), le PayLoad sera intégralement remplacé par le template que nous sommes en train de créer.

[[fichier:Rasp-Node-Red-picam-mail-23.png]]

==== Template ====

Dans ce template, nous allons créer une structure HTML de base minimum afin que la structure soit interprétée par la majorité des clients/webmail.
Vous pouvez la personnaliser à votre guise si vous avez les connaissances en HTML.

Voici la structure de base pour notre projet:

<syntaxhighlight lang="html">
<html>
<head>
<meta charset="utf8"/>
</head>
<body>
<h1>Projet Photo par email</h1>
<img src="data:image/jpg;base64,{{payload}}"/>
</body>
</html>
</syntaxhighlight>

Vous pourrez remarquer que nous intégrons l'image en appelant le PayLoad à 'intérieur du code HTML dans la balise <img>.
C'est le PayLoad créé précédemment par le bloc "Exec" qui est récupéré à ce moment précis.
Ce PayLoad est remplacé dans le flux par le PayLoad complet avec notre template dans le flux par notre bloc Template.

[[fichier:Rasp-Node-Red-picam-mail-24.png]]

=== Création d'un bloc (noeud) "Debug" ===

Nous allons ajouter la notion d'expéditeur dans le flux que nous avons créé à travers nos blocs (noeuds).
Pour rappel, actuellement nous avons deux propriétés avec des données dans notre flux.
Si nous voulons observer ce que nous avons créé jusque là, nous pouvons faire appel à un bloc "Debug".

==== Création du bloc "Debug" ====

Comme pour les blocs précédents, nous allons glisser/déposer un bloc débug dans l'espace de travail.

[[fichier:Rasp-Node-Red-picam-mail-25.png]]

Celui-ci s'appelle msg/payload par défaut

[[fichier:Rasp-Node-Red-picam-mail-26.png]]

Nous allons double-cliquer sur ce bloc pour le configurer.

[[fichier:Rasp-Node-Red-picam-mail-27.png]]

==== Output ====

Dans ce champs, nous allons choisir la partie du flux que nous souhaitons afficher, ou nous allons sélectionner le flux entier.

[[fichier:Rasp-Node-Red-picam-mail-28.png]]

Sélectionner le flux entier, nous affichera le flux complet incluant toutes ses propriétés.

[[fichier:Rasp-Node-Red-picam-mail-29.png]]

==== To =====

La propriété "To" nous permet de choisir ou nous souhaitons afficher les données que nous récupérons.
Soit nous les affichons uniquement dans l'onglet "Debug" à droite de l'espace de travail, soit nous l'affichons dans cet onglet mais aussi dans la console de NodeJS.
Dans notre cas, nous allons nous contenter d'afficher nos éléments dans l'onglet de "Debug" à droite de notre espace de travail.

[[fichier:Rasp-Node-Red-picam-mail-30.png]]

==== Name ====

Le champs Name nous servira à identifier quel bloc de "Debug" affiche les données en console ou dans l'onglet "Debug".
Il faut donc le nommer efficacement pour bien attacher et comprendre les données que nous récupérons, surtout si nous en plaçons plusieurs dans le flux.

[[fichier:Rasp-Node-Red-picam-mail-31.png]]

==== Exploitation et compréhension des données récupérées ====

Nous avons placé notre bloc "Debug" à la suite du flux en dernière position.

[[fichier:Rasp-Node-Red-picam-mail-32.png]]

Nous allons donc déployer le programme en cliquant sur "Deploy" en haut à droite de la page.

[[fichier:Rasp-Node-Red-picam-mail-33.png]]

Ensuite, nous allons exécuter manuellement le programme en cliquant sur le bouton se trouvant en début de chaîne:

[[fichier:Rasp-Node-Red-picam-mail-34.png]]

Nous allons ensuite afficher l'onglet "Debug" sur le coté droit de la page et analyser les données récupérées:

[[fichier:Rasp-Node-Red-picam-mail-35.png]]

==== Analyse des données récupérées dans l'onglet "Debug" ====

<syntaxhighlight lang="bash">
08/05/2017 à 12:54:31 node: FORMATAGE
MCHobby - Photo bureau : msg : Object
object
_msgid: "81efe35c.3208d"
topic: "MCHobby - Photo bureau"
payload: "<html>↵ <head>↵ <meta charset="utf8"/>↵ ↵ </head>↵ <body>↵ <h1>MCHobby - Photo bureau</h1>↵ <p>Cette photo est un instantané pris dans les bureaux de MCHobby.</p>↵
<img src="data:image/jpg;base64,/9j/4WP6x2.../>"
</syntaxhighlight>

Comme vous pourrez le constater, chaque élément du noeud est détaillé.
Les données sont cependant tronquées, le noeud "Debug" ne nous fourni pas la totalité du "PayLoad" mais nous avons déjà un bon aperçu des données qu'il contient.

_msgid: est un Id unique de message
topic: est le sujet du mail, nous l'avons déterminé dans le premier bloc
payload: contient les données du message formatées par le template que nous avons créé et complété par l'image en base64.

Les noeuds "Debug" sont pratiques. Ils nous permettent d'afficher une partie ou la totalité du flux tel qu'il est à l'endroit ou ils sont placés.

Cela peut permettre d'identifier et de résoudre plus facilement des problèmes dans des opérations plus complexes et dans notre cas, cela nous permet de mieux comprendre comment fonctionne le noeud et comment les données sont transmises d'un bloc à l'autre.

=== Création d'un expéditeur ===

Nous avons construit petit à petit un message avec un sujet, mais il manque encore un détail: l'expéditeur de l'email que nous allons envoyer.

Si vous avez bien suivi les étapes précédentes du tuto, jusqu'au noeud "Debug" et à son résultat, vous comprendrez facilement la démarche ci après pour ajouter un expéditeur dans le flux.

{{Rasp-Node-Red-TRAILER}}

Rasp-Node-Red-picam-mail

2017-05-08T12:52:28Z

AntoineWrt : /* Composants nécessaires pour constituer un email */

{{Rasp-Node-Red-NAV}}

{{traduction}}

== PiCamRED - Envoi périodique de photos par email avec PiCam et NodeRED ==

[[fichier:Rasp-Node-Red-picam-mail-01.png|900px]]

=== Description du projet ===

Dans ce tutoriel, nous allons réaliser des photos à l'aide de la caméra du RaspBerry Pi 2/3 et envoyer ces clichés par email de manière périodique grâce à NodeRED.
Nous allons donc utiliser plusieurs blocs et décrire de manière détaillée le déroulement de chaque étape de la réalisation de ce projet.

Dans NodeRED, il est important de bien identifier la finalité de notre projet afin de connaître au préalable tous les éléments qu'il faudra créer et fournir à l'action finale (celle qui enverra un email).

=== Quels sont les besoins du noeud email ===

==== Composants nécessaires pour constituer un email ====

Un email est composé des éléments suivants:

* Un expéditeur
* Un destinataire
* Un sujet
* Le corps du message

Tous ces éléments vont donc devoir être préparés afin de pouvoir construire le message à envoyer par le noeud final.

Le noeud final aura aussi besoin d'un serveur SMTP (serveur d'envoi d'emails) et éventuellement de paramètres d'identification pour ce serveur d'envoi d'emails.

==== Détail des besoins du noeud email ====

La liste des éléments nécessaires s'affiche lorsque le bloc est dans la zone de travail (Schema).
Commençons donc par sélectionner le bloc email, et de le glisser dans la zone de travail.

Commençons par cliquer sur le bloc email et nous maintenons le clic pour le glisser à droite dans l'espace de travail.

(on choisit celui qui a son point de liaison à gauche, car nous voulons un bloc de sortie)

[[fichier:Rasp-Node-Red-picam-mail-36.png]]

Glissons le dans l'espace de travail, et cliquons un clic simple pour le sélectionner.

[[fichier:Rasp-Node-Red-picam-mail-37.png]]

Ensuite, dans la colonne à droite de cet espace de travail, nous cliquons sur info et nous pourrons découvrir les éléments nécessaires à la constitution d'un bloc email.

[[fichier:Rasp-Node-Red-picam-mail-38.png]]

===== Nous utiliserons les champs suivants =====

=== Création d'une action périodique ===

Dans la colonne de gauche de NodeRED, se trouvent une liste de blocs à utiliser pour réaliser vos projets. Ils sont classés par "types".

Ainsi nous retrouvons les "types" suivants:

* Input qui contient tous les blocs d'entrées
* Ouput qui contient tous les blocs de sortie
* Function qui contient des blocs de fonctions javascript etc...
* Social qui sont des blocs d'entrée ou sorties depuis ou vers les réseaux sociaux
* Storage qui sont des fonctions de lecture ou d'écriture de fichiers
* Analysis ->> Sentiment interprète du texte et détermine un score sur base d'un dictionnaire anglais, renvoie le texte avec ce score de -5 à +5, déterminant ainsi l'émotion susceptible d'être procuré par ce texte
* Advanced possède des outils permettant de détecter des changements dans des fichiers ou dossiers, de lire des flux RSS ou encore EXEC qui permet d'exécuter directement des commandes sous linux !
* Raspberry Pi contient des outils pour piloter/lire le GPIO du raspberry Pi
* Network qui contient un outil réseau de Ping

Nous allons créer une action périodique, c'est à dire paramétrer un bloc "INJECT" de manière à déclencher régulièrement une chaine d'actions que nous allons accrocher à la suite les unes après les autres.
Nous allons donc cliquer sur le bloc "Inject" dans la liste "Input" et maintenir ce clic pour le déplacer vers la zone de travail.

[[fichier:Rasp-Node-Red-picam-mail-02.png]]

Nous obtiendrons donc une nouvelle instance "inject" qui portera le nom "Timestamp" (ce nom est attribué par défaut par NodeRED) comme dans la capture ci-dessous

[[fichier:Rasp-Node-Red-picam-mail-03.png]]

Nous allons maintenant double-cliquer sur celle-ci fin de l'éditer pour voir apparaitre le menu ci-dessous

[[fichier:Rasp-Node-Red-picam-mail-04.png]]

Il va falloir configurer ce bloc, mais avant tout voici une explication de celui-ci:

==== Payload ====

Le champs PayLoad est en fait le champ de données qui sera suivi d'un noeud à l'autre jusque à la fin de la chaine.
Dans ce module "inject", nous allons donc déterminer quel type de données contiendra le "PayLoad" jusqu'à la fin de la chaine que l'on va réaliser.

Dans notre cas, nous souhaitons construire un email, donc du contenu textuel, nous allons donc choisir "String" ce qui correspond à une chaine de caractères (du texte).

[[fichier:Rasp-Node-Red-picam-mail-05.png]]

==== Topic ====

Le champs "Topic" est un champs de texte dans lequel nous allons mettre un sujet succinct décrivant notre chaine.
Dans notre cas, ce sujet fera office de sujet au mail que nous expédierons.
Nous allons donc être précis en un minimum de mots pour que le destinataire de l'email puisse facilement deviner le contenu de celui-ci.

[[fichier:Rasp-Node-Red-picam-mail-06.png]]

==== Repeat ====

Nous allons ensuite choisir l'intervalle de déclenchement de notre action, sachant que nous avons le choix entre:

* none : pas de déclenchement périodique programmé
* interval : nous fixons un temps de déclenchement à partir du lancement du programme, l'action se réalisera à chaque fois que ce temps sera écoulé de manière répétée jusqu'à l'interruption manuelle du programme
* interval between times : nous fixons ici le déclenchement par interval, mais nous fixons aussi une fourchette d'heures et des jours pendant lesquels nous exécutons cet interval
* at a specific time : nous fixons une heure d'exécution, et un ou plusieurs jours d'exécution. Dans ce cas l'action n'est pas répétée en continu mais éxécutée une seule fois par jour à l'heure programmée

Dans notre exemple, nous allons fixer un intervalle de 15 secondes pour commencer. Nous pourrons ensuite augmenter cette valeur pour éviter de recevoir trop d'emails avec des photos :D

[[fichier:Rasp-Node-Red-picam-mail-07.png]]

La case "inject once at start" permet de ne pas attendre le premier cycle avant d'exécuter une première fois l'action. Elle se lancera dès le lancement du programme, puis périodiquement selon les cycles déterminés par l'intervalle.

[[fichier:Rasp-Node-Red-picam-mail-08.png]]

==== Name ====

Le champs Name va déterminer le nom que portera le bloc dans l'espace de travail et dans les logs (si nous créons des blocs de log ensuite pour contrôler des étapes).
Il est important de bien établir ce nom de manière explicite, car le nom des blocs permettra de comprendre et retrouver facilement la logique du schéma construit, même si l'on a pas consulté celui-ci pendant une longue période.

[[fichier:Rasp-Node-Red-picam-mail-09.png]]

=== Capture d'une image depuis la PiCam ===

Nous allons aller à l'essentiel en ce qui concerne la capture photo en utilisant une commande simple pour prendre un cliché et renvoyer celui-ci dans le flux NodeRED grâce à un bloc permettant d'exécuter des commandes bash.

{{ambox | text = Vous trouverez un TUTO détaillé sur la PiCam vous permettant de prendre la main, ou de la paramétrer si vous n'avez pas encore utilisé celle-ci auparavant: ....___TUTO___...}}

Nous allons tout d'abord cliquer sur le bloc "Exec" dans la section "Advanced" de la colonne de gauche et glisser l'élément dans la zone de travail.

[[fichier:Rasp-Node-Red-picam-mail-10.png]]

Ensuite, cliquer sur le bloc nouvellement créé et configurer celui-ci.

[[fichier:Rasp-Node-Red-picam-mail-11.png]]

Le menu suivant s'affichera, et nous pourrons configurer le bloc "Exec" nouvellement créé.

==== Command ====

Nous allons y ajouter la commande à exécuter pour prendre une photo avec la caméra du Raspberry Pi et la stocker dans un fichier jpg dans le dossier /tmp/ de linux.

<syntaxhighlight lang="python">
raspistill -o /tmp/cam.jpg -w 640 -h 480
</syntaxhighlight>

Nous prenons soin de limiter la hauteur et la largeur de l'image afin de réduire son poids pour l'envoi par email.

[[fichier:Rasp-Node-Red-picam-mail-12.png]]

==== +Append ====

Ensuite, nous allons décocher la case "msg.payload" si elle est cochée par défaut.

[[fichier:Rasp-Node-Red-picam-mail-13.png]]

==== Extra input parameters et Timeout ====

Nous n'aurons pas besoin de compléter ces champs pour notre projet.

Si vous cochez le champ "Use spawn() instead of exec()?", votre commande sera réalisée sous forme d'un processus résident et continuera de s'exécuter jusqu'à ce qu'elle se termine par elle-même (sauf si elle ne se termine jamais).
Cette solution implique que le programme n'attendra pas que cette commande soit réalisée pour passer aux étapes suivantes.
Si la suite de l'exécution de votre flux est susceptible d'utiliser le résultat de cette commande, nous vous déconseillons d'utiliser cette option sous peine de provoquer des erreurs à la suite du traitement du flux.

Le champ "Timeout" permet de définir un temps d'attente maximum avant de mettre un terme à l'exécution de la commande.
Cela permet de débloquer la situation si la commande exécutée prends un temps anormalement long à s'exécuter.

==== Name ====

Nous allons ensuite compléter le champs nom, celui-ci sera utilisé pour nommer le bloc dans le "schéma", mais aussi de nommer les logs comme pour le bloc "Exec".

[[fichier:Rasp-Node-Red-picam-mail-14.png]]

=== Encodage de l'image en base64 ===

Nous allons convertir la photo prise juste avant en utilisant une commande de conversion en base64.
Cela facilitera son injection dans un template HTML que nous allons créer ensuite pour construire un email.

Nous allons tout d'abord cliquer sur le bloc "Exec" dans la section "Advanced" de la colonne de gauche et glisser l'élément dans la zone de travail.

[[fichier:Rasp-Node-Red-picam-mail-10.png]]

Ensuite, cliquer sur le bloc nouvellement créé et configurer celui-ci.

[[fichier:Rasp-Node-Red-picam-mail-11.png]]

Le menu suivant s'affichera, et nous pourrons configurer le bloc "Exec" nouvellement créé.

[[fichier:Rasp-Node-Red-picam-mail-15.png]]

==== Command ====

Nous allons y ajouter la commande à exécuter pour encoder en base 64 la photo prise précédemment avec la caméra du Raspberry Pi.

<syntaxhighlight lang="python">
base64 -i "/tmp/cam.jpg"
</syntaxhighlight>

[[fichier:Rasp-Node-Red-picam-mail-16.png]]

==== +Append ====

Ensuite, nous allons cocher la case "msg.payload" si elle n'est pas cochée par défaut pour que le résultat soit directement renvoyé par cette commande dans le "PayLoad" du flux.

[[fichier:Rasp-Node-Red-picam-mail-17.png]]

==== Extra input parameters et Timeout ====

Nous n'aurons pas besoin de compléter ces champs pour notre projet.

Si vous cochez le champ "Use spawn() instead of exec()?", votre commande sera réalisée sous forme d'un processus résident et continuera de s'exécuter jusqu'à ce qu'elle se termine par elle-même (sauf si elle ne se termine jamais).
Cette solution implique que le programme n'attendra pas que cette commande soit réalisée pour passer aux étapes suivantes.
Si la suite de l'exécution de votre flux est susceptible d'utiliser le résultat de cette commande, nous vous déconseillons d'utiliser cette option sous peine de provoquer des erreurs à la suite du traitement du flux.

[[fichier:Rasp-Node-Red-picam-mail-18.png]]

Le champ "Timeout" permet de définir un temps d'attente maximum avant de mettre un terme à l'exécution de la commande.
Cela permet de débloquer la situation si la commande exécutée prends un temps anormalement long à s'exécuter.

[[fichier:Rasp-Node-Red-picam-mail-19.png]]

==== Name ====

Nous allons ensuite compléter le champs nom, celui-ci sera utilisé pour nommer le bloc dans le "schéma", mais aussi de nommer les logs comme pour le bloc "Exec".

[[fichier:Rasp-Node-Red-picam-mail-20.png]]

=== Création d'un email au format HTML ===

Nous allons maintenant créer un template d'email au format HTML afin de mettre en forme le message que nous enverrons ensuite.
Nous allons pour cela utiliser un bloc "Template".

[[fichier:Rasp-Node-Red-picam-mail-21.png]]

==== Name ====

Nous allons attribuer un nom au bloc afin de l'identifier plus facilement dans le flux.
Nous allons donc le nommer "Contenu du mail" puisque nous créons le contenu du mail que nous enverrons ensuite.

[[fichier:Rasp-Node-Red-picam-mail-22.png]]

==== Set property ====

La propriété que nous souhaitons créer dans le flux est le "PayLoad".
Ce PayLoad existe déjà, il contient pour le moment l'image au format "Base64" précédemment encodé.
Cela n'est pas un problème, après notre noeud (notre bloc), le PayLoad sera intégralement remplacé par le template que nous sommes en train de créer.

[[fichier:Rasp-Node-Red-picam-mail-23.png]]

==== Template ====

Dans ce template, nous allons créer une structure HTML de base minimum afin que la structure soit interprétée par la majorité des clients/webmail.
Vous pouvez la personnaliser à votre guise si vous avez les connaissances en HTML.

Voici la structure de base pour notre projet:

<syntaxhighlight lang="html">
<html>
<head>
<meta charset="utf8"/>
</head>
<body>
<h1>Projet Photo par email</h1>
<img src="data:image/jpg;base64,{{payload}}"/>
</body>
</html>
</syntaxhighlight>

Vous pourrez remarquer que nous intégrons l'image en appelant le PayLoad à 'intérieur du code HTML dans la balise <img>.
C'est le PayLoad créé précédemment par le bloc "Exec" qui est récupéré à ce moment précis.
Ce PayLoad est remplacé dans le flux par le PayLoad complet avec notre template dans le flux par notre bloc Template.

[[fichier:Rasp-Node-Red-picam-mail-24.png]]

=== Création d'un bloc (noeud) "Debug" ===

Nous allons ajouter la notion d'expéditeur dans le flux que nous avons créé à travers nos blocs (noeuds).
Pour rappel, actuellement nous avons deux propriétés avec des données dans notre flux.
Si nous voulons observer ce que nous avons créé jusque là, nous pouvons faire appel à un bloc "Debug".

==== Création du bloc "Debug" ====

Comme pour les blocs précédents, nous allons glisser/déposer un bloc débug dans l'espace de travail.

[[fichier:Rasp-Node-Red-picam-mail-25.png]]

Celui-ci s'appelle msg/payload par défaut

[[fichier:Rasp-Node-Red-picam-mail-26.png]]

Nous allons double-cliquer sur ce bloc pour le configurer.

[[fichier:Rasp-Node-Red-picam-mail-27.png]]

==== Output ====

Dans ce champs, nous allons choisir la partie du flux que nous souhaitons afficher, ou nous allons sélectionner le flux entier.

[[fichier:Rasp-Node-Red-picam-mail-28.png]]

Sélectionner le flux entier, nous affichera le flux complet incluant toutes ses propriétés.

[[fichier:Rasp-Node-Red-picam-mail-29.png]]

==== To =====

La propriété "To" nous permet de choisir ou nous souhaitons afficher les données que nous récupérons.
Soit nous les affichons uniquement dans l'onglet "Debug" à droite de l'espace de travail, soit nous l'affichons dans cet onglet mais aussi dans la console de NodeJS.
Dans notre cas, nous allons nous contenter d'afficher nos éléments dans l'onglet de "Debug" à droite de notre espace de travail.

[[fichier:Rasp-Node-Red-picam-mail-30.png]]

==== Name ====

Le champs Name nous servira à identifier quel bloc de "Debug" affiche les données en console ou dans l'onglet "Debug".
Il faut donc le nommer efficacement pour bien attacher et comprendre les données que nous récupérons, surtout si nous en plaçons plusieurs dans le flux.

[[fichier:Rasp-Node-Red-picam-mail-31.png]]

==== Exploitation et compréhension des données récupérées ====

Nous avons placé notre bloc "Debug" à la suite du flux en dernière position.

[[fichier:Rasp-Node-Red-picam-mail-32.png]]

Nous allons donc déployer le programme en cliquant sur "Deploy" en haut à droite de la page.

[[fichier:Rasp-Node-Red-picam-mail-33.png]]

Ensuite, nous allons exécuter manuellement le programme en cliquant sur le bouton se trouvant en début de chaîne:

[[fichier:Rasp-Node-Red-picam-mail-34.png]]

Nous allons ensuite afficher l'onglet "Debug" sur le coté droit de la page et analyser les données récupérées:

[[fichier:Rasp-Node-Red-picam-mail-35.png]]

==== Analyse des données récupérées dans l'onglet "Debug" ====

<syntaxhighlight lang="bash">
08/05/2017 à 12:54:31 node: FORMATAGE
MCHobby - Photo bureau : msg : Object
object
_msgid: "81efe35c.3208d"
topic: "MCHobby - Photo bureau"
payload: "<html>↵ <head>↵ <meta charset="utf8"/>↵ ↵ </head>↵ <body>↵ <h1>MCHobby - Photo bureau</h1>↵ <p>Cette photo est un instantané pris dans les bureaux de MCHobby.</p>↵
<img src="data:image/jpg;base64,/9j/4WP6x2.../>"
</syntaxhighlight>

Comme vous pourrez le constater, chaque élément du noeud est détaillé.
Les données sont cependant tronquées, le noeud "Debug" ne nous fourni pas la totalité du "PayLoad" mais nous avons déjà un bon aperçu des données qu'il contient.

_msgid: est un Id unique de message
topic: est le sujet du mail, nous l'avons déterminé dans le premier bloc
payload: contient les données du message formatées par le template que nous avons créé et complété par l'image en base64.

Les noeuds "Debug" sont pratiques. Ils nous permettent d'afficher une partie ou la totalité du flux tel qu'il est à l'endroit ou ils sont placés.

Cela peut permettre d'identifier et de résoudre plus facilement des problèmes dans des opérations plus complexes et dans notre cas, cela nous permet de mieux comprendre comment fonctionne le noeud et comment les données sont transmises d'un bloc à l'autre.

=== Création d'un expéditeur ===

Nous avons construit petit à petit un message avec un sujet, mais il manque encore un détail: l'expéditeur de l'email que nous allons envoyer.

Si vous avez bien suivi les étapes précédentes du tuto, jusqu'au noeud "Debug" et à son résultat, vous comprendrez facilement la démarche ci après pour ajouter un expéditeur dans le flux.

{{Rasp-Node-Red-TRAILER}}

Rasp-Node-Red-picam-mail

2017-05-08T12:51:46Z

AntoineWrt : /* Détail des besoins du noeud email */

{{Rasp-Node-Red-NAV}}

{{traduction}}

== PiCamRED - Envoi périodique de photos par email avec PiCam et NodeRED ==

[[fichier:Rasp-Node-Red-picam-mail-01.png|900px]]

=== Description du projet ===

Dans ce tutoriel, nous allons réaliser des photos à l'aide de la caméra du RaspBerry Pi 2/3 et envoyer ces clichés par email de manière périodique grâce à NodeRED.
Nous allons donc utiliser plusieurs blocs et décrire de manière détaillée le déroulement de chaque étape de la réalisation de ce projet.

Dans NodeRED, il est important de bien identifier la finalité de notre projet afin de connaître au préalable tous les éléments qu'il faudra créer et fournir à l'action finale (celle qui enverra un email).

=== Quels sont les besoins du noeud email ===

==== Composants nécessaires pour constituer un email ====

Un email est composé des éléments suivants:

* Un expéditeur
* Un destinataire
* Un sujet
* Le corps du message

Tous ces éléments vont donc devoir être préparés afin de pouvoir construire le message à envoyer par le noeud final.

Le noeud final aura aussi besoin d'un serveur SMTP (serveur d'envoi d'emails) et éventuellement de paramètres d'identification pour ce serveur d'envoi d'emails.

==== Détail des besoins du noeud email ====

La liste des éléments nécessaires s'affiche lorsque le bloc est dans la zone de travail (Schema).
Commençons donc par sélectionner le bloc email, et de le glisser dans la zone de travail.

Commençons par cliquer sur le bloc email et nous maintenons le clic pour le glisser à droite dans l'espace de travail.

(on choisit celui qui a son point de liaison à gauche, car nous voulons un bloc de sortie)

[[fichier:Rasp-Node-Red-picam-mail-36.png]]

Glissons le dans l'espace de travail, et cliquons un clic simple pour le sélectionner.

[[fichier:Rasp-Node-Red-picam-mail-37.png]]

Ensuite, dans la colonne à droite de cet espace de travail, nous cliquons sur info et nous pourrons découvrir les éléments nécessaires à la constitution d'un bloc email.

[[fichier:Rasp-Node-Red-picam-mail-38.png]]

===== Nous utiliserons les champs suivants =====

=== Création d'une action périodique ===

Dans la colonne de gauche de NodeRED, se trouvent une liste de blocs à utiliser pour réaliser vos projets. Ils sont classés par "types".

Ainsi nous retrouvons les "types" suivants:

* Input qui contient tous les blocs d'entrées
* Ouput qui contient tous les blocs de sortie
* Function qui contient des blocs de fonctions javascript etc...
* Social qui sont des blocs d'entrée ou sorties depuis ou vers les réseaux sociaux
* Storage qui sont des fonctions de lecture ou d'écriture de fichiers
* Analysis ->> Sentiment interprète du texte et détermine un score sur base d'un dictionnaire anglais, renvoie le texte avec ce score de -5 à +5, déterminant ainsi l'émotion susceptible d'être procuré par ce texte
* Advanced possède des outils permettant de détecter des changements dans des fichiers ou dossiers, de lire des flux RSS ou encore EXEC qui permet d'exécuter directement des commandes sous linux !
* Raspberry Pi contient des outils pour piloter/lire le GPIO du raspberry Pi
* Network qui contient un outil réseau de Ping

Nous allons créer une action périodique, c'est à dire paramétrer un bloc "INJECT" de manière à déclencher régulièrement une chaine d'actions que nous allons accrocher à la suite les unes après les autres.
Nous allons donc cliquer sur le bloc "Inject" dans la liste "Input" et maintenir ce clic pour le déplacer vers la zone de travail.

[[fichier:Rasp-Node-Red-picam-mail-02.png]]

Nous obtiendrons donc une nouvelle instance "inject" qui portera le nom "Timestamp" (ce nom est attribué par défaut par NodeRED) comme dans la capture ci-dessous

[[fichier:Rasp-Node-Red-picam-mail-03.png]]

Nous allons maintenant double-cliquer sur celle-ci fin de l'éditer pour voir apparaitre le menu ci-dessous

[[fichier:Rasp-Node-Red-picam-mail-04.png]]

Il va falloir configurer ce bloc, mais avant tout voici une explication de celui-ci:

==== Payload ====

Le champs PayLoad est en fait le champ de données qui sera suivi d'un noeud à l'autre jusque à la fin de la chaine.
Dans ce module "inject", nous allons donc déterminer quel type de données contiendra le "PayLoad" jusqu'à la fin de la chaine que l'on va réaliser.

Dans notre cas, nous souhaitons construire un email, donc du contenu textuel, nous allons donc choisir "String" ce qui correspond à une chaine de caractères (du texte).

[[fichier:Rasp-Node-Red-picam-mail-05.png]]

==== Topic ====

Le champs "Topic" est un champs de texte dans lequel nous allons mettre un sujet succinct décrivant notre chaine.
Dans notre cas, ce sujet fera office de sujet au mail que nous expédierons.
Nous allons donc être précis en un minimum de mots pour que le destinataire de l'email puisse facilement deviner le contenu de celui-ci.

[[fichier:Rasp-Node-Red-picam-mail-06.png]]

==== Repeat ====

Nous allons ensuite choisir l'intervalle de déclenchement de notre action, sachant que nous avons le choix entre:

* none : pas de déclenchement périodique programmé
* interval : nous fixons un temps de déclenchement à partir du lancement du programme, l'action se réalisera à chaque fois que ce temps sera écoulé de manière répétée jusqu'à l'interruption manuelle du programme
* interval between times : nous fixons ici le déclenchement par interval, mais nous fixons aussi une fourchette d'heures et des jours pendant lesquels nous exécutons cet interval
* at a specific time : nous fixons une heure d'exécution, et un ou plusieurs jours d'exécution. Dans ce cas l'action n'est pas répétée en continu mais éxécutée une seule fois par jour à l'heure programmée

Dans notre exemple, nous allons fixer un intervalle de 15 secondes pour commencer. Nous pourrons ensuite augmenter cette valeur pour éviter de recevoir trop d'emails avec des photos :D

[[fichier:Rasp-Node-Red-picam-mail-07.png]]

La case "inject once at start" permet de ne pas attendre le premier cycle avant d'exécuter une première fois l'action. Elle se lancera dès le lancement du programme, puis périodiquement selon les cycles déterminés par l'intervalle.

[[fichier:Rasp-Node-Red-picam-mail-08.png]]

==== Name ====

Le champs Name va déterminer le nom que portera le bloc dans l'espace de travail et dans les logs (si nous créons des blocs de log ensuite pour contrôler des étapes).
Il est important de bien établir ce nom de manière explicite, car le nom des blocs permettra de comprendre et retrouver facilement la logique du schéma construit, même si l'on a pas consulté celui-ci pendant une longue période.

[[fichier:Rasp-Node-Red-picam-mail-09.png]]

=== Capture d'une image depuis la PiCam ===

Nous allons aller à l'essentiel en ce qui concerne la capture photo en utilisant une commande simple pour prendre un cliché et renvoyer celui-ci dans le flux NodeRED grâce à un bloc permettant d'exécuter des commandes bash.

{{ambox | text = Vous trouverez un TUTO détaillé sur la PiCam vous permettant de prendre la main, ou de la paramétrer si vous n'avez pas encore utilisé celle-ci auparavant: ....___TUTO___...}}

Nous allons tout d'abord cliquer sur le bloc "Exec" dans la section "Advanced" de la colonne de gauche et glisser l'élément dans la zone de travail.

[[fichier:Rasp-Node-Red-picam-mail-10.png]]

Ensuite, cliquer sur le bloc nouvellement créé et configurer celui-ci.

[[fichier:Rasp-Node-Red-picam-mail-11.png]]

Le menu suivant s'affichera, et nous pourrons configurer le bloc "Exec" nouvellement créé.

==== Command ====

Nous allons y ajouter la commande à exécuter pour prendre une photo avec la caméra du Raspberry Pi et la stocker dans un fichier jpg dans le dossier /tmp/ de linux.

<syntaxhighlight lang="python">
raspistill -o /tmp/cam.jpg -w 640 -h 480
</syntaxhighlight>

Nous prenons soin de limiter la hauteur et la largeur de l'image afin de réduire son poids pour l'envoi par email.

[[fichier:Rasp-Node-Red-picam-mail-12.png]]

==== +Append ====

Ensuite, nous allons décocher la case "msg.payload" si elle est cochée par défaut.

[[fichier:Rasp-Node-Red-picam-mail-13.png]]

==== Extra input parameters et Timeout ====

Nous n'aurons pas besoin de compléter ces champs pour notre projet.

Si vous cochez le champ "Use spawn() instead of exec()?", votre commande sera réalisée sous forme d'un processus résident et continuera de s'exécuter jusqu'à ce qu'elle se termine par elle-même (sauf si elle ne se termine jamais).
Cette solution implique que le programme n'attendra pas que cette commande soit réalisée pour passer aux étapes suivantes.
Si la suite de l'exécution de votre flux est susceptible d'utiliser le résultat de cette commande, nous vous déconseillons d'utiliser cette option sous peine de provoquer des erreurs à la suite du traitement du flux.

Le champ "Timeout" permet de définir un temps d'attente maximum avant de mettre un terme à l'exécution de la commande.
Cela permet de débloquer la situation si la commande exécutée prends un temps anormalement long à s'exécuter.

==== Name ====

Nous allons ensuite compléter le champs nom, celui-ci sera utilisé pour nommer le bloc dans le "schéma", mais aussi de nommer les logs comme pour le bloc "Exec".

[[fichier:Rasp-Node-Red-picam-mail-14.png]]

=== Encodage de l'image en base64 ===

Nous allons convertir la photo prise juste avant en utilisant une commande de conversion en base64.
Cela facilitera son injection dans un template HTML que nous allons créer ensuite pour construire un email.

Nous allons tout d'abord cliquer sur le bloc "Exec" dans la section "Advanced" de la colonne de gauche et glisser l'élément dans la zone de travail.

[[fichier:Rasp-Node-Red-picam-mail-10.png]]

Ensuite, cliquer sur le bloc nouvellement créé et configurer celui-ci.

[[fichier:Rasp-Node-Red-picam-mail-11.png]]

Le menu suivant s'affichera, et nous pourrons configurer le bloc "Exec" nouvellement créé.

[[fichier:Rasp-Node-Red-picam-mail-15.png]]

==== Command ====

Nous allons y ajouter la commande à exécuter pour encoder en base 64 la photo prise précédemment avec la caméra du Raspberry Pi.

<syntaxhighlight lang="python">
base64 -i "/tmp/cam.jpg"
</syntaxhighlight>

[[fichier:Rasp-Node-Red-picam-mail-16.png]]

==== +Append ====

Ensuite, nous allons cocher la case "msg.payload" si elle n'est pas cochée par défaut pour que le résultat soit directement renvoyé par cette commande dans le "PayLoad" du flux.

[[fichier:Rasp-Node-Red-picam-mail-17.png]]

==== Extra input parameters et Timeout ====

Nous n'aurons pas besoin de compléter ces champs pour notre projet.

Si vous cochez le champ "Use spawn() instead of exec()?", votre commande sera réalisée sous forme d'un processus résident et continuera de s'exécuter jusqu'à ce qu'elle se termine par elle-même (sauf si elle ne se termine jamais).
Cette solution implique que le programme n'attendra pas que cette commande soit réalisée pour passer aux étapes suivantes.
Si la suite de l'exécution de votre flux est susceptible d'utiliser le résultat de cette commande, nous vous déconseillons d'utiliser cette option sous peine de provoquer des erreurs à la suite du traitement du flux.

[[fichier:Rasp-Node-Red-picam-mail-18.png]]

Le champ "Timeout" permet de définir un temps d'attente maximum avant de mettre un terme à l'exécution de la commande.
Cela permet de débloquer la situation si la commande exécutée prends un temps anormalement long à s'exécuter.

[[fichier:Rasp-Node-Red-picam-mail-19.png]]

==== Name ====

Nous allons ensuite compléter le champs nom, celui-ci sera utilisé pour nommer le bloc dans le "schéma", mais aussi de nommer les logs comme pour le bloc "Exec".

[[fichier:Rasp-Node-Red-picam-mail-20.png]]

=== Création d'un email au format HTML ===

Nous allons maintenant créer un template d'email au format HTML afin de mettre en forme le message que nous enverrons ensuite.
Nous allons pour cela utiliser un bloc "Template".

[[fichier:Rasp-Node-Red-picam-mail-21.png]]

==== Name ====

Nous allons attribuer un nom au bloc afin de l'identifier plus facilement dans le flux.
Nous allons donc le nommer "Contenu du mail" puisque nous créons le contenu du mail que nous enverrons ensuite.

[[fichier:Rasp-Node-Red-picam-mail-22.png]]

==== Set property ====

La propriété que nous souhaitons créer dans le flux est le "PayLoad".
Ce PayLoad existe déjà, il contient pour le moment l'image au format "Base64" précédemment encodé.
Cela n'est pas un problème, après notre noeud (notre bloc), le PayLoad sera intégralement remplacé par le template que nous sommes en train de créer.

[[fichier:Rasp-Node-Red-picam-mail-23.png]]

==== Template ====

Dans ce template, nous allons créer une structure HTML de base minimum afin que la structure soit interprétée par la majorité des clients/webmail.
Vous pouvez la personnaliser à votre guise si vous avez les connaissances en HTML.

Voici la structure de base pour notre projet:

<syntaxhighlight lang="html">
<html>
<head>
<meta charset="utf8"/>
</head>
<body>
<h1>Projet Photo par email</h1>
<img src="data:image/jpg;base64,{{payload}}"/>
</body>
</html>
</syntaxhighlight>

Vous pourrez remarquer que nous intégrons l'image en appelant le PayLoad à 'intérieur du code HTML dans la balise <img>.
C'est le PayLoad créé précédemment par le bloc "Exec" qui est récupéré à ce moment précis.
Ce PayLoad est remplacé dans le flux par le PayLoad complet avec notre template dans le flux par notre bloc Template.

[[fichier:Rasp-Node-Red-picam-mail-24.png]]

=== Création d'un bloc (noeud) "Debug" ===

Nous allons ajouter la notion d'expéditeur dans le flux que nous avons créé à travers nos blocs (noeuds).
Pour rappel, actuellement nous avons deux propriétés avec des données dans notre flux.
Si nous voulons observer ce que nous avons créé jusque là, nous pouvons faire appel à un bloc "Debug".

==== Création du bloc "Debug" ====

Comme pour les blocs précédents, nous allons glisser/déposer un bloc débug dans l'espace de travail.

[[fichier:Rasp-Node-Red-picam-mail-25.png]]

Celui-ci s'appelle msg/payload par défaut

[[fichier:Rasp-Node-Red-picam-mail-26.png]]

Nous allons double-cliquer sur ce bloc pour le configurer.

[[fichier:Rasp-Node-Red-picam-mail-27.png]]

==== Output ====

Dans ce champs, nous allons choisir la partie du flux que nous souhaitons afficher, ou nous allons sélectionner le flux entier.

[[fichier:Rasp-Node-Red-picam-mail-28.png]]

Sélectionner le flux entier, nous affichera le flux complet incluant toutes ses propriétés.

[[fichier:Rasp-Node-Red-picam-mail-29.png]]

==== To =====

La propriété "To" nous permet de choisir ou nous souhaitons afficher les données que nous récupérons.
Soit nous les affichons uniquement dans l'onglet "Debug" à droite de l'espace de travail, soit nous l'affichons dans cet onglet mais aussi dans la console de NodeJS.
Dans notre cas, nous allons nous contenter d'afficher nos éléments dans l'onglet de "Debug" à droite de notre espace de travail.

[[fichier:Rasp-Node-Red-picam-mail-30.png]]

==== Name ====

Le champs Name nous servira à identifier quel bloc de "Debug" affiche les données en console ou dans l'onglet "Debug".
Il faut donc le nommer efficacement pour bien attacher et comprendre les données que nous récupérons, surtout si nous en plaçons plusieurs dans le flux.

[[fichier:Rasp-Node-Red-picam-mail-31.png]]

==== Exploitation et compréhension des données récupérées ====

Nous avons placé notre bloc "Debug" à la suite du flux en dernière position.

[[fichier:Rasp-Node-Red-picam-mail-32.png]]

Nous allons donc déployer le programme en cliquant sur "Deploy" en haut à droite de la page.

[[fichier:Rasp-Node-Red-picam-mail-33.png]]

Ensuite, nous allons exécuter manuellement le programme en cliquant sur le bouton se trouvant en début de chaîne:

[[fichier:Rasp-Node-Red-picam-mail-34.png]]

Nous allons ensuite afficher l'onglet "Debug" sur le coté droit de la page et analyser les données récupérées:

[[fichier:Rasp-Node-Red-picam-mail-35.png]]

==== Analyse des données récupérées dans l'onglet "Debug" ====

<syntaxhighlight lang="bash">
08/05/2017 à 12:54:31 node: FORMATAGE
MCHobby - Photo bureau : msg : Object
object
_msgid: "81efe35c.3208d"
topic: "MCHobby - Photo bureau"
payload: "<html>↵ <head>↵ <meta charset="utf8"/>↵ ↵ </head>↵ <body>↵ <h1>MCHobby - Photo bureau</h1>↵ <p>Cette photo est un instantané pris dans les bureaux de MCHobby.</p>↵
<img src="data:image/jpg;base64,/9j/4WP6x2.../>"
</syntaxhighlight>

Comme vous pourrez le constater, chaque élément du noeud est détaillé.
Les données sont cependant tronquées, le noeud "Debug" ne nous fourni pas la totalité du "PayLoad" mais nous avons déjà un bon aperçu des données qu'il contient.

_msgid: est un Id unique de message
topic: est le sujet du mail, nous l'avons déterminé dans le premier bloc
payload: contient les données du message formatées par le template que nous avons créé et complété par l'image en base64.

Les noeuds "Debug" sont pratiques. Ils nous permettent d'afficher une partie ou la totalité du flux tel qu'il est à l'endroit ou ils sont placés.

Cela peut permettre d'identifier et de résoudre plus facilement des problèmes dans des opérations plus complexes et dans notre cas, cela nous permet de mieux comprendre comment fonctionne le noeud et comment les données sont transmises d'un bloc à l'autre.

=== Création d'un expéditeur ===

Nous avons construit petit à petit un message avec un sujet, mais il manque encore un détail: l'expéditeur de l'email que nous allons envoyer.

Si vous avez bien suivi les étapes précédentes du tuto, jusqu'au noeud "Debug" et à son résultat, vous comprendrez facilement la démarche ci après pour ajouter un expéditeur dans le flux.

{{Rasp-Node-Red-TRAILER}}

Fichier:Rasp-Node-Red-picam-mail-38.png

2017-05-08T12:50:57Z

AntoineWrt :

Fichier:Rasp-Node-Red-picam-mail-37.png

2017-05-08T12:50:38Z

AntoineWrt :

Fichier:Rasp-Node-Red-picam-mail-36.png

2017-05-08T12:50:25Z

AntoineWrt :

Rasp-Node-Red-picam-mail

2017-05-08T12:50:09Z

AntoineWrt :

{{Rasp-Node-Red-NAV}}

{{traduction}}

== PiCamRED - Envoi périodique de photos par email avec PiCam et NodeRED ==

[[fichier:Rasp-Node-Red-picam-mail-01.png|900px]]

=== Description du projet ===

Dans ce tutoriel, nous allons réaliser des photos à l'aide de la caméra du RaspBerry Pi 2/3 et envoyer ces clichés par email de manière périodique grâce à NodeRED.
Nous allons donc utiliser plusieurs blocs et décrire de manière détaillée le déroulement de chaque étape de la réalisation de ce projet.

Dans NodeRED, il est important de bien identifier la finalité de notre projet afin de connaître au préalable tous les éléments qu'il faudra créer et fournir à l'action finale (celle qui enverra un email).

=== Quels sont les besoins du noeud email ===

==== Composants nécessaires pour constituer un email ====

Un email est composé des éléments suivants:

* Un expéditeur
* Un destinataire
* Un sujet
* Le corps du message

Tous ces éléments vont donc devoir être préparés afin de pouvoir construire le message à envoyer par le noeud final.

Le noeud final aura aussi besoin d'un serveur SMTP (serveur d'envoi d'emails) et éventuellement de paramètres d'identification pour ce serveur d'envoi d'emails.

==== Détail des besoins du noeud email ====

La liste des éléments nécessaires s'affiche lorsque le bloc est dans la zone de travail (Schema).
Commençons donc par sélectionner le bloc email, et de le glisser dans la zone de travail.

Commençons par cliquer sur le bloc email et nous maintenons le clic pour le glisser à droite dans l'espace de travail.

(on choisit celui qui a son point de liaison à gauche, car nous voulons un bloc de sortie)

[[fichier:Rasp-Node-Red-picam-mail-36.png]]

Glissons le dans l'espace de travail, et cliquons un clic simple pour le sélectionner.

[[fichier:Rasp-Node-Red-picam-mail-37.png]]

Ensuite, dans la colonne à droite de cet espace de travail, nous cliquons sur info et nous pourrons découvrir les éléments nécessaires à la constitution d'un bloc email.

[[fichier:Rasp-Node-Red-picam-mail-38.png]]

=== Création d'une action périodique ===

Dans la colonne de gauche de NodeRED, se trouvent une liste de blocs à utiliser pour réaliser vos projets. Ils sont classés par "types".

Ainsi nous retrouvons les "types" suivants:

* Input qui contient tous les blocs d'entrées
* Ouput qui contient tous les blocs de sortie
* Function qui contient des blocs de fonctions javascript etc...
* Social qui sont des blocs d'entrée ou sorties depuis ou vers les réseaux sociaux
* Storage qui sont des fonctions de lecture ou d'écriture de fichiers
* Analysis ->> Sentiment interprète du texte et détermine un score sur base d'un dictionnaire anglais, renvoie le texte avec ce score de -5 à +5, déterminant ainsi l'émotion susceptible d'être procuré par ce texte
* Advanced possède des outils permettant de détecter des changements dans des fichiers ou dossiers, de lire des flux RSS ou encore EXEC qui permet d'exécuter directement des commandes sous linux !
* Raspberry Pi contient des outils pour piloter/lire le GPIO du raspberry Pi
* Network qui contient un outil réseau de Ping

Nous allons créer une action périodique, c'est à dire paramétrer un bloc "INJECT" de manière à déclencher régulièrement une chaine d'actions que nous allons accrocher à la suite les unes après les autres.
Nous allons donc cliquer sur le bloc "Inject" dans la liste "Input" et maintenir ce clic pour le déplacer vers la zone de travail.

[[fichier:Rasp-Node-Red-picam-mail-02.png]]

Nous obtiendrons donc une nouvelle instance "inject" qui portera le nom "Timestamp" (ce nom est attribué par défaut par NodeRED) comme dans la capture ci-dessous

[[fichier:Rasp-Node-Red-picam-mail-03.png]]

Nous allons maintenant double-cliquer sur celle-ci fin de l'éditer pour voir apparaitre le menu ci-dessous

[[fichier:Rasp-Node-Red-picam-mail-04.png]]

Il va falloir configurer ce bloc, mais avant tout voici une explication de celui-ci:

==== Payload ====

Le champs PayLoad est en fait le champ de données qui sera suivi d'un noeud à l'autre jusque à la fin de la chaine.
Dans ce module "inject", nous allons donc déterminer quel type de données contiendra le "PayLoad" jusqu'à la fin de la chaine que l'on va réaliser.

Dans notre cas, nous souhaitons construire un email, donc du contenu textuel, nous allons donc choisir "String" ce qui correspond à une chaine de caractères (du texte).

[[fichier:Rasp-Node-Red-picam-mail-05.png]]

==== Topic ====

Le champs "Topic" est un champs de texte dans lequel nous allons mettre un sujet succinct décrivant notre chaine.
Dans notre cas, ce sujet fera office de sujet au mail que nous expédierons.
Nous allons donc être précis en un minimum de mots pour que le destinataire de l'email puisse facilement deviner le contenu de celui-ci.

[[fichier:Rasp-Node-Red-picam-mail-06.png]]

==== Repeat ====

Nous allons ensuite choisir l'intervalle de déclenchement de notre action, sachant que nous avons le choix entre:

* none : pas de déclenchement périodique programmé
* interval : nous fixons un temps de déclenchement à partir du lancement du programme, l'action se réalisera à chaque fois que ce temps sera écoulé de manière répétée jusqu'à l'interruption manuelle du programme
* interval between times : nous fixons ici le déclenchement par interval, mais nous fixons aussi une fourchette d'heures et des jours pendant lesquels nous exécutons cet interval
* at a specific time : nous fixons une heure d'exécution, et un ou plusieurs jours d'exécution. Dans ce cas l'action n'est pas répétée en continu mais éxécutée une seule fois par jour à l'heure programmée

Dans notre exemple, nous allons fixer un intervalle de 15 secondes pour commencer. Nous pourrons ensuite augmenter cette valeur pour éviter de recevoir trop d'emails avec des photos :D

[[fichier:Rasp-Node-Red-picam-mail-07.png]]

La case "inject once at start" permet de ne pas attendre le premier cycle avant d'exécuter une première fois l'action. Elle se lancera dès le lancement du programme, puis périodiquement selon les cycles déterminés par l'intervalle.

[[fichier:Rasp-Node-Red-picam-mail-08.png]]

==== Name ====

Le champs Name va déterminer le nom que portera le bloc dans l'espace de travail et dans les logs (si nous créons des blocs de log ensuite pour contrôler des étapes).
Il est important de bien établir ce nom de manière explicite, car le nom des blocs permettra de comprendre et retrouver facilement la logique du schéma construit, même si l'on a pas consulté celui-ci pendant une longue période.

[[fichier:Rasp-Node-Red-picam-mail-09.png]]

=== Capture d'une image depuis la PiCam ===

Nous allons aller à l'essentiel en ce qui concerne la capture photo en utilisant une commande simple pour prendre un cliché et renvoyer celui-ci dans le flux NodeRED grâce à un bloc permettant d'exécuter des commandes bash.

{{ambox | text = Vous trouverez un TUTO détaillé sur la PiCam vous permettant de prendre la main, ou de la paramétrer si vous n'avez pas encore utilisé celle-ci auparavant: ....___TUTO___...}}

Nous allons tout d'abord cliquer sur le bloc "Exec" dans la section "Advanced" de la colonne de gauche et glisser l'élément dans la zone de travail.

[[fichier:Rasp-Node-Red-picam-mail-10.png]]

Ensuite, cliquer sur le bloc nouvellement créé et configurer celui-ci.

[[fichier:Rasp-Node-Red-picam-mail-11.png]]

Le menu suivant s'affichera, et nous pourrons configurer le bloc "Exec" nouvellement créé.

==== Command ====

Nous allons y ajouter la commande à exécuter pour prendre une photo avec la caméra du Raspberry Pi et la stocker dans un fichier jpg dans le dossier /tmp/ de linux.

<syntaxhighlight lang="python">
raspistill -o /tmp/cam.jpg -w 640 -h 480
</syntaxhighlight>

Nous prenons soin de limiter la hauteur et la largeur de l'image afin de réduire son poids pour l'envoi par email.

[[fichier:Rasp-Node-Red-picam-mail-12.png]]

==== +Append ====

Ensuite, nous allons décocher la case "msg.payload" si elle est cochée par défaut.

[[fichier:Rasp-Node-Red-picam-mail-13.png]]

==== Extra input parameters et Timeout ====

Nous n'aurons pas besoin de compléter ces champs pour notre projet.

Si vous cochez le champ "Use spawn() instead of exec()?", votre commande sera réalisée sous forme d'un processus résident et continuera de s'exécuter jusqu'à ce qu'elle se termine par elle-même (sauf si elle ne se termine jamais).
Cette solution implique que le programme n'attendra pas que cette commande soit réalisée pour passer aux étapes suivantes.
Si la suite de l'exécution de votre flux est susceptible d'utiliser le résultat de cette commande, nous vous déconseillons d'utiliser cette option sous peine de provoquer des erreurs à la suite du traitement du flux.

Le champ "Timeout" permet de définir un temps d'attente maximum avant de mettre un terme à l'exécution de la commande.
Cela permet de débloquer la situation si la commande exécutée prends un temps anormalement long à s'exécuter.

==== Name ====

Nous allons ensuite compléter le champs nom, celui-ci sera utilisé pour nommer le bloc dans le "schéma", mais aussi de nommer les logs comme pour le bloc "Exec".

[[fichier:Rasp-Node-Red-picam-mail-14.png]]

=== Encodage de l'image en base64 ===

Nous allons convertir la photo prise juste avant en utilisant une commande de conversion en base64.
Cela facilitera son injection dans un template HTML que nous allons créer ensuite pour construire un email.

Nous allons tout d'abord cliquer sur le bloc "Exec" dans la section "Advanced" de la colonne de gauche et glisser l'élément dans la zone de travail.

[[fichier:Rasp-Node-Red-picam-mail-10.png]]

Ensuite, cliquer sur le bloc nouvellement créé et configurer celui-ci.

[[fichier:Rasp-Node-Red-picam-mail-11.png]]

Le menu suivant s'affichera, et nous pourrons configurer le bloc "Exec" nouvellement créé.

[[fichier:Rasp-Node-Red-picam-mail-15.png]]

==== Command ====

Nous allons y ajouter la commande à exécuter pour encoder en base 64 la photo prise précédemment avec la caméra du Raspberry Pi.

<syntaxhighlight lang="python">
base64 -i "/tmp/cam.jpg"
</syntaxhighlight>

[[fichier:Rasp-Node-Red-picam-mail-16.png]]

==== +Append ====

Ensuite, nous allons cocher la case "msg.payload" si elle n'est pas cochée par défaut pour que le résultat soit directement renvoyé par cette commande dans le "PayLoad" du flux.

[[fichier:Rasp-Node-Red-picam-mail-17.png]]

==== Extra input parameters et Timeout ====

Nous n'aurons pas besoin de compléter ces champs pour notre projet.

Si vous cochez le champ "Use spawn() instead of exec()?", votre commande sera réalisée sous forme d'un processus résident et continuera de s'exécuter jusqu'à ce qu'elle se termine par elle-même (sauf si elle ne se termine jamais).
Cette solution implique que le programme n'attendra pas que cette commande soit réalisée pour passer aux étapes suivantes.
Si la suite de l'exécution de votre flux est susceptible d'utiliser le résultat de cette commande, nous vous déconseillons d'utiliser cette option sous peine de provoquer des erreurs à la suite du traitement du flux.

[[fichier:Rasp-Node-Red-picam-mail-18.png]]

Le champ "Timeout" permet de définir un temps d'attente maximum avant de mettre un terme à l'exécution de la commande.
Cela permet de débloquer la situation si la commande exécutée prends un temps anormalement long à s'exécuter.

[[fichier:Rasp-Node-Red-picam-mail-19.png]]

==== Name ====

Nous allons ensuite compléter le champs nom, celui-ci sera utilisé pour nommer le bloc dans le "schéma", mais aussi de nommer les logs comme pour le bloc "Exec".

[[fichier:Rasp-Node-Red-picam-mail-20.png]]

=== Création d'un email au format HTML ===

Nous allons maintenant créer un template d'email au format HTML afin de mettre en forme le message que nous enverrons ensuite.
Nous allons pour cela utiliser un bloc "Template".

[[fichier:Rasp-Node-Red-picam-mail-21.png]]

==== Name ====

Nous allons attribuer un nom au bloc afin de l'identifier plus facilement dans le flux.
Nous allons donc le nommer "Contenu du mail" puisque nous créons le contenu du mail que nous enverrons ensuite.

[[fichier:Rasp-Node-Red-picam-mail-22.png]]

==== Set property ====

La propriété que nous souhaitons créer dans le flux est le "PayLoad".
Ce PayLoad existe déjà, il contient pour le moment l'image au format "Base64" précédemment encodé.
Cela n'est pas un problème, après notre noeud (notre bloc), le PayLoad sera intégralement remplacé par le template que nous sommes en train de créer.

[[fichier:Rasp-Node-Red-picam-mail-23.png]]

==== Template ====

Dans ce template, nous allons créer une structure HTML de base minimum afin que la structure soit interprétée par la majorité des clients/webmail.
Vous pouvez la personnaliser à votre guise si vous avez les connaissances en HTML.

Voici la structure de base pour notre projet:

<syntaxhighlight lang="html">
<html>
<head>
<meta charset="utf8"/>
</head>
<body>
<h1>Projet Photo par email</h1>
<img src="data:image/jpg;base64,{{payload}}"/>
</body>
</html>
</syntaxhighlight>

Vous pourrez remarquer que nous intégrons l'image en appelant le PayLoad à 'intérieur du code HTML dans la balise <img>.
C'est le PayLoad créé précédemment par le bloc "Exec" qui est récupéré à ce moment précis.
Ce PayLoad est remplacé dans le flux par le PayLoad complet avec notre template dans le flux par notre bloc Template.

[[fichier:Rasp-Node-Red-picam-mail-24.png]]

=== Création d'un bloc (noeud) "Debug" ===

Nous allons ajouter la notion d'expéditeur dans le flux que nous avons créé à travers nos blocs (noeuds).
Pour rappel, actuellement nous avons deux propriétés avec des données dans notre flux.
Si nous voulons observer ce que nous avons créé jusque là, nous pouvons faire appel à un bloc "Debug".

==== Création du bloc "Debug" ====

Comme pour les blocs précédents, nous allons glisser/déposer un bloc débug dans l'espace de travail.

[[fichier:Rasp-Node-Red-picam-mail-25.png]]

Celui-ci s'appelle msg/payload par défaut

[[fichier:Rasp-Node-Red-picam-mail-26.png]]

Nous allons double-cliquer sur ce bloc pour le configurer.

[[fichier:Rasp-Node-Red-picam-mail-27.png]]

==== Output ====

Dans ce champs, nous allons choisir la partie du flux que nous souhaitons afficher, ou nous allons sélectionner le flux entier.

[[fichier:Rasp-Node-Red-picam-mail-28.png]]

Sélectionner le flux entier, nous affichera le flux complet incluant toutes ses propriétés.

[[fichier:Rasp-Node-Red-picam-mail-29.png]]

==== To =====

La propriété "To" nous permet de choisir ou nous souhaitons afficher les données que nous récupérons.
Soit nous les affichons uniquement dans l'onglet "Debug" à droite de l'espace de travail, soit nous l'affichons dans cet onglet mais aussi dans la console de NodeJS.
Dans notre cas, nous allons nous contenter d'afficher nos éléments dans l'onglet de "Debug" à droite de notre espace de travail.

[[fichier:Rasp-Node-Red-picam-mail-30.png]]

==== Name ====

Le champs Name nous servira à identifier quel bloc de "Debug" affiche les données en console ou dans l'onglet "Debug".
Il faut donc le nommer efficacement pour bien attacher et comprendre les données que nous récupérons, surtout si nous en plaçons plusieurs dans le flux.

[[fichier:Rasp-Node-Red-picam-mail-31.png]]

==== Exploitation et compréhension des données récupérées ====

Nous avons placé notre bloc "Debug" à la suite du flux en dernière position.

[[fichier:Rasp-Node-Red-picam-mail-32.png]]

Nous allons donc déployer le programme en cliquant sur "Deploy" en haut à droite de la page.

[[fichier:Rasp-Node-Red-picam-mail-33.png]]

Ensuite, nous allons exécuter manuellement le programme en cliquant sur le bouton se trouvant en début de chaîne:

[[fichier:Rasp-Node-Red-picam-mail-34.png]]

Nous allons ensuite afficher l'onglet "Debug" sur le coté droit de la page et analyser les données récupérées:

[[fichier:Rasp-Node-Red-picam-mail-35.png]]

==== Analyse des données récupérées dans l'onglet "Debug" ====

<syntaxhighlight lang="bash">
08/05/2017 à 12:54:31 node: FORMATAGE
MCHobby - Photo bureau : msg : Object
object
_msgid: "81efe35c.3208d"
topic: "MCHobby - Photo bureau"
payload: "<html>↵ <head>↵ <meta charset="utf8"/>↵ ↵ </head>↵ <body>↵ <h1>MCHobby - Photo bureau</h1>↵ <p>Cette photo est un instantané pris dans les bureaux de MCHobby.</p>↵
<img src="data:image/jpg;base64,/9j/4WP6x2.../>"
</syntaxhighlight>

Comme vous pourrez le constater, chaque élément du noeud est détaillé.
Les données sont cependant tronquées, le noeud "Debug" ne nous fourni pas la totalité du "PayLoad" mais nous avons déjà un bon aperçu des données qu'il contient.

_msgid: est un Id unique de message
topic: est le sujet du mail, nous l'avons déterminé dans le premier bloc
payload: contient les données du message formatées par le template que nous avons créé et complété par l'image en base64.

Les noeuds "Debug" sont pratiques. Ils nous permettent d'afficher une partie ou la totalité du flux tel qu'il est à l'endroit ou ils sont placés.

Cela peut permettre d'identifier et de résoudre plus facilement des problèmes dans des opérations plus complexes et dans notre cas, cela nous permet de mieux comprendre comment fonctionne le noeud et comment les données sont transmises d'un bloc à l'autre.

=== Création d'un expéditeur ===

Nous avons construit petit à petit un message avec un sujet, mais il manque encore un détail: l'expéditeur de l'email que nous allons envoyer.

Si vous avez bien suivi les étapes précédentes du tuto, jusqu'au noeud "Debug" et à son résultat, vous comprendrez facilement la démarche ci après pour ajouter un expéditeur dans le flux.

{{Rasp-Node-Red-TRAILER}}

Rasp-Node-Red-picam-mail

2017-05-08T11:08:39Z

AntoineWrt : /* Analyse des données récupérées dans l'onglet "Debug" */

{{Rasp-Node-Red-NAV}}

{{traduction}}

== PiCamRED - Envoi périodique de photos par email avec PiCam et NodeRED ==

[[fichier:Rasp-Node-Red-picam-mail-01.png|900px]]

=== Description du projet ===

Dans ce tutoriel, nous allons réaliser des photos à l'aide de la caméra du RaspBerry Pi 2/3 et envoyer ces clichés par email de manière périodique grâce à NodeRED.
Nous allons donc utiliser plusieurs blocs et décrire de manière détaillée le déroulement de chaque étape de la réalisation de ce projet.

=== Création d'une action périodique ===

Dans la colonne de gauche de NodeRED, se trouvent une liste de blocs à utiliser pour réaliser vos projets. Ils sont classés par "types".

Ainsi nous retrouvons les "types" suivants:

* Input qui contient tous les blocs d'entrées
* Ouput qui contient tous les blocs de sortie
* Function qui contient des blocs de fonctions javascript etc...
* Social qui sont des blocs d'entrée ou sorties depuis ou vers les réseaux sociaux
* Storage qui sont des fonctions de lecture ou d'écriture de fichiers
* Analysis ->> Sentiment interprète du texte et détermine un score sur base d'un dictionnaire anglais, renvoie le texte avec ce score de -5 à +5, déterminant ainsi l'émotion susceptible d'être procuré par ce texte
* Advanced possède des outils permettant de détecter des changements dans des fichiers ou dossiers, de lire des flux RSS ou encore EXEC qui permet d'exécuter directement des commandes sous linux !
* Raspberry Pi contient des outils pour piloter/lire le GPIO du raspberry Pi
* Network qui contient un outil réseau de Ping

Nous allons créer une action périodique, c'est à dire paramétrer un bloc "INJECT" de manière à déclencher régulièrement une chaine d'actions que nous allons accrocher à la suite les unes après les autres.
Nous allons donc cliquer sur le bloc "Inject" dans la liste "Input" et maintenir ce clic pour le déplacer vers la zone de travail.

[[fichier:Rasp-Node-Red-picam-mail-02.png]]

Nous obtiendrons donc une nouvelle instance "inject" qui portera le nom "Timestamp" (ce nom est attribué par défaut par NodeRED) comme dans la capture ci-dessous

[[fichier:Rasp-Node-Red-picam-mail-03.png]]

Nous allons maintenant double-cliquer sur celle-ci fin de l'éditer pour voir apparaitre le menu ci-dessous

[[fichier:Rasp-Node-Red-picam-mail-04.png]]

Il va falloir configurer ce bloc, mais avant tout voici une explication de celui-ci:

==== Payload ====

Le champs PayLoad est en fait le champ de données qui sera suivi d'un noeud à l'autre jusque à la fin de la chaine.
Dans ce module "inject", nous allons donc déterminer quel type de données contiendra le "PayLoad" jusqu'à la fin de la chaine que l'on va réaliser.

Dans notre cas, nous souhaitons construire un email, donc du contenu textuel, nous allons donc choisir "String" ce qui correspond à une chaine de caractères (du texte).

[[fichier:Rasp-Node-Red-picam-mail-05.png]]

==== Topic ====

Le champs "Topic" est un champs de texte dans lequel nous allons mettre un sujet succinct décrivant notre chaine.
Dans notre cas, ce sujet fera office de sujet au mail que nous expédierons.
Nous allons donc être précis en un minimum de mots pour que le destinataire de l'email puisse facilement deviner le contenu de celui-ci.

[[fichier:Rasp-Node-Red-picam-mail-06.png]]

==== Repeat ====

Nous allons ensuite choisir l'intervalle de déclenchement de notre action, sachant que nous avons le choix entre:

* none : pas de déclenchement périodique programmé
* interval : nous fixons un temps de déclenchement à partir du lancement du programme, l'action se réalisera à chaque fois que ce temps sera écoulé de manière répétée jusqu'à l'interruption manuelle du programme
* interval between times : nous fixons ici le déclenchement par interval, mais nous fixons aussi une fourchette d'heures et des jours pendant lesquels nous exécutons cet interval
* at a specific time : nous fixons une heure d'exécution, et un ou plusieurs jours d'exécution. Dans ce cas l'action n'est pas répétée en continu mais éxécutée une seule fois par jour à l'heure programmée

Dans notre exemple, nous allons fixer un intervalle de 15 secondes pour commencer. Nous pourrons ensuite augmenter cette valeur pour éviter de recevoir trop d'emails avec des photos :D

[[fichier:Rasp-Node-Red-picam-mail-07.png]]

La case "inject once at start" permet de ne pas attendre le premier cycle avant d'exécuter une première fois l'action. Elle se lancera dès le lancement du programme, puis périodiquement selon les cycles déterminés par l'intervalle.

[[fichier:Rasp-Node-Red-picam-mail-08.png]]

==== Name ====

Le champs Name va déterminer le nom que portera le bloc dans l'espace de travail et dans les logs (si nous créons des blocs de log ensuite pour contrôler des étapes).
Il est important de bien établir ce nom de manière explicite, car le nom des blocs permettra de comprendre et retrouver facilement la logique du schéma construit, même si l'on a pas consulté celui-ci pendant une longue période.

[[fichier:Rasp-Node-Red-picam-mail-09.png]]

=== Capture d'une image depuis la PiCam ===

Nous allons aller à l'essentiel en ce qui concerne la capture photo en utilisant une commande simple pour prendre un cliché et renvoyer celui-ci dans le flux NodeRED grâce à un bloc permettant d'exécuter des commandes bash.

{{ambox | text = Vous trouverez un TUTO détaillé sur la PiCam vous permettant de prendre la main, ou de la paramétrer si vous n'avez pas encore utilisé celle-ci auparavant: ....___TUTO___...}}

Nous allons tout d'abord cliquer sur le bloc "Exec" dans la section "Advanced" de la colonne de gauche et glisser l'élément dans la zone de travail.

[[fichier:Rasp-Node-Red-picam-mail-10.png]]

Ensuite, cliquer sur le bloc nouvellement créé et configurer celui-ci.

[[fichier:Rasp-Node-Red-picam-mail-11.png]]

Le menu suivant s'affichera, et nous pourrons configurer le bloc "Exec" nouvellement créé.

==== Command ====

Nous allons y ajouter la commande à exécuter pour prendre une photo avec la caméra du Raspberry Pi et la stocker dans un fichier jpg dans le dossier /tmp/ de linux.

<syntaxhighlight lang="python">
raspistill -o /tmp/cam.jpg -w 640 -h 480
</syntaxhighlight>

Nous prenons soin de limiter la hauteur et la largeur de l'image afin de réduire son poids pour l'envoi par email.

[[fichier:Rasp-Node-Red-picam-mail-12.png]]

==== +Append ====

Ensuite, nous allons décocher la case "msg.payload" si elle est cochée par défaut.

[[fichier:Rasp-Node-Red-picam-mail-13.png]]

==== Extra input parameters et Timeout ====

Nous n'aurons pas besoin de compléter ces champs pour notre projet.

Si vous cochez le champ "Use spawn() instead of exec()?", votre commande sera réalisée sous forme d'un processus résident et continuera de s'exécuter jusqu'à ce qu'elle se termine par elle-même (sauf si elle ne se termine jamais).
Cette solution implique que le programme n'attendra pas que cette commande soit réalisée pour passer aux étapes suivantes.
Si la suite de l'exécution de votre flux est susceptible d'utiliser le résultat de cette commande, nous vous déconseillons d'utiliser cette option sous peine de provoquer des erreurs à la suite du traitement du flux.

Le champ "Timeout" permet de définir un temps d'attente maximum avant de mettre un terme à l'exécution de la commande.
Cela permet de débloquer la situation si la commande exécutée prends un temps anormalement long à s'exécuter.

==== Name ====

Nous allons ensuite compléter le champs nom, celui-ci sera utilisé pour nommer le bloc dans le "schéma", mais aussi de nommer les logs comme pour le bloc "Exec".

[[fichier:Rasp-Node-Red-picam-mail-14.png]]

=== Encodage de l'image en base64 ===

Nous allons convertir la photo prise juste avant en utilisant une commande de conversion en base64.
Cela facilitera son injection dans un template HTML que nous allons créer ensuite pour construire un email.

Nous allons tout d'abord cliquer sur le bloc "Exec" dans la section "Advanced" de la colonne de gauche et glisser l'élément dans la zone de travail.

[[fichier:Rasp-Node-Red-picam-mail-10.png]]

Ensuite, cliquer sur le bloc nouvellement créé et configurer celui-ci.

[[fichier:Rasp-Node-Red-picam-mail-11.png]]

Le menu suivant s'affichera, et nous pourrons configurer le bloc "Exec" nouvellement créé.

[[fichier:Rasp-Node-Red-picam-mail-15.png]]

==== Command ====

Nous allons y ajouter la commande à exécuter pour encoder en base 64 la photo prise précédemment avec la caméra du Raspberry Pi.

<syntaxhighlight lang="python">
base64 -i "/tmp/cam.jpg"
</syntaxhighlight>

[[fichier:Rasp-Node-Red-picam-mail-16.png]]

==== +Append ====

Ensuite, nous allons cocher la case "msg.payload" si elle n'est pas cochée par défaut pour que le résultat soit directement renvoyé par cette commande dans le "PayLoad" du flux.

[[fichier:Rasp-Node-Red-picam-mail-17.png]]

==== Extra input parameters et Timeout ====

Nous n'aurons pas besoin de compléter ces champs pour notre projet.

Si vous cochez le champ "Use spawn() instead of exec()?", votre commande sera réalisée sous forme d'un processus résident et continuera de s'exécuter jusqu'à ce qu'elle se termine par elle-même (sauf si elle ne se termine jamais).
Cette solution implique que le programme n'attendra pas que cette commande soit réalisée pour passer aux étapes suivantes.
Si la suite de l'exécution de votre flux est susceptible d'utiliser le résultat de cette commande, nous vous déconseillons d'utiliser cette option sous peine de provoquer des erreurs à la suite du traitement du flux.

[[fichier:Rasp-Node-Red-picam-mail-18.png]]

Le champ "Timeout" permet de définir un temps d'attente maximum avant de mettre un terme à l'exécution de la commande.
Cela permet de débloquer la situation si la commande exécutée prends un temps anormalement long à s'exécuter.

[[fichier:Rasp-Node-Red-picam-mail-19.png]]

==== Name ====

Nous allons ensuite compléter le champs nom, celui-ci sera utilisé pour nommer le bloc dans le "schéma", mais aussi de nommer les logs comme pour le bloc "Exec".

[[fichier:Rasp-Node-Red-picam-mail-20.png]]

=== Création d'un email au format HTML ===

Nous allons maintenant créer un template d'email au format HTML afin de mettre en forme le message que nous enverrons ensuite.
Nous allons pour cela utiliser un bloc "Template".

[[fichier:Rasp-Node-Red-picam-mail-21.png]]

==== Name ====

Nous allons attribuer un nom au bloc afin de l'identifier plus facilement dans le flux.
Nous allons donc le nommer "Contenu du mail" puisque nous créons le contenu du mail que nous enverrons ensuite.

[[fichier:Rasp-Node-Red-picam-mail-22.png]]

==== Set property ====

La propriété que nous souhaitons créer dans le flux est le "PayLoad".
Ce PayLoad existe déjà, il contient pour le moment l'image au format "Base64" précédemment encodé.
Cela n'est pas un problème, après notre noeud (notre bloc), le PayLoad sera intégralement remplacé par le template que nous sommes en train de créer.

[[fichier:Rasp-Node-Red-picam-mail-23.png]]

==== Template ====

Dans ce template, nous allons créer une structure HTML de base minimum afin que la structure soit interprétée par la majorité des clients/webmail.
Vous pouvez la personnaliser à votre guise si vous avez les connaissances en HTML.

Voici la structure de base pour notre projet:

<syntaxhighlight lang="html">
<html>
<head>
<meta charset="utf8"/>
</head>
<body>
<h1>Projet Photo par email</h1>
<img src="data:image/jpg;base64,{{payload}}"/>
</body>
</html>
</syntaxhighlight>

Vous pourrez remarquer que nous intégrons l'image en appelant le PayLoad à 'intérieur du code HTML dans la balise <img>.
C'est le PayLoad créé précédemment par le bloc "Exec" qui est récupéré à ce moment précis.
Ce PayLoad est remplacé dans le flux par le PayLoad complet avec notre template dans le flux par notre bloc Template.

[[fichier:Rasp-Node-Red-picam-mail-24.png]]

=== Création d'un bloc (noeud) "Debug" ===

Nous allons ajouter la notion d'expéditeur dans le flux que nous avons créé à travers nos blocs (noeuds).
Pour rappel, actuellement nous avons deux propriétés avec des données dans notre flux.
Si nous voulons observer ce que nous avons créé jusque là, nous pouvons faire appel à un bloc "Debug".

==== Création du bloc "Debug" ====

Comme pour les blocs précédents, nous allons glisser/déposer un bloc débug dans l'espace de travail.

[[fichier:Rasp-Node-Red-picam-mail-25.png]]

Celui-ci s'appelle msg/payload par défaut

[[fichier:Rasp-Node-Red-picam-mail-26.png]]

Nous allons double-cliquer sur ce bloc pour le configurer.

[[fichier:Rasp-Node-Red-picam-mail-27.png]]

==== Output ====

Dans ce champs, nous allons choisir la partie du flux que nous souhaitons afficher, ou nous allons sélectionner le flux entier.

[[fichier:Rasp-Node-Red-picam-mail-28.png]]

Sélectionner le flux entier, nous affichera le flux complet incluant toutes ses propriétés.

[[fichier:Rasp-Node-Red-picam-mail-29.png]]

==== To =====

La propriété "To" nous permet de choisir ou nous souhaitons afficher les données que nous récupérons.
Soit nous les affichons uniquement dans l'onglet "Debug" à droite de l'espace de travail, soit nous l'affichons dans cet onglet mais aussi dans la console de NodeJS.
Dans notre cas, nous allons nous contenter d'afficher nos éléments dans l'onglet de "Debug" à droite de notre espace de travail.

[[fichier:Rasp-Node-Red-picam-mail-30.png]]

==== Name ====

Le champs Name nous servira à identifier quel bloc de "Debug" affiche les données en console ou dans l'onglet "Debug".
Il faut donc le nommer efficacement pour bien attacher et comprendre les données que nous récupérons, surtout si nous en plaçons plusieurs dans le flux.

[[fichier:Rasp-Node-Red-picam-mail-31.png]]

==== Exploitation et compréhension des données récupérées ====

Nous avons placé notre bloc "Debug" à la suite du flux en dernière position.

[[fichier:Rasp-Node-Red-picam-mail-32.png]]

Nous allons donc déployer le programme en cliquant sur "Deploy" en haut à droite de la page.

[[fichier:Rasp-Node-Red-picam-mail-33.png]]

Ensuite, nous allons exécuter manuellement le programme en cliquant sur le bouton se trouvant en début de chaîne:

[[fichier:Rasp-Node-Red-picam-mail-34.png]]

Nous allons ensuite afficher l'onglet "Debug" sur le coté droit de la page et analyser les données récupérées:

[[fichier:Rasp-Node-Red-picam-mail-35.png]]

==== Analyse des données récupérées dans l'onglet "Debug" ====

<syntaxhighlight lang="bash">
08/05/2017 à 12:54:31 node: FORMATAGE
MCHobby - Photo bureau : msg : Object
object
_msgid: "81efe35c.3208d"
topic: "MCHobby - Photo bureau"
payload: "<html>↵ <head>↵ <meta charset="utf8"/>↵ ↵ </head>↵ <body>↵ <h1>MCHobby - Photo bureau</h1>↵ <p>Cette photo est un instantané pris dans les bureaux de MCHobby.</p>↵
<img src="data:image/jpg;base64,/9j/4WP6x2.../>"
</syntaxhighlight>

Comme vous pourrez le constater, chaque élément du noeud est détaillé.
Les données sont cependant tronquées, le noeud "Debug" ne nous fourni pas la totalité du "PayLoad" mais nous avons déjà un bon aperçu des données qu'il contient.

_msgid: est un Id unique de message
topic: est le sujet du mail, nous l'avons déterminé dans le premier bloc
payload: contient les données du message formatées par le template que nous avons créé et complété par l'image en base64.

Les noeuds "Debug" sont pratiques. Ils nous permettent d'afficher une partie ou la totalité du flux tel qu'il est à l'endroit ou ils sont placés.

Cela peut permettre d'identifier et de résoudre plus facilement des problèmes dans des opérations plus complexes...

=== Création d'un expéditeur ===

Nous avons construit petit à petit un message avec un sujet, mais il manque encore un détail: l'expéditeur de l'email que nous allons envoyer.

Voici une méthode pour ajouter cet expéditeur dans le flux.

{{Rasp-Node-Red-TRAILER}}

Rasp-Node-Red-picam-mail

2017-05-08T10:59:56Z

AntoineWrt : /* Analyse des données récupérées dans l'onglet "Debug" */

{{Rasp-Node-Red-NAV}}

{{traduction}}

== PiCamRED - Envoi périodique de photos par email avec PiCam et NodeRED ==

[[fichier:Rasp-Node-Red-picam-mail-01.png|900px]]

=== Description du projet ===

Dans ce tutoriel, nous allons réaliser des photos à l'aide de la caméra du RaspBerry Pi 2/3 et envoyer ces clichés par email de manière périodique grâce à NodeRED.
Nous allons donc utiliser plusieurs blocs et décrire de manière détaillée le déroulement de chaque étape de la réalisation de ce projet.

=== Création d'une action périodique ===

Dans la colonne de gauche de NodeRED, se trouvent une liste de blocs à utiliser pour réaliser vos projets. Ils sont classés par "types".

Ainsi nous retrouvons les "types" suivants:

* Input qui contient tous les blocs d'entrées
* Ouput qui contient tous les blocs de sortie
* Function qui contient des blocs de fonctions javascript etc...
* Social qui sont des blocs d'entrée ou sorties depuis ou vers les réseaux sociaux
* Storage qui sont des fonctions de lecture ou d'écriture de fichiers
* Analysis ->> Sentiment interprète du texte et détermine un score sur base d'un dictionnaire anglais, renvoie le texte avec ce score de -5 à +5, déterminant ainsi l'émotion susceptible d'être procuré par ce texte
* Advanced possède des outils permettant de détecter des changements dans des fichiers ou dossiers, de lire des flux RSS ou encore EXEC qui permet d'exécuter directement des commandes sous linux !
* Raspberry Pi contient des outils pour piloter/lire le GPIO du raspberry Pi
* Network qui contient un outil réseau de Ping

Nous allons créer une action périodique, c'est à dire paramétrer un bloc "INJECT" de manière à déclencher régulièrement une chaine d'actions que nous allons accrocher à la suite les unes après les autres.
Nous allons donc cliquer sur le bloc "Inject" dans la liste "Input" et maintenir ce clic pour le déplacer vers la zone de travail.

[[fichier:Rasp-Node-Red-picam-mail-02.png]]

Nous obtiendrons donc une nouvelle instance "inject" qui portera le nom "Timestamp" (ce nom est attribué par défaut par NodeRED) comme dans la capture ci-dessous

[[fichier:Rasp-Node-Red-picam-mail-03.png]]

Nous allons maintenant double-cliquer sur celle-ci fin de l'éditer pour voir apparaitre le menu ci-dessous

[[fichier:Rasp-Node-Red-picam-mail-04.png]]

Il va falloir configurer ce bloc, mais avant tout voici une explication de celui-ci:

==== Payload ====

Le champs PayLoad est en fait le champ de données qui sera suivi d'un noeud à l'autre jusque à la fin de la chaine.
Dans ce module "inject", nous allons donc déterminer quel type de données contiendra le "PayLoad" jusqu'à la fin de la chaine que l'on va réaliser.

Dans notre cas, nous souhaitons construire un email, donc du contenu textuel, nous allons donc choisir "String" ce qui correspond à une chaine de caractères (du texte).

[[fichier:Rasp-Node-Red-picam-mail-05.png]]

==== Topic ====

Le champs "Topic" est un champs de texte dans lequel nous allons mettre un sujet succinct décrivant notre chaine.
Dans notre cas, ce sujet fera office de sujet au mail que nous expédierons.
Nous allons donc être précis en un minimum de mots pour que le destinataire de l'email puisse facilement deviner le contenu de celui-ci.

[[fichier:Rasp-Node-Red-picam-mail-06.png]]

==== Repeat ====

Nous allons ensuite choisir l'intervalle de déclenchement de notre action, sachant que nous avons le choix entre:

* none : pas de déclenchement périodique programmé
* interval : nous fixons un temps de déclenchement à partir du lancement du programme, l'action se réalisera à chaque fois que ce temps sera écoulé de manière répétée jusqu'à l'interruption manuelle du programme
* interval between times : nous fixons ici le déclenchement par interval, mais nous fixons aussi une fourchette d'heures et des jours pendant lesquels nous exécutons cet interval
* at a specific time : nous fixons une heure d'exécution, et un ou plusieurs jours d'exécution. Dans ce cas l'action n'est pas répétée en continu mais éxécutée une seule fois par jour à l'heure programmée

Dans notre exemple, nous allons fixer un intervalle de 15 secondes pour commencer. Nous pourrons ensuite augmenter cette valeur pour éviter de recevoir trop d'emails avec des photos :D

[[fichier:Rasp-Node-Red-picam-mail-07.png]]

La case "inject once at start" permet de ne pas attendre le premier cycle avant d'exécuter une première fois l'action. Elle se lancera dès le lancement du programme, puis périodiquement selon les cycles déterminés par l'intervalle.

[[fichier:Rasp-Node-Red-picam-mail-08.png]]

==== Name ====

Le champs Name va déterminer le nom que portera le bloc dans l'espace de travail et dans les logs (si nous créons des blocs de log ensuite pour contrôler des étapes).
Il est important de bien établir ce nom de manière explicite, car le nom des blocs permettra de comprendre et retrouver facilement la logique du schéma construit, même si l'on a pas consulté celui-ci pendant une longue période.

[[fichier:Rasp-Node-Red-picam-mail-09.png]]

=== Capture d'une image depuis la PiCam ===

Nous allons aller à l'essentiel en ce qui concerne la capture photo en utilisant une commande simple pour prendre un cliché et renvoyer celui-ci dans le flux NodeRED grâce à un bloc permettant d'exécuter des commandes bash.

{{ambox | text = Vous trouverez un TUTO détaillé sur la PiCam vous permettant de prendre la main, ou de la paramétrer si vous n'avez pas encore utilisé celle-ci auparavant: ....___TUTO___...}}

Nous allons tout d'abord cliquer sur le bloc "Exec" dans la section "Advanced" de la colonne de gauche et glisser l'élément dans la zone de travail.

[[fichier:Rasp-Node-Red-picam-mail-10.png]]

Ensuite, cliquer sur le bloc nouvellement créé et configurer celui-ci.

[[fichier:Rasp-Node-Red-picam-mail-11.png]]

Le menu suivant s'affichera, et nous pourrons configurer le bloc "Exec" nouvellement créé.

==== Command ====

Nous allons y ajouter la commande à exécuter pour prendre une photo avec la caméra du Raspberry Pi et la stocker dans un fichier jpg dans le dossier /tmp/ de linux.

<syntaxhighlight lang="python">
raspistill -o /tmp/cam.jpg -w 640 -h 480
</syntaxhighlight>

Nous prenons soin de limiter la hauteur et la largeur de l'image afin de réduire son poids pour l'envoi par email.

[[fichier:Rasp-Node-Red-picam-mail-12.png]]

==== +Append ====

Ensuite, nous allons décocher la case "msg.payload" si elle est cochée par défaut.

[[fichier:Rasp-Node-Red-picam-mail-13.png]]

==== Extra input parameters et Timeout ====

Nous n'aurons pas besoin de compléter ces champs pour notre projet.

Si vous cochez le champ "Use spawn() instead of exec()?", votre commande sera réalisée sous forme d'un processus résident et continuera de s'exécuter jusqu'à ce qu'elle se termine par elle-même (sauf si elle ne se termine jamais).
Cette solution implique que le programme n'attendra pas que cette commande soit réalisée pour passer aux étapes suivantes.
Si la suite de l'exécution de votre flux est susceptible d'utiliser le résultat de cette commande, nous vous déconseillons d'utiliser cette option sous peine de provoquer des erreurs à la suite du traitement du flux.

Le champ "Timeout" permet de définir un temps d'attente maximum avant de mettre un terme à l'exécution de la commande.
Cela permet de débloquer la situation si la commande exécutée prends un temps anormalement long à s'exécuter.

==== Name ====

Nous allons ensuite compléter le champs nom, celui-ci sera utilisé pour nommer le bloc dans le "schéma", mais aussi de nommer les logs comme pour le bloc "Exec".

[[fichier:Rasp-Node-Red-picam-mail-14.png]]

=== Encodage de l'image en base64 ===

Nous allons convertir la photo prise juste avant en utilisant une commande de conversion en base64.
Cela facilitera son injection dans un template HTML que nous allons créer ensuite pour construire un email.

Nous allons tout d'abord cliquer sur le bloc "Exec" dans la section "Advanced" de la colonne de gauche et glisser l'élément dans la zone de travail.

[[fichier:Rasp-Node-Red-picam-mail-10.png]]

Ensuite, cliquer sur le bloc nouvellement créé et configurer celui-ci.

[[fichier:Rasp-Node-Red-picam-mail-11.png]]

Le menu suivant s'affichera, et nous pourrons configurer le bloc "Exec" nouvellement créé.

[[fichier:Rasp-Node-Red-picam-mail-15.png]]

==== Command ====

Nous allons y ajouter la commande à exécuter pour encoder en base 64 la photo prise précédemment avec la caméra du Raspberry Pi.

<syntaxhighlight lang="python">
base64 -i "/tmp/cam.jpg"
</syntaxhighlight>

[[fichier:Rasp-Node-Red-picam-mail-16.png]]

==== +Append ====

Ensuite, nous allons cocher la case "msg.payload" si elle n'est pas cochée par défaut pour que le résultat soit directement renvoyé par cette commande dans le "PayLoad" du flux.

[[fichier:Rasp-Node-Red-picam-mail-17.png]]

==== Extra input parameters et Timeout ====

Nous n'aurons pas besoin de compléter ces champs pour notre projet.

Si vous cochez le champ "Use spawn() instead of exec()?", votre commande sera réalisée sous forme d'un processus résident et continuera de s'exécuter jusqu'à ce qu'elle se termine par elle-même (sauf si elle ne se termine jamais).
Cette solution implique que le programme n'attendra pas que cette commande soit réalisée pour passer aux étapes suivantes.
Si la suite de l'exécution de votre flux est susceptible d'utiliser le résultat de cette commande, nous vous déconseillons d'utiliser cette option sous peine de provoquer des erreurs à la suite du traitement du flux.

[[fichier:Rasp-Node-Red-picam-mail-18.png]]

Le champ "Timeout" permet de définir un temps d'attente maximum avant de mettre un terme à l'exécution de la commande.
Cela permet de débloquer la situation si la commande exécutée prends un temps anormalement long à s'exécuter.

[[fichier:Rasp-Node-Red-picam-mail-19.png]]

==== Name ====

Nous allons ensuite compléter le champs nom, celui-ci sera utilisé pour nommer le bloc dans le "schéma", mais aussi de nommer les logs comme pour le bloc "Exec".

[[fichier:Rasp-Node-Red-picam-mail-20.png]]

=== Création d'un email au format HTML ===

Nous allons maintenant créer un template d'email au format HTML afin de mettre en forme le message que nous enverrons ensuite.
Nous allons pour cela utiliser un bloc "Template".

[[fichier:Rasp-Node-Red-picam-mail-21.png]]

==== Name ====

Nous allons attribuer un nom au bloc afin de l'identifier plus facilement dans le flux.
Nous allons donc le nommer "Contenu du mail" puisque nous créons le contenu du mail que nous enverrons ensuite.

[[fichier:Rasp-Node-Red-picam-mail-22.png]]

==== Set property ====

La propriété que nous souhaitons créer dans le flux est le "PayLoad".
Ce PayLoad existe déjà, il contient pour le moment l'image au format "Base64" précédemment encodé.
Cela n'est pas un problème, après notre noeud (notre bloc), le PayLoad sera intégralement remplacé par le template que nous sommes en train de créer.

[[fichier:Rasp-Node-Red-picam-mail-23.png]]

==== Template ====

Dans ce template, nous allons créer une structure HTML de base minimum afin que la structure soit interprétée par la majorité des clients/webmail.
Vous pouvez la personnaliser à votre guise si vous avez les connaissances en HTML.

Voici la structure de base pour notre projet:

<syntaxhighlight lang="html">
<html>
<head>
<meta charset="utf8"/>
</head>
<body>
<h1>Projet Photo par email</h1>
<img src="data:image/jpg;base64,{{payload}}"/>
</body>
</html>
</syntaxhighlight>

Vous pourrez remarquer que nous intégrons l'image en appelant le PayLoad à 'intérieur du code HTML dans la balise <img>.
C'est le PayLoad créé précédemment par le bloc "Exec" qui est récupéré à ce moment précis.
Ce PayLoad est remplacé dans le flux par le PayLoad complet avec notre template dans le flux par notre bloc Template.

[[fichier:Rasp-Node-Red-picam-mail-24.png]]

=== Création d'un bloc (noeud) "Debug" ===

Nous allons ajouter la notion d'expéditeur dans le flux que nous avons créé à travers nos blocs (noeuds).
Pour rappel, actuellement nous avons deux propriétés avec des données dans notre flux.
Si nous voulons observer ce que nous avons créé jusque là, nous pouvons faire appel à un bloc "Debug".

==== Création du bloc "Debug" ====

Comme pour les blocs précédents, nous allons glisser/déposer un bloc débug dans l'espace de travail.

[[fichier:Rasp-Node-Red-picam-mail-25.png]]

Celui-ci s'appelle msg/payload par défaut

[[fichier:Rasp-Node-Red-picam-mail-26.png]]

Nous allons double-cliquer sur ce bloc pour le configurer.

[[fichier:Rasp-Node-Red-picam-mail-27.png]]

==== Output ====

Dans ce champs, nous allons choisir la partie du flux que nous souhaitons afficher, ou nous allons sélectionner le flux entier.

[[fichier:Rasp-Node-Red-picam-mail-28.png]]

Sélectionner le flux entier, nous affichera le flux complet incluant toutes ses propriétés.

[[fichier:Rasp-Node-Red-picam-mail-29.png]]

==== To =====

La propriété "To" nous permet de choisir ou nous souhaitons afficher les données que nous récupérons.
Soit nous les affichons uniquement dans l'onglet "Debug" à droite de l'espace de travail, soit nous l'affichons dans cet onglet mais aussi dans la console de NodeJS.
Dans notre cas, nous allons nous contenter d'afficher nos éléments dans l'onglet de "Debug" à droite de notre espace de travail.

[[fichier:Rasp-Node-Red-picam-mail-30.png]]

==== Name ====

Le champs Name nous servira à identifier quel bloc de "Debug" affiche les données en console ou dans l'onglet "Debug".
Il faut donc le nommer efficacement pour bien attacher et comprendre les données que nous récupérons, surtout si nous en plaçons plusieurs dans le flux.

[[fichier:Rasp-Node-Red-picam-mail-31.png]]

==== Exploitation et compréhension des données récupérées ====

Nous avons placé notre bloc "Debug" à la suite du flux en dernière position.

[[fichier:Rasp-Node-Red-picam-mail-32.png]]

Nous allons donc déployer le programme en cliquant sur "Deploy" en haut à droite de la page.

[[fichier:Rasp-Node-Red-picam-mail-33.png]]

Ensuite, nous allons exécuter manuellement le programme en cliquant sur le bouton se trouvant en début de chaîne:

[[fichier:Rasp-Node-Red-picam-mail-34.png]]

Nous allons ensuite afficher l'onglet "Debug" sur le coté droit de la page et analyser les données récupérées:

[[fichier:Rasp-Node-Red-picam-mail-35.png]]

==== Analyse des données récupérées dans l'onglet "Debug" ====

<syntaxhighlight lang="bash">

08/05/2017 à 12:54:31node: FORMATAGE
MCHobby - Photo bureau : msg : Object
object
_msgid: "81efe35c.3208d"
topic: "MCHobby - Photo bureau"
payload: "<html>↵ <head>↵ <meta charset="utf8"/>↵ ↵ </head>↵ <body>↵ <h1>MCHobby - Photo bureau</h1>↵ <p>Cette photo est un instantané pris dans les bureaux de MCHobby.</p>↵ <img src="data:image/jpg;base64,/9j/4WP6RXhpZgAATU0AKgAAAAgACgEAAAQAAAABAAACgAEBAAQAAAABAAAB4AEPAAIAAAAMAAAA↵hgEQAAIAAAAKAAAAkgEaAAUAAAABAAAAnAEbAAUAAAABAAAApAEoAAMAAAABAAIAAAEyAAIAAAAU↵AAAArAITAAMAAAABAAEAAIdpAAQAAAABAAAAwAAAA3xSYXNwYmVycnlQaQBSUF9vdjU2NDcAAAAA↵SAAAAAEAAABIAAAAATIwMTc6MDU6MDggMTI6NTQ6MzAAABeCmgAFAAAAAQAAAdqCnQAFAAAAAQAA↵AeKIIgADAAAAAQADAACIJwADAAAAAQD6AACQAAAHAAAABDAyMjCQAwACAAAAFAAAAeqQBAACAAAA↵FAAAAf6RAQAHAAAABAECAwCSAQAKAAAAAQAAAhKSAgAFAAAAAQAAAhqSAwAKAAAAAQAAAiKSBQAF↵AAAAAQAAAiqSBwADAAAAAQACAACSCQADAAAAAQAAAACSCgAFAAAAAQAAAjKSfAAHAAABMAAAAjqg↵AAAHAAAABDAxMDCgAQADAAAAAQABAACgAgAEAAAAAQAAAoCgAwAEAAAAAQAAAeCgBQAEAAAAAQAA↵A2qkAgADAAAAAQAAAACkAwADAAAAAQAAAAAAAAAAAAEPYwAPQkAAAHE4AAAnEDIwMTc6MDU6MDgg↵MTI6NTQ6MzAAMjAxNzowNTowOCAxMjo1NDozMAAAOrTCAA9CQAAAd&#x2..."

</syntaxhighlight>

=== Création d'un expéditeur ===

Nous avons construit petit à petit un message avec un sujet, mais il manque encore un détail: l'expéditeur de l'email que nous allons envoyer.

Voici une méthode pour ajouter cet expéditeur dans le flux.

{{Rasp-Node-Red-TRAILER}}