Swapdoodle - Revision history

DaniElectra: /* BPK1 */ Fix typos

2025-01-04T19:15:34Z

BPK1: Fix typos

← Older revision		Revision as of 22:15, 4 January 2025
Line 40:		Line 40:
	\|-		\|-
	\| 0x0		\| 0x0
	\| ~~0x44~~		\| 0x40
	\| BPK1 header		\| BPK1 header
	\|-		\|-
	\| ~~0x44~~		\| 0x40
	\|		\|
	\| Block header		\| Block header
Line 78:		Line 78:
	\| 0x8		\| 0x8
	\| 0x4		\| 0x4
	\| Maximum block name length		\| Maximum block name length?
	\|-		\|-
	\| 0xC		\| 0xC
Line 115:		Line 115:
	\| 0x10		\| 0x10
	\| 0x8		\| 0x8
	\| Block name (if the name is smaller ~~tahn~~ 0x8, the rest is filled with NULL bytes)		\| Block name (if the name is smaller than 0x8, the rest is filled with NULL bytes)
	\|}		\|}

DaniElectra: Various corrections

2025-01-04T19:14:25Z

Various corrections

← Older revision		Revision as of 22:14, 4 January 2025
Line 5:		Line 5:
	== [[SpotPass]] usage ==		== [[SpotPass]] usage ==
	Currently, only these SpotPass endpoints are known to exist:		Currently, only these SpotPass endpoints are known to exist:
	* <nowiki>https://npdl.cdn.nintendowifi.net/p01/nsa/<regionID>/RNG_LS1/dstsetting</nowiki> ~~LZ10~~ compressed BPK1 structure		* <nowiki>https://npdl.cdn.nintendowifi.net/p01/nsa/<regionID>/RNG_LS1/dstsetting</nowiki> LZ11 compressed BPK1 structure
	* <nowiki>https://npdl.cdn.nintendowifi.net/p01/nsa/<regionID>/RNG_EC1/x.dlp</nowiki> BPK1 structure with all game lessons (x = 1, 2 or 3)		* <nowiki>https://npdl.cdn.nintendowifi.net/p01/nsa/<regionID>/RNG_EC1/x.dlp</nowiki> BPK1 structure with all game lessons (x = 1, 2 or 3)
	* <nowiki>https://npdl.cdn.nintendowifi.net/p01/nsa/<regionID>/RNG_MD1/dstdatList.bin</nowiki> BPK1 structure with game metadata		* <nowiki>https://npdl.cdn.nintendowifi.net/p01/nsa/<regionID>/RNG_MD1/dstdatList.bin</nowiki> BPK1 structure with game metadata
Line 27:		Line 27:

	== BPK1 ==		== BPK1 ==
	The BPK1 structure is used in almost all game data files. Some of the files that use this structure are LZ10 compressed (like the ones used for doodles and stationery).		The BPK1 structure is used in almost all game data files. Some of the files that use this structure are either LZ11 or LZ10 compressed (like the ones used for doodles and stationery).

	The structure starts with a BPK1 header, followed by all of its block headers, which can share names between each other. The headers are the followed by each block's data, which can hold any data (including another BPK1 structure).		The structure starts with a BPK1 header, followed by all of its block headers, which can share names between each other. The headers are the followed by each block's data, which can hold any data (including another BPK1 structure).
Line 91:		Line 91:
	\| 0x2C		\| 0x2C
	\| Padding		\| Padding
	\|-
	~~\| 0x40~~
	~~\| 0x4~~
	~~\| Header length~~
	\|}		\|}

Line 106:		Line 102:
	\|-		\|-
	\| 0x0		\| 0x0
			\| 0x4
			\| Block data offset
			\|-
			\| 0x4
	\| 0x4		\| 0x4
	\| Block size		\| Block size
	\|-		\|-
	\| ~~0x4~~		\| 0x8
	\| 0x4		\| 0x4
	\| Checksum of block data		\| Checksum of block data
	\|-		\|-
			\| 0x10
	\| 0x8		\| 0x8
	\|		\| Block name (if the name is smaller tahn 0x8, the rest is filled with NULL bytes)
	\| Block name (~~null terminated)~~
	\|-
	\|
	~~\| 0x4~~
	~~\| Size of BPK1 header and previous blocks (including this one~~)
	\|}		\|}

DaniElectra: /* SpotPass usage */ Expand SpotPass information

2023-02-21T18:48:58Z

SpotPass usage: Expand SpotPass information

← Older revision		Revision as of 21:48, 21 February 2023
Line 4:		Line 4:

	== [[SpotPass]] usage ==		== [[SpotPass]] usage ==
	Currently, only ~~three~~ SpotPass endpoints are known to exist:		Currently, only these SpotPass endpoints are known to exist:
	* <nowiki>https://npdl.cdn.nintendowifi.net/p01/nsa/<regionID>/RNG_LS1/dstsetting</nowiki> LZ10 compressed BPK1 structure		* <nowiki>https://npdl.cdn.nintendowifi.net/p01/nsa/<regionID>/RNG_LS1/dstsetting</nowiki> LZ10 compressed BPK1 structure
	* <nowiki>https://npdl.cdn.nintendowifi.net/p01/nsa/<regionID>/RNG_EC1/1.dlp</nowiki>		* <nowiki>https://npdl.cdn.nintendowifi.net/p01/nsa/<regionID>/RNG_EC1/x.dlp</nowiki> BPK1 structure with all game lessons (x = 1, 2 or 3)
	* <nowiki>https://npdl.cdn.nintendowifi.net/p01/nsa/<regionID>/RNG_MD1/dstdatList.bin</nowiki>		* <nowiki>https://npdl.cdn.nintendowifi.net/p01/nsa/<regionID>/RNG_MD1/dstdatList.bin</nowiki> BPK1 structure with game metadata
			* <nowiki>https://npdl.cdn.nintendowifi.net/p01/nsa/<regionID>/RNG_NTX/<language>/ntx</nowiki> For game notifications (x = 1 or 2)

	Where regionID goes the value from the below table.		Where regionID goes the value from the below table.
Line 23:		Line 24:
	\|}		\|}

	Also, the game uses Hpp servers for posting doodles and making status updates.		Also, the game uses Hpp[https://github.com/kinnay/NintendoClients/wiki/Hpp-Server] servers for posting doodles and making status updates.

	== BPK1 ==		== BPK1 ==

DaniElectra: /* BPK1 header */ Define maximum block name length field

2023-01-19T17:40:07Z

BPK1 header: Define maximum block name length field

← Older revision		Revision as of 20:40, 19 January 2023
Line 77:		Line 77:
	\| 0x8		\| 0x8
	\| 0x4		\| 0x4
	\| ~~Unknown (always 0x7?)~~		\| Maximum block name length
	\|-		\|-
	\| 0xC		\| 0xC

DaniElectra: fixup: The compression used is LZ10, not LZ11

2023-01-19T17:23:48Z

fixup: The compression used is LZ10, not LZ11

← Older revision		Revision as of 20:23, 19 January 2023
Line 5:		Line 5:
	== [[SpotPass]] usage ==		== [[SpotPass]] usage ==
	Currently, only three SpotPass endpoints are known to exist:		Currently, only three SpotPass endpoints are known to exist:
	* <nowiki>https://npdl.cdn.nintendowifi.net/p01/nsa/<regionID>/RNG_LS1/dstsetting</nowiki> ~~LZ11~~ compressed BPK1 structure		* <nowiki>https://npdl.cdn.nintendowifi.net/p01/nsa/<regionID>/RNG_LS1/dstsetting</nowiki> LZ10 compressed BPK1 structure
	* <nowiki>https://npdl.cdn.nintendowifi.net/p01/nsa/<regionID>/RNG_EC1/1.dlp</nowiki>		* <nowiki>https://npdl.cdn.nintendowifi.net/p01/nsa/<regionID>/RNG_EC1/1.dlp</nowiki>
	* <nowiki>https://npdl.cdn.nintendowifi.net/p01/nsa/<regionID>/RNG_MD1/dstdatList.bin</nowiki>		* <nowiki>https://npdl.cdn.nintendowifi.net/p01/nsa/<regionID>/RNG_MD1/dstdatList.bin</nowiki>
Line 26:		Line 26:

	== BPK1 ==		== BPK1 ==
	The BPK1 structure is used in almost all game data files. Some of the files that use this structure are ~~LZ11~~ compressed (like the ones used for doodles and stationery).		The BPK1 structure is used in almost all game data files. Some of the files that use this structure are LZ10 compressed (like the ones used for doodles and stationery).

	The structure starts with a BPK1 header, followed by all of its block headers, which can share names between each other. The headers are the followed by each block's data, which can hold any data (including another BPK1 structure).		The structure starts with a BPK1 header, followed by all of its block headers, which can share names between each other. The headers are the followed by each block's data, which can hold any data (including another BPK1 structure).

DaniElectra: Add Swapdoodle wiki (thanks to Miles and MrNbaYoh for information)

2023-01-16T19:35:29Z

Add Swapdoodle wiki (thanks to Miles and MrNbaYoh for information)

New page

'''Swapdoodle''' is the successor of the [[Swapnote]] application that allows you to send doodles to friends using SpotPass.

''Credits for Miles (with the BPK1 structures) and MrNbaYoh (with the custom CRC32 checksum) for providing information!''

== [[SpotPass]] usage ==
Currently, only three SpotPass endpoints are known to exist:
* <nowiki>https://npdl.cdn.nintendowifi.net/p01/nsa/<regionID>/RNG_LS1/dstsetting</nowiki> LZ11 compressed BPK1 structure
* <nowiki>https://npdl.cdn.nintendowifi.net/p01/nsa/<regionID>/RNG_EC1/1.dlp</nowiki>
* <nowiki>https://npdl.cdn.nintendowifi.net/p01/nsa/<regionID>/RNG_MD1/dstdatList.bin</nowiki>

Where regionID goes the value from the below table.

{| class="wikitable"
|-
! Region
! ID
|-
| USA
| 0hFlOFo7pNTU2dyE
|-
| EUR
| 3vveLadT8H6xKkQH
|}

Also, the game uses Hpp servers for posting doodles and making status updates.

== BPK1 ==
The BPK1 structure is used in almost all game data files. Some of the files that use this structure are LZ11 compressed (like the ones used for doodles and stationery).

The structure starts with a BPK1 header, followed by all of its block headers, which can share names between each other. The headers are the followed by each block's data, which can hold any data (including another BPK1 structure).

All of the structure entries are stored as little-endian data.

{| class="wikitable"
|-
! Offset
! Size
! Description
|-
| 0x0
| 0x44
| BPK1 header
|-
| 0x44
|
| Block header
|-
|
|
| Additional block headers
|-
|
|
| Block data
|-
|
|
| Additional blocks data
|}

=== BPK1 header ===

{| class="wikitable"
|-
! Offset
! Size
! Description
|-
| 0x0
| 0x4
| Header magic (BPK1)
|-
| 0x4
| 0x4
| Number of blocks
|-
| 0x8
| 0x4
| Unknown (always 0x7?)
|-
| 0xC
| 0x4
| Structure length
|-
| 0x10
| 0x4
| Header length
|-
| 0x14
| 0x2C
| Padding
|-
| 0x40
| 0x4
| Header length
|}

=== Block header ===

{| class="wikitable"
|-
! Offset
! Size
! Description
|-
| 0x0
| 0x4
| Block size
|-
| 0x4
| 0x4
| Checksum of block data
|-
| 0x8
|
| Block name (null terminated)
|-
|
| 0x4
| Size of BPK1 header and previous blocks (including this one)
|}

=== Block checksum ===
The checksum of each block is calculated as a custom CRC-32 checksum of the block's data:

* Polynomial: 4C11DB7
* Initial value: 4C11DB7
* Output XOR: 0

== Stationery blocks ==
The following blocks are used in the stationery files.

=== STAHED1 ===
This block holds the stationery file name and 0x79 byte padding.

=== THUMB2 ===
This block holds the thumbnail of the stationery as a JPEG image.

=== STBARD1 ===
There are two of these blocks. The first one holds a JPEG of the 2D part of the stationery, and the second one holds the 3D part.

=== STMASK1 ===
This block holds a 256x256 L4 data of the 3D part of the stationery.