Аналоговый джойстик: подключение к Arduino и чтение осей

Джойстик из стартового набора я первые полчаса подозревал в браке: ручка стояла в покое, а монитор печатал x=503 и y=521 вместо учебных 512. Я пересаживал провода, менял аналоговые входы, перечитывал распиновку — числа держались. Разрешение пришло скучное: у каждого реального модуля центр свой, и полоса 500-523 в покое — это норма, а не дефект. Полчаса на пересадку проводов я мог бы сэкономить, зная полосу допусков, — теперь она висит у меня на стене над столом. Симулятор с его идеальными 512 эту правду замаскировал бы, поэтому первый запуск я советую делать на живой плате и сразу с честными ожиданиями.

Сам модуль называется KY-023 и устроен прозрачнее, чем кажется: внутри два потенциометра по 5 кОм — по одному на ось — плюс тактовая кнопка под стержнем ручки. Концы каждого потенциометра сидят на питании и земле, а средний отвод выведен наружу на контакты VRx и VRy. Наклон стержня поворачивает пластиковый крест, движки съезжают, и напряжение на отводах ползёт от нуля вольт до питания: analogRead превращает его в число от 0 до 1023.

Кнопка SW живёт отдельно от осей: нажатие замыкает её контакт на землю, в покое линия подтянута к 5 В. В этом уроке подключим все пять контактов, научимся печатать кадры парами x= y= sw=, откалибруем центр под конкретный экземпляр и поставим мёртвую зону 480-540, чтобы покой не притворялся движением. Направления — лево, право, верх, низ — мы уже строили в уроке про две оси; здесь копаем глубже, в железо и допуски.

Схема подключения занимает минуту. VCC идёт к 5 В, GND к земле, VRx к A0, VRy к A1 — и оси уже читаются. Это тот же делитель напряжения, что и у одиночного потенциометра из урока про analogRead, только движков два и командует ими один стержень. Номинал 5 кОм подобран удачно: ток через движок — доли миллиампера, вход АЦП нагрузку не чувствует, показания не плывут. Встречаются партии и с 10-килоомными движками — на чтение это не влияет: АЦП видит одну и ту же пропорцию делителя.

Кнопка SW сядет на любой цифровой вход. В симуляторе автоподбор макетки отдаёт ей A2; на живой плате я сразу вешаю SW на D2 — там живут внешние прерывания, которые пригодятся в меню из третьего урока этого кластера. У типовых модулей резистор подтяжки к 5 В уже распаян на плате, поэтому в покое digitalRead видит HIGH, при нажатии — LOW. Клоны без резистора тоже встречаются, и для них спасает INPUT_PULLUP в скетче: полярность при этом не меняется, а вход перестаёт зависеть от щедрости производителя.

Механика — вторая половина правды о показаниях. Возвратная пружина возвращает стержень в центр, но не идеально: у изношенных модулей ручка не доходит до крайних положений, и вместо 0-1023 вы увидите, скажем, 8-1015. Поэтому первое, что я делаю с новым джойстиком, — гоняю ручку до упора в четыре стороны и записываю минимумы с максимумами. Эти четыре числа потом кормятся в map, и весь ход ручки распределяется по диапазону без мёртвых сантиметров на краях. Заодно проверьте дрожь на упорах: у живого модуля число на краю стоит как вкопанное, у разбитого — плавает на десяток единиц, и это второй аргумент за мёртвую зону.

Читать оси удобно кадрами: пары x= и y= с шагом 250 миллисекунд дают читаемый лог и три именованных ряда на графике Serial Plotter. Кнопку печатаем в том же кадре числом sw=: единица в покое, ноль при нажатии. На живой плате кадры полезно снимать и рядом с вибрацией — моторы подмешивают шум, и полоса покоя расползается на глазах. Запустите скетч и не трогайте ручку — центр ляжет где-то в полосе 500-523: два резистора делителя имеют допуск, пружина возвращает стержень с небольшим недолётом, и у каждого экземпляра точка покоя своя. В симуляторе полоса сжата в одну точку 512 — макетка не знает допусков, и это удобно для отладки логики.

Мёртвая зона — коридор вокруг центра, внутри которого чтения считаются покоем. Полоса 480-540 покрывает и разброс центра, и шум в пару единиц; стоит отдать ось на серво — и без зоны каждое качание на 3-5 единиц превращается в микродёрганье рычага. Шире 100 единиц коридор не делайте: ручка перестанет отвечать вблизи центра, и управление станет ступенчатым. Если шум больше ожидаемого — сначала среднее нескольких чтений АЦП, потом расширение зоны: пять замеров гасят дрожь последних единиц почти бесплатно. Свою полосу покоя я смотрю по логу за минуту: если за шестьдесят секунд ни один кадр не вышел за 490-535, коридор 480-540 закроет всё с запасом.

Калибровка центра в setup — мой постоянный ритуал: десять чтений с паузой по 10 миллисекунд, среднее — и в переменную. Стоит это сто миллисекунд при старте, а взамен покой всегда даёт ноль отклонения: разность вычисляется от своего центра, а не от бумажных 512. На живой плате строка centerX=507 в начале лога честно говорит, где у вашего модуля середина хода, и все дальнейшие пороги откладываются от неё. В симуляторе centerX= выйдет ровно 512 — и это тоже тест: если строка печатает другое, скетч читает не тот пин.

С кнопкой работают те же мысли, что и с осью: печатайте сырой уровень и доверяйте фронтам. Для счёта нажатий этого мало — дребезг тактовой кнопки превращает один щелчок в три-пять событий, и лечится он дебаунсом, которому посвящён третий урок кластера. Куда отдать оси дальше — вопрос одного провода: сервопривод SG90 на D11 получает угол оси через map, а ручное управление углом мы уже делали с обычным потенциометром — джойстик отличается тем, что сам возвращается в центр.

История с «уехавшей» осью случилась у меня уже в готовой сборке: неделю кадры стояли по центру 511, потом x в покое намертво сел на 534. Я грешил на модуль, а виноват оказался удлинитель метр с лишним — передавленная жилка в линии VRx дала лишнее сопротивление, и ось уползла. С тех пор джойстик длиннее метра не тяну, а после любой пересборки макетки сначала смотрю кадр покоя и только потом калибрую центр заново.

На живой плате к арифметике добавляется макетка. Плохой контакт в проводе VRx даёт щелчки в логе: x прыгает на сотни единиц на мгновение и возвращается. Мой порядок диагностики простой: сначала пошевелите провода при работающем логе — прыжки в кадрах показывают виновника точнее любых догадок; потом пересадите VRx с A0 на A1 — если симптом переехал за проводом, дело в линии, если остался — в модуле. Десять чтений для калибровки — минимальная планка: при шумной макетке берите двадцать-тридцать, это всё ещё меньше трёхсот миллисекунд на старте. Симулятор этой комнаты с граблями лишён, зато логика зон на нём отрабатывается без помех.