Keyboard

Описание

Функции клавиатуры позволяют платам на базе микроконтроллеров 32u4 или SAMD отправлять нажатия клавиш на подключённый компьютер через встроенный USB-порт микроконтроллера.

Примечание

Не каждый возможный ASCII-символ, особенно непечатаемые, можно отправить с помощью библиотеки Keyboard.

Библиотека поддерживает использование клавиш-модификаторов. Клавиши-модификаторы изменяют поведение другой клавиши при одновременном нажатии. Дополнительную информацию о поддерживаемых клавишах и их использовании смотрите здесь.

Совместимое оборудование

HID поддерживается на следующих платах:

Плата

Поддерживаемые пины

Leonardo

Все цифровые и аналоговые пины

Micro

Все цифровые и аналоговые пины

Due

Все цифровые и аналоговые пины

Zero

Все цифровые и аналоговые пины

UNO R4 Minima

Все цифровые и аналоговые пины

UNO R4 WiFi

Все цифровые и аналоговые пины

GIGA R1 WiFi

Все цифровые и аналоговые пины

Nano ESP32

Все цифровые и аналоговые пины

Семейство MKR

Все цифровые и аналоговые пины

Примечания и предупреждения

Эти основные библиотеки позволяют платам на базе 32u4 и SAMD (Leonardo, Esplora, Zero, Due и семейство MKR) выступать в роли встроенной мыши и/или клавиатуры для подключённого компьютера.

Предупреждение

Предупреждение об использовании библиотек Mouse и Keyboard: если библиотека Mouse или Keyboard работает постоянно, будет сложно программировать вашу плату. Функции, такие как Mouse.move() и Keyboard.print(), будут перемещать курсор или отправлять нажатия клавиш на подключённый компьютер и должны вызываться только тогда, когда вы готовы их обрабатывать. Рекомендуется использовать систему управления для включения этой функциональности, например, физический переключатель или реагирование только на определённый контролируемый ввод. Обратитесь к примерам Mouse и Keyboard для получения информации о способах управления этим.

При использовании библиотеки Mouse или Keyboard лучше сначала протестировать вывод с помощью Serial.print(). Таким образом вы сможете убедиться, какие значения передаются.

Функции

  • Keyboard.begin()

  • Keyboard.end()

  • Keyboard.press()

  • Keyboard.print()

  • Keyboard.println()

  • Keyboard.release()

  • Keyboard.releaseAll()

  • Keyboard.write()

См. также

  • KeyboardAndMouseControl: Демонстрирует команды Mouse и Keyboard в одной программе.

  • KeyboardMessage: Отправляет текстовую строку при нажатии кнопки.

  • KeyboardLogout: Выход текущего пользователя с помощью клавиатурных команд.

  • KeyboardSerial: Считывает байт из последовательного порта и отправляет обратно нажатие клавиши.

  • KeyboardReprogram: Открывает новое окно в Arduino IDE и перепрограммирует плату простой программой мигания.