Installation de UCUq#

Le dépôt auquel il est fait référence dans cette page est celui situé à l’adresse https://github.com/epeios-q37/ucuq-python.

Sur le microcontrôleur#

À titre d’exemple, UCUq est installé sur la simulation Wokwi du kit Ravel, dont le lien est sur la section des démonstrations en ligne.

1. Installer MicroPython sur le microcontrôleur ;
2. placer les fichiers main.py, ucuq.py et settings.py, situés dans le répertoire device du dépôt, sur le microcontrôleur ;
3. créer sur le microcontrôleur un fichier ucuq.json avec le contenu ci-dessous ;
4. redémarrer le microcontrôleur.

Contenu du fichier ucuq.json à placer sur le microcontrôleur :

{
  "Identification": ["<device_token>","<device_id>"],
  "WLAN": {
    "<wlan_name>": ["<wlan_ssid>", "<wlan_key>"]
  },
  "OnBoardLed": [<led_pin>, <led_logic>],
  "version": {
    "format": "2025-09-19"
  }
}

• <device_token> : token de l’appareil ; choisissez-en un qui ne puisse pas être deviné facilement ; un même token peut être partagé entre plusieurs appareils ;
• <device_id> : identifiant de l’appareil, qui doit être unique parmi les appareils partageant le même token ;
• <wlan_name> : nom du réseau Wi-Fi (valeur de votre choix) ;
• <wlan_ssid> : SSID du réseau Wi-Fi ;
• <wlan_key> : clé secrète du réseau Wi-Fi ;
• <led_pin> : broche de la LED intégrée au microcontrôleur (généralement un nombre entier, mais peut être une chaîne de caractères, comme c’est la ces avec le RPI Pico (2) W);
• <led_logic> : true si la LED s’allume lorsque le niveau de la broche est haut, false dans le cas contraire.

L’entrée OnBoardLed est facultative.

Il est possible de placer plusieurs entrées sous l’entrée WLAN ; le microcontrôleur se connectera automatiquement au premier réseau disponible. Par exemple, l’un peut correspondre au point d’accès du smartphone, le second au Wi-Fi du domicile.

Sur l’ordinateur#

1. Récupérer le dépôt ;
2. lancer l’application Config (python3 Config/ depuis le dossier demos) ;
3. remplir les champs en fonction du contenu du fichier ucuq.json mentionné ci-dessus (Identification/device_token et Identification/device_id) ;
4. cliquer sur Save et quitter l’application.

À titre d’exemple, le code suivant fait clignoter une LED connectée à votre microcontrôleur :

import ucuq

for i in range(20):
  ucuq.GPIO(<led_pin>).high(i & 1)
  ucuq.sleep(0.5)

Remplacer <led_pin> par le numéro (ou la chaîne de caractères correspondante) de la broche de la LED embarquée (ou celle d’une quelconque LED connectée à votre microcontrôleur). Lancer ce programme avec python3.

L’API est détaillée ici.