Компоненты · 10 мин чтения

Бесконтактный датчик уровня жидкости XKC-Y25: подключение к Arduino и код

Бесконтактный датчик уровня жидкости XKC-Y25: ёмкостное обнаружение, толщина стенки, выход NPN/PNP и провод MODE, питание 5–24 V, подключение к Arduino и управление насосом по нескольким уровням.

Бесконтактный датчик уровня жидкости определяет, достигла ли жидкость заданной высоты, без установки каких-либо деталей внутрь бака: достаточно приклеить его снаружи к пластиковой или стеклянной стенке. Самый распространённый и дешёвый пример — XKC-Y25: небольшой диск диаметром 28 мм с белым пластиковым корпусом и четырьмя проводами. Он совсем не касается жидкости, поэтому не ржавеет, не покрывается накипью, не загрязняет питьевую воду и годами работает даже с жидкостями, которые трудно отмыть, например кислотой, кофе или молоком. Это самое чистое решение проблемы вилочных датчиков уровня воды из наборов Arduino, которые покрываются коррозией за несколько недель.

В этом руководстве ты узнаешь, как XKC-Y25 обнаруживает жидкость за стенкой ёмкостным способом и через какие материалы и толщину стенки он работает. Мы подробно разберём различия версий с выходом напряжения, NPN и PNP, цвета проводов и чёрный провод MODE, задающий логику выхода. Затем подключим датчик к Arduino Uno, напишем первый скетч и соберём систему с тремя датчиками, которая отображает уровень в баке в процентах и автоматически управляет насосом. Завершают статью сравнение с поплавковым датчиком уровня, примеры для кофемашины и аквариума, а также код для ESP32 и Raspberry Pi Pico.

Бесконтактный датчик уровня жидкости XKC-Y25
XKC-Y25: ёмкостный датчик уровня жидкости диаметром 28 мм, который приклеивается к внешней стенке бака.

Что такое бесконтактный датчик уровня жидкости и как он работает?

XKC-Y25 — ёмкостный датчик. В передней части его корпуса находится электрод, который вместе с окружающими предметами образует небольшой конденсатор. Когда за стенкой только воздух, ёмкость имеет определённое значение. Когда жидкость поднимается до высоты датчика, она становится частью конденсатора, и ёмкость увеличивается. Диэлектрическая проницаемость воды составляет около 80, а воздуха — около 1, поэтому появление воды вызывает заметное изменение ёмкости. Микросхема внутри датчика непрерывно измеряет это изменение и переключает выход при пересечении заданного порога. Электрическое поле проходит через изолирующие материалы, такие как пластик, стекло и керамика, поэтому датчик работает без контакта с жидкостью. Металл, напротив, экранирует поле, поэтому измерить уровень в металлическом баке снаружи нельзя. Ниже приведены характеристики производителя для версий XKC-Y25-V и XKC-Y25-T12V, которые чаще всего встречаются у продавцов:

ХарактеристикаXKC-Y25 (версия с выходом напряжения)
Напряжение питания5–24 V постоянного тока
Потребляемый токОколо 5 mA
ВыходВысокий уровень = напряжение питания, низкий уровень = 0 V
Выходной ток1–50 mA
Время откликаОколо 500 мс
Толщина стенки для обнаружения0–20 мм (для надёжной работы рекомендуется до 12 мм)
Рабочая температура0–100 °C
ЗащитаIP67, корпус из ABS
РазмерыДиаметр 28 мм, толщина около 17 мм
Регулировка чувствительностиПодстроечный резистор под задней крышкой

Толщина стенки, материал и тип жидкости

Чаще всего спрашивают об ограничении толщины стенки. Хотя производитель указывает обнаружение через стенку до 20 мм, для надёжного и стабильного результата рекомендуется стенка тоньше 12 мм. ПЭТ-бутылки, пластиковые канистры (1–3 мм), аквариумное стекло (4–10 мм) и трубы из ПВХ в любительских проектах вполне укладываются в этот предел. Передняя сторона датчика должна прилегать к стенке полностью и ровно; воздушный зазор сильно снижает чувствительность. Поэтому на цилиндрических баках крепи датчик вдоль вертикальной линии, желательно двусторонним скотчем без вспененной основы или термоклеем. Тип жидкости тоже важен: вода, сок, кофе, молоко, солёная вода и другие жидкости на водной основе обнаруживаются легко. У масел диэлектрическая проницаемость всего около 2–3; с ними датчик часто работает ненадёжно даже при максимальной чувствительности.

СитуацияОбнаруживает?Примечание
Пластиковый бак (PE, PP, PVC, акрил), 1–10 ммДаСамое распространённое и беспроблемное применение
Стеклянная банка, аквариумное стеклоДаДо 10 мм — без труда; для толстого стекла увеличь чувствительность
КерамикаДаСтенка должна быть ровной и тонкой
Металлический бак или бойлер из нержавеющей сталиНетМеталл экранирует поле; добавь к баку пластиковую смотровую трубку
Пластик толщиной 12–20 ммНа пределеУвеличь чувствительность и проверь ложные срабатывания
Вода, кофе, молоко, солёная водаДаВысокая диэлектрическая проницаемость
Масло, бензин, жидкости с высоким содержанием спиртаС трудом или нетНизкая диэлектрическая проницаемость
Порошки и гранулы (сахар, корм для животных)ИногдаМожет работать с влажными плотными порошками; всегда проверяй
Наружная поверхность стенки перед датчиком должна оставаться сухой. Капли конденсата на стенке, влажная ткань рядом с датчиком или прикосновение рукой тоже меняют ёмкость и могут вызвать ложный сигнал «жидкость есть». Густые жидкости, например молоко и кофе, после снижения уровня могут оставлять тонкую плёнку на внутренней стенке, и датчик некоторое время продолжит показывать «полный». Для настройки чувствительности открой заднюю крышку и поверни подстроечный резистор маленькой отвёрткой: против часовой стрелки чувствительность увеличивается, по часовой — уменьшается.

Провода, типы выхода и провод MODE

У XKC-Y25 четыре провода, и их цвета одинаковы у всех версий. Главное — учитывать, что внешне одинаковый датчик продаётся с разными типами выхода. Версия обычно указана на наклейке корпуса или в названии товара: XKC-Y25-V или -T12V имеет выход напряжения, XKC-Y25-NPN — выход с открытым коллектором, а XKC-Y25-PNP — выход, отдающий ток в нагрузку; существуют и версии RS485. Если подключить датчик, не выяснив версию, выход либо не будет переключаться, либо подаст высокое напряжение на Arduino.

Цвет проводаНазначениеПодключение
КоричневыйVCCПлюс питания 5–24 V
СинийGNDМинус питания, общий с GND Arduino
ЖёлтыйOUTСигнальный выход, к входному пину Arduino
ЧёрныйMODEВыбор логики выхода: подключение к VCC или GND

В версии с выходом напряжения при подключении чёрного провода к VCC выход работает с прямой логикой: при обнаружении жидкости на жёлтом проводе HIGH (напряжение питания), а при отсутствии — LOW. Если подключить чёрный провод к GND, логика инвертируется: LOW при обнаружении жидкости и HIGH при её отсутствии. Это позволяет изменить логику схемы, например для «тревоги при пустом баке», без правки кода. В версии NPN выход — транзистор, который в активном состоянии замыкает его на GND; в неактивном состоянии выход «висит в воздухе», и подтягивающий резистор задаёт HIGH. В этой версии выход работает как «нормально разомкнутый» или «нормально замкнутый» в зависимости от того, оставлен ли чёрный провод свободным или подключён к GND. У разных продавцов встречаются небольшие различия, поэтому при первой проверке поднеси руку к баку или используй стакан воды и измерь выход мультиметром.

ВерсияКак работает выходArduino Uno (5 V)ESP32 и Pico (3,3 V)
XKC-Y25-V / T12V (выход напряжения)На выходе 0 V или напряжение питанияПитай датчик от 5 V и подключай напрямуюПри питании 5 V обязателен делитель напряжения
XKC-Y25-NPNВ активном состоянии замыкает выход на GNDС INPUT_PULLUP; датчик можно питать от 5–24 VСамый безопасный вариант, с INPUT_PULLUP
XKC-Y25-PNPВ активном состоянии подаёт на выход напряжение питанияСо стягивающим резистором (pull-down) при питании 5 VНужны делитель напряжения и стягивающий резистор

Подключение к Arduino Uno, ESP32 и Pico

С Arduino Uno проще всего питать датчик с выходом напряжения от 5 V: тогда выход не превысит 5 V и его можно подключить прямо к цифровому пину. ESP32 и Raspberry Pi Pico работают с 3,3 V, поэтому здесь самый безопасный выбор — версия NPN: датчик питается от 5 V (или даже 12 V), а встроенный подтягивающий резистор платы подтягивает выход к 3,3 V. Если используешь версию с выходом напряжения с платой на 3,3 V, снизь выходное напряжение до 3,3 V делителем из резисторов 10 kΩ и 20 kΩ. В таблице ниже указаны пины, которые использует код из этой статьи.

ПодключениеArduino UnoESP32Raspberry Pi Pico
Коричневый (VCC)5VVIN (5 V)VBUS (5 V)
Синий (GND)GNDGNDGND
Чёрный (MODE)5V (HIGH при наличии жидкости)GND или не подключён (NPN)GND или не подключён (NPN)
Жёлтый (OUT), нижний датчикD2GPIO 27, INPUT_PULLUPGP14, PULL_UP
OUT среднего датчикаD3--
OUT верхнего датчикаD4--
IN модуля реле (насос)D7--
ЗуммерD8--
Если питать датчик от 12 V или 24 V, на выходе версии с выходом напряжения или PNP тоже будет 12–24 V; прямое подключение такого выхода к Arduino сожжёт пин и плату. В этом случае используй версию NPN либо добавь делитель напряжения или оптопару. Рассчитать номиналы делителя можно в утилите делителя напряжения. GND датчика и GND платы всегда должны быть соединены.

Первый скетч: есть жидкость или нет?

Собственное время отклика XKC-Y25 — около половины секунды, а при волнении поверхности жидкости выход может переключиться несколько раз. Поэтому первый скетч не использует выход напрямую, а выполняет простую проверку стабильности: ждёт, чтобы значение не менялось 300 мс. Код написан для датчика с выходом напряжения и чёрным проводом, подключённым к 5 V; если логика твоего датчика инвертирована, просто задай константе SIVI_VAR значение LOW. При каждом изменении состояния код выводит сообщение в монитор порта, а встроенный светодиод на D13 горит, пока есть жидкость.

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}

После загрузки закрепи датчик скотчем снаружи пустого пластикового стакана и медленно наливай воду. Когда вода приблизится к середине датчика, светодиод должен загореться, а в мониторе порта появится «Sivi VAR». Если датчик обнаруживает воду слишком рано или совсем не обнаруживает, настрой чувствительность подстроечным резистором: сначала убедись, что в пустом баке нет ложного срабатывания, затем — что в полном обнаружение стабильно. Маленький светодиод сзади датчика тоже показывает состояние обнаружения; при настройке можно следить за ним, не глядя на Arduino.

Несколько точек уровня: управление баком с тремя датчиками

Один XKC-Y25 сообщает только «есть ли жидкость на этой высоте: да или нет». Чтобы отслеживать уровень ступенями, приклей несколько датчиков к стенке бака на разной высоте. С тремя датчиками состояние бака делится на четыре ступени: пустой, низкий уровень, средний и полный. Та же схема отлично подходит для автоматического наполнения: насос включается, когда нижний датчик перестаёт обнаруживать жидкость, и выключается, когда верхний её обнаруживает. Расстояние между двумя датчиками фактически задаёт зону гистерезиса, которая не даёт насосу слишком часто включаться и выключаться; подробно эта идея разобрана в статье про фильтрацию данных датчиков. Код ниже добавляет две меры защиты: если верхний датчик обнаруживает жидкость, а нижний — нет, один из датчиков неисправен, поэтому насос останавливается и звучит тревога; если насос работает больше 60 секунд, но бак не наполняется (источник пуст, шланг отсоединился), он тоже выключается.

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}

В коде процент уровня соответствует высоте крепления датчиков; если на твоём баке они расположены иначе, измени числа. Некоторые модули реле включаются сигналом LOW; если насос работает наоборот, задай константе RELE_ACIK значение LOW. Подробности подключения насоса и реле есть в статьях «Что такое модуль реле?» и «Мини-насос для воды». В реальной системе безопаснее всего сообщать о неисправности через кнопку или сообщение в Telegram и не запускать насос снова до подтверждения пользователем.

Сравнение с поплавковым и вилочным датчиками

XKC-Y25 — не единственный способ измерять уровень жидкости. В любительских проектах чаще всего встречаются три варианта: вилочный датчик с токопроводящими дорожками из наборов Arduino, поплавковый датчик уровня из магнитного поплавка и геркона и ёмкостный бесконтактный датчик. Выбор зависит от материала бака, типа жидкости и бюджета.

ХарактеристикаXKC-Y25 (бесконтактный)Поплавковый датчик уровняВилочный (кондуктивный) датчик
Контакт с жидкостьюНет, измеряет снаружиДа, внутри бакаДа, дорожки находятся в жидкости
Отверстие в бакеНе нужноОбычно нужноНе нужно, но кабель идёт внутрь
ВыходЦифровой (да/нет)Цифровой (контакт)Аналоговый (ступенчатый)
Срок службыОчень долгийДолгий; грязь и накипь могут вызвать заклиниваниеКороткий; дорожки корродируют за несколько месяцев
Металлический бакНе работаетРаботаетРаботает
Пищевые жидкости и питьевая водаПодходит, совсем не касается жидкостиНужны материалы, безопасные для контакта с пищейНе подходит
ЦенаСредняяНизкаяОчень низкая
Питание5–24 V, около 5 mAНе нужно, пассивный контакт3,3–5 V, потребляет ток во время измерения

Для прототипов и коротких испытаний лучше всего подходит вилочный датчик, для простых баков, где отверстие не проблема, — поплавковый, а для долговечных чистых систем, герметичность которых нельзя нарушать, — XKC-Y25. О калибровке вилочного датчика и способах уменьшить коррозию читай в статье про датчик уровня воды.

Примеры применения: кофемашина и аквариум

Кофемашина и кулер для воды: Бак домашней кофемашины обычно сделан из прозрачного пластика. Если приклеить XKC-Y25 к нижней части бака и включать светодиод или блокировать машину, когда вода почти закончилась, это предотвратит работу нагревателя всухую. Датчик рассчитан на температуру до 100 °C, поэтому тёплая поверхность бака не проблема; всё же размещай его на боковой стенке бака, а не прямо над нагревателем. Если добавляешь что-либо внутрь машины, держись подальше от частей под сетевым напряжением и работай только со своей низковольтной схемой.

Автодолив аквариума: Для восполнения испарившейся воды в аквариумах используют отдельную резервную ёмкость и небольшой насос. XKC-Y25, приклеенный снаружи к аквариумному стеклу или отсеку фильтра, запускает насос на несколько секунд при снижении уровня воды. В такой системе необходимы две меры предосторожности: задай насосу максимальное время работы (как в предыдущем коде) и добавь второй датчик в резервную ёмкость, чтобы насос не работал всухую, когда она опустеет. Хорошая привычка — предусмотреть независимый уровень «аварийного останова» с помощью второго датчика выше по стенке для защиты от перелива.

Сигнализация низкого уровня на ESP32

На ESP32 безопаснее всего питать датчик версии NPN от 5 V и считывать выход со встроенным подтягивающим резистором. Тогда, независимо от напряжения питания датчика, на пин ESP32 не поступит больше 3,3 V. Код ниже включает тревогу низкого уровня, если жидкость непрерывно отсутствует 2 секунды, зажигает встроенный светодиод и сообщает, как долго уровень остаётся низким. К этой основе можно добавить Wi-Fi и отправлять сообщение на телефон через Telegram-бота на ESP32 или подключить систему к Home Assistant по MQTT.

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}

Контроль уровня на Raspberry Pi Pico и MicroPython

На Raspberry Pi Pico версия NPN со встроенной подтяжкой тоже является самым простым и безопасным решением. Код ниже считывает датчик на GP14, ждёт, пока значение останется неизменным 1 секунду, и переключает встроенный светодиод при изменении состояния. Если у тебя датчик с выходом напряжения и его необходимо питать от 5 V, подключи жёлтый провод к GP14 через делитель из резисторов 10 kΩ и 20 kΩ и используй обычный вход без подтяжки вместо 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)

Идеи проектов с XKC-Y25

  • Бак для умного полива растений: Останавливай насос и выдавай предупреждение, когда опустеет бак с водой в проекте умной теплицы; измеряй влажность почвы датчиком влажности почвы.
  • Бак на крыше или бак насосной станции: Приклей три датчика к пластиковому баку на разной высоте и показывай уровень в процентах на дисплее.
  • Ёмкость осушителя воздуха: Сделай защиту от перелива, которая останавливает устройство и подаёт звуковой сигнал при заполнении ёмкости.
  • Поилка для питомца: Собери проект на ESP32, который отправляет уведомление на телефон, когда воды становится мало.
  • Дозирование жидкости: Определяй, проходит ли жидкость через шланг или трубу, и не допускай работы насоса всухую.
  • Станция контроля качества воды: Объедини показания уровня с данными датчика TDS и датчика расхода воды.

Частые ошибки и их решения

СимптомВероятная причинаРешение
Выход никогда не меняетсяВерсия определена неверно (нет подтяжки у версии NPN) или нет общей GNDПроверь маркировку версии, используй INPUT_PULLUP для NPN, соедини земли
Логика наличия и отсутствия жидкости инвертированаПровод MODE подключён не так, как ожидаетсяПереключи чёрный провод с VCC на GND или наоборот либо измени константу SIVI_VAR в коде
Не обнаруживает жидкость даже в полном бакеТолстая или металлическая стенка либо воздух между датчиком и стенкойПриклей датчик ровно и плотно, увеличь чувствительность, проверь толщину стенки
Показывает «жидкость есть» даже в пустом бакеСлишком высокая чувствительность, конденсат на стенке, рука или металл рядомПоверни подстроечный резистор по часовой стрелке и держи наружную поверхность стенки сухой
Выход переключается при волнении поверхностиПоверхность колеблется на высоте датчикаУвеличь время подтверждения стабильности в коде или перенеси датчик туда, где меньше волн
Пин Arduino нагрелся или вышел из строяДатчик питался от 12 V, а выход напряжения был подключён напрямуюИспользуй версию NPN или делитель напряжения и питай датчик от 5 V
Не работает с маслянистыми жидкостямиУ масла очень низкая диэлектрическая проницаемостьВыбери поплавковый датчик уровня или другой способ измерения
После снижения уровня некоторое время показывает полный бакГустая жидкость оставляет плёнку на внутренней стенкеУменьши чувствительность и размести датчик там, где жидкость не оставляет плёнку на стенке
Перед окончательным приклеиванием временно закрепи датчик скотчем снаружи бака и несколько раз проверь его с полным, пустым и наполовину заполненным баком. Светодиод на задней стороне датчика — лучший помощник при настройке. Когда результат тебя устроит, очисти поверхность спиртом, закрепи датчик постоянным двусторонним скотчем или термоклеем и прикрепи кабель к баку так, чтобы он не тянул датчик.

Бесконтактный датчик уровня жидкости XKC-Y25 — самый практичный способ измерять уровень, ничего не помещая внутрь бака, не касаясь жидкости и не беспокоясь о ржавчине. Теперь, когда ты знаешь о ёмкостном обнаружении, ограничении толщины стенки, версиях выхода и проводе MODE, можно создавать системы, которые будут работать годами: от кофемашин и аквариумов до полива растений и баков на крыше. В приложении BlueGrays можно изучить проекты, например умную станцию полива, с пошаговыми схемами подключения и готовым кодом и добавить к ним контроль уровня в баке с помощью XKC-Y25.

Частые вопросы

Как работает бесконтактный датчик уровня жидкости?

Бесконтактный датчик уровня жидкости работает ёмкостным способом: ёмкость электрода датчика, приклеенного к внешней стенке бака, увеличивается при подъёме жидкости за стенкой. Когда изменение пересекает порог, микросхема внутри датчика переключает выход. Электрическое поле проходит через пластик, стекло и керамику, поэтому датчик работает без контакта с жидкостью.

Через стенку какой толщины работает XKC-Y25?

Производитель указывает диапазон обнаружения 0–20 мм, но для надёжной и стабильной работы рекомендуется стенка тоньше 12 мм. Ровное прилегание датчика к стенке без зазора заметно повышает чувствительность. Через металлические стенки он не работает при любой толщине.

Работает ли XKC-Y25 на металлическом баке?

Нет. Металлическая стенка экранирует электрическое поле датчика, поэтому он не может обнаружить жидкость снаружи металлического бака. Для такого бака можно приклеить датчик снаружи прозрачной пластиковой смотровой трубки или пластикового окна, соединённых с баком.

Для чего нужен чёрный провод XKC-Y25?

Чёрный провод — это MODE, он задаёт логику выхода. В версии с выходом напряжения при подключении чёрного провода к VCC обнаружение жидкости даёт HIGH; при подключении к GND — LOW. Так можно получить выход, активный при полном или пустом баке, без изменения кода.

Как подключить XKC-Y25 к Arduino?

Подключи коричневый провод к 5V, синий — к GND, жёлтый выходной — к цифровому пину, например D2, а чёрный MODE — к 5V или GND в зависимости от нужной логики. Для версии NPN настрой пин как INPUT_PULLUP. Если питаешь датчик от 12 V, не подключай выход напряжения прямо к Arduino.

Что лучше: бесконтактный или поплавковый датчик уровня?

Бесконтактный датчик не касается жидкости, поэтому не ржавеет, не покрывается накипью, не требует отверстия в баке и лучше подходит для питьевой воды и пищевых жидкостей. Поплавковый датчик уровня дешевле, не требует питания и работает в металлических баках, а также с жидкостями с низкой диэлектрической проницаемостью, например маслом. Выбор зависит от материала бака и типа жидкости.

Все проекты
Умная станция полива
AR-83Продвинутый
Premium

Умная станция полива

Садовник, который сам поливает растения, чтобы они не засохли, пока ты в отпуске.

5.0(42)
57
Работа с зуммером
AR-13Новичок

Работа с зуммером

Интересно, как дверной звонок или сигнализация издают звук? Arduino заставляет маленький зуммер пищать через короткие промежутки: пик, пауза, пик, пауза.

4.7(92)
170
Управление светодиодом кнопкой (удержание)
AR-9Новичок

Управление светодиодом кнопкой (удержание)

Как дверной звонок: свет горит, пока ты нажимаешь, и гаснет, когда отпускаешь. Arduino всё время слушает кнопку; пока она нажата, светодиод горит, а как только ты убираешь палец, он гаснет.

4.8(114)
253
Мигающий светодиод
AR-1Новичок

Мигающий светодиод

Самое первое «привет» в электронике: включение и выключение одного светодиода. Arduino включает и выключает светодиод через короткие промежутки, поэтому свет быстро мигает.

4.6(200)
1246
Мигающий светодиод на ESP32
ES-1Новичок

Мигающий светодиод на ESP32

Учит базовой работе с выходами GPIO на ESP32. Эффект мигания получается включением и выключением светодиода с цифрового пина. Это ESP32-версия классического проекта мигания на Arduino UNO; базовые команды мигания в среде Arduino те же, но расположение пинов ESP32 и уровни GPIO 3,3 V отличаются от Arduino UNO.

4.7(37)
108
Сигнализация движения на ESP32 (PIR + зуммер + светодиод + Telegram)
ES-41Продвинутый
Premium

Сигнализация движения на ESP32 (PIR + зуммер + светодиод + Telegram)

Умная охранная сигнализация, которая при обнаружении движения PIR-датчиком включает зуммер и светодиод и одновременно сразу отправляет владельцу уведомление в Telegram. В ней есть 30-секундная пауза, ограничивающая частоту повторных тревог; этот механизм не проверяет срабатывания PIR и не устраняет ложные тревоги. Подходит для дома, гаража, склада или мастерской. С ESP32-CAM можно добавить уведомления с фото, а с обычной ESP32 DevKit V1 приходят текстовые.

9
Светодиод с управлением кнопкой на Pico (удержание)
PI-9Новичок
Premium

Светодиод с управлением кнопкой на Pico (удержание)

Первый проект Pico с входом — чтение кнопки! Светодиод горит, пока кнопка нажата, и гаснет после отпускания. Это большой шаг после светодиодных анимаций: сигнал из внешнего мира в Pico. Изучи Pin.IN (режим входа), Pin.PULL_UP (встроенный подтягивающий резистор — стандарт для кнопок) и чтение button.value(). Светодиод на GP14, кнопка на GP2 (встроенный PULL_UP). Нажата = LOW (0), отпущена = HIGH (1) — обратная логика сначала путает, но это промышленный стандарт.

11