[Mise à jour le 7/7/2021]

• MKR FAMILY
• Getting started with the MKR WiFi 1010

• Wiki matériels - "Capteurs, afficheurs, préactionneurs, etc."
• Wiki Arduino - "Mettre en oeuvre un client MQTT sur un EP8266 (ESP32) Feather Huzzah ou Wifi MKR1010"
• Arduino Library List

• Mouser

La gamme MKR est une référence dans le domaine des cartes de développement IoT. Elle regroupe plusieurs cartes dont le tarif varie entre 20 et 60 euros (2019).

Toutes les cartes de la gamme MKR possèdent le même nombre d'E/S. Elles sont fournies avec un total de 22 broches d'E/S numérique dont 12 broches PWM. Elles comprennent également 7 broches d'entrée analogique et 1 broche de sortie analogique.

Il existe plusieurs shields MKR, par exemple le blindage MKR Relay Proto Shield qui permet d’utiliser des relais et qui fournit de l'espace pour ajouter d'autres composants grâce à sa zone de prototypage.

Bien qu'elles ne soient pas compatibles avec les shields Arduino Uno, il est possible de connecter facilement des capteurs aux cartes MKR à l'aide de l'adaptateur Arduino MKR Connector Carrier (Grove compatible). [Schéma]

Le MKR WIFI 1010 est équipé d'un module ESP32 fabriqué par U-BLOX. Cette carte a pour objectif d’accélérer et de simplifier le prototypage des applications IoT basées sur le WiFi grâce à la flexibilité du module ESP32 et à sa faible consommation d’énergie. La carte est composée de trois principaux blocs :

• Microcontrôleur SAMD21 Cortex-M0+ 32bit Low Power ARM MCU (Datasheet)
• U-BLOX NINA-W10 Series Low Power 2.4GHz IEEE® 802.11 b/g/n Wi-Fi (Datasheet)
• ECC508 Crypto Authentication. (Datasheet)

• Principales caractéristiques
  • Alimentation de la carte : 5V (circuit sous 3,3V)
  • Batterie supportée : Li-Po Single Cell, 3.7V, 700mAh Minimum
  • E/S numériques : 8 (7mA)
  • PWM : 2 (0, 1, 2, 3, 4, 5, 6, 7, 8, 10, A3 - or 18 -, A4 -or 19)
  • UART : 1
  • SPI : 1
  • I2C : 1
  • I2S : 1
  • Réseau : Wifi (sécurisé à l'aide du cryptage SHA-256)
  • Entrées analogiques : 7 (ADC 8/10/12 bit)
  • Sortie analogique : 1 (DAC 10bits)
  • Interruptions externes : 8 (0, 1, 4, 5, 6, 7, 8, A1 -or 16-, A2 - or 17)
  • Flash : 256KB
  • SRAM : 32KB
  • EEPROM : Non
  • Fréquence d'horloge : 48MHz, 32.768 kHz (RTC)

• Dans le menu « Outils » , « Type de carte » et « Gestionnaire de carte », rechercher « Arduino SAMD Board » et installer le composant.

A partir du gestionnaire de bibliothèque de l'IDE Arduino, télécharger et installer :

• Sources sur github
• Documentation sur arduino.cc

Active la connexion réseau (locale et Internet) des Arduino MKR Wifi 1010, Arduino MKR VIDOR 4000 et Arduino UNO Wifi Rev.2. Avec cette bibliothèque, vous pouvez instancier des serveurs, des clients et envoyer / recevoir des paquets UDP via le wifi. La carte peut se connecter à des réseaux ouverts ou cryptés (WEP, WPA). L'adresse IP peut être attribuée de manière statique ou via un serveur DHCP. La bibliothèque peut aussi gérer le DNS.

• Mise à jour du firmware du module WIFI NINA
  1. Mettre à jour la bibliothèque WiFiNINA avec le gestionnaire de bibliothèques.
  2. Vérifier la version du firmware installé en téléchargeant et en exécutant l'exemple CheckFirmwareVersion (→ Fichier → Exemples → WiFiNINA → Tools). Les informations apparaissent dans le moniteur série.
  3. Télécharger et exécuter l'exemple FirmwareUpdater dans la carte (→ Fichier → Exemples → WiFiNINA → Tools) puis mettre à jour le firmware à l'aide de WIFI101/WiFiNINA Firmware Updater (→ Outils).

• Sources et documentation de Nick O'Leary sur github

Cette bibliothèque fournit un client pour faire de simples messages de publication / abonnement avec un serveur prenant en charge MQTT.

• Sources sur github

WifiWebServer est une bibliothèque serveur simple mais complète pour les cartes AVR, Teensy, SAM DUE, Arduino SAMD21, Adafruit SAMD21/SAMD51, Adafruit nRF52, ESP32/ESP8266, STM32F/L/H/G/WB/MP1, etc., utilisant les modules/boucliers WiFi (WiFiNINA, WiFi101, U-Blox W101, W102, ESP8266/ESP32-AT, etc.).
Les fonctions sont similaires et compatibles à celles de ESP32 WebServer et des ESP8266WebServer.
A partir de la v1.1.0 cette bibliothèque fournit également un client HTTP et WebSocket de haut niveau dont les fonctions sont similaires et compatibles à celles de la bibliothèque ArduinoHttpClient.

*.cpp

void setup() {
  pinMode(LED_BUILTIN,OUTPUT);
}
 
void loop() {
  digitalWrite(LED_BUILTIN, HIGH);   
  delay(1000);                   
  digitalWrite(LED_BUILTIN, LOW);    
  delay(1000);                    
}

• WiFiPing (→ Fichier → Exemples → WiFiNINA)

*.cpp

// Modifications dans WiFiPing
// Specify IP address or hostname 
String hostName = "192.168.200.1"; // Adresse de la box
 
// Modifications dans arduino_secrets.h
#define SECRET_SSID "à renseigner"
#define SECRET_PASS "à renseigner"

• Résultat dans le moniteur série

• Ressource : ESP32 HTTP GET and HTTP POST with Arduino IDE (JSON, URL Encoded, Text)

• Version 1 : étude de cas
  • Source : SimpleWebServer (→ Fichier → Exemples → WiFiNINA)
  • Montage
  • Algorithme

// Principe
// Le serveur lit les requêtes caractère par caractère et extrait les données de l'url 
// En réponse à la requête, il envoie une valeur ou/et déclenche une commande 
// Exemples
// pas de données dans la requête => envoie de la page d'accueil
// /arduino/digital/led/1 => activation d'une sortie
// /arduino/digital/led/0 => désactivation d'une sortie
// /arduino/analog/val1 => mesure et envoie d'une valeur issue du CAN

// Initialisation
Créer un serveur HTTP à l'écoute sur le port 80

1.  si le module wifi n'est pas détecté alors 
        bloquer le programme
2.  tant que le module n'est pas connecté au wifi faire
        se connecter au wifi avec le SSID et le mot2passe
    fin tant que
3. Démarrer le serveur

// Programme
Répéter toujours
 début // 4. Traiter les requêtes
    Attente blocante d'un client
    si un client est connecté alors
     |  currentLine <- "" // mémorise la donnée transmise dans la requête
     |  tant que le client est connecté faire
     |    | si il reste des caractères à lire 
     |    | alors  
     |    |  |  lire le dernier caractère transmis
     |    |  |  si ce caractère est une fin de ligne 
     |    |  |  alors
     |    |  |   | si currentLine = "" // on a eu 2 fin de lignes consécutifs ! => pas de donnée transmise
     |    |  |   | alors 
     |    |  |   |    Envoyer la page d'accueil au client et sortir de la boucle tant que
     |    |  |   | sinon
     |    |  |   |    currentLine <- ""
     |    |  |   | fin si
     |    |  |  sinon 
     |    |  |   | si le caractère lu n'est pas un retour chariot 
     |    |  |   | alors 
     |    |  |   |    on l'ajoute à la fin de currentLine
     |    |  |   | fin si
     |    |  |  fin si
     |    |  |  // Traitement les autres requête(s) (une url suit l'@IP)
     |    |  |  Traiter la requête 1 et sortir de la boucle tant que
     |    |  |  Traiter la requête 2 et sortir de la boucle tant que 
     |    |  |  ...    
     |    |  |  Traiter la requête n et sortir de la boucle tant que     
     |    | fin si
     |  fin tant que
    fin si
    Fermer la connexion
 fin

• Code (adaptation de l'exemple SimpleWebServer)

*.cpp

/* ------------------------------------------------------------------- 
Titre: Serveur HTTP
Objectifs: commander la led L et la sortie 0 de la carte MKR Wifi 1010, 
  et obtenir la valeur présente sur l'entrée I0 à partir d'un navigateur
  (requêtes GET et cryptage WPA).
Commandes reconnues:
  http://@IP renvoie "La page d'accueil"
  http://@IP/arduino/digital/led/0 active la LED et D0
  http://@IP/arduino/digital/led/1 désactive la LED et D0
  http://@IP/arduino/analog/val1 demande la valeur sur A0
Carte arduino:
  Module NINA (Arduino MKR WiFi 1010, MKR VIDOR 4000 et UNO WiFi Rev.2)
-----------------------------------------------------------------------*/
// Définitions
#define LED LED_BUILTIN //  LED_BUILTIN (L sur la carte !)
#define D0 0
 
// Bibliothèques
#include <SPI.h>
#include <WiFiNINA.h>
 
// Paramètres réseau, cryptage WPA
const char ssid[] = "SynBoxLAN";   // nom du SSID
const char pass[] = "Tektronix18"; // mot de passe du réseau
 
// Page d'accueil
const char paccueil[] = "<html><head><meta charset=\"utf-8\">"
"<title>Serveur MKR Wifi 1010</title>"
"<style>"
".ip{color:blue;}</style>"
"</head><body>"
"<h3>Page d\'accueil du serveur sur MKR Wifi 1010</h3>"
"<strong>Commandes reconnues:</strong><br>"
"- http://@IP<span class=\"ip\">/arduino/digital/led/1</span> active la LED L et la sortie D0<br>"
"- http://@IP<span class=\"ip\">/arduino/digital/led/0</span> désactive la LED L et la sortie D0<br>"
"- http://@IP<span class=\"ip\">/arduino/analog/val1</span> renvoie la valeur sur l'entrée A0<br>"
"</body></html>";
 
// Client
WiFiClient client;
 
// Fonctions
void reponse(String message)
{
  client.println("HTTP/1.1 200 OK");
  client.println("Content-type:text/html");
  client.println();
  client.println(message);
  client.println();
}
 
// Initialisations
// -------------------------------------------------------------------
int status = WL_IDLE_STATUS;
// Création du serveur, écoute sur le port 80
WiFiServer server(80);
 
void setup()
{
  // Configuration des E/S
  pinMode(LED, OUTPUT); // Led L de la carte
  pinMode(D0, OUTPUT);
  Serial.begin(115200); // Moniteur pour la mise au point
 
  // 1. Vérification de la connexion au module Wifi
  if (WiFi.status() == WL_NO_MODULE)
  {
    Serial.println(" La communication avec le module WiFi a échoué!");
    // Blocage du programme !!!!
    while (true)
      ;
  }
 
  // 2. Connexion au réseau Wifi
  while (status != WL_CONNECTED)
  {
    Serial.print("Tentative de connexion au réseau: ");
    Serial.println(ssid);
    status = WiFi.begin(ssid, pass); // si WPA, WPA2
    // Attente de 10s avant la prochaine tentative de connexion
    delay(10000);
  }
 
  // 3. Connecté, alors démarrage du serveur Web sur le port défini
  // lors de l'initialisation
  server.begin();
}
// -------------------------------------------------------------------
void loop()
{                              // 4. Traiter les requêtes
  client = server.available(); // A l'écoute (blocante) d'un client
 
  if (client)
  { // Client connecté !
    Serial.println("Nouveau client !!!");
    String currentLine = ""; // Création d'une chaîne pour mémoriser
                             // les données transmises par le client
    while (client.connected())
    {
      if (client.available())
      {                         // Si il y a des octets à lire
        char c = client.read(); // on les lit !!!!
        if (c == '\n') // si le dernier caractère lu est une fin de ligne
        { 
          if (currentLine.length() == 0) // si la ligne est vide
          { // c'est la fin de la requête HTTP du client, alors on envoie la page d'accueil:
            // REMARQUE : les en-têtes HTTP commencent toujours par un code de réponse
            // (par exemple HTTP / 1.1 200 OK)
            // et un type de contenu pour que le client sache ce qui lui est envoyé, puis une ligne vide :
            client.println("HTTP/1.1 200 OK");
            client.println("Content-type:text/html");
            client.println();
            client.println(paccueil);
            client.println();
            // On sort de la boucle while après avoir envoyé la réponse
            break;
          }
          else
          { // si nouvelle ligne, on vide currentLine:
            currentLine = "";
          }
        }
        else if (c != '\r') // si le dernier caractère lu n'est pas un retour chariot,
        {
          currentLine += c; // on l'ajoute à la fin de currentLine
        }
        // Traitement des requêtes (commence par GET)
        // ----------------------------------------------------
        // Requête 1
        if (currentLine.endsWith("GET /arduino/digital/led/1"))
        {
          digitalWrite(LED, HIGH); // Activation de la commande de la LED
          digitalWrite(D0, HIGH);  // et de la sortie D0
          reponse(String("1"));
          // On sort de la boucle while après avoir envoyé la réponse
          break;
        }
        // Requête 2
        if (currentLine.endsWith("GET /arduino/digital/led/0"))
        {
          digitalWrite(LED, LOW); // Désactivation de la commande de la LED
          digitalWrite(D0, LOW);  // et de la sortie D0
          reponse(String("0"));
          // On sort de la boucle while après avoir envoyé la réponse
          break;
        }
        // Requête 3
        if (currentLine.endsWith("GET /arduino/analog/val1"))
        {
          unsigned int val1 = analogRead(0);
          reponse(String(val1));
          // On sort de la boucle while après avoir envoyé la réponse
          break;
        }
        // Fin traitement des requêtes
        // ----------------------------------------------------
      } // fin si octets à lire
    } // fin tant que
    // Fermeture de la connection
    client.stop();
    Serial.println("Client déconnecté");
  }
}

• Tests

• Version 2 : utilisé en projet
  • Source : SimpleWebServer (→ Fichier → Exemples → WiFiNINA)
  • Montage
  • Algorithme

• Code

*.cpp

• Tests

• Voir la page "Mettre en oeuvre un client MQTT sur un EP8266 (ESP32) Feather Huzzah ou Wifi MKR1010"

Des liens vers des tutoriels sont accessibles sur la page webographie.