14, 15 INI Settings Guide

Credit: CTCaer for README_CONFIG.txt

Never use # to comment out keys in the ini. Either avoid them or use ; in front to invalidate a key. Example: rootdev=mmcblk0p2 -> ;rootdev=mmcblk0p2

Below you can find all supported keys and their defaults.

.ini Boot Entry Config Keys

Meta Options for BL and Rootfs Configuration

l4t=1 REQUIRED Enables and parses the .ini boot entry with L4T Loader.
boot_prefixes=/switchroot/android/ REQUIRED Sets the main L4T Loader boot directory.
emmc=1 Enable eMMC. Also allows booting from eMMC.
id=SWANDR Set boot entry name. SWANDR by default. Used to find Android entry from hekate partitioner boot-to-recovery, so using another value will break this feature.

Configuration Options for Power Users

r2p_action=self self: Reboots to self. bootloader: Reboots to bootloader menu. normal: Reboots with no config. Allows default auto boot to be used.
usb3_enable=0 1: Enable USB3 support. Enabling it can dramatically decrease WiFi 2.4GHz and Bluetooth signal quality, but allows MTP, ADB, etc. to function (for now).
4k60_disable=0 1: Disable 4K60 for Nintendo Switch (OLED). If usb3_enable is set, the driver will automatically choose between USB3 and 4K60. 4K60 is preferred in that case.
uart_port=0 0: Disable serial logging 1: Enable serial logging on UART-A (board port) 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
wifi_mac= Override Wi-Fi MAC address with custom one
bt_mac= Override BT MAC address with custom one
earlycon=0 1: If UART logging is enabled, this enables early boot logging. If disabled, the backlog will be printed after uart driver init.
fbconsole=9 NOTE: currently broken on Android 0: Enable kernel logging on built-in display. 1: Enable kernel logging on DP/HDMI/VGA. 9: Or removed, disables kernel logging on any display.
jc_rail_disable=0 1: Disable railed JoyCon support.
cec_disable=0 1: Disable auto DP/HDMI CEC negotiation.
touch_skip_tuning=0 1: Disables touch panel tuning on boot. Some panels with broken flex cable might need it--if you can't use touch in recovery, try this.
bt_ertm_disable=0 1: Disable Bluetooth Enhanced Retransmission mode. Might help with some Xbox Bluetooth based controllers.
wifi_disable_vht80=0 1: 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.
alarms_disable=0 1: Disable RTC and WiFi wakeup alarms to massively increase battery while disabling notification wakeup from deep sleep
ddr200_enable=0 1: Enable the (much faster) ddr200 microSD card spec for supported cards. This is disabled by default in Android on non-Samsung cards due to possibility of instability with certain cards. For Samsung cards, we have extensive validation data showing thier implementation is fully compatible with our setup and highly consistent.
dvfsb=0 1: 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. Required for some OC profiles.
gpu_dvfsc=0 1: 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=0 1: Set GPU clock hard limit to 1075 MHz. T210B01 only. Helps when gpu_dvfsc is enabled and GPU can't handle the higher frequencies in such low voltages.

Overclocking

DISCLAIMER: Nintendo did not intend Switch units to sustain loads higher than their set frequencies. Your battery and board may degrade at a faster-than-normal pace. We are NOT responsible for issues caused by improper overclocking.

CPU and GPU Clocks

oc=1 1: Disable stock CPU clock limits NOTE: You must enable Performance Mode in Android to allow scaling to higher clocks
max_cpu_freq=0 Set CPU maximum kernel scaling frequency in KHz. Android Performance Mode allows scaling up to kernel max.
max_gpu_freq=0 Set GPU maximum kernel scaling frequency in KHz. Android Performance Mode allows scaling up to kernel max.

RAM Clocks and Voltages

ram_oc=0 Set RAM Overclock frequency in KHz.

See Ubuntu README_CONFIG.txt for info for how to troubleshoot and train your RAM OC in L4T for testing.

Any clock increase will also increase RAM power consumption like a CPU/GPU OC. For example on T210B01, with 1z-nm ram, going from 1866 to 2133 causes a 146 mW increase on active reads/writes which is 19.8%. Any other state is affected only with a voltage change.

T210 (Erista, max 2133 MHz)

List of supported frequencies: 1733000, 1800000, 1866000, 1900000, 1933000, 1966000, 2000000, 2033000, 2066000, 2100000, 2133000, 2166000, 2200000, 2233000, 2266000, 2300000, 2333000, 2366000.

Input frequency is normalized to one of the above.

Suggested Jedec Frequencies:

1862400
2133000

Suggested Custom:

Any, if it works.

T210B01 (Mariko, max 3000 MHz)

List of supported frequencies: 1866000, 2133000, 2166000, 2200000, 2233000, 2266000, 2300000, 2333000, 2366000, 2400000, 2433000, 2466000, 2500000, 2533000, 2566000, 2600000, 2633000, 2666000, 2700000, 2733000, 2766000, 2800000, 2833000, 2866000, 2900000, 2933000, 2966000, 3000000, 3033000, 3066000, 3100000, 3133000, 3166000, 3200000.

Input frequency is generally normalized to one of the above. Actual frequency will be exactly one of these.

Suggested Jedec Frequencies:

1866000
2133000

Suggested Custom Frequencies:

Any, if it works.

NOTE: Very high ram frequencies might raise GPU power draw on some GPU frequencies if GPU binning is low.

Timing-Based Overclocking

To enable that, edit the last 2 (T210) or 3 (T210B01) digits of the frequency.

It's generally better to find a good base frequency before touching these.

Do not touch them at all for guaranteed stability on max possible frequency, since without these, the whole configuration is exactly per Nvidia's and RAM vendor's specifications.

Syntax:

T210:    Freq MHz +  BA. FFFFF[BA]. (18624[00] -> 18624[52])
T210B01: Freq MHz + CBA. FFFF[CBA]. (2133[000] -> 2133[252])

Description of F, A, B and C timing overclocking options: F: Actual clock frequency. Exceeding chip's real max is actual OC.

A: Base Latency reduction. Base latency decreases based on selected frequency bracket. Brackets: 1333/1600/1866/2133.

Range: 0 - 3. 0 to -3 bracket change. Example 1: 1866 with 2 is 1333 base latency. Originally 1866 bracket. Example 1: 1866 with 3 is 1333 base latency. Originally 1866 bracket. Example 2: 1996 with 3 is 1333 base latency. Originally 2133 bracket. Example 3: 2133 with 2 is 1600 base latency. Originally 2133 bracket. Example 4: 2400 with 0 is 2133 base latency. Originally 2133 bracket.

B: Core Timings reduction. Timings that massively get affected by temperatures are not touched.

Range: 0 - 9. 0% to 45% reduction.

C: BW Increase. T210B01/LPDDR4x only. RAM Temperature limited timings. Can cause significant ram data corruption if ram temperature exceeds max. Reason is not allowed on T210 and LPDDR4.

0/1/2/3/4: for max 85/75/65/55/45 oC

RAM Temperature is only related to MEM/PLL sensors and not to Tdiode or Tboard. 45oC is 50/51 oC MEM/PLL (around 43 oC Tdiode, depends on temp equilibrium). 65oC is 68/69 oC MEM/PLL (around 60 oC Tdiode, depends on temp equilibrium).

Full Examples:

Old (no timing adjustments) OC equivalents:

1862 Old OC: 15% -> A1,B3,C0 - 1866031
1996 Old OC: 25% -> A2,B5,C0 - 2000052

T210 Examples:

1996800 -> 1996800: 1996 MHz with read/write base latency of 2133 MHz and proper 1996 MHz core timings.
1996800 -> 1996852: 1996 MHz with read/write base latency of 1600 MHz and reduced core timings by 25%.

T210B01 Examples:

2666000 -> 2666000: 2666 MHz with read/write base latency of 2133 MHz and proper 2666 MHz core timings.
2666000 -> 2666252: 2666 MHz with read/write base latency of 1600 MHz, reduced core timings by 25% and up to 65C operation.

Again, do not use them if you want the RAM running like Nvidia and RAM vendor made the tables, and write the frequency as is in that case.

ram_oc_vdd2=0 Changes VDDIO/VDDQ voltage for T210. VDDIO only for T210B01. Can stabilize timing reduction. Do not use for zero reason. It's useless on proper timings. It will just raise power draw for nothing. Range: 1100 - 1175. (Unit in mV).
ram_oc_vddq=0 Changes VDDQ voltage for T210B01. Can stabilize timing reduction. Do not use for zero reason. It's useless on proper timings. It will just raise power draw for nothing. Range: 600 - 650. (Unit in mV).

Previous14, 15 eMMC Boot Guide Next14, 15 Power User Docs

Last updated 12 days ago

14, 15 INI Settings Guide

Credit: CTCaer for README_CONFIG.txt

Never use # to comment out keys in the ini. Either avoid them or use ; in front to invalidate a key. Example: rootdev=mmcblk0p2 -> ;rootdev=mmcblk0p2

Below you can find all supported keys and their defaults.

.ini Boot Entry Config Keys

Meta Options for BL and Rootfs Configuration

l4t=1 REQUIRED Enables and parses the .ini boot entry with L4T Loader.
boot_prefixes=/switchroot/android/ REQUIRED Sets the main L4T Loader boot directory.
emmc=1 Enable eMMC. Also allows booting from eMMC.
id=SWANDR Set boot entry name. SWANDR by default. Used to find Android entry from hekate partitioner boot-to-recovery, so using another value will break this feature.

Configuration Options for Power Users

r2p_action=self self: Reboots to self. bootloader: Reboots to bootloader menu. normal: Reboots with no config. Allows default auto boot to be used.
usb3_enable=0 1: Enable USB3 support. Enabling it can dramatically decrease WiFi 2.4GHz and Bluetooth signal quality, but allows MTP, ADB, etc. to function (for now).
4k60_disable=0 1: Disable 4K60 for Nintendo Switch (OLED). If usb3_enable is set, the driver will automatically choose between USB3 and 4K60. 4K60 is preferred in that case.
uart_port=0 0: Disable serial logging 1: Enable serial logging on UART-A (board port) 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
wifi_mac= Override Wi-Fi MAC address with custom one
bt_mac= Override BT MAC address with custom one
earlycon=0 1: If UART logging is enabled, this enables early boot logging. If disabled, the backlog will be printed after uart driver init.
fbconsole=9 NOTE: currently broken on Android 0: Enable kernel logging on built-in display. 1: Enable kernel logging on DP/HDMI/VGA. 9: Or removed, disables kernel logging on any display.
jc_rail_disable=0 1: Disable railed JoyCon support.
cec_disable=0 1: Disable auto DP/HDMI CEC negotiation.
touch_skip_tuning=0 1: Disables touch panel tuning on boot. Some panels with broken flex cable might need it--if you can't use touch in recovery, try this.
bt_ertm_disable=0 1: Disable Bluetooth Enhanced Retransmission mode. Might help with some Xbox Bluetooth based controllers.
wifi_disable_vht80=0 1: 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.
alarms_disable=0 1: Disable RTC and WiFi wakeup alarms to massively increase battery while disabling notification wakeup from deep sleep
ddr200_enable=0 1: Enable the (much faster) ddr200 microSD card spec for supported cards. This is disabled by default in Android on non-Samsung cards due to possibility of instability with certain cards. For Samsung cards, we have extensive validation data showing thier implementation is fully compatible with our setup and highly consistent.
dvfsb=0 1: 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. Required for some OC profiles.
gpu_dvfsc=0 1: 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=0 1: Set GPU clock hard limit to 1075 MHz. T210B01 only. Helps when gpu_dvfsc is enabled and GPU can't handle the higher frequencies in such low voltages.

Overclocking

CPU and GPU Clocks

oc=1 1: Disable stock CPU clock limits NOTE: You must enable Performance Mode in Android to allow scaling to higher clocks
max_cpu_freq=0 Set CPU maximum kernel scaling frequency in KHz. Android Performance Mode allows scaling up to kernel max.
max_gpu_freq=0 Set GPU maximum kernel scaling frequency in KHz. Android Performance Mode allows scaling up to kernel max.

RAM Clocks and Voltages

ram_oc=0 Set RAM Overclock frequency in KHz.

See Ubuntu README_CONFIG.txt for info for how to troubleshoot and train your RAM OC in L4T for testing.

T210 (Erista, max 2133 MHz)

List of supported frequencies: 1733000, 1800000, 1866000, 1900000, 1933000, 1966000, 2000000, 2033000, 2066000, 2100000, 2133000, 2166000, 2200000, 2233000, 2266000, 2300000, 2333000, 2366000.

Input frequency is normalized to one of the above.

Suggested Jedec Frequencies:

1862400
2133000

Suggested Custom:

Any, if it works.

T210B01 (Mariko, max 3000 MHz)

Input frequency is generally normalized to one of the above. Actual frequency will be exactly one of these.

Suggested Jedec Frequencies:

1866000
2133000

Suggested Custom Frequencies:

Any, if it works.

NOTE: Very high ram frequencies might raise GPU power draw on some GPU frequencies if GPU binning is low.

Timing-Based Overclocking

To enable that, edit the last 2 (T210) or 3 (T210B01) digits of the frequency.

It's generally better to find a good base frequency before touching these.

Do not touch them at all for guaranteed stability on max possible frequency, since without these, the whole configuration is exactly per Nvidia's and RAM vendor's specifications.

Syntax:

T210:    Freq MHz +  BA. FFFFF[BA]. (18624[00] -> 18624[52])
T210B01: Freq MHz + CBA. FFFF[CBA]. (2133[000] -> 2133[252])

Description of F, A, B and C timing overclocking options: F: Actual clock frequency. Exceeding chip's real max is actual OC.

A: Base Latency reduction. Base latency decreases based on selected frequency bracket. Brackets: 1333/1600/1866/2133.

Range: 0 - 3. 0 to -3 bracket change. Example 1: 1866 with 2 is 1333 base latency. Originally 1866 bracket. Example 1: 1866 with 3 is 1333 base latency. Originally 1866 bracket. Example 2: 1996 with 3 is 1333 base latency. Originally 2133 bracket. Example 3: 2133 with 2 is 1600 base latency. Originally 2133 bracket. Example 4: 2400 with 0 is 2133 base latency. Originally 2133 bracket.

B: Core Timings reduction. Timings that massively get affected by temperatures are not touched.

Range: 0 - 9. 0% to 45% reduction.

C: BW Increase. T210B01/LPDDR4x only. RAM Temperature limited timings. Can cause significant ram data corruption if ram temperature exceeds max. Reason is not allowed on T210 and LPDDR4.

0/1/2/3/4: for max 85/75/65/55/45 oC

Full Examples:

Old (no timing adjustments) OC equivalents:

1862 Old OC: 15% -> A1,B3,C0 - 1866031
1996 Old OC: 25% -> A2,B5,C0 - 2000052

T210 Examples:

1996800 -> 1996800: 1996 MHz with read/write base latency of 2133 MHz and proper 1996 MHz core timings.
1996800 -> 1996852: 1996 MHz with read/write base latency of 1600 MHz and reduced core timings by 25%.

T210B01 Examples:

2666000 -> 2666000: 2666 MHz with read/write base latency of 2133 MHz and proper 2666 MHz core timings.
2666000 -> 2666252: 2666 MHz with read/write base latency of 1600 MHz, reduced core timings by 25% and up to 65C operation.

Again, do not use them if you want the RAM running like Nvidia and RAM vendor made the tables, and write the frequency as is in that case.

ram_oc_vdd2=0 Changes VDDIO/VDDQ voltage for T210. VDDIO only for T210B01. Can stabilize timing reduction. Do not use for zero reason. It's useless on proper timings. It will just raise power draw for nothing. Range: 1100 - 1175. (Unit in mV).
ram_oc_vddq=0 Changes VDDQ voltage for T210B01. Can stabilize timing reduction. Do not use for zero reason. It's useless on proper timings. It will just raise power draw for nothing. Range: 600 - 650. (Unit in mV).

Previous14, 15 eMMC Boot Guide Next14, 15 Power User Docs

Last updated 12 days ago