Skip to content

Commit 48f82e6

Browse files
npjohnsonnpjohnson
committed
devices: Add the Nintendo Switch (all models) | 21
Change-Id: I6ec9f5d7071dd0fe456061919dbc165e51d97abd
1 parent 0eb9e93 commit 48f82e6

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

62 files changed

+729
-0
lines changed

‎_data/devices/nx_tab_variant1.yml

Lines changed: 36 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,36 @@
1+
architecture: arm64
2+
battery: {capacity: 4310, removable: False, tech: 'Li-Ion'}
3+
bluetooth: {spec: '4.1'}
4+
cameras: []
5+
codename: nx_tab
6+
cpu: Cortex-A57
7+
cpu_cores: '4'
8+
cpu_freq: 1.9 GHz
9+
current_branch: 21
10+
dimensions: {depth: 13.9, height: 102, width: 239}
11+
gpu: NVIDIA GM20B (Maxwell)
12+
image: nx.png
13+
install_method: nintendo
14+
is_unlockable: false
15+
kernel: {repo: android_kernel_nvidia_kernel-nx, version: '4.9'}
16+
maintainers: [makinbacon, npjohnson, webgeek1234]
17+
models: [odin]
18+
name: Switch v1 [Tablet]
19+
network: None
20+
no_oem_unlock_switch: true
21+
peripherals: [Accelerometer, Gyroscope, Sensor hub, Light sensor, Dock, Joycons]
22+
ram: 4 GB
23+
recovery_boot: Boot to Hekate, then select "More Configs", then hold <kbd>Volume Up</kbd> and select the `LineageOS` entry.
24+
recovery_partition_name: recovery
25+
release: 2017-03-03
26+
screen: {resolution: '1280x720', size: 6.2, technology: 'LCD'}
27+
sdcard: {sizeMax: '2 TB'}
28+
soc: NVIDIA Tegra X1 (T210)
29+
storage: 32 GB
30+
tree: android_device_nintendo_nx_tab
31+
type: Handheld game console
32+
variant: 1
33+
vendor: Nintendo
34+
vendor_short: nintendo
35+
versions: [21]
36+
wifi: 802.11 a/b/g/n/ac

‎_data/devices/nx_tab_variant2.yml

Lines changed: 36 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,36 @@
1+
architecture: arm64
2+
battery: {capacity: 4310, removable: False, tech: 'Li-Ion'}
3+
bluetooth: {spec: '4.1'}
4+
cameras: []
5+
codename: nx_tab
6+
cpu: Cortex-A57
7+
cpu_cores: '4'
8+
cpu_freq: 1.9 GHz
9+
current_branch: 21
10+
dimensions: {depth: 13.9, height: 102, width: 239}
11+
gpu: NVIDIA GM20B (Maxwell)
12+
image: nx.png
13+
install_method: nintendo
14+
is_unlockable: false
15+
kernel: {repo: android_kernel_nvidia_kernel-nx, version: '4.9'}
16+
maintainers: [makinbacon, npjohnson, webgeek1234]
17+
models: [modin]
18+
name: Switch v2 [Tablet]
19+
network: None
20+
no_oem_unlock_switch: true
21+
peripherals: [Accelerometer, Gyroscope, Sensor hub, Light sensor, Dock, Joycons]
22+
ram: 4 GB
23+
recovery_boot: Boot to Hekate, then select "More Configs", then hold <kbd>Volume Up</kbd> and select the `LineageOS` entry.
24+
recovery_partition_name: recovery
25+
release: 2019-09-20
26+
screen: {resolution: '1280x720', size: 6.2, technology: 'LCD'}
27+
sdcard: {sizeMax: '2 TB'}
28+
soc: NVIDIA Tegra X1+ (T210b01)
29+
storage: 32 GB
30+
tree: android_device_nintendo_nx_tab
31+
type: Handheld game console
32+
variant: 2
33+
vendor: Nintendo
34+
vendor_short: nintendo
35+
versions: [21]
36+
wifi: 802.11 a/b/g/n/ac

‎_data/devices/nx_tab_variant3.yml

Lines changed: 36 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,36 @@
1+
architecture: arm64
2+
battery: {capacity: 3570, removable: False, tech: 'Li-Ion'}
3+
bluetooth: {spec: '4.1'}
4+
cameras: []
5+
codename: nx_tab
6+
cpu: Cortex-A57
7+
cpu_cores: '4'
8+
cpu_freq: 1.9 GHz
9+
current_branch: 21
10+
dimensions: {depth: 14, height: 91, width: 208}
11+
gpu: NVIDIA GM20B (Maxwell)
12+
image: nx_lite.png
13+
install_method: nintendo
14+
is_unlockable: false
15+
kernel: {repo: android_kernel_nvidia_kernel-nx, version: '4.9'}
16+
maintainers: [makinbacon, npjohnson, webgeek1234]
17+
models: [vali]
18+
name: Switch Lite [Tablet]
19+
network: None
20+
no_oem_unlock_switch: true
21+
peripherals: [Accelerometer, Gyroscope, Sensor hub, Light sensor]
22+
ram: 4 GB
23+
recovery_boot: Boot to Hekate, then select "More Configs", then hold <kbd>Volume Up</kbd> and select the `LineageOS` entry.
24+
recovery_partition_name: recovery
25+
release: 2019-09-20
26+
screen: {resolution: '1280x720', size: 5.5, technology: 'LCD'}
27+
sdcard: {sizeMax: '2 TB'}
28+
soc: NVIDIA Tegra X1+ (T210b01)
29+
storage: 32 GB
30+
tree: android_device_nintendo_nx_tab
31+
type: Handheld game console
32+
variant: 3
33+
vendor: Nintendo
34+
vendor_short: nintendo
35+
versions: [21]
36+
wifi: 802.11 a/b/g/n/ac

‎_data/devices/nx_tab_variant4.yml

Lines changed: 36 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,36 @@
1+
architecture: arm64
2+
battery: {capacity: 4310, removable: False, tech: 'Li-Ion'}
3+
bluetooth: {spec: '4.1'}
4+
cameras: []
5+
codename: nx_tab
6+
cpu: Cortex-A57
7+
cpu_cores: '4'
8+
cpu_freq: 1.9 GHz
9+
current_branch: 20
10+
dimensions: {depth: 14, height: 102, width: 242}
11+
gpu: NVIDIA GM20B (Maxwell)
12+
image: nx_oled.png
13+
install_method: nintendo
14+
is_unlockable: false
15+
kernel: {repo: android_kernel_nvidia_kernel-nx, version: '4.9'}
16+
maintainers: [makinbacon, npjohnson, webgeek1234]
17+
models: [frig]
18+
name: Switch OLED [Tablet]
19+
network: None
20+
no_oem_unlock_switch: true
21+
peripherals: [Accelerometer, Gyroscope, Sensor hub, Light sensor, Dock, Joycons]
22+
ram: 4 GB
23+
recovery_boot: Boot to Hekate, then select "More Configs", then hold <kbd>Volume Up</kbd> and select the `LineageOS` entry.
24+
recovery_partition_name: recovery
25+
release: 2021-10-08
26+
screen: {resolution: '1280x720', size: 7, technology: 'OLED'}
27+
sdcard: {sizeMax: '2 TB'}
28+
soc: NVIDIA Tegra X1+ (T210b01)
29+
storage: 32 GB
30+
tree: android_device_nintendo_nx_tab
31+
type: Handheld game console
32+
variant: 4
33+
vendor: Nintendo
34+
vendor_short: nintendo
35+
versions: [21]
36+
wifi: 802.11 a/b/g/n/ac

‎_data/devices/nx_variant1.yml

Lines changed: 36 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,36 @@
1+
architecture: arm64
2+
battery: {capacity: 4310, removable: False, tech: 'Li-Ion'}
3+
bluetooth: {spec: '4.1'}
4+
cameras: []
5+
codename: nx
6+
cpu: Cortex-A57
7+
cpu_cores: '4'
8+
cpu_freq: 1.9 GHz
9+
current_branch: 21
10+
dimensions: {depth: 13.9, height: 102, width: 239}
11+
gpu: NVIDIA GM20B (Maxwell)
12+
image: nx.png
13+
install_method: nintendo
14+
is_unlockable: false
15+
kernel: {repo: android_kernel_nvidia_kernel-nx, version: '4.9'}
16+
maintainers: [makinbacon, npjohnson, webgeek1234]
17+
models: [odin]
18+
name: Switch v1 [Android TV]
19+
network: None
20+
no_oem_unlock_switch: true
21+
peripherals: [Accelerometer, Gyroscope, Sensor hub, Light sensor, Dock, Joycons]
22+
ram: 4 GB
23+
recovery_boot: Boot to Hekate, then select "More Configs", then hold <kbd>Volume Up</kbd> and select the `LineageOS` entry.
24+
recovery_partition_name: recovery
25+
release: 2017-03-03
26+
screen: {resolution: '1280x720', size: 6.2, technology: 'LCD'}
27+
sdcard: {sizeMax: '2 TB'}
28+
soc: NVIDIA Tegra X1 (T210)
29+
storage: 32 GB
30+
tree: android_device_nintendo_nx
31+
type: Handheld game console
32+
variant: 1
33+
vendor: Nintendo
34+
vendor_short: nintendo
35+
versions: [21]
36+
wifi: 802.11 a/b/g/n/ac

‎_data/devices/nx_variant2.yml

Lines changed: 36 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,36 @@
1+
architecture: arm64
2+
battery: {capacity: 4310, removable: False, tech: 'Li-Ion'}
3+
bluetooth: {spec: '4.1'}
4+
cameras: []
5+
codename: nx
6+
cpu: Cortex-A57
7+
cpu_cores: '4'
8+
cpu_freq: 1.9 GHz
9+
current_branch: 21
10+
dimensions: {depth: 13.9, height: 102, width: 239}
11+
gpu: NVIDIA GM20B (Maxwell)
12+
image: nx.png
13+
install_method: nintendo
14+
is_unlockable: false
15+
kernel: {repo: android_kernel_nvidia_kernel-nx, version: '4.9'}
16+
maintainers: [makinbacon, npjohnson, webgeek1234]
17+
models: [modin]
18+
name: Switch v2 [Android TV]
19+
network: None
20+
no_oem_unlock_switch: true
21+
peripherals: [Accelerometer, Gyroscope, Sensor hub, Light sensor, Dock, Joycons]
22+
ram: 4 GB
23+
recovery_boot: Boot to Hekate, then select "More Configs", then hold <kbd>Volume Up</kbd> and select the `LineageOS` entry.
24+
recovery_partition_name: recovery
25+
release: 2019-09-20
26+
screen: {resolution: '1280x720', size: 6.2, technology: 'LCD'}
27+
sdcard: {sizeMax: '2 TB'}
28+
soc: NVIDIA Tegra X1+ (T210b01)
29+
storage: 32 GB
30+
tree: android_device_nintendo_nx
31+
type: Handheld game console
32+
variant: 2
33+
vendor: Nintendo
34+
vendor_short: nintendo
35+
versions: [21]
36+
wifi: 802.11 a/b/g/n/ac

‎_data/devices/nx_variant3.yml

Lines changed: 36 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,36 @@
1+
architecture: arm64
2+
battery: {capacity: 3570, removable: False, tech: 'Li-Ion'}
3+
bluetooth: {spec: '4.1'}
4+
cameras: []
5+
codename: nx
6+
cpu: Cortex-A57
7+
cpu_cores: '4'
8+
cpu_freq: 1.9 GHz
9+
current_branch: 21
10+
dimensions: {depth: 14, height: 91, width: 208}
11+
gpu: NVIDIA GM20B (Maxwell)
12+
image: nx_lite.png
13+
install_method: nintendo
14+
is_unlockable: false
15+
kernel: {repo: android_kernel_nvidia_kernel-nx, version: '4.9'}
16+
maintainers: [makinbacon, npjohnson, webgeek1234]
17+
models: [vali]
18+
name: Switch Lite [Android TV]
19+
network: None
20+
no_oem_unlock_switch: true
21+
peripherals: [Accelerometer, Gyroscope, Sensor hub, Light sensor]
22+
ram: 4 GB
23+
recovery_boot: Boot to Hekate, then select "More Configs", then hold <kbd>Volume Up</kbd> and select the `LineageOS` entry.
24+
recovery_partition_name: recovery
25+
release: 2019-09-20
26+
screen: {resolution: '1280x720', size: 5.5, technology: 'LCD'}
27+
sdcard: {sizeMax: '2 TB'}
28+
soc: NVIDIA Tegra X1+ (T210b01)
29+
storage: 32 GB
30+
tree: android_device_nintendo_nx
31+
type: Handheld game console
32+
variant: 3
33+
vendor: Nintendo
34+
vendor_short: nintendo
35+
versions: [21]
36+
wifi: 802.11 a/b/g/n/ac

‎_data/devices/nx_variant4.yml

Lines changed: 36 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,36 @@
1+
architecture: arm64
2+
battery: {capacity: 4310, removable: False, tech: 'Li-Ion'}
3+
bluetooth: {spec: '4.1'}
4+
cameras: []
5+
codename: nx
6+
cpu: Cortex-A57
7+
cpu_cores: '4'
8+
cpu_freq: 1.9 GHz
9+
current_branch: 20
10+
dimensions: {depth: 14, height: 102, width: 242}
11+
gpu: NVIDIA GM20B (Maxwell)
12+
image: nx_oled.png
13+
install_method: nintendo
14+
is_unlockable: false
15+
kernel: {repo: android_kernel_nvidia_kernel-nx, version: '4.9'}
16+
maintainers: [makinbacon, npjohnson, webgeek1234]
17+
models: [frig]
18+
name: Switch OLED [Android TV]
19+
network: None
20+
no_oem_unlock_switch: true
21+
peripherals: [Accelerometer, Gyroscope, Sensor hub, Light sensor, Dock, Joycons]
22+
ram: 4 GB
23+
recovery_boot: Boot to Hekate, then select "More Configs", then hold <kbd>Volume Up</kbd> and select the `LineageOS` entry.
24+
recovery_partition_name: recovery
25+
release: 2021-10-08
26+
screen: {resolution: '1280x720', size: 7, technology: 'OLED'}
27+
sdcard: {sizeMax: '2 TB'}
28+
soc: NVIDIA Tegra X1+ (T210b01)
29+
storage: 32 GB
30+
tree: android_device_nintendo_nx
31+
type: Handheld game console
32+
variant: 4
33+
vendor: Nintendo
34+
vendor_short: nintendo
35+
versions: [21]
36+
wifi: 802.11 a/b/g/n/ac

‎_includes/templates/recovery_install_nintendo.md

Lines changed: 66 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,66 @@
1+
## Pre-Install Information
2+
3+
LineageOS builds for this device support the following device configurations:
4+
5+
Configuration 1:
6+
* An original, exploitable "v1" Nintendo Switch with your preferred JoyCons attached during installation
7+
{% include alerts/note.html content="This can be identified by the model number 'MOD.' on the rear of the device `HAC-001` is exploitable, while `HAC-001(-01)`, or any other model number is not, and therefore you must use Configuration 2." %}
8+
* An RCM Jig such as [this one](https://www.amazon.com/Nintendo-Switch-Short-Connector-Recovery/dp/B07J9JJRRG))
9+
* Hekate `v6.1.0` loaded via a Fusee launcher such as [this one](https://webrcm.github.io)
10+
{% include alerts/warning.html content="This configuration requires that the Fusee launcher be ran every time you wish to boot Android! With this in mind, Configuration 2 is heavily preferred." %}
11+
12+
Configuration 2:
13+
* A hard-modded (often called "ModChipped") Switch v1 / v2 / Lite / OLED with your preferred JoyCons attached during installation
14+
* Hekate `v6.1.0` on your SD Card, and loaded by your ModChip
15+
16+
Additionally, we support two installation locations:
17+
* SD Card
18+
{% include alerts/warning.html content="This installation location requires a high quality, high speed SD Card to function." %}
19+
* eMMC
20+
{% include alerts/warning.html content="This installation location requires space be taken from HOS (the stock Switch OS), so please tread carefully." %}
21+
22+
This guide will detail SD Card installation, if you wish to install Android to the eMMC, you will need to consult external resources.
23+
24+
Additionally, his guide will not detail exploiting or ModChipping your Switch, or the installation of Hekate, so please go select the applicable/preferred installation configuration to your device, and come back when Hekate `v6.1.0` or newer is booted on the device.
25+
26+
## Preparing the SD Card
27+
1. In Hekate, select "Tools" in the top-center of the screen, then click "USB Tools" in the bottom right, finally selecting "SD Card" under the "USB Mass Storage" header in the top-left of the screen.
28+
2. Connect your device to your PC, and navigate to your SD Card once it is mounted.
29+
3. Please download the following files from [here](https://download.lineageos.org/devices/{{ device.codename }}/builds) and place them in the noted folders (which you will potentially have to create) on your device's SD Card:
30+
* `boot.img` -> `switchroot/install/boot.img`
31+
* `recovery.img` -> `switchroot/install/recovery.img`
32+
* `nx-plat.dtimg` -> `switchroot/install/nx-plat.dtimg`
33+
* `bl31.bin` -> `switchroot/android/bl31.bin`
34+
* `bl33.bin` -> `switchroot/android/bl33.bin`
35+
3. Please download the following files and place them in the noted folders (which you will potentially have to create) on your device's SD Card:
36+
* [`bootlogo_android.bmp`]({{ "images/device_specific/nx/bootlogo_android.bmp" | relative_url }}) -> `switchroot/android/bootlogo_android.bmp`
37+
* [`icon_android_hue.bmp`]({{ "images/device_specific/nx/icon_android_hue.bmp" | relative_url }}) -> `switchroot/android/icon_android_hue.bmp`
38+
4. Create a new text file called `android.ini` at `bootloader/ini/android.ini` and populate it with the following:
39+
```
40+
[LineageOS]
41+
l4t=1
42+
boot_prefixes=switchroot/android/
43+
id=SWANDR
44+
icon=switchroot/android/icon_android_hue.bmp
45+
logopath=switchroot/android/bootlogo_android.bmp
46+
r2p_action=self
47+
```
48+
5. Safely eject the SD Card from your PC's file browser, then click "Close" on the device, then the "X" icon in the top right of the screen, and finally the "Home" button in the top-left of the screen.
49+
6. In Hekate, select "Nyx Settings" in the bottom-left of the screen, then "Dump Joy-Con BT" from the top-right.
50+
7. Click "OK" once a message indicates success, the message will look like this:
51+
```
52+
Success!
53+
Found 2 out of 2 Joy-Con Pairing data!
54+
Both pairing data are HOS based!
55+
```
56+
{% include alerts/note.html content="You must have booted HOS (the stock Nintendo Switch OS) with your preferred JoyCons attached prior to doing this, or it will likely not succeed. You may boot to HOS at this point if necessary, and re-run this specific step after reboot." %}
57+
58+
## Partitioning the System
59+
1. Please back up ALL data on the SD Card before proceeding with installation, as all data/games/save data stored on the SD Card will be erased in the process of installation.
60+
{% include alerts/warning.html content="Upgrades, or dirty-installs from any unofficial build will NOT function, please start with a freshly partitioned system." %}
61+
{% include alerts/warning.html content="Please note that the files you have just copied in prior steps will be backed up and restored onto the SD Card by Hekate." %}
62+
3. In Hekate, select "Tools" in the top-center of the screen, then "Partition SD Card", then click "OK" when prompted.
63+
4. Now, make your partition scheme selections based on your needs, as well as any other operating systems you may plan to install alongside Android.
64+
{% include alerts/note.html content="Please give Android no less than roughly 10 GB to ensure that enough space is present." %}
65+
5. When content with your selections, click "Next Step" in the bottom-right of the screen, then when ready click "Start", then follow the on-screen instructions to proceed with the partitioning process.
66+
6. When the process is complete, select "Flash Android" and accept the prompt to reboot to recovery.

‎images/device_specific/nx/bootlogo_android.bmp

3.52 MB
Binary file not shown.

‎images/device_specific/nx/icon_android_hue.bmp

144 KB
Binary file not shown.

‎images/devices/nx.png

98 KB
Loading

‎images/devices/nx_lite.png

150 KB
Loading

‎images/devices/nx_oled.png

117 KB
Loading

‎images/devices/small/nx.png

13.4 KB
Loading

‎images/devices/small/nx_lite.png

16 KB
Loading

‎images/devices/small/nx_oled.png

18.5 KB
Loading

‎pages/build/nx_tab_variant1.md

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,8 @@
1+
---
2+
sidebar: home_sidebar
3+
title: Build for nx_tab
4+
folder: build
5+
permalink: /devices/nx_tab/build/variant1/
6+
device: nx_tab_variant1
7+
---
8+
{% include templates/device_build.md %}

‎pages/build/nx_tab_variant2.md

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,8 @@
1+
---
2+
sidebar: home_sidebar
3+
title: Build for nx_tab
4+
folder: build
5+
permalink: /devices/nx_tab/build/variant2/
6+
device: nx_tab_variant2
7+
---
8+
{% include templates/device_build.md %}

‎pages/build/nx_tab_variant3.md

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,8 @@
1+
---
2+
sidebar: home_sidebar
3+
title: Build for nx_tab
4+
folder: build
5+
permalink: /devices/nx_tab/build/variant3/
6+
device: nx_tab_variant3
7+
---
8+
{% include templates/device_build.md %}

‎pages/build/nx_tab_variant4.md

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,8 @@
1+
---
2+
sidebar: home_sidebar
3+
title: Build for nx_tab
4+
folder: build
5+
permalink: /devices/nx_tab/build/variant4/
6+
device: nx_tab_variant4
7+
---
8+
{% include templates/device_build.md %}

0 commit comments

Comments
 (0)