knowledge - Contributions [fr]

ESP32C3 avec écran spotear

2026-05-13T20:05:30Z

Jpinon : /* La "default font" */

Appelé en français "Mini ornement de Bureau" voici le module ESP32 C3 équipé de son écran. Personnellement c'est mon premier C3 donc mes débuts en RISC-V. Bon tant que je fais du C avec l'IDE Arduino ca devrait pas trop se voir.
[[Fichier:ESC32C3-desktop-gadget.png|vignette|220x220px]]

== Premier contact ==
Apres avoir joué au petit mécano pour monter le bidule. On le branche sur une alim USB (micro USB le design ne date pas d'hier).

On le branche et il affiche un message (assez moche en vérité) indiquant de configurer son "mobile WLAN" avec les paramètres :

SSID : spotpear (c'est le fabricant)

WIFI Key : 12345678

On peut pas plus sûr comme mot de passe !

Le message du dessous me parait me parait assez ésotérique. Ca sent la traduction du chinois fait pas une IA poussive.
[[Fichier:ESC32C3-desktop-gadget+wifi.png|gauche|vignette|215x215px]]
Je configure un routeur avec ces paramètres et je rebranche le bigonx.

Une belle barre de progression s'affiche et ensuite un superbe écran!

Que c'est beau!

A première vue:

* L'écran est très correct. Lumineux et lisible.
* <u>Pour le mini firmware:</u>

* L'heure locale est juste. Il sait se mètre à l'heure et détecte correctement le fuseau horaire et l'heure été/hiver

* La date est bonne
* La localisation à Clichy est fausse (on est a Paris aujourd'hui)
* La température semble correcte le service météo est juste en revanche le fait d'afficher en °F alors qu'on est a Clichy...Bof bof.
* La météo est correcte (il pleut, il pleut en ce mois de mars 2026)

Le barre de progression du wifi étant verte et le symbole "Temp" en bleu je suppose que cet écran est RGB. (Chercher le rouge)

== Recherche de documentation ==
Le bidule acheté 9€ sur Aliexpress est livré avec.... 8 entretoises 8 vis une façade trouée pour l'écran et un bout de plastique noir pour le fond. Mais .... Aucune doc.

Pas grave y'a Google et Gemini.

J'ai trouvé :

https://www.elektroda.com/news/news4091334.html où un certain p.kaczmarek2 détaille tout le processus d'utilisation.

Dedans j'ai trouvé le schéma électronique.

[[Fichier:SCHEMA ELEC SPOTEAR.png|sans_cadre|836x836px]]

https://spotpear.com/wiki/ESP32-C3-desktop-trinket-Mini-TV-Portable-Pendant-LVGL-1.44inch-LCD-ST7735.html le site du fabricant.

== Niveau Hardware ==
La carte est assez simple on y trouve :

* Le joli écran de 1,44<nowiki>'' de 128x128 pixel (on est loin du 300 ppp) utilisé en SPI (peut être possible en I2C). Pour les personnes normales utilisant le système métrique (le monde entier sauf les USA, le Libéria et la Birmanie je crois) 1.44'' ca fait 36,6 mm. La taille doit venir de ces unités exotiques où un pouce est divisé en 144 points. Je sais pas j'ai pas l'</nowiki>habitude... Doit y avoir une logique.
* Une prise pour une batterie et un circuit de charge PL4054
* Un régulateur linéaire pour faire du 3.3 V CAT 6219 qui m'a pas l'aire d'être tout jeune
* Un quartz 40 MHz
* Une petite mémoire flash de 128 Mbits (16b Mo) W25q128
* 4 boutons poussoirs
** RESET (ou plutôt CHIP_EN) avec son petit circuit de reset automatique
** Un bouton BOOT cablé sur IO09
** Deux boutons (actifs bas) sur IO8 et I010
* Une led sur IO11
* Une LED qui, si je comprends le schéma électronique s'allume quand le batterie se charge
* Le port USB est relié au ESP32C3 qui doit savoir le gérer en natif (pas de FTDI ou autre)
* 5 GPIO accessibles sur 6 broches
** GPIO1
** GPIO6
** GPIO7
** GPIO20
** GPIO21
* Une broches de masse (coté GPIO)
* Une broche +5V et une +3.3V autour du port µUSB

== Niveau developpement ==
Il faut installer un environnement correct. [[Poste de DEV ESP32 sur PI|C'est détaillé ici]]. Avec un premier "hello world" qui fait clignoter une LED.

=== Utiliser l'écran ===
J'ai eu pas mal de problèmes pour utiliser l'écran. Beaucoup de tutos (et aussi copilot) conseillent d'utiliser la librairie '''TFT_eSPI''' mais je ne suis pas arrivé à l'utiliser correctement.

D'autre part le branchement de l'écran n'est pas standard.

==== Brochage ====
Dans le schéma de principe donné sur le site de p.kaczmarek2 on voit plusieurs choses.

[[Fichier:ST7735 PINOUT.png|sans_cadre|429x429px]]

Le pinout n'est pas standard le 'backlight" n'est pas réglable. Les LEDs de rétroéclairage sont alimentées en permanence à travers R11.

En plus sur ce schéma les broches sont nommées SDA, SCL... alors que c'est du SPI et pas ce I<sub>2</sub>C.

Donc le fichier de définition est :<syntaxhighlight lang="c">
// Pinout du module Mini-TV ESP32-C3
#define SD_CS 5
#define TFT_CS 2
#define TFT_DC 0
#define TFT_RST 5
#define MOSI_PIN 4
#define SCK_PIN 3
</syntaxhighlight>Mon fichier User_Setup.h complet est:<syntaxhighlight lang="c">
#define USER_SETUP_ID 44

#define ST7735_DRIVER
#define TFT_WIDTH 128
#define TFT_HEIGHT 128

// Pinout du module Mini-TV ESP32-C3
#define SD_CS 5
#define TFT_CS 2
#define TFT_DC 0
#define TFT_RST 5
#define MOSI_PIN 4
#define SCK_PIN 3

#define LED_PIN 11 // GPIO11 sur ESP32-C3
#define SWITCH_0 8 // GPIO08 sur ESP32-C3
#define SWITCH_1 10 // GPIO10 sur ESP32-C3

#define TFT_RGB_ORDER TFT_BGR
#define TFT_INVERSION_ON
#define TFT_ROTATION 1

#define SPI_FREQUENCY 27000000
</syntaxhighlight>

==== Librairie Adafruit ====
Donc la librairies '''TFT_eSPI''' ne marche pas avec cet écran (ou je ne suis pas arrivé à la faire marcher) j'ai utilisé '''Adafruit_ST7735''' qui fonctionne très bien ([https://www.adafruit.com/ merci Lady Ada]).

Associée à la librairies GFX du même Adafruit on a un joli environnement pour faire des dessins sur l'écran.

On déclare la librairie dans platformio.ini :<syntaxhighlight lang="ini">
[env:adafruit_qtpy_esp32c3]
platform = espressif32
board = adafruit_qtpy_esp32c3
framework = arduino

lib_deps =
adafruit/Adafruit ST7735 and ST7789 Library
adafruit/Adafruit GFX Library

build_flags =
-DUSER_SETUP_LOADED=1
-include src/User_Setup.h

monitor_speed = 115200
upload_speed = 921600
</syntaxhighlight>On remarque l'inclusion du User_Setup.h montré ci dessus.

Et dans le code source on ajoute:<syntaxhighlight lang="c">
#include <Adafruit_GFX.h>
#include <Adafruit_ST7735.h>
</syntaxhighlight>On déclare un objet Adafruit_ST7735 avec les broches données ci dessus.<syntaxhighlight lang="c">
Adafruit_ST7735 tft = Adafruit_ST7735(TFT_CS, TFT_DC, MOSI_PIN, SCK_PIN, TFT_RST);

</syntaxhighlight>et on l'initialise dans <code>setup()</code> :<syntaxhighlight lang="c">tft.initR(INITR_144GREENTAB);
tft.setRotation(3);
tft.fillScreen(ST77XX_BLACK); // Fill the screen with black color
delay(100);
tft.setRotation(2);</syntaxhighlight>Ici y'a deux remarques:

* La constante INITR_144GREENTAB est à utiliser car le standard INITR_BLACKTAB est en mode RGB alors que notre écran est BGR (pourquoi ... pour faire genre je suppose).
* Ensuite, lors du premier démarrage le tft.fillScreen(ST77XX_BLACK); "oublie" quelques lignes de pixels a droite et, pour éviter ce probléme je remplis deux fois en tournant virtuellement l'écran. Il y a peut-etre une conf qui m'échappe...

===== La "default font" =====
Lorsque l'on choisit la fonte par défaut (on qu'on ne choisit rien) :<syntaxhighlight lang="c++">
tft.setFont(); // Si une fonte avait été selectionnée avant. On reviens à la 7x5 par défaut
</syntaxhighlight>C'est une police de base 5x7 mais elle va plus loin que l'ASCII standard.

* On a des caractères valides avant 32
* On a des caractères étendus après 127

Le fichier qui le décrit s'appelle <code>glcdfont.c</code> et, dans un projet Visual Studio Code est situé : <code>.pio/libdeps/adafruit_qtpy_esp32c3/Adafruit GFX Library/glcdfont.c</code>

La structure est simple chaque caractère est codé 5 octset représentant les 5 colonnes de bits.

Apres un programme en C++ pour comprendre et un programme en python pour représenter je suis arrivé à :
[[Fichier:AdafruitGFX 5x7 font.png|sans_cadre|645x645px]]

Bon le 5x7 c'est moche mais sur un écran 128x128 ca permet d'afficher 16 lignes de 21 caractères (un peu moins que le 176 × 184 du vic 20)

==== Exemple complet ====
Un programe démo complet est donné ici.

C'est un "LED Blink" amélioré.

Il fait clignoter la LED sur GPIO11 au rythme de une fois par seconde (1000 ms) ajustable.

L'écran affichera:

[[Fichier:Luxury blink.png|sans_cadre]]

On a en vert le période de "blink" et en blanc sur fond bleu le temps depuis le boot du device HH:MM:SS.

Un petit bandeau bleu a gauche indique que les boutons "+" et "-" permettent d'ajouter ou de retirer 10 ms à la période.

RST est également affiché a côté du bouton reset.

Le projet est constitué de 3 fichiers :

===== platformio.ini =====
<syntaxhighlight lang="ini">[env:adafruit_qtpy_esp32c3]
platform = espressif32
board = adafruit_qtpy_esp32c3
framework = arduino

lib_deps =
adafruit/Adafruit ST7735 and ST7789 Library
adafruit/Adafruit GFX Library

build_flags =
-DUSER_SETUP_LOADED=1
-include src/User_Setup.h

monitor_speed = 115200
upload_speed = 921600</syntaxhighlight>

===== User_Setup.h =====
<syntaxhighlight lang="c">
#define USER_SETUP_ID 44

#define ST7735_DRIVER
#define TFT_WIDTH 128
#define TFT_HEIGHT 128

// Pinout du module Mini-TV ESP32-C3
#define SD_CS 5
#define TFT_CS 2
#define TFT_DC 0
#define TFT_RST 5
#define MOSI_PIN 4
#define SCK_PIN 3

#define LED_PIN 11 // GPIO11 sur ESP32-C3
#define SWITCH_0 8 // GPIO08 sur ESP32-C3
#define SWITCH_1 10 // GPIO10 sur ESP32-C3

#define TFT_RGB_ORDER TFT_BGR
#define TFT_INVERSION_ON
#define TFT_ROTATION 1

#define SPI_FREQUENCY 27000000

</syntaxhighlight>

===== main.cpp =====
<syntaxhighlight lang="c++">
#include <Arduino.h>
#include <Adafruit_GFX.h>
#include <Adafruit_ST7735.h>
#include <Fonts/FreeSans9pt7b.h>
#include <Fonts/FreeSans12pt7b.h>

Adafruit_ST7735 tft = Adafruit_ST7735(TFT_CS, TFT_DC, MOSI_PIN, SCK_PIN, TFT_RST);

int periode = 1000;

void display(){
tft.fillScreen(tft.color565(128, 128, 128)); // Fill the screen with black color
tft.setCursor(20, 15); // Set cursor at the top-left corner
tft.setTextColor(ST77XX_WHITE); // Set text color to white
tft.setFont();
tft.print("Blink test..."); // Print the message
tft.fillRect(0,0,15,TFT_HEIGHT,tft.color565(0, 0, 128));
tft.drawRect(0,0,15,TFT_HEIGHT,ST77XX_BLACK);

tft.setCursor(5, 10); tft.print("+");
tft.setCursor(5, 110); tft.print("-");
tft.setCursor(100, 110); tft.print("RST");

}

void update(){
int16_t margin=5;
int16_t x=25;
int16_t y=50;
int16_t x1, y1;
uint16_t w, h;
String displayStr=" "+String(millis())+" ms ";
tft.setFont(&FreeSans9pt7b);
tft.setTextSize(1);
tft.getTextBounds(displayStr, x, y, &x1, &y1, &w, &h);
uint16_t real_w = TFT_WIDTH-x1-margin;
tft.fillRect(x1-margin, y1-margin, real_w, h+margin*2, ST77XX_BLACK); // efface la zone
tft.setCursor(x, y); // Set cursor at the top-left corner
tft.setTextColor(ST77XX_GREEN); // Set text color to green
tft.print(String(periode)+" ms"); // Print the message
}

void update_time(){
int16_t margin=5;
int16_t x=25;
int16_t y=90;
int16_t x1, y1;
uint16_t w, h;
uint32_t ti=millis();
uint16_t ss=ti/1000;
uint16_t mm=ss/60;
ss=ss-(mm*60);
uint16_t hh=mm/60;
mm=mm-(hh*60);
String displayStr=(hh < 10 ? String("0") : String(""))+String(hh)+":"+\
(mm < 10 ? String("0") : String(""))+String(mm)+":"+\
(ss < 10 ? String("0") : String(""))+String(ss);
tft.setFont(&FreeSans12pt7b);
tft.setTextSize(1);
tft.getTextBounds(displayStr, x, y, &x1, &y1, &w, &h);
uint16_t real_w = TFT_WIDTH-x1-margin;
tft.fillRect(x1-margin, y1-margin, real_w, h+margin*2, tft.color565(0, 0, 128)); // efface la zone
tft.drawRect(x1-margin, y1-margin, real_w, h+margin*2,ST77XX_BLACK);
tft.setTextColor(ST77XX_WHITE);
tft.setCursor(x, y);
tft.print(displayStr);
}

void setup() {
Serial.begin(115200);
delay(1000);

Serial.println("Démarrage ESP32-C3...");
Serial.println(periode);
pinMode(LED_PIN, OUTPUT);
pinMode(SWITCH_0, INPUT_PULLUP);
pinMode(SWITCH_1, INPUT_PULLUP);
Serial.println("Init écran ST7735...");
tft.initR(INITR_144GREENTAB);
tft.setRotation(3);
tft.fillScreen(ST77XX_BLACK); // Fill the screen with black color
delay(100);
tft.setRotation(2);
tft.setTextSize(1);
display();
update();
}

void loop() {
if (digitalRead(SWITCH_0)==LOW){
periode-=10;
if (periode<100)
periode=100;
Serial.println(periode);
update();
delay(10);
while (digitalRead(SWITCH_0)==LOW)
delay(10);
}

if (digitalRead(SWITCH_1)==LOW){
periode+=10;
if (periode>2000)
periode=2000;
Serial.println(periode);
update();
delay(10);
while (digitalRead(SWITCH_1)==LOW)
delay(10);
}

if ((millis() % periode)< (periode/2))
digitalWrite(LED_PIN, HIGH);
else
digitalWrite(LED_PIN, LOW);

if ((millis() % 1000)==0)
update_time();

}

</syntaxhighlight>

ESP32C3 avec écran spotear

2026-05-13T19:27:49Z

Jpinon : /* Librairie Adafruit */

Appelé en français "Mini ornement de Bureau" voici le module ESP32 C3 équipé de son écran. Personnellement c'est mon premier C3 donc mes débuts en RISC-V. Bon tant que je fais du C avec l'IDE Arduino ca devrait pas trop se voir.
[[Fichier:ESC32C3-desktop-gadget.png|vignette|220x220px]]

== Premier contact ==
Apres avoir joué au petit mécano pour monter le bidule. On le branche sur une alim USB (micro USB le design ne date pas d'hier).

On le branche et il affiche un message (assez moche en vérité) indiquant de configurer son "mobile WLAN" avec les paramètres :

SSID : spotpear (c'est le fabricant)

WIFI Key : 12345678

On peut pas plus sûr comme mot de passe !

Le message du dessous me parait me parait assez ésotérique. Ca sent la traduction du chinois fait pas une IA poussive.
[[Fichier:ESC32C3-desktop-gadget+wifi.png|gauche|vignette|215x215px]]
Je configure un routeur avec ces paramètres et je rebranche le bigonx.

Une belle barre de progression s'affiche et ensuite un superbe écran!

Que c'est beau!

A première vue:

* L'écran est très correct. Lumineux et lisible.
* <u>Pour le mini firmware:</u>

* L'heure locale est juste. Il sait se mètre à l'heure et détecte correctement le fuseau horaire et l'heure été/hiver

* La date est bonne
* La localisation à Clichy est fausse (on est a Paris aujourd'hui)
* La température semble correcte le service météo est juste en revanche le fait d'afficher en °F alors qu'on est a Clichy...Bof bof.
* La météo est correcte (il pleut, il pleut en ce mois de mars 2026)

Le barre de progression du wifi étant verte et le symbole "Temp" en bleu je suppose que cet écran est RGB. (Chercher le rouge)

== Recherche de documentation ==
Le bidule acheté 9€ sur Aliexpress est livré avec.... 8 entretoises 8 vis une façade trouée pour l'écran et un bout de plastique noir pour le fond. Mais .... Aucune doc.

Pas grave y'a Google et Gemini.

J'ai trouvé :

https://www.elektroda.com/news/news4091334.html où un certain p.kaczmarek2 détaille tout le processus d'utilisation.

Dedans j'ai trouvé le schéma électronique.

[[Fichier:SCHEMA ELEC SPOTEAR.png|sans_cadre|836x836px]]

https://spotpear.com/wiki/ESP32-C3-desktop-trinket-Mini-TV-Portable-Pendant-LVGL-1.44inch-LCD-ST7735.html le site du fabricant.

== Niveau Hardware ==
La carte est assez simple on y trouve :

* Le joli écran de 1,44<nowiki>'' de 128x128 pixel (on est loin du 300 ppp) utilisé en SPI (peut être possible en I2C). Pour les personnes normales utilisant le système métrique (le monde entier sauf les USA, le Libéria et la Birmanie je crois) 1.44'' ca fait 36,6 mm. La taille doit venir de ces unités exotiques où un pouce est divisé en 144 points. Je sais pas j'ai pas l'</nowiki>habitude... Doit y avoir une logique.
* Une prise pour une batterie et un circuit de charge PL4054
* Un régulateur linéaire pour faire du 3.3 V CAT 6219 qui m'a pas l'aire d'être tout jeune
* Un quartz 40 MHz
* Une petite mémoire flash de 128 Mbits (16b Mo) W25q128
* 4 boutons poussoirs
** RESET (ou plutôt CHIP_EN) avec son petit circuit de reset automatique
** Un bouton BOOT cablé sur IO09
** Deux boutons (actifs bas) sur IO8 et I010
* Une led sur IO11
* Une LED qui, si je comprends le schéma électronique s'allume quand le batterie se charge
* Le port USB est relié au ESP32C3 qui doit savoir le gérer en natif (pas de FTDI ou autre)
* 5 GPIO accessibles sur 6 broches
** GPIO1
** GPIO6
** GPIO7
** GPIO20
** GPIO21
* Une broches de masse (coté GPIO)
* Une broche +5V et une +3.3V autour du port µUSB

== Niveau developpement ==
Il faut installer un environnement correct. [[Poste de DEV ESP32 sur PI|C'est détaillé ici]]. Avec un premier "hello world" qui fait clignoter une LED.

=== Utiliser l'écran ===
J'ai eu pas mal de problèmes pour utiliser l'écran. Beaucoup de tutos (et aussi copilot) conseillent d'utiliser la librairie '''TFT_eSPI''' mais je ne suis pas arrivé à l'utiliser correctement.

D'autre part le branchement de l'écran n'est pas standard.

==== Brochage ====
Dans le schéma de principe donné sur le site de p.kaczmarek2 on voit plusieurs choses.

[[Fichier:ST7735 PINOUT.png|sans_cadre|429x429px]]

Le pinout n'est pas standard le 'backlight" n'est pas réglable. Les LEDs de rétroéclairage sont alimentées en permanence à travers R11.

En plus sur ce schéma les broches sont nommées SDA, SCL... alors que c'est du SPI et pas ce I<sub>2</sub>C.

Donc le fichier de définition est :<syntaxhighlight lang="c">
// Pinout du module Mini-TV ESP32-C3
#define SD_CS 5
#define TFT_CS 2
#define TFT_DC 0
#define TFT_RST 5
#define MOSI_PIN 4
#define SCK_PIN 3
</syntaxhighlight>Mon fichier User_Setup.h complet est:<syntaxhighlight lang="c">
#define USER_SETUP_ID 44

#define ST7735_DRIVER
#define TFT_WIDTH 128
#define TFT_HEIGHT 128

// Pinout du module Mini-TV ESP32-C3
#define SD_CS 5
#define TFT_CS 2
#define TFT_DC 0
#define TFT_RST 5
#define MOSI_PIN 4
#define SCK_PIN 3

#define LED_PIN 11 // GPIO11 sur ESP32-C3
#define SWITCH_0 8 // GPIO08 sur ESP32-C3
#define SWITCH_1 10 // GPIO10 sur ESP32-C3

#define TFT_RGB_ORDER TFT_BGR
#define TFT_INVERSION_ON
#define TFT_ROTATION 1

#define SPI_FREQUENCY 27000000
</syntaxhighlight>

==== Librairie Adafruit ====
Donc la librairies '''TFT_eSPI''' ne marche pas avec cet écran (ou je ne suis pas arrivé à la faire marcher) j'ai utilisé '''Adafruit_ST7735''' qui fonctionne très bien ([https://www.adafruit.com/ merci Lady Ada]).

Associée à la librairies GFX du même Adafruit on a un joli environnement pour faire des dessins sur l'écran.

On déclare la librairie dans platformio.ini :<syntaxhighlight lang="ini">
[env:adafruit_qtpy_esp32c3]
platform = espressif32
board = adafruit_qtpy_esp32c3
framework = arduino

lib_deps =
adafruit/Adafruit ST7735 and ST7789 Library
adafruit/Adafruit GFX Library

build_flags =
-DUSER_SETUP_LOADED=1
-include src/User_Setup.h

monitor_speed = 115200
upload_speed = 921600
</syntaxhighlight>On remarque l'inclusion du User_Setup.h montré ci dessus.

Et dans le code source on ajoute:<syntaxhighlight lang="c">
#include <Adafruit_GFX.h>
#include <Adafruit_ST7735.h>
</syntaxhighlight>On déclare un objet Adafruit_ST7735 avec les broches données ci dessus.<syntaxhighlight lang="c">
Adafruit_ST7735 tft = Adafruit_ST7735(TFT_CS, TFT_DC, MOSI_PIN, SCK_PIN, TFT_RST);

</syntaxhighlight>et on l'initialise dans <code>setup()</code> :<syntaxhighlight lang="c">tft.initR(INITR_144GREENTAB);
tft.setRotation(3);
tft.fillScreen(ST77XX_BLACK); // Fill the screen with black color
delay(100);
tft.setRotation(2);</syntaxhighlight>Ici y'a deux remarques:

* La constante INITR_144GREENTAB est à utiliser car le standard INITR_BLACKTAB est en mode RGB alors que notre écran est BGR (pourquoi ... pour faire genre je suppose).
* Ensuite, lors du premier démarrage le tft.fillScreen(ST77XX_BLACK); "oublie" quelques lignes de pixels a droite et, pour éviter ce probléme je remplis deux fois en tournant virtuellement l'écran. Il y a peut-etre une conf qui m'échappe...

===== La "default font" =====
Lorsque l'on choisit la fonte par défaut (on qu'on ne choisit rien) :<syntaxhighlight lang="c++">
tft.setFont(); // Si une fonte avait été selectionnée avant. On reviens à la 7x5 par défaut
</syntaxhighlight>C'est une police de base 5x7 mais elle va plus loin que l'ASCII standard.

* On a des caractères valides avant 32
* On a des caractères étendus après 127

Le fichier qui le décrit s'appelle <code>glcdfont.c</code> et, dans un projet Visual Studio Code est situé : <code>.pio/libdeps/adafruit_qtpy_esp32c3/Adafruit GFX Library/glcdfont.c</code>

La structure est simple chaque caractère est codé 5 octset représentant les 5 colonnes de bits.

Apres un programme en C++ pour comprendre et un programme en python pour représenter je suis arrivé à :
[[Fichier:AdafruitGFX 5x7 font.png|sans_cadre|645x645px]]
Bon le 5x7 c'est moche mais sur un écran 128x128 ca permet d'afficher 16 lignes de 21 caractères (un peu moins que le 176 × 184 du vic 20)

==== Exemple complet ====
Un programe démo complet est donné ici.

C'est un "LED Blink" amélioré.

Il fait clignoter la LED sur GPIO11 au rythme de une fois par seconde (1000 ms) ajustable.

L'écran affichera:

[[Fichier:Luxury blink.png|sans_cadre]]

On a en vert le période de "blink" et en blanc sur fond bleu le temps depuis le boot du device HH:MM:SS.

Un petit bandeau bleu a gauche indique que les boutons "+" et "-" permettent d'ajouter ou de retirer 10 ms à la période.

RST est également affiché a côté du bouton reset.

Le projet est constitué de 3 fichiers :

===== platformio.ini =====
<syntaxhighlight lang="ini">[env:adafruit_qtpy_esp32c3]
platform = espressif32
board = adafruit_qtpy_esp32c3
framework = arduino

lib_deps =
adafruit/Adafruit ST7735 and ST7789 Library
adafruit/Adafruit GFX Library

build_flags =
-DUSER_SETUP_LOADED=1
-include src/User_Setup.h

monitor_speed = 115200
upload_speed = 921600</syntaxhighlight>

===== User_Setup.h =====
<syntaxhighlight lang="c">
#define USER_SETUP_ID 44

#define ST7735_DRIVER
#define TFT_WIDTH 128
#define TFT_HEIGHT 128

// Pinout du module Mini-TV ESP32-C3
#define SD_CS 5
#define TFT_CS 2
#define TFT_DC 0
#define TFT_RST 5
#define MOSI_PIN 4
#define SCK_PIN 3

#define LED_PIN 11 // GPIO11 sur ESP32-C3
#define SWITCH_0 8 // GPIO08 sur ESP32-C3
#define SWITCH_1 10 // GPIO10 sur ESP32-C3

#define TFT_RGB_ORDER TFT_BGR
#define TFT_INVERSION_ON
#define TFT_ROTATION 1

#define SPI_FREQUENCY 27000000

</syntaxhighlight>

===== main.cpp =====
<syntaxhighlight lang="c++">
#include <Arduino.h>
#include <Adafruit_GFX.h>
#include <Adafruit_ST7735.h>
#include <Fonts/FreeSans9pt7b.h>
#include <Fonts/FreeSans12pt7b.h>

Adafruit_ST7735 tft = Adafruit_ST7735(TFT_CS, TFT_DC, MOSI_PIN, SCK_PIN, TFT_RST);

int periode = 1000;

void display(){
tft.fillScreen(tft.color565(128, 128, 128)); // Fill the screen with black color
tft.setCursor(20, 15); // Set cursor at the top-left corner
tft.setTextColor(ST77XX_WHITE); // Set text color to white
tft.setFont();
tft.print("Blink test..."); // Print the message
tft.fillRect(0,0,15,TFT_HEIGHT,tft.color565(0, 0, 128));
tft.drawRect(0,0,15,TFT_HEIGHT,ST77XX_BLACK);

tft.setCursor(5, 10); tft.print("+");
tft.setCursor(5, 110); tft.print("-");
tft.setCursor(100, 110); tft.print("RST");

}

void update(){
int16_t margin=5;
int16_t x=25;
int16_t y=50;
int16_t x1, y1;
uint16_t w, h;
String displayStr=" "+String(millis())+" ms ";
tft.setFont(&FreeSans9pt7b);
tft.setTextSize(1);
tft.getTextBounds(displayStr, x, y, &x1, &y1, &w, &h);
uint16_t real_w = TFT_WIDTH-x1-margin;
tft.fillRect(x1-margin, y1-margin, real_w, h+margin*2, ST77XX_BLACK); // efface la zone
tft.setCursor(x, y); // Set cursor at the top-left corner
tft.setTextColor(ST77XX_GREEN); // Set text color to green
tft.print(String(periode)+" ms"); // Print the message
}

void update_time(){
int16_t margin=5;
int16_t x=25;
int16_t y=90;
int16_t x1, y1;
uint16_t w, h;
uint32_t ti=millis();
uint16_t ss=ti/1000;
uint16_t mm=ss/60;
ss=ss-(mm*60);
uint16_t hh=mm/60;
mm=mm-(hh*60);
String displayStr=(hh < 10 ? String("0") : String(""))+String(hh)+":"+\
(mm < 10 ? String("0") : String(""))+String(mm)+":"+\
(ss < 10 ? String("0") : String(""))+String(ss);
tft.setFont(&FreeSans12pt7b);
tft.setTextSize(1);
tft.getTextBounds(displayStr, x, y, &x1, &y1, &w, &h);
uint16_t real_w = TFT_WIDTH-x1-margin;
tft.fillRect(x1-margin, y1-margin, real_w, h+margin*2, tft.color565(0, 0, 128)); // efface la zone
tft.drawRect(x1-margin, y1-margin, real_w, h+margin*2,ST77XX_BLACK);
tft.setTextColor(ST77XX_WHITE);
tft.setCursor(x, y);
tft.print(displayStr);
}

void setup() {
Serial.begin(115200);
delay(1000);

Serial.println("Démarrage ESP32-C3...");
Serial.println(periode);
pinMode(LED_PIN, OUTPUT);
pinMode(SWITCH_0, INPUT_PULLUP);
pinMode(SWITCH_1, INPUT_PULLUP);
Serial.println("Init écran ST7735...");
tft.initR(INITR_144GREENTAB);
tft.setRotation(3);
tft.fillScreen(ST77XX_BLACK); // Fill the screen with black color
delay(100);
tft.setRotation(2);
tft.setTextSize(1);
display();
update();
}

void loop() {
if (digitalRead(SWITCH_0)==LOW){
periode-=10;
if (periode<100)
periode=100;
Serial.println(periode);
update();
delay(10);
while (digitalRead(SWITCH_0)==LOW)
delay(10);
}

if (digitalRead(SWITCH_1)==LOW){
periode+=10;
if (periode>2000)
periode=2000;
Serial.println(periode);
update();
delay(10);
while (digitalRead(SWITCH_1)==LOW)
delay(10);
}

if ((millis() % periode)< (periode/2))
digitalWrite(LED_PIN, HIGH);
else
digitalWrite(LED_PIN, LOW);

if ((millis() % 1000)==0)
update_time();

}

</syntaxhighlight>

Fichier:AdafruitGFX 5x7 font.png

2026-05-13T19:21:25Z

Jpinon :

La poulice Adafruit par défaut (5x7)

Fichier:Alice et bob private public.png

2026-05-11T21:23:48Z

Jpinon : Jpinon a téléversé une nouvelle version de Fichier:Alice et bob private public.png

Alice et bob private public

Fichier:Mécanisme clés asymétriques.png

2026-05-11T21:13:36Z

Jpinon : Jpinon a téléversé une nouvelle version de Fichier:Mécanisme clés asymétriques.png

mécanisme clés asymétriques

Fichier:Alice-bob-mallory.png

2026-05-11T21:08:53Z

Jpinon : Jpinon a téléversé une nouvelle version de Fichier:Alice-bob-mallory.png

illustration crypto

ESP32C3 avec écran spotear

2026-05-08T20:56:22Z

Jpinon : /* Recherche de documentation */

Appelé en français "Mini ornement de Bureau" voici le module ESP32 C3 équipé de son écran. Personnellement c'est mon premier C3 donc mes débuts en RISC-V. Bon tant que je fais du C avec l'IDE Arduino ca devrait pas trop se voir.
[[Fichier:ESC32C3-desktop-gadget.png|vignette|220x220px]]

== Premier contact ==
Apres avoir joué au petit mécano pour monter le bidule. On le branche sur une alim USB (micro USB le design ne date pas d'hier).

On le branche et il affiche un message (assez moche en vérité) indiquant de configurer son "mobile WLAN" avec les paramètres :

SSID : spotpear (c'est le fabricant)

WIFI Key : 12345678

On peut pas plus sûr comme mot de passe !

Le message du dessous me parait me parait assez ésotérique. Ca sent la traduction du chinois fait pas une IA poussive.
[[Fichier:ESC32C3-desktop-gadget+wifi.png|gauche|vignette|215x215px]]
Je configure un routeur avec ces paramètres et je rebranche le bigonx.

Une belle barre de progression s'affiche et ensuite un superbe écran!

Que c'est beau!

A première vue:

* L'écran est très correct. Lumineux et lisible.
* <u>Pour le mini firmware:</u>

* L'heure locale est juste. Il sait se mètre à l'heure et détecte correctement le fuseau horaire et l'heure été/hiver

* La date est bonne
* La localisation à Clichy est fausse (on est a Paris aujourd'hui)
* La température semble correcte le service météo est juste en revanche le fait d'afficher en °F alors qu'on est a Clichy...Bof bof.
* La météo est correcte (il pleut, il pleut en ce mois de mars 2026)

Le barre de progression du wifi étant verte et le symbole "Temp" en bleu je suppose que cet écran est RGB. (Chercher le rouge)

== Recherche de documentation ==
Le bidule acheté 9€ sur Aliexpress est livré avec.... 8 entretoises 8 vis une façade trouée pour l'écran et un bout de plastique noir pour le fond. Mais .... Aucune doc.

Pas grave y'a Google et Gemini.

J'ai trouvé :

https://www.elektroda.com/news/news4091334.html où un certain p.kaczmarek2 détaille tout le processus d'utilisation.

Dedans j'ai trouvé le schéma électronique.

[[Fichier:SCHEMA ELEC SPOTEAR.png|sans_cadre|836x836px]]

https://spotpear.com/wiki/ESP32-C3-desktop-trinket-Mini-TV-Portable-Pendant-LVGL-1.44inch-LCD-ST7735.html le site du fabricant.

== Niveau Hardware ==
La carte est assez simple on y trouve :

* Le joli écran de 1,44<nowiki>'' de 128x128 pixel (on est loin du 300 ppp) utilisé en SPI (peut être possible en I2C). Pour les personnes normales utilisant le système métrique (le monde entier sauf les USA, le Libéria et la Birmanie je crois) 1.44'' ca fait 36,6 mm. La taille doit venir de ces unités exotiques où un pouce est divisé en 144 points. Je sais pas j'ai pas l'</nowiki>habitude... Doit y avoir une logique.
* Une prise pour une batterie et un circuit de charge PL4054
* Un régulateur linéaire pour faire du 3.3 V CAT 6219 qui m'a pas l'aire d'être tout jeune
* Un quartz 40 MHz
* Une petite mémoire flash de 128 Mbits (16b Mo) W25q128
* 4 boutons poussoirs
** RESET (ou plutôt CHIP_EN) avec son petit circuit de reset automatique
** Un bouton BOOT cablé sur IO09
** Deux boutons (actifs bas) sur IO8 et I010
* Une led sur IO11
* Une LED qui, si je comprends le schéma électronique s'allume quand le batterie se charge
* Le port USB est relié au ESP32C3 qui doit savoir le gérer en natif (pas de FTDI ou autre)
* 5 GPIO accessibles sur 6 broches
** GPIO1
** GPIO6
** GPIO7
** GPIO20
** GPIO21
* Une broches de masse (coté GPIO)
* Une broche +5V et une +3.3V autour du port µUSB

== Niveau developpement ==
Il faut installer un environnement correct. [[Poste de DEV ESP32 sur PI|C'est détaillé ici]]. Avec un premier "hello world" qui fait clignoter une LED.

=== Utiliser l'écran ===
J'ai eu pas mal de problèmes pour utiliser l'écran. Beaucoup de tutos (et aussi copilot) conseillent d'utiliser la librairie '''TFT_eSPI''' mais je ne suis pas arrivé à l'utiliser correctement.

D'autre part le branchement de l'écran n'est pas standard.

==== Brochage ====
Dans le schéma de principe donné sur le site de p.kaczmarek2 on voit plusieurs choses.

[[Fichier:ST7735 PINOUT.png|sans_cadre|429x429px]]

Le pinout n'est pas standard le 'backlight" n'est pas réglable. Les LEDs de rétroéclairage sont alimentées en permanence à travers R11.

En plus sur ce schéma les broches sont nommées SDA, SCL... alors que c'est du SPI et pas ce I<sub>2</sub>C.

Donc le fichier de définition est :<syntaxhighlight lang="c">
// Pinout du module Mini-TV ESP32-C3
#define SD_CS 5
#define TFT_CS 2
#define TFT_DC 0
#define TFT_RST 5
#define MOSI_PIN 4
#define SCK_PIN 3
</syntaxhighlight>Mon fichier User_Setup.h complet est:<syntaxhighlight lang="c">
#define USER_SETUP_ID 44

#define ST7735_DRIVER
#define TFT_WIDTH 128
#define TFT_HEIGHT 128

// Pinout du module Mini-TV ESP32-C3
#define SD_CS 5
#define TFT_CS 2
#define TFT_DC 0
#define TFT_RST 5
#define MOSI_PIN 4
#define SCK_PIN 3

#define LED_PIN 11 // GPIO11 sur ESP32-C3
#define SWITCH_0 8 // GPIO08 sur ESP32-C3
#define SWITCH_1 10 // GPIO10 sur ESP32-C3

#define TFT_RGB_ORDER TFT_BGR
#define TFT_INVERSION_ON
#define TFT_ROTATION 1

#define SPI_FREQUENCY 27000000
</syntaxhighlight>

==== Librairie Adafruit ====
Donc la librairies '''TFT_eSPI''' ne marche pas avec cet écran (ou je ne suis pas arrivé à la faire marcher) j'ai utilisé '''Adafruit_ST7735''' qui fonctionne très bien ([https://www.adafruit.com/ merci Lady Ada]).

Associée à la librairies GFX du même Adafruit on a un joli environnement pour faire des dessins sur l'écran.

On déclare la librairie dans platformio.ini :<syntaxhighlight lang="ini">
[env:adafruit_qtpy_esp32c3]
platform = espressif32
board = adafruit_qtpy_esp32c3
framework = arduino

lib_deps =
adafruit/Adafruit ST7735 and ST7789 Library
adafruit/Adafruit GFX Library

build_flags =
-DUSER_SETUP_LOADED=1
-include src/User_Setup.h

monitor_speed = 115200
upload_speed = 921600
</syntaxhighlight>On remarque l'inclusion du User_Setup.h montré ci dessus.

Et dans le code source on ajoute:<syntaxhighlight lang="c">
#include <Adafruit_GFX.h>
#include <Adafruit_ST7735.h>
</syntaxhighlight>On déclare un objet Adafruit_ST7735 avec les broches données ci dessus.<syntaxhighlight lang="c">
Adafruit_ST7735 tft = Adafruit_ST7735(TFT_CS, TFT_DC, MOSI_PIN, SCK_PIN, TFT_RST);

</syntaxhighlight>et on l'initialise dans <code>setup()</code> :<syntaxhighlight lang="c">tft.initR(INITR_144GREENTAB);
tft.setRotation(3);
tft.fillScreen(ST77XX_BLACK); // Fill the screen with black color
delay(100);
tft.setRotation(2);</syntaxhighlight>Ici y'a deux remarques:

* La constante INITR_144GREENTAB est à utiliser car le standard INITR_BLACKTAB est en mode RGB alors que notre écran est BGR (pourquoi ... pour faire genre je suppose).
* Ensuite, lors du premier démarrage le tft.fillScreen(ST77XX_BLACK); "oublie" quelques lignes de pixels a droite et, pour éviter ce probléme je remplis deux fois en tournant virtuellement l'écran. Il y a peut-etre une conf qui m'échappe...

==== Exemple complet ====
Un programe démo complet est donné ici.

C'est un "LED Blink" amélioré.

Il fait clignoter la LED sur GPIO11 au rythme de une fois par seconde (1000 ms) ajustable.

L'écran affichera:

[[Fichier:Luxury blink.png|sans_cadre]]

On a en vert le période de "blink" et en blanc sur fond bleu le temps depuis le boot du device HH:MM:SS.

Un petit bandeau bleu a gauche indique que les boutons "+" et "-" permettent d'ajouter ou de retirer 10 ms à la période.

RST est également affiché a côté du bouton reset.

Le projet est constitué de 3 fichiers :

===== platformio.ini =====
<syntaxhighlight lang="ini">[env:adafruit_qtpy_esp32c3]
platform = espressif32
board = adafruit_qtpy_esp32c3
framework = arduino

lib_deps =
adafruit/Adafruit ST7735 and ST7789 Library
adafruit/Adafruit GFX Library

build_flags =
-DUSER_SETUP_LOADED=1
-include src/User_Setup.h

monitor_speed = 115200
upload_speed = 921600</syntaxhighlight>

===== User_Setup.h =====
<syntaxhighlight lang="c">
#define USER_SETUP_ID 44

#define ST7735_DRIVER
#define TFT_WIDTH 128
#define TFT_HEIGHT 128

// Pinout du module Mini-TV ESP32-C3
#define SD_CS 5
#define TFT_CS 2
#define TFT_DC 0
#define TFT_RST 5
#define MOSI_PIN 4
#define SCK_PIN 3

#define LED_PIN 11 // GPIO11 sur ESP32-C3
#define SWITCH_0 8 // GPIO08 sur ESP32-C3
#define SWITCH_1 10 // GPIO10 sur ESP32-C3

#define TFT_RGB_ORDER TFT_BGR
#define TFT_INVERSION_ON
#define TFT_ROTATION 1

#define SPI_FREQUENCY 27000000

</syntaxhighlight>

===== main.cpp =====
<syntaxhighlight lang="c++">
#include <Arduino.h>
#include <Adafruit_GFX.h>
#include <Adafruit_ST7735.h>
#include <Fonts/FreeSans9pt7b.h>
#include <Fonts/FreeSans12pt7b.h>

Adafruit_ST7735 tft = Adafruit_ST7735(TFT_CS, TFT_DC, MOSI_PIN, SCK_PIN, TFT_RST);

int periode = 1000;

void display(){
tft.fillScreen(tft.color565(128, 128, 128)); // Fill the screen with black color
tft.setCursor(20, 15); // Set cursor at the top-left corner
tft.setTextColor(ST77XX_WHITE); // Set text color to white
tft.setFont();
tft.print("Blink test..."); // Print the message
tft.fillRect(0,0,15,TFT_HEIGHT,tft.color565(0, 0, 128));
tft.drawRect(0,0,15,TFT_HEIGHT,ST77XX_BLACK);

tft.setCursor(5, 10); tft.print("+");
tft.setCursor(5, 110); tft.print("-");
tft.setCursor(100, 110); tft.print("RST");

}

void update(){
int16_t margin=5;
int16_t x=25;
int16_t y=50;
int16_t x1, y1;
uint16_t w, h;
String displayStr=" "+String(millis())+" ms ";
tft.setFont(&FreeSans9pt7b);
tft.setTextSize(1);
tft.getTextBounds(displayStr, x, y, &x1, &y1, &w, &h);
uint16_t real_w = TFT_WIDTH-x1-margin;
tft.fillRect(x1-margin, y1-margin, real_w, h+margin*2, ST77XX_BLACK); // efface la zone
tft.setCursor(x, y); // Set cursor at the top-left corner
tft.setTextColor(ST77XX_GREEN); // Set text color to green
tft.print(String(periode)+" ms"); // Print the message
}

void update_time(){
int16_t margin=5;
int16_t x=25;
int16_t y=90;
int16_t x1, y1;
uint16_t w, h;
uint32_t ti=millis();
uint16_t ss=ti/1000;
uint16_t mm=ss/60;
ss=ss-(mm*60);
uint16_t hh=mm/60;
mm=mm-(hh*60);
String displayStr=(hh < 10 ? String("0") : String(""))+String(hh)+":"+\
(mm < 10 ? String("0") : String(""))+String(mm)+":"+\
(ss < 10 ? String("0") : String(""))+String(ss);
tft.setFont(&FreeSans12pt7b);
tft.setTextSize(1);
tft.getTextBounds(displayStr, x, y, &x1, &y1, &w, &h);
uint16_t real_w = TFT_WIDTH-x1-margin;
tft.fillRect(x1-margin, y1-margin, real_w, h+margin*2, tft.color565(0, 0, 128)); // efface la zone
tft.drawRect(x1-margin, y1-margin, real_w, h+margin*2,ST77XX_BLACK);
tft.setTextColor(ST77XX_WHITE);
tft.setCursor(x, y);
tft.print(displayStr);
}

void setup() {
Serial.begin(115200);
delay(1000);

Serial.println("Démarrage ESP32-C3...");
Serial.println(periode);
pinMode(LED_PIN, OUTPUT);
pinMode(SWITCH_0, INPUT_PULLUP);
pinMode(SWITCH_1, INPUT_PULLUP);
Serial.println("Init écran ST7735...");
tft.initR(INITR_144GREENTAB);
tft.setRotation(3);
tft.fillScreen(ST77XX_BLACK); // Fill the screen with black color
delay(100);
tft.setRotation(2);
tft.setTextSize(1);
display();
update();
}

void loop() {
if (digitalRead(SWITCH_0)==LOW){
periode-=10;
if (periode<100)
periode=100;
Serial.println(periode);
update();
delay(10);
while (digitalRead(SWITCH_0)==LOW)
delay(10);
}

if (digitalRead(SWITCH_1)==LOW){
periode+=10;
if (periode>2000)
periode=2000;
Serial.println(periode);
update();
delay(10);
while (digitalRead(SWITCH_1)==LOW)
delay(10);
}

if ((millis() % periode)< (periode/2))
digitalWrite(LED_PIN, HIGH);
else
digitalWrite(LED_PIN, LOW);

if ((millis() % 1000)==0)
update_time();

}

</syntaxhighlight>

Fichier:SCHEMA ELEC SPOTEAR.png

2026-05-08T20:55:31Z

Jpinon :

Schéme électronique

ESP32C3 avec écran spotear

2026-05-08T15:39:44Z

Jpinon : /* Exemple complet */

Appelé en français "Mini ornement de Bureau" voici le module ESP32 C3 équipé de son écran. Personnellement c'est mon premier C3 donc mes débuts en RISC-V. Bon tant que je fais du C avec l'IDE Arduino ca devrait pas trop se voir.
[[Fichier:ESC32C3-desktop-gadget.png|vignette|220x220px]]

== Premier contact ==
Apres avoir joué au petit mécano pour monter le bidule. On le branche sur une alim USB (micro USB le design ne date pas d'hier).

On le branche et il affiche un message (assez moche en vérité) indiquant de configurer son "mobile WLAN" avec les paramètres :

SSID : spotpear (c'est le fabricant)

WIFI Key : 12345678

On peut pas plus sûr comme mot de passe !

Le message du dessous me parait me parait assez ésotérique. Ca sent la traduction du chinois fait pas une IA poussive.
[[Fichier:ESC32C3-desktop-gadget+wifi.png|gauche|vignette|215x215px]]
Je configure un routeur avec ces paramètres et je rebranche le bigonx.

Une belle barre de progression s'affiche et ensuite un superbe écran!

Que c'est beau!

A première vue:

* L'écran est très correct. Lumineux et lisible.
* <u>Pour le mini firmware:</u>

* L'heure locale est juste. Il sait se mètre à l'heure et détecte correctement le fuseau horaire et l'heure été/hiver

* La date est bonne
* La localisation à Clichy est fausse (on est a Paris aujourd'hui)
* La température semble correcte le service météo est juste en revanche le fait d'afficher en °F alors qu'on est a Clichy...Bof bof.
* La météo est correcte (il pleut, il pleut en ce mois de mars 2026)

Le barre de progression du wifi étant verte et le symbole "Temp" en bleu je suppose que cet écran est RGB. (Chercher le rouge)

== Recherche de documentation ==
Le bidule acheté 9€ sur Aliexpress est livré avec.... 8 entretoises 8 vis une façade trouée pour l'écran et un bout de plastique noir pour le fond. Mais .... Aucune doc.

Pas grave y'a Google et Gemini.

J'ai trouvé :

https://www.elektroda.com/news/news4091334.html où un certain p.kaczmarek2 détaille tout le processus d'utilisation.

https://spotpear.com/wiki/ESP32-C3-desktop-trinket-Mini-TV-Portable-Pendant-LVGL-1.44inch-LCD-ST7735.html le site du fabricant.

== Niveau Hardware ==
La carte est assez simple on y trouve :

* Le joli écran de 1,44<nowiki>'' de 128x128 pixel (on est loin du 300 ppp) utilisé en SPI (peut être possible en I2C). Pour les personnes normales utilisant le système métrique (le monde entier sauf les USA, le Libéria et la Birmanie je crois) 1.44'' ca fait 36,6 mm. La taille doit venir de ces unités exotiques où un pouce est divisé en 144 points. Je sais pas j'ai pas l'</nowiki>habitude... Doit y avoir une logique.
* Une prise pour une batterie et un circuit de charge PL4054
* Un régulateur linéaire pour faire du 3.3 V CAT 6219 qui m'a pas l'aire d'être tout jeune
* Un quartz 40 MHz
* Une petite mémoire flash de 128 Mbits (16b Mo) W25q128
* 4 boutons poussoirs
** RESET (ou plutôt CHIP_EN) avec son petit circuit de reset automatique
** Un bouton BOOT cablé sur IO09
** Deux boutons (actifs bas) sur IO8 et I010
* Une led sur IO11
* Une LED qui, si je comprends le schéma électronique s'allume quand le batterie se charge
* Le port USB est relié au ESP32C3 qui doit savoir le gérer en natif (pas de FTDI ou autre)
* 5 GPIO accessibles sur 6 broches
** GPIO1
** GPIO6
** GPIO7
** GPIO20
** GPIO21
* Une broches de masse (coté GPIO)
* Une broche +5V et une +3.3V autour du port µUSB

== Niveau developpement ==
Il faut installer un environnement correct. [[Poste de DEV ESP32 sur PI|C'est détaillé ici]]. Avec un premier "hello world" qui fait clignoter une LED.

=== Utiliser l'écran ===
J'ai eu pas mal de problèmes pour utiliser l'écran. Beaucoup de tutos (et aussi copilot) conseillent d'utiliser la librairie '''TFT_eSPI''' mais je ne suis pas arrivé à l'utiliser correctement.

D'autre part le branchement de l'écran n'est pas standard.

==== Brochage ====
Dans le schéma de principe donné sur le site de p.kaczmarek2 on voit plusieurs choses.

[[Fichier:ST7735 PINOUT.png|sans_cadre|429x429px]]

Le pinout n'est pas standard le 'backlight" n'est pas réglable. Les LEDs de rétroéclairage sont alimentées en permanence à travers R11.

En plus sur ce schéma les broches sont nommées SDA, SCL... alors que c'est du SPI et pas ce I<sub>2</sub>C.

Donc le fichier de définition est :<syntaxhighlight lang="c">
// Pinout du module Mini-TV ESP32-C3
#define SD_CS 5
#define TFT_CS 2
#define TFT_DC 0
#define TFT_RST 5
#define MOSI_PIN 4
#define SCK_PIN 3
</syntaxhighlight>Mon fichier User_Setup.h complet est:<syntaxhighlight lang="c">
#define USER_SETUP_ID 44

#define ST7735_DRIVER
#define TFT_WIDTH 128
#define TFT_HEIGHT 128

// Pinout du module Mini-TV ESP32-C3
#define SD_CS 5
#define TFT_CS 2
#define TFT_DC 0
#define TFT_RST 5
#define MOSI_PIN 4
#define SCK_PIN 3

#define LED_PIN 11 // GPIO11 sur ESP32-C3
#define SWITCH_0 8 // GPIO08 sur ESP32-C3
#define SWITCH_1 10 // GPIO10 sur ESP32-C3

#define TFT_RGB_ORDER TFT_BGR
#define TFT_INVERSION_ON
#define TFT_ROTATION 1

#define SPI_FREQUENCY 27000000
</syntaxhighlight>

==== Librairie Adafruit ====
Donc la librairies '''TFT_eSPI''' ne marche pas avec cet écran (ou je ne suis pas arrivé à la faire marcher) j'ai utilisé '''Adafruit_ST7735''' qui fonctionne très bien ([https://www.adafruit.com/ merci Lady Ada]).

Associée à la librairies GFX du même Adafruit on a un joli environnement pour faire des dessins sur l'écran.

On déclare la librairie dans platformio.ini :<syntaxhighlight lang="ini">
[env:adafruit_qtpy_esp32c3]
platform = espressif32
board = adafruit_qtpy_esp32c3
framework = arduino

lib_deps =
adafruit/Adafruit ST7735 and ST7789 Library
adafruit/Adafruit GFX Library

build_flags =
-DUSER_SETUP_LOADED=1
-include src/User_Setup.h

monitor_speed = 115200
upload_speed = 921600
</syntaxhighlight>On remarque l'inclusion du User_Setup.h montré ci dessus.

Et dans le code source on ajoute:<syntaxhighlight lang="c">
#include <Adafruit_GFX.h>
#include <Adafruit_ST7735.h>
</syntaxhighlight>On déclare un objet Adafruit_ST7735 avec les broches données ci dessus.<syntaxhighlight lang="c">
Adafruit_ST7735 tft = Adafruit_ST7735(TFT_CS, TFT_DC, MOSI_PIN, SCK_PIN, TFT_RST);

</syntaxhighlight>et on l'initialise dans <code>setup()</code> :<syntaxhighlight lang="c">tft.initR(INITR_144GREENTAB);
tft.setRotation(3);
tft.fillScreen(ST77XX_BLACK); // Fill the screen with black color
delay(100);
tft.setRotation(2);</syntaxhighlight>Ici y'a deux remarques:

* La constante INITR_144GREENTAB est à utiliser car le standard INITR_BLACKTAB est en mode RGB alors que notre écran est BGR (pourquoi ... pour faire genre je suppose).
* Ensuite, lors du premier démarrage le tft.fillScreen(ST77XX_BLACK); "oublie" quelques lignes de pixels a droite et, pour éviter ce probléme je remplis deux fois en tournant virtuellement l'écran. Il y a peut-etre une conf qui m'échappe...

==== Exemple complet ====
Un programe démo complet est donné ici.

C'est un "LED Blink" amélioré.

Il fait clignoter la LED sur GPIO11 au rythme de une fois par seconde (1000 ms) ajustable.

L'écran affichera:

[[Fichier:Luxury blink.png|sans_cadre]]

On a en vert le période de "blink" et en blanc sur fond bleu le temps depuis le boot du device HH:MM:SS.

Un petit bandeau bleu a gauche indique que les boutons "+" et "-" permettent d'ajouter ou de retirer 10 ms à la période.

RST est également affiché a côté du bouton reset.

Le projet est constitué de 3 fichiers :

===== platformio.ini =====
<syntaxhighlight lang="ini">[env:adafruit_qtpy_esp32c3]
platform = espressif32
board = adafruit_qtpy_esp32c3
framework = arduino

lib_deps =
adafruit/Adafruit ST7735 and ST7789 Library
adafruit/Adafruit GFX Library

build_flags =
-DUSER_SETUP_LOADED=1
-include src/User_Setup.h

monitor_speed = 115200
upload_speed = 921600</syntaxhighlight>

===== User_Setup.h =====
<syntaxhighlight lang="c">
#define USER_SETUP_ID 44

#define ST7735_DRIVER
#define TFT_WIDTH 128
#define TFT_HEIGHT 128

// Pinout du module Mini-TV ESP32-C3
#define SD_CS 5
#define TFT_CS 2
#define TFT_DC 0
#define TFT_RST 5
#define MOSI_PIN 4
#define SCK_PIN 3

#define LED_PIN 11 // GPIO11 sur ESP32-C3
#define SWITCH_0 8 // GPIO08 sur ESP32-C3
#define SWITCH_1 10 // GPIO10 sur ESP32-C3

#define TFT_RGB_ORDER TFT_BGR
#define TFT_INVERSION_ON
#define TFT_ROTATION 1

#define SPI_FREQUENCY 27000000

</syntaxhighlight>

===== main.cpp =====
<syntaxhighlight lang="c++">
#include <Arduino.h>
#include <Adafruit_GFX.h>
#include <Adafruit_ST7735.h>
#include <Fonts/FreeSans9pt7b.h>
#include <Fonts/FreeSans12pt7b.h>

Adafruit_ST7735 tft = Adafruit_ST7735(TFT_CS, TFT_DC, MOSI_PIN, SCK_PIN, TFT_RST);

int periode = 1000;

void display(){
tft.fillScreen(tft.color565(128, 128, 128)); // Fill the screen with black color
tft.setCursor(20, 15); // Set cursor at the top-left corner
tft.setTextColor(ST77XX_WHITE); // Set text color to white
tft.setFont();
tft.print("Blink test..."); // Print the message
tft.fillRect(0,0,15,TFT_HEIGHT,tft.color565(0, 0, 128));
tft.drawRect(0,0,15,TFT_HEIGHT,ST77XX_BLACK);

tft.setCursor(5, 10); tft.print("+");
tft.setCursor(5, 110); tft.print("-");
tft.setCursor(100, 110); tft.print("RST");

}

void update(){
int16_t margin=5;
int16_t x=25;
int16_t y=50;
int16_t x1, y1;
uint16_t w, h;
String displayStr=" "+String(millis())+" ms ";
tft.setFont(&FreeSans9pt7b);
tft.setTextSize(1);
tft.getTextBounds(displayStr, x, y, &x1, &y1, &w, &h);
uint16_t real_w = TFT_WIDTH-x1-margin;
tft.fillRect(x1-margin, y1-margin, real_w, h+margin*2, ST77XX_BLACK); // efface la zone
tft.setCursor(x, y); // Set cursor at the top-left corner
tft.setTextColor(ST77XX_GREEN); // Set text color to green
tft.print(String(periode)+" ms"); // Print the message
}

void update_time(){
int16_t margin=5;
int16_t x=25;
int16_t y=90;
int16_t x1, y1;
uint16_t w, h;
uint32_t ti=millis();
uint16_t ss=ti/1000;
uint16_t mm=ss/60;
ss=ss-(mm*60);
uint16_t hh=mm/60;
mm=mm-(hh*60);
String displayStr=(hh < 10 ? String("0") : String(""))+String(hh)+":"+\
(mm < 10 ? String("0") : String(""))+String(mm)+":"+\
(ss < 10 ? String("0") : String(""))+String(ss);
tft.setFont(&FreeSans12pt7b);
tft.setTextSize(1);
tft.getTextBounds(displayStr, x, y, &x1, &y1, &w, &h);
uint16_t real_w = TFT_WIDTH-x1-margin;
tft.fillRect(x1-margin, y1-margin, real_w, h+margin*2, tft.color565(0, 0, 128)); // efface la zone
tft.drawRect(x1-margin, y1-margin, real_w, h+margin*2,ST77XX_BLACK);
tft.setTextColor(ST77XX_WHITE);
tft.setCursor(x, y);
tft.print(displayStr);
}

void setup() {
Serial.begin(115200);
delay(1000);

Serial.println("Démarrage ESP32-C3...");
Serial.println(periode);
pinMode(LED_PIN, OUTPUT);
pinMode(SWITCH_0, INPUT_PULLUP);
pinMode(SWITCH_1, INPUT_PULLUP);
Serial.println("Init écran ST7735...");
tft.initR(INITR_144GREENTAB);
tft.setRotation(3);
tft.fillScreen(ST77XX_BLACK); // Fill the screen with black color
delay(100);
tft.setRotation(2);
tft.setTextSize(1);
display();
update();
}

void loop() {
if (digitalRead(SWITCH_0)==LOW){
periode-=10;
if (periode<100)
periode=100;
Serial.println(periode);
update();
delay(10);
while (digitalRead(SWITCH_0)==LOW)
delay(10);
}

if (digitalRead(SWITCH_1)==LOW){
periode+=10;
if (periode>2000)
periode=2000;
Serial.println(periode);
update();
delay(10);
while (digitalRead(SWITCH_1)==LOW)
delay(10);
}

if ((millis() % periode)< (periode/2))
digitalWrite(LED_PIN, HIGH);
else
digitalWrite(LED_PIN, LOW);

if ((millis() % 1000)==0)
update_time();

}

</syntaxhighlight>

Fichier:Luxury blink.png

2026-05-08T15:39:18Z

Jpinon :

le Hello World de luxe

ESP32C3 avec écran spotear

2026-05-08T15:14:51Z

Jpinon : /* Utiliser l'écran */

Appelé en français "Mini ornement de Bureau" voici le module ESP32 C3 équipé de son écran. Personnellement c'est mon premier C3 donc mes débuts en RISC-V. Bon tant que je fais du C avec l'IDE Arduino ca devrait pas trop se voir.
[[Fichier:ESC32C3-desktop-gadget.png|vignette|220x220px]]

== Premier contact ==
Apres avoir joué au petit mécano pour monter le bidule. On le branche sur une alim USB (micro USB le design ne date pas d'hier).

On le branche et il affiche un message (assez moche en vérité) indiquant de configurer son "mobile WLAN" avec les paramètres :

SSID : spotpear (c'est le fabricant)

WIFI Key : 12345678

On peut pas plus sûr comme mot de passe !

Le message du dessous me parait me parait assez ésotérique. Ca sent la traduction du chinois fait pas une IA poussive.
[[Fichier:ESC32C3-desktop-gadget+wifi.png|gauche|vignette|215x215px]]
Je configure un routeur avec ces paramètres et je rebranche le bigonx.

Une belle barre de progression s'affiche et ensuite un superbe écran!

Que c'est beau!

A première vue:

* L'écran est très correct. Lumineux et lisible.
* <u>Pour le mini firmware:</u>

* L'heure locale est juste. Il sait se mètre à l'heure et détecte correctement le fuseau horaire et l'heure été/hiver

* La date est bonne
* La localisation à Clichy est fausse (on est a Paris aujourd'hui)
* La température semble correcte le service météo est juste en revanche le fait d'afficher en °F alors qu'on est a Clichy...Bof bof.
* La météo est correcte (il pleut, il pleut en ce mois de mars 2026)

Le barre de progression du wifi étant verte et le symbole "Temp" en bleu je suppose que cet écran est RGB. (Chercher le rouge)

== Recherche de documentation ==
Le bidule acheté 9€ sur Aliexpress est livré avec.... 8 entretoises 8 vis une façade trouée pour l'écran et un bout de plastique noir pour le fond. Mais .... Aucune doc.

Pas grave y'a Google et Gemini.

J'ai trouvé :

https://www.elektroda.com/news/news4091334.html où un certain p.kaczmarek2 détaille tout le processus d'utilisation.

https://spotpear.com/wiki/ESP32-C3-desktop-trinket-Mini-TV-Portable-Pendant-LVGL-1.44inch-LCD-ST7735.html le site du fabricant.

== Niveau Hardware ==
La carte est assez simple on y trouve :

* Le joli écran de 1,44<nowiki>'' de 128x128 pixel (on est loin du 300 ppp) utilisé en SPI (peut être possible en I2C). Pour les personnes normales utilisant le système métrique (le monde entier sauf les USA, le Libéria et la Birmanie je crois) 1.44'' ca fait 36,6 mm. La taille doit venir de ces unités exotiques où un pouce est divisé en 144 points. Je sais pas j'ai pas l'</nowiki>habitude... Doit y avoir une logique.
* Une prise pour une batterie et un circuit de charge PL4054
* Un régulateur linéaire pour faire du 3.3 V CAT 6219 qui m'a pas l'aire d'être tout jeune
* Un quartz 40 MHz
* Une petite mémoire flash de 128 Mbits (16b Mo) W25q128
* 4 boutons poussoirs
** RESET (ou plutôt CHIP_EN) avec son petit circuit de reset automatique
** Un bouton BOOT cablé sur IO09
** Deux boutons (actifs bas) sur IO8 et I010
* Une led sur IO11
* Une LED qui, si je comprends le schéma électronique s'allume quand le batterie se charge
* Le port USB est relié au ESP32C3 qui doit savoir le gérer en natif (pas de FTDI ou autre)
* 5 GPIO accessibles sur 6 broches
** GPIO1
** GPIO6
** GPIO7
** GPIO20
** GPIO21
* Une broches de masse (coté GPIO)
* Une broche +5V et une +3.3V autour du port µUSB

== Niveau developpement ==
Il faut installer un environnement correct. [[Poste de DEV ESP32 sur PI|C'est détaillé ici]]. Avec un premier "hello world" qui fait clignoter une LED.

=== Utiliser l'écran ===
J'ai eu pas mal de problèmes pour utiliser l'écran. Beaucoup de tutos (et aussi copilot) conseillent d'utiliser la librairie '''TFT_eSPI''' mais je ne suis pas arrivé à l'utiliser correctement.

D'autre part le branchement de l'écran n'est pas standard.

==== Brochage ====
Dans le schéma de principe donné sur le site de p.kaczmarek2 on voit plusieurs choses.

[[Fichier:ST7735 PINOUT.png|sans_cadre|429x429px]]

Le pinout n'est pas standard le 'backlight" n'est pas réglable. Les LEDs de rétroéclairage sont alimentées en permanence à travers R11.

En plus sur ce schéma les broches sont nommées SDA, SCL... alors que c'est du SPI et pas ce I<sub>2</sub>C.

Donc le fichier de définition est :<syntaxhighlight lang="c">
// Pinout du module Mini-TV ESP32-C3
#define SD_CS 5
#define TFT_CS 2
#define TFT_DC 0
#define TFT_RST 5
#define MOSI_PIN 4
#define SCK_PIN 3
</syntaxhighlight>Mon fichier User_Setup.h complet est:<syntaxhighlight lang="c">
#define USER_SETUP_ID 44

#define ST7735_DRIVER
#define TFT_WIDTH 128
#define TFT_HEIGHT 128

// Pinout du module Mini-TV ESP32-C3
#define SD_CS 5
#define TFT_CS 2
#define TFT_DC 0
#define TFT_RST 5
#define MOSI_PIN 4
#define SCK_PIN 3

#define LED_PIN 11 // GPIO11 sur ESP32-C3
#define SWITCH_0 8 // GPIO08 sur ESP32-C3
#define SWITCH_1 10 // GPIO10 sur ESP32-C3

#define TFT_RGB_ORDER TFT_BGR
#define TFT_INVERSION_ON
#define TFT_ROTATION 1

#define SPI_FREQUENCY 27000000
</syntaxhighlight>

==== Librairie Adafruit ====
Donc la librairies '''TFT_eSPI''' ne marche pas avec cet écran (ou je ne suis pas arrivé à la faire marcher) j'ai utilisé '''Adafruit_ST7735''' qui fonctionne très bien ([https://www.adafruit.com/ merci Lady Ada]).

Associée à la librairies GFX du même Adafruit on a un joli environnement pour faire des dessins sur l'écran.

On déclare la librairie dans platformio.ini :<syntaxhighlight lang="ini">
[env:adafruit_qtpy_esp32c3]
platform = espressif32
board = adafruit_qtpy_esp32c3
framework = arduino

lib_deps =
adafruit/Adafruit ST7735 and ST7789 Library
adafruit/Adafruit GFX Library

build_flags =
-DUSER_SETUP_LOADED=1
-include src/User_Setup.h

monitor_speed = 115200
upload_speed = 921600
</syntaxhighlight>On remarque l'inclusion du User_Setup.h montré ci dessus.

Et dans le code source on ajoute:<syntaxhighlight lang="c">
#include <Adafruit_GFX.h>
#include <Adafruit_ST7735.h>
</syntaxhighlight>On déclare un objet Adafruit_ST7735 avec les broches données ci dessus.<syntaxhighlight lang="c">
Adafruit_ST7735 tft = Adafruit_ST7735(TFT_CS, TFT_DC, MOSI_PIN, SCK_PIN, TFT_RST);

</syntaxhighlight>et on l'initialise dans <code>setup()</code> :<syntaxhighlight lang="c">tft.initR(INITR_144GREENTAB);
tft.setRotation(3);
tft.fillScreen(ST77XX_BLACK); // Fill the screen with black color
delay(100);
tft.setRotation(2);</syntaxhighlight>Ici y'a deux remarques:

* La constante INITR_144GREENTAB est à utiliser car le standard INITR_BLACKTAB est en mode RGB alors que notre écran est BGR (pourquoi ... pour faire genre je suppose).
* Ensuite, lors du premier démarrage le tft.fillScreen(ST77XX_BLACK); "oublie" quelques lignes de pixels a droite et, pour éviter ce probléme je remplis deux fois en tournant virtuellement l'écran. Il y a peut-etre une conf qui m'échappe...

==== Exemple complet ====
Un programe démo complet est donné ici.

C'est un "LED Blink" amélioré.

Il fait clignoter la LED sur GPIO11 au rythme de une fois par seconde (1000 ms) ajustable.

L'écran affichera:

<<ICI IMAGE>>

On a en vert le période de "blink" et en blanc sur fond bleu le temps depuis le boot du device HH:MM:SS.

Un petit bandeau bleu a gauche indique que les boutons "+" et "-" permettent d'ajouter ou de retirer 10 ms à la période.

RST est également affiché a côté du bouton reset.

Le projet est constitué de 3 fichiers :

===== platformio.ini =====
<syntaxhighlight lang="ini">[env:adafruit_qtpy_esp32c3]
platform = espressif32
board = adafruit_qtpy_esp32c3
framework = arduino

lib_deps =
adafruit/Adafruit ST7735 and ST7789 Library
adafruit/Adafruit GFX Library

build_flags =
-DUSER_SETUP_LOADED=1
-include src/User_Setup.h

monitor_speed = 115200
upload_speed = 921600</syntaxhighlight>

===== User_Setup.h =====
<syntaxhighlight lang="c">
#define USER_SETUP_ID 44

#define ST7735_DRIVER
#define TFT_WIDTH 128
#define TFT_HEIGHT 128

// Pinout du module Mini-TV ESP32-C3
#define SD_CS 5
#define TFT_CS 2
#define TFT_DC 0
#define TFT_RST 5
#define MOSI_PIN 4
#define SCK_PIN 3

#define LED_PIN 11 // GPIO11 sur ESP32-C3
#define SWITCH_0 8 // GPIO08 sur ESP32-C3
#define SWITCH_1 10 // GPIO10 sur ESP32-C3

#define TFT_RGB_ORDER TFT_BGR
#define TFT_INVERSION_ON
#define TFT_ROTATION 1

#define SPI_FREQUENCY 27000000

</syntaxhighlight>

===== main.cpp =====
<syntaxhighlight lang="c++">
#include <Arduino.h>
#include <Adafruit_GFX.h>
#include <Adafruit_ST7735.h>
#include <Fonts/FreeSans9pt7b.h>
#include <Fonts/FreeSans12pt7b.h>

Adafruit_ST7735 tft = Adafruit_ST7735(TFT_CS, TFT_DC, MOSI_PIN, SCK_PIN, TFT_RST);

int periode = 1000;

void display(){
tft.fillScreen(tft.color565(128, 128, 128)); // Fill the screen with black color
tft.setCursor(20, 15); // Set cursor at the top-left corner
tft.setTextColor(ST77XX_WHITE); // Set text color to white
tft.setFont();
tft.print("Blink test..."); // Print the message
tft.fillRect(0,0,15,TFT_HEIGHT,tft.color565(0, 0, 128));
tft.drawRect(0,0,15,TFT_HEIGHT,ST77XX_BLACK);

tft.setCursor(5, 10); tft.print("+");
tft.setCursor(5, 110); tft.print("-");
tft.setCursor(100, 110); tft.print("RST");

}

void update(){
int16_t margin=5;
int16_t x=25;
int16_t y=50;
int16_t x1, y1;
uint16_t w, h;
String displayStr=" "+String(millis())+" ms ";
tft.setFont(&FreeSans9pt7b);
tft.setTextSize(1);
tft.getTextBounds(displayStr, x, y, &x1, &y1, &w, &h);
uint16_t real_w = TFT_WIDTH-x1-margin;
tft.fillRect(x1-margin, y1-margin, real_w, h+margin*2, ST77XX_BLACK); // efface la zone
tft.setCursor(x, y); // Set cursor at the top-left corner
tft.setTextColor(ST77XX_GREEN); // Set text color to green
tft.print(String(periode)+" ms"); // Print the message
}

void update_time(){
int16_t margin=5;
int16_t x=25;
int16_t y=90;
int16_t x1, y1;
uint16_t w, h;
uint32_t ti=millis();
uint16_t ss=ti/1000;
uint16_t mm=ss/60;
ss=ss-(mm*60);
uint16_t hh=mm/60;
mm=mm-(hh*60);
String displayStr=(hh < 10 ? String("0") : String(""))+String(hh)+":"+\
(mm < 10 ? String("0") : String(""))+String(mm)+":"+\
(ss < 10 ? String("0") : String(""))+String(ss);
tft.setFont(&FreeSans12pt7b);
tft.setTextSize(1);
tft.getTextBounds(displayStr, x, y, &x1, &y1, &w, &h);
uint16_t real_w = TFT_WIDTH-x1-margin;
tft.fillRect(x1-margin, y1-margin, real_w, h+margin*2, tft.color565(0, 0, 128)); // efface la zone
tft.drawRect(x1-margin, y1-margin, real_w, h+margin*2,ST77XX_BLACK);
tft.setTextColor(ST77XX_WHITE);
tft.setCursor(x, y);
tft.print(displayStr);
}

void setup() {
Serial.begin(115200);
delay(1000);

Serial.println("Démarrage ESP32-C3...");
Serial.println(periode);
pinMode(LED_PIN, OUTPUT);
pinMode(SWITCH_0, INPUT_PULLUP);
pinMode(SWITCH_1, INPUT_PULLUP);
Serial.println("Init écran ST7735...");
tft.initR(INITR_144GREENTAB);
tft.setRotation(3);
tft.fillScreen(ST77XX_BLACK); // Fill the screen with black color
delay(100);
tft.setRotation(2);
tft.setTextSize(1);
display();
update();
}

void loop() {
if (digitalRead(SWITCH_0)==LOW){
periode-=10;
if (periode<100)
periode=100;
Serial.println(periode);
update();
delay(10);
while (digitalRead(SWITCH_0)==LOW)
delay(10);
}

if (digitalRead(SWITCH_1)==LOW){
periode+=10;
if (periode>2000)
periode=2000;
Serial.println(periode);
update();
delay(10);
while (digitalRead(SWITCH_1)==LOW)
delay(10);
}

if ((millis() % periode)< (periode/2))
digitalWrite(LED_PIN, HIGH);
else
digitalWrite(LED_PIN, LOW);

if ((millis() % 1000)==0)
update_time();

}

</syntaxhighlight>

Fichier:ST7735 PINOUT.png

2026-05-08T13:07:05Z

Jpinon :

Branchement ST7735

Infrastructure basée PI

2026-05-05T12:08:53Z

Jpinon :

[[Fichier:Image.png|vignette]]
L'architecture PILAN ressemble à quelque chose comme ça:

[[Fichier:Archi pilan.png|sans_cadre|769x769px]]

Accueil

2026-05-02T21:29:12Z

Jpinon : utiliser la camera du raspberry PI

Bienvenu sur ma nouvelle "Knowledge base" [[Spécial:Version|Version]] autohébergée.

Une page temporaire pour la mise à jour de ce wiki-ci: [[MAJ WIKI]] (a faire)
{| class="wikitable"
! rowspan="5" |Développement
| colspan="2" |[[Fichier:Logo C++.png|sans_cadre|61x61px]] C/C++ : '''LE''' Langage de programation.
|Les [[sockets C]]
Gérer l'écran "à la vi" avec [[Curses en C|curses]]

Gérer le [[Temps à la milliseconde en C|temps à la milliseconde]].
|-
| colspan="2" |[[Fichier:Perl logo.png|sans_cadre|48x48px]]Perl : Le meilleur langage de script.
|Quelques [[Quelques modules Perl|modules Perl]] utiles.
Petits [[hacks en perl]].
|-
| colspan="2" |[[Fichier:Python Logo.png|alt=Python|sans_cadre|74x74px]]Python : Pas mon préféré mais il est tellement utilisé!
|Syntaxe [[Les bases de Python|de base]],
Gestion des [[Exceptions en Python|exceptions]].

Python et ses [[Environnements virtuels Python|environnements virtuels]].

Les [[Modules et outils de développement Python|modules et les outils de développement]].

[[Gestion des documents PDF en Python|Gestion des documents PDF]].

[[Petits exemples de code Python|Petits exemples de code]].
|-
|Outils
|[[Fichier:Git logo.png|sans_cadre|67x67px]]Git
|[[GIT Utilisation simple|Utilisation simple]]
[[GIT-HUB]]
|-
|Shell
|sh/bash
|Syntaxe du [[If en bash|if]].
Syntaxe de [[For in bash|for]].

Traiter des [[CSV bash|fichiers csv]]
Traitement de phrases [[Encodage d'objets complexes#Usage en shell (commande jq)|JSON avec jq]]

[[Bash random|Générer de hasard]].
|-
! rowspan="8" |Système
| rowspan="2" |Global
|[[Encodage]] de caractères
|Le [[code morse]], le [[code baudot]], les codes [[ASCII]], les séquences [[ANSI]] le code [[Code Gray|Gray]] et un OVNI, le code [[Extended Binary Coded Decimal Interchange Code|EBCEDIC]]
les code [[UNICODE]].
|-
|Encodage d'objets
|Les [[entiers]]
le [[temps]]

Les [[nombres flottants]]

[[Encodage d'objets complexes|Les objets complexes]]

Encodage de binaire en [[base64]].
|-
| rowspan="3" |Linux [[Fichier:Linux-logo.png|sans_cadre|93x93px]]
|Général
|[[Généralités Linux|Généralités]] quel que soient les distributions de linux (ou UNIX).
Lancer un [[deamon avec systemd]].

Configurer une client [[Connexion SSH|ssh]].

Installer [[web-ssh]]
|-
|Debian (Ubuntu...)
|[[Gestion des services Debian/Ubuntu|Gestion des services]]

[[Nettoyage APT]]

Informations sur une [[Info distribution DEBIAN|distribution]]
|-
|WSL
|[[Relancer WSL]]

[[Monter un disque externe dans wsl]]

[[Utiliser un port USB dans WSL]]
|-
|Windows [[Fichier:Microsoft Windows Logo.png|sans_cadre|96x96px]]
|..., 10, 11
|[[Wireshark]] <sub>(images manquantes)</sub>
CYGWIN

[[MINGW32]]

[[Scoop]]
|-
|[[Open WRT]]
[[Fichier:Open WRT LOGO.png|sans_cadre|135x135px]]
|Global
[[GL Inet]]

[[Fichier:Gl-inet-router.png|sans_cadre|147x147px]]
|[[GL Inet Reset|Reset]] sortie d'usine.
Réglage du serveur [[Open WRT DHCP|DHCP]]

Ajouter un [[OpenWRTpackages|package]].

[[Open WRT Commandes de base pour le réseau|Commandes de base pour le réseau]].

[[tcpdump]]

Comment [[configurer un routeur pour activer le ssh depuis le côté WAN.]]

Comment [[configurer un routeur pour activer le WEB depuis le coté WAN]]

Gérer des ampoules [[Wiz et OpenWRT|Phillips Wiz]].

Installer un outil de [[Test de la bande passante Open WRT|test de la bande passante]] de la patte "wan"
|-
|Auto hébergement
[[Fichier:AnarchySymbol.png|sans_cadre|107x107px]]
|[[Fichier:Raspberry.png|sans_cadre|40x40px]] [[Raspberry PI]]
|L'auto hébergement est assez facile à réaliser chez sois. Une solution est d'utiliser un ou plusieurs raspberry PI.
[[Auto Hebergement|La base]] explique l'installation de base d'un PI comme module de base.

REPRISE de l'architecture. Je vais tenter une refonte de cette section. Elle devrait remplacer celle ci dessus

# [[Infrastructure basée PI|Architecture]]
# <code>front-router</code>[[Le routeur en tête réseau PI|Le routeur en tête]]
# [[Node-red dans le LAN|Un serveur Node-red]]
#<code>git</code>[[PI GitLab|Un serveur Git]]
#<code>database</code>[[PI MariaDB|Un serveur de base de données]]
#<code>mediawiki</code> [[PI MediaWiki|Un serveur mediawiki]]
|-
! rowspan="3" |APIs
| rowspan="3" |Géolocalisation et cartographie
|IP API
|[[Abstract API]] Donne une localisation a partir d'une IP
[[IPinfo]] Une autre bibliotheque de localisation d'IP
|-
|Ephemérides
|[[Sunset and sunrise times API]] va nous dire quand le soleil se lève quand il se couche, la lune…
|-
|Trafic Aérien
|[[FlightRadar24]]
|-
! rowspan="6" |Logiciels
| rowspan="4" |Middleware
|Bases de données relationelles
|Le langage [[SQL]]
Les "minimales": [[MariaDB]]

Les encore plus minimales: [[SQLite]]

Les maximales: [[Oracle]], [[PostgeSQL]]
|-
|Bases de données NoSQL
|[[mongodb]]
|-
|Messages
|[[MQTT]]
|-
|Serveur applicatifs/web
|[[Apache]]

[[Weblogic]]
|-
| rowspan="2" |Bureautique
|Excel
|[[Gestion des dates sous Excel|Gestion des dates]]<nowiki/>
[[EXCEL Gestion des chaines de caractères|Gest]][[EXCEL Gestion des chaines de caractères|io]][[EXCEL Gestion des chaines de caractères|n d]][[EXCEL Gestion des chaines de caractères|es cha]][[EXCEL Gestion des chaines de caractères|în]][[EXCEL Gestion des chaines de caractères|es de c]][[EXCEL Gestion des chaines de caractères|ar]][[EXCEL Gestion des chaines de caractères|actère]][[EXCEL Gestion des chaines de caractères|s]]

[[Identifier si la clé d'une ligne est présente dans un autre tableau]].
|-
|Outlook
|[[Outlook - Gestion des archives|Gestion des archives]]
|-
! rowspan="4" |Sécurite
|Chiffrement / déchiffrage
|OpenSSL
|[[Les bases de Open SSL|La base]]
[[OpenSSL et AES]] (symetrique)

[[OpenSSL_et_RSA]] (asymetrique)

Avec [[SMIME et Certificats x509|x509 et SMIME]] on marie les deux

Comment [[OpenSSL extraire un certificat|extraire un certificat]] d'un serveur en production.

PGP et [[GPG]] (chiffrer de documents)

Générer un [[mode de passe sécurisé]]

Les autres commandes [[openssl]].
|-
| rowspan="3" |Certificats
|Generalités
|[[Les certificats X.509|Un certificat c'est quoi?]]
|-
|PKI
|[[PKI familiale|Faire une PKI "familiale"]]
|-
|https
|[[Certificats Serveur https|Certificats Serveur]]
[[Certificats Client https|Certificats Client]]

[[Let's encrypt]]
|-
! rowspan="10" |Embarqué
| rowspan="3" |Microcontroleurs
|[[Fichier:Arduino Logo.png|sans_cadre|40x40px]][[Arduino]]
|
|-
|[[ESP8266]]
|Le module [[SON/OFF Smart Switch|Smart Switch]] de SONOFF
|-
|[[Fichier:Espessif logo.png|gauche|sans_cadre|40x40px]][[ESP32]]
|Environnement de dev [[ESP-IDF]], Utiliser [[mkspiffs]].
La carte "breakout" [[ESP32_DEVKITV1]]
La carte "AZ delivery" [[ESP32_DEVKITV2]]

Faire des [[ESP32 Requetês HTTPs|requetês HTTPs]]

[[ESP32 Firmware Update|Firmware Update]]

[[ESP32 Matrice de led|Exemple d'utilisation de matrice de LED]] (circuit MAX 72xx)

Programmation module [[ESP32C3 avec écran spotear]].
|-
!Fusion
|Dev ESP 32 sur Raspberry PI
|Ici un article qui touche aux deux sujets. [[Poste de DEV ESP32 sur PI|Comment programmes les microcontrôleurs ESP32 à partir d'un raspberry PI]].
|-
| rowspan="3" |SBC (single board computers)
| rowspan="2" |[[Fichier:Logo PI.png|sans_cadre|36x36px]][[Raspberry PI]]
|[[Les modèles de Raspberry PI]]
La configuration réseau [[DHCP ou IP fixe]]

Ecran [[Écran Adafruit 2.8 pouces TFT|Adafruit 2.8']]'et [[Cohabitation écran Adafruit PiTFT 2.8" et HDMI|Cohabitation des écrans]].

Utiliser le [[frame-buffer]]

[[Demarrer PI4 en USB|Gérer un PI4 dont le lecteur de carte SD est HS]].

Utiliser la [[camera PI]]
|-
|Installer :
[[RPi-NodeRed|NodeRed]], [[Mosquitto]], [[MariaDB sur Raspberry PI|MariaDB]]

Le service graphique de gestion des mises à jour [[PackageKit]]
|-
|[[Fichier:Bpi.png|sans_cadre|48x48px]]Banana PI
|
|-
| rowspan="3" |Objets connectés
|[[Fichier:PHILLIPS HUE LOGO.png|sans_cadre|87x87px]]
|Description [[PHILLIPS HUE|API]] de base
Le site de Phillips : https://developers.meethue.com/develop/hue-api-v2/getting-started/
|-
|[[Fichier:X-sense logo.png|sans_cadre|52x52px]]x-sense
|[[X-sense|Description générale]]
Utilisation avec le module [[python-xsense]]
|-
|Phillips Wiz
|Les limites de ces [[Securite PHILLIPS WIZ|ampoules au niveau sécurité]].
Utilisation avec un [[Wiz et OpenWRT|routeur OpenWrt]]
|-
! rowspan="9" |Electronique
|Composants
|Composants actifs
|[[Le transistor bipolaire]]
|-
|Circuits
|Filtres
|Filtre de rejection : https://poujouly.net/2015/10/25/filtre-notch-50hz/ (oui un lien externe pour le moment)
|-
| rowspan="5" |Le labo
|Le protocoles
|[[UART/RS323]]

[[SCPI uart]]
|-
| rowspan="4" |Les outils de mesures connectables
|[[Multimètre]] modèle :

* [[Multicomp PRO MP730027]]
|-
|[[Générateur de fonctions arbitraire]] modèles :

* [[GwINSTEK AFG-2012]]
* [[Multicomp MP75511]]
* [[FeelTech FY6600]]
|-
|[[Osciloscope]]
|-
|[[Alimantation]]

[[Alimentation USB C]]
|-
| rowspan="2" |Conception
|[[Fichier:Autodesk Eagle logo.png|sans_cadre|123x123px]]
|Logiciel de conception de circuits et de modélisation de circuit imprimés.
[[EAGLE - Plans de masse|Plans de masse]]

[[Les unités dans EAGLE]]
|-
|LTspice
|Logiciel de simulation électronique
[[LTspice fichier de simulation|Utiliser un signal numérisé en entré d'une simulation]].
|-
! rowspan="7" |CAO FAO
| rowspan="2" |Mécanique
|Visserie
|[[Fichier:Logo-iso.png|sans_cadre|105x105px]][[Dimensions visserie ISO]]
|-
|Usinage
|Dimensions des [[fraises en unités Imériales/US]]
|-
|Fabrication additive
|Imprimantes 3D FDM
|[[Fichier:Ultimaker logo.png|sans_cadre|37x37px]] [[Ultimaker 2]]
|-
|CNC
|Fraiseuses
|La base… la [[CNC 3018|3018]].
Faire des perçages avec un [[CNC Percages gcode|programme python]].

Graver des [[PCB avec CNC|PCB]]

[[Changer la broche CNC3018|Changer la broche]]
|-
|Découpeuse (Vinyle ou autre)
|Silhouette
|[[SILHOUETTE Paramètres de base|Paramètres de base]]
|-
|Logiciels de CAO
|[[Fichier:Freecad logo.png|alt=FREE CAD|sans_cadre|47x47px]]FreeCad
|[[FreeCad]]
|-
|Outillage
|Metrologie
|[[Comparateur Numérique]]
|-
! rowspan="5" |Projets complets
| rowspan="4" |Création/Configuration de serveur
| rowspan="4" |Exemple chez GANDI
|[[Serveur mediawiki basé docker]]
|-
|[[Serveur nodered basé docker]]
|-
|[[Serveur Owncloud]]
|-
|[[Serveur DNS GANDI|Serveur DNS]]
|-
|Objets connectés
|ESP32
|[[ESP32 Horloge à LED|Une Horloge à LED]]
|-
! rowspan="3" |Photos
|Matériel
|D90
[[Fichier:D90.png|sans_cadre|58x58px]]
|[[Connectique D90|Connectique]]
|-
|Théorie
|
|Les [[bases en optique pour la photo]]
|-
|Logiciel
|
|
|}

Vocabulaire en cryptographie

2026-04-29T09:52:27Z

Jpinon :

= Types cryptographiques du Linux Kernel Crypto API =

Cette page resume les principaux types d'algorithmes utilises dans l'API Crypto du noyau Linux.
Chaque type correspond a une famille fonctionnelle d'operations cryptographiques ou de compression.

== akcipher ==
''Asymmetric Key Cipher''
Algorithmes de chiffrement asymetrique utilisant une cle publique et une cle privee.
Utilisations : signature, verification, chiffrement, dechiffrement.
Exemples : RSA, ECDSA.

== cipher ==
''Symmetric Cipher''
Algorithmes de chiffrement symetrique utilisant une cle unique pour chiffrer et dechiffrer.
Exemples : AES, DES, ChaCha20.

== compression ==
''Compression Algorithms''
Algorithmes de compression et decompression integres au noyau.
Exemples : DEFLATE, LZ4, Zstd.

== kpp ==
''Key Pair Protocol''
Algorithmes d'echange de cles permettant a deux parties de derivier un secret partage.
Exemples : Diffie-Hellman, ECDH.

== lskcipher ==
''Synchronous Symmetric Key Cipher''
Version synchrone des algorithmes de chiffrement symetrique.
Utilisee pour chiffrer des buffers en mode bloc ou flux.

== scomp ==
''Synchronous Compression''
Version synchrone des algorithmes de compression.
Fonctionne de maniere immediate, sans pipeline asynchrone.

== shash ==
''Synchronous Hash''
Algorithmes de hachage synchrones.
Utilises pour l'integrite, les MAC, les signatures, etc.
Exemples : SHA-1, SHA-256, [[MD5]].

= Resume =
{| class="wikitable"
! Terme !! Domaine !! Description
|-
| akcipher || Asymetrique || Chiffrement et signatures a cle publique
|-
| cipher || Symetrique || Chiffrement bloc ou flux
|-
| compression || Compression || Compression et decompression
|-
| kpp || Echange de cles || DH, ECDH
|-
| lskcipher || Symetrique synchrone || Chiffrement synchrone
|-
| scomp || Compression synchrone || Compression immediate
|-
| shash || Hachage synchrone || SHA, MD5
|}
Icones avec <a href="https://www.flaticon.com/fr/icones-gratuites/cles" title="clés icônes">Clés icônes créées par Maan Icons - Flaticon</a>

Accueil

2026-04-26T12:05:28Z

Jpinon :

Bienvenu sur ma nouvelle "Knowledge base" [[Spécial:Version|Version]] autohébergée.

Une page temporaire pour la mise à jour de ce wiki-ci: [[MAJ WIKI]] (a faire)
{| class="wikitable"
! rowspan="5" |Développement
| colspan="2" |[[Fichier:Logo C++.png|sans_cadre|61x61px]] C/C++ : '''LE''' Langage de programation.
|Les [[sockets C]]
Gérer l'écran "à la vi" avec [[Curses en C|curses]]

Gérer le [[Temps à la milliseconde en C|temps à la milliseconde]].
|-
| colspan="2" |[[Fichier:Perl logo.png|sans_cadre|48x48px]]Perl : Le meilleur langage de script.
|Quelques [[Quelques modules Perl|modules Perl]] utiles.
Petits [[hacks en perl]].
|-
| colspan="2" |[[Fichier:Python Logo.png|alt=Python|sans_cadre|74x74px]]Python : Pas mon préféré mais il est tellement utilisé!
|Syntaxe [[Les bases de Python|de base]],
Gestion des [[Exceptions en Python|exceptions]].

Python et ses [[Environnements virtuels Python|environnements virtuels]].

Les [[Modules et outils de développement Python|modules et les outils de développement]].

[[Gestion des documents PDF en Python|Gestion des documents PDF]].

[[Petits exemples de code Python|Petits exemples de code]].
|-
|Outils
|[[Fichier:Git logo.png|sans_cadre|67x67px]]Git
|[[GIT Utilisation simple|Utilisation simple]]
[[GIT-HUB]]
|-
|Shell
|sh/bash
|Syntaxe du [[If en bash|if]].
Syntaxe de [[For in bash|for]].

Traiter des [[CSV bash|fichiers csv]]
Traitement de phrases [[Encodage d'objets complexes#Usage en shell (commande jq)|JSON avec jq]]

[[Bash random|Générer de hasard]].
|-
! rowspan="8" |Système
| rowspan="2" |Global
|[[Encodage]] de caractères
|Le [[code morse]], le [[code baudot]], les codes [[ASCII]], les séquences [[ANSI]] le code [[Code Gray|Gray]] et un OVNI, le code [[Extended Binary Coded Decimal Interchange Code|EBCEDIC]]
les code [[UNICODE]].
|-
|Encodage d'objets
|Les [[entiers]]
le [[temps]]

Les [[nombres flottants]]

[[Encodage d'objets complexes|Les objets complexes]]

Encodage de binaire en [[base64]].
|-
| rowspan="3" |Linux [[Fichier:Linux-logo.png|sans_cadre|93x93px]]
|Général
|[[Généralités Linux|Généralités]] quel que soient les distributions de linux (ou UNIX).
Lancer un [[deamon avec systemd]].

Configurer une client [[Connexion SSH|ssh]].

Installer [[web-ssh]]
|-
|Debian (Ubuntu...)
|[[Gestion des services Debian/Ubuntu|Gestion des services]]

[[Nettoyage APT]]

Informations sur une [[Info distribution DEBIAN|distribution]]
|-
|WSL
|[[Relancer WSL]]

[[Monter un disque externe dans wsl]]

[[Utiliser un port USB dans WSL]]
|-
|Windows [[Fichier:Microsoft Windows Logo.png|sans_cadre|96x96px]]
|..., 10, 11
|[[Wireshark]] <sub>(images manquantes)</sub>
CYGWIN

[[MINGW32]]

[[Scoop]]
|-
|[[Open WRT]]
[[Fichier:Open WRT LOGO.png|sans_cadre|135x135px]]
|Global
[[GL Inet]]

[[Fichier:Gl-inet-router.png|sans_cadre|147x147px]]
|[[GL Inet Reset|Reset]] sortie d'usine.
Réglage du serveur [[Open WRT DHCP|DHCP]]

Ajouter un [[OpenWRTpackages|package]].

[[Open WRT Commandes de base pour le réseau|Commandes de base pour le réseau]].

[[tcpdump]]

Comment [[configurer un routeur pour activer le ssh depuis le côté WAN.]]

Comment [[configurer un routeur pour activer le WEB depuis le coté WAN]]

Gérer des ampoules [[Wiz et OpenWRT|Phillips Wiz]].

Installer un outil de [[Test de la bande passante Open WRT|test de la bande passante]] de la patte "wan"
|-
|Auto hébergement
[[Fichier:AnarchySymbol.png|sans_cadre|107x107px]]
|[[Fichier:Raspberry.png|sans_cadre|40x40px]] [[Raspberry PI]]
|L'auto hébergement est assez facile à réaliser chez sois. Une solution est d'utiliser un ou plusieurs raspberry PI.
[[Auto Hebergement|La base]] explique l'installation de base d'un PI comme module de base.

REPRISE de l'architecture. Je vais tenter une refonte de cette section. Elle devrait remplacer celle ci dessus

# [[Infrastructure basée PI|Architecture]]
# <code>front-router</code>[[Le routeur en tête réseau PI|Le routeur en tête]]
# [[Node-red dans le LAN|Un serveur Node-red]]
#<code>git</code>[[PI GitLab|Un serveur Git]]
#<code>database</code>[[PI MariaDB|Un serveur de base de données]]
#<code>mediawiki</code> [[PI MediaWiki|Un serveur mediawiki]]
|-
! rowspan="3" |APIs
| rowspan="3" |Géolocalisation et cartographie
|IP API
|[[Abstract API]] Donne une localisation a partir d'une IP
[[IPinfo]] Une autre bibliotheque de localisation d'IP
|-
|Ephemérides
|[[Sunset and sunrise times API]] va nous dire quand le soleil se lève quand il se couche, la lune…
|-
|Trafic Aérien
|[[FlightRadar24]]
|-
! rowspan="6" |Logiciels
| rowspan="4" |Middleware
|Bases de données relationelles
|Le langage [[SQL]]
Les "minimales": [[MariaDB]]

Les encore plus minimales: [[SQLite]]

Les maximales: [[Oracle]], [[PostgeSQL]]
|-
|Bases de données NoSQL
|[[mongodb]]
|-
|Messages
|[[MQTT]]
|-
|Serveur applicatifs/web
|[[Apache]]

[[Weblogic]]
|-
| rowspan="2" |Bureautique
|Excel
|[[Gestion des dates sous Excel|Gestion des dates]]<nowiki/>
[[EXCEL Gestion des chaines de caractères|Gest]][[EXCEL Gestion des chaines de caractères|io]][[EXCEL Gestion des chaines de caractères|n d]][[EXCEL Gestion des chaines de caractères|es cha]][[EXCEL Gestion des chaines de caractères|în]][[EXCEL Gestion des chaines de caractères|es de c]][[EXCEL Gestion des chaines de caractères|ar]][[EXCEL Gestion des chaines de caractères|actère]][[EXCEL Gestion des chaines de caractères|s]]

[[Identifier si la clé d'une ligne est présente dans un autre tableau]].
|-
|Outlook
|[[Outlook - Gestion des archives|Gestion des archives]]
|-
! rowspan="4" |Sécurite
|Chiffrement / déchiffrage
|OpenSSL
|[[Les bases de Open SSL|La base]]
[[OpenSSL et AES]] (symetrique)

[[OpenSSL_et_RSA]] (asymetrique)

Avec [[SMIME et Certificats x509|x509 et SMIME]] on marie les deux

Comment [[OpenSSL extraire un certificat|extraire un certificat]] d'un serveur en production.

PGP et [[GPG]] (chiffrer de documents)

Générer un [[mode de passe sécurisé]]

Les autres commandes [[openssl]].
|-
| rowspan="3" |Certificats
|Generalités
|[[Les certificats X.509|Un certificat c'est quoi?]]
|-
|PKI
|[[PKI familiale|Faire une PKI "familiale"]]
|-
|https
|[[Certificats Serveur https|Certificats Serveur]]
[[Certificats Client https|Certificats Client]]

[[Let's encrypt]]
|-
! rowspan="10" |Embarqué
| rowspan="3" |Microcontroleurs
|[[Fichier:Arduino Logo.png|sans_cadre|40x40px]][[Arduino]]
|
|-
|[[ESP8266]]
|Le module [[SON/OFF Smart Switch|Smart Switch]] de SONOFF
|-
|[[Fichier:Espessif logo.png|gauche|sans_cadre|40x40px]][[ESP32]]
|Environnement de dev [[ESP-IDF]], Utiliser [[mkspiffs]].
La carte "breakout" [[ESP32_DEVKITV1]]
La carte "AZ delivery" [[ESP32_DEVKITV2]]

Faire des [[ESP32 Requetês HTTPs|requetês HTTPs]]

[[ESP32 Firmware Update|Firmware Update]]

[[ESP32 Matrice de led|Exemple d'utilisation de matrice de LED]] (circuit MAX 72xx)

Programmation module [[ESP32C3 avec écran spotear]].
|-
!Fusion
|Dev ESP 32 sur Raspberry PI
|Ici un article qui touche aux deux sujets. [[Poste de DEV ESP32 sur PI|Comment programmes les microcontrôleurs ESP32 à partir d'un raspberry PI]].
|-
| rowspan="3" |SBC (single board computers)
| rowspan="2" |[[Fichier:Logo PI.png|sans_cadre|36x36px]][[Raspberry PI]]
|[[Les modèles de Raspberry PI]]
La configuration réseau [[DHCP ou IP fixe]]

Ecran [[Écran Adafruit 2.8 pouces TFT|Adafruit 2.8']]'et [[Cohabitation écran Adafruit PiTFT 2.8" et HDMI|Cohabitation des écrans]].

Utiliser le [[frame-buffer]]

[[Demarrer PI4 en USB|Gérer un PI4 dont le lecteur de carte SD est HS]].
|-
|Installer :
[[RPi-NodeRed|NodeRed]], [[Mosquitto]], [[MariaDB sur Raspberry PI|MariaDB]]

Le service graphique de gestion des mises à jour [[PackageKit]]
|-
|[[Fichier:Bpi.png|sans_cadre|48x48px]]Banana PI
|
|-
| rowspan="3" |Objets connectés
|[[Fichier:PHILLIPS HUE LOGO.png|sans_cadre|87x87px]]
|Description [[PHILLIPS HUE|API]] de base
Le site de Phillips : https://developers.meethue.com/develop/hue-api-v2/getting-started/
|-
|[[Fichier:X-sense logo.png|sans_cadre|52x52px]]x-sense
|[[X-sense|Description générale]]
Utilisation avec le module [[python-xsense]]
|-
|Phillips Wiz
|Les limites de ces [[Securite PHILLIPS WIZ|ampoules au niveau sécurité]].
Utilisation avec un [[Wiz et OpenWRT|routeur OpenWrt]]
|-
! rowspan="9" |Electronique
|Composants
|Composants actifs
|[[Le transistor bipolaire]]
|-
|Circuits
|Filtres
|Filtre de rejection : https://poujouly.net/2015/10/25/filtre-notch-50hz/ (oui un lien externe pour le moment)
|-
| rowspan="5" |Le labo
|Le protocoles
|[[UART/RS323]]

[[SCPI uart]]
|-
| rowspan="4" |Les outils de mesures connectables
|[[Multimètre]] modèle :

* [[Multicomp PRO MP730027]]
|-
|[[Générateur de fonctions arbitraire]] modèles :

* [[GwINSTEK AFG-2012]]
* [[Multicomp MP75511]]
* [[FeelTech FY6600]]
|-
|[[Osciloscope]]
|-
|[[Alimantation]]

[[Alimentation USB C]]
|-
| rowspan="2" |Conception
|[[Fichier:Autodesk Eagle logo.png|sans_cadre|123x123px]]
|Logiciel de conception de circuits et de modélisation de circuit imprimés.
[[EAGLE - Plans de masse|Plans de masse]]

[[Les unités dans EAGLE]]
|-
|LTspice
|Logiciel de simulation électronique
[[LTspice fichier de simulation|Utiliser un signal numérisé en entré d'une simulation]].
|-
! rowspan="7" |CAO FAO
| rowspan="2" |Mécanique
|Visserie
|[[Fichier:Logo-iso.png|sans_cadre|105x105px]][[Dimensions visserie ISO]]
|-
|Usinage
|Dimensions des [[fraises en unités Imériales/US]]
|-
|Fabrication additive
|Imprimantes 3D FDM
|[[Fichier:Ultimaker logo.png|sans_cadre|37x37px]] [[Ultimaker 2]]
|-
|CNC
|Fraiseuses
|La base… la [[CNC 3018|3018]].
Faire des perçages avec un [[CNC Percages gcode|programme python]].

Graver des [[PCB avec CNC|PCB]]

[[Changer la broche CNC3018|Changer la broche]]
|-
|Découpeuse (Vinyle ou autre)
|Silhouette
|[[SILHOUETTE Paramètres de base|Paramètres de base]]
|-
|Logiciels de CAO
|[[Fichier:Freecad logo.png|alt=FREE CAD|sans_cadre|47x47px]]FreeCad
|[[FreeCad]]
|-
|Outillage
|Metrologie
|[[Comparateur Numérique]]
|-
! rowspan="5" |Projets complets
| rowspan="4" |Création/Configuration de serveur
| rowspan="4" |Exemple chez GANDI
|[[Serveur mediawiki basé docker]]
|-
|[[Serveur nodered basé docker]]
|-
|[[Serveur Owncloud]]
|-
|[[Serveur DNS GANDI|Serveur DNS]]
|-
|Objets connectés
|ESP32
|[[ESP32 Horloge à LED|Une Horloge à LED]]
|-
! rowspan="3" |Photos
|Matériel
|D90
[[Fichier:D90.png|sans_cadre|58x58px]]
|[[Connectique D90|Connectique]]
|-
|Théorie
|
|Les [[bases en optique pour la photo]]
|-
|Logiciel
|
|
|}

Fichier:Logo-iso.png

2026-04-26T12:05:07Z

Jpinon :

visserie iso

Fichier:MP750511-face.png

2026-04-23T20:55:20Z

Jpinon : Jpinon a téléversé une nouvelle version de Fichier:MP750511-face.png

Face avant du MP750511

Fichier:AFG-2012.png

2026-04-23T20:52:30Z

Jpinon : Jpinon a téléversé une nouvelle version de Fichier:AFG-2012.png

Le produit

Multimètre

2026-04-23T20:50:37Z

Jpinon :

Tout le monde a un multimètre (certains disent un voltmètre mais c'est souvent un multimètre).

[[Fichier:Divers multimetres.png|sans_cadre|244x244px]]

Mais nous n'allons pas parler de cela ici. Nous allons nous focaliser sur des appareils connectés. C'est la même chose, ça mesure la tension, l'intensité, la fréquence d'un courant la valeur d'une résistance ou d'une capacité....

En général ce sont des appareils de labo a poser sur la paillasse.

C'est plus gros et ça ressemble à ça:

[[Fichier:MP730027 EU-UK.png|alt=MP730027 EU-UK|sans_cadre]]

Si on regarde derrière on y voit plein de prises supplémentaires. Sur le mien y'a ça:

[[Fichier:ImageRear Panel Overview .png|sans_cadre|675x675px]]

On voit plein de choses intéressantes.

# Le trigger externe: si on configure le multimètre correctement il attendra une impulsion sur ce canal pour déclencher une mesure. C'est utile pour synchroniser la mesure à un évènement extérieur.
# AUX output c'est l'inverse, le multimètre peut informer électriquement (une impulsion aussi) que quelque chose s'est passé. On peut par exemple lui dire "si la tension passe au dessous de 2.5V avertis moi"
# RS232. Avec les connecteurs 4 et 5 c'est pas là que l'on peut automatiser les process. Par ce biais on peut configurer la mesure (CC ou CA, Gamme de mesure, rythme de mesure, courant, tension, fréquence...). Un protocole existe et est relativement normalisé c'est SCPI. La documentation de l'appareil vous donnera les fonctions qu'il sait utiliser.
# USB (la commande par un port USB)
# RJ45 (la commande par réseau au travers d'une connexion ethernet)
# Là ça deviens du classique c'est la tension du secteur 220 ou 110 (ou il y a encore des appareils qui détectent pas tout seuls. L'alim n'est peut être pas à découpage)
# Le fusible
# La prise secteur
# Pour relier la masse a quelque chose (une plaque de métal sur la paillasse ...)
# L'encoche pour l'antivol. Oui c'est un appareil qui se fauche bien. (dans une école par exemple)

Le multimétre présenté ci dessus est un [[multicomp PRO MP730027]] vendu par Farnell

Fichier:Divers multimetres.png

2026-04-23T20:49:51Z

Jpinon : Jpinon a téléversé une nouvelle version de Fichier:Divers multimetres.png

exemple de multimètres

Fichier:BoutonportMP730027.png

2026-04-23T20:46:43Z

Jpinon : Jpinon a téléversé une nouvelle version de Fichier:BoutonportMP730027.png

Le bouton PORT

Fichier:ImageRear Panel Overview .png

2026-04-23T20:41:59Z

Jpinon : dans le manuel

== Description ==
dans le manuel

Fichier:MP730027 EU-UK.png

2026-04-23T20:37:10Z

Jpinon : Jpinon a téléversé une nouvelle version de Fichier:MP730027 EU-UK.png

Mon multimetre de labo

Le routeur en tête réseau PI

2026-04-22T21:54:32Z

Jpinon : /* Installation des outils */

== Présentation ==
La première étape sera de créer ce qui sera la tête du réseau.

[[Fichier:Datacenter-schema-front.png|sans_cadre]]

Schématiquement on a un raspberry PI en frontal. Il n'a en aucun cas besoin de wifi donc un simple Raspbery PI2 sera suffisant.

En revanche il lui faudra deux "pattes" réseau donc un adaptateur USB - Ethernet sera nécessaire. De plus un écran [[Écran Adafruit 2.8 pouces TFT|Adafruit 2.8']] sera utilisé pour le "status".

=== Architecture réseau: ===

* eth0 (le port Ethernet standard) sera relié au WAN en tant que client DHCP. C'est sur le routeur auquel il est relié que le serveur DHCP attribuera (ou pas) une IP fixe.
* eth1 (le port Ethernet sur USB) sera relié au LAN. Il sera configuré en serveur DHCP et s'occupera du sub-net 10.11.11.0/24. Les autres raspberry seront reliés à ce port via un switch.
La configuration réseau n'est pas idéale car le contrôleur USB du PI2 n'est pas USB3 mais USB2 et le port ethernet natif est également un ethernet USB. Donc les deux ports partageront la bande passante de l'USB2 de 480 Mbs max.

L'utilisateur d'un adaptateur gigabit n'a donc pas vraiment d'intérêt car sur les 480 l'Ethernet embarqué utilise déjà 100Mbs... il en reste théoriquement 380 a disposition sans compter les conflits.

Bon moi j'ai un adaptateur gigabit car c'est le standard aujourd'hui! Je serais prêt si je dois passer à un Raspberry PI 4 qui gère de l'USB3 a 5Gbs et un Ethernet Gigabit. Je ne penses cependant pas que ce soit nécessaire. Le switch est gigabit et si, dans le LAN 10.11.11.0/24 on a deux PI4 ils communiqueront entre eux en gigabit.

Derrière on aura donc toute sorte de serveurs basés sur des raspberry PI du genre:

* Serveur node-red
* Serveur MariaDB
* Serveur MediaWiki
* Serveur Git
* ce dont on aura besoin...

=== Modules installés ===
Sur ce serveur "front" on aura donc installé:

* Un serveur DHCP pour eth1
* Un serveur ssh sur eth0 et eth1 utilisé comme "rebond"
* Un reverse proxy pour faire suivre les demandes vers les serveurs sur le "LAN 10.11.11"
* Un broker MQTT ouvert sur eth0 et eth1
* Un driver d"écran Adafruit 2.8'

== Installation ==

=== La carte SD ===
On utilise Raspberry Pi Imager https://www.raspberrypi.com/software/

[[Fichier:Datacenter-sd-1.png|sans_cadre]]

On choisit le modèle (moi c'est un raspberry PI 2 y'a pas besoin de mieux). Puis "SUIVANT"

[[Fichier:Datacenter-sd-2.png|sans_cadre]]

On ne veut pas de "desktop" on choisit "Raspberry PI OS (other)

[[Fichier:Datacenter-sd-3.png|sans_cadre]]

On choisit la dernière version sans desktop puis "SUIVANT"

[[Fichier:Datacenter-sd-4.png|sans_cadre]]

Moi j'ai qu'un seul port SD il n'y a pas d'ambiguïté je le sélectionne puis "SUIVANT"

[[Fichier:Datacenter-sd-5.png|sans_cadre]]

On donne le nom à notre serveur puis "SUIVANT"

[[Fichier:Datacenter-sd-6.png|sans_cadre]]

On donne la localisation puis "SUIVANT"

[[Fichier:Datacenter-sd-7.png|sans_cadre]]

On définit le nom de l'utilisateur et son mot de passe puis "SUIVANT"

[[Fichier:Datacenter-sd-8.png|sans_cadre]]

On peut ignorer le wifi dans notre cas (un raspberry PI 2 n'est pas équité!) "SUIVANT"

[[Fichier:Datacenter-sd-9.png|sans_cadre]]

On s'arrête un peut sur cette page.

On a définit un login que n'est pas "pi" mais qui peut être aisément trouvé. Notre mot de passe est sûrement très sécurisé mais toujours faillible. Comme le routeur sera probablement acessible de l'extérieur il est nécessaire, a mon avis, de sécuriser le process de login ssh par une clé. J'ai mis la clé publique du PC que j'utilise habituellement pour la maintenance. Une seconde clé pourra être ajouté ultérieurement.

"SUIVANT"

[[Fichier:Datacenter-sd-10.png|sans_cadre]]

Je ne penses pas que ce soit nécessaire d'utiliser Pi Connect, d'autant plus que le PI devra être le moins chargé possible. "SUIVANT"

[[Fichier:Datacenter-sd-11.png|sans_cadre]]

On a un dernier récapitulatif. "WRITE".

[[Fichier:Datacenter-sd-12.png|sans_cadre]]

Oui je comprends, on efface et on flashe la carte!

[[Fichier:Datacenter-sd-13.png|sans_cadre]]

Ca s'écrit... si une fenêtre proposant de formater la carte s'ouvre... fermez là.

[[Fichier:Datacenter-sd-14.png|sans_cadre]]

Apres avoir écrit la carte, on la vérifie (c'est indispensable pour être sûr de la qualité de la carte)

[[Fichier:Datacenter-sd-15.png|sans_cadre]]

C'est terminé. On peut soit en faire une seconde (un backup? mais il faudrait plutôt faire la copie après les étapes suivantes). "FINISH"

La carte est prête on peut lancer le premier boot.

On insère la carte dans le PI2 en question. On y branche un clavier et un écran (ne pas brancher l'adaptateur USB Ethernet la première fois) et GO! On blanche le courant.

=== Premier boot ===
Il boote correctement.

Moi il bloque un moment sur Network Manager mais continue (je penses que c'est eth1 sur le port USB qui n'est relié a rien qui le gène)

Il boote normalement, affiche la progression sur la console sur l'écran HDMI.

La fin est un succinct :

<code>[ OK ] Reached target '''cloud-init.target''' - Cloud-init target.</code>

Et rien ne se passe. C'est normal, pas de panique.

La console à l'écran se limite à... la console de base pour voir les erreurs. Pour se loguer il y a deux solutions :

* Par ssh depuis une autre machine
* en allant sur une autre console de login "hardware" grâce a <ctrl> + <F2> jusqu'à <F6>. La première <ctrl> <F1> sera toujours là ou seront affichés les messages.

On va configurer les trucs de base.

==== raspi-config ====
On lance le programme "raspi-config". On a fait beaucoup du travail au moment de la préparation de la carte SD mais il en reste un peu.<syntaxhighlight lang="bash">
sudo raspi-config
</syntaxhighlight>On a le "classique"

[[Fichier:Raspi-config.png|sans_cadre]]

Dans 1 "System options" choisir S6 "Autologin"

[[Fichier:Raspi-config-autologin.png|sans_cadre]]

Selectionner <Yes> qui nous réponds <code>"Console autologin is enabled"</code>.

Oui si quelqu'un rentre chez nous, branche un écran et un clavier sur la machine il sera logué automatiquement... c'est un risque que je prends car, comme ces machines marchent très bien et durent des années il m'arrive d'oublier leur mot de passe.

Dans 6 "Advanced Options" on choisit A1 "Expand Filesystem"

Et le PI nous réponds :<syntaxhighlight lang="text">
Root partition has been resized.
The filesystem will be enlarged upon the next reboot
</syntaxhighlight>On valide par <OK>

Au cas ou on lance un 8 "Update" mais si on vient de faire la carte il ne doit pas se passer grand chose.

On branche l'adaptateur USB Ethernet et on reboote<syntaxhighlight lang="bash">
sudo reboot
</syntaxhighlight>on voit le shutdown se dérouler sur la console et le redémarrage.

Le boot bloque un moment sur le démarrage du network manager sur eth1 mais on peut utiliser le serveur quand même.

On peut vérifier que le "resize filesystem" est bien passé:<syntaxhighlight lang="bash">
df -h /
Filesystem Size Used Avail Use% Mounted on
/dev/mmcblk0p2 229G 2.6G 217G 2% /
</syntaxhighlight>J'ai utilisé une carte de 256 Go on y est presque!

=== Configuration de l'écran ===
[[Fichier:Adafruit 2.8''.png|vignette|263x263px|L'écran Adafruit 2.8 pouces]]
Adafuit le fabricant de l'écran donnait autrefois une distribution spécifique pour cet écran. C'était rapide mais pas très "propre".

Maintenant il y a un script python pour faire ce travail. Adafuit donne le process ici: https://learn.adafruit.com/adafruit-2-8-pitft-capacitive-touch/easy-install-2

Je suis bon camarade je donne ici la méthode.

==== Installation des outils ====
Il faut d'abord installer les outils python de virtualisation d'environnement.<syntaxhighlight lang="bash">
sudo apt install python3-venv
python3 -m venv env --upgrade-deps --system-site-packages
source env/bin/activate
</syntaxhighlight>Ensuite on installe le script qui installera lui même l'écran.<syntaxhighlight lang="bash">
cd ~
sudo apt-get update # discutable
sudo apt-get install -y git python3-pip # aussi
pip3 install --upgrade adafruit-python-shell click Flask-SQLAlchemy
git clone https://github.com/adafruit/Raspberry-Pi-Installer-Scripts.git
cd Raspberry-Pi-Installer-Scripts
</syntaxhighlight>Bon je penses que certains <code>apt-get install</code> sont superflus mais je ne prends pas de risques.

==== Installation elle même ====
Ici chez Adafruit donne une instruction pour chaque modèle d'écran.

Pour l'écran 2.8<nowiki>''</nowiki> capacitif :<syntaxhighlight lang="bash">
sudo -E env PATH=$PATH python3 adafruit-pitft.py --display=28c --rotation=90 --install-type=console
</syntaxhighlight>SI j'avais utilisé la version résistive <syntaxhighlight lang="bash">
sudo -E env PATH=$PATH python3 adafruit-pitft.py --display=28r --rotation=90 --install-type=console
</syntaxhighlight>Ca se termine<syntaxhighlight lang="text">
PITFT Updating console to PiTFT...
Remove fbcp from /etc/rc.local, if it's there...
Configuring boot/config.txt for default HDMI
Installing console fbcon map helper...
Installing console fbcon map service...
PITFT Created symlink '/etc/systemd/system/multi-user.target.wants/con2fbmap.service' → '/etc/systemd/system/con2fbmap.service'.

PITFT Job for con2fbmap.service failed because the control process exited with error code.
See "systemctl status con2fbmap.service" and "journalctl -xeu con2fbmap.service" for details.
Turning off console blanking
Setting raspi-config to boot to console w/o login...
PITFT Success!

Settings take effect on next boot.

REBOOT NOW? [Y/n] Reboot started...
Connection to 192.168.0.77 closed by remote host.
Connection to 192.168.0.77 closed.
</syntaxhighlight>En rebootant le PI.

Et l'écran est actif.

Un dernier problème: Lorsque on reboote sans l'écran HDMI... l'écran LCD ne marche pas c'est ballot

===== Fichier config.txt =====

On l'édite avec<syntaxhighlight lang="bash">
sudo vi /boot/firmware/config.txt
</syntaxhighlight>La première chose est de DESACTIVER le son car: Si un écran HDMI est branché tout va bien le son est dirigé vers là. Mais il n'y a pas d'écran le son est dirigé vers le port jack 3.5 qui est géré par le GPIO 18 en PWM. On c'est ce GPIO qui est utilisé par Adafruit pour le rétro éclairage de l'écran. <syntaxhighlight lang="ini">
# Désactiver audio PWM
dtparam=audio=off
</syntaxhighlight>On désactive le son sur le JACK 3.3 comme ça. Le Raspberry PI 5 qui supprime le port jack 3.5 ne doit pas nécessiter cela.

Ensuite

Et on y trouves <syntaxhighlight lang="ini">
# --- added by adafruit-pitft-helper ---
[all]
hdmi_force_hotplug=0
dtparam=spi=on
dtparam=i2c1=on
dtparam=i2c_arm=on
dtoverlay=pitft28-capacitive,rotate=90,speed=64000000,fps=30,drm
# --- end adafruit-pitft-helper ---
</syntaxhighlight>Alors qu'avec :<syntaxhighlight lang="ini">
# --- added by adafruit-pitft-helper ---
[all]
dtparam=spi=on
dtparam=i2c1=on
dtparam=i2c_arm=on
dtoverlay=pitft28-capacitive,rotate=270,speed=64000000,fps=30,drm
dtoverlay=gpio-backlight,gpios=18,active_low=0
hdmi_force_hotplug=1
hdmi_group=2
hdmi_mode=82
# --- end adafruit-pitft-helper ---
</syntaxhighlight>C'est mieux.

J'ai ai profité pour retourner l'écran (rotate=270) car avec un rotatate=90 les boutons sont a gauche.

===== Le fichier cmdline.txt =====

Toujours pour le modifier:<syntaxhighlight lang="bash">
sudo vi /boot/firmware/cmdline.txt
</syntaxhighlight>On y trouve <syntaxhighlight lang="text">
console=serial0,115200 console=tty1 root=PARTUUID=b104592a-02 rootfstype=ext4 fsck.repair=yes rootwait cfg80211.ieee80211_regdom=FR
</syntaxhighlight>On supprime la "sérial console" et on active fbcon.<syntaxhighlight lang="text">
console=tty1 fbcon=map:10 root=PARTUUID=b104592a-02 rootfstype=ext4 fsck.repair=yes rootwait cfg80211.ieee80211_regdom=FR
</syntaxhighlight>On reboote et ca marche! Même sans l'écran HDMI.

Dans tous les cas on peut acceder au frame buffer sur /dev/fb1 pour la carte écran LCD.<syntaxhighlight lang="bash">
cp /dev/random /dev/fb1
</syntaxhighlight>et on voit du bruit sur l'écran.

==== Economiseur d'écran. ====
L'écran LCD est toujours allumé dans ce cas. C'est pratique mais ca chauffe énormément, ça l'use et ca consomme. Bref ppas top.

On va faire un économiseur d'écran. On pourrait le faire en détectant un appui dessus mais la date tactile du mien est morte. On a cependant 4 bon vieux boutons physiques que je vais utiliser.

On a des boutions marqués de haut en bas <code>#17</code>, <code>#22</code>, <code>#23</code> et <code>#27</code>.

Nous nous proposons d'utiliser le bouton du bas soit <code>#27</code>.

Le script bash est assez simple:<syntaxhighlight lang="bash" line="1">
#!/bin/bash
# /usr/local/bin/gpio-screen-saver.sh
# Extinction du backlight après IDLE_TIMEOUT, rallumage par bouton (libgpiod v2).
# BL=GPIO18 (1=ON, 0=OFF), BTN=GPIO27 (pull-up interne, appui → INACTIVE).

set -euo pipefail

CHIP="/dev/gpiochip0"
BL_PIN=18
BTN_PIN=27
IDLE_TIMEOUT=10 # secondes (adapter)
SLEEP_STEP=0.2
MIN_OFF_HOLD=1 # hystérésis OFF minimale (s)

GPIOSET="/usr/bin/gpioset"
GPIOGET="/usr/bin/gpioget"

log() { printf '[backlight] %s\n' "$*"; }

is_on=true
last_activity=$(date +%s)
off_since=0

cleanup() {
if [[ "$is_on" != true ]]; then
log "Exit: backlight ON"
"$GPIOSET" -c "$CHIP" -t 0 "$BL_PIN=1" || true
fi
}
trap cleanup EXIT

log "Start: backlight ON"
"$GPIOSET" -c "$CHIP" -t 0 "$BL_PIN=1"
is_on=true
last_activity=$(date +%s)

while true; do
now=$(date +%s)

# --- Lecture du bouton avec pull-up ---
raw=$("$GPIOGET" -c "$CHIP" -b pull-up "$BTN_PIN" 2>/dev/null || echo "$BTN_PIN=inactive")
state=$(echo "$raw" | awk -F= '{print $2}') # "active" ou "inactive"

if [[ "$state" == "inactive" ]]; then
# Appui (niveau bas), anti-rebond
sleep 0.02
raw2=$("$GPIOGET" -c "$CHIP" -b pull-up "$BTN_PIN" 2>/dev/null || echo "$BTN_PIN=inactive")
state2=$(echo "$raw2" | awk -F= '{print $2}')

if [[ "$state2" == "inactive" ]]; then
if [[ "$is_on" != true ]]; then
log "Button press → backlight ON"
"$GPIOSET" -c "$CHIP" -t 0 "$BL_PIN=1"
is_on=true
fi
last_activity=$now
sleep 0.2 # anti-rebond
fi
fi
# --- Fin lecture bouton ---

if [[ "$is_on" == true ]]; then
if (( now - last_activity >= IDLE_TIMEOUT )); then
log "Idle >= ${IDLE_TIMEOUT}s → backlight OFF"
"$GPIOSET" -c "$CHIP" -t 0 "$BL_PIN=0"
is_on=false
off_since=$now
fi
else
# Hystérésis OFF minimale (optionnel)
if (( now - off_since < MIN_OFF_HOLD )); then :; fi
fi

sleep "$SLEEP_STEP"
done
</syntaxhighlight>'''La ligne 2''' indique à bash comment gérer les erreurs

<code>'''-e'''</code> implique qu'a la première commande en erreur (!=0) le script entier s'arrête (pas besoin de gérer les codes retour)

<code>'''-u'''</code> si on accède à une variable d'environnement non existante le script s'arrête (Lutte contre les fautes de frappe)

<code>'''-o'''</code> est plus subtile. On l'appelle "pipe fail". Si dans une commande avec des pipe <code>cmd | cmd1 | cmd2</code> l'une des commandes plante le code d'erreur du script (le <code>$?</code>) sera celui de la commande en question et pas celui de la dernière. si <code>cmd1</code> provoque une erreur <code>$?=1</code> mais que <code>cmd2</code> passe bien <code>$?=0</code>, le script retournera la valeur du <code>$?</code> de <code>cmd1</code> si l'option <code>-o</code> est utilisée sinon c'est la dernière qui gagne.

'''Les lignes 3 et 4''' définissent les lignes GPIO utilisées. Les adresse commencent à 512 donc l'écran c'est 512+18 (GPIO18) donc 530 et le bouton c'est 512+27 soit 539.

'''La ligne 5''' c'est la durée au bout de laquelle l'écran va s'éteindre de nouveau. (20 sec ça ma paru bien pour un simple affichage de status)

'''Lignes 8 à 13''' une fonction qui exporte le GPIO si ce n'est pas déjà fait.

'''Lignes 16 et 17''' on définie les directions. écran=out bouton=in

'''Ligne 20''' on commence par allumer l'écran

'''Ligne 22''' <code>last_activity</code> reçoit le timestamp courant.

'''Lignes 24 à 38''' c'est la boucle.

* '''Lignes 25 à 29''' on allume l'écran su on détecte un appui sur le bouton et <code>ast_activity</code> reçoit le timestamp courant.
* Lignes 31 à 35 on éteint l'écran si on a dépassé le timeout <code>now - last_activity >= IDLE_TIMEOUT</code>.

Et c'est tout.

Maintenant on va faire un service ([[Deamon avec systemd|un deamon]]) de ce script. C'est décrit dans le lien mail je donne la conf spécifique:<syntaxhighlight lang="ini">
[Unit]
Description=Daemon pour économiseur d'écran GPIO
After=multi-user.target

[Service]
Type=simple
ExecStart=/usr/local/bin/gpio-screen-saver.sh
Restart=always
RestartSec=2

[Install]
WantedBy=multi-user.target

</syntaxhighlight>On donne les noms suivants aux fichiers

* gpio-screen-saver.sh est le bash vu plus haut
* gpio-screen-saver.service le fichier de conf ci-dessus

On installe avec:<syntaxhighlight lang="bash">
#!/bin/bash
set -euo pipefail

sudo cp gpio-screen-saver.sh /usr/local/bin/
sudo chmod +x /usr/local/bin/gpio-screen-saver.sh
sudo cp gpio-screen-saver.service /etc/systemd/system/

sudo systemctl daemon-reload
sudo systemctl enable --now gpio-screen-saver.service
</syntaxhighlight>SI ca marche bien il affiche juste le lien crée.

===== Arrêt relance =====
Tout ceci est bien beau mais l'écran LCD peut aussi servir de console de secours. Il suffit de branche un clavier et de taper ctrl+c et on récupère la console. Le timeout de 20 seconde va vite devenir insupportable (oui le clavier n'est pas pris en compte dedans).<syntaxhighlight lang="bash">
sudo systemctl stop gpio-screen-saver.service # Arrète le service
sudo systemctl start gpio-screen-saver.service # Démarre le service
sudo systemctl restart gpio-screen-saver.service # Redémarre le service (si on change la valeur du timeout pas exemple)
</syntaxhighlight>Pour avoir le statut:<syntaxhighlight lang="bash">
sudo systemctl status gpio-screen-saver.service
</syntaxhighlight>Qui nous donne un joli:
[[Fichier:Screen-saver.service.png|sans_cadre|838x838px]]
Avec tout plein de détails.

Pour que l'arrêt soit définitif (même après un reboot):<syntaxhighlight lang="bash">
sudo systemctl disable gpio-screen-saver.service
</syntaxhighlight>Et pour le réactiver<syntaxhighlight lang="bash">
sudo systemctl enable gpio-screen-saver.service
</syntaxhighlight>

=== La configuration du réseau ===
Les Raspberry PI ne sont malheureusement équipés que d'un seul port Ethernet. Il faut en ajouter un autre sur l'un des ports USB.

Cependant ce n'est pas catastrophique. Le port eth0 est lui aussi un device USB sauf qu'il est soudé sur la carte.

Lorsque je banche mon adaptateur réseau sur un prise USB, j'ai dans dmesg :<syntaxhighlight lang="text">
[ 67.026854] usb 1-1.4: new high-speed USB device number 5 using dwc_otg
[ 67.132758] usb 1-1.4: New USB device found, idVendor=0b95, idProduct=1790, bcdDevice= 2.00
[ 67.132807] usb 1-1.4: New USB device strings: Mfr=1, Product=2, SerialNumber=3
[ 67.132831] usb 1-1.4: Product: AX88179B
[ 67.132851] usb 1-1.4: Manufacturer: ASIX
[ 67.132869] usb 1-1.4: SerialNumber: 004132D3
[ 67.275834] usbcore: registered new interface driver cdc_ether
[ 67.323914] cdc_ncm 1-1.4:2.0: MAC-Address: 9c:69:d3:41:32:d3
[ 67.323953] cdc_ncm 1-1.4:2.0: setting rx_max = 16384
[ 67.324279] cdc_ncm 1-1.4:2.0: setting tx_max = 16384
[ 67.325521] cdc_ncm 1-1.4:2.0 eth1: register 'cdc_ncm' at usb-3f980000.usb-1.4, CDC NCM (NO ZLP), 9c:69:d3:41:32:d3
[ 67.325863] usbcore: registered new interface driver cdc_ncm
[ 67.346165] usbcore: registered new interface driver cdc_wdm
[ 67.352494] usbcore: registered new interface driver cdc_mbim
</syntaxhighlight>Avec ifconfig j'ai bien deux interfaces:<syntaxhighlight lang="text">
eth0: flags=4163<UP,BROADCAST,RUNNING,MULTICAST> mtu 1500
inet 192.168.X.XX netmask 255.255.255.0 broadcast 192.168.X.255
inet6 fe80::xxxx:xxxx:xxxx:xxxx prefixlen 64 scopeid 0x20<link>
inet6 2a01:xxxx:xxxx:xxxx:xxxx:xxxx:xxxx:xxxx prefixlen 64 scopeid 0x0<global>
ether b8:27:eb:1c:05:fc txqueuelen 1000 (Ethernet)
RX packets 340 bytes 39348 (38.4 KiB)
RX errors 0 dropped 0 overruns 0 frame 0
TX packets 266 bytes 78263 (76.4 KiB)
TX errors 0 dropped 0 overruns 0 carrier 0 collisions 0

eth1: flags=4099<UP,BROADCAST,MULTICAST> mtu 1500
ether 9c:69:d3:41:32:d3 txqueuelen 1000 (Ethernet)
RX packets 0 bytes 0 (0.0 B)
RX errors 0 dropped 0 overruns 0 frame 0
TX packets 0 bytes 0 (0.0 B)
TX errors 0 dropped 0 overruns 0 carrier 0 collisions 0
</syntaxhighlight>'''eth0''' est bien en DHCP sur mon routeur lui même connecté sur internet.

'''eth1''' est disponible. Configurons la.

Notre objectif:

* <code>eth1</code> (USB‑Ethernet) en IP statique <code>10.11.11.1/24</code> – passerelle du LAN.
* Serveur DHCP via <code>dnsmasq</code> : plage <code>10.11.11.100–10.11.11.200</code>, passerelle <code>10.11.11.1</code>.
* Routage IPv4 activé et NAT (masquerade) avec <code>nftables</code>.

SI l'adaptateur Ethernet n'a pas été détecté en tant que eth1 il faudra changer cette valeur dans les commandes qui suivent.

On entre les commandes:<syntaxhighlight lang="bash">
sudo nmcli con add type ethernet ifname eth0 con-name wan ipv4.method auto ipv6.method ignore
sudo nmcli con add type ethernet ifname eth1 con-name lan ipv4.method manual ipv4.addresses 10.11.11.1/24 ipv4.never-default yes ipv6.method ignore
sudo nmcli con up wan
sudo nmcli con up lan
</syntaxhighlight>

==== DHCP (dnsmasq) ====
On entre les commandes<syntaxhighlight lang="bash">
sudo apt install -y dnsmasq
sudo tee /etc/dnsmasq.d/lan.conf >/dev/null <<'EOF'
listen-address=127.0.0.1,10.11.11.1
domain=pilan
local=/pilan/
interface=eth1
bind-interfaces
domain-needed
bogus-priv
dhcp-range=10.11.11.100,10.11.11.200,255.255.255.0,24h
dhcp-option=option:router,10.11.11.1
EOF
sudo systemctl enable --now dnsmasq
</syntaxhighlight>Ca y est notre serveur DHCP est fonctionnel sur un LAN qui s'appelle <code>pilan</code>. Il qui écoute sur 10.11.11.1 mais aussi localhost. non pas qu'il ait à servir des IP par DHCP à lui même mais pour servir de serveur DNS à lui aussi (on parle de DSN plus loin)

==== Routage IPv4 et NAT ====
Il faut maintenant orchestrer le routage entre eth0 et eth1.

On active le routage:<syntaxhighlight lang="bash">
echo 'net.ipv4.ip_forward=1' | sudo tee /etc/sysctl.d/99-ip-forward.conf
sudo sysctl -p /etc/sysctl.d/99-ip-forward.conf
</syntaxhighlight>On configure nftables:<syntaxhighlight lang="bash">
sudo tee /etc/nftables.conf >/dev/null <<'EOF'
flush ruleset
table inet filter {
chain input { type filter hook input priority 0; policy accept; }
chain output { type filter hook output priority 0; policy accept; }
chain forward { type filter hook forward priority 0; policy drop;
ct state established,related accept
iif "eth1" oif "eth0" accept
}
}
table ip nat {
chain postrouting { type nat hook postrouting priority 100;
oif "eth0" masquerade
}
}
EOF
sudo systemctl enable --now nftables
</syntaxhighlight>On vérifie par :<syntaxhighlight lang="bash">
ip addr show eth1

3: eth1: <NO-CARRIER,BROADCAST,MULTICAST,UP> mtu 1500 qdisc fq_codel state DOWN group default qlen 1000
link/ether 9c:69:d3:41:32:d3 brd ff:ff:ff:ff:ff:ff
inet 10.11.11.1/24 brd 10.11.11.255 scope global noprefixroute eth1
valid_lft forever preferred_lft forever
</syntaxhighlight>Bon il n'est relié a rien (NO-CARRIER et state DOWN) mais il a bien une adresse IP correcte.

SI je branche mon PC dessus j'ai bien :<syntaxhighlight lang="bash">
ip addr show eth1

3: eth1: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc fq_codel state UP group default qlen 1000
link/ether 9c:69:d3:41:32:d3 brd ff:ff:ff:ff:ff:ff
inet 10.11.11.1/24 brd 10.11.11.255 scope global noprefixroute eth1
valid_lft forever preferred_lft forever
inet6 fe80::9e69:d3ff:fe41:32d3/64 scope link proto kernel_ll
valid_lft forever preferred_lft forever
</syntaxhighlight>L'état est passé à BROADCAST et state UP

==== Un petit dashboard sur la console ====
Un petit script permet d'avoir les info essentielles :<syntaxhighlight lang="bash">
#!/bin/bash
set -o pipefail

printf "\e[2J"
esc=$'\e'
while [ 1 ]
do
printf "\e[1;1H"
date "+%d/%m/%Y %H:%M"
echo "-----------------------------------------------"
echo -n "Routeur WAN IP: "
ifconfig eth0 | grep "inet " | awk '{print $2 " "}'
echo -n "LAN Gateway : "
ifconfig eth1 | grep "inet " | awk '{print $2 " "}'
echo "-----------------------------------------------"
echo "LAN Clients: "
cat /var/lib/misc/dnsmasq.leases | awk '{print "\033[94m",$2, "\033[0m",$3,"\033[93m",$4,"\033[0m"}'
echo "-----------------------------------------------"
echo "Services: http"
printf "node-red\t"
curl --max-time 2 -I -s http://main-host.pilan:1880 | grep HTTP | sed "s/OK/${esc}[30;42m[OK]${esc}[0m 1880/"
if [[ $? != 0 ]]; then
printf "\033[31mERREUR\033[0m\n"
fi
printf "webssh \t"
curl --max-time 2 -I -s http://main-host.pilan:8888 | grep HTTP | sed "s/OK/${esc}[30;42m[OK]${esc}[0m 8888/"
if [[ $? != 0 ]]; then
printf "\033[31mERREUR\033[0m\n"
fi
sleep 10
done
</syntaxhighlight>Si on le lance:

[[Fichier:Dashboard-router.png|sans_cadre|432x432px]]

Le plus élégant serait que ce script se lance sur le petit écran LCD du PI au démarrage. Facile on a configuré l'autologin...<syntaxhighlight lang="bash">
vi ~/.profile
</syntaxhighlight>Et on ajoute à la fin:<syntaxhighlight lang="bash">
if [ -n "$SSH_CONNECTION" ]; then
echo "Welcome to SSH users"
else
tput civis # Hide carret
./router-dash.sh
tput cnorm # Show carret
fi
</syntaxhighlight>Sur la console principale (l'écran LCD adafruit) il est toujours possible de sortir du dashboard avec <Ctrl> + C

=== Serveur DNS ===

==== Configuration ====
On a déjà installé dnsmasq donc rien a installer de plus.

Sur les clients ça marche déjà nickel (Comme on dit a Goro)

En revanche sur le routeur lui-même on utilise le DNS fournit par network manager et il utilise celui qui nous a été donné par le serveur DHCP utilisé lors de la conf de eth0.

Pas de panique c'est juste de la conf.<syntaxhighlight lang="bash">
sudo nmcli connection modify "wan" ipv4.dns "127.0.0.1 192.168.0.1"
sudo nmcli connection modify "wan" ipv4.ignore-auto-dns yes
sudo nmcli connection up "wan"

</syntaxhighlight>On redémarre dnsmasq:<syntaxhighlight lang="bash">
sudo systemctl restart dnsmasq
</syntaxhighlight>Je ne suis pas sûr que ce soit nécessaire mais bon... par acquis de conscience.

==== Tests ====
Pour tester il nous faudra des outils DNS donc :<syntaxhighlight lang="bash">
sudo apt update
sudo apt install dnsutils
</syntaxhighlight>Déja on vérifie que sur le "patte" par défaut (eth0) on accède aux deus serveurs DNS:<syntaxhighlight lang="bash">
nmcli device show eth0 | grep IP4.DNS
</syntaxhighlight>Doit nous donner DEUX lignes:<syntaxhighlight lang="text">
IP4.DNS[1]: 127.0.0.1
IP4.DNS[2]: 192.168.1.1
</syntaxhighlight>Ici le DNS n°2 est celui de ma box.

On teste:<syntaxhighlight lang="bash">
dig database
dig database.pilan
</syntaxhighlight>Qui tous deux nous donnent les détail sur 10.11.11.50 (voir plus bas)

=== Reverse proxy CADDY ===

==== Installation ====
Le "repository" n'est pas standard. Donc il faut demander gentiement:<syntaxhighlight lang="bash">

# 1. Ajouter la clé GPG
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/gpg.key' | \
sudo tee /etc/apt/trusted.gpg.d/caddy.gpg > /dev/null

# 2. Ajouter le dépôt
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/debian.deb.txt' | \
sudo tee /etc/apt/sources.list.d/caddy-stable.list

# 3. Installer Caddy
sudo apt update
sudo apt install caddy

</syntaxhighlight>Ensuite on teste caddy<syntaxhighlight lang="bash">
caddy version
</syntaxhighlight>Moi j'ai un truc comme:

<code>v2.10.1 h1:g/gTHGFRTY0dec+UgMw9Snxdgytr+KK2TdvoRL/Ovu6U8=</code>

On doit être en <code>v2.10.1</code> avec un n° de build bizarre en base64... (le décodage donne rien...)

==== Configuration ====
<syntaxhighlight lang="bash">
# Creation page de test
sudo mkdir -p /var/www/front
echo "<h1>Welcome to Front Router</h1>" | sudo tee /var/www/front/index.html

</syntaxhighlight>On édite le "caddy file":<syntaxhighlight lang="bash">
sudo vi /etc/caddy/Caddyfile
</syntaxhighlight>Avec <syntaxhighlight lang="apacheconf">
{
auto_https off # Pas de HTTPS auto en LAN
}

:80 {
root * /var/www/front
file_server
}

secure.pinon-hebert.fr {
root * /var/www/front
file_server
}

main-host.pilan {
reverse_proxy http://main-host.pilan:8080 # ce sera pour plus tard rien n'écoute ici
}

</syntaxhighlight>On valide la conf:<syntaxhighlight lang="bash">
sudo caddy fmt --overwrite /etc/caddy/Caddyfile
sudo caddy validate --config /etc/caddy/Caddyfile
</syntaxhighlight>On ne doit pas avoir d'erreur et de warnings.

Et on relance Caddy:<syntaxhighlight lang="bash">
sudo systemctl reload caddy
</syntaxhighlight>On vérifie que le port 80 soit ouvert!<syntaxhighlight lang="bash">
sudo ss -ltnp | grep :80
</syntaxhighlight>Qui doit répondre :

<code>LISTEN 0 4096 *:80 *:* users:(("caddy",pid=26458,fd=7))</code>

Et un <syntaxhighlight lang="bash">
curl http://front-router
</syntaxhighlight>Réponds :<syntaxhighlight lang="html">
<h1>Welcome to Front Router</h1>
</syntaxhighlight>

=== Chiffrement avec let's encrypy ===
Caddy incorpore par défaut un lien avec let's encrypt. Il n'y a rien a faire de ce côté là!

== Administration ==
Une fois installé voici les opérations d'administrations possibles.

=== Ajouter une redirection "reverse proxy" ===
{| class="wikitable"
|+Attention
|[[Fichier:Attention.png|sans_cadre|45x45px]]
|Pour que la redirection fonctionne il faut que le process serveur sur la machine distante soit à l'écoute sur le réseau et pas seulement sur localhost!
<code>listen 0.0.0.0 OUI</code>
<code>listen 127.0.0.1 NON</code>
|}

==== Prérequis ====
Il faut avoir enregistré un DNS toto.mondomaine.com qui pointe vers une adresse IP qui, d'une manière ou une autre arrive sur le routeur de tête.
{| class="wikitable"
|+Attention
|[[Fichier:Attention.png|sans_cadre|45x45px]]
|Il faut également que ce routeur soit ouvert sur les ports 80 et 443.
Oui il faut laisser ouvert le port 80 avec un serveur http derrière car let's encrypt s'en sert lors du renouvellement.
|}

==== Configuration ====
<syntaxhighlight lang="yaml">
# === Site public HTTPS vers toto (Let's Encrypt automatique) ===
toto.mondomaine.com {
# (Optionnel) Email ACME pour les notifications de certificat
tls tecinfo@mondomaine.com

# Logs utiles
log {
output file /var/log/caddy/toto.log
format json
level INFO
}

# Compression & quelques en-têtes sécurité
encode zstd gzip
header {
Strict-Transport-Security "max-age=31536000; includeSubDomains; preload"
X-Content-Type-Options "nosniff"
X-Frame-Options "DENY"
Referrer-Policy "strict-origin-when-cross-origin"
}

# Reverse proxy vers Node-RED sur IP qui héberge TOTO A.B.C.B et le port de TOTO PORT
reverse_proxy http://A.B.C.B:PORT {
# Caddy gère automatiquement WebSocket et X-Forwarded-*
# Si nécessaire :
# header_up Host {host}
}
}

# === (Recommandé) Forcer HTTP -> HTTPS pour ce FQDN ===
http://toto.mondomaine.com {
redir https://toto.mondomaine.com{uri}
}
</syntaxhighlight>Il faut créer le fichier de log "à la main":<syntaxhighlight lang="bash">
# Si c'est pas fait
sudo mkdir -p /var/log/caddy
sudo chown -R caddy:caddy /var/log/caddy
sudo chmod 750 /var/log/caddy
# et ensuite
sudo mkdir /var/log/caddy/toto.log
sudo chown -R caddy:caddy /var/log/caddy/toto.log
sudo chmod 750 /var/log/caddy/toto.log

</syntaxhighlight>Ensuite on relance caddy.<syntaxhighlight lang="bash">
sudo systemctl start caddy
</syntaxhighlight>Y'a 300 000 raisons pour que ça ne marche pas du premier coup mais si on fait bien tout étape par étape ça doit marcher!

=== Gestion des connexions ssh ===
Je ne sais pas pourquoi mais mon installation du routeur en <code>Raspbian GNU/Linux 13</code> vit mal les serveurs du LAN en <code>Debian GNU/Linux 12</code> qui datent d'il y a a peine 6 mois....

AU ssh j'ai des erreurs:<syntaxhighlight lang="text">
Unable to negotiate with 10.11.11.50 port 22: no matching key exchange method found. Their offer: diffie-hellman-group14-sha1,kex-strict-s-v00@openssh.com
</syntaxhighlight>Une sombre histoire d'algo de hashage que raspbian 13 considèrent comme à risque. Je vais passer les clients en <code>Raspbian GNU/Linux 13</code> des que possible mais en attendent j'ai accepé des compromis sur la sécu pour les machines du lan <code>pilan</code>.

Dans mon ~/.ssh/config j'ai ajouté:<syntaxhighlight lang="apacheconf">
Host *.pilan
User admin

# Autoriser l'ancien échange de clés (KEX)
KexAlgorithms +diffie-hellman-group14-sha1

# Si les serveurs n'annoncent que des clés/ signatures SHA-1
HostkeyAlgorithms +ssh-rsa
PubkeyAcceptedAlgorithms +ssh-rsa

# (Optionnel) ciphers classiques
</syntaxhighlight>Ce qui fait que pour les machines du lan et seulement avec le user admin on peut se loguer depuis le front.

=== Gestion de l'allocation d'IP fixes en DHCP ===
Autant je sous traite l'adresse du routeur lui même sur sa "patte" eth0 au routeur qui lui est supérieur (ma box par exemple) autant, pour les machines branchées sur eth1 il peut être intéressant de leur donner une IP fixe.

On peut rendre l'IP statique sur le client mais le plus propre est de laisser le client en DHCP mais reconnaitre l'adresse MAC du client et configurer le serveur DHCP pour lui donner TOUJOURS la même IP.

<u>Par exemple je voudrais que mon serveur de base de données appelé dadabase possède l'adresse IP 10.11.11.50</u>

Je relève son adresse mac sur le dashboard:

Pour le moment on lui a donné:

<code>b8:27:ee:cc:f9:ac 10.11.11.171 database</code>

Il faut simplement éditer le fichier: <code>/etc/dnsmasq.d/lan.conf</code>
sudo vi /etc/dnsmasq.d/lan.conf
Et ajouter/modifier la ligne :
dhcp-host=b8:27:ee:cc:f9:ac,10.11.11.50,database
Le serveur "<code>database</code>" dont l'adresse MAC est <code>b8:27:ee:cc:f9:ac</code> se verra systématiquement affecté l'adresse <code>10.11.11.50</code>. Pour que le serveur prenne en compte le changement il faut relancer <code>dnsmasq</code>
sudo systemctl restart dnsmasq
Et c'est tout.

=== Ajout d'une règle de redirection de port NAP/PAT ===
Dans cet exemple je vais rediriger ce qui rentre sur le port 2222 de eth0 sur front-router vers le port 22 sur le serveur git.

==== Modification: ====
Tout se fait dans <code>/etc/nftables.conf</code>.

On ajoute dans <code>table ip filter</code> la chaine <code>forward</code>doit être modifiée:<syntaxhighlight lang="c">
chain forward {
type filter hook forward priority 0; policy drop;

# flux établis
ct state established,related accept

# ICI LES ANCIENNES REGLES

# DNAT SSH WAN:2222 -> GIT:22
iifname $WAN oifname $LAN ip daddr $GIT tcp dport 22 ct state new accept
}

</syntaxhighlight>Et le post routing.<syntaxhighlight lang="c">
table ip nat {
chain prerouting {
type nat hook prerouting priority -100; policy accept;

# DNAT SSH (port 2222 du frontal -> GIT:22)
iifname $WAN tcp dport 2222 dnat to $GIT:22
}

</syntaxhighlight>

==== Application ====
On valide la syntaxe par :<syntaxhighlight lang="bash">
sudo nft -f /etc/nftables.conf
</syntaxhighlight>Et on relance par :<syntaxhighlight lang="bash">
sudo systemctl restart nftables
</syntaxhighlight>

==== Récapitulation ====
Le fichier <code>/etc/nftables.conf</code> contient maintenant :<syntaxhighlight lang="c">
flush ruleset

define WAN = "eth0" # 192.168.0.0/24
define LAN = "eth1" # 10.11.11.0/24
define LAN_NET = 10.11.11.0/24
define GIT = 10.11.11.30

table ip filter {
chain input {
type filter hook input priority 0; policy drop;

# loopback
iifname "lo" accept

# established/related
ct state established,related accept

# ICMP utile
ip protocol icmp accept

# DNS vers le routeur (clients du sous-LAN)
iifname $LAN udp dport 53 accept
iifname $LAN tcp dport 53 accept

# DHCP serveur (dnsmasq)
iifname $LAN udp sport 68 udp dport 67 accept
iifname $LAN udp sport 67 udp dport 68 accept

# SSH vers le routeur (port 22)
iifname $LAN tcp dport 22 accept
ip saddr 192.168.0.0/24 iifname $WAN tcp dport 22 accept

# HTTP/HTTPS vers Caddy sur le frontal
iifname $WAN tcp dport {80, 443} accept
iifname $LAN tcp dport {80, 443} accept
# HTTP/3 (QUIC)
iifname $WAN udp dport 443 accept
}

chain forward {
type filter hook forward priority 0; policy drop;

# flux établis
ct state established,related accept

# LAN -> WAN (trafic sortant)
iifname $LAN oifname $WAN ct state new accept

# DNAT SSH WAN:2222 -> GIT:22
iifname $WAN oifname $LAN ip daddr $GIT tcp dport 22 ct state new accept
}

chain output {
type filter hook output priority 0; policy accept;
}
}

table ip nat {
chain prerouting {
type nat hook prerouting priority -100; policy accept;

# DNAT SSH (port 2222 du frontal -> GIT:22)
iifname $WAN tcp dport 2222 dnat to $GIT:22
}

chain postrouting {
type nat hook postrouting priority 100; policy accept;

# Masquerade LAN -> WAN
oifname $WAN ip saddr $LAN_NET masquerade
}
}
</syntaxhighlight>Oui c'est mort depuis le WAN seul le HTTPS est ouvert (et le HTTP pour let's encrypt) inutile d'essayer de rentrer (par là en tout cas)

Le routeur en tête réseau PI

2026-04-22T21:52:25Z

Jpinon : correction venv python d'install de l'écran

== Présentation ==
La première étape sera de créer ce qui sera la tête du réseau.

[[Fichier:Datacenter-schema-front.png|sans_cadre]]

Schématiquement on a un raspberry PI en frontal. Il n'a en aucun cas besoin de wifi donc un simple Raspbery PI2 sera suffisant.

En revanche il lui faudra deux "pattes" réseau donc un adaptateur USB - Ethernet sera nécessaire. De plus un écran [[Écran Adafruit 2.8 pouces TFT|Adafruit 2.8']] sera utilisé pour le "status".

=== Architecture réseau: ===

* eth0 (le port Ethernet standard) sera relié au WAN en tant que client DHCP. C'est sur le routeur auquel il est relié que le serveur DHCP attribuera (ou pas) une IP fixe.
* eth1 (le port Ethernet sur USB) sera relié au LAN. Il sera configuré en serveur DHCP et s'occupera du sub-net 10.11.11.0/24. Les autres raspberry seront reliés à ce port via un switch.
La configuration réseau n'est pas idéale car le contrôleur USB du PI2 n'est pas USB3 mais USB2 et le port ethernet natif est également un ethernet USB. Donc les deux ports partageront la bande passante de l'USB2 de 480 Mbs max.

L'utilisateur d'un adaptateur gigabit n'a donc pas vraiment d'intérêt car sur les 480 l'Ethernet embarqué utilise déjà 100Mbs... il en reste théoriquement 380 a disposition sans compter les conflits.

Bon moi j'ai un adaptateur gigabit car c'est le standard aujourd'hui! Je serais prêt si je dois passer à un Raspberry PI 4 qui gère de l'USB3 a 5Gbs et un Ethernet Gigabit. Je ne penses cependant pas que ce soit nécessaire. Le switch est gigabit et si, dans le LAN 10.11.11.0/24 on a deux PI4 ils communiqueront entre eux en gigabit.

Derrière on aura donc toute sorte de serveurs basés sur des raspberry PI du genre:

* Serveur node-red
* Serveur MariaDB
* Serveur MediaWiki
* Serveur Git
* ce dont on aura besoin...

=== Modules installés ===
Sur ce serveur "front" on aura donc installé:

* Un serveur DHCP pour eth1
* Un serveur ssh sur eth0 et eth1 utilisé comme "rebond"
* Un reverse proxy pour faire suivre les demandes vers les serveurs sur le "LAN 10.11.11"
* Un broker MQTT ouvert sur eth0 et eth1
* Un driver d"écran Adafruit 2.8'

== Installation ==

=== La carte SD ===
On utilise Raspberry Pi Imager https://www.raspberrypi.com/software/

[[Fichier:Datacenter-sd-1.png|sans_cadre]]

On choisit le modèle (moi c'est un raspberry PI 2 y'a pas besoin de mieux). Puis "SUIVANT"

[[Fichier:Datacenter-sd-2.png|sans_cadre]]

On ne veut pas de "desktop" on choisit "Raspberry PI OS (other)

[[Fichier:Datacenter-sd-3.png|sans_cadre]]

On choisit la dernière version sans desktop puis "SUIVANT"

[[Fichier:Datacenter-sd-4.png|sans_cadre]]

Moi j'ai qu'un seul port SD il n'y a pas d'ambiguïté je le sélectionne puis "SUIVANT"

[[Fichier:Datacenter-sd-5.png|sans_cadre]]

On donne le nom à notre serveur puis "SUIVANT"

[[Fichier:Datacenter-sd-6.png|sans_cadre]]

On donne la localisation puis "SUIVANT"

[[Fichier:Datacenter-sd-7.png|sans_cadre]]

On définit le nom de l'utilisateur et son mot de passe puis "SUIVANT"

[[Fichier:Datacenter-sd-8.png|sans_cadre]]

On peut ignorer le wifi dans notre cas (un raspberry PI 2 n'est pas équité!) "SUIVANT"

[[Fichier:Datacenter-sd-9.png|sans_cadre]]

On s'arrête un peut sur cette page.

On a définit un login que n'est pas "pi" mais qui peut être aisément trouvé. Notre mot de passe est sûrement très sécurisé mais toujours faillible. Comme le routeur sera probablement acessible de l'extérieur il est nécessaire, a mon avis, de sécuriser le process de login ssh par une clé. J'ai mis la clé publique du PC que j'utilise habituellement pour la maintenance. Une seconde clé pourra être ajouté ultérieurement.

"SUIVANT"

[[Fichier:Datacenter-sd-10.png|sans_cadre]]

Je ne penses pas que ce soit nécessaire d'utiliser Pi Connect, d'autant plus que le PI devra être le moins chargé possible. "SUIVANT"

[[Fichier:Datacenter-sd-11.png|sans_cadre]]

On a un dernier récapitulatif. "WRITE".

[[Fichier:Datacenter-sd-12.png|sans_cadre]]

Oui je comprends, on efface et on flashe la carte!

[[Fichier:Datacenter-sd-13.png|sans_cadre]]

Ca s'écrit... si une fenêtre proposant de formater la carte s'ouvre... fermez là.

[[Fichier:Datacenter-sd-14.png|sans_cadre]]

Apres avoir écrit la carte, on la vérifie (c'est indispensable pour être sûr de la qualité de la carte)

[[Fichier:Datacenter-sd-15.png|sans_cadre]]

C'est terminé. On peut soit en faire une seconde (un backup? mais il faudrait plutôt faire la copie après les étapes suivantes). "FINISH"

La carte est prête on peut lancer le premier boot.

On insère la carte dans le PI2 en question. On y branche un clavier et un écran (ne pas brancher l'adaptateur USB Ethernet la première fois) et GO! On blanche le courant.

=== Premier boot ===
Il boote correctement.

Moi il bloque un moment sur Network Manager mais continue (je penses que c'est eth1 sur le port USB qui n'est relié a rien qui le gène)

Il boote normalement, affiche la progression sur la console sur l'écran HDMI.

La fin est un succinct :

<code>[ OK ] Reached target '''cloud-init.target''' - Cloud-init target.</code>

Et rien ne se passe. C'est normal, pas de panique.

La console à l'écran se limite à... la console de base pour voir les erreurs. Pour se loguer il y a deux solutions :

* Par ssh depuis une autre machine
* en allant sur une autre console de login "hardware" grâce a <ctrl> + <F2> jusqu'à <F6>. La première <ctrl> <F1> sera toujours là ou seront affichés les messages.

On va configurer les trucs de base.

==== raspi-config ====
On lance le programme "raspi-config". On a fait beaucoup du travail au moment de la préparation de la carte SD mais il en reste un peu.<syntaxhighlight lang="bash">
sudo raspi-config
</syntaxhighlight>On a le "classique"

[[Fichier:Raspi-config.png|sans_cadre]]

Dans 1 "System options" choisir S6 "Autologin"

[[Fichier:Raspi-config-autologin.png|sans_cadre]]

Selectionner <Yes> qui nous réponds <code>"Console autologin is enabled"</code>.

Oui si quelqu'un rentre chez nous, branche un écran et un clavier sur la machine il sera logué automatiquement... c'est un risque que je prends car, comme ces machines marchent très bien et durent des années il m'arrive d'oublier leur mot de passe.

Dans 6 "Advanced Options" on choisit A1 "Expand Filesystem"

Et le PI nous réponds :<syntaxhighlight lang="text">
Root partition has been resized.
The filesystem will be enlarged upon the next reboot
</syntaxhighlight>On valide par <OK>

Au cas ou on lance un 8 "Update" mais si on vient de faire la carte il ne doit pas se passer grand chose.

On branche l'adaptateur USB Ethernet et on reboote<syntaxhighlight lang="bash">
sudo reboot
</syntaxhighlight>on voit le shutdown se dérouler sur la console et le redémarrage.

Le boot bloque un moment sur le démarrage du network manager sur eth1 mais on peut utiliser le serveur quand même.

On peut vérifier que le "resize filesystem" est bien passé:<syntaxhighlight lang="bash">
df -h /
Filesystem Size Used Avail Use% Mounted on
/dev/mmcblk0p2 229G 2.6G 217G 2% /
</syntaxhighlight>J'ai utilisé une carte de 256 Go on y est presque!

=== Configuration de l'écran ===
[[Fichier:Adafruit 2.8''.png|vignette|263x263px|L'écran Adafruit 2.8 pouces]]
Adafuit le fabricant de l'écran donnait autrefois une distribution spécifique pour cet écran. C'était rapide mais pas très "propre".

Maintenant il y a un script python pour faire ce travail. Adafuit donne le process ici: https://learn.adafruit.com/adafruit-2-8-pitft-capacitive-touch/easy-install-2

Je suis bon camarade je donne ici la méthode.

==== Installation des outils ====
Il faut d'abord installer les outils python de virtualisation d'environnement.<syntaxhighlight lang="bash">
sudo apt install python3-venv
python3 -m venv env --upgrade-deps --system-site-packages
source env/bin/activate
</syntaxhighlight>Ensuite on installe le script qui installera lui même l'écran.<syntaxhighlight lang="bash">
cd ~
sudo apt-get update
sudo apt-get install -y git python3-pip
pip3 install --upgrade adafruit-python-shell click Flask-SQLAlchemy
git clone https://github.com/adafruit/Raspberry-Pi-Installer-Scripts.git
cd Raspberry-Pi-Installer-Scripts
</syntaxhighlight>Bon je penses que certains <code>apt-get install</code> sont superflus mais je ne prends pas de risques.

==== Installation elle même ====
Ici chez Adafruit donne une instruction pour chaque modèle d'écran.

Pour l'écran 2.8<nowiki>''</nowiki> capacitif :<syntaxhighlight lang="bash">
sudo -E env PATH=$PATH python3 adafruit-pitft.py --display=28c --rotation=90 --install-type=console
</syntaxhighlight>SI j'avais utilisé la version résistive <syntaxhighlight lang="bash">
sudo -E env PATH=$PATH python3 adafruit-pitft.py --display=28r --rotation=90 --install-type=console
</syntaxhighlight>Ca se termine<syntaxhighlight lang="text">
PITFT Updating console to PiTFT...
Remove fbcp from /etc/rc.local, if it's there...
Configuring boot/config.txt for default HDMI
Installing console fbcon map helper...
Installing console fbcon map service...
PITFT Created symlink '/etc/systemd/system/multi-user.target.wants/con2fbmap.service' → '/etc/systemd/system/con2fbmap.service'.

PITFT Job for con2fbmap.service failed because the control process exited with error code.
See "systemctl status con2fbmap.service" and "journalctl -xeu con2fbmap.service" for details.
Turning off console blanking
Setting raspi-config to boot to console w/o login...
PITFT Success!

Settings take effect on next boot.

REBOOT NOW? [Y/n] Reboot started...
Connection to 192.168.0.77 closed by remote host.
Connection to 192.168.0.77 closed.
</syntaxhighlight>En rebootant le PI.

Et l'écran est actif.

Un dernier problème: Lorsque on reboote sans l'écran HDMI... l'écran LCD ne marche pas c'est ballot

===== Fichier config.txt =====

On l'édite avec<syntaxhighlight lang="bash">
sudo vi /boot/firmware/config.txt
</syntaxhighlight>La première chose est de DESACTIVER le son car: Si un écran HDMI est branché tout va bien le son est dirigé vers là. Mais il n'y a pas d'écran le son est dirigé vers le port jack 3.5 qui est géré par le GPIO 18 en PWM. On c'est ce GPIO qui est utilisé par Adafruit pour le rétro éclairage de l'écran. <syntaxhighlight lang="ini">
# Désactiver audio PWM
dtparam=audio=off
</syntaxhighlight>On désactive le son sur le JACK 3.3 comme ça. Le Raspberry PI 5 qui supprime le port jack 3.5 ne doit pas nécessiter cela.

Ensuite

Et on y trouves <syntaxhighlight lang="ini">
# --- added by adafruit-pitft-helper ---
[all]
hdmi_force_hotplug=0
dtparam=spi=on
dtparam=i2c1=on
dtparam=i2c_arm=on
dtoverlay=pitft28-capacitive,rotate=90,speed=64000000,fps=30,drm
# --- end adafruit-pitft-helper ---
</syntaxhighlight>Alors qu'avec :<syntaxhighlight lang="ini">
# --- added by adafruit-pitft-helper ---
[all]
dtparam=spi=on
dtparam=i2c1=on
dtparam=i2c_arm=on
dtoverlay=pitft28-capacitive,rotate=270,speed=64000000,fps=30,drm
dtoverlay=gpio-backlight,gpios=18,active_low=0
hdmi_force_hotplug=1
hdmi_group=2
hdmi_mode=82
# --- end adafruit-pitft-helper ---
</syntaxhighlight>C'est mieux.

J'ai ai profité pour retourner l'écran (rotate=270) car avec un rotatate=90 les boutons sont a gauche.

===== Le fichier cmdline.txt =====

Toujours pour le modifier:<syntaxhighlight lang="bash">
sudo vi /boot/firmware/cmdline.txt
</syntaxhighlight>On y trouve <syntaxhighlight lang="text">
console=serial0,115200 console=tty1 root=PARTUUID=b104592a-02 rootfstype=ext4 fsck.repair=yes rootwait cfg80211.ieee80211_regdom=FR
</syntaxhighlight>On supprime la "sérial console" et on active fbcon.<syntaxhighlight lang="text">
console=tty1 fbcon=map:10 root=PARTUUID=b104592a-02 rootfstype=ext4 fsck.repair=yes rootwait cfg80211.ieee80211_regdom=FR
</syntaxhighlight>On reboote et ca marche! Même sans l'écran HDMI.

Dans tous les cas on peut acceder au frame buffer sur /dev/fb1 pour la carte écran LCD.<syntaxhighlight lang="bash">
cp /dev/random /dev/fb1
</syntaxhighlight>et on voit du bruit sur l'écran.

==== Economiseur d'écran. ====
L'écran LCD est toujours allumé dans ce cas. C'est pratique mais ca chauffe énormément, ça l'use et ca consomme. Bref ppas top.

On va faire un économiseur d'écran. On pourrait le faire en détectant un appui dessus mais la date tactile du mien est morte. On a cependant 4 bon vieux boutons physiques que je vais utiliser.

On a des boutions marqués de haut en bas <code>#17</code>, <code>#22</code>, <code>#23</code> et <code>#27</code>.

Nous nous proposons d'utiliser le bouton du bas soit <code>#27</code>.

Le script bash est assez simple:<syntaxhighlight lang="bash" line="1">
#!/bin/bash
# /usr/local/bin/gpio-screen-saver.sh
# Extinction du backlight après IDLE_TIMEOUT, rallumage par bouton (libgpiod v2).
# BL=GPIO18 (1=ON, 0=OFF), BTN=GPIO27 (pull-up interne, appui → INACTIVE).

set -euo pipefail

CHIP="/dev/gpiochip0"
BL_PIN=18
BTN_PIN=27
IDLE_TIMEOUT=10 # secondes (adapter)
SLEEP_STEP=0.2
MIN_OFF_HOLD=1 # hystérésis OFF minimale (s)

GPIOSET="/usr/bin/gpioset"
GPIOGET="/usr/bin/gpioget"

log() { printf '[backlight] %s\n' "$*"; }

is_on=true
last_activity=$(date +%s)
off_since=0

cleanup() {
if [[ "$is_on" != true ]]; then
log "Exit: backlight ON"
"$GPIOSET" -c "$CHIP" -t 0 "$BL_PIN=1" || true
fi
}
trap cleanup EXIT

log "Start: backlight ON"
"$GPIOSET" -c "$CHIP" -t 0 "$BL_PIN=1"
is_on=true
last_activity=$(date +%s)

while true; do
now=$(date +%s)

# --- Lecture du bouton avec pull-up ---
raw=$("$GPIOGET" -c "$CHIP" -b pull-up "$BTN_PIN" 2>/dev/null || echo "$BTN_PIN=inactive")
state=$(echo "$raw" | awk -F= '{print $2}') # "active" ou "inactive"

if [[ "$state" == "inactive" ]]; then
# Appui (niveau bas), anti-rebond
sleep 0.02
raw2=$("$GPIOGET" -c "$CHIP" -b pull-up "$BTN_PIN" 2>/dev/null || echo "$BTN_PIN=inactive")
state2=$(echo "$raw2" | awk -F= '{print $2}')

if [[ "$state2" == "inactive" ]]; then
if [[ "$is_on" != true ]]; then
log "Button press → backlight ON"
"$GPIOSET" -c "$CHIP" -t 0 "$BL_PIN=1"
is_on=true
fi
last_activity=$now
sleep 0.2 # anti-rebond
fi
fi
# --- Fin lecture bouton ---

if [[ "$is_on" == true ]]; then
if (( now - last_activity >= IDLE_TIMEOUT )); then
log "Idle >= ${IDLE_TIMEOUT}s → backlight OFF"
"$GPIOSET" -c "$CHIP" -t 0 "$BL_PIN=0"
is_on=false
off_since=$now
fi
else
# Hystérésis OFF minimale (optionnel)
if (( now - off_since < MIN_OFF_HOLD )); then :; fi
fi

sleep "$SLEEP_STEP"
done
</syntaxhighlight>'''La ligne 2''' indique à bash comment gérer les erreurs

<code>'''-e'''</code> implique qu'a la première commande en erreur (!=0) le script entier s'arrête (pas besoin de gérer les codes retour)

<code>'''-u'''</code> si on accède à une variable d'environnement non existante le script s'arrête (Lutte contre les fautes de frappe)

<code>'''-o'''</code> est plus subtile. On l'appelle "pipe fail". Si dans une commande avec des pipe <code>cmd | cmd1 | cmd2</code> l'une des commandes plante le code d'erreur du script (le <code>$?</code>) sera celui de la commande en question et pas celui de la dernière. si <code>cmd1</code> provoque une erreur <code>$?=1</code> mais que <code>cmd2</code> passe bien <code>$?=0</code>, le script retournera la valeur du <code>$?</code> de <code>cmd1</code> si l'option <code>-o</code> est utilisée sinon c'est la dernière qui gagne.

'''Les lignes 3 et 4''' définissent les lignes GPIO utilisées. Les adresse commencent à 512 donc l'écran c'est 512+18 (GPIO18) donc 530 et le bouton c'est 512+27 soit 539.

'''La ligne 5''' c'est la durée au bout de laquelle l'écran va s'éteindre de nouveau. (20 sec ça ma paru bien pour un simple affichage de status)

'''Lignes 8 à 13''' une fonction qui exporte le GPIO si ce n'est pas déjà fait.

'''Lignes 16 et 17''' on définie les directions. écran=out bouton=in

'''Ligne 20''' on commence par allumer l'écran

'''Ligne 22''' <code>last_activity</code> reçoit le timestamp courant.

'''Lignes 24 à 38''' c'est la boucle.

* '''Lignes 25 à 29''' on allume l'écran su on détecte un appui sur le bouton et <code>ast_activity</code> reçoit le timestamp courant.
* Lignes 31 à 35 on éteint l'écran si on a dépassé le timeout <code>now - last_activity >= IDLE_TIMEOUT</code>.

Et c'est tout.

Maintenant on va faire un service ([[Deamon avec systemd|un deamon]]) de ce script. C'est décrit dans le lien mail je donne la conf spécifique:<syntaxhighlight lang="ini">
[Unit]
Description=Daemon pour économiseur d'écran GPIO
After=multi-user.target

[Service]
Type=simple
ExecStart=/usr/local/bin/gpio-screen-saver.sh
Restart=always
RestartSec=2

[Install]
WantedBy=multi-user.target

</syntaxhighlight>On donne les noms suivants aux fichiers

* gpio-screen-saver.sh est le bash vu plus haut
* gpio-screen-saver.service le fichier de conf ci-dessus

On installe avec:<syntaxhighlight lang="bash">
#!/bin/bash
set -euo pipefail

sudo cp gpio-screen-saver.sh /usr/local/bin/
sudo chmod +x /usr/local/bin/gpio-screen-saver.sh
sudo cp gpio-screen-saver.service /etc/systemd/system/

sudo systemctl daemon-reload
sudo systemctl enable --now gpio-screen-saver.service
</syntaxhighlight>SI ca marche bien il affiche juste le lien crée.

===== Arrêt relance =====
Tout ceci est bien beau mais l'écran LCD peut aussi servir de console de secours. Il suffit de branche un clavier et de taper ctrl+c et on récupère la console. Le timeout de 20 seconde va vite devenir insupportable (oui le clavier n'est pas pris en compte dedans).<syntaxhighlight lang="bash">
sudo systemctl stop gpio-screen-saver.service # Arrète le service
sudo systemctl start gpio-screen-saver.service # Démarre le service
sudo systemctl restart gpio-screen-saver.service # Redémarre le service (si on change la valeur du timeout pas exemple)
</syntaxhighlight>Pour avoir le statut:<syntaxhighlight lang="bash">
sudo systemctl status gpio-screen-saver.service
</syntaxhighlight>Qui nous donne un joli:
[[Fichier:Screen-saver.service.png|sans_cadre|838x838px]]
Avec tout plein de détails.

Pour que l'arrêt soit définitif (même après un reboot):<syntaxhighlight lang="bash">
sudo systemctl disable gpio-screen-saver.service
</syntaxhighlight>Et pour le réactiver<syntaxhighlight lang="bash">
sudo systemctl enable gpio-screen-saver.service
</syntaxhighlight>

=== La configuration du réseau ===
Les Raspberry PI ne sont malheureusement équipés que d'un seul port Ethernet. Il faut en ajouter un autre sur l'un des ports USB.

Cependant ce n'est pas catastrophique. Le port eth0 est lui aussi un device USB sauf qu'il est soudé sur la carte.

Lorsque je banche mon adaptateur réseau sur un prise USB, j'ai dans dmesg :<syntaxhighlight lang="text">
[ 67.026854] usb 1-1.4: new high-speed USB device number 5 using dwc_otg
[ 67.132758] usb 1-1.4: New USB device found, idVendor=0b95, idProduct=1790, bcdDevice= 2.00
[ 67.132807] usb 1-1.4: New USB device strings: Mfr=1, Product=2, SerialNumber=3
[ 67.132831] usb 1-1.4: Product: AX88179B
[ 67.132851] usb 1-1.4: Manufacturer: ASIX
[ 67.132869] usb 1-1.4: SerialNumber: 004132D3
[ 67.275834] usbcore: registered new interface driver cdc_ether
[ 67.323914] cdc_ncm 1-1.4:2.0: MAC-Address: 9c:69:d3:41:32:d3
[ 67.323953] cdc_ncm 1-1.4:2.0: setting rx_max = 16384
[ 67.324279] cdc_ncm 1-1.4:2.0: setting tx_max = 16384
[ 67.325521] cdc_ncm 1-1.4:2.0 eth1: register 'cdc_ncm' at usb-3f980000.usb-1.4, CDC NCM (NO ZLP), 9c:69:d3:41:32:d3
[ 67.325863] usbcore: registered new interface driver cdc_ncm
[ 67.346165] usbcore: registered new interface driver cdc_wdm
[ 67.352494] usbcore: registered new interface driver cdc_mbim
</syntaxhighlight>Avec ifconfig j'ai bien deux interfaces:<syntaxhighlight lang="text">
eth0: flags=4163<UP,BROADCAST,RUNNING,MULTICAST> mtu 1500
inet 192.168.X.XX netmask 255.255.255.0 broadcast 192.168.X.255
inet6 fe80::xxxx:xxxx:xxxx:xxxx prefixlen 64 scopeid 0x20<link>
inet6 2a01:xxxx:xxxx:xxxx:xxxx:xxxx:xxxx:xxxx prefixlen 64 scopeid 0x0<global>
ether b8:27:eb:1c:05:fc txqueuelen 1000 (Ethernet)
RX packets 340 bytes 39348 (38.4 KiB)
RX errors 0 dropped 0 overruns 0 frame 0
TX packets 266 bytes 78263 (76.4 KiB)
TX errors 0 dropped 0 overruns 0 carrier 0 collisions 0

eth1: flags=4099<UP,BROADCAST,MULTICAST> mtu 1500
ether 9c:69:d3:41:32:d3 txqueuelen 1000 (Ethernet)
RX packets 0 bytes 0 (0.0 B)
RX errors 0 dropped 0 overruns 0 frame 0
TX packets 0 bytes 0 (0.0 B)
TX errors 0 dropped 0 overruns 0 carrier 0 collisions 0
</syntaxhighlight>'''eth0''' est bien en DHCP sur mon routeur lui même connecté sur internet.

'''eth1''' est disponible. Configurons la.

Notre objectif:

* <code>eth1</code> (USB‑Ethernet) en IP statique <code>10.11.11.1/24</code> – passerelle du LAN.
* Serveur DHCP via <code>dnsmasq</code> : plage <code>10.11.11.100–10.11.11.200</code>, passerelle <code>10.11.11.1</code>.
* Routage IPv4 activé et NAT (masquerade) avec <code>nftables</code>.

SI l'adaptateur Ethernet n'a pas été détecté en tant que eth1 il faudra changer cette valeur dans les commandes qui suivent.

On entre les commandes:<syntaxhighlight lang="bash">
sudo nmcli con add type ethernet ifname eth0 con-name wan ipv4.method auto ipv6.method ignore
sudo nmcli con add type ethernet ifname eth1 con-name lan ipv4.method manual ipv4.addresses 10.11.11.1/24 ipv4.never-default yes ipv6.method ignore
sudo nmcli con up wan
sudo nmcli con up lan
</syntaxhighlight>

==== DHCP (dnsmasq) ====
On entre les commandes<syntaxhighlight lang="bash">
sudo apt install -y dnsmasq
sudo tee /etc/dnsmasq.d/lan.conf >/dev/null <<'EOF'
listen-address=127.0.0.1,10.11.11.1
domain=pilan
local=/pilan/
interface=eth1
bind-interfaces
domain-needed
bogus-priv
dhcp-range=10.11.11.100,10.11.11.200,255.255.255.0,24h
dhcp-option=option:router,10.11.11.1
EOF
sudo systemctl enable --now dnsmasq
</syntaxhighlight>Ca y est notre serveur DHCP est fonctionnel sur un LAN qui s'appelle <code>pilan</code>. Il qui écoute sur 10.11.11.1 mais aussi localhost. non pas qu'il ait à servir des IP par DHCP à lui même mais pour servir de serveur DNS à lui aussi (on parle de DSN plus loin)

==== Routage IPv4 et NAT ====
Il faut maintenant orchestrer le routage entre eth0 et eth1.

On active le routage:<syntaxhighlight lang="bash">
echo 'net.ipv4.ip_forward=1' | sudo tee /etc/sysctl.d/99-ip-forward.conf
sudo sysctl -p /etc/sysctl.d/99-ip-forward.conf
</syntaxhighlight>On configure nftables:<syntaxhighlight lang="bash">
sudo tee /etc/nftables.conf >/dev/null <<'EOF'
flush ruleset
table inet filter {
chain input { type filter hook input priority 0; policy accept; }
chain output { type filter hook output priority 0; policy accept; }
chain forward { type filter hook forward priority 0; policy drop;
ct state established,related accept
iif "eth1" oif "eth0" accept
}
}
table ip nat {
chain postrouting { type nat hook postrouting priority 100;
oif "eth0" masquerade
}
}
EOF
sudo systemctl enable --now nftables
</syntaxhighlight>On vérifie par :<syntaxhighlight lang="bash">
ip addr show eth1

3: eth1: <NO-CARRIER,BROADCAST,MULTICAST,UP> mtu 1500 qdisc fq_codel state DOWN group default qlen 1000
link/ether 9c:69:d3:41:32:d3 brd ff:ff:ff:ff:ff:ff
inet 10.11.11.1/24 brd 10.11.11.255 scope global noprefixroute eth1
valid_lft forever preferred_lft forever
</syntaxhighlight>Bon il n'est relié a rien (NO-CARRIER et state DOWN) mais il a bien une adresse IP correcte.

SI je branche mon PC dessus j'ai bien :<syntaxhighlight lang="bash">
ip addr show eth1

3: eth1: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc fq_codel state UP group default qlen 1000
link/ether 9c:69:d3:41:32:d3 brd ff:ff:ff:ff:ff:ff
inet 10.11.11.1/24 brd 10.11.11.255 scope global noprefixroute eth1
valid_lft forever preferred_lft forever
inet6 fe80::9e69:d3ff:fe41:32d3/64 scope link proto kernel_ll
valid_lft forever preferred_lft forever
</syntaxhighlight>L'état est passé à BROADCAST et state UP

==== Un petit dashboard sur la console ====
Un petit script permet d'avoir les info essentielles :<syntaxhighlight lang="bash">
#!/bin/bash
set -o pipefail

printf "\e[2J"
esc=$'\e'
while [ 1 ]
do
printf "\e[1;1H"
date "+%d/%m/%Y %H:%M"
echo "-----------------------------------------------"
echo -n "Routeur WAN IP: "
ifconfig eth0 | grep "inet " | awk '{print $2 " "}'
echo -n "LAN Gateway : "
ifconfig eth1 | grep "inet " | awk '{print $2 " "}'
echo "-----------------------------------------------"
echo "LAN Clients: "
cat /var/lib/misc/dnsmasq.leases | awk '{print "\033[94m",$2, "\033[0m",$3,"\033[93m",$4,"\033[0m"}'
echo "-----------------------------------------------"
echo "Services: http"
printf "node-red\t"
curl --max-time 2 -I -s http://main-host.pilan:1880 | grep HTTP | sed "s/OK/${esc}[30;42m[OK]${esc}[0m 1880/"
if [[ $? != 0 ]]; then
printf "\033[31mERREUR\033[0m\n"
fi
printf "webssh \t"
curl --max-time 2 -I -s http://main-host.pilan:8888 | grep HTTP | sed "s/OK/${esc}[30;42m[OK]${esc}[0m 8888/"
if [[ $? != 0 ]]; then
printf "\033[31mERREUR\033[0m\n"
fi
sleep 10
done
</syntaxhighlight>Si on le lance:

[[Fichier:Dashboard-router.png|sans_cadre|432x432px]]

Le plus élégant serait que ce script se lance sur le petit écran LCD du PI au démarrage. Facile on a configuré l'autologin...<syntaxhighlight lang="bash">
vi ~/.profile
</syntaxhighlight>Et on ajoute à la fin:<syntaxhighlight lang="bash">
if [ -n "$SSH_CONNECTION" ]; then
echo "Welcome to SSH users"
else
tput civis # Hide carret
./router-dash.sh
tput cnorm # Show carret
fi
</syntaxhighlight>Sur la console principale (l'écran LCD adafruit) il est toujours possible de sortir du dashboard avec <Ctrl> + C

=== Serveur DNS ===

==== Configuration ====
On a déjà installé dnsmasq donc rien a installer de plus.

Sur les clients ça marche déjà nickel (Comme on dit a Goro)

En revanche sur le routeur lui-même on utilise le DNS fournit par network manager et il utilise celui qui nous a été donné par le serveur DHCP utilisé lors de la conf de eth0.

Pas de panique c'est juste de la conf.<syntaxhighlight lang="bash">
sudo nmcli connection modify "wan" ipv4.dns "127.0.0.1 192.168.0.1"
sudo nmcli connection modify "wan" ipv4.ignore-auto-dns yes
sudo nmcli connection up "wan"

</syntaxhighlight>On redémarre dnsmasq:<syntaxhighlight lang="bash">
sudo systemctl restart dnsmasq
</syntaxhighlight>Je ne suis pas sûr que ce soit nécessaire mais bon... par acquis de conscience.

==== Tests ====
Pour tester il nous faudra des outils DNS donc :<syntaxhighlight lang="bash">
sudo apt update
sudo apt install dnsutils
</syntaxhighlight>Déja on vérifie que sur le "patte" par défaut (eth0) on accède aux deus serveurs DNS:<syntaxhighlight lang="bash">
nmcli device show eth0 | grep IP4.DNS
</syntaxhighlight>Doit nous donner DEUX lignes:<syntaxhighlight lang="text">
IP4.DNS[1]: 127.0.0.1
IP4.DNS[2]: 192.168.1.1
</syntaxhighlight>Ici le DNS n°2 est celui de ma box.

On teste:<syntaxhighlight lang="bash">
dig database
dig database.pilan
</syntaxhighlight>Qui tous deux nous donnent les détail sur 10.11.11.50 (voir plus bas)

=== Reverse proxy CADDY ===

==== Installation ====
Le "repository" n'est pas standard. Donc il faut demander gentiement:<syntaxhighlight lang="bash">

# 1. Ajouter la clé GPG
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/gpg.key' | \
sudo tee /etc/apt/trusted.gpg.d/caddy.gpg > /dev/null

# 2. Ajouter le dépôt
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/debian.deb.txt' | \
sudo tee /etc/apt/sources.list.d/caddy-stable.list

# 3. Installer Caddy
sudo apt update
sudo apt install caddy

</syntaxhighlight>Ensuite on teste caddy<syntaxhighlight lang="bash">
caddy version
</syntaxhighlight>Moi j'ai un truc comme:

<code>v2.10.1 h1:g/gTHGFRTY0dec+UgMw9Snxdgytr+KK2TdvoRL/Ovu6U8=</code>

On doit être en <code>v2.10.1</code> avec un n° de build bizarre en base64... (le décodage donne rien...)

==== Configuration ====
<syntaxhighlight lang="bash">
# Creation page de test
sudo mkdir -p /var/www/front
echo "<h1>Welcome to Front Router</h1>" | sudo tee /var/www/front/index.html

</syntaxhighlight>On édite le "caddy file":<syntaxhighlight lang="bash">
sudo vi /etc/caddy/Caddyfile
</syntaxhighlight>Avec <syntaxhighlight lang="apacheconf">
{
auto_https off # Pas de HTTPS auto en LAN
}

:80 {
root * /var/www/front
file_server
}

secure.pinon-hebert.fr {
root * /var/www/front
file_server
}

main-host.pilan {
reverse_proxy http://main-host.pilan:8080 # ce sera pour plus tard rien n'écoute ici
}

</syntaxhighlight>On valide la conf:<syntaxhighlight lang="bash">
sudo caddy fmt --overwrite /etc/caddy/Caddyfile
sudo caddy validate --config /etc/caddy/Caddyfile
</syntaxhighlight>On ne doit pas avoir d'erreur et de warnings.

Et on relance Caddy:<syntaxhighlight lang="bash">
sudo systemctl reload caddy
</syntaxhighlight>On vérifie que le port 80 soit ouvert!<syntaxhighlight lang="bash">
sudo ss -ltnp | grep :80
</syntaxhighlight>Qui doit répondre :

<code>LISTEN 0 4096 *:80 *:* users:(("caddy",pid=26458,fd=7))</code>

Et un <syntaxhighlight lang="bash">
curl http://front-router
</syntaxhighlight>Réponds :<syntaxhighlight lang="html">
<h1>Welcome to Front Router</h1>
</syntaxhighlight>

=== Chiffrement avec let's encrypy ===
Caddy incorpore par défaut un lien avec let's encrypt. Il n'y a rien a faire de ce côté là!

== Administration ==
Une fois installé voici les opérations d'administrations possibles.

=== Ajouter une redirection "reverse proxy" ===
{| class="wikitable"
|+Attention
|[[Fichier:Attention.png|sans_cadre|45x45px]]
|Pour que la redirection fonctionne il faut que le process serveur sur la machine distante soit à l'écoute sur le réseau et pas seulement sur localhost!
<code>listen 0.0.0.0 OUI</code>
<code>listen 127.0.0.1 NON</code>
|}

==== Prérequis ====
Il faut avoir enregistré un DNS toto.mondomaine.com qui pointe vers une adresse IP qui, d'une manière ou une autre arrive sur le routeur de tête.
{| class="wikitable"
|+Attention
|[[Fichier:Attention.png|sans_cadre|45x45px]]
|Il faut également que ce routeur soit ouvert sur les ports 80 et 443.
Oui il faut laisser ouvert le port 80 avec un serveur http derrière car let's encrypt s'en sert lors du renouvellement.
|}

==== Configuration ====
<syntaxhighlight lang="yaml">
# === Site public HTTPS vers toto (Let's Encrypt automatique) ===
toto.mondomaine.com {
# (Optionnel) Email ACME pour les notifications de certificat
tls tecinfo@mondomaine.com

# Logs utiles
log {
output file /var/log/caddy/toto.log
format json
level INFO
}

# Compression & quelques en-têtes sécurité
encode zstd gzip
header {
Strict-Transport-Security "max-age=31536000; includeSubDomains; preload"
X-Content-Type-Options "nosniff"
X-Frame-Options "DENY"
Referrer-Policy "strict-origin-when-cross-origin"
}

# Reverse proxy vers Node-RED sur IP qui héberge TOTO A.B.C.B et le port de TOTO PORT
reverse_proxy http://A.B.C.B:PORT {
# Caddy gère automatiquement WebSocket et X-Forwarded-*
# Si nécessaire :
# header_up Host {host}
}
}

# === (Recommandé) Forcer HTTP -> HTTPS pour ce FQDN ===
http://toto.mondomaine.com {
redir https://toto.mondomaine.com{uri}
}
</syntaxhighlight>Il faut créer le fichier de log "à la main":<syntaxhighlight lang="bash">
# Si c'est pas fait
sudo mkdir -p /var/log/caddy
sudo chown -R caddy:caddy /var/log/caddy
sudo chmod 750 /var/log/caddy
# et ensuite
sudo mkdir /var/log/caddy/toto.log
sudo chown -R caddy:caddy /var/log/caddy/toto.log
sudo chmod 750 /var/log/caddy/toto.log

</syntaxhighlight>Ensuite on relance caddy.<syntaxhighlight lang="bash">
sudo systemctl start caddy
</syntaxhighlight>Y'a 300 000 raisons pour que ça ne marche pas du premier coup mais si on fait bien tout étape par étape ça doit marcher!

=== Gestion des connexions ssh ===
Je ne sais pas pourquoi mais mon installation du routeur en <code>Raspbian GNU/Linux 13</code> vit mal les serveurs du LAN en <code>Debian GNU/Linux 12</code> qui datent d'il y a a peine 6 mois....

AU ssh j'ai des erreurs:<syntaxhighlight lang="text">
Unable to negotiate with 10.11.11.50 port 22: no matching key exchange method found. Their offer: diffie-hellman-group14-sha1,kex-strict-s-v00@openssh.com
</syntaxhighlight>Une sombre histoire d'algo de hashage que raspbian 13 considèrent comme à risque. Je vais passer les clients en <code>Raspbian GNU/Linux 13</code> des que possible mais en attendent j'ai accepé des compromis sur la sécu pour les machines du lan <code>pilan</code>.

Dans mon ~/.ssh/config j'ai ajouté:<syntaxhighlight lang="apacheconf">
Host *.pilan
User admin

# Autoriser l'ancien échange de clés (KEX)
KexAlgorithms +diffie-hellman-group14-sha1

# Si les serveurs n'annoncent que des clés/ signatures SHA-1
HostkeyAlgorithms +ssh-rsa
PubkeyAcceptedAlgorithms +ssh-rsa

# (Optionnel) ciphers classiques
</syntaxhighlight>Ce qui fait que pour les machines du lan et seulement avec le user admin on peut se loguer depuis le front.

=== Gestion de l'allocation d'IP fixes en DHCP ===
Autant je sous traite l'adresse du routeur lui même sur sa "patte" eth0 au routeur qui lui est supérieur (ma box par exemple) autant, pour les machines branchées sur eth1 il peut être intéressant de leur donner une IP fixe.

On peut rendre l'IP statique sur le client mais le plus propre est de laisser le client en DHCP mais reconnaitre l'adresse MAC du client et configurer le serveur DHCP pour lui donner TOUJOURS la même IP.

<u>Par exemple je voudrais que mon serveur de base de données appelé dadabase possède l'adresse IP 10.11.11.50</u>

Je relève son adresse mac sur le dashboard:

Pour le moment on lui a donné:

<code>b8:27:ee:cc:f9:ac 10.11.11.171 database</code>

Il faut simplement éditer le fichier: <code>/etc/dnsmasq.d/lan.conf</code>
sudo vi /etc/dnsmasq.d/lan.conf
Et ajouter/modifier la ligne :
dhcp-host=b8:27:ee:cc:f9:ac,10.11.11.50,database
Le serveur "<code>database</code>" dont l'adresse MAC est <code>b8:27:ee:cc:f9:ac</code> se verra systématiquement affecté l'adresse <code>10.11.11.50</code>. Pour que le serveur prenne en compte le changement il faut relancer <code>dnsmasq</code>
sudo systemctl restart dnsmasq
Et c'est tout.

=== Ajout d'une règle de redirection de port NAP/PAT ===
Dans cet exemple je vais rediriger ce qui rentre sur le port 2222 de eth0 sur front-router vers le port 22 sur le serveur git.

==== Modification: ====
Tout se fait dans <code>/etc/nftables.conf</code>.

On ajoute dans <code>table ip filter</code> la chaine <code>forward</code>doit être modifiée:<syntaxhighlight lang="c">
chain forward {
type filter hook forward priority 0; policy drop;

# flux établis
ct state established,related accept

# ICI LES ANCIENNES REGLES

# DNAT SSH WAN:2222 -> GIT:22
iifname $WAN oifname $LAN ip daddr $GIT tcp dport 22 ct state new accept
}

</syntaxhighlight>Et le post routing.<syntaxhighlight lang="c">
table ip nat {
chain prerouting {
type nat hook prerouting priority -100; policy accept;

# DNAT SSH (port 2222 du frontal -> GIT:22)
iifname $WAN tcp dport 2222 dnat to $GIT:22
}

</syntaxhighlight>

==== Application ====
On valide la syntaxe par :<syntaxhighlight lang="bash">
sudo nft -f /etc/nftables.conf
</syntaxhighlight>Et on relance par :<syntaxhighlight lang="bash">
sudo systemctl restart nftables
</syntaxhighlight>

==== Récapitulation ====
Le fichier <code>/etc/nftables.conf</code> contient maintenant :<syntaxhighlight lang="c">
flush ruleset

define WAN = "eth0" # 192.168.0.0/24
define LAN = "eth1" # 10.11.11.0/24
define LAN_NET = 10.11.11.0/24
define GIT = 10.11.11.30

table ip filter {
chain input {
type filter hook input priority 0; policy drop;

# loopback
iifname "lo" accept

# established/related
ct state established,related accept

# ICMP utile
ip protocol icmp accept

# DNS vers le routeur (clients du sous-LAN)
iifname $LAN udp dport 53 accept
iifname $LAN tcp dport 53 accept

# DHCP serveur (dnsmasq)
iifname $LAN udp sport 68 udp dport 67 accept
iifname $LAN udp sport 67 udp dport 68 accept

# SSH vers le routeur (port 22)
iifname $LAN tcp dport 22 accept
ip saddr 192.168.0.0/24 iifname $WAN tcp dport 22 accept

# HTTP/HTTPS vers Caddy sur le frontal
iifname $WAN tcp dport {80, 443} accept
iifname $LAN tcp dport {80, 443} accept
# HTTP/3 (QUIC)
iifname $WAN udp dport 443 accept
}

chain forward {
type filter hook forward priority 0; policy drop;

# flux établis
ct state established,related accept

# LAN -> WAN (trafic sortant)
iifname $LAN oifname $WAN ct state new accept

# DNAT SSH WAN:2222 -> GIT:22
iifname $WAN oifname $LAN ip daddr $GIT tcp dport 22 ct state new accept
}

chain output {
type filter hook output priority 0; policy accept;
}
}

table ip nat {
chain prerouting {
type nat hook prerouting priority -100; policy accept;

# DNAT SSH (port 2222 du frontal -> GIT:22)
iifname $WAN tcp dport 2222 dnat to $GIT:22
}

chain postrouting {
type nat hook postrouting priority 100; policy accept;

# Masquerade LAN -> WAN
oifname $WAN ip saddr $LAN_NET masquerade
}
}
</syntaxhighlight>Oui c'est mort depuis le WAN seul le HTTPS est ouvert (et le HTTP pour let's encrypt) inutile d'essayer de rentrer (par là en tout cas)

Infrastructure basée PI

2026-04-22T21:09:47Z

Jpinon :

[[Fichier:Image.png|vignette]]
L'architecture PILAN ressemble à quelque chose comme ça:[[Fichier:Archi pilan.png|sans_cadre|769x769px]]

Infrastructure basée PI

2026-04-22T21:07:46Z

Jpinon :

[[Fichier:Archi pilan.png|sans_cadre|769x769px]]

Fichier:Archi pilan.png

2026-04-22T21:07:22Z

Jpinon :

Architecture L2/L3 + L4/L7

Bash random

2026-04-08T08:49:23Z

Jpinon :

Les ordinateurs savent faire beaucoup de chose mais ont beaucoup de mal avec le hasard. Leur conception déterministe ne les prédispose pas à ce genre de travail. Deux solutions émergent:

* Se baser sur un phénomène physique aléatoire ou réputé tel mais c'est très difficile et il faut avoir un capteur pour cela.
* Utiliser un algorithme pseudo aléatoire. La suite de nombre sera réputé aléatoire même su toujours la même. Exemple les chiffres de PI. La suite est aléatoire mais commence toujours par 3.14... l'ordinateur utilise souvent le temps pour prendre "en marche" cette séquence.

== Sulution basée sur des répétitions de uuid ==

Dans la page de génération de uuid j'avais mentionné la disponibillité d'un outil de génération :<syntaxhighlight lang="bash">
cat /proc/sys/kernel/random/uuid
</syntaxhighlight>Qui nous donne des chaines du type :<syntaxhighlight lang="text">
45448407-faf9-42af-af54-fbe6194a510c
</syntaxhighlight>Le script suivant :<syntaxhighlight>
while [ 1 ]
do
export RND=`cat /proc/sys/kernel/random/uuid | cut -b 1-8,10-13,15-18,20-23,25-`
echo -n $RND
done
</syntaxhighlight>Va nous donner une suite ininterrompue de digits en hexa.

Si on veut du binaire xxd est notre amis mai, attention, le binaire n'est pas affichable. On redirige vers un fichier.<syntaxhighlight lang="bash">
while [ 1 ]
do
export RND=`cat /proc/sys/kernel/random/uuid | cut -b 1-8,10-13,15-18,20-23,25-`
echo -n $RND
done | xxd -r -p > binary-random.bin

</syntaxhighlight>On fait tourner ce scriot quelques secondes et on l'arrête par <CTRL>+C.

On récupère un fichier binaire aléatoire.

On peut l'afficher avec <code>od -x</code> ou avec <code>base64</code> par exemple.

Bash random

2026-04-08T08:31:50Z

Jpinon : Page créée avec « Les ordinateurs savent faire beaucoup de chose mais ont beaucoup de mal avec le hasard. Leur conception déterministe ne les prédispose pas à ce genre de travail. Deux solutions émergent: * Se baser sur un phénomène physique aléatoire ou réputé tel mais c'est très difficile et il faut avoir un capteur pour cela. * Utiliser un algorithme pseudo aléatoire. La suite de nombre sera réputé aléatoire même su toujours la même. Exemple les chiffres de PI.... »

Les ordinateurs savent faire beaucoup de chose mais ont beaucoup de mal avec le hasard. Leur conception déterministe ne les prédispose pas à ce genre de travail. Deux solutions émergent:

* Se baser sur un phénomène physique aléatoire ou réputé tel mais c'est très difficile et il faut avoir un capteur pour cela.
* Utiliser un algorithme pseudo aléatoire. La suite de nombre sera réputé aléatoire même su toujours la même. Exemple les chiffres de PI. La suite est aléatoire mais commence toujours par 3.14... l'ordinateur utilise souvent le temps pour prendre "en marche" cette séquence.

Dans la page de génération de uuid j'avais mentionné la disponibillité d'un outil de génération :<syntaxhighlight lang="bash">
cat /proc/sys/kernel/random/uuid
</syntaxhighlight>Qui nous donne des chaines du type :<syntaxhighlight lang="text">
45448407-faf9-42af-af54-fbe6194a510c
</syntaxhighlight>Le script suivant :<syntaxhighlight>
while [ 1 ]
do
export RND=`cat /proc/sys/kernel/random/uuid | cut -b 1-8,10-13,15-18,20-23,25-`
echo -n $RND
done
</syntaxhighlight>Va nous donner une suite ininterrompue de digits en hexa.

Si on veut du binaire xxd est notre amis mai, attention, le binaire n'est pas affichable. On redirige vers un fichier.<syntaxhighlight lang="bash">
while [ 1 ]
do
export RND=`cat /proc/sys/kernel/random/uuid | cut -b 1-8,10-13,15-18,20-23,25-`
echo -n $RND
done | xxd -r -p > binary-random.bin

</syntaxhighlight>On fait tourner ce scriot quelques secondes et on l'arrête par <CTRL>+C.

On récupère un fichier binaire aléatoire.

On peut l'afficher avec <code>od -x</code> ou avec <code>base64</code> par exemple.

Accueil

2026-04-08T08:08:45Z

Jpinon :

Bienvenu sur ma nouvelle "Knowledge base" [[Spécial:Version|Version]] autohébergée.

Une page temporaire pour la mise à jour de ce wiki-ci: [[MAJ WIKI]] (a faire)
{| class="wikitable"
! rowspan="5" |Développement
| colspan="2" |[[Fichier:Logo C++.png|sans_cadre|61x61px]] C/C++ : '''LE''' Langage de programation.
|Les [[sockets C]]
Gérer l'écran "à la vi" avec [[Curses en C|curses]]

Gérer le [[Temps à la milliseconde en C|temps à la milliseconde]].
|-
| colspan="2" |[[Fichier:Perl logo.png|sans_cadre|48x48px]]Perl : Le meilleur langage de script.
|Quelques [[Quelques modules Perl|modules Perl]] utiles.
Petits [[hacks en perl]].
|-
| colspan="2" |[[Fichier:Python Logo.png|alt=Python|sans_cadre|74x74px]]Python : Pas mon préféré mais il est tellement utilisé!
|Syntaxe [[Les bases de Python|de base]],
Gestion des [[Exceptions en Python|exceptions]].

Python et ses [[Environnements virtuels Python|environnements virtuels]].

Les [[Modules et outils de développement Python|modules et les outils de développement]].

[[Gestion des documents PDF en Python|Gestion des documents PDF]].

[[Petits exemples de code Python|Petits exemples de code]].
|-
|Outils
|[[Fichier:Git logo.png|sans_cadre|67x67px]]Git
|[[GIT Utilisation simple|Utilisation simple]]
[[GIT-HUB]]
|-
|Shell
|sh/bash
|Syntaxe du [[If en bash|if]].
Syntaxe de [[For in bash|for]].

Traiter des [[CSV bash|fichiers csv]]
Traitement de phrases [[Encodage d'objets complexes#Usage en shell (commande jq)|JSON avec jq]]

[[Bash random|Générer de hasard]].
|-
! rowspan="8" |Système
| rowspan="2" |Global
|[[Encodage]] de caractères
|Le [[code morse]], le [[code baudot]], les codes [[ASCII]], les séquences [[ANSI]] le code [[Code Gray|Gray]] et un OVNI, le code [[Extended Binary Coded Decimal Interchange Code|EBCEDIC]]
les code [[UNICODE]].
|-
|Encodage d'objets
|Les [[entiers]]
le [[temps]]

Les [[nombres flottants]]

[[Encodage d'objets complexes|Les objets complexes]]

Encodage de binaire en [[base64]].
|-
| rowspan="3" |Linux [[Fichier:Linux-logo.png|sans_cadre|93x93px]]
|Général
|[[Généralités Linux|Généralités]] quel que soient les distributions de linux (ou UNIX).
Lancer un [[deamon avec systemd]].

Configurer une client [[Connexion SSH|ssh]].

Installer [[web-ssh]]
|-
|Debian (Ubuntu...)
|[[Gestion des services Debian/Ubuntu|Gestion des services]]

[[Nettoyage APT]]

Informations sur une [[Info distribution DEBIAN|distribution]]
|-
|WSL
|[[Relancer WSL]]

[[Monter un disque externe dans wsl]]

[[Utiliser un port USB dans WSL]]
|-
|Windows [[Fichier:Microsoft Windows Logo.png|sans_cadre|96x96px]]
|..., 10, 11
|[[Wireshark]] <sub>(images manquantes)</sub>
CYGWIN

[[MINGW32]]

[[Scoop]]
|-
|[[Open WRT]]
[[Fichier:Open WRT LOGO.png|sans_cadre|135x135px]]
|Global
[[GL Inet]]

[[Fichier:Gl-inet-router.png|sans_cadre|147x147px]]
|[[GL Inet Reset|Reset]] sortie d'usine.
Réglage du serveur [[Open WRT DHCP|DHCP]]

Ajouter un [[OpenWRTpackages|package]].

[[Open WRT Commandes de base pour le réseau|Commandes de base pour le réseau]].

[[tcpdump]]

Comment [[configurer un routeur pour activer le ssh depuis le côté WAN.]]

Comment [[configurer un routeur pour activer le WEB depuis le coté WAN]]

Gérer des ampoules [[Wiz et OpenWRT|Phillips Wiz]].

Installer un outil de [[Test de la bande passante Open WRT|test de la bande passante]] de la patte "wan"
|-
|Auto hébergement
[[Fichier:AnarchySymbol.png|sans_cadre|107x107px]]
|[[Fichier:Raspberry.png|sans_cadre|40x40px]] [[Raspberry PI]]
|L'auto hébergement est assez facile à réaliser chez sois. Une solution est d'utiliser un ou plusieurs raspberry PI.
[[Auto Hebergement|La base]] explique l'installation de base d'un PI comme module de base.

REPRISE de l'architecture. Je vais tenter une refonte de cette section. Elle devrait remplacer celle ci dessus

# [[Infrastructure basée PI|Architecture]]
# <code>front-router</code>[[Le routeur en tête réseau PI|Le routeur en tête]]
# [[Node-red dans le LAN|Un serveur Node-red]]
#<code>git</code>[[PI GitLab|Un serveur Git]]
#<code>database</code>[[PI MariaDB|Un serveur de base de données]]
#<code>mediawiki</code> [[PI MediaWiki|Un serveur mediawiki]]
|-
! rowspan="3" |APIs
| rowspan="3" |Géolocalisation et cartographie
|IP API
|[[Abstract API]] Donne une localisation a partir d'une IP
[[IPinfo]] Une autre bibliotheque de localisation d'IP
|-
|Ephemérides
|[[Sunset and sunrise times API]] va nous dire quand le soleil se lève quand il se couche, la lune…
|-
|Trafic Aérien
|[[FlightRadar24]]
|-
! rowspan="6" |Logiciels
| rowspan="4" |Middleware
|Bases de données relationelles
|Le langage [[SQL]]
Les "minimales": [[MariaDB]]

Les encore plus minimales: [[SQLite]]

Les maximales: [[Oracle]], [[PostgeSQL]]
|-
|Bases de données NoSQL
|[[mongodb]]
|-
|Messages
|[[MQTT]]
|-
|Serveur applicatifs/web
|[[Apache]]

[[Weblogic]]
|-
| rowspan="2" |Bureautique
|Excel
|[[Gestion des dates sous Excel|Gestion des dates]]<nowiki/>
[[EXCEL Gestion des chaines de caractères|Gest]][[EXCEL Gestion des chaines de caractères|io]][[EXCEL Gestion des chaines de caractères|n d]][[EXCEL Gestion des chaines de caractères|es cha]][[EXCEL Gestion des chaines de caractères|în]][[EXCEL Gestion des chaines de caractères|es de c]][[EXCEL Gestion des chaines de caractères|ar]][[EXCEL Gestion des chaines de caractères|actère]][[EXCEL Gestion des chaines de caractères|s]]

[[Identifier si la clé d'une ligne est présente dans un autre tableau]].
|-
|Outlook
|[[Outlook - Gestion des archives|Gestion des archives]]
|-
! rowspan="4" |Sécurite
|Chiffrement / déchiffrage
|OpenSSL
|[[Les bases de Open SSL|La base]]
[[OpenSSL et AES]] (symetrique)

[[OpenSSL_et_RSA]] (asymetrique)

Avec [[SMIME et Certificats x509|x509 et SMIME]] on marie les deux

Comment [[OpenSSL extraire un certificat|extraire un certificat]] d'un serveur en production.

PGP et [[GPG]] (chiffrer de documents)

Générer un [[mode de passe sécurisé]]

Les autres commandes [[openssl]].
|-
| rowspan="3" |Certificats
|Generalités
|[[Les certificats X.509|Un certificat c'est quoi?]]
|-
|PKI
|[[PKI familiale|Faire une PKI "familiale"]]
|-
|https
|[[Certificats Serveur https|Certificats Serveur]]
[[Certificats Client https|Certificats Client]]

[[Let's encrypt]]
|-
! rowspan="10" |Embarqué
| rowspan="3" |Microcontroleurs
|[[Fichier:Arduino Logo.png|sans_cadre|40x40px]][[Arduino]]
|
|-
|[[ESP8266]]
|Le module [[SON/OFF Smart Switch|Smart Switch]] de SONOFF
|-
|[[Fichier:Espessif logo.png|gauche|sans_cadre|40x40px]][[ESP32]]
|Environnement de dev [[ESP-IDF]], Utiliser [[mkspiffs]].
La carte "breakout" [[ESP32_DEVKITV1]]
La carte "AZ delivery" [[ESP32_DEVKITV2]]

Faire des [[ESP32 Requetês HTTPs|requetês HTTPs]]

[[ESP32 Firmware Update|Firmware Update]]

[[ESP32 Matrice de led|Exemple d'utilisation de matrice de LED]] (circuit MAX 72xx)

Programmation module [[ESP32C3 avec écran spotear]].
|-
!Fusion
|Dev ESP 32 sur Raspberry PI
|Ici un article qui touche aux deux sujets. [[Poste de DEV ESP32 sur PI|Comment programmes les microcontrôleurs ESP32 à partir d'un raspberry PI]].
|-
| rowspan="3" |SBC (single board computers)
| rowspan="2" |[[Fichier:Logo PI.png|sans_cadre|36x36px]][[Raspberry PI]]
|[[Les modèles de Raspberry PI]]
La configuration réseau [[DHCP ou IP fixe]]

Ecran [[Écran Adafruit 2.8 pouces TFT|Adafruit 2.8']]'et [[Cohabitation écran Adafruit PiTFT 2.8" et HDMI|Cohabitation des écrans]].

Utiliser le [[frame-buffer]]

[[Demarrer PI4 en USB|Gérer un PI4 dont le lecteur de carte SD est HS]].
|-
|Installer :
[[RPi-NodeRed|NodeRed]], [[Mosquitto]], [[MariaDB sur Raspberry PI|MariaDB]]

Le service graphique de gestion des mises à jour [[PackageKit]]
|-
|[[Fichier:Bpi.png|sans_cadre|48x48px]]Banana PI
|
|-
| rowspan="3" |Objets connectés
|[[Fichier:PHILLIPS HUE LOGO.png|sans_cadre|87x87px]]
|Description [[PHILLIPS HUE|API]] de base
Le site de Phillips : https://developers.meethue.com/develop/hue-api-v2/getting-started/
|-
|[[Fichier:X-sense logo.png|sans_cadre|52x52px]]x-sense
|[[X-sense|Description générale]]
Utilisation avec le module [[python-xsense]]
|-
|Phillips Wiz
|Les limites de ces [[Securite PHILLIPS WIZ|ampoules au niveau sécurité]].
Utilisation avec un [[Wiz et OpenWRT|routeur OpenWrt]]
|-
! rowspan="9" |Electronique
|Composants
|Composants actifs
|[[Le transistor bipolaire]]
|-
|Circuits
|Filtres
|Filtre de rejection : https://poujouly.net/2015/10/25/filtre-notch-50hz/ (oui un lien externe pour le moment)
|-
| rowspan="5" |Le labo
|Le protocoles
|[[UART/RS323]]

[[SCPI uart]]
|-
| rowspan="4" |Les outils de mesures connectables
|[[Multimètre]] modèle :

* [[Multicomp PRO MP730027]]
|-
|[[Générateur de fonctions arbitraire]] modèles :

* [[GwINSTEK AFG-2012]]
* [[Multicomp MP75511]]
* [[FeelTech FY6600]]
|-
|[[Osciloscope]]
|-
|[[Alimantation]]

[[Alimentation USB C]]
|-
| rowspan="2" |Conception
|[[Fichier:Autodesk Eagle logo.png|sans_cadre|123x123px]]
|Logiciel de conception de circuits et de modélisation de circuit imprimés.
[[EAGLE - Plans de masse|Plans de masse]]

[[Les unités dans EAGLE]]
|-
|LTspice
|Logiciel de simulation électronique
[[LTspice fichier de simulation|Utiliser un signal numérisé en entré d'une simulation]].
|-
! rowspan="7" |CAO FAO
| rowspan="2" |Mécanique
|Visserie
|[[Dimensions visserie ISO]]
|-
|Usinage
|Dimensions des [[fraises en unités Imériales/US]]
|-
|Fabrication additive
|Imprimantes 3D FDM
|[[Fichier:Ultimaker logo.png|sans_cadre|37x37px]] [[Ultimaker 2]]
|-
|CNC
|Fraiseuses
|La base… la [[CNC 3018|3018]].
Faire des perçages avec un [[CNC Percages gcode|programme python]].

Graver des [[PCB avec CNC|PCB]]

[[Changer la broche CNC3018|Changer la broche]]
|-
|Découpeuse (Vinyle ou autre)
|Silhouette
|[[SILHOUETTE Paramètres de base|Paramètres de base]]
|-
|Logiciels de CAO
|[[Fichier:Freecad logo.png|alt=FREE CAD|sans_cadre|47x47px]]FreeCad
|[[FreeCad]]
|-
|Outillage
|Metrologie
|[[Comparateur Numérique]]
|-
! rowspan="5" |Projets complets
| rowspan="4" |Création/Configuration de serveur
| rowspan="4" |Exemple chez GANDI
|[[Serveur mediawiki basé docker]]
|-
|[[Serveur nodered basé docker]]
|-
|[[Serveur Owncloud]]
|-
|[[Serveur DNS GANDI|Serveur DNS]]
|-
|Objets connectés
|ESP32
|[[ESP32 Horloge à LED|Une Horloge à LED]]
|-
! rowspan="3" |Photos
|Matériel
|D90
[[Fichier:D90.png|sans_cadre|58x58px]]
|[[Connectique D90|Connectique]]
|-
|Théorie
|
|Les [[bases en optique pour la photo]]
|-
|Logiciel
|
|
|}

Python-xsense

2026-03-28T23:08:37Z

Jpinon :

L'utilisation des capteurs x-sense en dehors des applications classiques est assez mal documentée. J'ai seulement trouvé un module python : [https://github.com/theosnel/python-xsense/tree/develop python-xsense] sur github.

== Installation ==
Pour moi elle a été relativement douloureuse mais avec les infos ci-dessous ca va tout seul.

Il vaut mieux créer un environnement virtuel python pour cela.<syntaxhighlight lang="bash">
python -m venv x-sense-env
source x-sense-env/bin/activate
</syntaxhighlight>On clone le repository git.<syntaxhighlight lang="bash">
git clone https://github.com/theosnel/python-xsense.git
cd python-xsense
</syntaxhighlight>On y est mais avant de lancer le test.py il y a beaucoup de modules a installer.<syntaxhighlight lang="bash">
python -m pip install requests
python -m pip install boto3
python -m pip install pycognito
python -m pip install paho-mqtt
python -m pip install aiohttp
</syntaxhighlight>Attention pour paho. Le programme dit qu'il manque le module paho mais, si on le trouves pour windows, pour linux il faut bien préciser paho-mqtt!

Ensuite on lance le programme de test avec les identifiants que l'on a entrés avec l'application lors de la création du compte.<syntaxhighlight lang="text">
python test.py --username 'mail@mondomaine.com' --password 'monmotdepasse'
----[ Paris Eugène Millon (XXXX7AD2F07111EXXXX711521EXXXXAA) ]-----------------
Station de base (SBS50):
serial : 14BXXXX
online : yes
values : {'type': 'SBS50', 'stationSN': '14B9XXXX', 'deviceSN': '14B9XXXX', 'sw': 'v1.5.7', 'rfFreq': '868', 'voiceVol': '75', 'alarmVol': '75', 'alarmTone': '1', 'ledBrt': '8', 'ssid': 'XXX', 'ip': 'X.Y.Z.101', 'mac': 'EC:C9:FF:7A:XX:XX', 'macBT': 'EC:C9:FF:7A:XX:XX', 'wifiRSSI': '-61'}
# Station de base (XXXXE563F07111EFB406B141D849XXXX)
Thermo-hygromètre (STH51):
serial : 00000001
online : yes
values : {'type': 'STH51', 'batInfo': 3, 'rfLevel': 3, 'online': '1', 'alarmStatus': False, 'temperature': 19.8, 'humidity': 45.6, 'temperatureUnit': '1', 'temperatureRange': [-20, 60], 'humidityRange': [0, 100], 'alarmEnabled': True, 'continuedAlarm': False, 'time': '20250221181904'}
Thermo-hygromètre 2 (STH51):
serial : 00000002
online : yes
values : {'type': 'STH51', 'batInfo': 3, 'rfLevel': 3, 'online': '1', 'alarmStatus': False, 'temperature': 18.4, 'humidity': 51.2, 'temperatureUnit': '1', 'temperatureRange': [-20, 60], 'humidityRange': [0, 100], 'alarmEnabled': True, 'continuedAlarm': False, 'time': '20250221181904'}
Thermo-hygromètre 3 (STH51):
serial : 00000003
online : yes
values : {'type': 'STH51', 'batInfo': 3, 'rfLevel': 3, 'online': '1', 'alarmStatus': False, 'temperature': 18.7, 'humidity': 48.8, 'temperatureUnit': '1', 'temperatureRange': [-20, 60], 'humidityRange': [0, 100], 'alarmEnabled': True, 'continuedAlarm': False, 'time': '20250221181905'}

</syntaxhighlight>On voit bien comment obtenir toutes les informations sur les capteurs installés. En particulier la température et l'humidité des 3 capteurs.

L'étude du code nous en apprendra beaucoup.

=== Repository GIT ===
Un repo git est crée dans l'environnement de dev.<syntaxhighlight lang="bash">
git clone git:repo/python-xsense
</syntaxhighlight>Lire le README.MD il résume ce qui est dit ci-dessus et explique comment ça marche.

PI GitLab

2026-03-24T00:06:08Z

Jpinon : /* Depuis l'extérieur du LAN "pilan" */

== Installation ==

=== La base ===
On crée une carte standard avec Raspberry Pi Imager (Dernière version sans desktop et en activant l'acces ssh).

Plus un petit :<syntaxhighlight lang="bash">
sudo apt update
sudo apt upgrade

</syntaxhighlight>Pour rattraper le retard de l'image sur le dépots.

Ensuite un <code>sudo raspi-config</code> pour :

* Activer l'autologin que l'on utilisera en urgence si le frontal plante ou si on a oublie le mot de passe.
* Le "expand file system" être sur de ne rien perdre.

On lui ajoute une adresse IP fixe sur le routeur : [[Le routeur en tête réseau PI#Gestion de l'allocation d'IP fixes en DHCP|IP FIXE]].

=== La partie spécifique ===
On commence par la base:<syntaxhighlight lang="bash">
sudo apt install -y git
sudo apt install -y cgit
sudo apt install -y fcgiwrap spawn-fcgi
</syntaxhighlight>

* '''fcgiwrap''' : un petit démon qui “wrappe” les scripts CGI pour les exécuter via le protocole FastCGI. → C’est ce qui permet à un serveur web (lighttpd, nginx, Caddy via reverse proxy) de lancer <code>cgit.cgi</code> proprement.
* '''spawn-fcgi''' : un utilitaire pour démarrer <code>fcgiwrap</code> facilement (en créant un socket Unix ou TCP).

==== Config de fcgiwrap ====
Créer une fichier <code>fcgiwrap.service</code> :<syntaxhighlight lang="ini">
[Unit]
Description=fcgiwrap FastCGI server
After=network.target

[Service]
ExecStart=/usr/bin/spawn-fcgi -s /var/run/fcgiwrap.socket -M 0660 -u www-data -g www-data /usr/sbin/fcgiwrap
Restart=always
RestartSec=2

[Install]
WantedBy=multi-user.target
</syntaxhighlight>Et utiliser le fichier d'installation install.sh :<syntaxhighlight lang="bash">
#!/bin/bash
sudo cp fcgiwrap.service /etc/systemd/system/.
sudo systemctl daemon-reload
sudo systemctl enable fcgiwrap.service
sudo systemctl start fcgiwrap.service
</syntaxhighlight>l'installation donne :<syntaxhighlight lang="text">
Synchronizing state of fcgiwrap.service with SysV service script with /usr/lib/systemd/systemd-sysv-install.
Executing: /usr/lib/systemd/systemd-sysv-install enable fcgiwrap
Created symlink '/etc/systemd/system/multi-user.target.wants/fcgiwrap.service' → '/etc/systemd/system/fcgiwrap.service'.
</syntaxhighlight>Et on peut vérifier par :<syntaxhighlight lang="bash">
systemctl status fcgiwrap.service
</syntaxhighlight>Qui nous réponds par un beau:

[[Fichier:Fcgiwrap.socket.status.png|sans_cadre|569x569px]]

J'ai pas pu résister à mettre une jolie copie d'écran avec du vert partout.

On a GIT installé sur le serveur et on a fcgi qui propose un acces a git en cgi-bin. Il faut maintenant installer un serveur http pour gérer le lien http avec le programme CGI.

==== Installation lighthttp ====
<syntaxhighlight lang="bash">
sudo apt install -y lighttpd
sudo lighttpd-enable-mod fastcgi
</syntaxhighlight>L'installation se fait normalement et ensuite le module fastcgi est activé:<syntaxhighlight lang="text">
Enabling fastcgi: ok
Run "service lighttpd force-reload" to enable changes
</syntaxhighlight>

==== Connexion avec cgit. ====
On modifie /etc/lighttpd/lighttpd.conf :

Dans les modules on doit trouver :<syntaxhighlight lang="text">
server.modules = (
"mod_indexfile",
"mod_access",
"mod_alias",
"mod_redirect",
"mod_fastcgi"
)
</syntaxhighlight>et la définition du serveur :<syntaxhighlight>
server.document-root = "/usr/share/cgit"
server.upload-dirs = ( "/var/cache/lighttpd/uploads" )
server.errorlog = "/var/log/lighttpd/error.log"
server.pid-file = "/run/lighttpd.pid"
server.username = "www-data"
server.groupname = "www-data"
server.port = 8080
</syntaxhighlight>Dans <code>/etc/lighttpd/conf-available</code> on crée 50-cgit.conf :<syntaxhighlight lang="text">
# Activer les modules nécessaires (en extension, pas en redéfinition)
server.modules += ( "mod_fastcgi", "mod_alias" )

# Déclarer cgit via FastCGI (socket systemd fcgiwrap)
# On mappe l'URL /cgit vers le CGI cgit.cgi
fastcgi.server += ( "/cgit" =>
((
"socket" => "/run/fcgiwrap.socket",
"bin-path" => "/usr/lib/cgit/cgit.cgi",
"check-local" => "disable",
"mode" => "responder"
))
)

# Servir les assets CSS / logo
alias.url += ( "/cgit-css/" => "/usr/share/cgit/" )

# Permettre que cgit soit servi comme page d'index
index-file.names += ( "cgit.cgi" )

</syntaxhighlight>On active le fichier de conf :<syntaxhighlight lang="bash">
sudo lighttpd-enable-mod cgit
</syntaxhighlight>On vérifie la syntaxe:<syntaxhighlight lang="bash">
sudo lighttpd -t -f /etc/lighttpd/lighttpd.conf
</syntaxhighlight>Qui doit nous répondre : <code>Syntax OK</code>

On crée le répertoire :<syntaxhighlight lang="bash">
sudo mkdir -p /srv/git
sudo chown -R www-data:www-data /srv/git

sudo mkdir -p /var/log/lighttpd
sudo chown www-data:www-data /var/log/lighttpd

</syntaxhighlight>Et on redémarre lighthttpd:<syntaxhighlight lang="bash">
sudo systemctl restart lighttpd
</syntaxhighlight>

== Utilisation ==

=== Depuis le LAN "pilan" ===
Là c'est simple on clone un repo par :<syntaxhighlight lang="bash">
git clone user-git@git.pilan:repo/misc.git
</syntaxhighlight>

=== Depuis l'extérieur du LAN "pilan" ===
Donc depuis mon LAN domestique ou connecté en VPN dessus:

On doit utiliser la redirection de port entre front-router:2222 et git:22.<syntaxhighlight lang="bash">git clone "ssh://jpinon@git:2222/~/repo/misc.git"</syntaxhighlight>C'est un peut plus relou.

On peut se simplifier la vie en ajoutant dans <code>.ssh/config</code><syntaxhighlight lang="makefile">Host git
HostName git
Port 2222
User user-git</syntaxhighlight>Apres ça un simple :<syntaxhighlight lang="bash">
git clone git:repo/misc.git
</syntaxhighlight>marchera très bien !

ESP32C3 avec écran spotear

2026-03-22T21:55:02Z

Jpinon : /* Niveau Hardware */

Poste de DEV ESP32 sur PI

2026-03-22T21:20:37Z

Jpinon : /* Exemple */

ttyACM0: USB ACM deviceUne fois n'est pas coutume je vais utiliser un Raspberry PI en mode graphique. Un bel écran HDMI branché sur HDMI N°1.

Une installation simple avec toutes les valeurs de bases et seulement un ou deux delta:

* [[PackageKit|Suppression de l'outil graphique PackageKit]] qui empèche les sudo apt install normeaux.
* Mettre a jour avec
<syntaxhighlight lang="bash">
sudo apt update
sudo apt upgrade
sudo apt full-upgrade
sudo apt install gnome-screenshot #C'est pas necessaire mais pour enrichier ce wiki je mets ca sur tous mes postes de dev

</syntaxhighlight>
* Passer Chromium en français pour pouvoir éditer ce site tranquilement.

== Préparer le Raspberry Pi ==
Normalement c'est inutile sur une installation par défaut mais au cas ou...<syntaxhighlight lang="bash">sudo apt install python3 python3-pip python3-venv git build-essential</syntaxhighlight>

== Installer Visual Studio Code (version ARM64/ARMHF) ==
Visual studio code n'est pas dans les repo par défaut. Il fout faire toute le sequence suivante:<syntaxhighlight lang="bash">sudo apt install wget gpg # Pour moi sur une insall par défaut ça n'a rien fait
# On télécharge la clé gpg de microsoft
wget -qO- https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > microsoft.gpg
# On installe cette clé
sudo install -o root -g root -m 644 microsoft.gpg /usr/share/keyrings/
# On ajoute une source pour apt
sudo sh -c 'echo "deb [arch=arm64 signed-by=/usr/share/keyrings/microsoft.gpg] https://packages.microsoft.com/repos/code stable main" > /etc/apt/sources.list.d/vscode.list'
# On synchronise
sudo apt update
# On installe (c'est que ca fait le boulot)
sudo apt install code</syntaxhighlight>

== Installer PlatformIO dans VS Code ==
On ouvre Visual Studio Code sagement avec le menu "Framboise | Programmation | Visual Studio Code".

[[Fichier:Visualstudiocode.png|sans_cadre|600x600px]]

Aller dans "extension" : Icone [[Fichier:Visualstudiocode-extensions.png|sans_cadre|25x25px]]

On recherche platformIO

[[Fichier:Visualstudiocode-platformio.png|sans_cadre]]

Et on installe. (Si ça demande si on y crois "Trust" on dit oui)

Ça prend quelques minutes et ça affiche la page de garde PlatformIO.

[[Fichier:Platform-io home.png|sans_cadre|871x871px]]

== Installer les toolchains ESP32 (automatique) ==
Il n'y a rien a installer en tant que tel. Ça se fait à la création du projet. On passe donc à la suite.

== Créer un projet ESP32 avec PlatformIO ==
Par défaut ca vas être créé dans (ça doit pouvoir se changer mais je sais pas encore faire):<syntaxhighlight lang="bash">
/home/$USER/Documents/PlatformIO/Projects/
</syntaxhighlight>On clique sur l'icône Platform IO dans la barre d'icône de gauche: [[Fichier:Platform-io icon.png|sans_cadre|28x28px]]

On attends un moment (surtout le première fois)...

Et dans la fenêtre : PlatformIO:

[[Fichier:Platform-io menu.png|sans_cadre|316x316px]]

On clique sur Create new Project.

[[Fichier:Platform-io home-2.png|sans_cadre|778x778px]]

On clique sur "+ New Project"

=== Choisir la "carte". ===
La il faut savoir quelle carte on a et surtout quelle est son interface.

Si on branche la carte sur le PI et que l'on examine dmesg.<syntaxhighlight lang="text">[ 6757.122196] usb 1-1.1: new full-speed USB device number 10 using xhci_hcd
[ 6757.217480] usb 1-1.1: New USB device found, idVendor=303a, idProduct=1001, bcdDevice= 1.01
[ 6757.217498] usb 1-1.1: New USB device strings: Mfr=1, Product=2, SerialNumber=3
[ 6757.217503] usb 1-1.1: Product: USB JTAG/serial debug unit
[ 6757.217508] usb 1-1.1: Manufacturer: Espressif
[ 6757.217512] usb 1-1.1: SerialNumber: AC:A7:04:83:55:70
[ 6757.226869] cdc_acm 1-1.1:1.0: ttyACM0: USB ACM device</syntaxhighlight>Ici j'ai une interface en ttyACM0. J'aurais pu avoir :<syntaxhighlight lang="text">[ 6757.226869] usb 1-1.3: ch341-uart converter now attached to ttyUSB0</syntaxhighlight>On choisit la carte en fonction de ça :
{| class="wikitable"
|+Type de carte
!dmesg
!carte
|-
|<code>cdc_acm 1-1.1:1.0: ttyACM0: USB ACM device</code>
|<code>esp32-c3-devkitc-02</code>
|-
|<code>usb 1-1.3: ch341-uart converter now attached to ttyUSB0</code>
|<code>esp32-c3-devkitm-1</code>
|-
|Doit y en avoir d'autres
|...
|}
Donc pour moi :

[[Fichier:Visualstudiocode-platformio-board.png|sans_cadre|593x593px]]

Dans un premier temps le framework Arduino c'est plus simple.

On clique sur Finish et on attends...
{| class="wikitable"
|+Attention
|[[Fichier:Attention.png|sans_cadre|44x44px]]
|Cette partie doit se faire ''connecté à internet'' la première fois puisque, comme vu plus haut, c'est là que l'on va chercher les éléments de la ''toolchain'' manquants.
|}
On a successivement les infos suivantes :

[[Fichier:ESP32-rasp-02.png|sans_cadre|300x300px]] [[Fichier:ESP32-rasp-01.png|sans_cadre|296x296px]] [[Fichier:ESP32-rasp-03.png|sans_cadre]] [[Fichier:ESP32-rasp-04.png|sans_cadre|296x296px]]

A la fin (moi ca a pris 15 min mais je suis loin du Point D'acces Wifi) on a un beau projet :

[[Fichier:Default-esp32-project.png|sans_cadre]]

Le code de "main.cpp" est par défaut :<syntaxhighlight lang="c">
#include <Arduino.h>

// put function declarations here:
int myFunction(int, int);

void setup() {
// put your setup code here, to run once:
int result = myFunction(2, 3);
}

void loop() {
// put your main code here, to run repeatedly:
}

// put function definitions here:
int myFunction(int x, int y) {
return x + y;
}
</syntaxhighlight>

== Connectivité USB ==
En fonction de la carte (voir ci dessus) on a un "device" que le système crée au branchement :<syntaxhighlight lang="text">
crw-rw----+ 1 root plugdev 166, 0 22 mars 18:49 /dev/ttyACM0 # C'est mou cas
crw-rw----+ 1 root dialout 166, 0 22 mars 18:49 /dev/ttyUSB01 # Ca pourait être ça
</syntaxhighlight>Il faut vérifier que l'utilisateur que vous utilisez pour le dev soit bien membre du groupe (<code>plugdev</code> ou <code>dialout</code>) <syntaxhighlight lang="text">
uid=.... gid=.... groupes=20(dialout),24(cdrom),29(audio),44(video),46(plugdev),60(games),100(users),102(netdev),986(gpio),992(render),996(input)

</syntaxhighlight>Moi je suis bien : <code>plugdev</code> donc ça va marcher sinon un petit :<syntaxhighlight lang="bash">
sudo usermod -aG dialout $USER
sudo usermod -aG plugdev $USER
</syntaxhighlight>et ça marche!

== Compiler et flasher ==
On arrive au cœur du sujet!

Moi j'ai du modifier platformio.ini:<syntaxhighlight lang="ini">
; PlatformIO Project Configuration File
;
; Build options: build flags, source filter
; Upload options: custom upload port, speed and extra flags
; Library options: dependencies, extra library storages
; Advanced options: extra scripting
;
; Please visit documentation for the other options and examples
; https://docs.platformio.org/page/projectconf.html

[env:esp32-c3-devkitc-02]
platform = espressif32
board = esp32-c3-devkitc-02
framework = arduino
upload_protocol = esptool
upload_port = /dev/ttyACM0
monitor_port = /dev/ttyACM0
monitor_speed = 115200
debug_tool = custom
debug_server =

</syntaxhighlight>On sauvegarde et ensuite, sur la petite barre du bas:

[[Fichier:Visualstudio-lower-bar.png|sans_cadre|709x709px]]

On clique sur la coche pour compiler: Ce doit se terminer par un beau SUCCESS en vert.

On clique ensuite sur le flèche (entre la coche et la poubelle) : On voit les logs de esptool :<syntaxhighlight lang="text">
Compressed 228800 bytes to 128556...
Writing at 0x00010000... (12 %)
Writing at 0x0001aa3d... (25 %)
Writing at 0x0002180e... (37 %)
Writing at 0x00027993... (50 %)
Writing at 0x0002df5c... (62 %)
Writing at 0x00033c3b... (75 %)
Writing at 0x0003b93d... (87 %)
Writing at 0x00042705... (100 %)
Wrote 228800 bytes (128556 compressed) at 0x00010000 in 0.8 seconds (effective 2163.5 kbit/s)...
Hash of data verified.
</syntaxhighlight>Et aussi un beau SUCCESS en vert.

C'est fait on a flashé avec un beau programme... qui fait rien.

== Exemple ==
Avec la carte avec [[ESP32C3 avec écran spotear|écran et ESP32-C3]] j'ai testé:<syntaxhighlight lang="c++">#include <Arduino.h>

#define LED_PIN 11
#define PERIODE 500 // miliseconds

void setup() {
// put your setup code here, to run once:
pinMode(LED_PIN,OUTPUT);
}

void loop() {
// put your main code here, to run repeatedly:
digitalWrite(LED_PIN,true);
delay (PERIODE/2);
digitalWrite(LED_PIN,false);
delay (PERIODE/2);
}</syntaxhighlight>Ca marche bien j'ai la led à droit de la prise USB qui clignotte.

ESP32C3 avec écran spotear

2026-03-22T21:18:18Z

Jpinon :

Poste de DEV ESP32 sur PI

2026-03-22T21:15:31Z

Jpinon :

ttyACM0: USB ACM deviceUne fois n'est pas coutume je vais utiliser un Raspberry PI en mode graphique. Un bel écran HDMI branché sur HDMI N°1.

Une installation simple avec toutes les valeurs de bases et seulement un ou deux delta:

* [[PackageKit|Suppression de l'outil graphique PackageKit]] qui empèche les sudo apt install normeaux.
* Mettre a jour avec
<syntaxhighlight lang="bash">
sudo apt update
sudo apt upgrade
sudo apt full-upgrade
sudo apt install gnome-screenshot #C'est pas necessaire mais pour enrichier ce wiki je mets ca sur tous mes postes de dev

</syntaxhighlight>
* Passer Chromium en français pour pouvoir éditer ce site tranquilement.

== Préparer le Raspberry Pi ==
Normalement c'est inutile sur une installation par défaut mais au cas ou...<syntaxhighlight lang="bash">sudo apt install python3 python3-pip python3-venv git build-essential</syntaxhighlight>

== Installer Visual Studio Code (version ARM64/ARMHF) ==
Visual studio code n'est pas dans les repo par défaut. Il fout faire toute le sequence suivante:<syntaxhighlight lang="bash">sudo apt install wget gpg # Pour moi sur une insall par défaut ça n'a rien fait
# On télécharge la clé gpg de microsoft
wget -qO- https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > microsoft.gpg
# On installe cette clé
sudo install -o root -g root -m 644 microsoft.gpg /usr/share/keyrings/
# On ajoute une source pour apt
sudo sh -c 'echo "deb [arch=arm64 signed-by=/usr/share/keyrings/microsoft.gpg] https://packages.microsoft.com/repos/code stable main" > /etc/apt/sources.list.d/vscode.list'
# On synchronise
sudo apt update
# On installe (c'est que ca fait le boulot)
sudo apt install code</syntaxhighlight>

== Installer PlatformIO dans VS Code ==
On ouvre Visual Studio Code sagement avec le menu "Framboise | Programmation | Visual Studio Code".

[[Fichier:Visualstudiocode.png|sans_cadre|600x600px]]

Aller dans "extension" : Icone [[Fichier:Visualstudiocode-extensions.png|sans_cadre|25x25px]]

On recherche platformIO

[[Fichier:Visualstudiocode-platformio.png|sans_cadre]]

Et on installe. (Si ça demande si on y crois "Trust" on dit oui)

Ça prend quelques minutes et ça affiche la page de garde PlatformIO.

[[Fichier:Platform-io home.png|sans_cadre|871x871px]]

== Installer les toolchains ESP32 (automatique) ==
Il n'y a rien a installer en tant que tel. Ça se fait à la création du projet. On passe donc à la suite.

== Créer un projet ESP32 avec PlatformIO ==
Par défaut ca vas être créé dans (ça doit pouvoir se changer mais je sais pas encore faire):<syntaxhighlight lang="bash">
/home/$USER/Documents/PlatformIO/Projects/
</syntaxhighlight>On clique sur l'icône Platform IO dans la barre d'icône de gauche: [[Fichier:Platform-io icon.png|sans_cadre|28x28px]]

On attends un moment (surtout le première fois)...

Et dans la fenêtre : PlatformIO:

[[Fichier:Platform-io menu.png|sans_cadre|316x316px]]

On clique sur Create new Project.

[[Fichier:Platform-io home-2.png|sans_cadre|778x778px]]

On clique sur "+ New Project"

=== Choisir la "carte". ===
La il faut savoir quelle carte on a et surtout quelle est son interface.

Si on branche la carte sur le PI et que l'on examine dmesg.<syntaxhighlight lang="text">[ 6757.122196] usb 1-1.1: new full-speed USB device number 10 using xhci_hcd
[ 6757.217480] usb 1-1.1: New USB device found, idVendor=303a, idProduct=1001, bcdDevice= 1.01
[ 6757.217498] usb 1-1.1: New USB device strings: Mfr=1, Product=2, SerialNumber=3
[ 6757.217503] usb 1-1.1: Product: USB JTAG/serial debug unit
[ 6757.217508] usb 1-1.1: Manufacturer: Espressif
[ 6757.217512] usb 1-1.1: SerialNumber: AC:A7:04:83:55:70
[ 6757.226869] cdc_acm 1-1.1:1.0: ttyACM0: USB ACM device</syntaxhighlight>Ici j'ai une interface en ttyACM0. J'aurais pu avoir :<syntaxhighlight lang="text">[ 6757.226869] usb 1-1.3: ch341-uart converter now attached to ttyUSB0</syntaxhighlight>On choisit la carte en fonction de ça :
{| class="wikitable"
|+Type de carte
!dmesg
!carte
|-
|<code>cdc_acm 1-1.1:1.0: ttyACM0: USB ACM device</code>
|<code>esp32-c3-devkitc-02</code>
|-
|<code>usb 1-1.3: ch341-uart converter now attached to ttyUSB0</code>
|<code>esp32-c3-devkitm-1</code>
|-
|Doit y en avoir d'autres
|...
|}
Donc pour moi :

[[Fichier:Visualstudiocode-platformio-board.png|sans_cadre|593x593px]]

Dans un premier temps le framework Arduino c'est plus simple.

On clique sur Finish et on attends...
{| class="wikitable"
|+Attention
|[[Fichier:Attention.png|sans_cadre|44x44px]]
|Cette partie doit se faire ''connecté à internet'' la première fois puisque, comme vu plus haut, c'est là que l'on va chercher les éléments de la ''toolchain'' manquants.
|}
On a successivement les infos suivantes :

[[Fichier:ESP32-rasp-02.png|sans_cadre|300x300px]] [[Fichier:ESP32-rasp-01.png|sans_cadre|296x296px]] [[Fichier:ESP32-rasp-03.png|sans_cadre]] [[Fichier:ESP32-rasp-04.png|sans_cadre|296x296px]]

A la fin (moi ca a pris 15 min mais je suis loin du Point D'acces Wifi) on a un beau projet :

[[Fichier:Default-esp32-project.png|sans_cadre]]

Le code de "main.cpp" est par défaut :<syntaxhighlight lang="c">
#include <Arduino.h>

// put function declarations here:
int myFunction(int, int);

void setup() {
// put your setup code here, to run once:
int result = myFunction(2, 3);
}

void loop() {
// put your main code here, to run repeatedly:
}

// put function definitions here:
int myFunction(int x, int y) {
return x + y;
}
</syntaxhighlight>

== Connectivité USB ==
En fonction de la carte (voir ci dessus) on a un "device" que le système crée au branchement :<syntaxhighlight lang="text">
crw-rw----+ 1 root plugdev 166, 0 22 mars 18:49 /dev/ttyACM0 # C'est mou cas
crw-rw----+ 1 root dialout 166, 0 22 mars 18:49 /dev/ttyUSB01 # Ca pourait être ça
</syntaxhighlight>Il faut vérifier que l'utilisateur que vous utilisez pour le dev soit bien membre du groupe (<code>plugdev</code> ou <code>dialout</code>) <syntaxhighlight lang="text">
uid=.... gid=.... groupes=20(dialout),24(cdrom),29(audio),44(video),46(plugdev),60(games),100(users),102(netdev),986(gpio),992(render),996(input)

</syntaxhighlight>Moi je suis bien : <code>plugdev</code> donc ça va marcher sinon un petit :<syntaxhighlight lang="bash">
sudo usermod -aG dialout $USER
sudo usermod -aG plugdev $USER
</syntaxhighlight>et ça marche!

== Compiler et flasher ==
On arrive au cœur du sujet!

Moi j'ai du modifier platformio.ini:<syntaxhighlight lang="ini">
; PlatformIO Project Configuration File
;
; Build options: build flags, source filter
; Upload options: custom upload port, speed and extra flags
; Library options: dependencies, extra library storages
; Advanced options: extra scripting
;
; Please visit documentation for the other options and examples
; https://docs.platformio.org/page/projectconf.html

[env:esp32-c3-devkitc-02]
platform = espressif32
board = esp32-c3-devkitc-02
framework = arduino
upload_protocol = esptool
upload_port = /dev/ttyACM0
monitor_port = /dev/ttyACM0
monitor_speed = 115200
debug_tool = custom
debug_server =

</syntaxhighlight>On sauvegarde et ensuite, sur la petite barre du bas:

[[Fichier:Visualstudio-lower-bar.png|sans_cadre|709x709px]]

On clique sur la coche pour compiler: Ce doit se terminer par un beau SUCCESS en vert.

On clique ensuite sur le flèche (entre la coche et la poubelle) : On voit les logs de esptool :<syntaxhighlight lang="text">
Compressed 228800 bytes to 128556...
Writing at 0x00010000... (12 %)
Writing at 0x0001aa3d... (25 %)
Writing at 0x0002180e... (37 %)
Writing at 0x00027993... (50 %)
Writing at 0x0002df5c... (62 %)
Writing at 0x00033c3b... (75 %)
Writing at 0x0003b93d... (87 %)
Writing at 0x00042705... (100 %)
Wrote 228800 bytes (128556 compressed) at 0x00010000 in 0.8 seconds (effective 2163.5 kbit/s)...
Hash of data verified.
</syntaxhighlight>Et aussi un beau SUCCESS en vert.

C'est fait on a flashé avec un beau programme... qui fait rien.

== Exemple ==
Avec la carte avec [[ESP32C3 avec écran spotear|écran et ESP32-C3]] j'ai testé:<syntaxhighlight lang="c">
#include <Arduino.h>

// put function declarations here:
int myFunction(int, int);

void setup() {
// put your setup code here, to run once:
pinMode(11,OUTPUT);
}

void loop() {
// put your main code here, to run repeatedly:
digitalWrite(11,true);
delay (1000);
digitalWrite(11,false);
delay (1000);
}
</syntaxhighlight>Ca marche bien j'ai la led à droit de la prise USB qui clignotte.

Poste de DEV ESP32 sur PI

2026-03-22T18:32:28Z

Jpinon :

Poste de DEV ESP32 sur PI

2026-03-22T18:26:03Z

Jpinon : version 1

ttyACM0: USB ACM deviceUne fois n'est pas coutume je vais utiliser un Raspberry PI en mode graphique. Un bel écran HDMI branché sur HDMI N°1.

Une installation simple avec toutes les valeurs de bases et seulement un ou deux delta:

* [[PackageKit|Suppression de l'outil graphique PackageKit]] qui empèche les sudo apt install normeaux.
* Mettre a jour avec
<syntaxhighlight lang="bash">
sudo apt update
sudo apt upgrade
sudo apt full-upgrade
sudo apt install gnome-screenshot #C'est pas necessaire mais pour enrichier ce wiki je mets ca sur tous mes postes de dev

</syntaxhighlight>
* Passer Chromium en français pour pouvoir éditer ce site tranquilement.

== Préparer le Raspberry Pi ==
Normalement c'est inutile sur une installation par défaut mais au cas ou...<syntaxhighlight lang="bash">sudo apt install python3 python3-pip python3-venv git build-essential</syntaxhighlight>

== Installer Visual Studio Code (version ARM64/ARMHF) ==
Visual studio code n'est pas dans les repo par défaut. Il fout faire toute le sequence suivante:<syntaxhighlight lang="bash">sudo apt install wget gpg # Pour moi sur une insall par défaut ça n'a rien fait
# On télécharge la clé gpg de microsoft
wget -qO- https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > microsoft.gpg
# On installe cette clé
sudo install -o root -g root -m 644 microsoft.gpg /usr/share/keyrings/
# On ajoute une source pour apt
sudo sh -c 'echo "deb [arch=arm64 signed-by=/usr/share/keyrings/microsoft.gpg] https://packages.microsoft.com/repos/code stable main" > /etc/apt/sources.list.d/vscode.list'
# On synchronise
sudo apt update
# On installe (c'est que ca fait le boulot)
sudo apt install code</syntaxhighlight>

== Installer PlatformIO dans VS Code ==
On ouvre Visual Studio Code sagement avec le menu "Framboise | Programmation | Visual Studio Code".

[[Fichier:Visualstudiocode.png|sans_cadre|600x600px]]

Aller dans "extension" : Icone [[Fichier:Visualstudiocode-extensions.png|sans_cadre|25x25px]]

On recherche platformIO

[[Fichier:Visualstudiocode-platformio.png|sans_cadre]]

Et on installe. (Si ça demande si on y crois "Trust" on dit oui)

Ça prend quelques minutes et ça affiche la page de garde PlatformIO.

[[Fichier:Platform-io home.png|sans_cadre|871x871px]]

== Installer les toolchains ESP32 (automatique) ==
Il n'y a rien a installer en tant que tel. Ça se fait à la création du projet. On passe donc à la suite.

== Créer un projet ESP32 avec PlatformIO ==
On clique sur l'icône Platform IO dans la barre d'icône de gauche: [[Fichier:Platform-io icon.png|sans_cadre|28x28px]]

On attends un moment (surtout le première fois)...

Et dans la fenêtre : PlatformIO:

[[Fichier:Platform-io menu.png|sans_cadre|316x316px]]

On clique sur Create new Project.

[[Fichier:Platform-io home-2.png|sans_cadre|778x778px]]

On clique sur "+ New Project"

=== Choisir la "carte". ===
La il faut savoir quelle carte on a et surtout quelle est son interface.

Si on branche la carte sur le PI et que l'on examine dmesg.<syntaxhighlight lang="text">[ 6757.122196] usb 1-1.1: new full-speed USB device number 10 using xhci_hcd
[ 6757.217480] usb 1-1.1: New USB device found, idVendor=303a, idProduct=1001, bcdDevice= 1.01
[ 6757.217498] usb 1-1.1: New USB device strings: Mfr=1, Product=2, SerialNumber=3
[ 6757.217503] usb 1-1.1: Product: USB JTAG/serial debug unit
[ 6757.217508] usb 1-1.1: Manufacturer: Espressif
[ 6757.217512] usb 1-1.1: SerialNumber: AC:A7:04:83:55:70
[ 6757.226869] cdc_acm 1-1.1:1.0: ttyACM0: USB ACM device</syntaxhighlight>Ici j'ai une interface en ttyACM0. J'aurais pu avoir :<syntaxhighlight lang="text">[ 6757.226869] usb 1-1.3: ch341-uart converter now attached to ttyUSB0</syntaxhighlight>On choisit la carte en fonction de ça :
{| class="wikitable"
|+Type de carte
!dmesg
!carte
|-
|<code>cdc_acm 1-1.1:1.0: ttyACM0: USB ACM device</code>
|<code>esp32-c3-devkitc-02</code>
|-
|<code>usb 1-1.3: ch341-uart converter now attached to ttyUSB0</code>
|<code>esp32-c3-devkitm-1</code>
|-
|Doit y en avoir d'autres
|...
|}
Donc pour moi :

[[Fichier:Visualstudiocode-platformio-board.png|sans_cadre|593x593px]]

Dans un premier temps le framework Arduino c'est plus simple.

On clique sur Finish et on attends...
{| class="wikitable"
|+Attention
|[[Fichier:Attention.png|sans_cadre|44x44px]]
|Cette partie doit se faire ''connecté à internet'' la première fois puisque, comme vu plus haut, c'est là que l'on va chercher les éléments de la ''toolchain'' manquants.
|}
On a successivement les infos suivantes :

[[Fichier:ESP32-rasp-02.png|sans_cadre|300x300px]] [[Fichier:ESP32-rasp-01.png|sans_cadre|296x296px]] [[Fichier:ESP32-rasp-03.png|sans_cadre]] [[Fichier:ESP32-rasp-04.png|sans_cadre|296x296px]]

A la fin (moi ca a pris 15 min mais je suis loin du Point D'acces Wifi) on a un beau projet :

[[Fichier:Default-esp32-project.png|sans_cadre]]

Le code de "main.cpp" est par défaut :<syntaxhighlight lang="c">
#include <Arduino.h>

// put function declarations here:
int myFunction(int, int);

void setup() {
// put your setup code here, to run once:
int result = myFunction(2, 3);
}

void loop() {
// put your main code here, to run repeatedly:
}

// put function definitions here:
int myFunction(int x, int y) {
return x + y;
}
</syntaxhighlight>

== Connectivité USB ==
En fonction de la carte (voir ci dessus) on a un "device" que le système crée au branchement :<syntaxhighlight lang="text">
crw-rw----+ 1 root plugdev 166, 0 22 mars 18:49 /dev/ttyACM0 # C'est mou cas
crw-rw----+ 1 root dialout 166, 0 22 mars 18:49 /dev/ttyUSB01 # Ca pourait être ça
</syntaxhighlight>Il faut vérifier que l'utilisateur que vous utilisez pour le dev soit bien membre du groupe (<code>plugdev</code> ou <code>dialout</code>) <syntaxhighlight lang="text">
uid=.... gid=.... groupes=20(dialout),24(cdrom),29(audio),44(video),46(plugdev),60(games),100(users),102(netdev),986(gpio),992(render),996(input)

</syntaxhighlight>Moi je suis bien : <code>plugdev</code> donc ça va marcher sinon un petit :<syntaxhighlight lang="bash">
sudo usermod -aG dialout $USER
sudo usermod -aG plugdev $USER
</syntaxhighlight>et ça marche!

== Compiler et flasher ==
On arrive au cœur du sujet!

Moi j'ai du modifier platformio.ini:<syntaxhighlight lang="ini">
; PlatformIO Project Configuration File
;
; Build options: build flags, source filter
; Upload options: custom upload port, speed and extra flags
; Library options: dependencies, extra library storages
; Advanced options: extra scripting
;
; Please visit documentation for the other options and examples
; https://docs.platformio.org/page/projectconf.html

[env:esp32-c3-devkitc-02]
platform = espressif32
board = esp32-c3-devkitc-02
framework = arduino
upload_protocol = esptool
upload_port = /dev/ttyACM0
monitor_port = /dev/ttyACM0
monitor_speed = 115200
debug_tool = custom
debug_server =

</syntaxhighlight>On sauvegarde et ensuite, sur la petite barre du bas:

[[Fichier:Visualstudio-lower-bar.png|sans_cadre|709x709px]]

On clique sur la coche pour compiler: Ce doit se terminer par un beau SUCCESS en vert.

On clique ensuite sur le flèche (entre la coche et la poubelle) : On voit les logs de esptool :<syntaxhighlight lang="text">
Compressed 228800 bytes to 128556...
Writing at 0x00010000... (12 %)
Writing at 0x0001aa3d... (25 %)
Writing at 0x0002180e... (37 %)
Writing at 0x00027993... (50 %)
Writing at 0x0002df5c... (62 %)
Writing at 0x00033c3b... (75 %)
Writing at 0x0003b93d... (87 %)
Writing at 0x00042705... (100 %)
Wrote 228800 bytes (128556 compressed) at 0x00010000 in 0.8 seconds (effective 2163.5 kbit/s)...
Hash of data verified.
</syntaxhighlight>Et aussi un beau SUCCESS en vert.

C'est fait on a flashé avec un beau programme... qui fait rien.

Fichier:Visualstudio-lower-bar.png

2026-03-22T18:22:45Z

Jpinon :

bare du bas

Fichier:Default-esp32-project.png

2026-03-22T17:50:23Z

Jpinon :

projet

Fichier:ESP32-rasp-04.png

2026-03-22T17:44:31Z

Jpinon :

Fichier:ESP32-rasp-03.png

2026-03-22T17:43:30Z

Jpinon :

Fichier:ESP32-rasp-02.png

2026-03-22T17:42:44Z

Jpinon :

Fichier:ESP32-rasp-01.png

2026-03-22T17:40:18Z

Jpinon :

Poste de DEV ESP32 sur PI

2026-03-22T17:37:48Z

Jpinon :

Poste de DEV ESP32 sur PI

2026-03-22T17:25:22Z

Jpinon :

Fichier:Visualstudiocode-platformio-board.png

2026-03-22T17:17:02Z

Jpinon :

selection carte

Fichier:Platform-io home-2.png

2026-03-22T16:57:03Z

Jpinon :

project home