Прошивка и слои в QMK/VIA: быстрый старт без кирпича

Чтобы прошить клавиатуру и настроить слои, новичку проще всего: один раз поставить VIA-совместимую прошивку, а затем собрать Base + FN в VIA. QMK нужен, когда упираетесь в ограничения интерфейса и хотите логику “как код”.

Оглавление

QMK или VIA: что выбрать

VIA выбирайте, если нужно быстро:

  • переназначить клавиши;
  • сделать FN-слой со стрелками/медиа;
  • включить простые переключатели слоёв (MO/TG/LT) без пересборки прошивки.

QMK выбирайте, если нужно:

  • сложные tap-hold сценарии и тонкая настройка таймингов;
  • дополнительные функции (макросы, условия, нестандартная логика);
  • хранить конфиг воспроизводимо (как проект/код).

Перед прошивкой: что проверить

  1. Точная модель и ревизия платы/клавиатуры (важно: у “почти одинаковых” ревизий прошивки могут отличаться).
  2. Тип загрузчика (bootloader) — от него зависит файл и способ прошивки.
  3. Как войти в bootloader: кнопка RESET, пэды RST–GND, или назначенная клавиша QK_BOOT.

Не прошивайте “похожую” прошивку. Правильная прошивка должна совпадать с моделью и ревизией, иначе клавиатура может не стартовать без восстановления.

Как прошить клавиатуру: универсальный алгоритм

Подход один и тот же, меняются только инструменты.

Вариант 1 (проще): QMK Toolbox (GUI)

  1. Подготовьте файл прошивки (.hex / .bin / .uf2).
  2. Откройте QMK Toolbox и выберите файл.
  3. Переведите клавиатуру в bootloader (RESET или QK_BOOT).
  4. Нажмите Flash (или включите Auto-Flash и затем сделайте Reset).

Если у вас контроллер с “коротким” bootloader (часто бывает на Pro Micro/Caterina), помогает Auto-Flash + двойной reset: успеваете попасть в окно прошивки.

Вариант 2: QMK CLI (терминал)

  • сборка: qmk compile -kb <keyboard> -km <keymap>
  • прошивка: qmk flash -kb <keyboard> -km <keymap> (перед этим войдите в bootloader)

Форматы прошивки и типичный способ

ФорматЧаще где встречаетсяКак обычно шьют
.hexAVR-платычерез Toolbox/CLI
.binмногие ARM/STM32/WB32через Toolbox/CLI/DFU
.uf2RP2040как “флешку”: перетащить файл в накопитель bootloader

Настройка слоёв в VIA: Base + FN

Логика слоёв:

  • Layer 0 — базовый (печать всегда).
  • Layer 1 — FN (стрелки, F-ряд, медиа).
  • TRNS (Transparent) — “пропустить вниз” на слой 0.

Клавиши слоёв, которые реально нужны новичку

  • MO(1) — слой 1 активен, пока держите клавишу (лучший “FN”).
  • TG(1) — включить/выключить слой 1 тумблером.
  • LT(1, KC_SPC) — тап = Space, удержание = слой 1 (удобно на 60–65%).

Рецепт “за 10 минут”

  1. В Layer 0 назначьте удобную кнопку FN → MO(1) (часто Caps/Menu/правый Alt).
  2. В Layer 1 задайте:
    • H J K L → ← ↓ ↑ → (или любой ваш блок стрелок),
    • U I O P → Home / PgDn / PgUp / End,
    • верхний ряд → F1–F12,
    • медиа: Play/Pause, Vol-, Vol+, Mute (по желанию).
  3. Остальные клавиши на Layer 1 оставьте TRNS, чтобы “база” работала как обычно.

Если на FN-слое “пропали буквы”, почти всегда причина в том, что стоит NO (пусто), а нужно TRNS.

Если VIA не видит клавиатуру

Проверьте по порядку:

  1. Прошивка действительно VIA-совместимая (в QMK обычно это keymap via и включение VIA_ENABLE = yes).
  2. Если модель не распознаётся автоматически — нужен definition JSON (в VIA включают вкладку Design и загружают JSON).
  3. Для web-VIA обычно нужен браузер на Chromium (WebHID), иначе не появится выбор устройства.
  4. После смены прошивки иногда помогает сброс настроек/EEPROM (если в вашей прошивке предусмотрен reset).
  5. На Windows проблемы часто в драйвере bootloader-устройства (важно: не меняйте драйвер “обычной” HID-клавиатуры наугад).

Частые ошибки

  • Прошивают “похожую” ревизию → клавиатура не стартует.
  • Не оставляют способ входа в bootloader (нет QK_BOOT, не знают где RESET).
  • Ставят TG вместо MO и удивляются “залипанию” FN.
  • На FN-слое ставят NO вместо TRNS и теряют базовые клавиши.
  • Меняют сразу половину раскладки — сложно откатиться. Делайте 1–3 правки и тест.

FAQ

Можно ли пользоваться VIA и QMK вместе?
Да. Частый сценарий: вы собираете QMK-прошивку с поддержкой VIA, прошиваете её один раз, а дальше правите раскладку в VIA.

Что лучше для первой настройки слоёв: MO или LT?
Для старта — MO(1). Когда привыкнете, попробуйте LT на Space/Enter: экономит место на компактных клавиатурах.

Если прошивка “не шьётся”, что проверить первым делом?
Что вы действительно в bootloader-режиме, и что выбран правильный файл под вашу модель/ревизию и формат (hex/bin/uf2).