Təmassız maye səviyyə sensoru XKC-Y25: Arduino qoşulması və kod
Təmassız maye səviyyə sensoru XKC-Y25: kapasitiv aşkarlama, divar qalınlığı, NPN/PNP çıxış və MODE naqili, 5–24 V, Arduino, çoxsəviyyəli nasos idarəsi.
Təmassız maye səviyyə sensoru çənin içinə heç bir hissə salmadan, plastik və ya şüşə divarın kənarına yapışdırılaraq mayenin həmin hündürlüyə çatıb-çatmadığını aşkarlayan sensordur. Bu işin ən geniş yayılmış və ən ucuz nümunəsi XKC-Y25-dir: diametri 28 mm, ağ plastik gövdəli, dörd naqilli kiçik disk. Mayeyə heç toxunmadığı üçün paslanmır, əhəng çöküntüsü yaratmır, içməli suyu çirkləndirmir və turşu, qəhvə, süd kimi təmizlənməsi çətin mayelərlə belə illərlə problemsiz işləyir. Arduino setlərindəki çəngəlşəkilli su səviyyə sensorlarının bir neçə həftə ərzində korroziyaya uğraması problemi üçün ən təmiz həlldir.
Bu bələdçidə XKC-Y25-in divarın arxasındakı mayeni kapasitiv üsulla necə hiss etdiyini, hansı materiallarda və hansı divar qalınlığına qədər işlədiyini öyrənəcəksən. Gərginlik çıxışlı, NPN və PNP versiyalar arasındakı fərqi, naqillərin rənglərini və çıxış məntiqini müəyyən edən qara MODE naqilini ətraflı nəzərdən keçirəcəyik. Sonra sensoru Arduino Uno-ya qoşub ilk kodu yazacaq, üç sensorla çəni faiz səviyyələrinə bölən və nasosu özbaşına idarə edən sistem quracağıq. Üzgəcli açarla müqayisə, qəhvə maşını və akvarium tətbiqləri, ESP32 və Raspberry Pi Pico kodları da yazının sonundadır.

Təmassız maye səviyyə sensoru nədir, necə işləyir?
XKC-Y25 kapasitiv sensordur. Gövdəsinin ön üzündə elektrod var və bu elektrod ətrafla birlikdə kiçik bir kondensator yaradır. Divarın arxasında yalnız hava olanda bu tutum müəyyən qiymətdə olur. Maye qalxıb sensorun səviyyəsinə çatanda maye də bu kondensatorun bir hissəsi olur və tutum artır. Suyun dielektrik sabiti təxminən 80-dir, havanınkı isə 1; buna görə su gələndə tutumdakı dəyişiklik çox nəzərəçarpandır. Sensorun içindəki mikrosxem bu dəyişikliyi fasiləsiz ölçür, təyin olunmuş həddi keçəndə çıxışını dəyişir. Elektrik sahəsi plastik, şüşə və keramika kimi izolyator materiallardan keçə bildiyi üçün sensor mayeyə toxunmadan işləyir; metal isə sahəni ekranlaşdırdığından metal çəndə kənardan ölçmə aparmaq olmur. Satıcıların ən çox satdığı XKC-Y25-V və XKC-Y25-T12V versiyalarının istehsalçı dəyərləri belədir:
| Xüsusiyyət | XKC-Y25 (gərginlik çıxışlı versiya) |
|---|---|
| Qida gərginliyi | 5–24 V DC |
| Cərəyan istehlakı | Təxminən 5 mA |
| Çıxış | Yüksək səviyyə = qida gərginliyi, aşağı səviyyə = 0 V |
| Çıxış cərəyanı | 1–50 mA |
| Cavab müddəti | Təxminən 500 ms |
| Aşkarlama üçün divar qalınlığı | 0–20 mm (etibarlı iş üçün 12 mm-ə qədər tövsiyə olunur) |
| İşçi temperatur | 0–100 °C |
| Qoruma sinfi | IP67, ABS gövdə |
| Ölçü | Diametri 28 mm, dərinliyi təxminən 17 mm |
| Həssaslıq ayarı | Arxa qapağın altındakı trimmer |
Divar qalınlığı, material və maye növü
Sensorun ən çox verilən sualı divar qalınlığı həddidir. İstehsalçı 20 mm-ə qədər aşkarlama göstərsə də, etibarlı və sabit nəticə üçün divarın 12 mm-dən nazik olması tövsiyə olunur. Hobbi layihələrindəki pet şüşələr, plastik bidonlar (1–3 mm), akvarium şüşələri (4–10 mm) və PVC borular rahatlıqla bu həddin daxilindədir. Sensorun ön üzü divara tam və düz toxunmalıdır; arada hava boşluğu həssaslığı ciddi şəkildə azaldır. Buna görə silindr formalı çənlərdə sensoru şaquli xətt boyunca, tercihən köpüksüz ikitərəfli lent və ya isti silikonla bərkit. Mayenin növü də vacibdir: su, meyvə şirəsi, qəhvə, süd və duzlu su kimi su əsaslı mayelər asanlıqla aşkarlanır. Yağların dielektrik sabiti isə cəmi 2–3 civarındadır; bu mayelərdə sensorun həssaslığı ən yüksəyə qoyulsa belə, çox vaxt etibarlı işləmir.
| Vəziyyət | Aşkarlayır? | Qeyd |
|---|---|---|
| Plastik çən (PE, PP, PVC, akril), 1–10 mm | Bəli | Ən geniş yayılmış və ən problemsiz istifadə |
| Şüşə banka, akvarium şüşəsi | Bəli | 10 mm-ə qədər rahatdır; qalın şüşədə həssaslığı artır |
| Keramika | Bəli | Divar düz və nazik olmalıdır |
| Metal çən və ya paslanmayan polad qazan | Xeyr | Metal sahəni ekranlaşdırır; çənə plastik müşahidə borusu əlavə et |
| 12–20 mm qalın plastik | Sərhəddə | Həssaslığı artır, yanlış işə düşməni yoxla |
| Su, qəhvə, süd, duzlu su | Bəli | Yüksək dielektrik sabiti |
| Yağ, benzin, spirt faizi yüksək maye | Çətin və ya xeyr | Dielektrik sabiti aşağıdır |
| Toz və qranul (şəkər, yem) | Bəzən | Nəm və sıx tozlarda işləyə bilər, mütləq yoxla |
Naqillər, çıxış növləri və MODE naqili
XKC-Y25-in dörd naqili var və rəngləri bütün versiyalarda eynidir. Əsas diqqət etməli olduğun məqam eyni görünən sensorun fərqli çıxış növləri ilə satılmasıdır. Versiya adı adətən gövdə etiketində və ya məhsul adında yazılır: XKC-Y25-V və ya -T12V gərginlik çıxışlı, XKC-Y25-NPN açıq kollektorlu, XKC-Y25-PNP isə mənbə (sourcing) çıxışlıdır; RS485 rabitəli versiyalar da var. Versiyanı bilmədən qoşsan, çıxış ya heç dəyişməz, ya da Arduino-ya yüksək gərginlik verər.
| Naqil rəngi | Vəzifəsi | Qoşulma |
|---|---|---|
| Qəhvəyi | VCC | 5–24 V qida plyusu |
| Göy | GND | Qida mənfisi, Arduino GND ilə ortaq |
| Sarı | OUT | Siqnal çıxışı, Arduino giriş pinə |
| Qara | MODE | Çıxış məntiqini seçir: VCC-yə və ya GND-yə qoşulur |
Gərginlik çıxışlı versiyada qara naqil VCC-yə qoşulsa, çıxış "müsbət" işləyir: maye aşkarlananda sarı naqil HIGH (qida gərginliyi), maye olmayanda LOW olur. Qara naqil GND-yə qoşulsa, məntiq tərsinə dönür: maye aşkarlananda LOW, maye olmayanda HIGH. Bu, məsələn, "boş qalanda xəbərdarlıq ver" kimi dövrədə kodu dəyişmədən məntiqi çevirməyə imkan verir. NPN versiyada çıxış aktiv olanda GND-yə çəkən tranzistordur; passiv olanda boşda qalır və pull-up rezistoru ilə HIGH oxunur. Bu versiyada qara naqilin boşda və ya GND-də olmasına görə çıxış "normal açıq" və ya "normal bağlı" işləyir. Satıcıdan satıcıya kiçik fərqlər ola bildiyi üçün ilk sınaqda sensoru əlini çənə yaxınlaşdıraraq və ya bir stəkan su ilə yoxla və çıxışı multimetrlə ölç.
| Versiya | Çıxış necə işləyir? | Arduino Uno (5 V) | ESP32 və Pico (3,3 V) |
|---|---|---|---|
| XKC-Y25-V / T12V (gərginlik) | Çıxış 0 V və ya qida gərginliyi verir | Sensoru 5 V ilə qidalandır, birbaşa qoş | 5 V qidada gərginlik bölücü şərtdir |
| XKC-Y25-NPN | Aktiv olanda çıxışı GND-yə çəkir | INPUT_PULLUP ilə, sensor 5–24 V ola bilər | INPUT_PULLUP ilə ən təhlükəsiz seçim |
| XKC-Y25-PNP | Aktiv olanda çıxışa qida gərginliyini verir | 5 V qidada pull-down rezistorla | Gərginlik bölücü və pull-down lazımdır |
Arduino Uno, ESP32 və Pico qoşulması
Arduino Uno ilə ən asan yol gərginlik çıxışlı sensoru 5 V ilə qidalandırmaqdır; çıxış da ən çox 5 V olur və birbaşa rəqəmsal pinə qoşula bilər. ESP32 və Raspberry Pi Pico 3,3 V ilə işlədiyi üçün burada NPN versiya ən təhlükəsiz seçimdir: sensoru 5 V ilə (hətta 12 V ilə) qidalandırırsan, çıxışı isə platanın öz daxili pull-up rezistoru 3,3 V-a çəkir. Gərginlik çıxışlı versiyanı 3,3 V platada istifadə edəcəksənsə, çıxışı 10 kΩ və 20 kΩ-luq gərginlik bölücü ilə 3,3 V-a endir. Aşağıdakı cədvəl bu yazıdakı kodların pinlərini göstərir.
| Qoşulma | Arduino Uno | ESP32 | Raspberry Pi Pico |
|---|---|---|---|
| Qəhvəyi (VCC) | 5V | VIN (5 V) | VBUS (5 V) |
| Göy (GND) | GND | GND | GND |
| Qara (MODE) | 5V (maye olanda HIGH) | GND və ya boşda (NPN) | GND və ya boşda (NPN) |
| Sarı (OUT), alt sensor | D2 | GPIO 27, INPUT_PULLUP | GP14, PULL_UP |
| Orta sensor OUT | D3 | - | - |
| Üst sensor OUT | D4 | - | - |
| Rele modulu IN (nasos) | D7 | - | - |
| Buzzer | D8 | - | - |
İlk kod: maye var, yoxsa yox?
XKC-Y25-in öz cavab müddəti təxminən yarım saniyədir və mayenin səthi dalğalananda çıxış bir neçə dəfə dəyişə bilər. Buna görə ilk kodda çıxışdan birbaşa istifadə etmək əvəzinə, dəyərin 300 ms ərzində eyni qalmasını gözləyən sadə sabitlik yoxlaması aparırıq. Kod gərginlik çıxışlı sensor və qara naqilin 5 V-a qoşulduğu hala görə yazılıb; sensorunun məntiqi tərsdirsə, yalnız SIVI_VAR sabitini LOW etmək kifayətdir. Vəziyyət hər dəyişəndə Serial Monitor-a yazır və D13-dəki daxili LED maye olanda yanır.
1const int SENSOR_PIN = 2; // XKC-Y25 sarı kablo / yellow wire
2const int LED_PIN = 13; // dahili LED / onboard LED
3const int SIVI_VAR = HIGH; // siyah kablo 5V'ta: sıvı varken HIGH / black wire on 5V: HIGH when liquid
4const unsigned long KARARLI_MS = 300; // değer bu kadar sabit kalmalı / value must stay this long
5
6int sonOkunan = -1;
7int kararliDurum = -1;
8unsigned long degisimZamani = 0;
9
10void setup() {
11 Serial.begin(9600);
12 pinMode(SENSOR_PIN, INPUT); // NPN sürümde INPUT_PULLUP / INPUT_PULLUP for the NPN version
13 pinMode(LED_PIN, OUTPUT);
14}
15
16void loop() {
17 int okunan = digitalRead(SENSOR_PIN);
18 if (okunan != sonOkunan) { // ham değer değişti / raw value changed
19 sonOkunan = okunan;
20 degisimZamani = millis();
21 }
22 if (millis() - degisimZamani >= KARARLI_MS && okunan != kararliDurum) {
23 kararliDurum = okunan; // 300 ms sabit kaldı, kabul et / stable for 300 ms, accept it
24 bool siviVar = (kararliDurum == SIVI_VAR);
25 digitalWrite(LED_PIN, siviVar ? HIGH : LOW);
26 Serial.println(siviVar ? "Sivi VAR / Liquid detected" : "Sivi YOK / No liquid");
27 }
28}Kodu yüklədikdən sonra sensoru boş plastik stəkanın kənarına lentlə yapışdır və stəkana yavaş-yavaş su doldur. Su sensorun ortasına yaxınlaşanda LED yanmalı və Serial Monitor-da "Sivi VAR" yazılmalıdır. Sensor suyu çox tez aşkarlayırsa və ya heç aşkarlamırsa, trimmerlə həssaslığı tənzimlə; əvvəlcə boş çəndə yanlış aşkarlama olmadığından, sonra dolu çəndə sabit aşkarladığından əmin ol. Sensorun arxa üzündəki kiçik LED də aşkarlama vəziyyətini göstərir; ayar edəndə Arduino-ya baxmadan bu LED-i izləyə bilərsən.
Bir neçə səviyyə nöqtəsi: üç sensorla çən idarəsi
Tək XKC-Y25 yalnız "bu hündürlükdə maye var və ya yoxdur" məlumatını verir. Səviyyəni pilləli izləmək üçün çənin divarına müxtəlif hündürlüklərdə bir neçə sensor yapışdırırsan. Üç sensorla çənin vəziyyəti dörd pilləyə bölünür: boş, aşağı, orta və dolu. Eyni düzən avtomatik doldurma üçün də idealdır: alt sensor quruyanda nasos işləyir, üst sensor islananda dayanır. İki sensor arasındakı məsafə əslində histerezis zolağıdır və nasosun tez-tez açılıb-bağlanmasının qarşısını alır; bu anlayışı sensor verilənlərinin filtrlənməsi yazısında ətraflı izah etmişik. Aşağıdakı kod buna iki təhlükəsizlik tədbiri də əlavə edir: üst sensor yaş olduğu halda alt sensor quru görünürsə, sensorlardan biri nasazdır, nasos dayanır və həyəcan siqnalı verilir; nasos 60 saniyədən uzun işləyib çəni doldura bilməsə də (boş mənbə, qopmuş şlanq) nasos söndürülür.
1const int ALT_PIN = 2; // %20 hizası / at 20%
2const int ORTA_PIN = 3; // %50 hizası / at 50%
3const int UST_PIN = 4; // %90 hizası / at 90%
4const int RELE_PIN = 7; // pompa rölesi / pump relay
5const int BUZZER_PIN = 8;
6const int SIVI_VAR = HIGH; // sensör mantığı / sensor logic
7const int RELE_ACIK = HIGH; // düşük tetiklemeli röle için LOW / LOW for active-low relays
8const unsigned long EN_UZUN_POMPA_MS = 60000; // 60 sn güvenlik sınırı / 60 s safety limit
9
10bool pompaCalisiyor = false;
11bool arizaVar = false;
12unsigned long pompaBaslangic = 0;
13
14bool siviVar(int pin) {
15 return digitalRead(pin) == SIVI_VAR;
16}
17
18void pompa(bool ac) {
19 if (ac && !pompaCalisiyor) pompaBaslangic = millis();
20 pompaCalisiyor = ac;
21 digitalWrite(RELE_PIN, ac ? RELE_ACIK : !RELE_ACIK);
22}
23
24void setup() {
25 Serial.begin(9600);
26 pinMode(ALT_PIN, INPUT);
27 pinMode(ORTA_PIN, INPUT);
28 pinMode(UST_PIN, INPUT);
29 pinMode(RELE_PIN, OUTPUT);
30 pinMode(BUZZER_PIN, OUTPUT);
31 pompa(false);
32}
33
34void loop() {
35 bool alt = siviVar(ALT_PIN);
36 bool orta = siviVar(ORTA_PIN);
37 bool ust = siviVar(UST_PIN);
38
39 int seviye = 0; // yüzde / percent
40 if (alt) seviye = 20;
41 if (alt && orta) seviye = 50;
42 if (alt && orta && ust) seviye = 90;
43
44 // Mantıksız durum: üst ıslak ama alt kuru / impossible state: top wet but bottom dry
45 if ((ust && !alt) || (orta && !alt) || (ust && !orta)) {
46 arizaVar = true;
47 }
48 // Pompa çok uzun çalıştı / pump ran too long
49 if (pompaCalisiyor && millis() - pompaBaslangic > EN_UZUN_POMPA_MS) {
50 arizaVar = true;
51 }
52
53 if (arizaVar) {
54 pompa(false);
55 tone(BUZZER_PIN, 2000, 200); // ariza alarmı / fault alarm
56 Serial.println("ARIZA: sensorleri ve pompayi kontrol et / FAULT: check sensors and pump");
57 delay(1000);
58 return; // ariza resetle silinir / fault is cleared by reset
59 }
60
61 if (!alt && !pompaCalisiyor) pompa(true); // alt kurudu: doldur / bottom dry: fill
62 if (ust && pompaCalisiyor) pompa(false); // üst ıslandı: dur / top wet: stop
63
64 Serial.print("Seviye / Level: %");
65 Serial.print(seviye);
66 Serial.print(" Pompa / Pump: ");
67 Serial.println(pompaCalisiyor ? "ACIK / ON" : "KAPALI / OFF");
68 delay(500);
69}Kodda səviyyə faizi sensorların yapışdırıldığı hündürlüklərə görə verilir; öz çənində sensorları fərqli hündürlüklərə qoymusansa, ədədləri dəyiş. Rele modullarının bir qismi LOW siqnalla işə düşür; nasos tərsinə işləyirsə, RELE_ACIK sabitini LOW et. Nasos və rele qoşulmasının təfərrüatları üçün Rele modulu nədir? və mini su nasosu yazılarına baxa bilərsən. Real sistemdə nasazlıq halını düymə ilə və ya Telegram mesajı ilə bildirmək və istifadəçi təsdiqləmədən nasosu yenidən işə salmamaq ən təhlükəsiz yoldur.
Üzgəcli açar və çəngəl sensorla müqayisə
Maye səviyyəsini ölçməyin yeganə yolu XKC-Y25 deyil. Hobbi layihələrində ən çox rast gəlinən üç seçim bunlardır: Arduino setlərindəki keçirici izli çəngəl sensor, içində maqnit olan üzgəc və reed releden ibarət üzgəcli açar və kapasitiv təmassız sensor. Hansının uyğun olduğu çənin materialından, mayenin növündən və büdcədən asılıdır.
| Xüsusiyyət | XKC-Y25 (təmassız) | Üzgəcli açar | Çəngəl (keçirici) sensor |
|---|---|---|---|
| Mayeyə toxunma | Yoxdur, kənardan ölçür | Var, çənin içində | Var, izlər mayedədir |
| Çənə dəlik | Lazım deyil | Adətən lazımdır | Lazım deyil, amma kabel içəri girir |
| Çıxış | Rəqəmsal (var/yox) | Rəqəmsal (kontakt) | Analoq (pilləli) |
| Ömür | Çox uzun | Uzun; çirk və əhəng ilişə bilər | Qısa; izlər aylar ərzində paslanır |
| Metal çən | İşləmir | İşləyir | İşləyir |
| Qida və içməli su | Uyğundur, mayeyə toxunmur | Qidaya uyğun material lazımdır | Uyğun deyil |
| Qiymət | Orta | Ucuz | Çox ucuz |
| Qida | 5–24 V, təxminən 5 mA | Lazım deyil, passiv kontakt | 3,3–5 V, ölçən zaman cərəyan |
Qısası, prototip və qısamüddətli sınaqlar üçün çəngəl sensor, dəliyi problem olmayan sadə çənlər üçün üzgəcli açar, uzunömürlü, təmiz və sızdırmazlığı pozulmamalı sistemlər üçün XKC-Y25 ən yaxşı seçimdir. Çəngəl sensorun kalibrləməsi və korroziyanı azaltma üsulları üçün su səviyyə sensoru yazısına nəzər sala bilərsən.
Tətbiq nümunələri: qəhvə maşını və akvarium
Qəhvə maşını və su dispenseri: Ev tipli qəhvə maşınlarının su anbarı adətən şəffaf plastikdir. Anbarın aşağı hissəsinə XKC-Y25 yapışdırıb su qurtarmaq üzrə olanda LED yandırmaq və ya maşını kilidləmək qızdırıcının quru işləməsinin qarşısını alır. Sensor 100 °C-yə qədər davamlı olduğu üçün isti anbar səthləri də problem deyil; yenə də sensoru birbaşa qızdırıcının üstünə deyil, anbarın yan divarına yerləşdir. Maşının içinə nəsə əlavə edirsənsə, şəbəkə gərginlikli hissələrdən uzaq dur və yalnız öz aşağı gərginlikli dövrənə toxun.
Akvariumda avtomatik su əlavəsi: Akvariumlarda buxarlanan suyu tamamlamaq üçün ayrıca ehtiyat su bidonu və kiçik nasos istifadə olunur. Akvarium şüşəsinin və ya filtr bölməsinin kənarına yapışdırılan XKC-Y25 su səviyyəsi düşəndə nasosu bir neçə saniyə işlədir. Bu düzəndə iki tədbir çox vacibdir: nasosa maksimum iş müddəti qoy (əvvəlki koddakı kimi) və ehtiyat bidona da ikinci sensor əlavə et, beləliklə bidon boş olanda nasos quru işləməz. Daşma riskinə qarşı üstdə ikinci sensorla müstəqil "təcili dayandır" səviyyəsi qurmaq yaxşı vərdişdir.
ESP32 ilə aşağı səviyyə həyəcan siqnalı
ESP32-də ən təhlükəsiz quraşdırma NPN versiya sensoru 5 V ilə qidalandırmaq və çıxışı daxili pull-up rezistoru ilə oxumaqdır. Beləliklə sensor nə qədər yüksək gərginliklə qidalansa da, ESP32-nin pininə 3,3 V-dan çox gərginlik gəlməz. Aşağıdakı kod maye 2 saniyə fasiləsiz olmayanda aşağı səviyyə həyəcan siqnalı verir, daxili LED-i yandırır və səviyyənin nə vaxtdan aşağı olduğunu yazır. Bu əsasa Wi-Fi əlavə edərək ESP32 Telegram botu ilə telefona mesaj göndərə və ya MQTT ilə Home Assistant-a qoşa bilərsən.
1const int SENSOR_PIN = 27; // NPN çıkış, dahili pull-up / NPN output, internal pull-up
2const int LED_PIN = 2; // dahili LED / onboard LED
3const int SIVI_VAR = LOW; // NPN: sıvı varken GND'ye çeker / NPN: pulls to GND when liquid
4const unsigned long ONAY_MS = 2000; // 2 sn onay / 2 s confirmation
5
6bool alarmAktif = false;
7unsigned long yokBaslangic = 0;
8bool yokSayiliyor = false;
9
10void setup() {
11 Serial.begin(115200);
12 pinMode(SENSOR_PIN, INPUT_PULLUP);
13 pinMode(LED_PIN, OUTPUT);
14}
15
16void loop() {
17 bool siviVar = (digitalRead(SENSOR_PIN) == SIVI_VAR);
18
19 if (!siviVar) {
20 if (!yokSayiliyor) {
21 yokSayiliyor = true;
22 yokBaslangic = millis();
23 }
24 if (!alarmAktif && millis() - yokBaslangic >= ONAY_MS) {
25 alarmAktif = true;
26 digitalWrite(LED_PIN, HIGH);
27 Serial.println("DUSUK SEVIYE! / LOW LEVEL!");
28 }
29 } else {
30 yokSayiliyor = false;
31 if (alarmAktif) {
32 alarmAktif = false;
33 digitalWrite(LED_PIN, LOW);
34 Serial.println("Seviye normal / Level OK");
35 }
36 }
37
38 static unsigned long sonRapor = 0;
39 if (alarmAktif && millis() - sonRapor >= 10000) { // 10 sn'de bir hatırlat / remind every 10 s
40 sonRapor = millis();
41 Serial.printf("Dusuk seviye suresi / Low level for: %lu s\n",
42 (unsigned long)((millis() - yokBaslangic) / 1000));
43 }
44 delay(50);
45}Raspberry Pi Pico və MicroPython ilə səviyyə izlənməsi
Raspberry Pi Pico-da da NPN versiya və daxili pull-up ən asan və ən təhlükəsiz yoldur. Aşağıdakı kod sensoru GP14-dən oxuyur, dəyərin 1 saniyə eyni qalmasını gözləyir və vəziyyət dəyişəndə plata üzərindəki LED-i yandırıb söndürür. Gərginlik çıxışlı sensorun varsa və onu 5 V ilə qidalandırmalısansa, sarı naqili GP14-ə 10 kΩ və 20 kΩ-luq bölücü ilə qoş və Pin.PULL_UP əvəzinə rezistorsuz giriş istifadə et.
1from machine import Pin
2import time
3
4sensor = Pin(14, Pin.IN, Pin.PULL_UP) # NPN çıkış / NPN output
5led = Pin(25, Pin.OUT) # Pico W'da Pin("LED") / Pin("LED") on Pico W
6SIVI_VAR = 0 # NPN: sıvı varken 0 / NPN: 0 when liquid
7ONAY_MS = 1000
8
9kararli = None
10son_okunan = sensor.value()
11degisim = time.ticks_ms()
12
13while True:
14 okunan = sensor.value()
15 if okunan != son_okunan: # ham değer değişti / raw value changed
16 son_okunan = okunan
17 degisim = time.ticks_ms()
18 if time.ticks_diff(time.ticks_ms(), degisim) >= ONAY_MS and okunan != kararli:
19 kararli = okunan
20 sivi_var = (kararli == SIVI_VAR)
21 led.value(1 if sivi_var else 0)
22 print("Sivi VAR / Liquid" if sivi_var else "Sivi YOK / No liquid")
23 time.sleep_ms(20)XKC-Y25 ilə layihə ideyaları
- Ağıllı bitki suvarma çəni: Ağıllı istixana layihəsindəki su çəni boşalanda nasosu dayandır və xəbərdarlıq ver; torpağın nəmini torpaq rütubət sensoru ilə ölç.
- Dam və ya hidrofor çəni: Plastik çənə müxtəlif hündürlüklərdə üç sensor yapışdırıb səviyyəni ekranda faizlə göstər.
- Rütubət azaldıcı cihazın anbarı: Anbar dolanda cihazı dayandıran və səsli xəbərdarlıq verən daşmadan qoruma düzəlt.
- Pişik və it su qabı: Su azalanda telefona bildiriş göndərən ESP32 layihəsi qur.
- Maye dozalama: Şlanq və ya boru üzərindən mayenin keçib-keçmədiyini aşkarlayıb nasosun boş yerə işləməsinin qarşısını al.
- Su keyfiyyəti stansiyası: Səviyyə məlumatını TDS sensoru və su axını sensoru ilə birləşdir.
Tez-tez olan xətalar və həlləri
| Əlamət | Ehtimal olunan səbəb | Həll |
|---|---|---|
| Çıxış heç dəyişmir | Yanlış versiya fərz edilib (NPN versiyada pull-up yoxdur) və ya GND ortaq deyil | Versiya etiketini yoxla, NPN üçün INPUT_PULLUP istifadə et, GND-ləri birləşdir |
| Maye olanda və olmayanda məntiq tərsdir | MODE naqili gözləniləndən tərsinədir | Qara naqili VCC ilə GND arasında dəyiş və ya koddakı SIVI_VAR sabitini çevir |
| Dolu çəndə belə aşkarlamır | Divar qalındır, metaldır və ya sensorla divar arasında hava var | Sensoru düz və sıx yapışdır, həssaslığı artır, divar qalınlığını yoxla |
| Boş çəndə də "maye var" deyir | Həssaslıq çox yüksəkdir, divarda kondensasiya var və ya yaxında əl və ya metal var | Trimmeri saat əqrəbi istiqamətində çevir, divarın xarici üzünü quru saxla |
| Maye səthi dalğalananda çıxış titrəyir | Səth sensor səviyyəsində dalğalanır | Koddakı sabitlik müddətini artır, sensoru dalğaların az olduğu yerə köçür |
| Arduino-nun pini qızdı və ya xarab oldu | Sensor 12 V ilə qidalanıb və gərginlik çıxışı birbaşa qoşulub | NPN versiya və ya gərginlik bölücü istifadə et, sensoru 5 V ilə qidalandır |
| Yağlı mayedə işləmir | Yağın dielektrik sabiti çox aşağıdır | Üzgəcli açar və ya başqa ölçmə üsulu seç |
| Səviyyə düşəndən sonra bir müddət dolu göstərir | Qatı maye daxili divarda təbəqə qoyur | Həssaslığı azalt, sensoru mayenin divarda iz qoymadığı yerə qoy |
XKC-Y25 təmassız maye səviyyə sensoru çənin içinə heç nə salmadan, mayeyə heç toxunmadan və paslanma dərdi olmadan səviyyə ölçməyin ən praktik yoludur. Kapasitiv aşkarlamanı, divar qalınlığı həddini, çıxış versiyalarını və MODE naqilini öyrəndiyinə görə artıq qəhvə maşınından akvariuma, bitki suvarmasından dam çəninə qədər uzun illər işləyəcək sistemlər qura bilərsən. BlueGrays tətbiqində ağıllı suvarma stansiyası kimi layihələri addım-addım dövrə sxemləri və hazır kodları ilə araşdıra, bu layihələrə XKC-Y25 ilə çən səviyyəsi idarəsi əlavə edə bilərsən.
Tez-tez verilən suallar
Təmassız maye səviyyə sensoru necə işləyir?
Təmassız maye səviyyə sensoru kapasitiv işləyir: çənin xarici divarına yapışdırılan sensorun elektrodu arxadakı maye qalxanda daha böyük tutum görür. Sensorun içindəki mikrosxem bu dəyişiklik həddi keçəndə çıxışını dəyişir. Elektrik sahəsi plastik, şüşə və keramikadan keçdiyi üçün sensor mayeyə toxunmadan işləyir.
XKC-Y25 neçə mm divar qalınlığında işləyir?
İstehsalçı 0–20 mm arası aşkarlama dəyəri verir, lakin etibarlı və sabit iş üçün divarın 12 mm-dən nazik olması tövsiyə olunur. Sensorun divara düz və boşluqsuz yapışdırılması həssaslığı xeyli artırır. Metal divarlarda qalınlıq nə olursa olsun işləmir.
XKC-Y25 metal çəndə işləyirmi?
Xeyr. Metal divar sensorun elektrik sahəsini ekranlaşdırdığı üçün sensor metal çənin kənarından mayeni aşkarlaya bilmir. Metal çənlərdə çənə qoşulan şəffaf plastik müşahidə borusunun və ya plastik pəncərənin kənarına sensor yapışdıraraq həll tapmaq olar.
XKC-Y25-in qara naqili nəyə xidmət edir?
Qara naqil MODE naqilidir və çıxış məntiqini seçir. Gərginlik çıxışlı versiyada qara naqil VCC-yə qoşulsa, maye aşkarlananda çıxış HIGH, GND-yə qoşulsa, maye aşkarlananda LOW olur. Beləliklə kodu dəyişmədən "dolu" və ya "boş" vəziyyətdə aktiv olan çıxış əldə edə bilərsən.
XKC-Y25 Arduino-ya necə qoşulur?
Qəhvəyi naqili 5V-a, göy naqili GND-yə, sarı çıxış naqilini D2 kimi rəqəmsal pinə, qara MODE naqilini isə istədiyin məntiqə görə 5V-a və ya GND-yə qoş. NPN versiya istifadə edirsənsə, pini INPUT_PULLUP olaraq tənzimlə. Sensoru 12 V ilə qidalandırırsansa, gərginlik çıxışını Arduino-ya birbaşa qoşma.
Təmassız səviyyə sensoru yoxsa üzgəcli açar daha yaxşıdır?
Təmassız sensor mayeyə toxunmadığı üçün paslanmır, əhəng çöküntüsü yaratmır, çənə dəlik açmağı tələb etmir və içməli su ilə qida üçün daha uyğundur. Üzgəcli açar isə daha ucuzdur, qida tələb etmir və metal çənlərdə, həmçinin yağ kimi aşağı dielektrik sabitli mayelərdə də işləyir. Seçim çənin materialına və mayenin növünə görə edilməlidir.
Bu yazıdan sonra edə biləcəyin layihələr
Bütün layihələrə bax
Ağıllı suvarma stansiyası
Tətilə gedəndə çiçəklərin qurumasın deyə özü suvaran bağbandır. Torpaq rütubət sensoru torpağın nə qədər nəm olduğunu ölçür; torpaq quruyanda Arduino su nasosunu bir neçə saniyə işlədir və mavi işıq…

Buzzer istifadəsi
Qapı zəngi ya da həyəcan siqnalı necə səslənir, heç maraqlanmısan? Arduino kiçik buzzer-i qısa fasilələrlə səsləndirir: bip, sus, bip, sus.

Düymə ilə LED yandırma (Push)
Qapı zəngi kimi: bassan işıq yanır, buraxanda sönür. Arduino düyməni daim dinləyir; düymə basılı olanda LED-i yandırır, əlini çəkdiyin anda söndürür.

LED yandırma
Elektronikanın ilk salamı: tək bir LED-i yandırıb söndürmək. Arduino LED-i çox qısa fasilələrlə yandırıb söndürür, işıq sürətlə qırpılır.

ESP32 ilə LED yandırma
ESP32 ilə əsas GPIO çıxışından istifadəni öyrədir. LED-i rəqəmsal pindən yandırıb söndürərək yanıb-sönmə effekti əldə edirik. Arduino UNO-dakı klassik blink layihəsinin ESP32 versiyasıdır; Arduino mühitindəki əsas blink əmrləri eynidir, lakin ESP32-nin pin yerləşməsi və 3,3 V GPIO səviyyələri Arduino UNO-dan fərqlidir.

ESP32 hərəkət siqnalizasiya sistemi (PIR + buzzer + LED + Telegram)
PIR sensoru hərəkət aşkarlayanda buzzer-i və LED-i işə salan, eyni zamanda Telegram vasitəsilə sahibinə ani bildiriş göndərən ağıllı təhlükəsizlik siqnalizasiyası. Təkrarlanan həyəcanların tezliyini məhdudlaşdırmaq üçün 30 saniyəlik gözləmə müddəti (cooldown) var; bu müddət PIR sensorunun yanlış aşkarlamalarını aradan qaldırmır. Ev, qaraj, anbar və ya iş otağı kimi yerlərdə istifadə oluna bilər.

Raspberry Pi Pico düymə ilə LED yandırma (Push)
Pico ilə ilk giriş layihəsi — düymə oxuma! Düyməyə basdıqca LED yanır, buraxdıqca sönür. Bu layihə LED animasiyalarından sonrakı böyük addımdır: Pico-ya xaricdən siqnal girişi. Yeni öyrəniləcəklər: Pin.IN (giriş rejimi), Pin.PULL_UP (daxili pull-up rezistoru — düymə üçün standart), button.value() oxuması. GP14 LED, GP2 düymə (daxili PULL_UP). Düyməyə basılanda siqnal LOW (0), buraxılanda HIGH (1) olur — bu tərs məntiq əvvəlcə çaşdırıcıdır, amma sənaye standartıdır.
Digər yazılar
BlueGrays tətbiqi
Bu dövrəni telefonunda addım-addım qur
Dövrə sxemi, kod və hissə siyahısı bir ekranda. 500-dən çox Arduino, ESP32 və Pico layihəsi səni gözləyir.
Telefonunla skan et
Kameranı koda tut; telefonunun tətbiq mağazası açılır.
ya da mağazada aç

