KY-021 — миниатюрный модуль геркона (магнитный датчик)

int reed_magnet = 10;  // Пин, к которому подключен вывод S KY-021
int value;             // Временная переменная

void setup() {
    pinMode(reed_magnet, INPUT);           // Инициализация пина как входа
    Serial.begin(9600);                    // Инициализация Serial Monitor
    Serial.println("KY-021 Magnetic field detection");
}

void loop() {
    // Считываем текущее состояние пина
    value = digitalRead(reed_magnet);

    // Если обнаружен магнит (LOW), выводим сообщение
    if (value == LOW) {
        Serial.println("Magnetic field detected");
        delay(100);  // Пауза 100 мс
    }
}

Этот Arduino скетч подключает KY-021 к цифровому пину 10. При поднесении магнита геркон замыкается, и пин становится LOW (так как на модуле есть подтяжка к VCC). Код периодически опрашивает пин и выводит сообщение в Serial Monitor при обнаружении магнитного поля. Задержка 100 мс снижает нагрузку.

#include <stdio.h>
#include "freertos/FreeRTOS.h"
#include "freertos/task.h"
#include "driver/gpio.h"

#define REED_SWITCH_PIN GPIO_NUM_4  // Пин подключения вывода S KY-021

void app_main(void) {
    // Конфигурация пина как входа с подтяжкой к VCC (Internal pull-up)
    gpio_config_t io_conf = {
        .pin_bit_mask = (1ULL << REED_SWITCH_PIN),
        .mode = GPIO_MODE_INPUT,
        .pull_up_en = GPIO_PULLUP_ENABLE,    // Внутренняя подтяжка к 3.3В
        .pull_down_en = GPIO_PULLDOWN_DISABLE,
        .intr_type = GPIO_INTR_DISABLE      // Прерывания не используем
    };
    gpio_config(&io_conf);

    printf("KY-021 Magnetic Field Detection Test\n");

    while (1) {
        int level = gpio_get_level(REED_SWITCH_PIN);
        // При наличии магнита геркон замыкается, напряжение LOW (0)
        if (level == 0) {
            printf("Magnetic field detected\n");
            vTaskDelay(pdMS_TO_TICKS(100));  // Задержка 100 мс
        }
        vTaskDelay(pdMS_TO_TICKS(100));      // Основной опрос 100 мс
    }
}

Пример на ESP-IDF настраивает GPIO4 как цифровой вход с внутренней подтяжкой к 3.3В (эквивалент INPUT_PULLUP в Arduino). Когда магнит подносится к модулю, геркон замыкается и пин становится LOW. Программа непрерывно опрашивает пин и выводит сообщение при обнаружении поля. Задержка 100 мс в цикле снижает нагрузку на CPU.

# Пример конфигурации ESPHome для KY-021
binary_sensor:
  - platform: gpio
    pin:
      number: GPIO4
      mode: INPUT_PULLUP  # Подтяжка к 3.3В
    name: "KY-021 Magnetic Reed Switch"
    filters:
      - delayed_on: 50ms    # Фильтр дребезга включения
      - delayed_off: 50ms   # Фильтр дребезга выключения
    on_press:
      - then:
          - lambda: |- 
              ESP_LOGD("sensor", "Magnetic field detected!");

ESPHome конфигурация определяет binary_sensor на GPIO4 с режимом INPUT_PULLUP. При срабатывании reed switch (замыкании) пин становится LOW, и бинарный сенсор переходит в состояние «ON». Фильтры задержек (50 мс) убирают дребезг. Событие логируется в Home Assistant.

platformio.ini

[env:esp32]
platform = espressif32
board = esp32dev
framework = arduino
monitor_speed = 115200

src/main.cpp

#define REED_SWITCH_PIN 4

void setup() {
    pinMode(REED_SWITCH_PIN, INPUT_PULLUP);  // Вход с подтяжкой к 3.3В
    Serial.begin(115200);
    Serial.println("KY-021 Magnetic Field Detection Test");
}

void loop() {
    if (digitalRead(REED_SWITCH_PIN) == LOW) {
        Serial.println("Magnetic field detected");
        delay(100);
    }
    delay(100);
}

Проект PlatformIO настраивается для ESP32 на фреймворке Arduino. Пин GPIO4 задаётся как INPUT_PULLUP. При замыкании reed switch (магнит рядом) пин становится LOW, и выводится сообщение. Задержка 100 мс в основном цикле.

import machine
import time

REED_SWITCH_PIN = machine.Pin(4, machine.Pin.IN, machine.Pin.PULL_UP)

while True:
    if REED_SWITCH_PIN.value() == 0:
        print("Magnetic field detected")
        time.sleep(0.1)
    time.sleep(0.1)

MicroPython скрипт настраивает GPIO4 как вход с внутренней подтяжкой к 3.3В (machine.Pin.PULL_UP). При замыкании reed switch пин становится LOW (0), что вызывает вывод сообщения. Двойная задержка 0.1 секунды (~100 мс) между опросами снижает нагрузку.