
KY-017 — контактный датчик наклона
Joy-IT · KY-017 (исполнение SensorKit)
Определение изменения ориентации по переключению контакта.
Автор: SLDV LAB
Опубликовано · Обновлено
О МОДУЛЕ
Что делает KY-017 (исполнение SensorKit)
Карточка описывает чёрный цилиндрический KY-017 Joy-IT: его документация указывает шариковый механизм, который меняет состояние при наклоне. Модуль подходит для учебного индикатора положения корпуса. Он выдаёт состояние контакта и не измеряет угол.
Под названием KY-017 другие продавцы также предлагают ртутные выключатели в стеклянной капсуле. Такие исполнения не следует отождествлять с описанной платой или определять их состав только по номеру. Если происхождение выключателя неизвестно, не вскрывайте его и уточните состав у поставщика. Для известного ртутного исполнения нужна соответствующая утилизация. При механическом переключении возможен дребезг.
Описано исполнение Joy-IT SensorKit, показанное в документации. У модулей других поставщиков с тем же обозначением могут отличаться расположение выводов, номиналы и логика выхода. Сверьте маркировку до подачи питания.
Характеристики
- Выход
- Цифровой сигнал S
- Плата примера
- Arduino Uno R3 (ATmega328P)
- Питание модуля
- 5 В в примере Arduino Uno R3. При питании модуля от 5 В его сигналы нельзя подключать напрямую к GPIO/ADC ESP32: нужны подходящее согласование уровней и общая земля. Допустимое питание и уровни другой ревизии проверяйте отдельно.
ПРАКТИКА
Подключение

| Контакт модуля | Контакт платы | Назначение |
|---|---|---|
| + / VCC | 5V | Подключать при полностью обесточенной схеме; проверить маркировку. Arduino Uno R3. |
| − / GND | GND | Общая земля модуля и Arduino Uno R3. |
| S | D2 | Arduino Uno R3; ориентируйтесь по S, а не по положению контакта на другой плате. |
Подходит для Arduino, ESP32. Выберите контакты по документации своей платы.
ВАШ ПРОЕКТ · ВАШ ДАТЧИК
Интегрируйте модуль с ChatGPT
Скопируйте запрос в ChatGPT. Укажите свою плату и среду разработки — получите подключение и код для своего проекта.
Помоги интегрировать KY-017 в мой проект. Сначала уточни точную плату и её ревизию, среду разработки, задачу и фотографию/маркировку модуля. Базовый пример в карточке: Arduino Uno R3, Arduino AVR Boards 1.8.6, питание 5 В, S → D2. Подготовь согласованную распиновку, необходимые зависимости и полный минимальный пример. Не переноси номера выводов Uno на ESP32. Для 3,3-вольтовой платы проверь допустимое питание модуля и исключи подачу 5 В на GPIO/ADC; предложи безопасное согласование. Объясни ограничения измерения, диагностику постоянного уровня и способ проверки результата. Сравните S до и после воздействия. Если уровень не меняется, проверьте питание, общую землю и маркировку S. Дребезг механических контактов может давать несколько переходов на одно событие.
Библиотеки
Установите библиотеку для своей среды и откройте пример из её документации.
Что именно прописать
- Плата и API
Arduino Uno R3 / Arduino AVR Boards 1.8.6Выберите Arduino Uno в Arduino IDE; это 5-вольтовая плата ATmega328P.
- Монитор порта
115200Установите такую же скорость в Serial Monitor / Serial Plotter.
- Выводы примера
S=2Число 2 в скетче означает цифровой D2 Arduino Uno R3.
Arduino Uno R3 — проверка сигнала
cppconst byte SIGNAL_PIN = 2;
int previous = -1;
void setup() {
Serial.begin(115200);
pinMode(SIGNAL_PIN, INPUT_PULLUP);
}
void loop() {
const int state = digitalRead(SIGNAL_PIN);
if (state != previous) {
previous = state;
Serial.println(state == LOW ? "S=LOW" : "S=HIGH");
}
}
Полный скетч для Arduino Uno R3 и API Arduino AVR Boards 1.8.6. Специальная библиотека не нужна. Физический тест с модулем не проводился. Выводятся изменения уровня; подавления дребезга в этом диагностическом примере нет. Очень короткие импульсы опрос может пропустить. Сравните S до и после воздействия. Если уровень не меняется, проверьте питание, общую землю и маркировку S. Дребезг механических контактов может давать несколько переходов на одно событие.
Проекты с этим компонентом
Все проектыСвязанные проекты пока не опубликованы.


