A função map() do Arduino, em um potenciômetro que você pode girar
Iniciante
- 526componentes na bancada
- 46placas rodando agora
- 1.00xtempo real, em todas as placas
map(value, fromLow, fromHigh, toLow, toHigh) re-scales a number from one range to another. Its most common job is the line map(analogRead(A0), 0, 1023, 0, 255), which turns a knob’s reading into an LED brightness: 0 stays 0, 1023 becomes 255, and everything in between lands in proportion.
O circuito acima é exatamente isso: um potenciômetro em A0 e um LED no pino 9 de um Uno. Aperte Rodar e gire o potenciômetro. Com o potenciômetro no meio, o monitor serial imprime uma leitura de 511 e um brilho de 127. Gire até o fim e ele imprime 1023 e 255, até o outro extremo e 0 e 0, e o LED acompanha.
Essa é a vitória rápida. O resto desta página é sobre as quatro coisas que map() faz e que surpreendem as pessoas: ela arredonda para baixo, não faz clamp, aceita contar de trás para frente e só trabalha com números inteiros. Cada uma foi testada em um Uno no Mokxi, e os números abaixo são o que ele imprimiu.
Quer a versão passo a passo? A aula "Lendo uma tensão" percorre isso com checkpoints.
Abrir a aulaO sketch, e os cinco números
The first number is the value to convert. The next two are the range it comes from, and the last two are the range you want. So map(reading, 0, 1023, 0, 255) reads as "reading, which runs from 0 to 1023, scaled to run from 0 to 255". For a servo you would write map(reading, 0, 1023, 0, 180), and the knob at 512 gives 90 degrees.
O sketch imprime somente quando a leitura muda mais de 8, então um potenciômetro parado não enche o monitor. Troque o último 255 por 50 e aperte Rodar de novo: o LED nunca fica mais brilhante que um leve brilho, porque agora o potenciômetro inteiro é mapeado para 0 a 50.
const int KNOB = A0;
const int LED = 9;
int shown = -1;
void setup() {
pinMode(LED, OUTPUT);
Serial.begin(9600);
Serial.println("Mokxi Uno: knob on A0, LED on pin 9");
}
void loop() {
int reading = analogRead(KNOB);
int brightness = map(reading, 0, 1023, 0, 255);
analogWrite(LED, brightness);
if (abs(reading - shown) > 8) {
shown = reading;
Serial.print("reading ");
Serial.print(reading);
Serial.print(" brightness ");
Serial.println(brightness);
}
delay(20);
}Abrir este sketch no editorSó o código: o editor posiciona a placa e os componentes que ele consegue ler do sketch.
Como map() funciona por dentro
Não há nada escondido nela. map() é uma linha de aritmética com números inteiros, e a referência do Arduino a imprime por completo. Subtraia o início da primeira faixa, multiplique pelo tamanho da segunda, divida pelo tamanho da primeira e some o início da segunda.
Compilamos essa função sob outro nome e a comparamos com a map() embutida para cada leitura de 0 a 1023, para 0 a 255, 0 a 180 e 255 a 0. Todas as respostas coincidiram. Conhecer a fórmula explica cada surpresa abaixo: a divisão descarta o resto, e nada em lugar algum verifica se a resposta está dentro da faixa.
long map(long x, long in_min, long in_max, long out_min, long out_max) {
return (x - in_min) * (out_max - out_min) / (in_max - in_min) + out_min;
}Ela arredonda para baixo, então o valor máximo é raro
A divisão inteira descarta a fração. map(512, 0, 1023, 0, 255) é 127,6 na calculadora e 127 na placa. map(1022, 0, 1023, 0, 255) é 254,75, e a placa diz 254. Só uma leitura de exatamente 1023 dá 255.
Nós contamos, rodando cada leitura de 0 a 1023 pela map() no Uno. Cinco leituras dão 0, a maioria das saídas recebe quatro leituras cada, e 255 recebe uma. Em um potenciômetro real, com um pouco de ruído no cursor, o LED raramente ficará no brilho máximo. Isso normalmente está bom. Quando não está, divida por quatro: reading / 4, que é o mesmo que map(reading, 0, 1024, 0, 256). Assim, cada saída de 0 a 255 recebe exatamente quatro leituras, 512 dá 128, e 1023 dá 255, nunca 256.
Ela não faz clamp: use constrain()
map() responde sem problema fora da faixa que você deu. Digamos que você calibrou um sensor de luz e descobriu que ele lê 200 no escuro e 800 à luz do dia, então escreveu map(reading, 200, 800, 0, 100) para uma porcentagem. No sol forte ele lê 900, e o sketch diz 116 por cento. Dê 1200 a ele em uma faixa de 0 a 1023 e você obtém 299, que não é um brilho que analogWrite() deveria receber.
A solução é mais uma chamada. constrain(map(reading, 200, 800, 0, 100), 0, 100) deu 100 para a mesma leitura de 900. Mantenha as duas juntas sempre que a entrada puder passar dos extremos que você mediu, o que, para qualquer sensor real, é sempre.
void setup() {
Serial.begin(9600);
int reading = 900;
Serial.println(map(reading, 200, 800, 0, 100));
Serial.println(constrain(map(reading, 200, 800, 0, 100), 0, 100));
}
void loop() {
}Abrir este sketch no editorSó o código: o editor posiciona a placa e os componentes que ele consegue ler do sketch.
De trás para frente e abaixo de zero
Troque os dois últimos números e a faixa inverte. map(300, 0, 1023, 255, 0) deu 181, então girar o potenciômetro para cima diminui o brilho do LED. Esse é o conserto fácil para um potenciômetro ligado ao contrário, ou um sensor de luz que deve acender uma lâmpada quando escurece.
Negative numbers work too. map(512, 0, 1023, -40, 125) gave 42, which is how a sensor’s 0 to 5 V output becomes -40 to 125 degrees. Below zero, the rounding goes toward zero rather than down: map(-10, 0, 1023, 0, 255) gave -2, not -3.
Por que map() usa long, e por que os decimais desaparecem
Faça você mesmo a aritmética com um int e ela sai errada. Num Uno um int tem 16 bits e guarda só até 32767. int a = 1000; e depois a * 180 / 1023 imprimiu -16, porque 180000 não cabe e o valor deu a volta antes da divisão. map(1000, 0, 1023, 0, 180) imprimiu 175, porque map() faz a multiplicação num long de 32 bits.
map() aceita só números inteiros. map(2.7, 0, 10, 0, 100) imprimiu 20, porque 2.7 virou 2 na entrada, e a aba de compilação avisou: implicit conversion from 'double' to 'long' changes value from 2.7 to 2. Para decimais, escreva a mesma fórmula com floats. A versão abaixo imprimiu 27.00 para 2.7, e 2.50 para uma leitura de 512 convertida para 0 a 5 volts.
float mapFloat(float x, float inMin, float inMax, float outMin, float outMax) {
return (x - inMin) * (outMax - outMin) / (inMax - inMin) + outMin;
}
void setup() {
Serial.begin(9600);
Serial.println(mapFloat(2.7, 0, 10, 0, 100));
Serial.println(mapFloat(512, 0, 1023, 0, 5));
}
void loop() {
}Abrir este sketch no editorSó o código: o editor posiciona a placa e os componentes que ele consegue ler do sketch.
Abra este circuito no editor. Arduino Uno: um potenciômetro em A0 controla o brilho do LED no pino 9, ligado como no exemplo do topo desta página. Troque um componente ou um valor e rode de novo.
Abrir o circuitoPerguntas
O map() do Arduino limita o resultado?
Não. Um valor fora da primeira faixa dá uma resposta fora da segunda: uma leitura de 900 mapeada de 200 a 800 para 0 a 100 dá 116. Envolva com constrain(), como em constrain(map(x, 200, 800, 0, 100), 0, 100).
Por que map(x, 0, 1023, 0, 255) quase nunca chega a 255?
Porque map() arredonda para baixo, só uma leitura de exatamente 1023 dá 255. Cinco leituras dão 0 e a maioria das saídas recebe quatro. Divida a leitura por 4 se quiser que cada brilho receba a mesma fatia do potenciômetro.
O map() aceita decimais?
Não. Os argumentos e a resposta são long, então 2.7 vira 2 antes de começar. Escreva a mesma fórmula com argumentos float, como faz a função mapFloat() desta página, quando precisar de frações.
Como inverto uma faixa com map()?
Troque os dois últimos números: map(reading, 0, 1023, 255, 0) dá 255 na base do potenciômetro e 0 no topo. A primeira faixa pode ser invertida do mesmo jeito.
Qual é a diferença entre map() e constrain()?
map() muda a escala de um número. constrain() deixa a escala como está e impede que um número passe dos dois limites que você deu. Eles costumam ser usados juntos, map() primeiro.
Qual é a fórmula da função map() do Arduino?
(value - fromLow) * (toHigh - toLow) / (fromHigh - fromLow) + toLow, calculada em números inteiros com o resto descartado. Assim map(1000, 0, 1023, 0, 100) é 97 e map(512, 0, 1023, 0, 100) é 50, que é o que um Uno imprimiu aqui.
Continuar
De onde vêm as informações desta página
Monte isto de verdade
Abra o editor, mude um valor e veja o número mudar junto. Nada para instalar, e não precisa de conta.