Fungsi map() Arduino, pada knob yang bisa kamu putar
Pemula
Atau lihat semua pelajaran.
- 526komponen di meja kerja
- 46board sedang berjalan
- 1.00xwaktu nyata, di semua board
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.
Rangkaian di atas persis seperti itu: sebuah potensiometer pada A0 dan sebuah LED pada pin 9 di Uno. Tekan Jalankan dan putar knobnya. Dengan knob di tengah, Serial monitor mencetak pembacaan 511 dan kecerahan 127. Putar sampai penuh dan ia mencetak 1023 dan 255, putar sampai batas sebaliknya dan 0 dan 0, dan LED mengikutinya.
Itulah hasil cepatnya. Sisa halaman ini membahas empat hal yang dilakukan map() dan mengejutkan orang: ia membulatkan ke bawah, ia tidak membatasi nilai, ia bisa menghitung mundur, dan ia hanya bekerja dengan bilangan bulat. Setiap satu di antaranya kami jalankan di Uno di Mokxi, dan angka di bawah adalah apa yang dicetaknya.
Mau versi langkah demi langkah? Pelajaran "Reading a voltage" memandu hal ini dengan checkpoint.
Buka pelajaranSketch-nya, dan lima angkanya
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.
Sketch-nya hanya mencetak saat pembacaan berubah lebih dari 8, jadi knob yang diam tidak memenuhi monitor. Ubah angka 255 terakhir menjadi 50 dan tekan Jalankan lagi: LED tidak akan pernah lebih terang dari sekadar redup, karena seluruh knob sekarang dipetakan ke 0 sampai 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);
}Buka sketch ini di editorKodenya saja: editor menempatkan board dan komponen yang bisa dibacanya dari sketch.
Bagaimana map() bekerja di dalamnya
Tidak ada yang tersembunyi di dalamnya. map() adalah satu baris aritmetika bilangan bulat, dan referensi Arduino mencetaknya lengkap. Kurangi batas bawah rentang pertama, kalikan dengan ukuran rentang kedua, bagi dengan ukuran rentang pertama, lalu tambahkan batas bawah rentang kedua.
Kami mengompilasi fungsi itu dengan nama lain dan membandingkannya dengan map() bawaan untuk setiap pembacaan dari 0 sampai 1023, ke 0 sampai 255, 0 sampai 180 dan 255 ke 0. Semua jawabannya sama. Mengetahui rumusnya menjelaskan setiap kejutan di bawah: pembagian membuang sisanya, dan tidak ada bagian mana pun yang memeriksa jawabannya berada di dalam rentang.
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;
}Ia membulatkan ke bawah, jadi nilai tertinggi jarang muncul
Pembagian bilangan bulat membuang pecahannya. map(512, 0, 1023, 0, 255) adalah 127.6 di kalkulator dan 127 di board. map(1022, 0, 1023, 0, 255) adalah 254.75, dan board menyebutnya 254. Hanya pembacaan tepat 1023 yang memberi 255.
Kami menghitungnya, dengan menjalankan setiap pembacaan dari 0 sampai 1023 lewat map() di Uno. Lima pembacaan memberi 0, sebagian besar keluaran mendapat empat pembacaan masing-masing, dan 255 mendapat satu. Pada pot sungguhan, dengan sedikit noise pada wipernya, LED jarang berada di kecerahan penuh. Itu biasanya tidak masalah. Jika masalah, bagi empat saja: reading / 4, yang sama dengan map(reading, 0, 1024, 0, 256). Maka setiap keluaran dari 0 sampai 255 mendapat tepat empat pembacaan, 512 memberi 128, dan 1023 memberi 255, tidak pernah 256.
Ia tidak membatasi nilai: gunakan constrain()
map() dengan senang hati menjawab di luar rentang yang kamu berikan. Misalnya kamu mengkalibrasi sensor cahaya dan menemukan ia membaca 200 saat gelap dan 800 saat siang, jadi kamu menulis map(reading, 200, 800, 0, 100) untuk persentase. Saat matahari terik ia membaca 900, dan sketch-nya bilang 116 persen. Beri 1200 pada rentang 0 sampai 1023 dan kamu dapat 299, yang bukan kecerahan yang pantas diberikan ke analogWrite().
Perbaikannya satu panggilan lagi. constrain(map(reading, 200, 800, 0, 100), 0, 100) memberi 100 untuk pembacaan 900 yang sama. Selalu gunakan keduanya bersama setiap kali masukan bisa melewati batas yang kamu ukur, dan untuk sensor sungguhan itu selalu terjadi.
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() {
}Buka sketch ini di editorKodenya saja: editor menempatkan board dan komponen yang bisa dibacanya dari sketch.
Mundur dan di bawah nol
Tukar dua angka terakhir dan rentangnya berjalan ke arah sebaliknya. map(300, 0, 1023, 255, 0) menghasilkan 181, jadi memutar knob ke atas membuat LED jadi redup. Itulah cara mudah memperbaiki pot yang terpasang terbalik, atau sensor cahaya yang seharusnya menyalakan lampu saat gelap.
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.
Kenapa map() memakai long, dan kenapa angka desimalnya hilang
Coba hitung sendiri dengan int dan hasilnya akan salah. Di Uno, int hanya 16 bit dan menampung sampai 32767. int a = 1000; lalu a * 180 / 1023 mencetak -16, karena 180000 tidak muat dan berputar balik sebelum dibagi. map(1000, 0, 1023, 0, 180) mencetak 175, karena map() melakukan perkaliannya dalam long 32-bit.
map() hanya menerima bilangan bulat. map(2.7, 0, 10, 0, 100) mencetak 20, karena 2.7 dipotong jadi 2 saat masuk, dan tab build memberi peringatan: implicit conversion from 'double' to 'long' changes value from 2.7 to 2. Untuk desimal, tulis rumus yang sama dengan float. Versi di bawah mencetak 27.00 untuk 2.7, dan 2.50 untuk pembacaan 512 yang diskalakan ke 0 sampai 5 volt.
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() {
}Buka sketch ini di editorKodenya saja: editor menempatkan board dan komponen yang bisa dibacanya dari sketch.
Buka rangkaian ini di editor. Arduino Uno: knob di A0 meredupkan LED di pin 9, dirangkai seperti di bagian atas halaman ini. Ubah komponen atau nilainya lalu jalankan lagi.
Buka rangkaian iniPertanyaan
Apakah map() di Arduino membatasi hasilnya?
Tidak. Nilai di luar rentang pertama menghasilkan jawaban di luar rentang kedua: pembacaan 900 yang dipetakan dari 200 sampai 800 ke 0 sampai 100 menghasilkan 116. Bungkus dengan constrain(), seperti constrain(map(x, 200, 800, 0, 100), 0, 100).
Kenapa map(x, 0, 1023, 0, 255) hampir tidak pernah mencapai 255?
Karena map() membulatkan ke bawah, hanya pembacaan tepat 1023 yang menghasilkan 255. Lima pembacaan menghasilkan 0 dan sebagian besar output mendapat empat. Bagi pembacaan dengan 4 saja jika kamu ingin setiap tingkat kecerahan mendapat bagian knob yang sama.
Bisakah map() memakai desimal?
Tidak. Argumen dan hasilnya berupa bilangan bulat, jadi 2.7 menjadi 2 sebelum mulai dihitung. Tulis rumus yang sama dengan argumen float, seperti fungsi mapFloat() di halaman ini, saat kamu butuh pecahan.
Bagaimana cara membalik rentang dengan map()?
Tukar dua angka terakhir: map(reading, 0, 1023, 255, 0) memberi 255 di ujung bawah knob dan 0 di ujung atas. Rentang pertama bisa dibalik dengan cara yang sama.
Apa bedanya map() dan constrain()?
map() mengubah skala sebuah angka. constrain() tidak mengubah skala dan mencegah angka melewati dua batas yang kamu berikan. Keduanya sering dipakai bersama, map() dulu.
Apa rumus fungsi map() milik Arduino?
(value - fromLow) * (toHigh - toLow) / (fromHigh - fromLow) + toLow, dihitung dalam bilangan bulat dengan sisanya dibuang. Jadi map(1000, 0, 1023, 0, 100) adalah 97 dan map(512, 0, 1023, 0, 100) adalah 50, sesuai yang dicetak Uno di sini.
Lanjutkan
Asal fakta di halaman ini
Rakit versi nyatanya
Buka editor, ubah sebuah nilai, dan lihat angkanya ikut berubah. Tidak ada yang perlu dipasang, dan tidak perlu akun.