Гайд по сплит клавиатурам

Гайд по сплит клавиатурам

https://habr.com/ru/articles/797523/?utm_source=habrahabr&utm_medium=rss&utm_campaign=797523

Для изменения раскладки:

  1. Откройте файл keymap.c в вашем текстовом редакторе.

  2. Модифицируйте массивы, представляющие слои клавиатуры, заменяя коды клавиш на нужные вам.

  3. Сохраните изменения и скомпилируйте прошивку, следуя инструкциям по сборке QMK.

Отличие изменения раскладки в QMK и в VIA / Vial:

  • QMK:

    • Изменения делаются на уровне кода, что предоставляет максимальную гибкость и позволяет добавлять сложные макросы и функции.

    • Требуется компиляция и прошивка клавиатуры после каждого изменения раскладки.

    • Изменения являются постоянными до следующей перепрошивки.

  • VIA / Vial:

    • Позволяют изменять раскладку в реальном времени через графический интерфейс пользователя без необходимости компиляции и перепрошивки.

    • Идеально подходят для быстрой настройки и тестирования различных раскладок.

    • Не требуют глубоких знаний в программировании.

    • Важно, чтобы ваша клавиатура была поддерживаема VIA/Vial и имела предварительно загруженную соответствующую прошивку.

4.1.5. Компиляция прошивки

Если у вас уже установлено все необходимое программное обеспечение и подготовлена раскладка для вашей клавиатуры в QMK, вы можете приступить к компиляции прошивки. Вот инструкция по компиляции прошивки QMK с учетом этих условий:

Шаг 1: Открытие терминала или командной строки

Откройте терминал на macOS или Linux, или командную строку/PowerShell на Windows.

Шаг 2: Переход в директорию QMK Firmware

Перейдите в каталог qmk_firmware, который содержит исходный код QMK и вашу раскладку. Если вы клонировали репозиторий QMK Firmware в свой домашний каталог, команда будет выглядеть примерно так:

cd ~/qmk_firmware

Шаг 3: Компиляция вашей раскладки

Для компиляции используйте команду qmk compile. Укажите путь к вашей раскладке, используя следующий формат: <keyboard_name>:<keymap_name>. Например, если ваша раскладка называется "my_custom_layout" для клавиатуры "my_keyboard", команда будет следующей:

qmk compile -kb my_keyboard -km my_custom_layout

Эта команда создаст файл прошивки в формате .hex или .bin, который будет использоваться для прошивки вашей клавиатуры. Результат компиляции, включая путь к файлу прошивки, будет отображен в консоли после завершения процесса.

Шаг 4: Загрузка прошивки на клавиатуру

После успешной компиляции используйте QMK Toolbox или другой инструмент для загрузки файла прошивки на вашу клавиатуру. Для этого:

  1. Откройте QMK Toolbox.

  2. Подключите вашу клавиатуру к компьютеру и переведите ее в режим прошивки

  3. В QMK Toolbox выберите файл прошивки, который вы создали на предыдущем шаге.

  4. Нажмите кнопку "Flash" для начала процесса прошивки.

После завершения процесса ваша клавиатура будет перезагружена с новой прошивкой и готова к использованию.

4.2. Введение в Vial

Vial — это инструмент для настройки клавиатур, который расширяет возможности QMK и предлагает удобный графический интерфейс пользователя (GUI). Он упрощает процесс настройки раскладок клавиш, макросов и подсветки, делая его доступным для широкого круга пользователей, независимо от их опыта в программировании. Также Vial позволяет изменять раскладку и другие настройки клавиатуры без необходимости компилировать прошивку. Vial доступен для скачивания на официальном сайте, где можно найти последнюю версию инструмента для различных операционных систем. Также существует веб-версия Vial, которая позволяет быстро и легко настраивать клавиатуры прямо в браузере.

4.2.1. Отличия Vial от VIA

Хотя Vial и VIA оба предлагают графический интерфейс для настройки клавиатур на базе QMK, между ними есть ключевые отличия:

  • Функциональность: Vial вводит дополнительные функции, такие как автоматическое переключение слоев и более сложные макросы, которых нет в VIA.

  • Пользовательский интерфейс: Vial может предложить более комплексный интерфейс с дополнительными настройками, что делает его более мощным, но потенциально менее интуитивным для новичков.

  • Совместимость и настройка: VIA известна своей широкой поддержкой клавиатур "из коробки", в то время как Vial может требовать дополнительной настройки для полной совместимости с некоторыми устройствами.

4.2.2. Переназначение клавиш (вкладка Keymap)

Переназначение клавиш располагается во вкладке Keymap. Здесь можно назначить определенные действия и символы каждой клавише, а также управлять слоями раскладки.

Чтобы переназначить клавишу, вам необходимо выполнить несколько простых шагов:

  1. Выберите необходимый слой.

  2. Нажмите на клавишу, которую вы хотите переназначить на визуальном макете клавиатуры.

  3. Выберите функцию из списка, которую хотите назначить на эту клавишу.

Теперь давайте посмотрим, что включает в себя каждая из вкладок со списком функций:

4.2.2.1. Basic

Здесь находятся основные действия клавиш, такие как буквы, цифры и стандартные пунктуации.

4.2.2.2. ISO/JIS

Эта вкладка предназначена для специфических клавиш, которые используются в стандартах клавиатур ISO или JIS, часто встречающихся в европейских и японских раскладках соответственно.

4.2.2.3. Layers

В этой вкладке находятся функции, связанные с перемещением между слоями.

  • MO(layer): "Momentary Layer Switch" или "Мгновенное переключение слоя". Эта функция временно активирует указанный слой, пока зажата соответствующая клавиша. Когда клавиша отпущена, активный слой возвращается к предыдущему.

  • DF(layer): "Default Layer Set" или "Установка слоя по умолчанию". Эта функция устанавливает указанный слой как базовый (по умолчанию) слой, переключая клавиатуру на использование этого слоя до тех пор, пока не будет выбран другой базовый слой.

  • TG(layer): "Toggle Layer" или "Переключение слоя". Эта функция переключает указанный слой во включенное или выключенное состояние каждый раз, когда активируется соответствующая клавиша. Если слой уже активен, он будет деактивирован, и наоборот.

  • TT(layer): "Tap Toggle" или "Переключение при нажатии". Эта функция позволяет активировать слой при нескольких нажатиях на клавишу. Количество нажатий, необходимых для активации слоя, может быть настроено.

  • OSL(layer): "One Shot Layer" или "Однократное переключение слоя". Эта функция активирует указанный слой до момента следующего нажатия клавиши, после чего слой автоматически деактивируется. Это удобно для выполнения одиночных команд или сочетаний клавиш на другом слое.

  • LT(layer, kc): "Layer Tap" или "Слой при касании". Эта функция позволяет клавише выполнять двойную функцию: при кратковременном нажатии активируется указанная клавиша (kc), а при удержании — переключается на указанный слой (layer). Это позволяет экономить место на клавиатуре, объединяя функции клавиш.

4.2.2.4. Quantum

Здесь находятся коды клавиш из прошивки QMK, наведите на любую из клавиш для появления описания.

4.2.2.5. Backlight

Управление настройками подсветки клавиатуры, если таковая имеется.

4.2.2.6. App, Media and Mouse

Действия, связанные с управлением приложениями, мультимедиа и мышью (мультимедийные клавиши, управление курсором и т.д.).

4.2.2.7. Tap Dance

В этой вкладке вы можете найти созданные вами клавиши Tap Dance, инструкцию о том, как их создавать, вы найдете ниже.

4.2.2.8. Вкладка User

Пользовательские клавиши, которые можно создать самому добавить в прошивку.

4.2.2.9. Вкладка Macro

Создание и редактирование макросов для автоматизации последовательностей клавиш.

4.2.3. Создание собственных клавиш (функций)

4.2.3.1. Создание макросов (Macros)

Во вкладке "Macros" пользователи могут создавать, редактировать и удалять макросы. Макросы — это последовательности действий, которые могут быть активированы одним нажатием клавиши, облегчая выполнение рутинных задач. Вы можете выбрать абсолютно любые действия по нажатию клавиши, будь то сложная последовательность символов или полноценное предложение.

Для создания собственного макроса выберете номер макроса сверху (M0, M1, M2 и т.д.)

Используйте кнопки управления, расположенные в правом нижнем углу окна, для добавления действий в макрос:

  • Add Action: Добавляет новое действие в ваш макрос, после чего вам нужно выбрать функцию или функции, которые будет активироваться, а так же что будет имитировать это действие:

    1. Text: Позволяет ввести текст, который будет автоматически введен при активации макроса. Например, если вы хотите, чтобы ваш макрос вводил ваш e-mail адрес, вы выбираете опцию "Text" и вводите адрес.

    2. Down: Имитирует нажатие клавиши, т.е. клавиша считается нажатой и удерживаемой вниз. Это полезно для создания макросов, где требуется удержание клавиши, например, для сочетаний клавиш.

    3. Up: Имитирует отпускание клавиши. Это используется после "Down" для создания полной последовательности нажатия и отпускания клавиши.

    4. Delay: Добавляет временную задержку между действиями в макросе. Это может быть необходимо для того, чтобы дать системе время на обработку предыдущих команд перед выполнением следующих.

  • Tap Enter: Упрощает добавление действия нажатия клавиши Enter в конец макроса.

  • Record Macro: Позволяет начать запись последовательности действий с вашей физической клавиатуры.

Пример максора для сочетания клавиш Ctrl+Shift+Esc

После добавления действий, вы можете изменить их порядок, используя стрелки перемещения, расположенные слева от списка действий. Убедитесь, что все действия расположены в нужном порядке для исполнения макроса.

Когда вы полностью настроили макрос, нажмите кнопку "Save" для сохранения ваших изменений. Если вы хотите отменить последние изменения и вернуться к предыдущей конфигурации, используйте кнопку "Revert".

4.2.3.2 Создание клавиш Tap Dance

Tap Dance — это функция в QMK, которая позволяет клавише выполнять разные действия в зависимости от того, сколько раз и как быстро она была нажата. На этой вкладке можно настроить эти действия для каждой клавиши.

В этой вкладке пользователь может создать свою функцию, присваивая ей уникальный номер. Например, если пользователь выбирает номер 1 для своей "Tap Dance" клавиши, в коде прошивки это действие будет обозначаться как TD(1).

После выбора номера для "Tap Dance" клавиши, пользователь может назначить различные действия для разного количества нажатий или удержаний этой клавиши:

  • Одиночное нажатие: Выполнение одной команды при однократном нажатии.

  • Двойное нажатие: Выполнение другой команды при двойном нажатии.

  • Удержание: Выполнение команды при удержании клавиши.

  • Нажатие + удержание: Выполнение ещё одной команды при сначала нажатии, а затем удержании клавиши.

Пользователь также может настроить время (Tapping term), за которое считается, что клавиша удерживается. Это время определяет, как быстро система должна отличать между удержанием и одиночным/двойным нажатием. Корректная настройка этого времени важна для удобства использования и точности распознавания желаемых действий пользователя.

4.2.3.3 Создание комбинаций клавиш (Combos)

Принцип работы комбинаций клавиш заключается в следующем:

  • Комбинация клавиш (Combo): Это когда пользователь нажимает несколько клавиш одновременно или почти одновременно, чтобы активировать отдельное действие или команду, которое отличается от того, что произошло бы при нажатии каждой из этих клавиш по отдельности.

  • Key 1, Key 2, Key 3, Key 4: Это места для назначения клавиш, которые будут участвовать в комбинации. Пользователь может выбрать любые клавиши на клавиатуре для создания комбо. Например, если комбо требует одновременного нажатия "A" и "S", то пользователь поместит "A" в поле "Key 1" и "S" в поле "Key 2".

  • Output Key: Это поле для назначения результата активации комбинации. Например, если пользователь хочет, чтобы при нажатии "A" и "S" одновременно на экран выводился символ "&", то "&" будет указан в поле "Output Key".

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

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

4.2.3.4. Вкладка "Key Overrides"

Функция "Key Overrides" в интерфейсе Vial позволяет пользователю изменять стандартное поведение клавиш на клавиатуре при нажатии вместе с модификаторами. Это может использоваться для создания кастомных горячих клавиш или изменения функциональности клавиш в зависимости от активного слоя или нажатых модификаторов. Рассмотрим интерфейс создания переопределения.

Чтобы создать своё переопределение клавиш, выполните следующие шаги:

  1. Включите переопределение: Поставьте галочку в поле "Enable".

  2. Выберите слои: Определите, на каких слоях будет действовать переопределение. Вы можете выбрать конкретные слои, на которых хотите включить переопределение, или выбрать "Enable all", чтобы активировать его на всех слоях.

  3. Установите триггерную клавишу: Введите или выберите клавишу в поле "Trigger", которую хотите переопределить (например, "A").

  4. Настройте модификаторы-триггеры: Укажите модификаторы в разделе "Trigger mods", которые должны быть нажаты для активации переопределения (например, "LShift").

  5. Настройте отрицательные модификаторы: В разделе "Negative mods" выберите модификаторы, которые, если не нажаты, также будут активировать переопределение. (Можно оставить пустым)

  6. Настройте подавляемые модификаторы: В разделе "Suppressed mods" выберите модификаторы, которые будут игнорироваться при активации переопределения. (Можно оставить пустым)

  7. Установите клавишу замены: В поле "Replacement" введите клавишу, которая будет использоваться вместо оригинальной триггерной клавиши (например, "G").

  8. Настройте дополнительные параметры: В разделе "Options" выберите нужные параметры активации и деактивации переопределения. Это включает в себя активацию при нажатии триггерной клавиши, при нажатии необходимого модификатора и при отпускании отрицательного модификатора.

После того как вы настроите все параметры, ваше переопределение клавиш будет готово к использованию.

Пример переопределения: LCtrl + Bksp меняется на Del

4.2.3.5 Вкладка "QMK Settings"

В этой вкладке находятся дополнительные настройки QMK. Она содержит в себе несколько вложенных вкладок, вот краткое описание каждой из них:

  • Magic: Настройки "Magic" позволяют включать и отключать различные специальные функции и переключения, такие как замена Caps Lock на Control или включение N-key rollover.

  • Grave Escape: Эта вкладка позволяет настроить клавишу Grave/Tilde (` и ~) для выполнения функции клавиши Escape в зависимости от того, какие модификаторы нажаты одновременно с ней.

  • Tap-Hold: Здесь можно дополнительно настроить поведение Tap-Hold клавиш.

  • Auto Shift: Настройки "Auto Shift" позволяют автоматически получать заглавные буквы или другие символы при длительном нажатии клавиши.

  • Combo: Настройки комбо позволяют определить время ожидания для активации комбинаций клавиш.

  • One Shot Keys: В этой вкладке можно настроить однократные клавиши, которые остаются активными до следующего нажатия клавиши, с возможностью установки таймаута.

  • Mouse keys: Позволяют настроить поведение клавиш, которые управляют курсором мыши, включая скорость движения курсора, ускорение и задержку между движениями.

4.2.3.6. Вкладка "Matrix tester"

"Matrix tester" — это инструмент для диагностики клавиатур. Он позволяет проверить работоспособность каждой клавиши и убедиться, что матрица клавиатуры функционирует правильно, отображая нажатия в реальном времени.

5. Сообщества и ресурсы

Документация

Reddit

GitHub

Форумы и веб-сайты

  • Geekhack: Форум для обсуждения новостей, проектов и гайдов по механическим клавиатурам.

  • AtomBoards Наш сайт

Discord

  • MechKeys: Канал Discord для обсуждения механических клавиатур, включая сплит-модели. К сожалению, прямая ссылка на приглашение в Discord может изменяться, поэтому рекомендуется поискать актуальную ссылку через поиск в Discord или на соответствующих форумах и сайтах.

YouTube

Telegram

Report Page