Nintendo Switch Brew - User contributions [en]

3.0.1

2017-10-27T14:53:59Z

Smartperson: /* Change-log */ Update formatting to match Nintendo official info

The Switch 3.0.1 system update was released on July 31, 2017. This Switch update was released for the following regions: ALL.

Security flaws fixed: <fill this in manually later, see the updatedetails page from the ninupdates-report page(s) once available for now>.

==Change-log==
[http://en-americas-support.nintendo.com/app/answers/detail/a_id/22525/p/897 Official] ALL change-log:

'''General system stability improvements to enhance the user's experience, including:'''
* Addressed an issue in which the remaining battery charge can't be displayed accurately
** If the system's battery power display suddenly increases or decreases, it will gradually improve by [http://en-americas-support.nintendo.com/app/answers/detail/a_id/27111 following these steps].

==System Titles==
Exactly the following was updated:
* Every sysmodule.
* Every web-applet.
* Sysupdate titlelisting-title, browser "shareddata:/", [[System Version Title]], and all FIRM packages.

All sysmodules were rebuilt, where the only change was the hashid following the "GNU" string, however some sysmodules have additional changes.
* Some sysmodules have strings containing "D:\'''h'''ome\teamcity\work\sdk\Externals\{...}" changed to "D:\'''H'''ome\teamcity\work\sdk\Externals\{...}".
* Build timestamp in wlan-sysmodule was updated.

Actual updated sysmodules:
* nvservices
* pcv
* account
* nim
* pctl
* npns
* eupld

The only changes for npns and account: The <nowiki>"https://dauth-%.ndas.srv.nintendo.net/v1/device_auth_token"</nowiki> URL was changed to <nowiki>"https://dauth-%.ndas.srv.nintendo.net/{hex string}/device_auth_token"</nowiki>.

The above new URL was added(not replacing any URL in .(ro)data) to nim, + code changes. A "device_auth_token" string in nim was removed.

As of October 19, 2017, manually accessing the above new URL with the proper post-data works fine, however accessing the old URL returns the following: <code>{"errors":[{"code":"0007","message":"System update is required."}]}</code>
Hence, all sysmodules using the old URL would throw a sysupdate-required error.

===FIRM packages===
819:

Everything under RomFS was updated.

Kernel wasn't updated.

The following firm-sysmodules were updated: FS, boot, and sm. The remaining modules(Loader, NCM, ProcessMana, and spl) were rebuilt: hashid following "GNU" string was updated.

====[[Filesystem_services|FS]]====
Basically all code changes are related to the new [[NCA_Format|NCA]] crypto. Key-init function was updated due to the new NCA crypto. Various keyindex values were updated due to the new NCA crypto, for non-NCA and NCA code. A function which returned ncahdr_x206("Crypto Type") was replaced with a branch to the new <get-final-cryptotype> function described [[NCA_Format|here]](equivalent to similar changes elsewhere).

====boot====
Updated 1 func and added a new func:
* Added a call to <new func>. w1 value passed to L_381c(prev ver L_37d4) is now the output of <mask>, instead of fixed to 0x1.

==Internet Browser==
All webapplets were updated, vulnerabilities were fixed. 803/buildinfo/buildinfo.dat contains the following:
r:14938
p:NX64
v:Release
d:2017-07-11 17:51
n:0.6.10

==Keys==
The bootloader [[BCT#bootloader0_info|version]] was changed from 2 to 3.

New keydata was introduced for NCA content, see [[NCA_Format|here]].

New keydata was introduced for [[BCAT_Content_Container| BCAT containers]] for indexes 0x10 to 0x1F.

==See Also==
System update report(s):
* [https://yls8.mtheall.com/ninupdates/reports.php?date=07-31-17_08-05-16&sys=hac]

{{NavboxVersions}}

3.0.2

2017-10-27T14:51:57Z

Smartperson: Update formatting to match Nintendo official change log

The Switch 3.0.2 system update was released on September 5, 2017. This Switch update was released for the following regions: ALL.

Security flaws fixed: <fill this in manually later, see the updatedetails page from the ninupdates-report page(s) once available for now>.

==Change-log==
[http://en-americas-support.nintendo.com/app/answers/detail/a_id/22525/p/897 Official] ALL change-log:
* Nintendo Switch Online
** Added online play in Argentina, Brazil, Chile, Colombia, and Peru. This is currently available for free until the paid online service launches in 2018.
* General system stability improvements to enhance the user's experience

==System Titles==
<fill this in (manually) later>

===FIRM-packages===
819:

The only change under RomFS "/nx/" was package2. Filesize is same as before.

Kernel was updated. FIRM-sysmodules were not updated.

===0100000000000823===
The [[Title_list|0100000000000823]] title was updated, the following was updated in RomFS:
* /ac_0_not_b_nx
* /ac_1_not_b_nx
* /ac_2_not_b_nx
* /ac_3_b1_nx
* /ac_3_b2_nx
* /ac_3_not_b_nx

==See Also==
System update report(s):
* [https://yls8.mtheall.com/ninupdates/reports.php?date=09-05-17_08-05-14&sys=hac]

{{NavboxVersions}}

4.0.0

2017-10-27T14:39:36Z

Smartperson: /* Unofficial Changes */

The Switch 4.0.0 system update was released on October 18, 2017. This Switch update was released for the following regions: ALL.

Security flaws fixed: <fill this in manually later, see the updatedetails page from the ninupdates-report page(s) once available for now>.

==Change-log==
[http://en-americas-support.nintendo.com/app/answers/detail/a_id/22525/p/897 Official] ALL change-log:

'''Added the following system functionality'''

* Capture video on select games
** To capture video, hold down the Capture Button during gameplay
** Up to maximum of the previous 30 seconds will be saved in the Album. You can trim the beginning and end of each clip, and post to Facebook and Twitter.
** As of October 18th, 2017, this feature is compatible with The Legend of Zelda: Breath of the Wild, Mario Kart 8 Deluxe, ARMS, and Splatoon 2
* Select from 12 new Super Mario Odyssey and The Legend of Zelda: Breath of the Wild icons for your user
** To edit your user icon, head to your My Page on the top left of the Home Menu > Profile
* Transfer user and save data to another system
** To transfer, head to System Settings > Users > Transfer Your User and Save Data
* Pre-purchase option on Nintendo eShop
** A pre-purchase option will be available for certain games. This option allows pre-load of the game to your system for quicker play when the game is released.
** This feature will be supported by future game releases
* News channel updates
** The news feed has been updated with a new look.
** Unfollowing a channel will remove that channel's content from the news feed and following the channel again will make it reappear.
* Match software version with a group of local users
** To create a group, head to the software's Options > Software Update > Match Version with Local Users
** Everyone's software will be updated to match the most recent version in the group
** All users must be on system menu version 4.0.0 or later to view and join a group

'''General system stability improvements to enhance the user's experience, including'''

* Changed the specification which hid wireless networks using TKIP security from the network search results. Wireless networks using TKIP security will now display in search results as a grayed-out selection instead of not being displayed
** The Nintendo Switch console supports WEP, WPA-PSK(AES), and WPA2-PSK(AES). If your router is using a different security type (e.g. WPA-PSK(TKIP)), you will need to change this security type within your router's settings.

==Unofficial Changes==
* Added support for Wii U GameCube Adapter and Headsets [[List of compatible USB devices | over USB]]

==System Titles==
<fill this in (manually) later>

* Every single system title was updated, except for: 0100000000000805("Chinese and Korean dictionaries"), 0100000000000808("European, English and Japanese dictionaries"), and 010000000000080C("EULA").
* 4 new sysmodules were added, and new FIRM-package title 010000000000081C was added.

===FIRM===
Everything under RomFS was updated.

The package1 entrypoint address specified by BCT was increased by 0x20-bytes, since there's now an additional 0x20-bytes at the start of package1. The additional data is identical to the 0x20-byte block before it.

====Package1====
setKeyslotFlags (LT_4001011a)
Instead of writing ~flags directly to securityEngine->KEYSLOT_FLAGS[keyslot], this now preserves the high bits of the existing flags.

getOdmFuse4Type (LT_40010614)
This func now includes bits 16-19 in the OR'd flag used in the switch, and now returns 4 as a default invalid result instead of the low bit of [[Fuses|FUSE_SPARE_BIT_5]].

checkFuseCoherency (LT_400106e4)
This func was updated to take into account the new invalid retval for getOdmFuse4Type.
Checks that were only enforced on retail prior to this update (bootROM patch must be < 0x7F and EKS must be provisionned) are now enforced for dev too.
The now redundant bootROM patch version < 0x1F check was removed.

decryptAndParsePK11 (LT_40010734)
The entrypoint calculation code no longer adds *(package11Header + 0x4) to the address.

generateKeys (LT_400107a2)
setKeyslotFlags(keyslot, 0x15) is now additionally called on keyslots 14 and 15.
The code for switching key generation method depending on fuses (unit type) and last byte of PKC modulus has been removed, and replaced with a call to a single key generation function.
The code block inbetween the keyslot-config code was replaced with just a call to LT_40011264(same function mentioned above).
setKeyslotFlags(keyslot, 0xFF) is now used on keyslots 12 and 15 instead of 12 and 13.

downgradeFuseCheck (LT_400111cc)
The burnt fuse information stored in .rodata now expects 5 fuses to be burnt for retail units, instead of 4.

generateKeysFromBITAddress (LT_40011264)
Instead of calling generateKeysLegacyMethod, this now calls generateKeysFromKeyblobAndKeyseeds (the main key generation function). Legacy key generation code has been removed.

generateKeysFromKeyblobAndKeyseeds (LT_400112f0)
The function now takes in two keyseeds and sizes, previously it only took in one (keyseed, size) pair.
Keyslot 15 (initially SSK) is now used where keyslot 10 was used previously, and keyslot 15 is no longer cleared when keyslot 14 (initially SBK) is cleared.
The [[Flash_Filesystem|Keyblob]] keyseed was updated for keyblob 4.
code block following the keyblob clear code was updated:
After the decrypted keyblob is cleared, decryptDataIntoKeyslot(KEYSLOT_14, KEYSLOT_12, secondKeySeed, secondKeySeedSize) is now called before decryptDataIntoKeyslot(KEYSLOT_12, KEYSLOT_12, firstKeySeed, firstKeySeedSize).
At the end of the function, "decryptDataIntoKeyslot(KEYSLOT_13, KEYSLOT_10, perConsoleKeyseed2, 0x10); clearKeyslot(KEYSLOT_10);" has been replaced with "decryptDataIntoKeyslot(KEYSLOT_13, KEYSLOT_15, perConsoleKeyseed3, 0x10); decryptDataIntoKeyslot(KEYSLOT_15, KEYSLOT_15, perConsoleKeyseed2, 0x10);"

==Keys==
All of these updated titles now use the new [[NCA_Format|NCA]] crypto for [[NCA|non-ncatype0]](all content except .cnmt content), except for all of the FIRM-packages including the new one(required for FIRM installation).

[[Flash_Filesystem|Keyblob]] 4 is now used, instead of 3.

==OSS==
The updated [https://www.nintendo.co.jp/support/oss/index.html OSS] includes WebKit changes.

==See Also==
System update report(s):
* [https://yls8.mtheall.com/ninupdates/reports.php?date=10-18-17_08-05-13&sys=hac]

{{NavboxVersions}}

4.0.0

2017-10-27T14:39:12Z

Smartperson: Added note for GCN controller and USB headset support

The Switch 4.0.0 system update was released on October 18, 2017. This Switch update was released for the following regions: ALL.

Security flaws fixed: <fill this in manually later, see the updatedetails page from the ninupdates-report page(s) once available for now>.

==Change-log==
[http://en-americas-support.nintendo.com/app/answers/detail/a_id/22525/p/897 Official] ALL change-log:

'''Added the following system functionality'''

* Capture video on select games
** To capture video, hold down the Capture Button during gameplay
** Up to maximum of the previous 30 seconds will be saved in the Album. You can trim the beginning and end of each clip, and post to Facebook and Twitter.
** As of October 18th, 2017, this feature is compatible with The Legend of Zelda: Breath of the Wild, Mario Kart 8 Deluxe, ARMS, and Splatoon 2
* Select from 12 new Super Mario Odyssey and The Legend of Zelda: Breath of the Wild icons for your user
** To edit your user icon, head to your My Page on the top left of the Home Menu > Profile
* Transfer user and save data to another system
** To transfer, head to System Settings > Users > Transfer Your User and Save Data
* Pre-purchase option on Nintendo eShop
** A pre-purchase option will be available for certain games. This option allows pre-load of the game to your system for quicker play when the game is released.
** This feature will be supported by future game releases
* News channel updates
** The news feed has been updated with a new look.
** Unfollowing a channel will remove that channel's content from the news feed and following the channel again will make it reappear.
* Match software version with a group of local users
** To create a group, head to the software's Options > Software Update > Match Version with Local Users
** Everyone's software will be updated to match the most recent version in the group
** All users must be on system menu version 4.0.0 or later to view and join a group

'''General system stability improvements to enhance the user's experience, including'''

* Changed the specification which hid wireless networks using TKIP security from the network search results. Wireless networks using TKIP security will now display in search results as a grayed-out selection instead of not being displayed
** The Nintendo Switch console supports WEP, WPA-PSK(AES), and WPA2-PSK(AES). If your router is using a different security type (e.g. WPA-PSK(TKIP)), you will need to change this security type within your router's settings.

==Unofficial Changes==
* Support for Wii U GameCube Adapter and Headsets [[List of compatible USB devices | over USB]]

==System Titles==
<fill this in (manually) later>

* Every single system title was updated, except for: 0100000000000805("Chinese and Korean dictionaries"), 0100000000000808("European, English and Japanese dictionaries"), and 010000000000080C("EULA").
* 4 new sysmodules were added, and new FIRM-package title 010000000000081C was added.

===FIRM===
Everything under RomFS was updated.

The package1 entrypoint address specified by BCT was increased by 0x20-bytes, since there's now an additional 0x20-bytes at the start of package1. The additional data is identical to the 0x20-byte block before it.

====Package1====
setKeyslotFlags (LT_4001011a)
Instead of writing ~flags directly to securityEngine->KEYSLOT_FLAGS[keyslot], this now preserves the high bits of the existing flags.

getOdmFuse4Type (LT_40010614)
This func now includes bits 16-19 in the OR'd flag used in the switch, and now returns 4 as a default invalid result instead of the low bit of [[Fuses|FUSE_SPARE_BIT_5]].

checkFuseCoherency (LT_400106e4)
This func was updated to take into account the new invalid retval for getOdmFuse4Type.
Checks that were only enforced on retail prior to this update (bootROM patch must be < 0x7F and EKS must be provisionned) are now enforced for dev too.
The now redundant bootROM patch version < 0x1F check was removed.

decryptAndParsePK11 (LT_40010734)
The entrypoint calculation code no longer adds *(package11Header + 0x4) to the address.

generateKeys (LT_400107a2)
setKeyslotFlags(keyslot, 0x15) is now additionally called on keyslots 14 and 15.
The code for switching key generation method depending on fuses (unit type) and last byte of PKC modulus has been removed, and replaced with a call to a single key generation function.
The code block inbetween the keyslot-config code was replaced with just a call to LT_40011264(same function mentioned above).
setKeyslotFlags(keyslot, 0xFF) is now used on keyslots 12 and 15 instead of 12 and 13.

downgradeFuseCheck (LT_400111cc)
The burnt fuse information stored in .rodata now expects 5 fuses to be burnt for retail units, instead of 4.

generateKeysFromBITAddress (LT_40011264)
Instead of calling generateKeysLegacyMethod, this now calls generateKeysFromKeyblobAndKeyseeds (the main key generation function). Legacy key generation code has been removed.

generateKeysFromKeyblobAndKeyseeds (LT_400112f0)
The function now takes in two keyseeds and sizes, previously it only took in one (keyseed, size) pair.
Keyslot 15 (initially SSK) is now used where keyslot 10 was used previously, and keyslot 15 is no longer cleared when keyslot 14 (initially SBK) is cleared.
The [[Flash_Filesystem|Keyblob]] keyseed was updated for keyblob 4.
code block following the keyblob clear code was updated:
After the decrypted keyblob is cleared, decryptDataIntoKeyslot(KEYSLOT_14, KEYSLOT_12, secondKeySeed, secondKeySeedSize) is now called before decryptDataIntoKeyslot(KEYSLOT_12, KEYSLOT_12, firstKeySeed, firstKeySeedSize).
At the end of the function, "decryptDataIntoKeyslot(KEYSLOT_13, KEYSLOT_10, perConsoleKeyseed2, 0x10); clearKeyslot(KEYSLOT_10);" has been replaced with "decryptDataIntoKeyslot(KEYSLOT_13, KEYSLOT_15, perConsoleKeyseed3, 0x10); decryptDataIntoKeyslot(KEYSLOT_15, KEYSLOT_15, perConsoleKeyseed2, 0x10);"

==Keys==
All of these updated titles now use the new [[NCA_Format|NCA]] crypto for [[NCA|non-ncatype0]](all content except .cnmt content), except for all of the FIRM-packages including the new one(required for FIRM installation).

[[Flash_Filesystem|Keyblob]] 4 is now used, instead of 3.

==OSS==
The updated [https://www.nintendo.co.jp/support/oss/index.html OSS] includes WebKit changes.

==See Also==
System update report(s):
* [https://yls8.mtheall.com/ninupdates/reports.php?date=10-18-17_08-05-13&sys=hac]

{{NavboxVersions}}

4.0.0

2017-10-27T10:43:13Z

Smartperson: /* Change-log */ Removed overzealous Nintendo format matching (red color).

The Switch 4.0.0 system update was released on October 18, 2017. This Switch update was released for the following regions: ALL.

Security flaws fixed: <fill this in manually later, see the updatedetails page from the ninupdates-report page(s) once available for now>.

==Change-log==
[http://en-americas-support.nintendo.com/app/answers/detail/a_id/22525/p/897 Official] ALL change-log:

'''Added the following system functionality'''

* Capture video on select games
** To capture video, hold down the Capture Button during gameplay
** Up to maximum of the previous 30 seconds will be saved in the Album. You can trim the beginning and end of each clip, and post to Facebook and Twitter.
** As of October 18th, 2017, this feature is compatible with The Legend of Zelda: Breath of the Wild, Mario Kart 8 Deluxe, ARMS, and Splatoon 2
* Select from 12 new Super Mario Odyssey and The Legend of Zelda: Breath of the Wild icons for your user
** To edit your user icon, head to your My Page on the top left of the Home Menu > Profile
* Transfer user and save data to another system
** To transfer, head to System Settings > Users > Transfer Your User and Save Data
* Pre-purchase option on Nintendo eShop
** A pre-purchase option will be available for certain games. This option allows pre-load of the game to your system for quicker play when the game is released.
** This feature will be supported by future game releases
* News channel updates
** The news feed has been updated with a new look.
** Unfollowing a channel will remove that channel's content from the news feed and following the channel again will make it reappear.
* Match software version with a group of local users
** To create a group, head to the software's Options > Software Update > Match Version with Local Users
** Everyone's software will be updated to match the most recent version in the group
** All users must be on system menu version 4.0.0 or later to view and join a group

'''General system stability improvements to enhance the user's experience, including'''

* Changed the specification which hid wireless networks using TKIP security from the network search results. Wireless networks using TKIP security will now display in search results as a grayed-out selection instead of not being displayed
** The Nintendo Switch console supports WEP, WPA-PSK(AES), and WPA2-PSK(AES). If your router is using a different security type (e.g. WPA-PSK(TKIP)), you will need to change this security type within your router's settings.

==System Titles==
<fill this in (manually) later>

* Every single system title was updated, except for: 0100000000000805("Chinese and Korean dictionaries"), 0100000000000808("European, English and Japanese dictionaries"), and 010000000000080C("EULA").
* 4 new sysmodules were added, and new FIRM-package title 010000000000081C was added.

===FIRM===
Everything under RomFS was updated.

The package1 entrypoint address specified by BCT was increased by 0x20-bytes, since there's now an additional 0x20-bytes at the start of package1. The additional data is identical to the 0x20-byte block before it.

====Package1====
setKeyslotFlags (LT_4001011a)
Instead of writing ~flags directly to securityEngine->KEYSLOT_FLAGS[keyslot], this now preserves the high bits of the existing flags.

getOdmFuse4Type (LT_40010614)
This func now includes bits 16-19 in the OR'd flag used in the switch, and now returns 4 as a default invalid result instead of the low bit of [[Fuses|FUSE_SPARE_BIT_5]].

checkFuseCoherency (LT_400106e4)
This func was updated to take into account the new invalid retval for getOdmFuse4Type.
Checks that were only enforced on retail prior to this update (bootROM patch must be < 0x7F and EKS must be provisionned) are now enforced for dev too.
The now redundant bootROM patch version < 0x1F check was removed.

decryptAndParsePK11 (LT_40010734)
The entrypoint calculation code no longer adds *(package11Header + 0x4) to the address.

generateKeys (LT_400107a2)
setKeyslotFlags(keyslot, 0x15) is now additionally called on keyslots 14 and 15.
The code for switching key generation method depending on fuses (unit type) and last byte of PKC modulus has been removed, and replaced with a call to a single key generation function.
The code block inbetween the keyslot-config code was replaced with just a call to LT_40011264(same function mentioned above).
setKeyslotFlags(keyslot, 0xFF) is now used on keyslots 12 and 15 instead of 12 and 13.

downgradeFuseCheck (LT_400111cc)
The burnt fuse information stored in .rodata now expects 5 fuses to be burnt for retail units, instead of 4.

generateKeysFromBITAddress (LT_40011264)
Instead of calling generateKeysLegacyMethod, this now calls generateKeysFromKeyblobAndKeyseeds (the main key generation function). Legacy key generation code has been removed.

generateKeysFromKeyblobAndKeyseeds (LT_400112f0)
The function now takes in two keyseeds and sizes, previously it only took in one (keyseed, size) pair.
Keyslot 15 (initially SSK) is now used where keyslot 10 was used previously, and keyslot 15 is no longer cleared when keyslot 14 (initially SBK) is cleared.
The [[Flash_Filesystem|Keyblob]] keyseed was updated for keyblob 4.
code block following the keyblob clear code was updated:
After the decrypted keyblob is cleared, decryptDataIntoKeyslot(KEYSLOT_14, KEYSLOT_12, secondKeySeed, secondKeySeedSize) is now called before decryptDataIntoKeyslot(KEYSLOT_12, KEYSLOT_12, firstKeySeed, firstKeySeedSize).
At the end of the function, "decryptDataIntoKeyslot(KEYSLOT_13, KEYSLOT_10, perConsoleKeyseed2, 0x10); clearKeyslot(KEYSLOT_10);" has been replaced with "decryptDataIntoKeyslot(KEYSLOT_13, KEYSLOT_15, perConsoleKeyseed3, 0x10); decryptDataIntoKeyslot(KEYSLOT_15, KEYSLOT_15, perConsoleKeyseed2, 0x10);"

==Keys==
All of these updated titles now use the new [[NCA_Format|NCA]] crypto for [[NCA|non-ncatype0]](all content except .cnmt content), except for all of the FIRM-packages including the new one(required for FIRM installation).

[[Flash_Filesystem|Keyblob]] 4 is now used, instead of 3.

==OSS==
The updated [https://www.nintendo.co.jp/support/oss/index.html OSS] includes WebKit changes.

==See Also==
System update report(s):
* [https://yls8.mtheall.com/ninupdates/reports.php?date=10-18-17_08-05-13&sys=hac]

{{NavboxVersions}}

4.0.1

2017-10-27T10:35:25Z

Smartperson: Created page with "The Switch 4.0.1 system update was released on October 25, 2017. This Switch update was released for the following regions: ALL. Security flaws fixed: <fill this in manually..."

The Switch 4.0.1 system update was released on October 25, 2017. This Switch update was released for the following regions: ALL.

Security flaws fixed: <fill this in manually later, see the updatedetails page from the ninupdates-report page(s) once available for now>.

==Change-log==
[http://en-americas-support.nintendo.com/app/answers/detail/a_id/22525/~/nintendo-switch-system-updates-and-change-history Official] ALL change-log:

* '''General system stability improvements to enhance the user's experience, including:'''
** Changed the HDMI connection process specification to match that of version 3.0.2 to address video and sound output issues with some TV models.

==System Titles==
<fill this in (manually) later>

==See Also==
System update report(s):
* [https://yls8.mtheall.com/ninupdates/reports.php?date=10-25-17_08-05-13&sys=hac 1]

4.0.0

2017-10-27T10:25:42Z

Smartperson: /* Change-log */ Updated formatting to match Nintendo's official and improve readability

The Switch 4.0.0 system update was released on October 18, 2017. This Switch update was released for the following regions: ALL.

Security flaws fixed: <fill this in manually later, see the updatedetails page from the ninupdates-report page(s) once available for now>.

==Change-log==
[http://en-americas-support.nintendo.com/app/answers/detail/a_id/22525/p/897 Official] ALL change-log:

'''Added the following system functionality'''

* Capture video on select games
** To capture video, <span style="color:#FF0000">'''hold down the Capture Button'''</span> during gameplay
** Up to maximum of the previous 30 seconds will be saved in the Album. You can trim the beginning and end of each clip, and post to Facebook and Twitter.
** As of October 18th, 2017, this feature is compatible with The Legend of Zelda: Breath of the Wild, Mario Kart 8 Deluxe, ARMS, and Splatoon 2
* Select from 12 new Super Mario Odyssey and The Legend of Zelda: Breath of the Wild icons for your user
** To edit your user icon, head to your My Page on the top left of the Home Menu > Profile
* Transfer user and save data to another system
** To transfer, head to System Settings > Users > <span style="color:#FF0000">'''Transfer Your User and Save Data'''</span>
* Pre-purchase option on Nintendo eShop
** A pre-purchase option will be available for certain games. This option allows pre-load of the game to your system for quicker play when the game is released.
** This feature will be supported by future game releases
* News channel updates
** The news feed has been updated with a new look.
** Unfollowing a channel will remove that channel's content from the news feed and following the channel again will make it reappear.
* Match software version with a group of local users
** To create a group, head to the software's Options > Software Update > <span style="color:#FF0000">'''Match Version with Local Users'''</span>
** Everyone's software will be updated to match the most recent version in the group
** All users must be on system menu version 4.0.0 or later to view and join a group

'''General system stability improvements to enhance the user's experience, including'''

* Changed the specification which hid wireless networks using TKIP security from the network search results. Wireless networks using TKIP security will now display in search results as a grayed-out selection instead of not being displayed
** The Nintendo Switch console supports WEP, WPA-PSK(AES), and WPA2-PSK(AES). If your router is using a different security type (e.g. WPA-PSK(TKIP)), you will need to change this security type <span style="color:#FF0000">'''within your router's settings'''</span>.

==System Titles==
<fill this in (manually) later>

* Every single system title was updated, except for: 0100000000000805("Chinese and Korean dictionaries"), 0100000000000808("European, English and Japanese dictionaries"), and 010000000000080C("EULA").
* 4 new sysmodules were added, and new FIRM-package title 010000000000081C was added.

===FIRM===
Everything under RomFS was updated.

The package1 entrypoint address specified by BCT was increased by 0x20-bytes, since there's now an additional 0x20-bytes at the start of package1. The additional data is identical to the 0x20-byte block before it.

====Package1====
setKeyslotFlags (LT_4001011a)
Instead of writing ~flags directly to securityEngine->KEYSLOT_FLAGS[keyslot], this now preserves the high bits of the existing flags.

getOdmFuse4Type (LT_40010614)
This func now includes bits 16-19 in the OR'd flag used in the switch, and now returns 4 as a default invalid result instead of the low bit of [[Fuses|FUSE_SPARE_BIT_5]].

checkFuseCoherency (LT_400106e4)
This func was updated to take into account the new invalid retval for getOdmFuse4Type.
Checks that were only enforced on retail prior to this update (bootROM patch must be < 0x7F and EKS must be provisionned) are now enforced for dev too.
The now redundant bootROM patch version < 0x1F check was removed.

decryptAndParsePK11 (LT_40010734)
The entrypoint calculation code no longer adds *(package11Header + 0x4) to the address.

generateKeys (LT_400107a2)
setKeyslotFlags(keyslot, 0x15) is now additionally called on keyslots 14 and 15.
The code for switching key generation method depending on fuses (unit type) and last byte of PKC modulus has been removed, and replaced with a call to a single key generation function.
The code block inbetween the keyslot-config code was replaced with just a call to LT_40011264(same function mentioned above).
setKeyslotFlags(keyslot, 0xFF) is now used on keyslots 12 and 15 instead of 12 and 13.

downgradeFuseCheck (LT_400111cc)
The burnt fuse information stored in .rodata now expects 5 fuses to be burnt for retail units, instead of 4.

generateKeysFromBITAddress (LT_40011264)
Instead of calling generateKeysLegacyMethod, this now calls generateKeysFromKeyblobAndKeyseeds (the main key generation function). Legacy key generation code has been removed.

generateKeysFromKeyblobAndKeyseeds (LT_400112f0)
The function now takes in two keyseeds and sizes, previously it only took in one (keyseed, size) pair.
Keyslot 15 (initially SSK) is now used where keyslot 10 was used previously, and keyslot 15 is no longer cleared when keyslot 14 (initially SBK) is cleared.
The [[Flash_Filesystem|Keyblob]] keyseed was updated for keyblob 4.
code block following the keyblob clear code was updated:
After the decrypted keyblob is cleared, decryptDataIntoKeyslot(KEYSLOT_14, KEYSLOT_12, secondKeySeed, secondKeySeedSize) is now called before decryptDataIntoKeyslot(KEYSLOT_12, KEYSLOT_12, firstKeySeed, firstKeySeedSize).
At the end of the function, "decryptDataIntoKeyslot(KEYSLOT_13, KEYSLOT_10, perConsoleKeyseed2, 0x10); clearKeyslot(KEYSLOT_10);" has been replaced with "decryptDataIntoKeyslot(KEYSLOT_13, KEYSLOT_15, perConsoleKeyseed3, 0x10); decryptDataIntoKeyslot(KEYSLOT_15, KEYSLOT_15, perConsoleKeyseed2, 0x10);"

==Keys==
All of these updated titles now use the new [[NCA_Format|NCA]] crypto for [[NCA|non-ncatype0]](all content except .cnmt content), except for all of the FIRM-packages including the new one(required for FIRM installation).

[[Flash_Filesystem|Keyblob]] 4 is now used, instead of 3.

==OSS==
The updated [https://www.nintendo.co.jp/support/oss/index.html OSS] includes WebKit changes.

==See Also==
System update report(s):
* [https://yls8.mtheall.com/ninupdates/reports.php?date=10-18-17_08-05-13&sys=hac]

{{NavboxVersions}}

USB services

2017-10-12T22:08:56Z

Smartperson: attempt to improve clarity on what 'former' refers to

One symbol in USB-sysmodule is: "vtable for nn::usb::detail::UsbComplexTegra21x".

= usb:ds =
Used for Switch<>PC USB comms, aka Switch-as-device.
This service is used during [[Factory Setup|factory setup]] by [[Manu Services|manu]].

This service session is used as an IPC [[IPC_Marshalling|domain]] by [[Manu Services|manu]]. All of these {get-session} commands also return an output u8 and the u32 <[[IPC_Marshalling|domainID]]>, for using those sessions as domains.

{| class="wikitable" border="1"
|-
! Cmd || Name || Notes
|-
| 0 || [[#BindDevice]] ||
|-
| 1 || [[#BindClientProcess]] ||
|-
| 2 || [[#GetDsInterface]] ||
|-
| 3 || [[#GetStateChangeEvent]] ||
|-
| 4 || [[#GetState]] ||
|-
| 5 || [[#SetVidPidBcd]] ||
|}

Initialization done by [[Manu Services|manu]]:
* Initial service init:
** Get service/etc.
** Uses [[#BindDevice]].
** Uses [[#BindClientProcess]].
** Uses [[#GetStateChangeEvent]].
** Uses [[#SetVidPidBcd]].
* Interface init:
** Uses [[#GetDsInterface]], then uses commands from that with the rest of the following.
** Uses [[#GetSetupEvent]].
** Uses [[#GetCtrlInCompletionEvent]].
** Uses [[#GetCtrlOutCompletionEvent]].
* Initializes two endpoints via using [[#GetDsEndpoint]] twice.

== Configuration ==
The following is the default USB config strings, while the usbds service isn't being used. All of the below configuration will reset to the defaults when all usbds-related sessions are closed. These can be set with [[#SetVidPidBcd]]. The default string for Product is loaded from [[Settings_services|settings]] config. The default is referred to by usb-sysmodule as "Dummy".
Product: Nintendo Switch
Manufacturer: Nintendo
SerialNumber: SerialNumber

The following is the default <code>lsusb -v {...}</code> output when the usbds service wasn't used.

The endpoints are configured using [[#GetDsEndpoint]], the total number of endpoints is the number of open [[#IDsEndpoint]] sessions. bInterfaceNumber is {0-based index for the enabled [[#IDsInterface]] session.} Some of the interface fields are configured using [[#GetDsInterface]].

Additional descriptors for use with interfaces and endpoints can't be configured with usbds, even though the former is used for the default HID interface. This seems to be the main(?) restriction with using usbds for Switch-as-arbitrary-devices. The device class fields can't be configured, interface class fields are set instead.

Bus 003 Device 006: ID 057e:2000 Nintendo Co., Ltd
Couldn't open device, some information will be missing
Device Descriptor:
bLength 18
bDescriptorType 1
bcdUSB 2.00
bDeviceClass 0 (Defined at Interface level)
bDeviceSubClass 0
bDeviceProtocol 0
bMaxPacketSize0 64
idVendor 0x057e Nintendo Co., Ltd
idProduct 0x2000
bcdDevice 1.00
iManufacturer 1
iProduct 2
iSerial 3
bNumConfigurations 1
Configuration Descriptor:
bLength 9
bDescriptorType 2
wTotalLength 34
bNumInterfaces 1
bConfigurationValue 1
iConfiguration 0
bmAttributes 0xc0
Self Powered
MaxPower {...}
Interface Descriptor:
bLength 9
bDescriptorType 4
bInterfaceNumber 0
bAlternateSetting 0
bNumEndpoints 1
bInterfaceClass 3 Human Interface Device
bInterfaceSubClass 0 No Subclass
bInterfaceProtocol 0 None
iInterface 0
HID Device Descriptor:
bLength 9
bDescriptorType 33
bcdHID 2.00
bCountryCode 0 Not supported
bNumDescriptors 1
bDescriptorType 34 Report
wDescriptorLength 26
Report Descriptors:
** UNAVAILABLE **
Endpoint Descriptor:
bLength 7
bDescriptorType 5
bEndpointAddress 0x81 EP 1 IN
bmAttributes 3
Transfer Type Interrupt
Synch Type None
Usage Type Data
wMaxPacketSize 0x0001 1x 1 bytes
bInterval 16

== BindDevice ==
Takes an u32 ('''complexId'''). [[Manu_Services|Manu]] sends 0x02.

Binding more than once with the current session is not allowed. Once this command is used, the USB device will not be listed with <code>lsusb</code> until [[#EnableInterface]] is used.

Returns a not-found error when complexId isn't 0x02, for values 0x0-0x4 (while in handheld-mode at least).

== BindClientProcess ==
Takes 1 copy-handle for the current process (0xFFFF8001).

== GetDsInterface ==
Takes 2 type-5 buffers and returns an [[#IDsInterface]]. [[Manu_Services|Manu]] sends a 0x09-byte command (e.g.: 0x09, 0x04, 0x04, 0x00, 0x00, 0xFF, 0xFF, 0xFF, 0x00) in the first buffer and a string ("usb") in the second buffer.

When the strlen output for the second buffer is >=0x40, size 0x40 is used instead for copying the string. This is the interface name, it's not sent over USB.

Returns an error when [[#BindDevice]] wasn't used.

Up to 4 interfaces can be used+[[#EnableInterface|enabled]].

Structure of the first buffer(this is the same as [http://libusb.sourceforge.net/api-1.0/structlibusb__interface__descriptor.html libusb__interface__descriptor]):
{| class="wikitable" border="1"
|-
! Offset || Size || Description
|-
| 0x0 || 0x1 || bLength. Must match 0x9.
|-
| 0x1 || 0x1 || bDescriptorType. Must match 0x4.
|-
| 0x2 || 0x1 || bInterfaceNumber. When 0x4, the bInterfaceNumber is automatically allocated(error will be thrown if no space). Otherwise, it's used directly and must be <=3.
|-
| 0x3 || 0x1 || bAlternateSetting. Must match 0x0.
|-
| 0x4 || 0x1 || bNumEndpoints. Ignored.
|-
| 0x5 || 0x1 || bInterfaceClass
|-
| 0x6 || 0x1 || bInterfaceSubClass
|-
| 0x7 || 0x1 || bInterfaceProtocol
|-
| 0x8 || 0x1 || iInterface. Ignored.
|}

Only the first 0x9-bytes are used.

== GetStateChangeEvent ==
Returns an event handle for when the state returned by [[#GetState]] changes. Signalled when Switch<->host USB comms change between started/stopped. USB cable connected/disconnected while at least 1 interface was enabled, or interface enabled/disabled while the USB cable was connected which then caused USB-comms state to change.

== GetState ==
No input. Returns an output u32. Returns an error when [[#BindDevice]] wasn't used.

Returns the current state. Values:
* 0: Initial state.
* 6: Device init starting.
* 3: {Initialization}, previous state is 6.
* 4: {Initialization}, previous state is 3.
* 5: Initialization done, data-transfer is now available.

== SetVidPidBcd ==
Takes a type-5 buffer with 0x66 bytes of USB descriptor data (see [[Manu_Services#manu|manu]]).

{| class="wikitable" border="1"
|-
! Offset || Size || Description
|-
| 0x0 || 0x2 || VID (idVendor)
|-
| 0x2 || 0x2 || PID (idProduct)
|-
| 0x4 || 0x2 || bcdDevice
|-
| 0x6 || 0x20 || Manufacturer
|-
| 0x26 || 0x20 || Product
|-
| 0x46 || 0x20 || SerialNumber
|}

The last 3 blocks are ASCII strings. The data following each string is all-zero, for padding to size 0x20.

== IDsInterface ==
{| class="wikitable" border="1"
|-
! Cmd || Name || Notes
|-
| 0 || [[#GetDsEndpoint]] ||
|-
| 1 || [[#GetSetupEvent]] ||
|-
| 2 || || Takes a type-0x6 output buffer, no other output. Memcpys data to outbuf with outsize, uses size 0x8 if outsize is too large.
|-
| 3 || [[#EnableInterface]] ||
|-
| 4 || [[#DisableInterface]] ||
|-
| 5 || [[#CtrlInPostBufferAsync]] ||
|-
| 6 || [[#CtrlOutPostBufferAsync]] ||
|-
| 7 || [[#GetCtrlInCompletionEvent]] ||
|-
| 8 || [[#GetCtrlInReportData]] ||
|-
| 9 || [[#GetCtrlOutCompletionEvent]] ||
|-
| 10 || [[#GetCtrlOutReportData]] ||
|-
| 11 || [[#StallCtrl]] ||
|}

Commands cmd2, [[#CtrlInPostBufferAsync]], [[#CtrlOutPostBufferAsync]], and [[#StallCtrl]], will throw an error if the interface is not [[#EnableInterface|enabled]]. [[#GetDsEndpoint]] will throw an error if the interface is [[#EnableInterface|enabled]].

=== GetDsEndpoint ===
Takes a type-5 buffer and returns an [[#IDsEndpoint]]. [[Manu_Services|Manu]] uses this twice for getting two endpoint sessions, with the following 0x7-byte buffer data:
* First endpoint: 0x07, 0x05, 0x80, 0x02, 0x00, 0x02, 0x00
** bLength=0x7
** bDescriptorType=LIBUSB_DT_ENDPOINT
** bEndpointAddress=LIBUSB_ENDPOINT_IN
** bmAttributes=LIBUSB_TRANSFER_TYPE_BULK
** wMaxPacketSize=0x200
** bInterval=0
* Second endpoint: Same as above except byte2 is 0x00(bEndpointAddress=LIBUSB_ENDPOINT_OUT).

Each field is an u8, except for offset 0x4-0x5 which is an u16.

This structure matches [http://libusb.sourceforge.net/api-1.0/structlibusb__endpoint__descriptor.html libusb_endpoint_descriptor], with audio-only-devices fields bRefresh and bSynchAddress removed.

The buffer size must be >=0x7. Only the first 0x7-bytes from the buffer are used.
* Byte0(bLength) must match 0x7.
* Byte1(bDescriptorType) must match 0x5.
* Byte2(bEndpointAddress) is only compared with 0x80 to determine whether to use an input or output endpoint, the actual endpoint-number is allocated automatically by checking state. Hence, all input endpoints must use bEndpointAddress==0x80. Up to endpoint-number 0xF can be allocated for each endpoint-direction, for a total of 16 endpoints including control, and 15 for non-control endpoints([[#IDsEndpoint]] sessions for each direction). This matches the Tegra maximum.

From the Tegra datasheet: "The maximum packet size supported on any endpoint is 1024 bytes in high-speed mode, for both device and host modes."

=== GetSetupEvent ===
Returns an event handle. Unknown what triggers signalling, not signalled during interface-enable / device<>host USB-comms init.

=== EnableInterface ===
Takes no arguments. Enables the current interface.

Only one interface can be enabled at a time per bInterfaceNumber. When bInterfaceNumber is auto-allocate(0x4) for [[#GetDsEndpoint]] this isn't an issue since the final bInterfaceNumber will be unique.

Once enabled, the device/interface can then actually be used over USB.

=== DisableInterface ===
Takes no arguments. Disables the current interface.

=== CtrlInPostBufferAsync ===
Same as [[#PostBufferAsync]](with same input/output), except this uses control input endpoint 0x80.

=== CtrlOutPostBufferAsync ===
Same as [[#PostBufferAsync]](with same input/output), except this uses control output endpoint 0x00.

=== GetCtrlInCompletionEvent ===
Returns an event handle for polling the completion of input control commands. Same as [[#GetCompletionEvent]], except this uses control input endpoint 0x80.

=== GetCtrlInReportData ===
Same as [[#GetReportData]](with same input/output), except this uses control input endpoint 0x80.

=== GetCtrlOutCompletionEvent ===
Returns an event handle for polling the completion of output control commands. Same as [[#GetCompletionEvent]], except this uses control output endpoint 0x00.

=== GetCtrlOutReportData ===
Same as [[#GetReportData]](with same input/output), except this uses control output endpoint 0x00.

=== StallCtrl ===
No input/output.

Calls a function with both control endpoints(0x80 and 0x00) with the same function. From strings: "m_pProtocol->Stall(0x80)" "m_pProtocol->Stall(0x00)".

=== IDsEndpoint ===
{| class="wikitable" border="1"
|-
! Cmd || Name || Notes
|-
| 0 || [[#PostBufferAsync]] ||
|-
| 1 || || No input/output.
|-
| 2 || [[#GetCompletionEvent]] ||
|-
| 3 || [[#GetReportData]] ||
|-
| 4 || [[#Stall]] ||
|-
| 5 || || Takes an input u8, no output.
|}

==== PostBufferAsync ====
Takes an u32 ('''size''') and an u64 ('''buffer'''). Returns an output u32 ('''urbId'''). The output urbId can then be used while parsing the output of [[#GetReportData]], after waiting for the CompletionEvent to be signalled.

The buffer address must be 0x1000-byte aligned. The input size doesn't matter.

Used for data-transfer with input/output endpoints.

The user-process must flush dcache for the buffer before using this command.

When sending data where size is larger than wMaxPacketSize, it will automatically send multiple USB packets where last packet size = {remaining size}. Every {wMaxPacketSize}-bytes is a different packet.

For receiving data, if size is less than {actual received USB packet size} the rest of the packet will be discarded. Later PostBufferAsync cmd(s) will only return data from new packets, not the remainder of the earlier packet(s).

==== GetCompletionEvent ====
No input. Returns an output event handle for polling the completion of [[#PostBufferAsync]], even when it finished via [[#Stall]].

==== GetReportData ====
No input. Returns 0x84 bytes of report data from the endpoint. Seems to be eventually loaded from state, since this doesn't trigger any USB bus activity. All-zero before PostBufferAsync was used at least once.

{| class="wikitable" border="1"
|-
! Offset || Size || Description
|-
| 0x0 || 0x10*0x8(0x80) || 0x8 entries 0x10-bytes each for each report.
|-
| 0x80 || 0x4 || u32 report count
|}

Entry data:
{| class="wikitable" border="1"
|-
! Offset || Size || Description
|-
| 0x0 || 0x4 || u32 id (urbId from post-buffer commands)
|-
| 0x4 || 0x4 || u32 requestedSize
|-
| 0x8 || 0x4 || u32 transferredSize
|-
| 0xC || 0x4 || u32 urb status, converted to error-codes. 0x3 = success, 0x4 = 0x828c, 0x5 = 0x748c. All other values are invalid.
|-
|}

==== Stall ====
No input/output.

Calls the same function used by [[#StallCtrl]], except this uses the endpoint associated with the current session.

Stops in-progress data-transfer done by [[#PostBufferAsync]].

= usb:hs =
General USB devices usage, used by hid-sysmodule and bsdsockets-sysmodule.

= usb:pd =
Only system-titles with access to this are [[PTM_services|PTM]] and [[AM_services|AM]].

= usb:pd:c =
USB-sysmodule symbols for this refer to "Cradle", which is the [[Dock]].

= usb:pm =
Presumably Power Management, only system-title using this is [[PTM_services|PTM]].

NCM services

2017-07-16T15:13:48Z

Smartperson: /* lr */ cross-reference link to StorageID

LR (Location Resolver) contains services for internal file path and content management.

= LR services =
== lr ==
{| class="wikitable" border="1"
|-
! Cmd || Name || Notes
|-
| 0 || GetPathResolverForStorage || Takes a [[Filesystem_services#StorageId|StorageID]]
|-
| 1 || GetPatchPathResolver? ||
|-
| 2 || CheckStorage || Takes a [[Filesystem_services#StorageId|StorageID]]
|-
| 3 || ||
|}

=== IPathResolver ===
{| class="wikitable" border="1"
|-
! Cmd || Name || Notes
|-
| 0 || GetProgramNcaPath ||
|-
| 1 || SetProgramNcaPath ||
|-
| 2 || ||
|-
| 3 || ||
|-
| 4 || GetControlNcaPath ||
|-
| 5 || SetControlNcaPath ||
|-
| 6 || ||
|-
| 7 || ||
|-
| 8 || ||
|-
| 9 || ||
|}

= Content Manager services =
== ncm ==
{| class="wikitable" border="1"
|-
! Cmd || Name || Notes
|-
| 0 || ||
|-
| 1 || ||
|-
| 2 || ||
|-
| 3 || ||
|-
| 4 || GetIContentStorage ||
|-
| 5 || GetIContentMetaDatabase ||
|-
| 8 || ||
|-
| 9 || InitializeStorageForMediaId ||
|-
| 10 || UninitializeStorageForMediaId ||
|-
| 11 || InitializeDatabaseForMediaId ||
|-
| 12 || UninitializeDatabaseForMediaId ||
|}

All of the above cmds takes a u8 as input.

=== IContentStorage ===
{| class="wikitable" border="1"
|-
! Cmd || Name || Notes
|-
| 0 || [[#GetRootEntry]] ||
|-
| 1 || || Takes two 0x10-sized entries, and a u64.
|-
| 2 || || Takes a 0x10-sized entry.
|-
| 3 || || Takes a 0x10-sized entry, returns a bool/u8.
|-
| 4 || || Takes a 0x10-sized entry, a u64-offset, and type-5 array.
|-
| 5 || || Takes two 0x10-sized entries.
|-
| 6 || DeleteContent? || Takes a 0x10-sized entry.
|-
| 7 || IsNcaEntryValid || Takes a 0x10-sized entry, returns a bool/u8.
|-
| 8 || MakeNcaRegisteredPath || Takes a type-0x1A string and a 0x10-sized entry.
|-
| 9 || MakeNcaPlaceholderPath || Takes a type-0x1A string and a 0x10-sized entry.
|-
| 10 || || Void.
|-
| 11 || || Takes a type-6 buffer, each entry 0x10 bytes, and returns a u32.
|-
| 12 || [[#GetNumberOfEntries]] ||
|-
| 13 || [[#GetEntries]] ||
|-
| 14 || [[#GetEntrySize]] ||
|-
| 15 || || Void.
|-
| 16 || || Takes three 0x10-sized entries.
|-
| 17 || || Takes a 0x10-sized entry and a u64.
|-
| 18 || [[#ReadEntryRaw]] ||
|-
| 19 || || Takes a 0x10-sized entry and returns another 0x10-sized entry.
|-
| 20 || [[#GetNcaTitleInfo]] ||
|-
| 21 || || Takes a 0x10-sized entry, a u64, and a type5 buffer.
|-
| 22 || GetFreeSpace ||
|-
| 23 || GetTotalSpace ||
|}

==== GetRootEntry ====
Returns an entry of 16 completely random-looking bytes. It is not possible to read this entry.

Changes on reboot?

==== GetNumberOfEntries ====
Writes the total number of entries which can be read by GetEntries, to cmdreply <SFCO_offset>+0x10.

==== GetEntries ====
Takes an output buffer, u32 offset and gets all entries starting at that offset.
Returns number of entries read.

Each entry is a [[#NcaID]].

The total read entries is exactly the same as the number of "<hex>.nca" directories in the storage FS(or at least under the "registered" directory?).

==== GetEntrySize ====
Takes a [[#NcaID]] as input.

Returns the total size readable by ReadEntryRaw. This is the same as the size-field in the [[NAX0]] "<NcaID>.nca/00" file.

==== ReadEntryRaw ====
Takes an output buffer, a [[#NcaID]] as input, and a u64 file offset.

Returns encrypted looking data from the content in the [[NAX0]]. Doesn't match the encrypted raw data in the [[NAX0]] "<NcaID>.nca/00" file. Seems to be at least one crypto layer below the initial NAX0 layer, since the data doesn't change after NAX0 recreation.

Manually modifying the content in the NAX0(starting at offset 0x4000) results in different output data being returned by this cmd. Changing any data within the first 0x10-bytes results in the entire 0x10-byte block changing. Likewise for offset 0x4010 size 0x1, entire 0x10-byte block at 0x4010 changes. Changing the first 0x20-bytes at 0x4000 to zeros has the same combined changed output, as when offset 0x4000 size 0x10 and offset 0x4010 size 0x10 were changed to zeros separately. Output BlockA and BlockB are completely different, where the raw NAX0 data for those blocks are all-zero.

Overwriting the entire raw NAX0 content with zeros results in output data which doesn't seem to have any duplicate blocks/data. When changing the previously mentioned raw content for the first 8 blocks to last-block-byte = 1<<i, where i is 0-7, none of the changed output blocks match any output blocks from the previously mentioned output(all-zero raw content).

This implies that that an AES mode is being used which isn't CTR, where changing data in one block doesn't affect other blocks.

See GetEntrySize for the total size readable with this.

==== GetNcaTitleInfo ====
Takes a [[#NcaID]] and returns the following 0x10-sized entry.

With some NcaIDs this may return 0 with an all-zero output entry. This seems to be the case for most/all (?) NandSystem NcaIds? This seems to be only usable with NcaIds which have [[NCA|type]] 1 or 4.

{| class="wikitable" border="1"
|-
! Offset
! Size
! Description
|-
| 0x0
| 0x8
| Big-endian titleID
|-
| 0x8
| 0x8
| Unknown. Usually zero?
|}

=== IContentMetaDatabase ===
{| class="wikitable" border="1"
|-
! Cmd || Name || Notes
|-
| 0 || InsertContentEntry? || Takes a 0x10-sized entry, a type-5 buffer and a u64.
|-
| 1 || || Takes a 0x10-sized entry, a type-6 buffer and a u64. Returns a u64.
|-
| 2 || || Takes a 0x10-sized entry.
|-
| 3 || || Takes a 0x10-sized entry and a bool/u8. Returns an 0x10-sized entry.
|-
| 4 || || Takes a type-6 buffer, each entry being 24 bytes, 0x10-sized entry and a u32. Returns a u32.
|-
| 5 || Iterate || Takes a type-6 buffer, each entry being 16 bytes, a 0x10-sized entry, and a u32. Returns a u32.
|-
| 6 || [[#GetTitleIdInfo]] ||
|-
| 7 || [[#GetTitleList]] || Takes a type-6 buffer, each entry being 24 bytes, and a u8/bool. Returns two u32's.
|-
| 8 || || Takes a 0x10-sized entry. Returns a bool/u8.
|-
| 9 || || Takes a type-5 buffer, each entry being 16 bytes. Returns a bool/u8.
|-
| 10 || || Takes a 0x10-sized entry. Returns a u64.
|-
| 11 || || Takes a 0x10-sized entry. Returns a u32.
|-
| 12 || || Takes a 0x10-sized entry. Returns a u64.
|-
| 13 || || Void.
|-
| 14 || || Takes a type-6 byte buffer, and a type-5 buffer with each entry being 16 bytes.
|-
| 15 || EndIteration || Void.
|-
| 16 || || Takes two 0x10-sized entries. Returns a bool/u8.
|-
| 17 || [[#GetUpdateTitleList]] ||
|-
| 18 || || Takes a 0x10-sized entry. Returns a bool/u8.
|-
| 19 || || Takes a 0x10-sized entry. Returns a u32.
|}

==== GetTitleIdInfo ====
Takes a u64 title-id as input, returns same title-id together with info struct.

struct title_info {
u32 version;
u8 type;
u8 pad[3];
};

==== GetTitleList ====
Each 24-byte entries is as follows:

u64 title_id_update;
struct title_info info;
u64 title_id;

==== GetUpdateTitleList ====
Takes a type-6 output buffer, each entry being 0x10-byte bytes, a u32 entryoffset and a 0x10-sized entry. Returns a u32 for total_read_entries.

The input entry is the output entry from [[#GetTitleIdInfo]] starting at the TID. The output 0x10-bytes entries are the same as the output from [[#GetTitleIdInfo]] starting at the TID. However, "pad[0]" is used for something else it seems?(0 for everything except for TID [[Title_list|010000000000081B]], where it's 1)

See [[NCA#Meta_records]].

This reads the titlelist stored in the specified title, normally a title with title-type 3, which is sysupdate-title 0100000000000816. Returns 0 with total_read_entries=0 when used with other title(s).

=== NcaID ===
This is a 0x10-byte entry. This is originally from the hex portion of "<hex>.nca" directory-names from this storage FS(like [[SD_Filesystem|SD]]).

The NcaID is the same as the first 0x10-bytes from the calculated SHA256 hash, from hashing the entire output from ReadEntryRaw.

=== Enums ===
==== Title Types ====

{| class="wikitable" border="1"
|-
! Value
! Description
|-
| 0x01
| System Programs ([[Title_list#System_Modules|System Modules]] or [[Title_list#System_Applets|System Applets]])
|-
| 0x02
| [[Title_list#System_Data_Archives|System Data Archives]]
|-
| 0x03
| System Update
|-
| 0x04
| [[Title_list|Firmware package A]]
|-
| 0x05
| [[Title_list|Firmware package B]]
|-
| 0x80
| Regular application
|-
| 0x81
| Update title
|-
| 0x82
| Add-on content
|}

== ncm:v ==

[[Category:Services]]

File:HAC-EMMC-Connector-Plug.jpg

2017-03-20T02:11:34Z

Smartperson: Smartperson uploaded a new version of File:HAC-EMMC-Connector-Plug.jpg

Labels of which pins map to which functions. Tested with my multimeter based on the images for Front/Back here on this wiki.

EMMC pinout

2017-03-20T01:36:45Z

Smartperson: Added information for the eMMC's connector pinout, including image.

=== Front ===
[[File:HAC-EMMC-Side-B.png|600px]]

=== Back ===
[[File:HAC-EMMC-Side-A.png|600px]]

Supply power via the VCC 3.3V and 1.8V pins, and solder the CLK, CMD, and DAT0 pins to an SD Card reader in order to extract the data off the eMMC chip.

=== eMMC Connector ===
[[File:HAC-EMMC-Connector-Plug.jpg|600px]]

The eMMC connector plug on the board mates with the receptacle on the Switch motherboard. The receptacle is a [http://www.molex.com/molex/products/datasheet.jsp?part=active/5009130302_PCB_RECEPTACLES.xml&channel=Products&Lang=en-US Molex 5009130302], and is available from retailers such as [https://www.digikey.com/product-detail/en/molex-llc/5009130302/WM6833CT-ND/3045233 Digi-Key].

File:Switch eMMC Connector Pinout.jpg

2017-03-20T01:31:52Z

Smartperson: Smartperson moved page File:Switch eMMC Connector Pinout.jpg to File:HAC-EMMC-Connector-Plug.jpg: Renaming to match other image files on Hardware page.

#REDIRECT [[File:HAC-EMMC-Connector-Plug.jpg]]

File:HAC-EMMC-Connector-Plug.jpg

2017-03-20T01:31:52Z

Smartperson: Smartperson moved page File:Switch eMMC Connector Pinout.jpg to File:HAC-EMMC-Connector-Plug.jpg: Renaming to match other image files on Hardware page.

Labels of which pins map to which functions. Tested with my multimeter based on the images for Front/Back here on this wiki.

File:HAC-EMMC-Connector-Plug.jpg

2017-03-20T01:30:16Z

Smartperson: Labels of which pins map to which functions. Tested with my multimeter based on the images for Front/Back here on this wiki.

Labels of which pins map to which functions. Tested with my multimeter based on the images for Front/Back here on this wiki.

Joy-Con

2017-03-12T23:40:43Z

Smartperson: Unifying joy-con info since when both are paired they report identical info.

== Specifications ==
{| class="wikitable"
! Type !!
|-
| Technology || Bluetooth
|-
| Interface || HID
|-

|}

== Left & Right Separate Joy-con ==

When paired directly to a computer over bluetooth, the joy-con both provide identical HID input report descriptor. This does not appear to include motion controls, IR data, or NFC. They both behave as detached single-player controllers.

HID Input Report Descriptor (Hexadecimal):
05010905A1010601FF85210921750895308102853009307508953081028531093175089669018102853209327508966901810285330933750896690
18102853F05091901291015002501750195108102050109391500250775049501814205097504950181010501093009310933093416000027FFFF00
007510950481020601FF85010901750895309102851009107508953091028511091175089530910285120912750895309102C0

{| class="mw-collapsible mw-collapsed wikitable"
! Parsed Bytes || Description
|-
|0x05, 0x01, || Usage Page (Generic Desktop Ctrls)
|-
|0x09, 0x05, || Usage (Game Pad)
|-
|0xA1, 0x01, || Collection (Application)
|-
|0x06, 0x01, 0xFF, || Usage Page (Vendor Defined 0xFF01)
|-
|0x85, 0x21, || Report ID (33)
|-
|0x09, 0x21, || Usage (0x21)
|-
|0x75, 0x08, || Report Size (8)
|-
|0x95, 0x30, || Report Count (48)
|-
|0x81, 0x02, || Input (Data,Var,Abs,No Wrap,Linear,Preferred State,No Null Position)
|-
|0x85, 0x30, || Report ID (48)
|-
|0x09, 0x30, || Usage (0x30)
|-
|0x75, 0x08, || Report Size (8)
|-
|0x95, 0x30, || Report Count (48)
|-
|0x81, 0x02, || Input (Data,Var,Abs,No Wrap,Linear,Preferred State,No Null Position)
|-
|0x85, 0x31, || Report ID (49)
|-
|0x09, 0x31, || Usage (0x31)
|-
|0x75, 0x08, || Report Size (8)
|-
|0x96, 0x69, 0x01, || Report Count (361)
|-
|0x81, 0x02, || Input (Data,Var,Abs,No Wrap,Linear,Preferred State,No Null Position)
|-
|0x85, 0x32, || Report ID (50)
|-
|0x09, 0x32, || Usage (0x32)
|-
|0x75, 0x08, || Report Size (8)
|-
|0x96, 0x69, 0x01, || Report Count (361)
|-
|0x81, 0x02, || Input (Data,Var,Abs,No Wrap,Linear,Preferred State,No Null Position)
|-
|0x85, 0x33, || Report ID (51)
|-
|0x09, 0x33, || Usage (0x33)
|-
|0x75, 0x08, || Report Size (8)
|-
|0x96, 0x69, 0x01, || Report Count (361)
|-
|0x81, 0x02, || Input (Data,Var,Abs,No Wrap,Linear,Preferred State,No Null Position)
|-
|0x85, 0x3F, || Report ID (63)
|-
|0x05, 0x09, || Usage Page (Button)
|-
|0x19, 0x01, || Usage Minimum (0x01)
|-
|0x29, 0x10, || Usage Maximum (0x10)
|-
|0x15, 0x00, || Logical Minimum (0)
|-
|0x25, 0x01, || Logical Maximum (1)
|-
|0x75, 0x01, || Report Size (1)
|-
|0x95, 0x10, || Report Count (16)
|-
|0x81, 0x02, || Input (Data,Var,Abs,No Wrap,Linear,Preferred State,No Null Position)
|-
|0x05, 0x01, || Usage Page (Generic Desktop Ctrls)
|-
|0x09, 0x39, || Usage (Hat switch)
|-
|0x15, 0x00, || Logical Minimum (0)
|-
|0x25, 0x07, || Logical Maximum (7)
|-
|0x75, 0x04, || Report Size (4)
|-
|0x95, 0x01, || Report Count (1)
|-
|0x81, 0x42, || Input (Data,Var,Abs,No Wrap,Linear,Preferred State,Null State)
|-
|0x05, 0x09, || Usage Page (Button)
|-
|0x75, 0x04, || Report Size (4)
|-
|0x95, 0x01, || Report Count (1)
|-
|0x81, 0x01, || Input (Const,Array,Abs,No Wrap,Linear,Preferred State,No Null Position)
|-
|0x05, 0x01, || Usage Page (Generic Desktop Ctrls)
|-
|0x09, 0x30, || Usage (X)
|-
|0x09, 0x31, || Usage (Y)
|-
|0x09, 0x33, || Usage (Rx)
|-
|0x09, 0x34, || Usage (Ry)
|-
|0x16, 0x00, 0x00, || Logical Minimum (0)
|-
|0x27, 0xFF, 0xFF, 0x00, 0x00, || Logical Maximum (65534)
|-
|0x75, 0x10, || Report Size (16)
|-
|0x95, 0x04, || Report Count (4)
|-
|0x81, 0x02, || Input (Data,Var,Abs,No Wrap,Linear,Preferred State,No Null Position)
|-
|0x06, 0x01, 0xFF, || Usage Page (Vendor Defined 0xFF01)
|-
|0x85, 0x01, || Report ID (1)
|-
|0x09, 0x01, || Usage (0x01)
|-
|0x75, 0x08, || Report Size (8)
|-
|0x95, 0x30, || Report Count (48)
|-
|0x91, 0x02, || Output (Data,Var,Abs,No Wrap,Linear,Preferred State,No Null Position,Non-volatile)
|-
|0x85, 0x10, || Report ID (16)
|-
|0x09, 0x10, || Usage (0x10)
|-
|0x75, 0x08, || Report Size (8)
|-
|0x95, 0x30, || Report Count (48)
|-
|0x91, 0x02, || Output (Data,Var,Abs,No Wrap,Linear,Preferred State,No Null Position,Non-volatile)
|-
|0x85, 0x11, || Report ID (17)
|-
|0x09, 0x11, || Usage (0x11)
|-
|0x75, 0x08, || Report Size (8)
|-
|0x95, 0x30, || Report Count (48)
|-
|0x91, 0x02, || Output (Data,Var,Abs,No Wrap,Linear,Preferred State,No Null Position,Non-volatile)
|-
|0x85, 0x12, || Report ID (18)
|-
|0x09, 0x12, || Usage (0x12)
|-
|0x75, 0x08, || Report Size (8)
|-
|0x95, 0x30, || Report Count (48)
|-
|0x91, 0x02, || Output (Data,Var,Abs,No Wrap,Linear,Preferred State,No Null Position,Non-volatile)
|-
|0xC0, || End Collection
|}

Joy-Con

2017-03-12T23:36:16Z

Smartperson: Added basic HID info for right joy-con.

== Specifications ==
{| class="wikitable"
! Type !!
|-
| Technology || Bluetooth
|-
| Interface || HID
|-

|}

== Left Joy-con ==

HID Input Report Descriptor (Hexadecimal):
05010905A1010601FF85210921750895308102853009307508953081028531093175089669018102853209327508966901810285330933750896690
18102853F05091901291015002501750195108102050109391500250775049501814205097504950181010501093009310933093416000027FFFF00
007510950481020601FF85010901750895309102851009107508953091028511091175089530910285120912750895309102C0

{| class="mw-collapsible mw-collapsed wikitable"
! Parsed Bytes || Description
|-
|0x05, 0x01, || Usage Page (Generic Desktop Ctrls)
|-
|0x09, 0x05, || Usage (Game Pad)
|-
|0xA1, 0x01, || Collection (Application)
|-
|0x06, 0x01, 0xFF, || Usage Page (Vendor Defined 0xFF01)
|-
|0x85, 0x21, || Report ID (33)
|-
|0x09, 0x21, || Usage (0x21)
|-
|0x75, 0x08, || Report Size (8)
|-
|0x95, 0x30, || Report Count (48)
|-
|0x81, 0x02, || Input (Data,Var,Abs,No Wrap,Linear,Preferred State,No Null Position)
|-
|0x85, 0x30, || Report ID (48)
|-
|0x09, 0x30, || Usage (0x30)
|-
|0x75, 0x08, || Report Size (8)
|-
|0x95, 0x30, || Report Count (48)
|-
|0x81, 0x02, || Input (Data,Var,Abs,No Wrap,Linear,Preferred State,No Null Position)
|-
|0x85, 0x31, || Report ID (49)
|-
|0x09, 0x31, || Usage (0x31)
|-
|0x75, 0x08, || Report Size (8)
|-
|0x96, 0x69, 0x01, || Report Count (361)
|-
|0x81, 0x02, || Input (Data,Var,Abs,No Wrap,Linear,Preferred State,No Null Position)
|-
|0x85, 0x32, || Report ID (50)
|-
|0x09, 0x32, || Usage (0x32)
|-
|0x75, 0x08, || Report Size (8)
|-
|0x96, 0x69, 0x01, || Report Count (361)
|-
|0x81, 0x02, || Input (Data,Var,Abs,No Wrap,Linear,Preferred State,No Null Position)
|-
|0x85, 0x33, || Report ID (51)
|-
|0x09, 0x33, || Usage (0x33)
|-
|0x75, 0x08, || Report Size (8)
|-
|0x96, 0x69, 0x01, || Report Count (361)
|-
|0x81, 0x02, || Input (Data,Var,Abs,No Wrap,Linear,Preferred State,No Null Position)
|-
|0x85, 0x3F, || Report ID (63)
|-
|0x05, 0x09, || Usage Page (Button)
|-
|0x19, 0x01, || Usage Minimum (0x01)
|-
|0x29, 0x10, || Usage Maximum (0x10)
|-
|0x15, 0x00, || Logical Minimum (0)
|-
|0x25, 0x01, || Logical Maximum (1)
|-
|0x75, 0x01, || Report Size (1)
|-
|0x95, 0x10, || Report Count (16)
|-
|0x81, 0x02, || Input (Data,Var,Abs,No Wrap,Linear,Preferred State,No Null Position)
|-
|0x05, 0x01, || Usage Page (Generic Desktop Ctrls)
|-
|0x09, 0x39, || Usage (Hat switch)
|-
|0x15, 0x00, || Logical Minimum (0)
|-
|0x25, 0x07, || Logical Maximum (7)
|-
|0x75, 0x04, || Report Size (4)
|-
|0x95, 0x01, || Report Count (1)
|-
|0x81, 0x42, || Input (Data,Var,Abs,No Wrap,Linear,Preferred State,Null State)
|-
|0x05, 0x09, || Usage Page (Button)
|-
|0x75, 0x04, || Report Size (4)
|-
|0x95, 0x01, || Report Count (1)
|-
|0x81, 0x01, || Input (Const,Array,Abs,No Wrap,Linear,Preferred State,No Null Position)
|-
|0x05, 0x01, || Usage Page (Generic Desktop Ctrls)
|-
|0x09, 0x30, || Usage (X)
|-
|0x09, 0x31, || Usage (Y)
|-
|0x09, 0x33, || Usage (Rx)
|-
|0x09, 0x34, || Usage (Ry)
|-
|0x16, 0x00, 0x00, || Logical Minimum (0)
|-
|0x27, 0xFF, 0xFF, 0x00, 0x00, || Logical Maximum (65534)
|-
|0x75, 0x10, || Report Size (16)
|-
|0x95, 0x04, || Report Count (4)
|-
|0x81, 0x02, || Input (Data,Var,Abs,No Wrap,Linear,Preferred State,No Null Position)
|-
|0x06, 0x01, 0xFF, || Usage Page (Vendor Defined 0xFF01)
|-
|0x85, 0x01, || Report ID (1)
|-
|0x09, 0x01, || Usage (0x01)
|-
|0x75, 0x08, || Report Size (8)
|-
|0x95, 0x30, || Report Count (48)
|-
|0x91, 0x02, || Output (Data,Var,Abs,No Wrap,Linear,Preferred State,No Null Position,Non-volatile)
|-
|0x85, 0x10, || Report ID (16)
|-
|0x09, 0x10, || Usage (0x10)
|-
|0x75, 0x08, || Report Size (8)
|-
|0x95, 0x30, || Report Count (48)
|-
|0x91, 0x02, || Output (Data,Var,Abs,No Wrap,Linear,Preferred State,No Null Position,Non-volatile)
|-
|0x85, 0x11, || Report ID (17)
|-
|0x09, 0x11, || Usage (0x11)
|-
|0x75, 0x08, || Report Size (8)
|-
|0x95, 0x30, || Report Count (48)
|-
|0x91, 0x02, || Output (Data,Var,Abs,No Wrap,Linear,Preferred State,No Null Position,Non-volatile)
|-
|0x85, 0x12, || Report ID (18)
|-
|0x09, 0x12, || Usage (0x12)
|-
|0x75, 0x08, || Report Size (8)
|-
|0x95, 0x30, || Report Count (48)
|-
|0x91, 0x02, || Output (Data,Var,Abs,No Wrap,Linear,Preferred State,No Null Position,Non-volatile)
|-
|0xC0, || End Collection
|}

== Right Joy-con ==

HID Input Report Descriptor (Hexadecimal):
05010905a1010601ff85210921750895308102853009307508953081028531093175089669018102853209327508966901810285330933750896690
18102853f05091901291015002501750195108102050109391500250775049501814205097504950181010501093009310933093416000027ffff00
007510950481020601ff85010901750895309102851009107508953091028511091175089530910285120912750895309102c0

{| class="mw-collapsible mw-collapsed wikitable"
! Parsed Bytes || Description
|-
|0x05, 0x01, || Usage Page (Generic Desktop Ctrls)
|-
|0x09, 0x05, || Usage (Game Pad)
|-
|0xA1, 0x01, || Collection (Application)
|-
|0x06, 0x01, 0xFF, || Usage Page (Vendor Defined 0xFF01)
|-
|0x85, 0x21, || Report ID (33)
|-
|0x09, 0x21, || Usage (0x21)
|-
|0x75, 0x08, || Report Size (8)
|-
|0x95, 0x30, || Report Count (48)
|-
|0x81, 0x02, || Input (Data,Var,Abs,No Wrap,Linear,Preferred State,No Null Position)
|-
|0x85, 0x30, || Report ID (48)
|-
|0x09, 0x30, || Usage (0x30)
|-
|0x75, 0x08, || Report Size (8)
|-
|0x95, 0x30, || Report Count (48)
|-
|0x81, 0x02, || Input (Data,Var,Abs,No Wrap,Linear,Preferred State,No Null Position)
|-
|0x85, 0x31, || Report ID (49)
|-
|0x09, 0x31, || Usage (0x31)
|-
|0x75, 0x08, || Report Size (8)
|-
|0x96, 0x69, 0x01, || Report Count (361)
|-
|0x81, 0x02, || Input (Data,Var,Abs,No Wrap,Linear,Preferred State,No Null Position)
|-
|0x85, 0x32, || Report ID (50)
|-
|0x09, 0x32, || Usage (0x32)
|-
|0x75, 0x08, || Report Size (8)
|-
|0x96, 0x69, 0x01, || Report Count (361)
|-
|0x81, 0x02, || Input (Data,Var,Abs,No Wrap,Linear,Preferred State,No Null Position)
|-
|0x85, 0x33, || Report ID (51)
|-
|0x09, 0x33, || Usage (0x33)
|-
|0x75, 0x08, || Report Size (8)
|-
|0x96, 0x69, 0x01, || Report Count (361)
|-
|0x81, 0x02, || Input (Data,Var,Abs,No Wrap,Linear,Preferred State,No Null Position)
|-
|0x85, 0x3F, || Report ID (63)
|-
|0x05, 0x09, || Usage Page (Button)
|-
|0x19, 0x01, || Usage Minimum (0x01)
|-
|0x29, 0x10, || Usage Maximum (0x10)
|-
|0x15, 0x00, || Logical Minimum (0)
|-
|0x25, 0x01, || Logical Maximum (1)
|-
|0x75, 0x01, || Report Size (1)
|-
|0x95, 0x10, || Report Count (16)
|-
|0x81, 0x02, || Input (Data,Var,Abs,No Wrap,Linear,Preferred State,No Null Position)
|-
|0x05, 0x01, || Usage Page (Generic Desktop Ctrls)
|-
|0x09, 0x39, || Usage (Hat switch)
|-
|0x15, 0x00, || Logical Minimum (0)
|-
|0x25, 0x07, || Logical Maximum (7)
|-
|0x75, 0x04, || Report Size (4)
|-
|0x95, 0x01, || Report Count (1)
|-
|0x81, 0x42, || Input (Data,Var,Abs,No Wrap,Linear,Preferred State,Null State)
|-
|0x05, 0x09, || Usage Page (Button)
|-
|0x75, 0x04, || Report Size (4)
|-
|0x95, 0x01, || Report Count (1)
|-
|0x81, 0x01, || Input (Const,Array,Abs,No Wrap,Linear,Preferred State,No Null Position)
|-
|0x05, 0x01, || Usage Page (Generic Desktop Ctrls)
|-
|0x09, 0x30, || Usage (X)
|-
|0x09, 0x31, || Usage (Y)
|-
|0x09, 0x33, || Usage (Rx)
|-
|0x09, 0x34, || Usage (Ry)
|-
|0x16, 0x00, 0x00, || Logical Minimum (0)
|-
|0x27, 0xFF, 0xFF, 0x00, 0x00, || Logical Maximum (65534)
|-
|0x75, 0x10, || Report Size (16)
|-
|0x95, 0x04, || Report Count (4)
|-
|0x81, 0x02, || Input (Data,Var,Abs,No Wrap,Linear,Preferred State,No Null Position)
|-
|0x06, 0x01, 0xFF, || Usage Page (Vendor Defined 0xFF01)
|-
|0x85, 0x01, || Report ID (1)
|-
|0x09, 0x01, || Usage (0x01)
|-
|0x75, 0x08, || Report Size (8)
|-
|0x95, 0x30, || Report Count (48)
|-
|0x91, 0x02, || Output (Data,Var,Abs,No Wrap,Linear,Preferred State,No Null Position,Non-volatile)
|-
|0x85, 0x10, || Report ID (16)
|-
|0x09, 0x10, || Usage (0x10)
|-
|0x75, 0x08, || Report Size (8)
|-
|0x95, 0x30, || Report Count (48)
|-
|0x91, 0x02, || Output (Data,Var,Abs,No Wrap,Linear,Preferred State,No Null Position,Non-volatile)
|-
|0x85, 0x11, || Report ID (17)
|-
|0x09, 0x11, || Usage (0x11)
|-
|0x75, 0x08, || Report Size (8)
|-
|0x95, 0x30, || Report Count (48)
|-
|0x91, 0x02, || Output (Data,Var,Abs,No Wrap,Linear,Preferred State,No Null Position,Non-volatile)
|-
|0x85, 0x12, || Report ID (18)
|-
|0x09, 0x12, || Usage (0x12)
|-
|0x75, 0x08, || Report Size (8)
|-
|0x95, 0x30, || Report Count (48)
|-
|0x91, 0x02, || Output (Data,Var,Abs,No Wrap,Linear,Preferred State,No Null Position,Non-volatile)
|-
|0xC0, || End Collection
|}

Joy-Con

2017-03-12T23:26:33Z

Smartperson: Added basic HID info for left joy-con.

Main Page/Navigation

2017-03-12T23:16:43Z

Smartperson: Adding link to page for Joy-Con. I'm adding some details there.

{{Main page box|Navigation|:Navigation}}
<div style="margin: -.3em -1em -1em -1em;">
{| width="100%" bgcolor="#fff" border="0" cellpadding="2px" cellspacing="2px" style="margin:auto;"
|- align="center" bgcolor="#e7eef6"
! width="33%" | '''General'''
! width="33%" | '''Homebrew'''
! width="33%" | '''Switch hardware'''
|- valign="top" style="background: #F5FAFF;"
|
|
*[[Switch System Flaws]]
|
*[[Hardware|Overview]]
*[[Joy-Con]]
|}
</div>

<div style="margin: -.3em -1em -1em -1em; margin-top: +1em">
{| width="100%" bgcolor="#fff" border="0" cellpadding="2px" cellspacing="2px" style="margin:auto;"
|- align="center" bgcolor="#e7eef6"
! width="33%" | '''Switch Operating System'''
! width="33%" | '''Switch Software Stack'''
! width="33%" | '''Switch Content'''
|- valign="top" style="background: #F5FAFF;"
|
|
|
|}
</div>
{{box-footer-empty}}

News

2017-03-04T02:36:57Z

Smartperson: typo

<noinclude>
=== News ===
</noinclude>
*'''3 March 17''' Nintendo Switch global release.
*'''2 March 17''' Nintendo released system update [[2.0]].

2.0.0

2017-03-04T02:35:58Z

Smartperson: Updated with official change log from Nintendo, including link

The 2.0 release added the eShop functionality, the ability to add friends via Friend Codes, and to post screenshots to Facebook and Twitter.

This is the [http://en-americas-support.nintendo.com/app/answers/detail/a_id/22525/p/897 official changelog] from Nintendo regarding this update:

'''Improvements Included in Version 2.0.0'''

'''The following network features are now available'''
* Nintendo Account required. Some features may not be available in all countries/regions.
* Playing online
**Online multiplayer available for free until the paid online service launches in fall 2017. Not available in all countries.
*Adding friends
**Friends can be added from My Page, head to the HOME Menu and select your icon on the upper left.
*Sharing Album screenshots to Facebook and Twitter
*Browsing and purchasing content on Nintendo eShop
*Receiving News relating to games, Nintendo eShop discounts, and promotions
*Earning My Nintendo points for game card (retail version)

'''Added the following system functionality'''
*Update game software
*Turn on the TV automatically when placing the Nintendo Switch console in the Nintendo Switch dock.
**HDMI settings must also be enabled on your TV. Some TV models may be unable to use this feature. To turn on this feature for the Nintendo Switch console, head to System Settings > TV Settings > Match TV Power State
*Display the battery percentage on the HOME Menu
**To turn this ON/OFF, head to System Settings > System > Console Battery (%)
*Format the microSD card
**To format, head to System Settings > System > Initialize > Format microSD Card