Прошивка и слои в QMK/VIA: быстрый старт без кирпича
Чтобы прошить клавиатуру и настроить слои, новичку проще всего: один раз поставить VIA-совместимую прошивку, а затем собрать Base + FN в VIA. QMK нужен, когда упираетесь в ограничения интерфейса и хотите логику “как код”.
Оглавление
QMK или VIA: что выбрать
VIA выбирайте, если нужно быстро:
- переназначить клавиши;
- сделать FN-слой со стрелками/медиа;
- включить простые переключатели слоёв (MO/TG/LT) без пересборки прошивки.
QMK выбирайте, если нужно:
- сложные tap-hold сценарии и тонкая настройка таймингов;
- дополнительные функции (макросы, условия, нестандартная логика);
- хранить конфиг воспроизводимо (как проект/код).
Перед прошивкой: что проверить
- Точная модель и ревизия платы/клавиатуры (важно: у “почти одинаковых” ревизий прошивки могут отличаться).
- Тип загрузчика (bootloader) — от него зависит файл и способ прошивки.
- Как войти в bootloader: кнопка RESET, пэды RST–GND, или назначенная клавиша
QK_BOOT.
Не прошивайте “похожую” прошивку. Правильная прошивка должна совпадать с моделью и ревизией, иначе клавиатура может не стартовать без восстановления.
Как прошить клавиатуру: универсальный алгоритм
Подход один и тот же, меняются только инструменты.
Вариант 1 (проще): QMK Toolbox (GUI)
- Подготовьте файл прошивки (
.hex/.bin/.uf2). - Откройте QMK Toolbox и выберите файл.
- Переведите клавиатуру в bootloader (RESET или
QK_BOOT). - Нажмите 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)
Форматы прошивки и типичный способ
| Формат | Чаще где встречается | Как обычно шьют |
|---|---|---|
.hex | AVR-платы | через Toolbox/CLI |
.bin | многие ARM/STM32/WB32 | через Toolbox/CLI/DFU |
.uf2 | RP2040 | как “флешку”: перетащить файл в накопитель 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 минут”
- В Layer 0 назначьте удобную кнопку FN → MO(1) (часто Caps/Menu/правый Alt).
- В Layer 1 задайте:
H J K L→ ← ↓ ↑ → (или любой ваш блок стрелок),U I O P→ Home / PgDn / PgUp / End,- верхний ряд → F1–F12,
- медиа: Play/Pause, Vol-, Vol+, Mute (по желанию).
- Остальные клавиши на Layer 1 оставьте TRNS, чтобы “база” работала как обычно.
Если на FN-слое “пропали буквы”, почти всегда причина в том, что стоит NO (пусто), а нужно TRNS.
Если VIA не видит клавиатуру
Проверьте по порядку:
- Прошивка действительно VIA-совместимая (в QMK обычно это keymap
viaи включениеVIA_ENABLE = yes). - Если модель не распознаётся автоматически — нужен definition JSON (в VIA включают вкладку Design и загружают JSON).
- Для web-VIA обычно нужен браузер на Chromium (WebHID), иначе не появится выбор устройства.
- После смены прошивки иногда помогает сброс настроек/EEPROM (если в вашей прошивке предусмотрен reset).
- На 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).