Fonction map Arduino

La fonction map d’Arduino transfère une valeur de la plage actuelle à une nouvelle plage de valeurs spécifiée par les paramètres – map(value, fromLow, fromHigh, toLow, toHigh). La commande map() ne fonctionne que sur les entiers. La partie fractionnaire d’un nombre n’est pas arrondie selon les règles mathématiques du transfert proportionnel, mais est simplement rejetée. Utilisons la fonction map dans Arduino IDE avec des exemples.


Pour cette activité, nous aurons besoin:

  • Arduino Uno / Arduino Nano / Arduino Mega
  • LED et résistance
  • photorésistance (LDR)
  • breadboard
  • fils de connexion

Matériel supplémentaire sur ce sujet:

  1. Type de données (variable) dans Arduino
  2. Arduino EEPROM: exemples pour lire/écrire
  3. Interruptions externes et matérielles Arduino

Fonction map Arduino IDE description

Syntaxe map

map(valeur_entrée, inférieur_entrée, supérieur_entrée, inférieur_sortie, supérieur_sortie);

Dans ce mandat on observe cinq paramètres:

valeur_entrée -> c’est le nombre à mapper (à transformer)
inférieur_entrée -> c’est la limite inférieur de l’intervalle actuel
supérieur_entrée -> c’est la limite supérieur de l’intervalle actuel
inférieur_sortie -> c’est la limite inférieur de l’intervalle résultat du changement
supérieur_sortie -> c’est la limite supérieur de l’intervalle résultat du changement

Function map Arduino exemple, syntaxe

Montage photorésistance (LDR) avec Arduino
Montage photorésistance (LDR) et la LED avec Arduino

Parfois, les valeurs que nous obtenons de la lecture d’un pin, comme par exemple un capteur, peuvent être hors d’une portée déterminée, c’est pour cela que nous devons les transférer à une nouvelle portée afin de pouvoir les utiliser correctement. Notez que function map() de la Arduino IDE peut inverser la plage, c’est-à-dire que la « limite inférieure » peut être plus grande que la « limite supérieure ». Exemple de programme avec LDR et la LED:



int value;
 
void setup() {
  Serial.begin(9600);   // initialise la communication
  pinMode(A1, INPUT);   // composante photorésistance sur la pin A1
  pinMode(9, OUTPUT);   // composante la LED sur la pin A1
}
 
void loop() {
  // mesure la tension sur la broche A1
  value = analogRead(A1);
  Serial.println(value);

/* la LED allumera plus fort si l'entourage est plus sombre.
c'est à dire, "analogWrite()" est inversement proportionnelle à "value".
On doit invertir "value" pour que sa valeur change de 0/1023 à 255/0 */

  value = map(value, 0, 1023, 255, 0);
  analogWrite(9, value);

}


Fonction map float Arduino, nombres fractionnaires

Dans l’exemple suivant, nous allons convertir les données de la photorésistance (valeurs de 0 à 1023) en volts (valeurs de 0 à 5) et les afficher sur le moniteur du port. Pour obtenir des valeurs avec des nombres fractionnaires, vous devez utiliser la fonction float mapf dans le croquis pour mesurer plus précisément la tension à l’entrée analogique. Sans modifier le circuit du premier exemple, chargez le programme suivant dans le microcontrôleur.

int val, led;

void setup() {
  Serial.begin(9600);
  pinMode(A1, INPUT);
  pinMode(9, OUTPUT);
}

void loop() {
  val = analogRead(A1);
  float data = mapf(val, 0, 1023, 0, 5);

  Serial.print(data);
  Serial.println(" V");

  led = map(val, 0, 1023, 255, 0);
  analogWrite(9, led);
  delay(100);
}

float mapf(float value, float fromLow, float fromHigh, float toLow, float toHigh) {
  float result;
  result = (value - fromLow) * (toHigh - toLow) / (fromHigh - fromLow) + toLow;
  return result;
}

Conclusion. Lors de la conversion à l’aide de map(), la partie fractionnaire du nombre n’est pas arrondie, mais simplement écartée (non prise en compte). Ce fait doit être pris en compte lorsque vous travaillez avec le type de données float dans le langage Arduino. Notez que la fonction map utilise une division par 2, ce qui est une opération très coûteuse pour les microcontrôleurs. La fonction est donc très lente et ne doit pas être interrompue.





Laisser un commentaire

Votre adresse e-mail ne sera pas publiée. Les champs obligatoires sont indiqués avec *

Ce site utilise Akismet pour réduire les indésirables. Découvrez comment les données de vos commentaires sont traitées.