Skip to content

📝 Blog

TinyGo - Show time !

Après les deux premiers articles, vous êtes maintenant capables de manipuler l'écran et la led arrière de la Pygamer.

Mais est ce que ce ne serait pas mieux de pouvoir faire un petit show lumineux avec les 5 Neopixels en façade ?
Voyons voir ce que l'on peut faire.

Comme d'habitude, je vous donne le code tout de suite pour le commenter ensuite.

package main

import (
    "image/color"
    "machine"
    "time"

    "tinygo.org/x/drivers/ws2812"
)

var (
    black = color.RGBA{R: 0, G: 0, B: 0}
    red   = color.RGBA{R: 255, G: 0, B: 0}
    green = color.RGBA{R: 0, G: 255, B: 0}
    blue  = color.RGBA{R: 0, G: 0, B: 255}
)

func main() {
    // color intensity does not seems to work but you got the idea ;)
    reds := make([]color.RGBA, 5)
    reds[0] = color.RGBA{R: 50, G: 0, B: 0}
    reds[1] = color.RGBA{R: 100, G: 0, B: 0}
    reds[2] = color.RGBA{R: 150, G: 0, B: 0}
    reds[3] = color.RGBA{R: 200, G: 0, B: 0}
    reds[4] = color.RGBA{R: 255, G: 0, B: 0}

    colors := make([]color.RGBA, 5)

    neopixels := ws2812.New(machine.NEOPIXELS)
    neopixels.Pin.Configure(machine.PinConfig{Mode: machine.PinOutput})

    for {
        for i := range [5]int{0, 1, 2, 3, 4} {
            clear(colors)
            colors[i] = reds[i]
            neopixels.WriteColors(colors)
            time.Sleep(time.Millisecond * 500)
        }
    }
}

func clear(colors []color.RGBA) {
    colors[0] = black
    colors[1] = black
    colors[2] = black
    colors[3] = black
    colors[4] = black
}

Pour manipuler les Neopixels, nous allons utiliser le driver tinygo.org/x/drivers/ws2812 que vous voyez dans les imports.

neopixels := ws2812.New(machine.NEOPIXELS)
neopixels.Pin.Configure(machine.PinConfig{Mode: machine.PinOutput})

De manière assez similaire à la Led, nous déclarons ensuite un objet pour nos Neopixels et nous configurons la broche correspondante.
Une fois de plus, le module machine nous fournit la référence qu'il nous faut.

Pour manipuler les Neopixels, nous utiliserons ici la fonction WriteColors. Cette fonction a besoin d'un paramètre qui sera un tableau avec chaque couleur de chaque Led.
Ce tableau est créé sur la ligne :

colors := make([]color.RGBA, 5)

Le tableau contiendra donc 5 couleurs RGBA, une pour chaque Neopixel de la Pygamer.

for i := range [5]int{0, 1, 2, 3, 4} {
    clear(colors)
    colors[i] = reds[i]
    neopixels.WriteColors(colors)
    time.Sleep(time.Millisecond * 500)
}

Cette boucle est alors en charge de s'assurer que chaque Neopixel est éteinte, puis on affecte la couleur rouge à une Neopixel à la fois, la boucle passant de l'une à l'autre.
Je laisse volontairement mon code ainsi, il n'est pas tout à fait complet par rapport à ce que je visais. Je cherchais à reproduire un effet "K2000" ou "Cylon" mais je me suis aperçu que l'intensité ne semblait pas être prise en charge par le driver actuel.
Cela fera l'objet d'un prochain article et d'une mise à jour du code si je parviens à résoudre ce point.

Voilà, il ne vous reste plus qu'à flasher la Pygamer :

tinygo flash -target=pygamer

Profitez du spectacle !

Sorry, your browser doesn't support embedded videos.

Bien entendu, cet exemple est disponible dans le repository dédié aux exemples TinyGo.

Merci, n'hésitez pas à me faire parvenir vos remarques par email ou par le biais d'issues sur le repository.

TinyGo - Allumons l'écran de la Pygamer

Maintenant que nous avons vu comment mettre en place un environnement qui permet de coder avec TinyGo pour la Pygamer, voyons ce que l'on peut faire de l'écran de cette console.

Vous l'avez peut être vu dans la documentation d'installation, mais il existe des modules rapidement essentiels au développement avec Tinygo.
Ces modules contiennent le code nécessaire pour piloter les différents aspects matériels des différentes plateformes.

Le projet TinyGo Drivers rassemble les principaux drivers dont vous aurez besoin.
Vous pouvez installer tout le nécessaire en suivant les informations du Readme, le tout se résumant à une commande :

go get tinygo.org/x/drivers

Pour manipuler l'écran de la Pygamer, la documentation TinyGo nous indique qu'il faut utiliser le driver pour le composant ST7735.
C'est ce que nous allons faire et sans plus attendre, le code du jour :

package main

import (
    "image/color"
    "machine"
    "time"

    "tinygo.org/x/drivers/st7735"
)

var red = color.RGBA{255, 0, 0, 255}
var green = color.RGBA{0, 255, 0, 255}

func main() {
    display := st7735.New(machine.SPI1, machine.TFT_RST, machine.TFT_DC, machine.TFT_CS, machine.TFT_LITE)
    machine.SPI1.Configure(machine.SPIConfig{
        Frequency: 16000000,
        SCK:       machine.SPI1_SCK_PIN,
        SDO:       machine.SPI1_SDO_PIN,
        SDI:       machine.SPI1_SDI_PIN,
    })
    display.Configure(st7735.Config{})

    i := 0
    for {
        display.FillScreen(green)
        time.Sleep(1 * time.Second)
        display.FillScreen(red)
        time.Sleep(1 * time.Second)
        i++
    }
}

Eliminons tout d'abord les lignes de codes qui sont nécessaires mais qui ne vous poseront pas de souci une fois copiées.
Le module est ajouté dans les import :

"tinygo.org/x/drivers/st7735"

Vous aurez alors à disposition tous les outils prévus par ce module pour allumer, contrôler des pixels...
Il suffit d'instancier un objet pour manipuler l'écran :

display := st7735.New(machine.SPI1, machine.TFT_RST, machine.TFT_DC, machine.TFT_CS, machine.TFT_LITE)
machine.SPI1.Configure(machine.SPIConfig{
        Frequency: 16000000,
        SCK:       machine.SPI1_SCK_PIN,
        SDO:       machine.SPI1_SDO_PIN,
        SDI:       machine.SPI1_SDI_PIN,
    })
display.Configure(st7735.Config{})

Les paramètres nécessaires correspondent aux broches impliquées dans le contrôle du composant ST7735.
Ce module peut être utilisé avec n'importe quel micro-contrôleur capable de piloter ce type d'écran, mais dans notre cas, le module machine de la Pygamer fournit des constantes explicites pour cela.
Il reste ensuite à paramétrer correctement le port SPI utilisé.
Là encore, les constantes existantes dans le module machine seront d'une grande aide.
Il faut ensuite s'assurer que l'objet display est bien configuré.

A partir de là, nous allons vérifier que nous avons bien la maîtrise de l'écran de manière simple : nous alternerons entre un écran vert et un écran rouge, toutes les secondes. Cela nous assurera du bon fonctionnement de notre configuration.
La fonction FillScreen permet un remplissage de l'écran basé sur une couleur RGBA.

Il n'y a plus qu'à lancer le flash comme précédemment :

tinygo flash -target=pygamer

Et voilà le résultat !

Sorry, your browser doesn't support embedded videos.

Comme toujours, vous trouverez cet exemple dans le repository TinyGo Examples.

A bientôt pour la suite avec une fois encore plein de lumières colorées ;)

TinyGo - et si on codait une Pygamer

Tout comme je l'avais fait l'année dernière, je suis parti en vacances avec mon iPad mais cette fois avec quelques idées de code autour du language Rust.
J'ai appris pas mal de choses avec ce language mais il me manquait cette petite touche de fun que j'avais ressentie avec Go en 2020.

Et puis sur ma dernière semaine de congés, en changeant de lieu de villégiature, j'ai emporté de quoi essayer à nouveau la version embarquée de Go, connue sous le petit nom de TinyGo.
J'avais pris une série de cartes que j'ai, une micro:bit évidemment, mais également des M4 de Arduino et ma Pygamer.

Très rapidement, j'ai pu faire de chouettes progrès mais qui ont nécessité de fouiller pas mal Internet, Slack et Discord.
L'idée est de vous partager tout ça en une série d'articles, accompagnés d'un repository sur Gitlab.
Je remercie au passage Aurélie Vache qui m'a aidé à garder le focus, parfois sans le savoir, moi qui m'éparpille parfois, grâce à ces petits messages et ses expériences avec la Gameboy. (on en reparlera, promis) et ses articles sur Go.

Mais sans plus attendre, en avant pour le monde de TinyGo.

Je vous conseille de suivre simplement leur Getting Started qui m'a permis d'avoir un environnement fonctionnel autant sur mon Macbook que ma machine Linux.
J'ajouterai que j'ai essentiellement utilisé VSCode qui a de bonnes extensions pour Go qui m'ont suffit, le reste se passant dans le terminal, intégré c'est pratique.

Pour ce qui est de la Pygamer, la documentation de base se trouve dans la section microcontroller du site de TinyGo. Nous y reviendrons dans un prochain article, mais la documentation est très légère, les exemples quasi inexistants.
Comme ce n'est pas la première fois que je m'en fait la remarque, j'ai décidé d'essayer d'apporter ma petite pierre en écrivant cette série d'article, mais surtout en publiant un repository rassemblant des exemples très réduits sur ce qu'ils abordent pour permettre à chacun de se lancer.

Sans plus attendre, lançons nous dans notre premier code, le Hello World des micro contrôleurs, le clignotement d'une led ;)

Le code en lui même est assez simple, mais je vous conseille de prendre un tout petit peu de temps pour avoir les bases minimales du language Go.

package main

import (
    "machine"
    "time"
)

func main() {
    led := machine.LED
    led.Configure(
        machine.PinConfig{Mode: machine.PinOutput} )
    for {
        led.Low()
        time.Sleep(time.Millisecond * 500)

        led.High()
        time.Sleep(time.Millisecond * 500)
    }
}

Je tacherai de conserver des exemples avec le moins de code possible, en me concentrant sur une fonctionnalité à la fois.

Ici, nous ferons appel à machine.LED qui correspond à la broche D13 si l'on lit la documentation du module machine pour la Pygamer.
Nous utiliserons ensuite les fonctions pour alterner l'état de cette broche entre l'état low avec led.Low()) et high avec led.High(). Cela correspondra à une alternance entre 0V et 3,3V sur la broche D13 qui correspond sur la Pygamer à une Led au dos, à côté de la prise USB et clairement indiquée D13.

Il ne restera plus qu'à compiler et flasher ce code sur la Pygamer avec la commande indiquée sur la page de documentation :

tinygo flash -target=pygamer

Je lance cette commande en étant dans le répertoire où se trouve mon code dans un fichier main.go.
La Pygamer va passer par un écran intermédiaire indiquant qu'elle est en mode flashable :

Puis l'écran redevient noir et la Led au dos se met à clignoter. Il s'agit de la Led rouge sur la photo, la Led orange est celle indiquant la charge en cours.

Il est possible que le premier flash ne se passe pas, auquel cas je vous invite à suivre la section troubleshooting de la documentation que je résume ici :

  • double appui sur la touche reset, pas trop vite.
  • la Pygamer apparait comme une clé USB appelée Pygamerboot et l'écran est celui montré plus haut.
  • vous pouvez flasher.

Vous voulà prêt.e.s à embarquer sur le navire TinyGo !
Je met tout le code que j'écris pour ces articles à disposition sur un repository Gitlab. Comme vous le verrez, j'ai d'autres exemples à votre disposition et ils feront l'objet de prochains articles.

[Micro:bit] découverte de la microbit V2 et premier projet

Voici un peu plus de détail sur la nouvelle version de la carte micro:bit qui sortira au mois de novembre.

J'essaie de vous montrer concrètement les changements de cette magnifique carte.

Dans la foulée, un petit projet sonore qui permet de voir l'environnement MakeCode tel qu'il se profile.

Dites moi ce que vous souhaiteriez que je teste d'ici la sortie officielle de la carte.

[AtomFly] test de fonctionnement

Une fois déballé, il faut maintenant se préoccuper de l'installation des outils nécessaires.
Il y a une documentation de quick start sur le site de M5Stack que je vous résume et complète ici.

La première étape est simple, et déjà faite dans mon cas. Il s'agit d'installer l'IDE Arduino.

Il faut ensuite ajouter l'url de Board Manager suivante dans les préférences: https://dl.espressif.com/dl/package_esp32_index.json

Du coup, il est alors possible d'installer le support ESP32 proprement dit depuis le Board Manager.

Puis, il faut ajouter les librairies pour la gestion de l'Atom Lite, de la led et des capteurs : M5Atom, FastLED, Adafruit_BMP280, Adafruit VL53L0X.

La dernière étape consiste à aller récupérer le code de test sur le github de M5Stack.

Petite précision : le fichier de projet Arduino est le fichier AtomFLY.ino et il doit se trouver dans un répertoire AtomFLY. Laissez dans ce répertoire les 2 autres fichiers .cpp et .h

Lorsque vous ouvrez le projet AtomFLY, vous pouvez déjà tester votre installation logicielle en utilisant la compilation (bouton Verify).
Choisissez la carte M5Stick-C dans la catégorie ESP32.

Vous apercevez quelques messages au sujet de pragma dans la librairie FastLed.
Ca n'empêche pas le programme de fonctionner et c'est confirmé sur le forum

Raccordez votre Atom Fly en USB et uploadez le code.
En prenant soin de vos doigts, débranchez l'USB C, puis branchez la batterie.
Vous pouvez alors appuyer sur le bouton une fois en retirant rapidement votre doigt : le premier moteur tourne puis s'arrête.
La même manipulation fait tourner chaque moteur, puis les 4 ensemble.

Il est également possible de faire tourner le programme juste avec l'USB C, les moteurs ne tourneront pas mais la console série vous affihera les informations de l'accéléromètre.

Tout cela est visible en détails dans une petit vidéo que je vous ait préparé.

Je souhaite une bonne expérimentation et je vous dis à bientôt pour d'autres articles et vidéos où je vous montrerai ce que je code.