RMK Internal Configuration#

The [rmk] section defines configuration parameters used inside RMK. These parameters affect the firmware's behavior, memory usage, and performance. If you don't need to change these parameters, you can ignore this section.

Configuration Example#

[rmk]
# Mouse key interval (ms) - controls mouse movement speed
mouse_key_interval = 20
# Mouse wheel interval (ms) - controls scrolling speed
mouse_wheel_interval = 80
# Maximum number of combos keyboard can store
combo_max_num = 8
# Maximum number of keys pressed simultaneously in a combo
combo_max_length = 4
# Maximum number of forks for conditional key actions
fork_max_num = 8
# Maximum number of morse keys keyboard can store (max 256)
morse_max_num = 8
# Maximum number of patterns a morse key can handle (default: 8, min: 4, max 65536)
max_patterns_per_key = 8
# Macro space size in bytes for storing sequences. The maximum number of Macros depends on the size of each sequence: All sequences combined need to fit into macro_space_size, the number of macro sequences doesn't matter.
macro_space_size = 256
# Default debounce time in ms
debounce_time = 20
# Event channel size
event_channel_size = 16
# Report channel size
report_channel_size = 16
# Vial channel size
vial_channel_size = 4
# Flash channel size
flash_channel_size = 4
# The number of the split peripherals
split_peripherals_num = 1
# The number of available BLE profiles
ble_profiles_num = 3

Parameter Details#

Mouse-Related Configuration#

• mouse_key_interval: Mouse key interval in milliseconds, default value is 20. This parameter controls the mouse movement speed; lower values result in faster movement.
• mouse_wheel_interval: Mouse wheel interval in milliseconds, default value is 80. This parameter controls the scrolling speed; lower values result in faster scrolling.

Behavior Configuration#

• combo_max_num: Maximum number of combos that the keyboard can store, default value is 8. This value must be between 0 and 256.
• combo_max_length: Maximum number of keys that can be pressed simultaneously in a combo, default value is 4.
• fork_max_num: Maximum number of forks for conditional key actions, default value is 8. This value must be between 0 and 256.
• morse_max_num: Maximum number of morses that can be stored, default value is 8. This value must be between 0 and 256.
• max_patterns_per_key : Maximum number of tap/hold patterns a morse key can handle, default value is 8. This value must be between 4 and 65536. (Will be automatically set to the maximum length of tap_actions + hold_actions or morse_actions.)
• macro_space_size: Space size in bytes for storing macro sequences, default value is 256.

Matrix Configuration#

• debounce_time: Default key debounce time in milliseconds, default value is 20.

Channel Configuration#

In RMK there are several channels used for communication between tasks. The length of the channel can be adjusted. Larger channel size means more events can be buffered, but it will increase memory usage.

• event_channel_size: The length of event channel, default value is 16.
• report_channel_size: The length of report channel, default value is 16.
• vial_channel_size: The length of vial channel, default value is 4.
• flash_channel_size: The length of flash channel, default value is 4.

Split Keyboard Configuration#

• split_peripherals_num: The number of split peripherals, default value is 1. If multiple peripherals are specified in the toml, this field will be automatically set to the actual peripherals number.

Wireless Configuration#

• ble_profiles_num: The number of available Bluetooth profiles, default value is 3. This parameter defines how many Bluetooth paired devices the keyboard can store.