Датчик температуры KY-001

#include <OneWire.h>
#include <DallasTemperature.h>

// Контакт данных 1-Wire (подключите DATA KY-001 к этому пину)
#define ONE_WIRE_BUS 4

// Создаём объекты OneWire и DallasTemperature
OneWire oneWire(ONE_WIRE_BUS);
DallasTemperature sensors(&oneWire);

void setup() {
    // Инициализация Serial Monitor
    Serial.begin(115200);
    Serial.println("Пример датчика KY-001");

    // Запуск библиотеки DallasTemperature
    sensors.begin();
    Serial.println("Датчик KY-001 инициализирован.");
}

void loop() {
    // Запрос на чтение температуры всех датчиков на шине
    sensors.requestTemperatures();

    // Получение температуры с первого датчика (индекс 0)
    float tempC = sensors.getTempCByIndex(0);

    // Вывод значения в Serial Monitor
    Serial.print("Температура: ");
    Serial.print(tempC);
    Serial.println(" °C");

    // Задержка между измерениями
    delay(2000);
}

Этот Arduino-скетч использует библиотеки OneWire и DallasTemperature для работы с KY-001 по протоколу 1-Wire. В функции setup() инициализируется последовательный порт и библиотека датчиков. В loop() каждые 2 секунды запрашивается температура и выводится в монитор порта. Контакт данных 1-Wire подключен к пину GPIO4 (можно изменить на любой другой).

Требуемые библиотеки

Установите следующие библиотеки через Arduino Library Manager:

1. OneWire — парадрайвер шины 1-Wire
2. DallasTemperature — надстройка для удобной работы с DS18B20

🔗 Библиотека OneWire
🔗 Библиотека DallasTemperature

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

#define ONE_WIRE_GPIO GPIO_NUM_4  // Пин данных 1-Wire

void app_main(void) {
    printf("KY-001 Sensor Test\n");

    // Инициализация 1-Wire шины
    onewire_bus_handle_t bus = onewire_bus_init(ONE_WIRE_GPIO);

    // Буфер для ROM-кода датчика
    uint8_t rom_code[8];

    // Поиск первого датчика на шине
    if (!onewire_search_first(bus, rom_code, false)) {
        printf("Датчик не найден. Проверьте подключение.\n");
        return;
    }

    printf("Датчик KY-001 обнаружен. Начинаю чтение.\n");

    while (1) {
        float temp;
        // Запуск преобразования температуры
        ds18b20_start_conversion(bus, rom_code);
        // Ожидание завершения (750мс для 12-битного разрешения)
        vTaskDelay(pdMS_TO_TICKS(750));
        // Чтение температуры
        ds18b20_get_temperature(bus, rom_code, &temp);

        // Вывод результата
        printf("Температура: %.2f°C\n", temp);

        // Задержка между измерениями
        vTaskDelay(pdMS_TO_TICKS(2000));
    }
}

Этот пример для ESP-IDF использует компоненты onewire и ds18b20 из официального репозитория ESP-IDF. В функции app_main() инициализируется шина 1-Wire на GPIO4, затем выполняется поиск датчика по уникальному ROM-коду. В бесконечном цикле каждые 2 секунды запускается преобразование, ожидается завершение и выводится температура.

Требуемые компоненты

Добавьте в CMakeLists.txt:

idf_component_register(
    SRCS "main.c"
    INCLUDE_DIRS "."
    REQUIRES onewire ds18b20
)

И установите зависимости через idf.py add-dependency или вручную.

# Конфигурация ESPHome для KY-001 (DS18B20)
esphome:
  name: ky001-sensor
  platform: ESP32
  board: esp32dev

# Настройка 1-Wire шины
# Обычно используется любой GPIO, кроме 34-39
onewire:
  - platform: onewire
    id: "onewire_bus_ky001"
    pin: GPIO4

# Сенсор температуры на основе DS18B20/KY-001
sensor:
  - platform: ds18b20
    onewire_id: "onewire_bus_ky001"
    address: !secret ds18b20_address  # Уникальный 64-битный ID
    name: "KY-001 Temperature"
    unit_of_measurement: "°C"
    update_interval: 10s

Эта конфигурация ESPHome настраивает 1-Wire шину на GPIO4 и подключает к ней датчик DS18B20/KY-001. Укажите уникальный 64-битный адрес датчика (можно узнать через скрипт поиска или монитор). Значения температуры будут автоматически публиковаться в Home Assistant с интервалом 10 секунд. Для поиска адреса используйте встроенный лог ESPHome или скрипт:

# Включить логирование для поиска:
logger:
  level: DEBUG

Смотрите консоль при загрузке: там будут выведены все обнаруженные 1-Wire устройства.

platformio.ini

[env:esp32]
platform = espressif32
board = esp32dev
framework = arduino
monitor_speed = 115200
lib_deps =
    paulstoffregen/OneWire@^2.3.5
    milesburton/DallasTemperature@^3.9.0

main.cpp

#include <Arduino.h>
#include <OneWire.h>
#include <DallasTemperature.h>

// Пин данных 1-Wire
#define ONE_WIRE_BUS 4

OneWire oneWire(ONE_WIRE_BUS);
DallasTemperature sensors(&oneWire);

void setup() {
    Serial.begin(115200);
    Serial.println("KY-001 с PlatformIO");

    // Инициализация датчика
    sensors.begin();
    Serial.println("Датчик готов.");
}

void loop() {
    // Запрос температуры
    sensors.requestTemperatures();
    float tempC = sensors.getTempCByIndex(0);

    // Вывод результата
    Serial.print("Температура: ");
    Serial.print(tempC);
    Serial.println(" °C");

    delay(2000);
}

Этот проект PlatformIO настроен для платы ESP32 и использует те же библиотеки OneWire и DallasTemperature, что и обычный Arduino. Преимущество PlatformIO — удобное управление зависимостями и интеграция с VS Code. Код идентичен Arduino-примеру, но управление библиотеками происходит через lib_deps в platformio.ini.

import machine
import time
import onewire
import ds18x20

# Инициализация 1-Wire на GPIO4
pin = machine.Pin(4)
ow = onewire.OneWire(pin)
ds = ds18x20.DS18X20(ow)

# Сканирование шины на наличие датчиков
roms = ds.scan()
print('Найдено датчиков:', len(roms))

if len(roms) == 0:
    print('Датчик KY-001 не обнаружен. Проверьте подключение.')
else:
    print('Датчик готов к чтению.')

# Основной цикл
while True:
    try:
        # Запуск преобразования температуры
        ds.convert_temp()
        time.sleep_ms(750)  # Ждём завершения

        # Чтение температуры всех найденных датчиков
        for rom in roms:
            temp = ds.read_temp(rom)
            print('Температура: {:.2f}°C'.format(temp))

        time.sleep(2)  # Задержка между измерениями

    except Exception as e:
        print('Ошибка:', e)
        time.sleep(2)

Этот скрипт MicroPython использует встроенные модули onewire и ds18x20 для работы с KY-001. На пине GPIO4 создаётся объект OneWire, затем оборачивается в DS18X20. Сканирование шины scan() находит все подключённые датчики и возвращает их уникальные ROM-адреса. В цикле запускается преобразование, ждётся 750 мс (для 12-битного разрешения), затем читается температура. Обработка исключений помогает отловить ошибки связи.