VL53L0X Arduino Kullanımı: Lazer Mesafe Sensörü ile 2 m Ölçüm
VL53L0X lazer mesafe sensörü Arduino, ESP32 ve Pico ile nasıl kullanılır? I2C bağlantısı, ölçüm modları, XSHUT ile çoklu sensör ve HC-SR04 karşılaştırması.
VL53L0X, Arduino ile mesafe ölçmenin en küçük ve en hassas yollarından biri olan ToF (Time of Flight, uçuş süresi) lazer mesafe sensörüdür. STMicroelectronics'in ürettiği bu yonga, gözle görülmeyen 940 nm'lik bir lazer ışığı gönderir, ışığın hedefe çarpıp geri dönme süresini ölçer ve sonucu doğrudan milimetre olarak verir. Pul büyüklüğündeki modül yalnızca I2C'nin iki veri kablosuyla bağlanır; varsayılan modda yaklaşık 1,2 metreye, uzun menzil modunda ise 2 metreye kadar ölçüm yapabilir.
Bu yazıda VL53L0X'in nasıl çalıştığını, Arduino Uno, ESP32 ve Raspberry Pi Pico'ya nasıl bağlandığını, dört ölçüm profili arasındaki farkı ve aynı I2C hattına birden fazla sensörü XSHUT pini ile nasıl bağlayacağını adım adım öğreneceksin. Ayrıca çok kullanılan ultrasonik HC-SR04 mesafe sensörü ile karşılaştırıp hangi projede hangisinin daha mantıklı olduğunu da göreceksin.
VL53L0X nedir, nasıl çalışır?
Sensörün içinde iki ana parça vardır: ışık yayan bir VCSEL (dikey yüzeyden ışık yayan lazer diyot) ve tek bir fotonu bile algılayabilen SPAD (tek foton çığ diyodu) dizisi. VCSEL çok kısa ışık darbeleri gönderir, SPAD dizisi geri dönen fotonları yakalar ve yonga aradaki süreyi ölçer. Mesafe basit bir formülle bulunur: d = c × t / 2. Burada c ışık hızıdır (yaklaşık 300.000 km/s) ve ışık yolu iki kez kat ettiği için sonuç ikiye bölünür. 1 metre uzaklıktaki bir nesne için gidiş-dönüş süresi yalnızca 6,67 nanosaniyedir. Bu kadar kısa bir süreyi tek darbeyle ölçmek imkânsıza yakın olduğu için yonga binlerce darbenin istatistiğini toplar ve hesaplamayı kendi içinde yapar; sen yalnızca hazır sonucu okursun.
Kullanılan lazer Sınıf 1 güvenlik sınıfındadır; normal kullanımda göz için tehlikeli değildir ve kızılötesi olduğu için çıplak gözle görünmez. Sensörün görüş açısı yaklaşık 25 derecedir, yani ölçüm dar bir koni içinde yapılır. Bu sayede HC-SR04'ün geniş ses dalgasına göre çok daha iyi nişan alınabilir; masanın kenarındaki küçük bir nesneyi bile yandaki duvara takılmadan ölçebilirsin. Sonuç, ışık hızına dayandığı için ortam sıcaklığından ve nemden neredeyse hiç etkilenmez.
| Özellik | Değer |
|---|---|
| Yonga | STMicroelectronics VL53L0X |
| Ölçüm prensibi | Uçuş süresi (ToF), 940 nm VCSEL lazer, Sınıf 1 |
| Menzil | Yaklaşık 3 cm – 1,2 m (varsayılan), 2 m'ye kadar (uzun menzil modu, karanlık ortam, beyaz hedef) |
| Çözünürlük | 1 mm |
| Doğruluk | Moda göre yaklaşık ±%3 – ±%5 |
| Görüş açısı | Yaklaşık 25° |
| Ölçüm süresi | 20 ms – 200 ms (zamanlama bütçesine göre) |
| Besleme | Yonga 2,6–3,5 V; modüllerin çoğu regülatörlü, 3,3–5 V |
| Akım | Ölçüm sırasında yaklaşık 19 mA, bekleme modunda birkaç µA |
| Arayüz | I2C, en fazla 400 kHz, varsayılan adres 0x29 |
| Pinler | VIN, GND, SCL, SDA, GPIO1 (kesme), XSHUT (kapatma) |
VL53L0X mi, HC-SR04 mü?
İki sensör de mesafe ölçer ama fizikleri tamamen farklıdır. HC-SR04 40 kHz'lik bir ses dalgası gönderir ve yankıyı dinler; ses yaklaşık 343 m/s hızla gittiği için zamanlama kolaydır ve menzil 4 metreye uzanır. Ancak geniş ses konisi yandaki nesneleri de algılar; kumaş, köpük ve eğik yüzeyler sesi yutar ya da saptırır. VL53L0X ise ışıkla ölçer: çok küçüktür, dar açıyla hedefe nişan alır, kısa mesafelerde daha kararlıdır ve I2C sayesinde tek hatta birçok sensör paylaşabilir. Buna karşılık doğrudan güneş ışığı, çok koyu ya da ayna gibi parlak yüzeyler ve cam onu zorlar. Kısa özet: 2 metrenin altında küçük ve hızlı bir ölçüm gerekiyorsa VL53L0X, daha uzun menzil ve dış mekân gerekiyorsa HC-SR04 daha mantıklıdır. Diğer seçenekler için mesafe sensörleri karşılaştırması yazısına bakabilirsin.
| Özellik | VL53L0X | HC-SR04 |
|---|---|---|
| Ölçüm prensibi | Lazer ışığın uçuş süresi (940 nm) | Ultrasonik ses yankısı (40 kHz) |
| Menzil | Yaklaşık 3 cm – 2 m | Yaklaşık 2 cm – 4 m |
| Ölçüm konisi | Yaklaşık 25°, dar ve düzenli | Yaklaşık 15° ölçüm açısı, ses daha geniş yayılır |
| Çözünürlük | 1 mm | Yaklaşık 3 mm (pratikte ±1 cm) |
| Bağlantı | I2C (SDA, SCL) | 2 dijital pin (Trig, Echo) |
| Çoklu sensör | XSHUT ile aynı I2C hattında | Her sensöre ayrı pin, birbirinin yankısını duyabilir |
| Besleme | 3,3–5 V (modül) | 5 V |
| Boyut | Yaklaşık 25 × 13 mm | Yaklaşık 45 × 20 mm |
| Zorlandığı durumlar | Siyah ya da ayna gibi yüzey, cam, güneş ışığı | Kumaş, köpük, eğik yüzey, gürültülü ortam |
VL53L0X bağlantısı: Arduino Uno, ESP32 ve Pico
Piyasadaki modüllerin çoğu (GY-530, GY-VL53L0XV2 gibi) üzerinde 2,8 V regülatör, I2C hatları için pull-up dirençleri ve XSHUT için bir pull-up direnci taşır. Bu sayede modülü Uno'nun 5V pinine de, ESP32 ve Pico'nun 3V3 pinine de bağlayabilirsin. Ucuz modüllerin çoğu Uno ile sorunsuz haberleşir; yine de uzun süre çalışacak projelerde I2C hatlarını korumak istersen bir lojik seviye dönüştürücü kullanabilirsin. I2C hattının mantığını merak ediyorsan I2C nedir yazısına göz at. GPIO1 pini, ölçüm bittiğinde sinyal veren bir kesme çıkışıdır; temel kullanımda bağlamana gerek yoktur.
| VL53L0X pini | Arduino Uno | ESP32 | Raspberry Pi Pico |
|---|---|---|---|
| VIN | 5V (ya da 3.3V) | 3V3 | 3V3(OUT) |
| GND | GND | GND | GND |
| SCL | A5 | GPIO 22 | GP5 |
| SDA | A4 | GPIO 21 | GP4 |
| XSHUT (isteğe bağlı) | D4 (2. sensörde D5) | GPIO 25 | GP6 |
| GPIO1 (isteğe bağlı) | Bağlanmaz | Bağlanmaz | Bağlanmaz |
Adım adım: Arduino ile ilk ölçüm
- Kabloları tabloya göre bağla: VIN → 5V, GND → GND, SDA → A4, SCL → A5.
- Sensörün üzerinde sarı ya da turuncu bir koruyucu bant varsa dikkatlice sök; bant ölçümü tamamen bozar.
- Arduino IDE'de Kütüphane Yöneticisi'ni aç, VL53L0X yaz ve Pololu imzalı kütüphaneyi kur. Adafruit_VL53L0X de çalışır ama ST'nin tam API'sini içerdiği için Uno'da çok daha fazla bellek kaplar. Kütüphane kurulumunda takılırsan Arduino kütüphane ekleme yazısına bak.
- Aşağıdaki kodu yükle ve Seri Monitörü 115200 baud hızında aç.
- Elini sensörün önünde yaklaştırıp uzaklaştır; değerlerin milimetre ve santimetre olarak değiştiğini gör.
1#include <Wire.h>
2#include <VL53L0X.h>
3
4VL53L0X sensor;
5
6void setup() {
7 Serial.begin(115200);
8 Wire.begin(); // Uno: SDA=A4, SCL=A5
9 sensor.setTimeout(500); // 500 ms cevap bekle / wait 500 ms for a reply
10 if (!sensor.init()) {
11 Serial.println(F("VL53L0X bulunamadi / not found"));
12 while (1) {}
13 }
14 sensor.startContinuous(); // sürekli ölçüm / continuous ranging
15}
16
17void loop() {
18 uint16_t mm = sensor.readRangeContinuousMillimeters();
19 if (sensor.timeoutOccurred()) {
20 Serial.println(F("Zaman asimi / Timeout"));
21 return;
22 }
23 if (mm > 2000) { // geçerli yansıma yok / no valid return
24 Serial.println(F("Menzil disi / Out of range"));
25 } else {
26 Serial.print(mm);
27 Serial.print(F(" mm = "));
28 Serial.print(mm / 10.0, 1);
29 Serial.println(F(" cm"));
30 }
31 delay(100);
32}| Komut | Ne yapar? |
|---|---|
| sensor.setTimeout(500) | Sensör 500 ms içinde cevap vermezse beklemeyi bırakır; kod sonsuza kadar takılmaz. |
| sensor.init() | ST'nin ayar dizisini yükler ve SPAD kalibrasyonunu yapar; false dönerse sensör I2C hattında bulunamamıştır. |
| sensor.startContinuous() | Sensörün arka arkaya, kesintisiz ölçüm yapmasını sağlar. |
| sensor.readRangeContinuousMillimeters() | En son ölçümü milimetre olarak döndürür; hedef yoksa 8190 civarı bir değer gelir. |
| sensor.timeoutOccurred() | Son okuma zaman aşımına uğradıysa true döner (bu durumda değer 65535 olur). |
VL53L0X ölçüm modları
VL53L0X'te ölçüm kalitesini üç ayar belirler: zamanlama bütçesi (bir ölçüme ayrılan süre), sinyal oranı sınırı (geçerli sayılacak en zayıf yansıma) ve VCSEL darbe periyodu (lazer darbelerinin uzunluğu). Bütçe arttıkça sensör daha çok foton toplar, ölçüm daha kararlı olur ama yavaşlar; 200 ms'lik bütçe saniyede yalnızca 5 ölçüm demektir. Sinyal sınırını varsayılan 0,25 MCPS'den 0,1 MCPS'ye düşürmek zayıf yansımaları da kabul ettirerek menzili uzatır, fakat hatalı okuma riskini artırır. Darbe periyodlarını varsayılan 14 ve 10 değerinden 18 ve 14'e çıkarmak ise uzaktaki hedefe daha fazla enerji gönderir. ST bu ayarları dört hazır profil olarak tanımlar; aşağıdaki kodda istediğin satırın başındaki yorum işaretini kaldırarak profili seçebilirsin. Uzun menzil ayarını hız ya da doğruluk ayarıyla birlikte de kullanabilirsin.
| Profil | Zamanlama bütçesi | Tipik menzil | Doğruluk | Ne zaman kullanılır? |
|---|---|---|---|---|
| Varsayılan | Yaklaşık 30 ms | 1,2 m | Yaklaşık ±%3–4 | Genel amaçlı ölçüm |
| Yüksek doğruluk | 200 ms | 1,2 m | ±%3'ün altında | Seviye ölçümü, hassas cetvel |
| Uzun menzil | 33 ms | 2 m | Yaklaşık ±%4 | Karanlık ortam, uzak hedef |
| Yüksek hız | 20 ms | 1,2 m | Yaklaşık ±%5 | Hızlı robot, el hareketi algılama |
1#include <Wire.h>
2#include <VL53L0X.h>
3
4VL53L0X sensor;
5
6// Profil seç: istediğin satırın yorumunu kaldır / Pick a profile: uncomment the line you want
7#define UZUN_MENZIL // uzun menzil / long range
8//#define YUKSEK_HIZ // yüksek hız / high speed
9//#define YUKSEK_DOGRULUK // yüksek doğruluk / high accuracy
10
11void setup() {
12 Serial.begin(115200);
13 Wire.begin();
14 sensor.setTimeout(500);
15 if (!sensor.init()) {
16 Serial.println(F("Sensor yok / No sensor"));
17 while (1) {}
18 }
19
20#if defined UZUN_MENZIL
21 sensor.setSignalRateLimit(0.1); // varsayılan 0.25 MCPS / default 0.25 MCPS
22 sensor.setVcselPulsePeriod(VL53L0X::VcselPeriodPreRange, 18); // varsayılan 14 / default 14
23 sensor.setVcselPulsePeriod(VL53L0X::VcselPeriodFinalRange, 14); // varsayılan 10 / default 10
24#endif
25
26#if defined YUKSEK_HIZ
27 sensor.setMeasurementTimingBudget(20000); // 20 ms
28#elif defined YUKSEK_DOGRULUK
29 sensor.setMeasurementTimingBudget(200000); // 200 ms
30#endif
31}
32
33void loop() {
34 Serial.print(sensor.readRangeSingleMillimeters()); // tek seferlik ölçüm / single-shot ranging
35 if (sensor.timeoutOccurred()) {
36 Serial.print(F(" ZAMAN ASIMI / TIMEOUT"));
37 }
38 Serial.println();
39}Birden fazla VL53L0X: XSHUT ile adres değiştirme
Her VL53L0X fabrikadan aynı 0x29 adresiyle çıkar ve bu adres kalıcı olarak değiştirilemez. Aynı hatta iki sensörü doğrudan bağlarsan ikisi de aynı anda cevap verir ve haberleşme bozulur. Çözüm XSHUT pinidir: XSHUT LOW iken sensör tamamen kapanır ve I2C hattında görünmez. Açılışta sensörleri tek tek uyandırıp her birine yazılımla yeni bir adres verirsin. Yeni adres yalnızca güç kesilene ya da XSHUT tekrar LOW olana kadar geçerlidir; bu yüzden bu işlem her açılışta setup() içinde yapılır. Bu yöntemle bir robota sol, orta ve sağ olmak üzere üç sensör takmak çok kolaydır; pratikte sınırı boştaki dijital pin sayın ve kabloların toplam uzunluğu belirler.
- Tüm sensörlerin VIN, GND, SDA ve SCL pinlerini ortak hatta bağla; her sensörün XSHUT pinini ayrı bir dijital pine (örnekte D4 ve D5) bağla.
- setup() başında bütün XSHUT pinlerini LOW yaparak tüm sensörleri kapat.
- 1. sensörü aç, init() ile başlat ve setAddress(0x30) ile yeni adresini ver.
- 2. sensörü aç, başlat ve 0x31 adresini ver; başka sensör varsa 0x32, 0x33 diye devam et.
- Tüm sensörlerde sürekli ölçümü başlat ve her birini kendi nesnesiyle oku.
1#include <Wire.h>
2#include <VL53L0X.h>
3
4const uint8_t XSHUT_1 = 4;
5const uint8_t XSHUT_2 = 5;
6
7VL53L0X sensor1;
8VL53L0X sensor2;
9
10void setup() {
11 Serial.begin(115200);
12 Wire.begin();
13
14 pinMode(XSHUT_1, OUTPUT);
15 pinMode(XSHUT_2, OUTPUT);
16 digitalWrite(XSHUT_1, LOW); // iki sensörü de kapat / shut down both sensors
17 digitalWrite(XSHUT_2, LOW);
18 delay(10);
19
20 pinMode(XSHUT_1, INPUT); // 1. sensörü aç, modülün pull-up direnci HIGH yapar / wake sensor 1, module pull-up pulls it HIGH
21 delay(10);
22 sensor1.setTimeout(500);
23 if (!sensor1.init()) {
24 Serial.println(F("Sensor 1 yok / Sensor 1 missing"));
25 while (1) {}
26 }
27 sensor1.setAddress(0x30); // yeni adres / new address
28
29 pinMode(XSHUT_2, INPUT); // 2. sensörü aç / wake sensor 2
30 delay(10);
31 sensor2.setTimeout(500);
32 if (!sensor2.init()) {
33 Serial.println(F("Sensor 2 yok / Sensor 2 missing"));
34 while (1) {}
35 }
36 sensor2.setAddress(0x31);
37
38 sensor1.startContinuous();
39 sensor2.startContinuous();
40}
41
42void loop() {
43 Serial.print(F("Sol / Left: "));
44 Serial.print(sensor1.readRangeContinuousMillimeters());
45 Serial.print(F(" mm Sag / Right: "));
46 Serial.print(sensor2.readRangeContinuousMillimeters());
47 Serial.println(F(" mm"));
48 delay(100);
49}ESP32 ile VL53L0X
ESP32'de aynı Pololu kütüphanesi değişiklik yapmadan çalışır. Varsayılan I2C pinleri GPIO 21 (SDA) ve GPIO 22 (SCL)'dir; Wire.begin(21, 22) ile bunları açıkça belirtmek, farklı kartlarda sürpriz yaşamanı önler. ESP32'nin pinleri 3,3 V olduğu için XSHUT'u doğrudan HIGH yapabilirsin; Uno'daki INPUT yöntemine gerek kalmaz. Aşağıdaki örnek 50 ms'lik bütçeyle ölçer, son 5 ölçümün ortalamasını alır ve nesne 15 cm'den yakına gelince kartın dahili LED'ini yakar. Ortalama almak, zıplayan değerleri yumuşatmanın en basit yoludur; daha gelişmiş yöntemler için sensör verisi filtreleme yazısına bakabilirsin. Mesafeyi telefondan izlemek istersen kodu ESP32 web sunucusu örneğiyle birleştirebilirsin.
1#include <Wire.h>
2#include <VL53L0X.h>
3
4const int SDA_PIN = 21;
5const int SCL_PIN = 22;
6const int LED_PIN = 2; // çoğu DevKit'te dahili LED / onboard LED on most DevKits
7const uint16_t ESIK_MM = 150; // uyarı eşiği / warning threshold
8const uint8_t N = 5; // ortalama için örnek sayısı / samples for averaging
9
10VL53L0X sensor;
11uint16_t olcumler[N];
12uint8_t sira = 0;
13
14uint16_t olc() {
15 uint16_t mm = sensor.readRangeContinuousMillimeters();
16 if (mm > 2000) mm = 2000; // menzil dışını sınırla / clamp out-of-range values
17 return mm;
18}
19
20void setup() {
21 Serial.begin(115200);
22 pinMode(LED_PIN, OUTPUT);
23 Wire.begin(SDA_PIN, SCL_PIN);
24 Wire.setClock(400000); // hızlı I2C / fast-mode I2C
25 sensor.setTimeout(500);
26 if (!sensor.init()) {
27 Serial.println("VL53L0X bulunamadi / not found");
28 while (true) delay(1000);
29 }
30 sensor.setMeasurementTimingBudget(50000); // 50 ms bütçe / 50 ms budget
31 sensor.startContinuous();
32 for (uint8_t i = 0; i < N; i++) olcumler[i] = olc(); // diziyi doldur / pre-fill the buffer
33}
34
35void loop() {
36 uint16_t mm = olc();
37 if (sensor.timeoutOccurred()) {
38 Serial.println("Zaman asimi / Timeout");
39 return;
40 }
41 olcumler[sira] = mm;
42 sira = (sira + 1) % N;
43
44 uint32_t toplam = 0;
45 for (uint8_t i = 0; i < N; i++) toplam += olcumler[i];
46 uint16_t ortalama = toplam / N;
47
48 digitalWrite(LED_PIN, ortalama < ESIK_MM ? HIGH : LOW);
49 Serial.printf("Ham / Raw: %u mm Ortalama / Average: %u mm\n", (unsigned)mm, (unsigned)ortalama);
50 delay(50);
51}Raspberry Pi Pico ve MicroPython ile VL53L0X
MicroPython'da VL53L0X için yerleşik bir modül yoktur; topluluğun hazırladığı vl53l0x.py sürücü dosyasını Thonny ile Pico'ya kopyalaman gerekir. Bu sürücüler ST'nin başlatma dizisini Python'a taşır ve genellikle start(), read() ve stop() fonksiyonlarını sunar; kullandığın sürücünün dosyasındaki fonksiyon adlarını bir kez kontrol et. Bağlantıda I2C0'ın GP4 (SDA) ve GP5 (SCL) pinlerini kullanıyoruz; tarama sonucunda 0x29 (ondalık 41) görmen gerekir. Kodda kullanılan Pin("LED") ifadesi MicroPython 1.20 ve sonrasında hem Pico hem Pico W'da dahili LED'i seçer. Pico'da birden fazla sensör kullanırken de aynı XSHUT mantığı geçerlidir; Pico 3,3 V ile çalıştığı için XSHUT pinlerini doğrudan HIGH yapabilirsin. MicroPython'a yeniysen önce MicroPython temelleri yazısına göz atabilirsin.
1from machine import Pin, I2C
2import time
3from vl53l0x import VL53L0X # vl53l0x.py Pico'da olmalı / must be on the Pico
4
5i2c = I2C(0, sda=Pin(4), scl=Pin(5), freq=400000)
6print("I2C:", [hex(a) for a in i2c.scan()]) # 0x29 görmelisin / you should see 0x29
7
8tof = VL53L0X(i2c) # varsayılan adres 0x29 / default address 0x29
9led = Pin("LED", Pin.OUT) # dahili LED (Pico ve Pico W) / onboard LED (Pico and Pico W)
10ESIK_MM = 150 # uyarı eşiği / warning threshold
11
12tof.start() # sürekli ölçüm / continuous ranging
13try:
14 while True:
15 mm = tof.read()
16 if mm > 2000:
17 print("Menzil disi / Out of range")
18 else:
19 print(mm, "mm")
20 led.value(1 if mm < ESIK_MM else 0)
21 time.sleep_ms(100)
22finally:
23 tof.stop() # ölçümü durdur / stop rangingDoğru ölçüm için ipuçları
- Hedefin rengi önemli: Beyaz ve mat yüzeyler ışığı iyi yansıtır; siyah, koyu gri ya da kadife gibi yüzeylerde menzil yarıya ya da daha azına düşebilir.
- Güneş ışığından kaçın: Güneş ışığında güçlü bir kızılötesi bileşen vardır ve sensörün arka plan gürültüsünü artırır. Dış mekânda sensörü gölgede tut ya da HC-SR04'ü tercih et.
- Kapak camına dikkat: Sensörü bir kutunun içine koyacaksan önüne konan cam ya da akrilik, ışığın bir kısmını geri yansıtır (crosstalk) ve ölçümü kısa gösterir. Kapak kullanacaksan ince, kızılötesi geçiren ve sensöre olabildiğince yakın bir malzeme seç.
- Ayna gibi parlak yüzeyler: Işık açılı bir parlak yüzeyden başka yöne sekebilir; sensörü yüzeye mümkün olduğunca dik tut.
- Küçük hedefler: 25 derecelik koni uzaklaştıkça genişler; 1 metrede yaklaşık 44 cm çapında bir alanı görür. Küçük bir nesneyi uzaktan ölçerken arkadaki duvar da sonuca karışabilir.
- Kabloları kısa tut: I2C hattı uzun kablolarda bozulur; 30 cm'yi aşan bağlantılarda hızı 100 kHz'e düşür ve kabloları motor kablolarından uzak geçir.
VL53L0X ile proje fikirleri
- Garaj park yardımcısı: Aracın duvara kalan mesafesini ölç, yaklaştıkça LED rengini değiştir. Ayrıntılı bir örnek için Arduino otopark sistemi yazısına bak.
- Temassız çöp kutusu ya da sabunluk: Elini 10 cm'ye yaklaştırınca servo kapağı açsın; akıllı çöp kutusu projesinde HC-SR04 yerine VL53L0X kullanabilirsin.
- Üç gözlü engelden kaçan robot: Sol, orta ve sağa birer sensör takıp XSHUT ile aynı hatta bağla; engelden kaçan robot çok daha akıllı dönüşler yapar.
- Mama ya da tahıl seviye göstergesi: Haznenin kapağına monte et ve kalan miktarı yüzde olarak göster; otomatik mama makinesi projesiyle iyi bir ikili olur.
- El hareketiyle dimmer: Elinin sensöre uzaklığını PWM ile LED parlaklığına çevir; 5 cm tam parlak, 30 cm kapalı gibi.
- Dijital cetvel: Ölçülen mesafeyi büyük rakamlarla bir OLED ekrana yazdır ve masaüstü bir ölçüm aletine dönüştür.
Sık yapılan hatalar ve çözümleri
| Belirti | Olası sebep | Çözüm |
|---|---|---|
| init() false dönüyor, sensör bulunamıyor | SDA ve SCL yer değiştirmiş, besleme yok ya da yanlış pin | I2C tarayıcıyla 0x29 adresini ara; Uno'da SDA = A4, SCL = A5 olduğunu kontrol et |
| Değerler sürekli 8190 civarında | Hedef menzil dışında, koruyucu bant sökülmemiş ya da yüzey çok koyu | Bandı sök, hedefi yaklaştır, uzun menzil profilini dene |
| Ölçüm birkaç santimetre kayık | Modül ofseti ya da önündeki kapak camı | Bilinen mesafede ölç, farkı koddan çıkar; kapağı kaldır ya da değiştir |
| Değerler sürekli zıplıyor | Kısa zamanlama bütçesi, ortam ışığı, küçük hedef | Bütçeyi 50–200 ms'ye çıkar, birkaç ölçümün ortalamasını al |
| 65535 ve zaman aşımı mesajı | Uzun ya da gevşek I2C kablosu, sensör resetlenmiş | Kabloları kısalt, bağlantıları sıkılaştır, sensörü yeniden başlat |
| İki sensörden biri hiç cevap vermiyor | Adres çakışması ya da XSHUT bağlantısı eksik | XSHUT pinlerini kontrol et, sensörleri sırayla açıp farklı adresler ver |
| Dışarıda ölçüm çok kısa kalıyor | Güneş ışığındaki kızılötesi gürültü | Sensörü gölgede tut, yüksek doğruluk profili kullan ya da HC-SR04'e geç |
VL53L0X, küçük boyutu, dar görüş açısı ve milimetre çözünürlüğüyle robotlardan temassız anahtarlara kadar pek çok projeye hassas bir göz ekler; doğru profili seçip ofseti düzelttiğinde ultrasonik sensörlerin zorlandığı kısa mesafelerde çok daha kararlı sonuçlar alırsın. BlueGrays uygulamasında mesafe ölçme, park sensörü, boy ölçer ve engelden kaçan robot projelerini adım adım devre şeması ve kodlarıyla inceleyebilir, aynı mantığı VL53L0X ile kendi projene kolayca uyarlayabilirsin.
Sıkça sorulan sorular
VL53L0X kaç metreye kadar ölçer?
Varsayılan ayarlarla güvenilir menzil yaklaşık 1,2 metredir. Uzun menzil profilinde, karanlık bir ortamda ve beyaz, iyi yansıtan bir hedefle 2 metreye kadar ölçebilir. Gri ya da koyu yüzeylerde ve güneş ışığında bu menzil belirgin şekilde kısalır.
VL53L0X mi HC-SR04 mü daha iyi?
Kullanım yerine bağlıdır. VL53L0X küçük, dar açılı ve 2 metrenin altında daha kararlıdır; I2C sayesinde birden fazla sensör aynı hatta kolayca bağlanır. HC-SR04 ise 4 metreye kadar ölçer, güneş ışığından etkilenmez ve camı algılar, ama kumaş gibi yumuşak yüzeylerde zorlanır.
VL53L0X I2C adresi nedir, nasıl değiştirilir?
Varsayılan 7 bitlik adres 0x29'dur; 8 bitlik gösterimde 0x52 olarak da yazılır. Adres setAddress() fonksiyonuyla yazılımla değiştirilir ama kalıcı değildir; güç kesilince ya da XSHUT LOW yapılınca 0x29'a döner. Birden fazla sensörde her açılışta XSHUT ile sırayla açıp adres vermen gerekir.
VL53L0X neden 8190 değeri gösteriyor?
Pololu kütüphanesi, sensör görüş alanında geçerli bir yansıma bulamadığında 8190 ya da 8191 gibi bir değer döndürür. Hedef menzil dışında olabilir, yüzey çok koyu olabilir ya da sensörün üzerindeki koruyucu bant sökülmemiş olabilir. 65535 değeri ise I2C zaman aşımı anlamına gelir; kabloları ve beslemeyi kontrol et.
VL53L0X güneş ışığında çalışır mı?
Çalışır ama performansı düşer. Güneş ışığı güçlü bir kızılötesi bileşen içerdiği için sensörün arka plan gürültüsü artar ve menzil yarıya ya da daha azına inebilir. Dış mekânda sensörü gölgede tutmak, yüksek doğruluk profilini seçmek ve kısa mesafelerde kullanmak işe yarar.
VL53L0X ile VL53L1X arasındaki fark nedir?
VL53L1X aynı ailenin daha yeni üyesidir; 4 metreye kadar ölçer ve görüş alanının yalnızca bir bölümünü (ROI) seçmene izin verir. VL53L0X ise 2 metreyle sınırlıdır ama daha ucuzdur ve kısa mesafeli projeler için fazlasıyla yeterlidir. İki sensörün kütüphaneleri farklı olduğu için kod birebir aktarılamaz.
Bu yazıdan sonra yapabileceğin projeler
Tüm projeleri gör
HC-SR04 Mesafe Ölçme (Serial Ekran)
Yarasalar karanlıkta yollarını nasıl buluyorsa HC-SR04 sensörü de öyle çalışır: duyamadığın bir ses gönderir, yankısını dinler ve önündeki cismin ne kadar uzakta olduğunu ölçer.

HC-SR04 ile Park Sensörü
Arabalardaki park sensörünün küçük bir benzeri: bir şey yaklaştıkça bip sesleri hızlanır.

LCD Ekran Kullanarak Mesafe Ölçme
Cetvelsiz mesafe ölçen bir alet: elini sensörün önünde ileri geri götür, sayı değişsin.

Boy Ölçüm Projesi
Kapı kasasına asılan ve altında duranın boyunu santimetre olarak söyleyen bir boy ölçer.

TCRT5000 ile Yansıma (Yakınlık) Okuma
Görünmez ışık yollayıp yansımasını ölçen küçük bir sensörle önündeki yüzeyi algılarsın.

Engelden Kaçan Robot
Kendi yolunu bulan akıllı bir araç yapmaya ne dersin? Engelden Kaçan Robot, önündeki ultrasonik sensör sayesinde çevresini sürekli tarar.

ESP32 HC-SR04 Ultrasonik Mesafe Ölçer
HC-SR04 ultrasonik sensör, gönderdiği ses dalgasının nesneye çarpıp geri dönme süresini (Time of Flight) ölçerek mesafe hesaplar. Bu projede ESP32 ile TRIG pinine 10 mikrosaniyelik darbe gönderip, ECHO pininden gelen yankı süresini pulseIn() ile okuyacağız. Hesaplanan mesafeyi cm cinsinden 16x2 I2C LCD'de göstereceğiz. HC-SR04 5V çalıştığı için ECHO pinine gerilim bölücü zorunludur — aksi halde ESP32'nin 3.3V GPIO'su zarar görür.

ESP32 Park Sensörü (HC-SR04 + 5 LED Bar + Buzzer + OLED)
Otomobil park sensörünün ESP32 versiyonu! HC-SR04 ultrasonik sensörle öndeki nesneye olan mesafeyi ölçüyoruz. Mesafe azaldıkça 5 LED'lik bar dolar (yeşil → sarı → kırmızı) ve buzzer'ın bip aralığı kısalır. Çok yaklaşınca (10 cm'nin altında) sürekli alarm çalar ve tüm LED'ler yanar. SSD1306 OLED ekranda büyük yazıyla anlık cm değeri ve durum metni gösterilir.
Diğer yazılar
BlueGrays uygulaması
Bu devreyi telefonunda adım adım kur
Devre şeması, kod ve parça listesi tek ekranda. 500'den fazla Arduino, ESP32 ve Pico projesi seni bekliyor.
Telefonunla tara
Kamerayı koda tut; telefonunun uygulama mağazası açılır.
ya da mağazada aç

