Microsoft MakeCode pour Adafruit est un éditeur de code de base accessible en ligne. Il est composé d'un éditeur de blocs qui ressemble à Scratch ou Code.org. MakeCode a aussi une version en JavaScript pour les utilisateurs plus avancés.  Essayez-le maintenant au:  https://makecode.adafruit.com/ !

Certaines des charactéristiques de MakeCode sont:

• éditeur de code en ligne: ne requiert aucune installation.
• multi-plateforme: fonctionne avec la plupart des navigateurs actuels aussi bien sur un petit cellulaire que sur un écran géant.
• compile dans le navigateur: le compilateur fonctionne à même votre navigateur, il est rapide et peut fonctionner sans être en ligne. 
• blocs + JavaScript: déplacez et déposez les blocs ou  codez en JavaScript , MakeCode permet de passer de l'un à l'autre facilement.
• travailler sans être en ligne: une fois que vous avez accédé à l'éditeur, il reste caché dans votre navigateur.
• événement basé sur une action: il réagit aux boutons actionnés, aux mouvements effectués et plus encore.

MakeCode supporte présentement Adafruit Circuit Playground Express. Pour les autres cartes informatiques de base, comme l'Adafruit Metro M0, essayez https://maker.makecode.com .

Parts

L'éditeur des blocs est la façon la plus facile pour commencer avec MakeCode.  Vous pouvez sélectionner à partir d'une liste de catégories les blocs. Ensuite vous n'avez qu'à les glisser ou les déposer dans votre espace de programmation . Chaque fois que vous faites un changement aux blocs, le simulateur partira automatiquement et démarrera votre code. Vous pouvez tester vos programmes à même le navigateur! 

• essayez notre tutoriel par où commencer, celui-ci vous montrera comment faire un programme qui produira le son et les effets lumineux d'une sirène de police. 
• essayez un de nos projets pour découvrir les nombreuses composantes du Circuit Playground. 
• notre façon préférée d'apprendre consiste à regarder les capsules MakeCode Live avec John Park. Vous pouvez faire ceci ou bien en regardant la liste des vidéos enregistrées, ou en regardant en directe les mardis à 15h00 (heure de l'est) sur le canal d'Adafruit sur Youtube
• consulter abondament la documentation.

Voulez-vous sélectionner ou changer de couleurs? Le bloc (''show ring'') vous permets de sélectionner la couleur désiré dans la palette de couleurs, vous n'avez qu'à cliquer sur chacune des dix NéoPixels. 

Comment désactiver les NéoPixels?  Le gris qui se trouve au milieu dans la palette de couleur représente les NéoPixels désactivés. Sélectionnez le gris dans la palette de couleurs et ensuite cliquez sur les dix NéoPixels.

Vous pouvez voir le programme Blinky en action dans l'éditeur MakeCode ci-dessous. Vous pouvez aussi observer comment faire pour que les blocs soient imbrigués l'un dans l'autre. En cliquant sur le point d'interrogation sur la boîte, une bulle d'information apparaît qui indique ce que le bloc fera.

Dans la prochaine section, nous allons télécharger le code de Blinky sur le Circuit Playground Express! 

Quand le Circuit Playground Express passe au mode bootloader, toutes les LEDs deviendront brièvement rouges pour ensuite devenir toutes vertes. Assurez-vous que toutes les LEDs clignotent en rouges avant de passer aux verts. Sur votre ordinateur vous devriez voir apparaître une nouvelle partition amovible qui se nomme: "CPLAYBOOT".

 Si les LEDs restent toutes rouges, il y a deux explications possibles: votre ordinateur complète les mises à jour (si c'est le cas, svp. attendez une minute, Windows prends parfois du temps pour installer les mise-à-jours) ou vous avez un mauvais branchement USB.  Si vous continuez d'avoir des LEDs rouges - essayez un nouveau cable USB (assurez-vous que votre câble  USB n'est pas seulement unidirectionel (charge seulement), vous devez être capable aussi de transférer le data (bi-directionelle, ou bien essayez un port USB différent.

Quand les LEDs sont toutes vertes, vous devriez voir CPLAYBOOT apparaître dans votre liste de partitions dans votre explorer.

Nous sommes maintenant prêt à compiler notre code blinky et à le télécharger sur notre carte!

Commençons par vérifier si notre code compile bien dans MakeCode.

Il y a un similateur à l'intérieur de MakeCode qui charge et fait fonctionner votre code automatiquement quand il recommence. Ceci est une façon facile pour s'assurer que notre code compile et l'imite avant de le mettre sur la carte. Le bouton recharge le similateur avec la dernière version du code. 

Si votre code fonctionne dans le similateur, il est maintenant temps de le télécharger sur le vrai! Cliquez le bouton "Download"(télécharger). Il y aura un fichier .uf2 qui sera généré et téléchargez-le dans votre ordinateur (le fichier UF2 est un format de fichier dédié pour les microcontrolleurs qui peut se télécharger à l'aide d'un branchement à un port USB).

Faites les étapes mentionner ci-dessous pour copier votre programme (fonctionne peu importe le système d'exploitation utilisé).

1.  Assurez-vous que votre carte est en mode ''bootloader''
2. Trouvez le fichier .uf2 généré par MakeCode dans votre système d'exploitation (par défaut ''téléchargement''). Copiez-le sur le volume "CPLAYBOOT".
3. Le LED du status sur la carte clignotera pendant que le fichier est transféré sur celle-ci.  Quand le transfère sera complété, la carte effectuera une réinitialisation automatique et votre programme sera enclenché, comme vous avez vue sur le similateur!

Windows: ouvrir l'explorateur Window Explorer (touches: Windows + E ) et localiser le fichier "blinky.uf2" qui a été généré. Il est probablement dans votre dossier Téléchargement (Downloads)!

Vous pouvez copier/coller le fichier dans le volume CPLAYBOOT ou bien le glisser/poser comme démontré dans le fichier GIF ci-dessous.

macOS: Ouvrez le (''Finder'') et localisez le fichier "blinky.uf2". Vous pouvez copier/coller le fichier dans le volume CPLAYBOOT ou bien le glisser dans celui-ci.

Si vous voulez éviter cette façon de copier: Vous pouvez télécharger (''download'') votre code directement sur votre carte. Pour faire ceci: changez l'endroit ou vous le téléchargerez dans  Chrome, Firefox, Safari ou Opera dans le dossier principal sur votre volume "CPLAYBOOT".

Exécuter MakeCode qui est déjà téléchargé.

Si vous débranchez votre carte pour ensuite la rebranchée à votre ordinateur, il est probable que dans ce cas le programme ne s'exécutera pas automatiquement.  Si tout les NéoPixels sont verts, vous n'avez qu'à presser le bouton (''reset'') et votre programme s'enclenchera. 

Vous voulez changer le programme ** Blinky pour afficher des couleurs différentes, ou faire jouer du son? Éditez le programme sur votre Circuit Playground est très facile! 

Extraire votre code de votre Circuit Playground

Le fichier .uf2  (CURRENT.UF2) que vous avez crée en cliquant sur le button du compilateur dans MakeCode contient aussi le code source de votre programme!

Vous pouvez ouvrir ce fichier dans MakeCode en le déplaçant et en le relâchant à l'intérieur d'un navigateur pour l'éditer. 

Vous pouvez aussi passer de la programmation en blocs  à la  programmation en JavaScript en cliquant sur le bouton situé dans le haut.

Téléchargement en un clic

Vous en avez assez de faire glisser et de déposer vos fichiers UF2 encore et encore? Alors le téléchargement WebUSB est pour vous! Avec WebUSB, vous pouvez télécharger votre code directement sans avoir à enregistrer un fichier UF2 pour ensuite le déposer sur la clé USB. Il suffit de brancher le câble USB sur votre ordinateur et de télécharger le code autant de fois que vous le souhaitez!

Éléments nécessaires!

Vous aller avoir besoin de quelques éléments avant de pouvoir utiliser le WebUSB.

• Vous allez devoir utiliser la dernière version du navigateur lnternet Google Chrome. Firefox, Safari, Opera, Edge, etc ne supporte pas le WebUSB pour le moment.
• Seulement les versions à partir de Chrome 68 et plus supporte le WebUSB.
• Utilisez un des systèmes d’exploitations suivants: Window 10, Mac OS X ou Linux. Windows 7 et 8 ne sont pas supportés!

Mise à jour du « bootloader ».

Vous allez devoir aussi mettre à jour votre Circuit Playground Express (cette étape ne doit être exécuté qu'une seule fois) en téléchargeant le dernier « bootloader » pour le Circuit Playground Express. Depuis juillet 2018, nous installons toujours le plus récent « bootloader » sur les Circuit Playground Express mais au cas que le vôtre soit une version moins récente, il est toujours mieux de vérifier et d'installer le tout dernier « bootloader »!

Faire une mise à jour du « bootloader » est aussi facile que de "flasher" un programme MakeCode. Simplement pressez le bouton "reset" situé sur la carte une fois (ou deux fois) pour que toutes les néopixels deviennent vertes. Le volume CPLAYBOOT apparaîtra dans votre système d'exploitation. Glisser la version récente du fichier « bootloader uf2 » que vous avez téléchargé en pressant le bouton "reset" dans le volume CPLAYBOOT. Ce fichier uf2 contient le programme qui permettra l'accès au « bootloader » déjà sur la carte, ensuite ce dernier sera remplacé par la version que vous avez téléchargé précédemment et finalement l'accès au nouveau « bootloader » sera bloqué. Ceci effaçera tout le code présent sur la carte, que ce soit CircuitPython ou Arduino, alors assurez-vous de sauvegarder les programmes que vous voulez garder avant d'effectuer la mise à jour!

L'URL spécial de MakeCode avec WebUSB

Dès que vous avez mise à jour votre carte, vous allez devoir vous rendre sur l'URL spécial de MakeCode avec WebUSB. Utilisez le bouton vert ou effectué un copier/coller de l'adresse URL complète ci-dessous pour la mettre dans votre navigateur: https://makecode.adafruit.com/?webusb=1#editor

Projets & extensions

Tout vos programmes déjà sauvegardés devraient apparaître sur le site de MakeCode donc vous n’avez pas à copier aucun des programmes fait avant.  Toutefois, si vous aviez installé des extensions, vous devrez les installées de nouveau. Ceci peut être fait en sélectionnant la bonne extensions dans le menu «extensions».

L’étape mentionnée ci-dessus est requise pour avoir accès aux fonctionnalités de WebUSB sur Google Chrome. Vous n’avez qu’à la faire qu’une seule fois! Si vous avez bien fait la copie du fichier UF2 en le glissant et déposant manuellement sur la carte sur le volume «CPLAYBOOT» cette étape ne devrait plus être requise.