Componenten · 12 min leestijd

Contactloze vloeistofniveausensor XKC-Y25: Arduino-bedrading en code

Contactloze vloeistofniveausensor XKC-Y25: capacitieve detectie, wanddikte, NPN-/PNP-uitgang en MODE-draad, 5–24 V, Arduino-bedrading en pompbesturing met meerdere niveaus.

Een contactloze vloeistofniveausensor detecteert of de vloeistof een bepaalde hoogte heeft bereikt zonder dat er iets in het reservoir zit: je plakt hem gewoon aan de buitenkant van een kunststof of glazen wand. Het bekendste en goedkoopste voorbeeld is de XKC-Y25: een kleine schijf van 28 mm doorsnede met een witte kunststof behuizing en vier draden. Omdat hij de vloeistof nooit aanraakt, roest hij niet, krijgt hij geen kalkaanslag, vervuilt hij geen drinkwater en werkt hij jarenlang, ook met vloeistoffen die moeilijk schoon te houden zijn, zoals zuur, koffie of melk. Het is de schoonste oplossing voor het probleem dat de vorkvormige waterniveausensoren uit Arduino-kits na een paar weken corroderen.

In deze gids leer je hoe de XKC-Y25 de vloeistof achter de wand capacitief waarneemt en door welke materialen en wanddiktes hij werkt. We bekijken in detail het verschil tussen de versies met spanningsuitgang, NPN en PNP, de draadkleuren en de zwarte MODE-draad die de uitgangslogica instelt. Daarna sluiten we de sensor aan op een Arduino Uno en schrijven we een eerste sketch. Vervolgens bouwen we een systeem dat het reservoir met drie sensoren in procentuele niveaus verdeelt en de pomp automatisch laat draaien. Een vergelijking met een vlotterschakelaar, toepassingen in koffiemachines en aquaria en code voor ESP32 en Raspberry Pi Pico sluiten het artikel af.

Contactloze vloeistofniveausensor XKC-Y25
XKC-Y25: een capacitieve vloeistofniveausensor van 28 mm die je op de buitenwand van een reservoir plakt.

Wat is een contactloze vloeistofniveausensor en hoe werkt hij?

De XKC-Y25 is een capacitieve sensor. Aan de voorkant van de behuizing zit een elektrode, die samen met de omgeving een kleine condensator vormt. Met alleen lucht achter de wand heeft deze capaciteit een bepaalde waarde. Als de vloeistof tot de hoogte van de sensor stijgt, wordt de vloeistof een deel van de condensator en neemt de capaciteit toe. Water heeft een diëlektrische constante van ongeveer 80 en lucht ongeveer 1, dus de verandering in capaciteit is heel duidelijk zodra er water komt. De chip in de sensor meet deze verandering continu en schakelt zijn uitgang als een ingestelde drempel wordt overschreden. Omdat het elektrische veld door isolerende materialen zoals kunststof, glas en keramiek kan, werkt de sensor zonder de vloeistof aan te raken; metaal schermt het veld echter af, dus een metalen reservoir kun je niet van buitenaf meten. Dit zijn de gegevens van de fabrikant voor de versies XKC-Y25-V en XKC-Y25-T12V die verkopers het vaakst aanbieden:

EigenschapXKC-Y25 (versie met spanningsuitgang)
Voedingsspanning5–24 V DC
StroomverbruikOngeveer 5 mA
UitgangHoog niveau = voedingsspanning, laag niveau = 0 V
Uitgangsstroom1–50 mA
ReactietijdOngeveer 500 ms
Detecteerbare wanddikte0–20 mm (voor betrouwbare werking wordt tot 12 mm aanbevolen)
Bedrijfstemperatuur0–100 °C
BeschermingIP67, ABS-behuizing
Afmetingen28 mm diameter, ongeveer 17 mm diep
GevoeligheidsinstellingTrimmer onder het achterdeksel

Wanddikte, materiaal en soort vloeistof

De vaakst gestelde vraag over de sensor gaat over de wanddikte. De fabrikant noemt weliswaar detectie tot 20 mm, maar voor een betrouwbaar, stabiel resultaat wordt een wand dunner dan 12 mm aanbevolen. PET-flessen, kunststof jerrycans (1–3 mm), aquariumglas (4–10 mm) en PVC-buizen in hobbyprojecten vallen ruim binnen deze grens. De voorkant van de sensor moet de wand volledig en vlak raken; een luchtspleet ertussen verlaagt de gevoeligheid sterk. Bevestig de sensor op cilindrische reservoirs dus langs een verticale lijn, bij voorkeur met niet-schuimend dubbelzijdig plakband of hete siliconen. Ook de soort vloeistof telt: vloeistoffen op waterbasis zoals water, vruchtensap, koffie, melk en zout water worden makkelijk gedetecteerd. Oliën hebben echter een diëlektrische constante van maar ongeveer 2–3; bij deze vloeistoffen werkt de sensor vaak zelfs op maximale gevoeligheid niet betrouwbaar.

SituatieWordt het gedetecteerd?Opmerking
Kunststof reservoir (PE, PP, PVC, acryl), 1–10 mmJaDe meest gebruikte en probleemloze toepassing
Glazen pot, aquariumglasJaEenvoudig tot 10 mm; verhoog de gevoeligheid voor dik glas
KeramiekJaDe wand moet vlak en dun zijn
Metalen reservoir of roestvrijstalen boilerNeeMetaal schermt het veld af; voeg een kunststof kijkbuis toe aan het reservoir
Kunststof van 12–20 mm dikGrensgevalVerhoog de gevoeligheid en test op valse meldingen
Water, koffie, melk, zout waterJaHoge diëlektrische constante
Olie, benzine, vloeistoffen met veel alcoholMoeilijk of nietLage diëlektrische constante
Poeders en korrels (suiker, dierenvoer)SomsKan werken met vochtige, dichte poeders; test altijd
De buitenkant van de wand voor de sensor moet droog blijven. Condensdruppels op de wand, een natte doek bij de sensor of een hand die hem aanraakt veranderen ook de capaciteit en kunnen een vals signaal "vloeistof aanwezig" geven. Dikke vloeistoffen zoals melk en koffie kunnen na het dalen van het niveau een dunne film op de binnenwand achterlaten, en de sensor kan nog even "vol" blijven aangeven. Je stelt de gevoeligheid in door het achterdeksel te openen en de trimmer met een klein schroevendraaiertje te draaien: tegen de klok in verhoogt de gevoeligheid, met de klok mee verlaagt hem.

Draden, uitgangstypen en de MODE-draad

De XKC-Y25 heeft vier draden en de kleuren zijn in alle versies gelijk. Waar je echt op moet letten, is dat dezelfde sensor wordt verkocht met verschillende uitgangstypen. De versienaam staat meestal op het label van de behuizing of in de productnaam: XKC-Y25-V of -T12V heeft een spanningsuitgang, XKC-Y25-NPN een open-collectoruitgang en XKC-Y25-PNP een sourcing-uitgang; er zijn ook RS485-versies. Als je hem aansluit zonder de versie te kennen, verandert de uitgang nooit of komt er een hoge spanning op de Arduino.

DraadkleurFunctieAansluiting
BruinVCCVoeding plus, 5–24 V
BlauwGNDVoeding min, gemeenschappelijk met GND van de Arduino
GeelOUTSignaaluitgang, naar een ingangspin van de Arduino
ZwartMODEKiest de uitgangslogica: aangesloten op VCC of GND

Als bij de versie met spanningsuitgang de zwarte draad naar VCC gaat, werkt de uitgang "positief": bij gedetecteerde vloeistof is de gele draad HIGH (voedingsspanning) en LOW als er geen vloeistof is. Gaat de zwarte draad naar GND, dan is de logica omgekeerd: LOW bij gedetecteerde vloeistof, HIGH als er geen is. Zo kun je de logica omdraaien voor een schakeling als "alarm bij leeg" zonder de code aan te passen. Bij de NPN-versie is de uitgang een transistor die bij activering naar GND trekt; als hij niet actief is, zweeft hij en leest hij via een pull-upweerstand HIGH. Bij deze versie werkt de uitgang "normaal open" of "normaal gesloten", afhankelijk van of de zwarte draad vrij blijft of aan GND wordt gelegd. Omdat er kleine verschillen tussen verkopers zijn, breng je bij je eerste test je hand dicht bij het reservoir of gebruik je een glas water en meet je de uitgang met een multimeter.

VersieWerking van de uitgangArduino Uno (5 V)ESP32 en Pico (3,3 V)
XKC-Y25-V / T12V (spanning)De uitgang geeft 0 V of de voedingsspanningVoed de sensor met 5 V en sluit rechtstreeks aanEen spanningsdeler is verplicht bij een voeding van 5 V
XKC-Y25-NPNTrekt de uitgang naar GND als hij actief isMet INPUT_PULLUP; de sensor kan op 5–24 V werkenDe veiligste optie, met INPUT_PULLUP
XKC-Y25-PNPZet de voedingsspanning op de uitgang als hij actief isMet een pull-downweerstand bij een voeding van 5 VHeeft een spanningsdeler en een pull-down nodig

Bedrading voor Arduino Uno, ESP32 en Pico

Bij een Arduino Uno voed je de sensor met spanningsuitgang het eenvoudigst met 5 V; de uitgang komt dan nooit boven 5 V en kan direct naar een digitale pin. De ESP32 en de Raspberry Pi Pico werken op 3,3 V, dus hier is de NPN-versie de veiligste keuze: je voedt de sensor met 5 V (of zelfs 12 V) en de interne pull-upweerstand van het board trekt de uitgang naar 3,3 V. Gebruik je de versie met spanningsuitgang op een 3,3V-board, breng de uitgang dan terug naar 3,3 V met een spanningsdeler van 10 kΩ en 20 kΩ. De tabel hieronder toont de pins die de code in dit artikel gebruikt.

AansluitingArduino UnoESP32Raspberry Pi Pico
Bruin (VCC)5VVIN (5 V)VBUS (5 V)
Blauw (GND)GNDGNDGND
Zwart (MODE)5V (HIGH bij vloeistof)GND of vrij (NPN)GND of vrij (NPN)
Geel (OUT), onderste sensorD2GPIO 27, INPUT_PULLUPGP14, PULL_UP
OUT van de middelste sensorD3--
OUT van de bovenste sensorD4--
IN van de relaismodule (pomp)D7--
BuzzerD8--
Als je de sensor met 12 V of 24 V voedt, is de uitgang van de spannings- en PNP-versies ook 12–24 V; die uitgang rechtstreeks op een Arduino aansluiten brandt de pin en het board door. Gebruik in dat geval de NPN-versie, of voeg een spanningsdeler of een optocoupler toe. Je kunt de waarden van de deler berekenen met de tool Spanningsdeler. De GND van de sensor en de GND van het board moeten altijd met elkaar verbonden zijn.

Eerste sketch: is er vloeistof of niet?

De eigen reactietijd van de XKC-Y25 is ongeveer een halve seconde en terwijl het vloeistofoppervlak rimpelt, kan de uitgang meerdere keren wisselen. In plaats van de uitgang direct te gebruiken, doet de eerste sketch daarom een eenvoudige stabiliteitscontrole die wacht tot de waarde 300 ms gelijk blijft. De code is geschreven voor een sensor met spanningsuitgang waarvan de zwarte draad aan 5 V ligt; is de logica van jouw sensor omgekeerd, zet de constante SIVI_VAR dan op LOW. Bij elke statusverandering schrijft de sketch naar de Serial Monitor en de ingebouwde led op D13 brandt zolang er vloeistof is.

C++ (Arduino IDE)
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}

Plak na het uploaden de sensor aan de buitenkant van een lege kunststof beker en vul de beker langzaam met water. Als het water het midden van de sensor nadert, moet de led gaan branden en moet de Serial Monitor "Sivi VAR" tonen. Detecteert de sensor het water veel te vroeg of helemaal niet, stel de gevoeligheid dan bij met de trimmer; zorg eerst dat er bij een leeg reservoir geen valse detectie is, en dan dat de detectie bij een vol reservoir stabiel is. De kleine led aan de achterkant van de sensor toont ook de detectiestatus; die kun je tijdens het afstellen bekijken zonder naar de Arduino te kijken.

Meerdere niveaupunten: een reservoir beheren met drie sensoren

Eén XKC-Y25 vertelt je alleen "vloeistof op deze hoogte: ja of nee". Om het niveau in stappen te volgen, plak je meerdere sensoren op verschillende hoogtes op de reservoirwand. Met drie sensoren valt de toestand van het reservoir uiteen in vier stappen: leeg, laag, gemiddeld en vol. Dezelfde opzet is ideaal voor automatisch vullen: de pomp draait zodra de onderste sensor droog valt en stopt als de bovenste sensor nat wordt. De afstand tussen de twee sensoren is in feite een hysteresisband die voorkomt dat de pomp te vaak aan- en uitschakelt; dit idee leggen we uitgebreid uit in het artikel over het filteren van sensordata. De onderstaande code voegt twee veiligheidsmaatregelen toe: als de bovenste sensor nat meet terwijl de onderste droog meet, is een sensor defect, dus stopt de pomp en gaat het alarm af; en als de pomp langer dan 60 seconden draait zonder het reservoir te vullen (lege bron, losse slang), wordt hij ook uitgeschakeld.

C++ (Arduino IDE)
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}

In de code volgt het niveaupercentage de hoogtes waar de sensoren zijn geplakt; heb je ze op andere hoogtes op je reservoir geplaatst, pas dan de getallen aan. Sommige relaismodules schakelen op een LOW-signaal; werkt de pomp verkeerd om, zet dan de constante RELE_ACIK op LOW. Voor details over het aansluiten van de pomp en het relais, zie Wat is een relaismodule? en mini-waterpomp. In een echt systeem is het veiligst om een storing te melden met een knop of een Telegram-bericht en de pomp pas weer te starten als een gebruiker dat bevestigt.

Vergelijking met een vlotterschakelaar en een vorksensor

De XKC-Y25 is niet de enige manier om vloeistofniveau te meten. De drie opties die je het vaakst tegenkomt in hobbyprojecten zijn de vorksensor met geleidende banen uit Arduino-kits, de vlotterschakelaar met een magnetische vlotter en een reedschakelaar, en de capacitieve contactloze sensor. Welke bij je past, hangt af van het reservoirmateriaal, de soort vloeistof en het budget.

EigenschapXKC-Y25 (contactloos)VlotterschakelaarVorksensor (geleidend)
Contact met vloeistofGeen, meet van buitenafJa, in het reservoirJa, de banen zitten in de vloeistof
Gat in het reservoirNiet nodigMeestal nodigNiet nodig, maar de kabel gaat naar binnen
UitgangDigitaal (ja/nee)Digitaal (contact)Analoog (in stappen)
LevensduurZeer langLang; vuil en kalk kunnen hem laten vastlopenKort; de banen corroderen binnen enkele maanden
Metalen reservoirWerkt nietWerktWerkt
Voedsel en drinkwaterGeschikt, raakt de vloeistof nooit aanVraagt voedselveilige materialenNiet geschikt
PrijsGemiddeldGoedkoopZeer goedkoop
Voeding5–24 V, ongeveer 5 mANiet nodig, passief contact3,3–5 V, stroom tijdens het meten

Kortom: voor prototypes en korte tests de vorksensor, voor eenvoudige reservoirs waar een gat geen probleem is de vlotterschakelaar, en voor duurzame, schone systemen waarvan de afdichting niet doorbroken mag worden is de XKC-Y25 de beste keuze. Voor het kalibreren van de vorksensor en manieren om corrosie te beperken lees je het artikel over de waterniveausensor.

Toepassingsvoorbeelden: koffiemachine en aquarium

Koffiemachine en waterdispenser: Het watervat van een koffiemachine voor thuis is meestal van doorzichtig kunststof. Als je een XKC-Y25 op het onderste deel van het vat plakt en een led laat branden of de machine blokkeert wanneer het water bijna op is, voorkom je dat het verwarmingselement droog draait. De sensor is geschikt tot 100 °C, dus warme oppervlakken van het vat zijn geen probleem; plaats hem toch op de zijwand van het vat, niet direct boven het verwarmingselement. Als je iets in een machine toevoegt, blijf dan uit de buurt van de delen onder netspanning en werk alleen aan je eigen laagspanningsschakeling.

Automatisch bijvullen van een aquarium: Aquaria gebruiken een apart reservewatervat en een kleine pomp om verdampt water aan te vullen. Een XKC-Y25 die aan de buitenkant van het aquariumglas of het filtercompartiment is geplakt, laat de pomp een paar seconden draaien als het waterniveau daalt. In deze opstelling zijn twee voorzorgsmaatregelen essentieel: geef de pomp een maximale looptijd (zoals in de vorige code) en voeg een tweede sensor toe aan het reservevat, zodat de pomp nooit droog draait als dat leeg is. Een onafhankelijk "noodstopniveau" met een tweede sensor hoger op, tegen overlopen, is een goede gewoonte.

Alarm bij laag niveau met de ESP32

Op de ESP32 is het veiligst om een sensor met NPN-versie met 5 V te voeden en de uitgang uit te lezen met de interne pull-upweerstand. Zo ziet de ESP32-pin, hoe hoog de voedingsspanning van de sensor ook is, nooit meer dan 3,3 V. De onderstaande code geeft een alarm bij laag niveau wanneer er 2 seconden onafgebroken geen vloeistof is geweest, laat de ingebouwde led branden en meldt hoe lang het niveau al laag is. Daarbovenop kun je Wi-Fi toevoegen en een bericht naar je telefoon sturen met een ESP32-Telegrambot, of de sensor via MQTT aan Home Assistant koppelen.

C++ (Arduino IDE)
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}

Niveaubewaking met de Raspberry Pi Pico en MicroPython

Ook op de Raspberry Pi Pico is de NPN-versie met de interne pull-up de eenvoudigste en veiligste manier. De onderstaande code leest de sensor op GP14 uit, wacht tot de waarde 1 seconde gelijk blijft en schakelt de ingebouwde led als de status verandert. Heb je een sensor met spanningsuitgang en moet je hem met 5 V voeden, sluit dan de gele draad via een deler van 10 kΩ en 20 kΩ aan op GP14 en gebruik een gewone ingang in plaats van Pin.PULL_UP.

MicroPython
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)

Projectideeën met de XKC-Y25

  • Slim watergeefreservoir voor planten: Stop de pomp en geef een waarschuwing als het watervat in het project slimme kas leeg raakt; meet de bodemvochtigheid met een bodemvochtsensor.
  • Dak- of drukreservoir: Plak drie sensoren op verschillende hoogtes op een kunststof reservoir en toon het niveau als percentage op een display.
  • Emmer van een luchtontvochtiger: Bouw een overloopbeveiliging die het apparaat stopt en een waarschuwing laat klinken als de emmer vol is.
  • Waterbak voor huisdieren: Maak een ESP32-project dat een melding naar je telefoon stuurt als het water laag wordt.
  • Vloeistofdosering: Detecteer of er vloeistof door een slang of buis stroomt en voorkom dat de pomp leegdraait.
  • Waterkwaliteitsstation: Combineer de niveaumeting met een TDS-sensor en een waterdebietsensor.

Veelgemaakte fouten en oplossingen

SymptoomWaarschijnlijke oorzaakOplossing
De uitgang verandert nooitVerkeerde versie aangenomen (geen pull-up bij de NPN-versie) of geen gemeenschappelijke GNDControleer het versielabel, gebruik INPUT_PULLUP voor NPN, verbind de massa's
De logica is omgekeerd voor vloeistof en geen vloeistofDe MODE-draad zit andersomVerplaats de zwarte draad tussen VCC en GND of draai de constante SIVI_VAR in de code om
Detecteert niets, zelfs bij een vol reservoirDikke of metalen wand, of lucht tussen sensor en wandPlak de sensor vlak en strak aan, verhoog de gevoeligheid, controleer de wanddikte
Meldt ook "vloeistof" bij een leeg reservoirGevoeligheid te hoog, condens op de wand of een hand of metaal in de buurtDraai de trimmer met de klok mee en houd de buitenkant van de wand droog
De uitgang flikkert terwijl het oppervlak rimpeltHet oppervlak rimpelt op de hoogte van de sensorVerhoog de stabiliteitstijd in de code of verplaats de sensor naar een rustigere plek
Een Arduino-pin werd heet of viel uitDe sensor draaide op 12 V en de spanningsuitgang was rechtstreeks aangeslotenGebruik de NPN-versie of een spanningsdeler en voed de sensor met 5 V
Werkt niet met olieachtige vloeistoffenDe diëlektrische constante van olie is heel laagKies een vlotterschakelaar of een andere meetmethode
Blijft nog even vol aangeven nadat het niveau daaltEen dikke vloeistof laat een film op de binnenwand achterVerlaag de gevoeligheid en plaats de sensor waar de vloeistof de wand niet bedekt
Voordat je de sensor definitief opplakt, houd je hem met tijdelijk plakband aan de buitenkant van het reservoir en test je hem meerdere keren vol, leeg en half vol. De led aan de achterkant van de sensor is je beste hulp tijdens het afstellen. Ben je tevreden met het resultaat, maak het oppervlak dan schoon met alcohol, bevestig de sensor met permanent dubbelzijdig plakband of hete siliconen en zet de kabel aan het reservoir vast, zodat hij niet aan de sensor trekt.

De contactloze vloeistofniveausensor XKC-Y25 is de handigste manier om niveau te meten zonder iets in het reservoir te plaatsen, zonder de vloeistof aan te raken en zonder je zorgen te maken over roest. Nu je weet hoe capacitieve detectie werkt en wat de wanddiktegrens, de uitgangsversies en de MODE-draad inhouden, kun je systemen bouwen die jarenlang meegaan, van koffiemachines en aquaria tot plantenbewatering en dakreservoirs. In de BlueGrays-app kun je projecten zoals een slim irrigatiestation verkennen, met stap-voor-stap schakelschema's en kant-en-klare code, en daar reservoirniveaubesturing met de XKC-Y25 aan toevoegen.

Veelgestelde vragen

Hoe werkt een contactloze vloeistofniveausensor?

Een contactloze vloeistofniveausensor werkt capacitief: de elektrode van een sensor die aan de buitenwand van een reservoir is geplakt, ziet een grotere capaciteit wanneer de vloeistof erachter stijgt. Als deze verandering een drempel overschrijdt, schakelt de chip in de sensor zijn uitgang. Omdat het elektrische veld door kunststof, glas en keramiek gaat, werkt de sensor zonder de vloeistof aan te raken.

Door welke wanddikte werkt de XKC-Y25?

De fabrikant noemt een detectiebereik van 0–20 mm, maar voor betrouwbare, stabiele werking wordt een wand dunner dan 12 mm aanbevolen. De sensor vlak en zonder spleet tegen de wand plakken verbetert de gevoeligheid sterk. Door metalen wanden werkt hij niet, ongeacht de dikte.

Werkt de XKC-Y25 op een metalen reservoir?

Nee. Een metalen wand schermt het elektrische veld van de sensor af, dus de sensor kan van buiten een metalen reservoir geen vloeistof detecteren. Bij metalen reservoirs kun je de sensor aan de buitenkant van een doorzichtige kunststof kijkbuis of een kunststof venster plakken dat met het reservoir is verbonden.

Waar dient de zwarte draad van de XKC-Y25 voor?

De zwarte draad is de MODE-draad en kiest de uitgangslogica. Bij de versie met spanningsuitgang gaat de uitgang HIGH bij gedetecteerde vloeistof als de zwarte draad op VCC is aangesloten; is hij op GND aangesloten, dan gaat de uitgang LOW bij gedetecteerde vloeistof. Zo krijg je een uitgang die actief is bij "vol" of bij "leeg" zonder de code te wijzigen.

Hoe sluit ik de XKC-Y25 aan op een Arduino?

Sluit de bruine draad aan op 5V, de blauwe draad op GND, de gele uitgangsdraad op een digitale pin zoals D2 en de zwarte MODE-draad op 5V of GND, afhankelijk van de logica die je wilt. Gebruik je de NPN-versie, zet de pin dan op INPUT_PULLUP. Voed je de sensor met 12 V, sluit de spanningsuitgang dan niet rechtstreeks aan op de Arduino.

Wat is beter: een contactloze niveausensor of een vlotterschakelaar?

Een contactloze sensor raakt de vloeistof nooit aan, dus hij roest niet, krijgt geen kalkaanslag, heeft geen gat in het reservoir nodig en is beter geschikt voor drinkwater en voedsel. Een vlotterschakelaar is goedkoper, heeft geen voeding nodig en werkt ook in metalen reservoirs en met vloeistoffen met een lage diëlektrische constante zoals olie. De keuze moet afhangen van het reservoirmateriaal en de soort vloeistof.

Alle projecten bekijken
Slim bewateringsstation
AR-83Gevorderd
Premium

Slim bewateringsstation

Een tuinier die je planten zelf water geeft, zodat ze niet uitdrogen terwijl jij op vakantie bent.

5.0(42)
57
Een buzzer gebruiken
AR-13Beginner

Een buzzer gebruiken

Heb je je ooit afgevraagd hoe een deurbel of alarm geluid maakt? De Arduino laat een kleine buzzer met korte tussenpozen piepen: piep, pauze, piep, pauze.

4.7(92)
170
LED aansturen met een drukknop (Push)
AR-9Beginner

LED aansturen met een drukknop (Push)

Net als een deurbel: het licht blijft aan zolang je indrukt en gaat uit als je loslaat.

4.8(114)
253
LED laten knipperen
AR-1Beginner

LED laten knipperen

De allereerste hallo van de elektronica: één LED aan- en uitzetten. De Arduino zet de LED met korte tussenpozen aan en uit, zodat het licht snel knippert.

4.6(200)
1246
Led laten knipperen met ESP32
ES-1Beginner

Led laten knipperen met ESP32

Leert je het basisgebruik van een GPIO-uitgang met de ESP32. Door een led via een digitale pin aan en uit te zetten krijgen we een knippereffect. Dit is de ESP32-versie van het klassieke blinkproject op de Arduino UNO; de basiscommando's in de Arduino-omgeving zijn hetzelfde, maar de pinindeling en de 3,3 V-GPIO-niveaus van de ESP32 verschillen van die van de Arduino UNO.

4.7(37)
108
ESP32-bewegingsalarm (PIR + buzzer + LED + Telegram)
ES-41Gevorderd
Premium

ESP32-bewegingsalarm (PIR + buzzer + LED + Telegram)

Een slim beveiligingsalarm: als de PIR-sensor beweging detecteert, gaat de buzzer af, licht de LED op en krijgt de eigenaar direct een Telegram-melding. Een afkoeltijd van 30 seconden beperkt hoe vaak het alarm zich herhaalt; valse detecties van de PIR-sensor filtert dit niet weg. Gebruik het thuis, in een garage, een berging of een studeerkamer.

9
Raspberry Pi Pico: led bedienen met een knop (indrukken)
PI-9Beginner
Premium

Raspberry Pi Pico: led bedienen met een knop (indrukken)

Het eerste invoerproject met de Pico — een knop uitlezen! De led brandt zolang je de knop indrukt en gaat uit als je loslaat. Dit is de grote stap na de ledanimaties: signalen van buiten naar de Pico. Je leert Pin.IN (invoermodus), Pin.PULL_UP (interne pull-upweerstand — standaard voor knoppen) en button.value() uitlezen. GP14 led, GP2 knop (interne PULL_UP). Ingedrukt = LOW (0), losgelaten = HIGH (1) — die omgekeerde logica lijkt eerst verwarrend, maar is de industriestandaard.

11