Hàm Arduino map(), trên một núm xoay bạn có thể vặn
Cơ bản
Hoặc xem mọi bài học.
- 526linh kiện trên bàn làm mạch
- 46bo mạch đang chạy
- 1.00xthời gian thực, trên mọi bo mạch
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.
Mạch ở trên đúng là như vậy: một chiết áp trên A0 và một LED ở chân 9 của Uno. Nhấn Chạy và vặn núm. Khi núm ở giữa, Serial Monitor in giá trị 511 và độ sáng 127. Vặn hết cỡ nó in 1023 và 255, vặn ngược hết nó in 0 và 0, và LED thay đổi theo.
Đó là phần cơ bản. Phần còn lại của trang này là bốn điều map() làm khiến nhiều người ngạc nhiên: nó làm tròn xuống, nó không kẹp giá trị, nó chấp nhận đếm ngược, và nó chỉ làm việc với số nguyên. Mỗi điều đều được chạy trên Uno trong Mokxi, và các số bên dưới là những gì nó in ra.
Muốn xem phiên bản từng bước? Bài học "Đọc một điện áp" sẽ hướng dẫn chi tiết với các điểm kiểm tra.
Mở bài họcSketch, và năm con số
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 chỉ in khi giá trị đọc thay đổi hơn 8, nên núm đứng yên sẽ không làm ngập monitor. Đổi số 255 cuối thành 50 rồi nhấn Chạy lại: LED không bao giờ sáng hơn một ánh mờ, vì cả núm giờ ánh xạ vào 0 đến 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);
}Mở sketch này trong trình soạn codeChỉ riêng phần code: trình soạn code sẽ tự đặt bo mạch và các linh kiện mà nó đọc được từ sketch.
map() hoạt động thế nào bên trong
Không có gì bí ẩn trong nó. map() là một dòng phép tính số nguyên, và tài liệu tham khảo Arduino in ra đầy đủ. Lấy giá trị trừ đáy khoảng thứ nhất, nhân với độ lớn khoảng thứ hai, chia cho độ lớn khoảng thứ nhất, cộng đáy khoảng thứ hai.
Chúng tôi biên dịch hàm đó dưới tên khác và đối chiếu với map() sẵn có cho mọi giá trị đọc từ 0 đến 1023, ánh xạ sang 0 đến 255, 0 đến 180 và 255 đến 0. Mọi kết quả đều khớp. Biết công thức giải thích mọi điều ngạc nhiên bên dưới: phép chia vứt phần dư, và không có chỗ nào kiểm tra kết quả có nằm trong khoảng hay không.
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;
}Nó làm tròn xuống, nên giá trị đỉnh hiếm khi tới
Phép chia số nguyên vứt phần lẻ. map(512, 0, 1023, 0, 255) là 127.6 trên máy tính và 127 trên bo mạch. map(1022, 0, 1023, 0, 255) là 254.75, và bo mạch trả 254. Chỉ giá trị đúng 1023 mới cho 255.
Chúng tôi đã đếm, bằng cách chạy mọi giá trị từ 0 đến 1023 qua map() trên Uno. Năm giá trị cho ra 0, phần lớn các đầu ra nhận bốn giá trị mỗi cái, và 255 chỉ nhận một. Trên chiết áp thật, với chút nhiễu ở con chạy, LED sẽ hiếm khi sáng hết công suất. Thường vậy là ổn. Khi không ổn, hãy chia bốn thay thế: reading / 4, tương đương map(reading, 0, 1024, 0, 256). Khi đó mọi đầu ra từ 0 đến 255 nhận đúng bốn giá trị, 512 cho 128, và 1023 cho 255, không bao giờ 256.
Nó không kẹp giá trị: hãy dùng constrain()
map() sẵn sàng trả về ngoài khoảng bạn đưa cho nó. Giả sử bạn hiệu chuẩn một cảm biến ánh sáng và thấy nó đọc 200 trong tối và 800 ban ngày, nên bạn viết map(reading, 200, 800, 0, 100) để lấy phần trăm. Dưới nắng gắt nó đọc 900, và sketch trả 116 phần trăm. Đưa vào 1200 trên khoảng 0 đến 1023 bạn nhận 299, thứ không phải độ sáng mà analogWrite() từng được thiết kế để nhận.
Lời giải chỉ là thêm một lời gọi. constrain(map(reading, 200, 800, 0, 100), 0, 100) trả 100 cho cùng giá trị đọc 900. Giữ hai hàm này cạnh nhau bất cứ khi nào đầu vào có thể vượt ra ngoài hai đầu bạn đo, mà với mọi cảm biến thật thì luôn có thể.
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() {
}Mở sketch này trong trình soạn codeChỉ riêng phần code: trình soạn code sẽ tự đặt bo mạch và các linh kiện mà nó đọc được từ sketch.
Đếm ngược và dưới số không
Đổi chỗ hai số cuối thì khoảng sẽ chạy ngược lại. map(300, 0, 1023, 255, 0) cho ra 181, nghĩa là vặn núm lên thì LED lại mờ đi. Đây là cách sửa nhanh cho một biến trở cắm ngược, hoặc một cảm biến ánh sáng mà cần bật đèn khi trời tối.
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.
Vì sao map() dùng long, và vì sao số thập phân biến mất
Thử tự tính với int thì sẽ sai. Trên Uno, int là 16 bit và chỉ chứa tối đa 32767. int a = 1000; rồi a * 180 / 1023 in ra -16, vì 180000 không vừa nên bị tràn trước khi chia. map(1000, 0, 1023, 0, 180) in ra 175, vì map() nhân trong kiểu long 32 bit.
map() chỉ nhận số nguyên. map(2.7, 0, 10, 0, 100) in ra 20, vì 2.7 bị cắt thành 2 lúc vào, và tab biên dịch cảnh báo: implicit conversion from 'double' to 'long' changes value from 2.7 to 2. Với số thập phân, hãy viết cùng công thức bằng float. Phiên bản dưới đây in ra 27.00 cho 2.7, và 2.50 cho giá trị đọc 512 quy đổi ra 0 đến 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() {
}Mở sketch này trong trình soạn codeChỉ riêng phần code: trình soạn code sẽ tự đặt bo mạch và các linh kiện mà nó đọc được từ sketch.
Mở mạch này trong trình soạn thảo. Bo mạch Arduino Uno: núm trên A0 điều chỉnh độ sáng của LED ở chân 9, nối như mạch đang chạy ở đầu trang này. Thay một linh kiện hoặc một giá trị rồi chạy lại nhé.
Mở mạchCâu hỏi
Arduino map() có giới hạn kết quả không?
Không. Giá trị ngoài khoảng đầu sẽ cho kết quả ngoài khoảng sau: giá trị đọc 900 ánh xạ từ 200 đến 800 sang 0 đến 100 thì cho ra 116. Bọc bằng constrain(), như trong constrain(map(x, 200, 800, 0, 100), 0, 100).
Vì sao map(x, 0, 1023, 0, 255) hầu như không bao giờ đạt 255?
Vì map() làm tròn xuống, chỉ có giá trị đọc đúng 1023 mới cho 255. Năm giá trị đọc cho ra 0 và phần lớn đầu ra nhận bốn. Hãy chia giá trị đọc cho 4 nếu muốn mọi mức sáng đều được phần núm như nhau.
map() có dùng số thập phân được không?
Không. Các tham số và kết quả của nó đều là long, nên 2.7 thành 2 trước khi bắt đầu. Khi cần phần thập phân, hãy viết cùng công thức với tham số float, như hàm mapFloat() trên trang này.
Làm sao đảo ngược khoảng với map()?
Đổi chỗ hai số cuối: map(reading, 0, 1023, 255, 0) cho 255 ở đầu dưới của núm và 0 ở đầu trên. Khoảng đầu cũng đảo ngược được theo cách tương tự.
map() và constrain() khác nhau thế nào?
map() đổi tỷ lệ của một số. constrain() giữ nguyên tỷ lệ và ngăn số vượt qua hai giới hạn bạn đặt. Hai hàm này hay đi cùng nhau, map() đứng trước.
Công thức của hàm map() trên Arduino là gì?
(value - fromLow) * (toHigh - toLow) / (fromHigh - fromLow) + toLow, tính bằng số nguyên và phần dư bị bỏ đi. Nên map(1000, 0, 1023, 0, 100) là 97 và map(512, 0, 1023, 0, 100) là 50, đúng như Uno ở đây đã in ra.
Tiếp tục nào
Thông tin trên trang này lấy từ đâu
Lắp mạch này ngoài đời
Mở trình soạn thảo, đổi một giá trị và xem con số thay đổi theo. Không cần cài gì, không cần tài khoản.