FEATHER-M0-ArduinoIDE-Croquis

Introduction

L'ATSAMD21 est un tout petit composant mais encore assez récent comme nouveau venu dans le monde des Arduino-compatible. La plupart des croquis et bibliothèques fonctionnerons mais il y a quelques petites choses à noter!

Les notes ci-dessous concerne toutes les cartes M0 mais il n'est pas nécessaire de toutes les appliquer (ex: Trinket M0 et Gemma M0 n'ont pas de broche ARef, vous pouvez donc sauter les notes concernant la Référence Analogique!)

Référence Analogique

Si vous désirez utiliser la broche ARef pour une référence analogique différente de 3.3V, le code à utiliser est analogReference(AR_EXTERNAL) (avec un AR_EXTERNAL et non EXTERNAL)

Broches et pull-up

L'ancienne façon d'activer une broche en entrée avec un avec résistance pullup etait:

pinMode(pin, INPUT)
digitalWrite(pin, HIGH)

Parce que le registre de selection-pullup (pullup-selection) est le même que le registre de sélection-des-sortie (output-selection).

Vous ne pouvez plus utiliser cette approche avec le M0! Il faut utiliser:

pinMode(pin, INPUT_PULLUP)

Approche qui à au moins le bénéfice d'être rétro-compatible avec AVR.

Serial ou SerialUSB

99.9% des croquis Arduino existant utilise Serial.print pour sortie de débogage ou sortie console. Sur un Arduino SAMD/M0 officiel, cette instruction utilise le port Serial5, qui n'est pas exposé sur un Feather.

A la place, le port USB d'un Arduino M0 officiel est appelé SerialUSB.

Sur un Adafruit M0, Adafruit a corrigé cela de sortie que Serial est dirigé vers l'USB lorsque vous utilisez un Feather M0 (et donc tout fonctionne correctement automatiquement).

Si vous avez des croquis existants et que vous désirez le faire fonctionner sur un M0 sans occasionner de nombreuses opérations de remplacement, placez le code suivant:

#if defined(ARDUINO_SAMD_ZERO) && defined(SERIAL_PORT_USBVIRTUAL)
   // requis pour les opérations Serial sur les cartes à base de Zero
   #define Serial '''SERIAL_PORT_USBVIRTUAL'''
#endif

juste au dessus de la première définition de fonction dans votre code.

Par exemple:

Crédit: AdaFruit Industries www.adafruit.com

AnalogWrite / PWM sur Feather M0/Metro M0

Après avoir consulté la fiche technique du SAMD21, Adafruit à constaté qu'il manquait quelques options listée dans la table multiplexeur sur la puce spécifiquement utilisée sur un Feather M0.

Sur toutes les puces SAMD21, il y a deux périphériques capables de générer des signaux PWM: Le Timer/Counter (TC) et Timer/Counter pour le contrôle des applications (TCC). Chaque SAMD21 dispose de plusieurs copies de chaque, appelés 'instances'.

Chaque instance TC dispose d'un registre de comptage (count), un registre de contrôle (control) et de deux canaux de sortie (output channel). Chaque canal peut être activé, désactivé et même inversé. Les broches connectées sur une instance TC peuvent produire une version identique de la même forme d'onde, ou forme d'onde complémentaire.

Chaque instance TCC dispose d'un simple registre compteur (count) mais de multiples registre comparateur (compare) et canaux de sorties (output channels). Il y a des options pour différent type de forme d'onde, interleaved switching, programmable dead time, etc.

Les plus gros membres de la famille SAMD21 ont jusqu'à 5 instances TC avec 2 canaux WO (waveform output : sortie de forme d'onde) et 3 instances TCC avec 8 canaux WO:

• TC[0-4],WO[0-1]
• TCC[0-2],WO[0-7]

Et cela sont ceux présentés dans la table multiplexer de la fiche technique.

Le SAMD21G utilisé sur le Feather M0 dispose seulement de 3 instances TC avec 2 canaux de sortie, et 3 instances TCC avec 8 canaux de sorties:

• TC[3-5],WO[0-1]
• TCC[0-2],WO[0-7]

En suivant les signaux vers les broches rendues disponibles sir le Feather M0, les broches suivantes ne seront pas capable de produire de signal PWM:

• broche analogique A5

Les broches suivantes peuvent être configurées en sortie PWM (sans aucun conflit) aussi longtemps que les broches SPI, I2C et UART gardent leurs fonctions protocole:

• Broches digitales 5, 6, 9, 10, 11, 12 et 13
• Broches analogiques A3 et A4

Si seules les broches SPI gardent leur fonctions protocole, vous pouvez également faire du PWM sur les broches suivantes:

• TX (broche digitale 1)
• SDA (broche digitale 20)

analogWrite() et gamme de valeur PWM

Sur un AVR (Arduino Uno), si vous utilisez l'instruction analogWrite(pin, 255) sur une sortie PWM alors cela conduit à un signal HAUT en permanence sur la broche.

Sur un Cortex ARM, le signal PWM sera fixé à 255/256. Par conséquent, il y aura toujours une très petite 'implusion à 0v'. Si vous avez besoin que le signal soit continuellement HIGH alors il faudra ajouter un test qui remplace l'instruction analogWrite(pin, 255) par digitalWrite(pin, HIGH)

Fichier d'entête manquant

Vous pourriez avoir du code qui utilise des bibliothèques non supportée sur un coeur M0. Par exemple, si vous avez du code contenant la ligne suivante:

#include <util/delay.h>

alors vous obtiendrez une erreur mentionnant

fatal error: util/delay.h: No such file or directory
  #include <util/delay.h>
                         ^
compilation terminated.
Error compiling.

Ce qui permet de localiser la ligne (et fichier) où s'est produit l'erreur. Il suffira alors de l'inclure dans une structure #ifdef comme celle présentée ci-dessous:

#if !defined(ARDUINO_ARCH_SAM) && !defined(ARDUINO_ARCH_SAMD) && !defined(ESP8266) && !defined(ARDUINO_ARCH_STM32F2)
 #include <util/delay.h>;
#endif

Les lignes ci-dessous font en sorte de ne pas inclure le fichier d'entête pour d'autres architectures.

Si l'instruction #include se trouve directement dans votre croquis Arduino alors vous pouvez essayer de retirer cette ligne.

Lancer le Bootloader

Sur la plupart des AVRs (Arduino Uno), le simple fait de presser le bouton reset avec le microcontrôleur branché en USB permet de démarrer manuellement le bootloader. Le bootloader termine automatiquement sont exécution au bout de quelques secondes.

Sur le M0, vous aurez besoin de double cliquer le bouton reset. Vous verrez la LED rouge pulser, ce qui indique que le bootloader est actif. Une fois dans ce mode, il n'y a pas de "time out", le M0 reste en mode bootloader indéfiniment. Cliquez une nouvelle fois sur le bouton "reset" pour redémarrer le microcontrôleur.

Alignement en mémoire

Cela à moi de chance de vous arriver... mais autant être tenu informé.

Si vous avez utilisé des plateformes 8 bits alors vous savez probablement qu'il est possible de réaliser des typecast de variables. Par exemple:

uint8_t mybuffer[4];
float f = (float)mybuffer;

Mais vous ne pouvez pas garantir que cela fonctionnera sur une plateforme 32 bits parce que mybuffer pourrait ne pas être aligné sur 2 ou 4 octets (voir alignement en mémoire sur Wikipedia).

Un ARM Cortex-M0 peut uniquement accéder directement aux données par bloc de 16-bit (tous les deux ou 4 octets). Essayer d'accéder à un octet impaire (octets en position 1 ou 3) provoquera une erreur matérielle et un arrêt du MCU.

Heureusement, il existe une solution simple... utiliser la fonction memcpy !

uint8_t mybuffer[4];
float f;
memcpy(f, mybuffer, 4)

Conversion en virgule flottante

Like the AVR Arduinos, the M0 library does not have full support for converting floating point numbers to ASCII strings. Functions like sprintf will not convert floating point.  Fortunately, the standard AVR-LIBC library includes the dtostrf function which can handle the conversion for you.

Unfortunately, the M0 run-time library does not have dtostrf.  You may see some references to using #include <avr/dtostrf.h> to get dtostrf in your code.  And while it will compile, it does not work.

Instead, check out this thread to find a working dtostrf function you can include in your code:

<a href="http://forum.arduino.cc/index.php?topic=368720.0">http://forum.arduino.cc/index.php?topic=368720.0</a>

COmbien de RAM disponible?

Un ATSAMD21G18 dispose de 32K de RAM mais vous pourriez avoir besoin de surveiller sa consommation pour des raisons propres à votre projet. Vous pouvez le faire à l'aide de cette fonction:

extern "C" char *sbrk(int i);

int FreeRam () {
  char stack_dummy = 0;
  return &stack_dummy - sbrk(0);
}

Merci a ce fil de discussion sur les forums Arduino pour ce truc!

Storing data in FLASH

If you're used to AVR, you've probably used PROGMEM to let the compiler know you'd like to put a variable or string in flash memory to save on RAM. On the ARM, its a little easier, simply add const before the variable name:

const char str[] = "My very long string";

That string is now in FLASH. You can manipulate the string just like RAM data, the compiler will automatically read from FLASH so you dont need special progmem-knowledgeable functions.

You can verify where data is stored by printing out the address:
Serial.print("Address of str $"); Serial.println((int)&str, HEX);

If the address is $2000000 or larger, its in SRAM. If the address is between $0000 and $3FFFF Then it is in FLASH

---

Source: Adafruit Feather M0 Express - Designed for CircuitPython créé par LadyAda, Tony DiCola, Scorr Shawcroft, Dan Halbert pour AdaFruit Industries. Crédit AdaFruit Industries

Traduit par Meurisse D. pour MCHobby.be

Traduit avec l'autorisation d'AdaFruit Industries - Translated with the permission from Adafruit Industries - www.adafruit.com

Toute référence, mention ou extrait de cette traduction doit être explicitement accompagné du texte suivant : «  Traduction par MCHobby (www.MCHobby.be) - Vente de kit et composants » avec un lien vers la source (donc cette page) et ce quelque soit le média utilisé.

L'utilisation commercial de la traduction (texte) et/ou réalisation, même partielle, pourrait être soumis à redevance. Dans tous les cas de figures, vous devez également obtenir l'accord du(des) détenteur initial des droits. Celui de MC Hobby s'arrêtant au travail de traduction proprement dit.