Dasar · 10 mnt baca

Cara memahami kode Arduino: membaca sketch baris demi baris

Cara memahami kode Arduino: library, definisi pin, setup dan loop, fungsi dan kondisi if, contoh sketch yang dibedah baris demi baris, ESP32 dan Pico.

Tahu cara memahami kode Arduino adalah pembeda antara menyalin sebuah proyek sambil berharap semuanya jalan dan benar-benar menjadikannya proyekmu sendiri. Hampir semua sketch yang kamu temukan di internet, di buku, atau dari teman mengikuti kerangka yang sama: library dan definisi pin di bagian atas, setup() yang berjalan sekali di tengah, loop() yang berjalan terus-menerus di bawahnya, dan kalau perlu beberapa fungsi buatan sendiri. Begitu mengenali kerangka itu, kamu bisa melihat kode yang belum pernah kamu temui dan berkata “baris ini membaca pin itu, dan dalam kondisi ini ia menyalakan motor itu”.

Di panduan ini kamu akan mempelajari metode langkah demi langkah untuk membaca kode Arduino. Pertama kamu akan mengenal bagian-bagian sebuah sketch dan tugas masing-masing, lalu kita akan membedah, baris demi baris, kode tempat sampah kecil yang tutupnya terbuka begitu ada tangan mendekat. Setelah itu kita bahas cara membaca variabel, kondisi, dan fungsi, menyesuaikan kode orang lain dengan rangkaianmu, serta memindahkan kode yang sama ke ESP32 dan Raspberry Pi Pico. Terakhir, kamu akan melihat cara berlatih dengan tab “Pahami kode” di BlueGrays.

Board Arduino Uno dan pin-pinnya
Setiap nomor pin di kode sesuai dengan label di board: baris const int TRIG_PIN = 9 memberi tahu bahwa kabelnya masuk ke lubang bertanda D9.

Anatomi sebuah sketch Arduino

Sketch Arduino selalu mengikuti urutan yang sama dari atas ke bawah. Compiler membaca file dari awal sampai akhir, tetapi board menjalankannya dengan urutan berbeda: deklarasi global disiapkan lebih dulu, lalu setup() berjalan sekali, kemudian loop() berulang selama board mendapat daya. Tabel berikut merangkum bagian-bagian yang akan kamu lihat begitu membuka sebuah sketch dan cara mengenalinya:

Bagian kodeFungsinyaBaris khasCara mengenalinya
KomentarMenjelaskan kode; diabaikan compiler// catatan atau /* ... */Diawali //, tampil abu-abu di IDE
LibraryMenambahkan kode siap pakai (servo, layar, sensor)#include <Servo.h>Diawali #, letaknya paling atas
Definisi pin dan konstantaMemberi nama pada nomor pin dan nilai ambangconst int LED_PIN = 13;Biasanya namanya HURUF BESAR
Variabel dan objek globalData yang bisa diakses dari mana saja di kodeint count = 0; Servo lidServo;Di luar semua fungsi
setup()Berjalan sekali ketika board dinyalakanpinMode(LED_PIN, OUTPUT);void setup() { ... }
loop()Berulang tanpa henti; pekerjaan utamanya ada di siniif (distance < 20) { ... }void loop() { ... }
Fungsi buatanmu sendiriMembungkus pekerjaan yang kamu ulang-ulanglong readDistanceCm() { ... }Blok terpisah di atas atau di bawah loop

Mulai membaca dari mana: metode lima langkah

  1. Baca komentar dan library-nya. Baris #include membocorkan hardware yang dipakai: Servo.h berarti servo, LiquidCrystal_I2C.h berarti LCD I2C, DHT.h berarti sensor suhu.
  2. Tulis definisi pin di kertas. Ubah setiap baris const int atau #define menjadi daftar pengkabelan seperti “TRIG = D9, ECHO = D10”, lalu bandingkan dengan rangkaianmu.
  3. Baca setup(). Di sinilah kamu melihat pin mana yang menjadi input dan output, kecepatan serial, dan kondisi awal board (servo tertutup, LED mati, dan sebagainya).
  4. Jalankan loop() sekali secara manual. Pilih satu nilai sensor (misalnya 45 cm) dan ikuti kodenya baris demi baris dengan nilai itu; catat blok if mana yang kamu masuki dan variabel mana yang berubah.
  5. Masuk ke fungsi kalau memang perlu. Begitu melihat pemanggilan seperti readDistanceCm() di dalam loop(), tebak dulu kegunaannya dari namanya, lalu buka fungsi itu untuk memeriksa tebakanmu.

Contoh sketch: bedah baris demi baris

Untuk latihan, kami memilih kode dari proyek sungguhan: sensor jarak HC-SR04 mendeteksi tangan yang mendekat, servo membuka tutup lalu menutupnya tiga detik kemudian, sebuah LED menyala selama itu, dan jumlah bukaan dicetak ke Serial Monitor. Sketch ini punya library, konstanta, variabel global, objek, setup, loop, kondisi, dan fungsi buatan sendiri. Lihat dulu keseluruhannya, lalu kita telusuri baris demi baris bersama tabel.

C++ (Arduino IDE)
1// Akıllı çöp kutusu: el yaklaşınca kapak açılır / Smart bin: the lid opens when a hand comes close
2#include <Servo.h>                  // servo kütüphanesi / servo library
3
4const int TRIG_PIN = 9;             // HC-SR04 TRIG
5const int ECHO_PIN = 10;            // HC-SR04 ECHO
6const int SERVO_PIN = 6;            // servo sinyal kablosu / servo signal wire
7const int LED_PIN = 13;             // durum LED'i / status LED
8const int OPEN_DISTANCE = 20;       // bundan yakınsa aç (cm) / open if closer than this (cm)
9const int OPEN_ANGLE = 90;          // açık kapak açısı / open lid angle
10const int CLOSED_ANGLE = 0;         // kapalı kapak açısı / closed lid angle
11
12Servo lidServo;                     // servo nesnesi / servo object
13int openCount = 0;                  // kaç kez açıldı / how many times it opened
14
15void setup() {
16  Serial.begin(9600);
17  pinMode(TRIG_PIN, OUTPUT);
18  pinMode(ECHO_PIN, INPUT);
19  pinMode(LED_PIN, OUTPUT);
20  lidServo.attach(SERVO_PIN);
21  lidServo.write(CLOSED_ANGLE);     // açılışta kapalı / closed at power-up
22}
23
24void loop() {
25  long distance = readDistanceCm(); // mesafeyi ölç / measure the distance
26  Serial.print("Mesafe / Distance: ");
27  Serial.println(distance);
28
29  if (distance > 0 && distance < OPEN_DISTANCE) {
30    openCount++;                    // sayacı bir artır / add one to the counter
31    digitalWrite(LED_PIN, HIGH);
32    lidServo.write(OPEN_ANGLE);     // kapağı aç / open the lid
33    delay(3000);                    // 3 sn açık kal / stay open for 3 s
34    lidServo.write(CLOSED_ANGLE);   // kapağı kapat / close the lid
35    digitalWrite(LED_PIN, LOW);
36    Serial.print("Acilma sayisi / Times opened: ");
37    Serial.println(openCount);
38  }
39  delay(100);                       // saniyede yaklaşık 10 ölçüm / about 10 readings per second
40}
41
42// Mesafeyi santimetre olarak döndürür / returns the distance in centimetres
43long readDistanceCm() {
44  digitalWrite(TRIG_PIN, LOW);
45  delayMicroseconds(2);
46  digitalWrite(TRIG_PIN, HIGH);     // 10 µs tetik darbesi / 10 µs trigger pulse
47  delayMicroseconds(10);
48  digitalWrite(TRIG_PIN, LOW);
49  long duration = pulseIn(ECHO_PIN, HIGH, 30000);  // en fazla 30 ms bekle / wait at most 30 ms
50  return duration / 58;             // µs'yi cm'ye çevir / convert µs to cm
51}
BarisFungsinyaApa yang terjadi kalau diubah?
#include <Servo.h>Menambahkan library Servo ke sketchKalau dihapus, compiler menampilkan “'Servo' does not name a type”
const int TRIG_PIN = 9;Memberi nama TRIG_PIN pada pin 9Kalau kabelnya dipindah, cukup ubah angka ini
const int OPEN_DISTANCE = 20;Jarak ambang untuk membuka tutupKalau diubah jadi 30, tutup terbuka dari jarak yang lebih jauh
Servo lidServo;Membuat objek servo bernama lidServoSemua baris berikutnya harus memakai nama yang sama
int openCount = 0;Penghitung global, nol ketika board dinyalakanKalau dipindah ke dalam loop(), nilainya direset di setiap putaran dan selalu mencetak 1
lidServo.attach(SERVO_PIN);Menghubungkan servo ke pin 6Kalau lupa, servo tidak akan pernah bergerak
long distance = readDistanceCm();Memanggil fungsi dan menyimpan hasilnyadistance hanya ada di dalam loop()
if (distance > 0 && distance < OPEN_DISTANCE)Masuk ke blok kalau kedua kondisi benardistance > 0 menyaring nilai 0 yang dikembalikan ketika tidak ada gema yang kembali
delay(3000);Membuat board menunggu 3 detikSelama itu Arduino tidak memeriksa hal lain
return duration / 58;Mengubah waktu gema menjadi sentimeterSuara menempuh perjalanan pergi-pulang, jadi 1 cm kira-kira 58 µs

Sekarang mari jalankan loop() secara manual dengan dua situasi berbeda. Ketika tidak ada siapa pun di depannya, sensor mengukur 45 cm: distance menjadi 45, Serial Monitor menampilkan “Mesafe / Distance: 45”, kondisi 45 < 20 bernilai salah sehingga bloknya dilewati, board menunggu 100 ms, dan loop() mulai lagi. Itu berulang sekitar sepuluh kali per detik. Dekatkan tanganmu sampai 12 cm dan kedua kondisi menjadi benar: openCount naik dari 0 ke 1, LED menyala, servo berputar ke 90 derajat, board menunggu tiga detik, tutup menutup, LED mati, dan Serial Monitor mencetak “Acilma sayisi / Times opened: 1”. Mengikuti kode dengan angka nyata seperti ini adalah cara paling andal untuk membacanya.

Perhatikan satu detail lagi: kalau pulseIn() tidak menerima gema dalam 30 ms, ia mengembalikan 0. Tanpa pemeriksaan distance > 0, nilai 0 yang terukur ketika sensor menghadap ruang kosong akan dianggap “kurang dari 20” dan tutup akan terbuka tanpa sebab. Kode yang ditulis dengan baik penuh dengan pemeriksaan kecil seperti ini; kalau kamu tidak paham kenapa sebuah baris ada di sana, hapus sementara dan lihat apa yang terjadi. Cara kerja sensornya bisa kamu baca di panduan sensor jarak HC-SR04, dan versi lengkap proyek ini dengan dua sensor ada di panduan tempat sampah pintar.

Variabel dan tipe data: label pada kotak

Variabel adalah kotak berlabel tempat kamu menaruh angka atau teks. Kata di awal baris menunjukkan jenis kotaknya, dengan kata lain apa yang muat di dalamnya. Di Arduino Uno, tipe yang salah menimbulkan bug yang tidak kelihatan: simpan millis() di dalam int, misalnya, dan angkanya berubah jadi negatif setelah sekitar 32 detik.

TipeRentang (Arduino Uno)Penggunaan umum
int-32.768 sampai 32.767Nomor pin, nilai analogRead, penghitung
longsekitar ±2,1 miliarDurasi pulseIn, angka besar
unsigned long0 sampai sekitar 4,29 miliarWaktu millis() dan micros()
floatBilangan desimal, presisi 6–7 digitPerhitungan suhu, tegangan, dan jarak
booltrue atau falseApakah sesuatu menyala atau mati?
byte0 sampai 255Nilai PWM, angka kecil
char / StringSatu karakter / teksPerintah dari port serial, teks untuk layar

Tempat sebuah variabel dideklarasikan juga penting; ini disebut scope atau cakupannya. Pada contoh tadi, openCount dideklarasikan di luar semua fungsi, jadi sifatnya global: nilainya tetap tersimpan setiap kali loop() berjalan. distance dideklarasikan di dalam loop(), jadi sifatnya lokal: ia dibuat di setiap putaran dan hilang begitu putaran selesai. Variabel yang diawali const adalah konstanta dan tidak bisa berubah selama program berjalan. Untuk pengantar yang lebih mendalam, lihat panduan dasar-dasar pemrograman Arduino, dan untuk menyimpan beberapa nilai dalam satu variabel, panduan array Arduino.

Cara membaca kondisi, perulangan, dan fungsi

  • if / else if / else: bacalah sebagai “jika ... maka lakukan ini, kalau tidak lakukan itu”. Kurung kurawal { } menunjukkan baris mana saja yang bergantung pada kondisi.
  • Perbandingan: == berarti “sama dengan”, != “tidak sama dengan”, < “lebih kecil dari”, >= “lebih besar dari atau sama dengan”. && berarti “dan”, || “atau”, ! “bukan”.
  • Perulangan for: baca for (int i = 0; i < 5; i++) sebagai “mulai i dari 0, ulangi selama i lebih kecil dari 5, tambah satu setiap kali”; bloknya berjalan 5 kali.
  • Perulangan while: while (digitalRead(BUTTON_PIN) == HIGH) dibaca “tunggu selama tombol belum ditekan”; kalau kondisinya tidak pernah berubah, kode akan macet di situ.
  • switch / case: program mengambil jalur berbeda bergantung pada nilai sebuah variabel; kalau break di akhir sebuah case terlupa, case berikutnya ikut berjalan.
  • Definisi fungsi: pada long readDistanceCm(), long adalah tipe nilai yang dikembalikan, readDistanceCm adalah namanya, dan kurung kosong berarti fungsi itu tidak menerima parameter. Fungsi yang diawali void tidak mengembalikan apa pun; ia hanya mengerjakan sebuah tugas.
Ada dua jebakan yang mudah terlewat ketika membaca kode. if (x = 5) bukan perbandingan, melainkan pemberian nilai 5 ke x, sehingga kondisinya selalu benar; bentuk yang benar adalah if (x == 5). Kedua, titik koma di akhir if (distance < 20); membatalkan kondisinya, dan blok di bawahnya berjalan di setiap putaran. Compiler tidak memberi error untuk keduanya, jadi baca baris-baris seperti ini dengan ekstra teliti.

Mengenali fungsi library

Pada baris seperti lidServo.write(90), tanda titik memberi tahu bahwa fungsi write adalah milik objek lidServo: “lidServo, bergeraklah ke 90 derajat”. Ada tiga cara mudah untuk mengetahui apa yang dilakukan sebuah fungsi library: di Arduino IDE 2, arahkan kursor ke fungsinya untuk membaca deskripsinya atau klik kanan lalu pilih Go to Definition; buka contoh bawaan library itu dari File > Examples; atau lihat daftar fungsi di file .h milik library tersebut. Cara memasang library kami jelaskan di panduan cara menambahkan library Arduino. Berikut fungsi-fungsi dasar yang akan kamu temui di hampir setiap sketch:

FungsiKegunaannyaContoh
pinMode(pin, mode)Menjadikan sebuah pin sebagai input atau outputpinMode(13, OUTPUT);
digitalWrite(pin, nilai)Mengatur output ke 5 V (HIGH) atau 0 V (LOW)digitalWrite(13, HIGH);
digitalRead(pin)Membaca apakah sebuah input HIGH atau LOWdigitalRead(2)
analogRead(pin)Mengubah 0–5 V menjadi angka dari 0 sampai 1023analogRead(A0)
analogWrite(pin, 0–255)Mengatur kecerahan LED atau kecepatan motor dengan PWManalogWrite(9, 128);
delay(ms)Menghentikan board sementara selama waktu yang ditentukandelay(1000);
millis()Milidetik sejak board dinyalakanif (millis() - last > 500)
Serial.begin / print / printlnMengirim teks ke Serial MonitorSerial.println(distance);
map(x, a, b, c, d)Menskalakan satu rentang nilai ke rentang lainmap(value, 0, 1023, 0, 180)
pulseIn(pin, HIGH)Mengukur panjang sebuah pulsa dalam µspulseIn(10, HIGH, 30000)

Untuk daftar lengkap beserta contoh terperinci, lihat panduan perintah Arduino kami. Memahami perbedaan delay() dan millis() termasuk hal paling berguna untuk membaca sketch; panduan millis vs delay menjelaskannya dengan contoh.

Menyesuaikan kode orang lain dengan rangkaianmu

  1. Buat tabel pengkabelan dari kodenya. Tulis semua konstanta pin berurutan ke bawah; daftar itu adalah rangkaian milik orang yang menulis kodenya.
  2. Bandingkan dengan rangkaianmu sendiri. Kalau kamu memakai pin berbeda, jangan pindahkan kabelnya: ubah saja angka di baris const dan biarkan sisa kodenya.
  3. Periksa perbedaan library. Dua library dengan nama yang sama bisa memakai fungsi berbeda; pada LCD I2C, alamat 0x27 versus 0x3F juga menjadi ketidakcocokan yang paling sering terjadi.
  4. Waspadai active LOW dan active HIGH. Sebagian besar modul relay aktif dengan LOW; kalau kodenya menyalakan sesuatu dengan HIGH, relay-mu akan melakukan kebalikannya.
  5. Samakan kecepatan serial. Kalau di kode ada Serial.begin(115200), pilih 115200 juga di Serial Monitor, kalau tidak kamu hanya akan melihat karakter acak.
  6. Uji bagian demi bagian. Jalankan dulu bagian yang membaca sensor saja, lalu tambahkan motor dan layar setelah nilainya terlihat benar.
Serial Monitor adalah senter yang kamu sorotkan ke dalam kodemu. Kalau kamu tidak tahu kenapa sebuah kondisi tidak terpenuhi, tambahkan baris seperti Serial.println(distance) tepat sebelum if dan lihat nilai mana yang sebenarnya dibandingkan. Selengkapnya ada di panduan Serial Monitor Arduino kami.

Memindahkan kode yang sama ke ESP32

ESP32 juga diprogram dengan Arduino IDE, jadi sebagian besar kodenya berjalan apa adanya; yang berubah adalah nomor pin, level tegangan, dan beberapa library. Tabel berikut memuat hal-hal yang perlu diperiksa ketika memindahkan kode Arduino Uno ke ESP32:

TopikArduino UnoESP32Yang perlu dilakukan
Nama pinD2–D13, A0–A5Nomor GPIOGanti konstantanya dengan nomor GPIO; hati-hati dengan 6–11 dan 34–39
Tegangan kerja5 V3,3 VPasang pembagi tegangan pada sensor dengan output 5 V (ECHO HC-SR04)
analogRead10 bit, 0–102312 bit, 0–4095Hitung ulang nilai ambang dan rentang map() untuk rentang empat kali lebih besar
Library servoServo.hESP32Servo.hGanti library-nya dan beri attach rentang pulsanya
Kecepatan serialBiasanya 9600Biasanya 115200Samakan Serial.begin dan Serial Monitor
MemoriRAM 2 KBRAM sekitar 320 KBArray besar dan String tidak lagi jadi masalah
C++ (Arduino IDE)
1// ESP32 sürümü: değişen satırlar işaretli / ESP32 version: changed lines are marked
2#include <ESP32Servo.h>             // DEĞİŞTİ: Servo.h yerine / CHANGED: instead of Servo.h
3
4const int TRIG_PIN = 26;            // DEĞİŞTİ / CHANGED
5const int ECHO_PIN = 27;            // DEĞİŞTİ: 1k/2k bölücüyle / CHANGED: through a 1k/2k divider
6const int SERVO_PIN = 18;           // DEĞİŞTİ / CHANGED
7const int LED_PIN = 2;              // DEĞİŞTİ: çoğu DevKit'te dahili LED / CHANGED: onboard LED on most DevKits
8const int OPEN_DISTANCE = 20;
9const int OPEN_ANGLE = 90;
10const int CLOSED_ANGLE = 0;
11
12Servo lidServo;
13int openCount = 0;
14
15void setup() {
16  Serial.begin(115200);             // DEĞİŞTİ: ESP32'de yaygın hız / CHANGED: common ESP32 speed
17  pinMode(TRIG_PIN, OUTPUT);
18  pinMode(ECHO_PIN, INPUT);
19  pinMode(LED_PIN, OUTPUT);
20  lidServo.setPeriodHertz(50);      // EKLENDİ: standart servo 50 Hz / ADDED: standard servo 50 Hz
21  lidServo.attach(SERVO_PIN, 500, 2400);  // DEĞİŞTİ: darbe aralığı µs / CHANGED: pulse range in µs
22  lidServo.write(CLOSED_ANGLE);
23}
24
25void loop() {
26  long distance = readDistanceCm();
27  Serial.print("Mesafe / Distance: ");
28  Serial.println(distance);
29
30  if (distance > 0 && distance < OPEN_DISTANCE) {
31    openCount++;
32    digitalWrite(LED_PIN, HIGH);
33    lidServo.write(OPEN_ANGLE);
34    delay(3000);
35    lidServo.write(CLOSED_ANGLE);
36    digitalWrite(LED_PIN, LOW);
37    Serial.print("Acilma sayisi / Times opened: ");
38    Serial.println(openCount);
39  }
40  delay(100);
41}
42
43long readDistanceCm() {
44  digitalWrite(TRIG_PIN, LOW);
45  delayMicroseconds(2);
46  digitalWrite(TRIG_PIN, HIGH);
47  delayMicroseconds(10);
48  digitalWrite(TRIG_PIN, LOW);
49  long duration = pulseIn(ECHO_PIN, HIGH, 30000);
50  return duration / 58;
51}

Seperti yang kamu lihat, loop() dan readDistanceCm() pindah tanpa berubah satu huruf pun; semua yang berubah ada di bagian atas file dan di setup(). Itu tanda kode yang ditulis dengan baik: detail hardware dikumpulkan di atas dan logika di bawahnya tetap bersih. Karena pin ECHO HC-SR04 mengeluarkan 5 V, sinyalnya harus sampai ke ESP32 lewat pembagi tegangan 1 kΩ dan 2 kΩ; servo sebaiknya diberi daya dari 5 V di pin VIN, bukan dari 3,3 V. Perbedaan lain di antara kedua board kami bandingkan di panduan Arduino vs ESP32.

Logika yang sama di Raspberry Pi Pico: MicroPython

Kalau kamu memprogram Pico dengan MicroPython, kodenya tampak berbeda tetapi logikanya sama. Kamu menulis import sebagai ganti #include, dan indentasi menggantikan kurung kurawal. Tidak ada kata kunci setup() dan loop(): baris-baris di bagian atas file berjalan sekali (bagian setup) dan blok while True: berjalan terus-menerus (bagian loop). Fungsi diawali def, bukan void atau long. Sandingkan kode ini dengan sketch Arduino di atas dan kamu akan menemukan padanan setiap barisnya:

MicroPython
1from machine import Pin, PWM, time_pulse_us   # #include karşılığı / the #include part
2import time
3
4TRIG = Pin(14, Pin.OUT)              # HC-SR04 TRIG
5ECHO = Pin(15, Pin.IN)               # HC-SR04 ECHO, bölücüyle / through a divider
6LED = Pin(25, Pin.OUT)               # Pico dahili LED; Pico W'de Pin("LED") / onboard LED; Pin("LED") on Pico W
7servo = PWM(Pin(16))
8servo.freq(50)                       # servo 50 Hz ister / servos need 50 Hz
9
10OPEN_DISTANCE = 20                   # cm
11
12
13def set_angle(angle):
14    pulse_us = 500 + angle * 2000 // 180            # 0 derece 0,5 ms, 180 derece 2,5 ms / 0 deg 0.5 ms, 180 deg 2.5 ms
15    servo.duty_u16(pulse_us * 65535 // 20000)       # 20 ms periyodun oranı / share of the 20 ms period
16
17
18def read_distance_cm():
19    TRIG.low()
20    time.sleep_us(2)
21    TRIG.high()                      # 10 µs tetik darbesi / 10 µs trigger pulse
22    time.sleep_us(10)
23    TRIG.low()
24    duration = time_pulse_us(ECHO, 1, 30000)        # zaman aşımında negatif / negative on timeout
25    if duration < 0:
26        return 0
27    return duration // 58
28
29
30set_angle(0)                         # setup() karşılığı / the setup() part
31open_count = 0
32
33while True:                          # loop() karşılığı / the loop() part
34    distance = read_distance_cm()
35    print("Mesafe / Distance:", distance)
36    if 0 < distance < OPEN_DISTANCE:
37        open_count += 1
38        LED.on()
39        set_angle(90)
40        time.sleep(3)
41        set_angle(0)
42        LED.off()
43        print("Acilma sayisi / Times opened:", open_count)
44    time.sleep_ms(100)

Karena di sini Python tidak punya library Servo, fungsi set_angle() sendiri yang mengubah sudut menjadi panjang pulsa: servo menentukan posisinya dari pulsa 0,5–2,5 ms yang datang setiap 20 ms. Penulisan 0 < distance < OPEN_DISTANCE adalah bentuk singkat Python untuk kondisi C++ distance > 0 && distance < OPEN_DISTANCE. Kalau kamu baru mengenal MicroPython, panduan dasar-dasar MicroPython kami membahas aturan indentasi, variabel, dan fungsi.

Berlatih dengan “Pahami kode” di BlueGrays

Di aplikasi BlueGrays, layar kode setiap proyek juga punya tab “Pahami kode”. Bagian “Kode ini ngapain?” lebih dulu merangkum tugas program dalam beberapa kalimat. “Langkah demi langkah” kemudian memecah kode menjadi potongan-potongan kecil dan menjelaskan di bawah tiap potongan untuk apa baris-baris itu dan apa yang terjadi kalau kamu mengubahnya. “Kalau mentok” memuat masalah yang paling sering muncul dalam bentuk gejala dan solusi, dan “Coba sendiri” memberimu tugas kecil lengkap dengan petunjuk dan solusinya, misalnya mengubah nilai ambang lampu tidur supaya LED menyala lebih awal. Metode lima langkah dari panduan ini juga bisa kamu pakai di sana: baca ringkasannya, cocokkan tiap potongan dengan rangkaianmu, lalu selesaikan tugasnya dengan mengubah kodenya sendiri.

Latihan untuk membaca kode

  • Tebak dulu, lalu uji: sebelum mengubah sebuah konstanta, tuliskan apa yang kamu perkirakan, lalu upload kodenya dan periksa tebakanmu.
  • Jadikan satu baris komentar: taruh // di depan sebuah baris lalu upload lagi; apa pun yang rusak menunjukkan untuk apa baris itu ada.
  • Jelaskan dengan kata-katamu sendiri: ubah setiap baris loop() menjadi kalimat biasa; baris yang tidak bisa kamu ungkapkan dengan kata-kata adalah baris yang belum kamu pahami.
  • Gambar diagram alir: gambarkan setup, loop, pernyataan if, dan pemanggilan fungsi sebagai kotak dan panah; ini sangat membantu untuk kode yang memakai state machine.
  • Buat kesalahan dengan sengaja: hapus satu titik koma dan baca pesan dari compiler; panduan error kompilasi Arduino kami menjelaskan pesan-pesan yang paling umum.

Kesalahan umum ketika membaca kode

KesalahanKenapa jadi masalahPendekatan yang benar
Menganggap kode sebagai daftar yang berjalan sekali dari atas ke bawahloop() berulang selamanya dan variabel berubah dari putaran ke putaranIkuti loop() selama beberapa putaran dengan nilai berbeda
Tertukar antara = dan ==if (x = 5) selalu benarSelalu pakai == untuk membandingkan
Melewatkan pembagian bilangan bulat5 / 2 menghasilkan 2; bagian desimalnya dibuangKalau butuh desimal, tulis 5.0 / 2 atau pakai float
Lupa bahwa delay() menghentikan semuanyaTombol dan sensor tidak dibaca selama menungguPakai pewaktuan millis() kalau beberapa tugas berjalan bersamaan
Mengabaikan perbedaan versi libraryFungsi yang sama bisa punya nama lain di versi yang lebih baruCari di komentar, kode itu ditulis dengan library yang mana
Mengubah konstanta pin tetapi kabelnya tidakKode membaca pin yang benar, kabelnya ada di tempat lainPerbarui tabel pengkabelanmu setelah setiap perubahan
Kalau sebuah sketch terlihat sulit, mulailah dengan menulis ulang dalam bahasa sehari-hari: “Ukur jaraknya. Kalau lebih dari 0 dan kurang dari 20, tambah satu ke penghitung, nyalakan LED, buka tutup, tunggu 3 detik, tutup kembali, matikan LED. Tunggu 100 ms lalu mulai lagi.” Ini disebut pseudocode, dan inilah cara tercepat untuk menangkap jalan pikiran orang yang menulis programnya.

Membaca kode, sama seperti membaca skema rangkaian, makin cepat dengan setiap contoh yang kamu lihat. Untuk memulai, buka proyek-proyek pendek di aplikasi BlueGrays seperti menyalakan LED, lampu lalu lintas, LED yang dikendalikan tombol, atau lampu tidur LDR, lalu ikuti tab “Pahami kode” baris demi baris; masing-masing dilengkapi skema rangkaian, penjelasan kode potongan demi potongan, dan sebuah tugas kecil untukmu.

Pertanyaan umum

Kode Arduino ditulis dengan bahasa apa?

Kode Arduino berbasis C dan C++. Arduino menambahkan fungsi siap pakai seperti pinMode dan digitalWrite supaya lebih mudah, tetapi aturan untuk pernyataan if, perulangan for, variabel, dan fungsi adalah C++ murni. Karena itulah sedikit pengetahuan C++ membuat kode Arduino jauh lebih mudah dibaca.

Apa perbedaan setup dan loop?

setup() hanya berjalan sekali, ketika board dinyalakan atau di-reset, dan dipakai untuk persiapan seperti mengatur pin dan komunikasi serial. Setelah itu loop() berulang tanpa henti selama board mendapat daya; di situlah pekerjaan utamanya berlangsung, seperti membaca sensor, mengambil keputusan, dan menggerakkan motor.

Apa arti void di Arduino?

void berarti sebuah fungsi tidak mengembalikan nilai. void setup() dan void loop() mengerjakan sesuatu tetapi tidak menyerahkan hasil apa pun. Sebaliknya, fungsi seperti long readDistanceCm() mengembalikan nilai dengan tipe yang tertulis di depan namanya lewat return.

Kenapa kodeku berhasil dikompilasi tetapi rangkaiannya tidak bekerja?

Compiler hanya memeriksa sintaks; nomor pin yang salah, modul yang terpasang terbalik, atau nilai ambang yang keliru tidak akan memunculkan error kompilasi. Bandingkan konstanta pin di kode dengan rangkaianmu dan pantau nilainya dengan Serial.println di Serial Monitor; masalahnya biasanya ada di pengkabelan atau nilai ambang.

Bisakah kode Arduino dipakai di ESP32?

Sering kali bisa: ESP32 juga diprogram dengan Arduino IDE dan fungsi-fungsi dasarnya sama. Kamu perlu mengganti nomor pin dengan nomor GPIO, menurunkan sinyal 5 V ke 3,3 V, dan mengganti beberapa library, seperti Servo, dengan versi ESP32-nya. Ingat juga bahwa analogRead mengembalikan nilai dari 0 sampai 4095.

Di mana aku bisa menemukan contoh kode Arduino?

Menu File > Examples di Arduino IDE adalah titik awal yang bagus, begitu juga contoh yang disertakan di setiap library yang kamu pasang. Proyek-proyek di aplikasi BlueGrays juga dilengkapi skema rangkaian dan kode yang dijelaskan baris demi baris. Dari mana pun kodenya berasal, membacanya sekali dengan metode di panduan ini sebelum meng-upload membantumu menangkap kesalahan sejak awal.

Lihat semua proyek
LED Berkedip
AR-1Pemula

LED Berkedip

"Halo" pertama di dunia elektronika: menyalakan dan mematikan satu LED. Arduino menyalakan dan mematikan LED dengan jeda singkat, sehingga cahayanya berkedip cepat.

4.6(200)
1246
Lampu Lalu Lintas
AR-3Pemula

Lampu Lalu Lintas

Tiruan mini lampu lalu lintas yang kamu lihat di jalan setiap hari. Merah menyala dua detik, kuning menyala sebentar, hijau menyala dua detik, lalu kembali ke merah lewat kuning lagi, terus berulang.

4.8(137)
440
Kendali LED dengan Tombol Tekan (Tekan)
AR-9Pemula

Kendali LED dengan Tombol Tekan (Tekan)

Persis seperti bel pintu: lampu tetap menyala selama kamu menekan, dan mati ketika kamu melepasnya. Arduino terus mendengarkan tombol; selama ditekan LED menyala, dan begitu jarimu terangkat LED mati.

4.8(114)
253
Lampu Tidur dengan LDR
AR-12Pemula

Lampu Tidur dengan LDR

Lampu tidur kecil yang menyala sendiri ketika gelap dan mati ketika pagi tiba. Sensor cahaya mengukur seberapa terang ruangan, dan Arduino menyalakan LED ketika cukup gelap lalu mematikannya lagi…

4.7(105)
224
Pengukuran Jarak HC-SR04 (Tampilan Serial)
AR-27Pemula

Pengukuran Jarak HC-SR04 (Tampilan Serial)

Sensor HC-SR04 bekerja persis seperti kelelawar yang mencari jalan dalam gelap: ia mengirim suara yang tidak bisa kamu dengar, mendengarkan pantulannya, dan mengukur seberapa jauh benda di depannya.

4.6(50)
82
Suhu dan Kelembapan dengan DHT11
AR-55Menengah

Suhu dan Kelembapan dengan DHT11

Seberapa hangat kamarmu, dan apakah udaranya lembap atau kering? Sensor DHT11 mengukur suhu dan kelembapan, dan Arduino menulis nilainya di layar LCD dua baris, diperbarui setiap beberapa detik.

4.7(47)
83
Sensor Parkir dengan HC-SR04
AR-28Menengah
Premium

Sensor Parkir dengan HC-SR04

Versi mini sensor parkir mobil: makin dekat sesuatu, makin cepat bunyi bipnya. Sensor jarak mengukur benda di depannya; jika jaraknya lebih dari 20 sentimeter LED hijau tetap menyala, dan begitu…

4.8(64)
86
Menggerakkan Motor Servo dengan Potensiometer
AR-36Pemula
Premium

Menggerakkan Motor Servo dengan Potensiometer

Ketika kamu memutar kenop potensiometer, lengan motor servo ikut berputar: satu ujung kenop berarti nol derajat, ujung lainnya berarti setengah putaran.

4.6(37)
53