FastCFWswitch: Difference between revisions

fastCFWswitch
fastCFWswitch
General
Author	Hartie95
Type	Overlays
Version	1.3.1
License	GPL-2.0
Last Updated	2023/02/24
Links
	Download
	Website
	Source

Revision as of 06:33, 26 April 2023

fastCFWswitch is a simple overlay to boot into payloads to change between CFWs or boot into tools.

The overlay is base based on Tesla and presents the payloads based on a configuration file on the sd-card.

Its possible to define the entry name and separate them by categories, the order is currently used directly from the ini file.

An example configuration is included in the release zip.

Installation

Requirements:

A Tesla compatible CFW.
Tesla Menu and nx-ovlloader installed and confirm working.
A Switch with an Erisa SOC, since Mariko switches don't support reboot to payload.

Extract the latest release to the SD card.

Modify the configuration in /config/fastCFWSwitch/config.ini

User guide

Configuration

Attribute	possible values	Description
`type`	empty / `section` / `payload`	This defines the type of element this section defines, if left empty it will automatically differentiate it by checking if a path is set
`name`	any string - example: `atmosphere`	The entry name, shown in the Overlay
`path`	a path - example: `/bootloader/hekate.bin`	The absolute path, based on the root of the sd, to the payload that should be loaded
`bootPos`	a number	The config position of the config the target payload should load, currently only supported for hekate
`bootId`	an 1-7 character long string - example `atmos`	The id of the config entry the target should be loaded, supported for hekate 5.0.2+
`ums`	string from UMS target list - example `sd`	The ums target, that should automatically be exposed via usb, supported for hekate

UMS Target

Target	possible values
SD-Card	`sd`, default fallback
EMMC BOOT0	`nand_boot0`, `emmc_boot0`
EMMC BOOT1	`nand_boot1`, `emmc_boot1`
EMMC Main/GPT	`nand_gpt`, `emmc_gpt`
EmuNAND BOOT0	`emu_boot0`
EmuNAND BOOT1	`emu_boot1`
EmuNAND Main/GPT	`emu_gpt`

Example configuration

[CFW]
type=section
name=CFW

[SYSMMC]
name=sysMMC
path=/bootloader/update.bin
bootId=sysnand

[EMUMMC]
name=emuMMC
path=/bootloader/update.bin
bootId=emunand

[ATMOSPHERE]
name=Atmosphere
path=/atmosphere/reboot_payload.bin

[SXOS]
name=SX OS
path=/sxos/reboot_payload.bin

[ANDROID]
name=Android
path=/bootloader/update.bin
bootId=SWANDR

[Ubuntu]
name=Ubuntu
path=/bootloader/update.bin
bootId=SWR-UBU


[TOOLS]
name=Tools

[HEKATE]
name=hekate
path=/bootloader/update.bin

[LOCKPICKRCM]
name=Lockpick RCM
path=/bootloader/payloads/Lockpick_RCM.bin


[UMS]
name=hekate UMS options

[SD_CARD]
name=microSD
path=/bootloader/update.bin
ums=sd

[EMMC_GPT]
name=EMMC GPT 
path=/bootloader/update.bin
ums=emmc_gpt

Screenshots

Compatibility

Supported devices:

Only Switch consoles with the old Erista SOC are supported, because exosphere uses a bootrom exploit to reboot to a payload.

Changelog

v1.3.1 2023/02/24

Updated libtesla for 16.0.0 compability.

v1.3.0 Edit 2022/01/22

Updated included config to match the updated example.

v1.3.0 2021/10/02

fastCFWswitch now uses the more secure way to reboot (ams:bpc).
This should reduce the amount of possible fs corruptions.
SXOS and reinx still use the old, manual reboot.

v1.2.0 2021/03/28

This release adds support for hekates boot to ums feature.
- To use it, create an entry with the ums field set to one of the values defined in the README.

v1.1.1 2021/02/22

This release mostly just adds some small internal changes, like an update to the latest libTesla version, and a few internal refactorings.
It also adds an error message on Mariko switches, since those don't support reboot to payload.

v1.1.0 2020/05/31

Updated to the latest libtesla version.
Added support for hekates payload storage, to allow autobooting into different hekate configurations by config position or id (5.0.2+). To use this, set the bootPos or bootId field for the entry in the config file.

v1.0.0 2020/04/15

First Release.
Release zip includes an example configuration and the overlay, just extract it to your sd cards root and modify the configuration to your likings.

Credits

libtestla by WerWolv as base for this overlay.
libnx as base of almost all switch homebrew.
inih for the ini parsing lib.

External links

GitHub - https://github.com/Hartie95/fastCFWswitch
GBAtemp - https://gbatemp.net/threads/overlay-fastcfwswitch.562451/

@@ Line 1: / Line 1: @@
 {{Infobox Switch Homebrews
 |title=fastCFWswitch
-|image=fastcfwswitch.png
+|image=fastcfwswitchnx.png
-|description=Overlay to reboot into payloads on the nintendo switch.
+|description=Overlay to reboot into payloads on the Nintendo Switch.
 |author=Hartie95
 |lastupdated=2023/02/24
-|type=System Tools
+|type=Overlays
 |version=1.3.1
 |license=GPL-2.0
-|download=https://dlhb.gamebrew.org/switchhomebrews/fastcfwswitch.7z
+|download=https://dlhb.gamebrew.org/switchhomebrews/fastcfwswitchnx.7z
 |website=https://gbatemp.net/threads/overlay-fastcfwswitch.562451/
 |source=https://github.com/Hartie95/fastCFWswitch
 |donation=
 }}
-{{#seo:
+fastCFWswitch is a simple overlay to boot into payloads to change between CFWs or boot into tools.
-|title=Switch Homebrew Apps (System Tools) - GameBrew
-|title_mode=append
+The overlay is base based on Tesla and presents the payloads based on a configuration file on the sd-card.
-|image=fastcfwswitch.png
-|image_alt=fastCFWswitch
+Its possible to define the entry name and separate them by categories, the order is currently used directly from the ini file.
-}}
-{{cleanup|article|Needs cleanup}}
+An example configuration is included in the release zip.
-Overlay to reboot into payloads on the nintendo switch.
+==Installation==
+Requirements:
+* A Tesla compatible CFW.
+* [[Tesla Menu Switch|Tesla Menu]] and [[NX-ovlloader Switch|nx-ovlloader]] installed and confirm working.
+* A Switch with an Erisa SOC, since Mariko switches don't support reboot to payload.
+Extract the [https://github.com/Hartie95/fastCFWswitch/releases latest release] to the SD card.
+Modify the configuration in <code>/config/fastCFWSwitch/config.ini</code>
+==User guide==
+===Configuration===
+{| class="wikitable"
+! Attribute||possible values||Description
+|-
+| <code>type</code>||empty / <code>section</code> / <code>payload</code>||This defines the type of element this section defines, if left empty it will automatically differentiate it by checking if a path is set
+|-
+| <code>name</code>||any string - example: <code>atmosphere</code>||The entry name, shown in the Overlay
+|-
+| <code>path</code>||a path - example: <code>/bootloader/hekate.bin</code>||The absolute path, based on the root of the sd, to the payload that should be loaded
+|-
+| <code>bootPos</code>||a number||The config position of the config the target payload should load, currently only supported for hekate
+|-
+| <code>bootId</code>||an 1-7 character long string - example <code>atmos</code>||The id of the config entry the target should be loaded, supported for hekate 5.0.2+
+|-
+| <code>ums</code>||string from UMS target list - example <code>sd</code>||The ums target, that should automatically be exposed via usb, supported for hekate
+|-
+|}
+===UMS Target===
+{| class="wikitable"
+! Target||possible values
+|-
+| SD-Card||<code>sd</code>, default fallback
+|-
+| EMMC BOOT0||<code>nand_boot0</code>, <code>emmc_boot0</code>
+|-
+| EMMC BOOT1||<code>nand_boot1</code>, <code>emmc_boot1</code>
+|-
+| EMMC Main/GPT||<code>nand_gpt</code>, <code>emmc_gpt</code>
+|-
+| EmuNAND BOOT0||<code>emu_boot0</code>
+|-
+| EmuNAND BOOT1||<code>emu_boot1</code>
+|-
+| EmuNAND Main/GPT||<code>emu_gpt</code>
+|-
+|}
+===Example configuration===
+<pre>
+[CFW]
+type=section
+name=CFW
+[SYSMMC]
+name=sysMMC
+path=/bootloader/update.bin
+bootId=sysnand
+[EMUMMC]
+name=emuMMC
+path=/bootloader/update.bin
+bootId=emunand
+[ATMOSPHERE]
+name=Atmosphere
+path=/atmosphere/reboot_payload.bin
+[SXOS]
+name=SX OS
+path=/sxos/reboot_payload.bin
+[ANDROID]
+name=Android
+path=/bootloader/update.bin
+bootId=SWANDR
+[Ubuntu]
+name=Ubuntu
+path=/bootloader/update.bin
+bootId=SWR-UBU
+[TOOLS]
+name=Tools
+[HEKATE]
+name=hekate
+path=/bootloader/update.bin
+[LOCKPICKRCM]
+name=Lockpick RCM
+path=/bootloader/payloads/Lockpick_RCM.bin
+[UMS]
+name=hekate UMS options
-==Media==
+[SD_CARD]
-<youtube></youtube>
+name=microSD
+path=/bootloader/update.bin
+ums=sd
+[EMMC_GPT]
+name=EMMC GPT
+path=/bootloader/update.bin
+ums=emmc_gpt
+</pre>
 ==Screenshots==
-https://dlhb.gamebrew.org/switchhomebrews/fastcfwswitch-01.png
+https://dlhb.gamebrew.org/switchhomebrews/fastcfwswitchnx.png
-https://dlhb.gamebrew.org/switchhomebrews/fastcfwswitch-02.png
-https://dlhb.gamebrew.org/switchhomebrews/fastcfwswitch-03.png
+==Compatibility==
-https://dlhb.gamebrew.org/switchhomebrews/fastcfwswitch-04.png
+Supported devices:
-https://dlhb.gamebrew.org/switchhomebrews/fastcfwswitch-05.png
-https://dlhb.gamebrew.org/switchhomebrews/fastcfwswitch-06.png
+Only Switch consoles with the old Erista SOC are supported, because exosphere uses a bootrom exploit to reboot to a payload.
-https://dlhb.gamebrew.org/switchhomebrews/fastcfwswitch-07.png
-https://dlhb.gamebrew.org/switchhomebrews/fastcfwswitch-08.png
 ==Changelog==
-'''v.1.0'''
+'''v1.3.1 2023/02/24'''
-* First Release.
+*Updated libtesla for 16.0.0 compability.
+'''v1.3.0 Edit 2022/01/22'''
+*Updated included config to match the updated example.
+'''v1.3.0 2021/10/02'''
+*fastCFWswitch now uses the more secure way to reboot (ams:bpc).
+*This should reduce the amount of possible fs corruptions.
+*SXOS and reinx still use the old, manual reboot.
+'''v1.2.0 2021/03/28'''
+*This release adds support for hekates boot to ums feature.
+**To use it, create an entry with the ums field set to one of the values defined in the README.
+'''v1.1.1 2021/02/22'''
+*This release mostly just adds some small internal changes, like an update to the latest libTesla version, and a few internal refactorings.
+*It also adds an error message on Mariko switches, since those don't support reboot to payload.
+'''v1.1.0 2020/05/31'''
+*Updated to the latest libtesla version.
+*Added support for hekates payload storage, to allow autobooting into different hekate configurations by config position or id (5.0.2+). To use this, set the bootPos or bootId field for the entry in the config file.
+'''v1.0.0 2020/04/15'''
+*First Release.
+*Release zip includes an example configuration and the overlay, just extract it to your sd cards root and modify the configuration to your likings.
+==Credits==
+*[https://github.com/WerWolv/libtesla libtestla] by [https://github.com/WerWolv WerWolv] as base for this overlay.
+*[https://github.com/switchbrew/libnx libnx] as base of almost all switch homebrew.
+*[https://github.com/benhoyt/inih inih] for the ini parsing lib.
 == External links ==
-* Gbatemp - https://gbatemp.net/threads/overlay-fastcfwswitch.562451/
+* GitHub - https://github.com/Hartie95/fastCFWswitch
-* Github - https://github.com/Hartie95/fastCFWswitch
+* GBAtemp - https://gbatemp.net/threads/overlay-fastcfwswitch.562451/
-* Reddit -