Linux Boot Configuration
Here you can find all hekate boot entry ini keys supported by Linux.
Warning: Never use # to comment out keys in the ini. Either avoid them or use ; in front to invalidate a key. Example:
;rootdev=mmcblk0p2Also, never have an empty line between keys.
Below you can find all supported keys and their defaults.
l4t=11: Enables and parses the .ini boot entry with L4T Loader. Mandatory!
boot_prefixes=/switchroot/ubuntu/Sets the main L4T boot directory. Mandatory!
emmc=01: Enable eMMC. Also allows booting from eMMC.
id=SWR-UBUSet FS Label name. SWR-UBU or something else by default. Used to automatically find the correct linux partition. Mandatory if
rootdevis not defined!
rootdev=mmcblk0p2Default disk and linux partition. Gets overridden via
idif FS label is found. Mandatory if
idis not defined! (sda1, sda2, sdb1, mmcblk0p2, mmcblk1p1, etc)
rootfstype=ext4Sets linux partition FS type. Only ext4 is generally suggested since other filesystems use more CPU or they are slower.
rootfs_fw=/lib/firmware/Sets firmware directory for kernel to search in.
rootlabel_retries=1How many times to retry and search rootdev. Each iteration is 200ms. Useful when booting via USB (use 50 for 10s max polling).
rootdevsearch done by initramfs which uses
r2p_action=selfself: Reboots to self. bootloader: Reboots to bootloader menu. normal: Reboots with no config. Allows default auto boot to be used.
usb3_enable=01: Enable USB3 support. Enabling it can decrease WiFi 2.4GHz and Bluetooth signal quality.
4k60_disable=01: Disable 4K@60 for Nintendo Switch (OLED). If [usb3_enable] is set and 4K@60 is not disabled, the driver will automatically choose between USB3 and 4K@60. 4K@60 is preferred in that case.
uart_port=00: Disable serial logging 1: Enable serial logging on UART-A (internal testpads) 2: Enable serial logging on UART-B (right joycon rail) 3: Enable serial logging on UART-C (left joycon rail) 4: Enable serial logging on USB
earlycon=01: If UART logging is enabled, this enables early boot logging. If disabled, the backlog will be printed after uart driver init.
fbconsole=90: Enable kernel logging on built-in display. 1: Enable kernel logging on DP/HDMI/VGA. 9: Disables kernel logging on any display.
als_enable=01: Enable Ambient Light Sensor.
jc_rail_disable=01: Disable railed Joycon support.
cec_disable=01: Disable auto DP/HDMI CEC negotiation.
touch_skip_tuning=01: Disables touch panel tuning on boot. Some panels with broken flex cable might need it.
bt_ertm_disable=01: Disable Bluetooth Enhanced Retransmission mode. Might help with some Xbox Bluetooth based controllers.
wifi_disable_vht80=01: Disable Wi-Fi VHT80 and VHT160 bonding (5GHz band). In case wifi card firmware hangs when fully used at such speeds and kernel panics, that might help to mitigate that issue.
bootargs_extra=Set extra kernel command line arguments.
dvfsb=01: Enable DVFS B-Side for CPU/GPU/Core. T210B01 only. Reduces power draw in order to use less battery for the same performance. Can also allow higher CPU/GPU clocks. If OC is used, the reduced power draw is negated.
gpu_dvfsc=01: Enable DVFS C-Side for GPU. T210B01 only. Reduces power draw drastically on GPU frequencies of 768/844 MHz and up. Allows up to 1228 MHz clocks on select speedo binnings.
limit_gpu_clk=01: Set GPU clock hard limit to 1075 MHz. T210B01 only. Helps when
gpu_dvfscis enabled and GPU can't handle the higher frequencies in such low voltages.