Skip to content

# Release Notes - October 16, 2025

Choose a tag to compare

View all tags
@zerodice0 zerodice0 released this 16 Oct 03:21
· 11 commits to main since this release
1.1.0
4403e20

Summary

This release updates the zerodice0 keymap to comply with QMK's modern standards and introduces RGB Matrix support. The update modernizes keycode definitions, enables advanced RGB lighting control, and adds new layer-specific functionality while maintaining full compatibility with both Iris Rev7 and Iris CE Rev1 hardware.

Key Changes

1. Keycode Modernization

Mouse Keycodes

Updated deprecated mouse keycode naming conventions to QMK's current standard across layers 4 and 5:

  • Button Keycodes (Layer 4, Row 2):

    • KC_BTN1 → MS_BTN1 (Mouse Button 1)
    • KC_BTN2 → MS_BTN2 (Mouse Button 2)
    • KC_BTN3 → MS_BTN3 (Mouse Button 3)
    • KC_BTN4 → MS_BTN4 (Mouse Button 4)

  • Mouse Movement Keycodes (Layer 4, Row 3):

    • KC_MS_L → MS_LEFT (Mouse Left)
    • KC_MS_D → MS_DOWN (Mouse Down)
    • KC_MS_U → MS_UP (Mouse Up)
    • KC_MS_R → MS_RGHT (Mouse Right)

  • Mouse Wheel Keycodes (Layer 4, Row 4):

    • KC_WH_R → MS_WHLD (Mouse Wheel Left)
    • KC_WH_U → MS_WHLU (Mouse Wheel Up)
    • KC_WH_D → MS_WHLD (Mouse Wheel Down)
    • KC_WH_L → MS_WHLR (Mouse Wheel Right)

RGB Keycodes

Standardized RGB lighting keycodes to align with RGB_MATRIX_ENABLE configuration:

  • RGB Mode Keycodes (Layers 3 and 4):

    • RGB_M_P → RM_NEXT (RGB Pattern Next)
    • RGB_M_B → RM_VALD (RGB Brightness Down, alternative pattern control)
    • RGB_M_R → RM_SPDU (RGB Speed Up)
    • RGB_M_SW → RM_SPDD (RGB Speed Down)
    • RGB_MOD → RM_NEXT (RGB Pattern Next)

  • RGB Control Keycodes (Layer 3, Rows 2-3):

    • RGB_HUI → RM_HUI (RGB Hue Increase)
    • RGB_HUD → RM_HUD (RGB Hue Decrease)
    • RGB_SAI → RM_SATU (RGB Saturation Increase)
    • RGB_SAD → RM_SATD (RGB Saturation Decrease)
    • RGB_VAI → RM_VALU (RGB Value/Brightness Increase)
    • RGB_VAD → RM_VALD (RGB Value/Brightness Decrease)

2. Build Configuration Updates

rules.mk - RGB Matrix Configuration:

# Previous: RGBLIGHT_ENABLE (underglow only)
# Updated: RGB_MATRIX_ENABLE = yes

Rationale:

  • Enables per-key RGB matrix support for the Iris CE Rev1 and compatible keyboards
  • Aligns with QMK's modern RGB lighting architecture
  • Provides more granular RGB control options

3. Layer 3 (_RIGHT_UNDER) Enhancements

Added RGB color and brightness control keys on the right-side modifier layer:

  • Row 2 (Color Control):

    • KC_HOME position: RGB_HUI (Hue ↑)
    • KC_UP area: RGB_SAI (Saturation ↑)
    • Right side: RGB_VAI (Brightness ↑)

  • Row 3 (Brightness & Saturation):

    • KC_END position: RGB_HUD (Hue ↓)
    • KC_DOWN area: RGB_SAD (Saturation ↓)
    • Right side: RGB_VAD (Brightness ↓)

Visual Layout (Layer 3, Right Side):

┌────────┬────────┬────────┬────────┐
│ RGB_HUI│ RGB_SAI│ RGB_VAI│ KC_BSLS│  Row 2
├────────┼────────┼────────┼────────┤
│ RGB_HUD│ RGB_SAD│ RGB_VAD│ _______│  Row 3
└────────┴────────┴────────┴────────┘

4. Layer 4 (_LEFT_UP) Updates

New Addition: Cmd+` (Tab Switch) Keycode

  • Row 1, leftmost position on modifier row: Added TAP_P (Cmd+` Backtick)
  • Enables quick window switching within applications (macOS standard)
  • Located at position where RGB_M_P was previously

Layer Overview

Layer 0: _BASIC (Default)

  • Standard QWERTY layout
  • Left thumb: KC_LGUI (Cmd), LEFT_UNDER (layer switch), KC_ENT (Enter)
  • Right thumb: KC_SPC (Space), RIGHT_UNDER (layer switch), KC_RALT (Right Alt)
  • Modifier key: MO(4) (temporarily activate Layer 4)

Layer 1: _LEFT_UNDER

  • Number pad simulation (Left side)
  • Symbols and special characters
  • Triggered by holding left thumb key

Layer 2: _RIGHT_UNDER

  • Function keys (F1-F12)
  • Media controls (Prev, Next, Volume Up/Down)
  • RGB Controls (Newly updated):
    • Hue/Saturation/Brightness adjustment
    • Supports advanced RGB matrix animation control

Layer 3: _BOTH_UNDER (Tri-Layer)

  • System commands and shortcuts
  • Auto-activated when both thumb keys are held simultaneously
  • RGB mode controls using updated RM_* keycodes

Layer 4: _LEFT_UP

  • Mouse control (Movement, buttons, wheel)
  • macOS screenshot shortcuts (Cmd+Shift+3/4/5 variants)
  • Browser navigation (Back, Forward)
  • Finder navigation (Up, Down)
  • New: Cmd+` window switcher

Technical Specifications

Hardware Support

  • Keyboards: Keebio Iris Rev7, Iris CE Rev1
  • MCU: Compatible with QMK-supported MCUs
  • RGB Matrix: Per-key RGB (if hardware present)
  • Features Enabled:
    • Split keyboard support
    • Mouse key support
    • RGB Matrix control
    • EXTRAKEY (media keys)
    • Link-Time Optimization (LTO)

Build Configuration

BOOTMAGIC_ENABLE = no
MOUSEKEY_ENABLE = yes        # Required for mouse layer
EXTRAKEY_ENABLE = yes        # Media keys (Vol, Play, etc.)
CONSOLE_ENABLE = yes         # Debug output
COMMAND_ENABLE = no
NKRO_ENABLE = no
BACKLIGHT_ENABLE = no
RGBLIGHT_ENABLE = no
AUDIO_ENABLE = no
SPLIT_KEYBOARD = yes         # Split keyboard configuration
ENCODER_ENABLE = no
RGB_MATRIX_ENABLE = yes      # Per-key RGB matrix (NEW)
LTO_ENABLE = yes             # Link-time optimization

Compatibility & Platform Notes

Windows/Linux

  • ⚠️ Partial compatibility
  • Cmd key codes may not behave as expected (mapped to Super/Windows key)
  • macOS-specific shortcuts will not work as intended
  • Mouse controls and RGB matrix fully functional
  • Basic layer functionality unaffected

QMK Version Compatibility

  • Minimum: QMK Firmware 0.24.0+
  • Tested: QMK Firmware 0.24.x series
  • Recommended: Latest QMK development branch

Migration Guide (From Previous Versions)

If you're updating from the previous zerodice0 keymap version:

  1. Backup your existing keymap

    cp keymap.c keymap.c.backup

  2. Update QMK CLI

    qmk update

  3. Compile and flash using the commands above

  4. Verify functionality:

    • Test mouse layer operations
    • Verify RGB matrix controls on Layer 2 and 3
    • Confirm Layer 4 window switcher (Cmd+`)

Behavioral Changes

  • Mouse wheel scrolling: Direction follows macOS conventions (reversed if coming from Windows)
  • RGB control: Now uses modern RGB_MATRIX keycodes instead of RGBLIGHT
  • Layer 4: New Cmd+` keycode added to Tab position

요약

이 릴리즈는 zerodice0 키맵을 QMK의 최신 표준에 맞게 업데이트하고 RGB 매트릭스 지원을 도입합니다. 이 업데이트는 키코드 정의를 현대화하고, 고급 RGB 조명 제어를 활성화하며, 새로운 레이어별 기능을 추가하면서 Iris Rev7과 Iris CE Rev1 하드웨어 모두와의 완전한 호환성을 유지합니다.

주요 변경사항

1. 키코드 현대화

마우스 키코드

레이어 4와 5에서 사용 중단된 마우스 키코드 명명 규칙을 QMK의 현재 표준으로 업데이트했습니다:

  • 버튼 키코드 (레이어 4, 2행):

    • KC_BTN1 → MS_BTN1 (마우스 버튼 1)
    • KC_BTN2 → MS_BTN2 (마우스 버튼 2)
    • KC_BTN3 → MS_BTN3 (마우스 버튼 3)
    • KC_BTN4 → MS_BTN4 (마우스 버튼 4)

  • 마우스 이동 키코드 (레이어 4, 3행):

    • KC_MS_L → MS_LEFT (마우스 왼쪽)
    • KC_MS_D → MS_DOWN (마우스 아래)
    • KC_MS_U → MS_UP (마우스 위)
    • KC_MS_R → MS_RGHT (마우스 오른쪽)

  • 마우스 휠 키코드 (레이어 4, 4행):

    • KC_WH_R → MS_WHLD (마우스 휠 왼쪽)
    • KC_WH_U → MS_WHLU (마우스 휠 위)
    • KC_WH_D → MS_WHLD (마우스 휠 아래)
    • KC_WH_L → MS_WHLR (마우스 휠 오른쪽)

RGB 키코드

RGB 조명 키코드를 RGB_MATRIX_ENABLE 설정에 맞게 표준화했습니다:

  • RGB 모드 키코드 (레이어 3 및 4):

    • RGB_M_P → RM_NEXT (RGB 패턴 다음)
    • RGB_M_B → RM_VALD (RGB 밝기 감소, 대체 패턴 제어)
    • RGB_M_R → RM_SPDU (RGB 속도 증가)
    • RGB_M_SW → RM_SPDD (RGB 속도 감소)
    • RGB_MOD → RM_NEXT (RGB 패턴 다음)

  • RGB 제어 키코드 (레이어 3, 2행-3행):

    • RGB_HUI → RM_HUI (RGB 색상 증가)
    • RGB_HUD → RM_HUD (RGB 색상 감소)
    • RGB_SAI → RM_SATU (RGB 채도 증가)
    • RGB_SAD → RM_SATD (RGB 채도 감소)
    • RGB_VAI → RM_VALU (RGB 밝기 증가)
    • RGB_VAD → RM_VALD (RGB 밝기 감소)

2. 빌드 설정 업데이트

rules.mk - RGB 매트릭스 설정:

# 이전: RGBLIGHT_ENABLE (언더글로우만)
# 업데이트됨: RGB_MATRIX_ENABLE = yes

이유:

  • Iris CE Rev1 및 호환 키보드에 대한 키별 RGB 매트릭스 지원 활성화
  • QMK의 최신 RGB 조명 아키텍처와 일치
  • 보다 세밀한 RGB 제어 옵션 제공

3. 레이어 3 (_RIGHT_UNDER) 개선사항

오른쪽 수정자 레이어에 RGB 색상 및 밝기 제어 키를 추가했습니다:

  • 2행 (색상 제어):

    • KC_HOME 위치: RGB_HUI (색상 ↑)
    • KC_UP 영역: RGB_SAI (채도 ↑)
    • 오른쪽: RGB_VAI (밝기 ↑)

  • 3행 (밝기 및 채도):

    • KC_END 위치: RGB_HUD (색상 ↓)
    • KC_DOWN 영역: RGB_SAD (채도 ↓)
    • 오른쪽: RGB_VAD (밝기 ↓)

시각적 레이아웃 (레이어 3, 오른쪽):

┌────────┬────────┬────────┬────────┐
│ RGB_HUI│ RGB_SAI│ RGB_VAI│ KC_BSLS│  2행
├────────┼────────┼────────┼────────┤
│ RGB_HUD│ RGB_SAD│ RGB_VAD│ _______│  3행
└────────┴────────┴────────┴────────┘

4. 레이어 4 (_LEFT_UP) 업데이트

새로운 추가 기능: Cmd+` (탭 전환) 키코드

  • 1행, 수정자 행의 맨 왼쪽 위치: TAP_P (Cmd+` 백틱) 추가
  • 애플리케이션 내 빠른 창 전환 활성화 (macOS 표준)
  • 이전에 RGB_M_P가 있던 위치에 배치

레이어 개요

레이어 0: _BASIC (기본값)

  • 표준 QWERTY 레이아웃
  • 왼쪽 엄지: KC_LGUI (Cmd), LEFT_UNDER (레이어 전환), KC_ENT (Enter)
  • 오른쪽 엄지: KC_SPC (스페이스), RIGHT_UNDER (레이어 전환), KC_RALT (오른쪽 Alt)
  • 수정자 키: MO(4) (임시로 레이어 4 활성화)

레이어 1: _LEFT_UNDER

  • 숫자판 시뮬레이션 (왼쪽)
  • 기호 및 특수 문자
  • 왼쪽 엄지 키를 누르면 트리거됨

레이어 2: _RIGHT_UNDER

  • 기능 키 (F1-F12)
  • 미디어 제어 (이전, 다음, 볼륨 증가/감소)
  • RGB 제어 (새로 업데이트됨):
    • 색상/채도/밝기 조정
    • 고급 RGB 매트릭스 애니메이션 제어 지원

레이어 3: _BOTH_UNDER (트라이-레이어)

  • 시스템 명령 및 단축키
  • 두 엄지 키를 동시에 누르면 자동 활성화
  • 업데이트된 RM_* 키코드를 사용한 RGB 모드 제어

레이어 4: _LEFT_UP

  • 마우스 제어 (이동, 버튼, 휠)
  • macOS 스크린샷 단축키 (Cmd+Shift+3/4/5 변형)
  • 브라우저 탐색 (뒤로, 앞으로)
  • 파인더 탐색 (위, 아래)
  • 새로운 기능: Cmd+` 창 전환기

기술 사양

하드웨어 지원

  • 키보드: Keebio Iris Rev7, Iris CE Rev1
  • MCU: QMK 지원 MCU와 호환
  • RGB 매트릭스: 키별 RGB (하드웨어가 있는 경우)
  • 활성화된 기능:
    • 분할 키보드 지원
    • 마우스 키 지원
    • RGB 매트릭스 제어
    • EXTRAKEY (미디어 키)
    • 링크 타임 최적화 (LTO)

빌드 설정

BOOTMAGIC_ENABLE = no
MOUSEKEY_ENABLE = yes        # 마우스 레이어에 필수
EXTRAKEY_ENABLE = yes        # 미디어 키 (볼륨, 재생 등)
CONSOLE_ENABLE = yes         # 디버그 출력
COMMAND_ENABLE = no
NKRO_ENABLE = no
BACKLIGHT_ENABLE = no
RGBLIGHT_ENABLE = no
AUDIO_ENABLE = no
SPLIT_KEYBOARD = yes         # 분할 키보드 설정
ENCODER_ENABLE = no
RGB_MATRIX_ENABLE = yes      # 키별 RGB 매트릭스 (새로움)
LTO_ENABLE = yes             # 링크 타임 최적화

플랫폼 참고사항

Windows/Linux

  • ⚠️ 부분 호환성
  • Cmd 키 코드가 예상대로 작동하지 않을 수 있음 (Super/Windows 키로 매핑됨)
  • macOS 특화 단축키는 의도대로 작동하지 않음
  • 마우스 제어 및 RGB 매트릭스 완벽 작동
  • 기본 레이어 기능은 영향받지 않음

QMK 버전 호환성

  • 최소 버전: QMK Firmware 0.24.0+
  • 테스트 버전: QMK Firmware 0.24.x 시리즈
  • 권장 버전: 최신 QMK 개발 브랜치

동작 변경사항

  • 마우스 휠 스크롤: macOS 규칙을 따름 (Windows에서 오는 경우 반대)
  • RGB 제어: 이제 RGBLIGHT 대신 최신 RGB_MATRIX 키코드 사용
  • 레이어 4: Tab 위치에 새로운 Cmd+` 키코드 추가됨
Assets 4
Loading