Arduino Leonardo и USB Host Shield

Почему нужен Leonardo, а не Uno

Всё дело в микроконтроллере. В Leonardo стоит ATmega32u4 со встроенным в чип USB, поэтому плата может сама представляться компьютеру клавиатурой, мышью или serial-портом. Uno так не умеет: его USB-разъём подключён к отдельному чипу-мосту, единственная задача которого — serial, так что выдать себя за мышь он не сможет никогда. Это единственное отличие и есть вся причина, по которой в этой сборке указан именно Leonardo. По этой же причине Uno, который у вас уже есть, не заработает, как ни пиши код. Платы на том же чипе 32u4, например Pro Micro, работают по тому же принципу.

Какие детали нужны

Для сборки нужны две платы и два кабеля. В этой простоте вся привлекательность, и это действительно самый дешёвый путь к работающему курсору.

Arduino Leonardo

ATmega32u4 с родным USB. Отдаёт игровому ПК интерфейс мыши, и через него же идёт serial-канал

USB Host Shield 2.0

На нём стоит USB-хост-контроллер MAX3421E, с которым плата общается по SPI. Это та половина, в которую подключается ваша настоящая мышь

Библиотека

USB Host Shield Library 2.0 — она отвечает за работу с HID-мышью на стороне хоста

Кабель к игровому ПК

Собственный разъём micro-USB на Leonardo. Это HID-сторона

Кабель ко второму ПК

В сборке с одним кабелем — тоже USB-разъём Leonardo, а если хотите физически разделить каналы — отдельный USB-serial адаптер на UART

Паяльник

На практике обязателен. Подробности в следующем блоке

Как загрузить скетч

Когда разводка правильная, загрузка проста, но прежде чем писать или прошивать что-то сложнее, убедитесь, что сторона хоста работает.

1. 01Установите Arduino IDE и добавьте USB Host Shield Library 2.0 через менеджер библиотек
2. 02Выберите Tools, затем Board, затем Arduino Leonardo и укажите порт, на котором появилась плата
3. 03Загрузите из библиотеки пример диагностики USB host board и откройте монитор порта: он должен сообщить, что контроллер найден и инициализирован
4. 04Загрузите из библиотеки пример HID-мыши, подключите к шилду проводную мышь и убедитесь, что движение и клики выводятся в монитор порта
5. 05Только после этого загружайте passthrough-прошивку, которую ожидает ваш чит, не меняя плату и порт
6. 06Запишите скорость, с которой скетч открывает serial-канал: то же значение нужно будет ввести в чите
7. 07После финальной загрузки передёрните питание сборки, а не полагайтесь на программный сброс

Почему номер COM-порта всё время меняется

У Leonardo serial-порт — часть USB-гаджета самой платы, а не отдельный чип-мост. Поэтому номер COM может меняться при сбросе платы и меняется снова, когда во время загрузки плата входит в загрузчик. Для сборки, которую вы то и дело перепрошиваете, это нормально. Когда определитесь с финальной прошивкой, найдите порт в диспетчере устройств и принудительно назначьте ему маленький однозначный номер в Port Settings → Advanced («Параметры порта» → «Дополнительно»). Затем введите этот номер в чите. Если хотите полностью отделить канал управления от игрового ПК, возьмите его с аппаратного UART через USB-serial адаптер. Тогда игровой ПК видит просто мышь и ничего больше.

Чем вы расплачиваетесь за низкую цену

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

Что проверить, прежде чем решить, что оно сломано

• Плата — Leonardo или другая плата на ATmega32u4, а не Uno
• Линии SPI шилда доходят до разъёма ICSP — через гнездо или через провода
• Диагностика платы из библиотеки сообщает, что MAX3421E найден
• Простая проводная мышь выводит движение в примере HID-мыши
• Игровой ПК показывает устройство мыши, когда к нему подключён Leonardo
• Номер COM в чите совпадает с номером в диспетчере устройств и состоит из одной цифры
• Скорость в чите совпадает со значением в скетче

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