![]() |
Librairie Arduino esp8266 et esp32 |
Février 2021 |
Si vous n'avez pas déjà utilisé l'une des librairies sai_oled ou menu_oled
il faut directement choisir la
librairie lib_1306_rot qui regroupe
toutes les fonctions des librairies citées
ainsi que des fonctions additionnelles.
Quand on développe sur Arduino où ESP on a souvent besoin de proposer différent choix à l'utilisateur.
Cette librairie est utilisée à plusieurs reprises dans ce site voir les exemples dans le chapitre électronique.
Attention c'est celle-ci
qu'il faut télécharger sur le site "github", elle est différente de celle qui est disponible dans l'environnement "Arduino".
On la reconnait au "w" de Wire qui doit dans notre cas être une majuscule. (Merci à Guy, pour cette précision qui peut éviter pas mal de galère !).
Merci également à tous les contributeurs(46) de ce petit package qui contient plusieurs librairies. Vous devez charger le zip complet comme montré sur
l'image ci-contre.
// Choix selectionnés dans menu
int A_menu;
const int nb_ch_menuA = 5;
const String ch_menuA[] = {"Ouverture / Fermeture", "Param nb tour moteur", "Param date heure", "Param Réseaux", "Param seuil lumiere"};
String _ch_menuA = * ch_menuA;
int B_menu;
const int nb_ch_menuB = 2;
const String ch_menuB[] = {"Vérif. Date Heure", "Retour"};
String _ch_menuB = * ch_menuB;
int C_menu;
const int nb_ch_menuC = 5;
const String ch_menuC[] = {"Temps par tour", "Nb tour ouvre", "Test ouvre", "Nb tour ferme", "Test ferme"};
String _ch_menuC = * ch_menuC;
int D_menu;
const int nb_ch_menuD = 5;
const String ch_menuD[] = {"Login Wifi", "Adresse IP mosquitto", "Login mosquitto", "Passe mosquitto", "Aff. param Wifi"};
String _ch_menuD = * ch_menuD;
switch (A_menu){ // Menu général
case 0 : // Saisie du nom
// Traitement choix 1
break;
case 1 : // Saisie du prénom
// Traitement choix 2
break;
case 2 : // Affichage du nom et du prénom
// Traitement choix 3
break;
}
L'encodeur rotatif est disponible en brut ou sur plaquette qui doit inclure 3 résistances de rappel au + (positif).
Différents Encodeurs rotatifs sont supportés mais l'objet a été créée avec un KY-040 30 pas.
Cette librairie a été développée avec un encodeur qui comporte bien une résistance de rappel au positif sur les trois signaux. Il existe cependant sur le marché des
encodeurs sur plaquette ou la résistance sur le signal "SW" n'a pas été installée, pour fonctionner avec cette librairie cette résistance doit être ajoutée.
Voir ici en bas de page.
Si vous utilisez un encodeur brut (sans pré câblage sur une plaquette)
vous devez réaliser le câblage des résistance comme sur le schéma ci-contre.
Dans cette version le LCD et l'encodeur sont directement connectés au microprocesseur. Sur ce schéma j'ai repris les numéros de port de l'exemple
si vous utilisez un autre processeur, vous devez adapter les numéros de port et utiliser dans votre code les numéros correspondants.
Je vous livre ici le code complet en "Open Source".
Si vous utilisez ce code, merci de mettre un lien vers ce site : https://castoo.fr
// menu_oled.h
// Affiche un menu sur LCD Oled 1306
// Affichage/Saisie depuis le menu et retourne le choix de l'utilisateur
// Castoo
// Décembre 2019
/*
menu_oled.h
- Objet destiné à être utilisé avec Arduino ou ESPxxx.
Possibilité de supporter différents LCD mais l'objet a été créée avec un OLED SD1306
Possibilité de supporter différents Encodeurs rotatifs mais l'objet a été créée avec un KY-040 30 pas
Création Jean Michel Castille décembre 2019 / castoo.fr
Cette bibliothèque est un logiciel libre;
Vous pouvez la redistribuer et ou la modifier.
Cette bibliothèque est distribuée dans l'espoir qu'elle sera utile,
mais SANS AUCUNE GARANTIE, sans même la garantie implicite de
QUALITÉ MARCHANDE ou ADÉQUATION À UN USAGE PARTICULIER.
*/
#ifndef menu_oled_h
#define menu_oled_h
#include
#include "SSD1306Wire.h"
class menu_oled{
private:
SSD1306Wire *_ecran; // Ecran OLED
uint8_t PinCLK; // Gpio x sur sortie Clk du selecteur rotatif
uint8_t PinDT; // Gpio x sur sortie DT du selecteur rotatif
uint8_t PinSW; // Gpio x sur sortie SW du selecteur rotatif
int max_ch; // Nb max de chaine du menu
String * _ch_menu; // Pointeur sur tableau des chaines
public:
// Constructeur permet de passer les cnx du bouton de commande et le nom du LCD
menu_oled(uint8_t vclk, uint8_t vdt, uint8_t vsw, SSD1306Wire &ecran);
// Initialisation du menu permet de passer le nb de choix et un tableau des chaines de choix
uint8_t init(int nb_ch_menu, String &ch_menu);
private:
// Affichage du menu A
void aff_menu(int pos);
// Selection dans le menu A à l'aide selecteur rotatif
uint8_t sel_menu(int max);
};
#endif
// menu_oled.cpp
// Affiche un menu sur LCD Oled 1306
// Affichage/Saisie depuis le menu et retourne le choix de l'utilisateur
// Castoo
// Décembre 2019
/*
menu_oled.cpp
- Objet destiné à être utilisé avec Arduino ou ESPxxx.
Possibilité de supporter différents LCD mais l'objet a été créée avec un OLED SD1306
Possibilité de supporter différents Encodeurs rotatifs mais l'objet a été créée avec un KY-040 30 pas
Création Jean Michel Castille décembre 2019 / castoo.fr
Cette bibliothèque est un logiciel libre;
Vous pouvez la redistribuer et ou la modifier.
Cette bibliothèque est distribuée dans l'espoir qu'elle sera utile,
mais SANS AUCUNE GARANTIE, sans même la garantie implicite de
QUALITÉ MARCHANDE ou ADÉQUATION À UN USAGE PARTICULIER.
*/
#include "menu_oled.h"
// Constructeur permet de passer les cnx du bouton de commande et le nom du LCD
menu_oled::menu_oled(uint8_t vclk, uint8_t vdt, uint8_t vsw, SSD1306Wire &ecran){
this->PinCLK = vclk; pinMode (this->PinCLK, INPUT); // Clk du selecteur rotatif
this->PinDT = vdt; pinMode (this->PinDT, INPUT); // DT du selecteur rotatif
this->PinSW = vsw; pinMode (this->PinSW, INPUT); // SW du selecteur rotatif
this->_ecran = &ecran; // Ecran OLED
}
// Initialisation du menu permet de passer le nb de choix et un tableau des chaines de choix
uint8_t menu_oled::init(int nb_ch_menu, String &ch_menu){
this->_ecran->flipScreenVertically();
this->_ecran->setFont(ArialMT_Plain_10);
this->_ecran->setTextAlignment(TEXT_ALIGN_LEFT);
this->max_ch = nb_ch_menu;
this->_ch_menu = &ch_menu;
return this->sel_menu(this->max_ch);
}
// Affichage du menu et encadrement de la valeur en cours de selection
void menu_oled::aff_menu(int pos){
this->_ecran->clear();
for (uint8_t i = 0; i < this->max_ch; i++) this->_ecran->drawString(0, (12*i), this->_ch_menu[i+1]);
this->_ecran->drawRect(0, (12*pos), (this->_ch_menu[pos+1].length()*5)+2, 13);
this->_ecran->display();
}
// Selection dans le menu à l'aide du selecteur rotatif
uint8_t menu_oled::sel_menu(int max){
max--;
bool B_val = false, val_clk = true, memo_clk = true;
int B_choix = 0;
this->aff_menu(B_choix);
while (! B_val){
val_clk = digitalRead(PinCLK);
if (val_clk != memo_clk){
if (digitalRead(PinDT) != val_clk) { B_choix++; if (B_choix > max) B_choix = max;}
else { B_choix--; if (B_choix < 0) B_choix = 0;}
this->aff_menu(B_choix); delay(10);
}
if (!(digitalRead(PinSW))) { B_val = true; } // Bouton validation
memo_clk = val_clk; delay(5);
}
this->aff_menu(B_choix);
return B_choix;
}
Le fichier d'exemple d'utilisation des deux objets (mais chacun peut bien sûr être utilisé seul dans vos montage).
Ne pas oublier de personnaliser les PIN GPio en fonction du circuit sur lequel vous désirez tester l'exemple !
// test_obj_saioled.ino
// Test des objets sai_oled et menu_oled
// Castoo https://castoo.fr
// Décembre 2019
#include "SSD1306Wire.h"
#include "sai_oled.h"
#include "menu_oled.h"
// l'adresse I2C (ici 0x3C) peut être différente en fonction du module utilisé
//SSD1306Wire display(0x3c, 4, 5); // I2C sur un esp8266 donc gpio 4 > SDA & gpio 5 > SCL
SSD1306Wire display(0x3c, 15, 14); // I2C sur un esp8266 donc gpio 4 > SDA & gpio 5 > SCL
// Pour initialiser les objets sai_oled et menu_oled il faut passer les sorties Gpio utilisées pour le bouton rotatif
// Il est également necessaire de preciser le nom de l'objet écran utilisé (celui-ci peut facilement être modifié)
//sai_oled mon_sai_oled(16, 13, 0, display); // init saisie (Gpio vclk, Gpio vdt, Gpio vsw et nom de l'objet LCD)
sai_oled mon_sai_oled(3, 13, 1, display); // init saisie (Gpio vclk, Gpio vdt, Gpio vsw et nom de l'objet LCD)
//menu_oled mes_menus_oled(16, 13, 0, display); // init saisie (Gpio vclk, Gpio vdt, Gpio vsw et nom de l'objet LCD)
menu_oled mes_menus_oled(3, 13, 1, display); // init saisie (Gpio vclk, Gpio vdt, Gpio vsw et nom de l'objet LCD)
//uint8_t PinSW = 0; // Gpio x sur sortie SW du selecteur rotatif sera utilisée pour valider les delais d'attente
uint8_t PinSW = 1; // Gpio x sur sortie SW du selecteur rotatif sera utilisée pour valider les delais d'attente
int B_menu; // Choix selectionné dans menu
const int nb_ch_menuA = 3; // choix du menu Principal
const String ch_menuA[] = {"Saisir votre nom", "Saisir votre prénom", "Afficher Nom Prénom"};
String _ch_menuA = * ch_menuA;
String nom = "";
String prenom = "";
String ch_result = "";
// Initialisation
void setup() {
pinMode(PinSW, INPUT); // Sortie SW du selecteur rotatif
// Init OLED
display.init();
display.flipScreenVertically();
display.setFont(ArialMT_Plain_24);
display.setTextAlignment(TEXT_ALIGN_CENTER);
display.clear();
// Init des objets sai_oled
mon_sai_oled.init(); // Initialisation ecran pour saisie OLED
mon_sai_oled.sortie_deb(false); // Invalide sortie balayage aprés chaque saisie (+ rapide mais perso, j'aime pas !) à tester à true...
}
// Boucle principale
void loop(){
delay(200);
B_menu = 0;
B_menu = mes_menus_oled.init(nb_ch_menuA, _ch_menuA);
delay(300);
if (B_menu == 0) {
// Saisie du nom
mon_sai_oled.init(); // Initialisation ecran OLED pour saisie
nom = mon_sai_oled.aff_menu_Alpha(); // On lance la saisie
}
else if (B_menu == 1) {
// Saisie du prénom
mon_sai_oled.init(); // Initialisation ecran OLED pour saisie
prenom = mon_sai_oled.aff_menu_Alpha(); // On lance la saisie
}
else if (B_menu == 2) {
// Affichage du nom et du prénom
delay(200); // Anti rebond bouton
ch_result = nom + " " + prenom;
if(ch_result == " ") ch_result = "Vous devez faire une saisie !";
display.setFont(ArialMT_Plain_10);
display.setTextAlignment(TEXT_ALIGN_CENTER);
display.clear();
display.drawString(64, 25, ch_result);
display.display();
while(digitalRead(PinSW)){delay(10);} // On attend que le bouton soit pressé pour sortir de l'affichage
delay(400);
}
}