Belajar

Arduino millis(): timer, dan beberapa hal sekaligus

Atau lihat semua pelajaran.

  • 526komponen di meja kerja
  • 46board sedang berjalan
  • 1.00xwaktu nyata, di semua board
Arduino Uno: tiga lampu dengan tiga laju, tanpa delay()live0.000 s 0.00x
Tekan Jalankan dan saksikan ketiga lampunya
Tiga timer dalam satu loop, masing-masing diperiksa terhadap millis() di setiap putaran.

millis() mengembalikan berapa milidetik sudah berlalu sejak board menyala, sebagai unsigned long. Ia tidak menunggu apa pun. Untuk melakukan sesuatu setiap detik, ingat kapan terakhir kamu melakukannya, dan setiap kali loop() berputar tanyakan apakah sudah lewat satu detik: if (millis() - previous >= 1000). Satu baris itu adalah cara Arduino melakukan beberapa hal sekaligus.

Rangkaian di atas adalah meja kerja kode dengan tiga lampu. Tekan Jalankan. Lampu merah berkedip setiap 200 ms, kuning setiap 330 ms dan hijau setiap 1100 ms, semuanya dari satu loop() tanpa delay() di dalamnya. Serial monitor mencetak "putaran loop terburuk: 2 ms" setiap dua detik: tidak ada putaran loop() yang pernah lebih lama dari itu, jadi setiap lampu tepat waktu.

Di bawah ini adalah apa yang dikembalikan millis(), pola timer, sebuah sketch yang menjalankan tiga tugas sekaligus, millis() dibandingkan delay(), dan kesalahan yang membuat timer drift, berhenti atau jadi negatif, masing-masing dijalankan di Uno.

Mau versi langkah demi langkah? Pelajaran "Tanyakan waktu, jangan menunggunya" memandu hal ini dengan checkpoint.

Buka pelajaran

Apa yang dikembalikan millis()

Hitungan milidetik sejak dinyalakan atau direset, mulai dari 0. Sketch ini mencetaknya sekali per detik dan mencetak 0, 999, 1999, 3000 dan 3999. Hitungannya 0 di awal setup() karena board selalu mulai dari nol setiap kali.

Ia adalah unsigned long, 32 bit, jadi ia menghitung sampai 4294967295 lalu kembali ke 0, setelah sekitar 49,7 hari. Halaman overflow millis() menjelaskan mengapa pengurangan dalam pola timer tetap aman melewati wrap.

Cetak millis()
void setup() {
  Serial.begin(9600);
}

void loop() {
  Serial.println(millis());
  delay(1000);
}

Buka sketch ini di editorKodenya saja: editor menempatkan board dan komponen yang bisa dibacanya dari sketch.

Sebuah timer millis()

Ini polanya. previous menyimpan kapan timer terakhir menyala. Setiap putaran, now - previous >= INTERVAL menanyakan apakah interval sudah berlalu, dan jika ya sketch melakukan tugasnya lalu menggeser previous. delay(7) mewakili sisa sketch sungguhan, yang juga butuh waktu.

Ia mencetak "tick at 1003", "tick at 2001", "tick at 3006", "tick at 4003" dan "tick at 5001". Setiap tick bisa terlambat beberapa milidetik, karena loop hanya memeriksa setiap 7 ms, tapi keterlambatannya tidak menumpuk: tick kelima tetap di 5001.

Sebuah timer setiap detik
const unsigned long INTERVAL = 1000;
unsigned long previous = 0;

void setup() {
  Serial.begin(9600);
}

void loop() {
  unsigned long now = millis();
  if (now - previous >= INTERVAL) {
    previous += INTERVAL;
    Serial.print("tick at ");
    Serial.println(now);
  }
  delay(7);  // stands in for the rest of a busy loop
}

Buka sketch ini di editorKodenya saja: editor menempatkan board dan komponen yang bisa dibacanya dari sketch.

Beberapa tugas sekaligus

Setiap tugas punya timer sendiri, dan loop() memeriksa semuanya di setiap putaran. Sketch ini membuat pin 13 berkedip setiap 250 ms, mengubah lampu di pin 12 setiap kali tombol ditekan, dan mencetak laporan setiap detik, semua bersamaan.

Kami menekan tombol tiga kali, tekanan cepat 150 ms sekali. Ia mencetak "1 s, presses: 1", "2 s, presses: 3" dan "3 s, presses: 3", lampu di pin 12 berubah di setiap tekanan, dan kedipan di pin 13 tidak pernah telat sekali pun. Tambahkan tugas keempat dengan cara yang sama: satu timer lagi, satu if lagi.

Tiga tugas, satu loop
const int BLINK_LED = 13;
const int LAMP = 12;
const int BUTTON = 2;

unsigned long lastBlink = 0;
unsigned long lastChange = 0;
unsigned long lastReport = 0;
int lastReading = HIGH;
bool blinkOn = false;
bool lampOn = false;
int presses = 0;

void setup() {
  Serial.begin(9600);
  pinMode(BLINK_LED, OUTPUT);
  pinMode(LAMP, OUTPUT);
  pinMode(BUTTON, INPUT_PULLUP);
}

void loop() {
  unsigned long now = millis();

  // Task 1: blink pin 13 every 250 ms.
  if (now - lastBlink >= 250) {
    lastBlink = now;
    blinkOn = !blinkOn;
    digitalWrite(BLINK_LED, blinkOn ? HIGH : LOW);
  }

  // Task 2: each press flips the lamp on pin 12.
  int reading = digitalRead(BUTTON);
  if (reading != lastReading && now - lastChange > 50) {
    lastChange = now;
    lastReading = reading;
    if (reading == LOW) {
      presses++;
      lampOn = !lampOn;
      digitalWrite(LAMP, lampOn ? HIGH : LOW);
    }
  }

  // Task 3: report once a second.
  if (now - lastReport >= 1000) {
    lastReport = now;
    Serial.print(now / 1000);
    Serial.print(" s, presses: ");
    Serial.println(presses);
  }
}

Buka sketch ini di editorKodenya saja: editor menempatkan board dan komponen yang bisa dibacanya dari sketch.

millis() dibandingkan delay()

Ini kedipan dan tombol yang sama ditulis dengan delay(). Sketch menghabiskan seluruh waktunya di dalam delay(), jadi ia hanya membaca tombol sesaat sekali per detik. Tiga tekanan 150 ms yang sama hanya mencetak "pressed" sekali. Dua dari tiga datang dan pergi saat sketch sedang menunggu.

delay() tidak masalah saat board punya satu hal untuk dikerjakan. Begitu ada dua, beralihlah ke millis().

Yang sama, dengan delay()
const int BUTTON = 2;

void setup() {
  Serial.begin(9600);
  pinMode(13, OUTPUT);
  pinMode(BUTTON, INPUT_PULLUP);
}

void loop() {
  digitalWrite(13, HIGH);
  delay(500);
  digitalWrite(13, LOW);
  delay(500);
  if (digitalRead(BUTTON) == LOW) {
    Serial.println("pressed");
  }
}

Buka sketch ini di editorKodenya saja: editor menempatkan board dan komponen yang bisa dibacanya dari sketch.

Mengapa millis() kadang melompat 2

Timer di balik millis() berdetak setiap 1024 µs, bukan setiap 1000. Jadi millis() tertinggal 24 µs per detak, dan setiap 41 atau 42 detak ia mengejar dengan menambah 2 sekaligus. Sketch ini mengamatinya di 200 ms pertama dan mencetak "41 -> 43", "84 -> 86", "126 -> 128" dan "169 -> 171". Uno sungguhan melakukan hal yang persis sama.

Itulah mengapa meja kerja kode di atas bisa melaporkan putaran terburuk 2 ms: putaran yang jatuh tepat di lompatan melihat jam bergerak 2. Itu juga mengapa timer harus menguji >= dan tidak pernah ==. Uji untuk tepat 42 tidak akan pernah benar.

Tangkap lompatan millis()
void setup() {
  Serial.begin(9600);
  unsigned long last = millis();
  while (millis() < 200) {
    unsigned long now = millis();
    if (now - last > 1) {
      Serial.print(last);
      Serial.print(" -> ");
      Serial.println(now);
    }
    last = now;
  }
}

void loop() {
}

Buka sketch ini di editorKodenya saja: editor menempatkan board dan komponen yang bisa dibacanya dari sketch.

Kesalahan umum

Menyimpan millis() dalam int. int di Uno hanya sampai 32767. Sketch di bawah mencetak 0, 7999, 16000, 23999, 32000, lalu -25536 di detik ke-40, dan timer apa pun yang dibangun di atasnya rusak. Gunakan unsigned long.

Mengatur previous = now alih-alih previous += INTERVAL. Setiap tick sedikit terlambat, dan dengan = now keterlambatan menumpuk: timer yang sama mencetak 1003, 2009, 3013, 4018 dan 5022. Gunakan += saat tick harus tetap pada iramanya, dan = now hanya saat tick yang telat boleh menggeser tick berikutnya.

Menguji millis() == target. millis() bisa melewati satu nilai, jadi ujinya mungkin tidak pernah benar. Uji >= pada selisihnya.

Menambah, bukan mengurang. if (millis() >= previous + INTERVAL) rusak saat millis() wrap; millis() - previous >= INTERVAL tidak.

delay() tersembunyi di tempat lain. Satu delay() di tugas mana pun menahan semua tugas lainnya.

millis() dalam int
void setup() {
  Serial.begin(9600);
}

void loop() {
  int now = millis();  // should be unsigned long
  Serial.println(now);
  delay(8000);
}

Buka sketch ini di editorKodenya saja: editor menempatkan board dan komponen yang bisa dibacanya dari sketch.

Buka rangkaian ini di editor. Arduino Uno: tiga lampu dengan tiga laju, tanpa delay(), dirangkai seperti yang berjalan di atas halaman ini. Ubah komponen atau nilainya dan jalankan lagi.

Pertanyaan

Apa fungsi millis() di Arduino?

Ia mengembalikan jumlah milidetik sejak board menyala, sebagai unsigned long. Ia tidak menjeda apa pun, jadi itulah cara sketch mengatur waktu sambil mengerjakan hal lain.

Bagaimana menjalankan banyak tugas dengan millis()?

Beri setiap tugas unsigned long sendiri untuk kapan terakhir dijalankan, dan di loop() periksa semuanya dengan if (millis() - last >= interval). Jauhkan delay() dari loop.

Apa bedanya millis() dan delay()?

delay() menghentikan sketch sampai waktunya habis. millis() hanya melaporkan waktu dan membiarkan sketch lanjut. Dengan delay(), tiga tekanan tombol cepat di sini hanya tertangkap satu; dengan millis(), ketiganya.

Kenapa timer millis() saya jadi negatif?

Nilainya disimpan dalam int, yang berbalik menjadi negatif setelah 32767 ms: -25536 pada detik ke-40 di sini. Gunakan unsigned long untuk millis() dan setiap waktu yang dihitung darinya.

Rakit versi nyatanya

Buka editor, ubah sebuah nilai, dan lihat angkanya ikut berubah. Tidak ada yang perlu dipasang, dan tidak perlu akun.