3dbrew - User contributions [en]

PTM Services

2014-11-22T19:02:07Z

Thib:

A total of 24 sessions can be open for each of these services combined. The commands for each service are handled by the PTM module main() thread.

=User PTM Service "ptm:u" / PTM services=
{| class="wikitable" border="1"
|-
! Command Header
! Description
|-
| 0x00010002
| RegisterAlarmClient
|-
| 0x00020080
| SetRtcAlarm
|-
| 0x00030000
| GetRtcAlarm
|-
| 0x00040000
| CancelRtcAlarm
|-
| 0x00050000
| [[PTM:GetAdapterState|GetAdapterState]]
|-
| 0x00060000
| [[PTM:GetShellState|GetShellState]]
|-
| 0x00070000
| [[PTM:GetBatteryLevel|GetBatteryLevel]]
|-
| 0x00080000
| [[PTM:GetBatteryChargeState|GetBatteryChargeState]]
|-
| 0x00090000
| [[PTM:GetPedometerState|GetPedometerState]]
|-
| 0x000A0042
| GetStepHistoryEntry
|-
| 0x000B00C2
| GetStepHistory
|-
| 0x000C0000
| [[PTM:GetTotalStepCount|GetTotalStepCount]]
|-
| 0x000D0040
| SetPedometerRecordingMode
|-
| 0x000E0000
| GetPedometerRecordingMode
|-
| 0x000F0084
| GetStepHistoryAll
|}

The above commands are available for all PTM services.

=PlayHistory PTM Service "ptm:play" =
{| class="wikitable" border="1"
|-
! Command Header
! Description
|-
| 0x08070082
| GetPlayHistory
|-
| 0x08080000
| GetPlayHistoryStart
|-
| 0x08090000
| GetPlayHistoryLength
|-
| 0x080B0080
| CalcPlayHistoryStart
|}

=SysMenu PTM Service "ptm:sysm"=
{| class="wikitable" border="1"
|-
! Command Header
! Description
|-
| 0x040100C0
| SetRtcAlarmEx
|-
| 0x04020042
| ReplySleepQuery
|-
| 0x04030042
| NotifySleepPreparationComplete
|-
| 0x04040102
| SetWakeupTrigger
|-
| 0x04050000
| GetAwakeReason
|-
| 0x04060000
| RequestSleep
|-
| 0x040700C0
| ShutdownAsync
|-
| 0x04080000
| Awake
|-
| 0x04090080
| [[PTMSYSM:LaunchFIRMRebootSystem|RebootAsync]]
|-
| 0x040A0000
| [[PTMSYSM:CheckNew3DS|CheckNew3DS]] (Added with [[8.0.0-18]])
|-
| 0x08010640
| [[PTMSYSM:SetInfoLEDPattern|SetInfoLEDPattern]] (These 4 LED commands are used for the notification LED, see [[MCU]] regarding boot fail with invalid parameters)
|-
| 0x08020040
| [[PTMSYSM:SetInfoLEDPatternHeader|SetInfoLEDPatternHeader]]
|-
| 0x08030000
| [[PTMSYSM:GetInfoLEDStatus|GetInfoLEDStatus]]
|-
| 0x08040040
| [[PTMSYSM:SetBatteryEmptyLEDPattern|SetBatteryEmptyLEDPattern]]
|-
| 0x08050000
| ClearStepHistory
|-
| 0x080600C2
| SetStepHistory
|-
| 0x08070082
| GetPlayHistory
|-
| 0x08080000
| GetPlayHistoryStart
|-
| 0x08090000
| GetPlayHistoryLength
|-
| 0x080A0000
| ClearPlayHistory
|-
| 0x080B0080
| CalcPlayHistoryStart
|-
| 0x080C0080
| SetUserTime
|-
| 0x080D0000
| InvalidateSystemTime
|-
| 0x080E0140
| [[PTMSYSM:NotifyPlayEvent|NotifyPlayEvent]]
|-
| 0x080F0000
| IsLegacyPowerOff
|-
| 0x08100000
| ClearLegacyPowerOff
|-
| 0x08110000
| GetShellStatus
|-
| 0x08120000
| IsShutdownByBatteryEmpty
|-
| 0x08130000
| FormatSavedata
|-
| 0x08140000
| GetLegacyJumpProhibitedFlag
|}

=GetSystemTime PTM Service "ptm:gets"=

=SystemControl PTM Service "ptm:s"=

PTM:GetPedometerState

2014-11-22T19:02:02Z

Thib: Created page with "=Request= {| class="wikitable" border="1" |- ! Index Word ! Description |- | 0 | Header code [0x00090000] |} =Response= {| class="wikitable" border="1" |- ! Index Word ! Des..."

=Request=
{| class="wikitable" border="1"
|-
! Index Word
! Description
|-
| 0
| Header code [0x00090000]
|}

=Response=
{| class="wikitable" border="1"
|-
! Index Word
! Description
|-
| 0
| Header code
|-
| 1
| Result code
|-
| 2
| u8 output: 0 = not counting steps, 1 = counting steps.
|}

PTM:GetShellState

2014-11-22T19:01:04Z

Thib: Created page with "=Request= {| class="wikitable" border="1" |- ! Index Word ! Description |- | 0 | Header code [0x00060000] |} =Response= {| class="wikitable" border="1" |- ! Index Word ! Des..."

=Request=
{| class="wikitable" border="1"
|-
! Index Word
! Description
|-
| 0
| Header code [0x00060000]
|}

=Response=
{| class="wikitable" border="1"
|-
! Index Word
! Description
|-
| 0
| Header code
|-
| 1
| Result code
|-
| 2
| u8 output: 0 = closed, 1 = open (not tested on 2DS).
|}

MPO

2013-01-08T20:29:04Z

Thib: /* Nintendo's EXIF MakerNote Tag */

[[Category:File formats]]
=== Overview ===

MPO = Multi-Picture Object

Document describing the file format used in mpo files:
http://www.cipa.jp/english/hyoujunka/kikaku/pdf/DC-007_E.pdf

Nintendo uses a common format for its 3D pictures.
MPO is basically two JPG files concatenated in one file.
The two JPG files has an EXIF data structure in their headers (This was developed by CIPA).

EXIF is a standard that specifies the formats for images, sound, and ancillary tags used by digital cameras (including smartphones), scanners and other systems handling image and sound files recorded by digital cameras.[http://en.wikipedia.org/wiki/Exchangeable_image_file_format]

=== Nintendo's EXIF Data Structure ===

{| class="wikitable" border="1"
|-
! ID
! DESCRIPTION
! VALUE
|-
|0x010F
|Manufacturer
|Nintendo
|-
|0x0110
|Camera
|Nintendo 3DS
|-
|0x011A
|XResolution
|72:1
|-
|0x011B
|YResolution
|72:1
|-
|0x0128
|ResolutionUnit
|2
|-
|0x0131
|Software
|Depends on the software: 00204 for the Camera (EU), 00227 for the Mii Editor (EU), 00955 for KH3D (EU)
|-
|0x0132
|DateTime
|YYYY:MM:DD HH:mm:SS
|-
|0x0213
|YCbCrPositioning
|2
|-
|0x9000
|ExifVersion
|0220
|-
|0x9003
|DateTimeOriginal
|YYYY:MM:DD HH:mm:SS
|-
|0x9004
|DateTimeDigitized
|YYYY:MM:DD HH:mm:SS
|-
|0x9101
|ComponentsConfiguration
|[0x01,0x02,0x03,0x00]
|-
|0x927C
|MakerNote
|[DATA - 174 bytes] (yet to be understood)
|-
|0xA000
|FlashPixVersion
|0100
|-
|0xA001
|ColorSpace
|1
|-
|0xA002
|PixelXDimension
|640
|-
|0xA003
|PixelYDimension
|480
|-
|0x5041
|InteroperabilityIndex
|R98
|-
|0x5042
|ExifInteroperabilityVersion
|0100
|-
|0x1000
|InteroperabilityVersion
|JPEG Exif Ver 2.2
|-
|0x501B
|ThumbnailData
|[DATA - 3000+ bytes]
|-
|0x5023
|ThumbnailCompression
|6
|-
|0x502D
|ThumbnailXResolution
|72:1
|-
|0x502E
|ThumbnailYResolution
|72:1
|-
|0x5030
|ThumbnailTransferFunction
|2
|-
|0x0201
|JPEGInterchangeFormat
|682
|-
|0x0202
|JPEGInterchangeFormatLength
|3000+
|-
|0x5091
|ChrominanceTable
|[DATA - 128 bytes]
|-
|0x5090
|LuminanceTable
|[DATA - 128 bytes]
|}

==== Nintendo's EXIF MakerNote Tag ====
'''This still need to be figured out:'''

The MakerNote is made with Tiff Exif information (Big Endian)

first 2 bytes are the IFD Count (IFD is a 12 byte tag), Regulary there are 2 IFDs.

'''IFD structure'''
{| class="wikitable" border="1"
|-
! Tag
! Type
! Count/Value
! Value/Offset
|-
|2 bytes
|2 bytes
|4 bytes
|4 bytes
|}

'''Nintendo's IFDs'''

{| class="wikitable" border="1"
|-
! Tag
! Desc
! Type
! Count/Value
! Value/Offset
|-
|0x1100
|Software-specific data
|7-Undefined
|Count
|Count=1 ? Value : Offset
|-
|0x1101
|Nintendo 64byte Note
|7-Undefined
|Count
|Offset
|}

After the IFDs comes a 4 byte Zero ( {0,0,0,0} ).

And then the Data the IFDs point at (if at all)

'''Nintendo's 64Byte Note'''

Different from the wrapping structure this structure is Little-Endian.

{| class="wikitable" border="1"
|-
! Offset
! Description
! Type
! Default Value
|-
|0x00
|Magic
|char[4]
|{'3','D','S','1'}
|-
|0x08
|Timestamp
|uint32
|Number of seconds since 1/1/2010 00:00:00
|-
|0x0C
|Padding
|uint32
|0
|-
|0x10
|Title ID Low
|uint32
|like the title id low but without the last two letters
|-
|0x14
|Flags
|uint32
|
|-
|0x18
|Console ID
|byte[4]
|unique identifier
|-
|0x1C
|Padding
|byte[12]
|0
|-
|0x28
|3D Parallax
|float
|[-52,54]
|-
|0x2C
|Padding
|uint32
|0
|-
|0x30
|Category
|uint16
|0x2000 for a man, 0x4000 a woman, 0x1000 a mii...
|-
|0x32
|Filter
|uint16
|
|-
|0x34
|Padding
|byte[12]
|0
|}

MPO

2013-01-08T19:09:55Z

Thib: /* Nintendo's EXIF MakerNote Tag */

[[Category:File formats]]
=== Overview ===

MPO = Multi-Picture Object

Document describing the file format used in mpo files:
http://www.cipa.jp/english/hyoujunka/kikaku/pdf/DC-007_E.pdf

Nintendo uses a common format for its 3D pictures.
MPO is basically two JPG files concatenated in one file.
The two JPG files has an EXIF data structure in their headers (This was developed by CIPA).

EXIF is a standard that specifies the formats for images, sound, and ancillary tags used by digital cameras (including smartphones), scanners and other systems handling image and sound files recorded by digital cameras.[http://en.wikipedia.org/wiki/Exchangeable_image_file_format]

=== Nintendo's EXIF Data Structure ===

{| class="wikitable" border="1"
|-
! ID
! DESCRIPTION
! VALUE
|-
|0x010F
|Manufacturer
|Nintendo
|-
|0x0110
|Camera
|Nintendo 3DS
|-
|0x011A
|XResolution
|72:1
|-
|0x011B
|YResolution
|72:1
|-
|0x0128
|ResolutionUnit
|2
|-
|0x0131
|Software
|Depends on the software: 00204 for the Camera (EU), 00227 for the Mii Editor (EU), 00955 for KH3D (EU)
|-
|0x0132
|DateTime
|YYYY:MM:DD HH:mm:SS
|-
|0x0213
|YCbCrPositioning
|2
|-
|0x9000
|ExifVersion
|0220
|-
|0x9003
|DateTimeOriginal
|YYYY:MM:DD HH:mm:SS
|-
|0x9004
|DateTimeDigitized
|YYYY:MM:DD HH:mm:SS
|-
|0x9101
|ComponentsConfiguration
|[0x01,0x02,0x03,0x00]
|-
|0x927C
|MakerNote
|[DATA - 174 bytes] (yet to be understood)
|-
|0xA000
|FlashPixVersion
|0100
|-
|0xA001
|ColorSpace
|1
|-
|0xA002
|PixelXDimension
|640
|-
|0xA003
|PixelYDimension
|480
|-
|0x5041
|InteroperabilityIndex
|R98
|-
|0x5042
|ExifInteroperabilityVersion
|0100
|-
|0x1000
|InteroperabilityVersion
|JPEG Exif Ver 2.2
|-
|0x501B
|ThumbnailData
|[DATA - 3000+ bytes]
|-
|0x5023
|ThumbnailCompression
|6
|-
|0x502D
|ThumbnailXResolution
|72:1
|-
|0x502E
|ThumbnailYResolution
|72:1
|-
|0x5030
|ThumbnailTransferFunction
|2
|-
|0x0201
|JPEGInterchangeFormat
|682
|-
|0x0202
|JPEGInterchangeFormatLength
|3000+
|-
|0x5091
|ChrominanceTable
|[DATA - 128 bytes]
|-
|0x5090
|LuminanceTable
|[DATA - 128 bytes]
|}

==== Nintendo's EXIF MakerNote Tag ====
'''This still need to be figured out:'''

The MakerNote is made with Tiff Exif information (Big Endian)

first 2 bytes are the IFD Count (IFD is a 12 byte tag), Regulary there are 2 IFDs.

'''IFD structure'''
{| class="wikitable" border="1"
|-
! Tag
! Type
! Count/Value
! Value/Offset
|-
|2 bytes
|2 bytes
|4 bytes
|4 bytes
|}

'''Nintendo's IFDs'''

{| class="wikitable" border="1"
|-
! Tag
! Desc
! Type
! Count/Value
! Value/Offset
|-
|0x1100
|Software-specific data
|7-Undefined
|Count
|Count=1 ? Value : Offset
|-
|0x1101
|Nintendo 64byte Note
|7-Undefined
|Count
|Offset
|}

After the IFDs comes a 4 byte Zero ( {0,0,0,0} ).

And then the Data the IFDs point at (if at all)

'''Nintendo's 64Byte Note'''

{| class="wikitable" border="1"
|-
! Offset
! Description
! Type
! Default Value
|-
|0
|Magic
|Byte[4]
|{'3','D','S','1'}
|-
|8
|Timestamp
|Int
|-
|16
|Title ID Low
|Int
|-
|24
|Console identifier?
|Int
|?
|-
|38
|Unknown
|Unknown
|Unknown
|-
|40
|3D Parallax*
|NegInt?
|?
|-
|48
|Category?
|Int?
|0x02000 for a man, 0x04000 a woman, 0x10000 a mii...
|}

*The 3D Parallax value is the distance that the right image needed to move in order to get focus.

My formula to get that value isn't so good but here it is:

x = (lsb - 0xC0) << 8 + msb;

Parallax = - round( 2 ^ (x/128 + 2) )

If someone makes sense of this, please explain or maybe correct..

MPO

2012-07-28T13:08:55Z

Thib: /* Nintendo's EXIF Data Structure */

[[Category:File formats]]
=== Overview ===

MPO = Multi-Picture Object

Document describing the file format used in mpo files:
http://www.cipa.jp/english/hyoujunka/kikaku/pdf/DC-007_E.pdf

Nintendo uses a common format for its 3D pictures.
MPO is basically two JPG files concatenated in one file.
The two JPG files has an EXIF data structure in their headers (This was developed by CIPA).

EXIF is a standard that specifies the formats for images, sound, and ancillary tags used by digital cameras (including smartphones), scanners and other systems handling image and sound files recorded by digital cameras.[http://en.wikipedia.org/wiki/Exchangeable_image_file_format]

=== Nintendo's EXIF Data Structure ===

{| class="wikitable" border="1"
|-
! ID
! DESCRIPTION
! VALUE
|-
|0x010F
|Manufacturer
|Nintendo
|-
|0x0110
|Camera
|Nintendo 3DS
|-
|0x011A
|XResolution
|72:1
|-
|0x011B
|YResolution
|72:1
|-
|0x0128
|ResolutionUnit
|2
|-
|0x0131
|Software
|Depends on the software: 00204 for the Camera (EU), 00227 for the Mii Editor (EU), 00955 for KH3D (EU)
|-
|0x0132
|DateTime
|YYYY:MM:DD HH:mm:SS
|-
|0x0213
|YCbCrPositioning
|2
|-
|0x9000
|ExifVersion
|0220
|-
|0x9003
|DateTimeOriginal
|YYYY:MM:DD HH:mm:SS
|-
|0x9004
|DateTimeDigitized
|YYYY:MM:DD HH:mm:SS
|-
|0x9101
|ComponentsConfiguration
|[0x01,0x02,0x03,0x00]
|-
|0x927C
|MakerNote
|[DATA - 174 bytes] (yet to be understood)
|-
|0xA000
|FlashPixVersion
|0100
|-
|0xA001
|ColorSpace
|1
|-
|0xA002
|PixelXDimension
|640
|-
|0xA003
|PixelYDimension
|480
|-
|0x5041
|InteroperabilityIndex
|R98
|-
|0x5042
|ExifInteroperabilityVersion
|0100
|-
|0x1000
|InteroperabilityVersion
|JPEG Exif Ver 2.2
|-
|0x501B
|ThumbnailData
|[DATA - 3000+ bytes]
|-
|0x5023
|ThumbnailCompression
|6
|-
|0x502D
|ThumbnailXResolution
|72:1
|-
|0x502E
|ThumbnailYResolution
|72:1
|-
|0x5030
|ThumbnailTransferFunction
|2
|-
|0x0201
|JPEGInterchangeFormat
|682
|-
|0x0202
|JPEGInterchangeFormatLength
|3000+
|-
|0x5091
|ChrominanceTable
|[DATA - 128 bytes]
|-
|0x5090
|LuminanceTable
|[DATA - 128 bytes]
|}

==== Nintendo's EXIF MakerNote Tag ====
'''This still need to be figured out:'''

The MakerNote is made with Tiff Exif information (Big Endian)

first 2 bytes are the IFD Count (IFD is a 12 byte tag), Regulary there are 2 IFDs.

'''IFD structure'''
{| class="wikitable" border="1"
|-
! Tag
! Type
! Count/Value
! Value/Offset
|-
|2 bytes
|2 bytes
|4 bytes
|4 bytes
|}

'''Nintendo's IFDs'''

{| class="wikitable" border="1"
|-
! Tag
! Desc
! Type
! Count/Value
! Value/Offset
|-
|0x1100
|Software-specific data
|7-Undefined
|Count
|Count=1 ? Value : Offset
|-
|0x1101
|Nintendo 64byte Note
|7-Undefined
|Count
|Offset
|}

After the IFDs comes a 4 byte Zero ( {0,0,0,0} ).

And then the Data the IFDs point at (if at all)

'''Nintendo's 64Byte Note'''

{| class="wikitable" border="1"
|-
! Offset
! Description
! Type
! Default Value
|-
|0
|Magic
|Byte[4]
|{'3','D','S','1'}
|-
|24
|Console identifier?
|Int
|?
|-
|38
|Unknown
|Unknown
|Unknown
|-
|40
|3D Parallax*
|NegInt?
|?
|-
|48
|Category?
|Int?
|0x02000 for a man, 0x04000 a woman, 0x10000 a mii...
|}

*The 3D Parallax value is the distance that the right image needed to move in order to get focus.

My formula to get that value isn't so good but here it is:

x = (lsb - 0xC0) << 8 + msb;

Parallax = - round( 2 ^ (x/128 + 2) )

If someone makes sense of this, please explain or maybe correct..

MPO

2012-07-28T13:07:00Z

Thib: /* Nintendo's EXIF MakerNote Tag */

[[Category:File formats]]
=== Overview ===

MPO = Multi-Picture Object

Document describing the file format used in mpo files:
http://www.cipa.jp/english/hyoujunka/kikaku/pdf/DC-007_E.pdf

Nintendo uses a common format for its 3D pictures.
MPO is basically two JPG files concatenated in one file.
The two JPG files has an EXIF data structure in their headers (This was developed by CIPA).

EXIF is a standard that specifies the formats for images, sound, and ancillary tags used by digital cameras (including smartphones), scanners and other systems handling image and sound files recorded by digital cameras.[http://en.wikipedia.org/wiki/Exchangeable_image_file_format]

=== Nintendo's EXIF Data Structure ===

{| class="wikitable" border="1"
|-
! ID
! DESCRIPTION
! VALUE
|-
|0x010F
|Manufacturer
|Nintendo
|-
|0x0110
|Camera
|Nintendo 3DS
|-
|0x011A
|XResolution
|72:1
|-
|0x011B
|YResolution
|72:1
|-
|0x0128
|ResolutionUnit
|2
|-
|0x0131
|Software
|00204
|-
|0x0132
|DateTime
|YYYY:MM:DD HH:mm:SS
|-
|0x0213
|YCbCrPositioning
|2
|-
|0x9000
|ExifVersion
|0220
|-
|0x9003
|DateTimeOriginal
|YYYY:MM:DD HH:mm:SS
|-
|0x9004
|DateTimeDigitized
|YYYY:MM:DD HH:mm:SS
|-
|0x9101
|ComponentsConfiguration
|[0x01,0x02,0x03,0x00]
|-
|0x927C
|MakerNote
|[DATA - 174 bytes] (yet to be understood)
|-
|0xA000
|FlashPixVersion
|0100
|-
|0xA001
|ColorSpace
|1
|-
|0xA002
|PixelXDimension
|640
|-
|0xA003
|PixelYDimension
|480
|-
|0x5041
|InteroperabilityIndex
|R98
|-
|0x5042
|ExifInteroperabilityVersion
|0100
|-
|0x1000
|InteroperabilityVersion
|JPEG Exif Ver 2.2
|-
|0x501B
|ThumbnailData
|[DATA - 3000+ bytes]
|-
|0x5023
|ThumbnailCompression
|6
|-
|0x502D
|ThumbnailXResolution
|72:1
|-
|0x502E
|ThumbnailYResolution
|72:1
|-
|0x5030
|ThumbnailTransferFunction
|2
|-
|0x0201
|JPEGInterchangeFormat
|682
|-
|0x0202
|JPEGInterchangeFormatLength
|3000+
|-
|0x5091
|ChrominanceTable
|[DATA - 128 bytes]
|-
|0x5090
|LuminanceTable
|[DATA - 128 bytes]
|}

==== Nintendo's EXIF MakerNote Tag ====
'''This still need to be figured out:'''

The MakerNote is made with Tiff Exif information (Big Endian)

first 2 bytes are the IFD Count (IFD is a 12 byte tag), Regulary there are 2 IFDs.

'''IFD structure'''
{| class="wikitable" border="1"
|-
! Tag
! Type
! Count/Value
! Value/Offset
|-
|2 bytes
|2 bytes
|4 bytes
|4 bytes
|}

'''Nintendo's IFDs'''

{| class="wikitable" border="1"
|-
! Tag
! Desc
! Type
! Count/Value
! Value/Offset
|-
|0x1100
|Software-specific data
|7-Undefined
|Count
|Count=1 ? Value : Offset
|-
|0x1101
|Nintendo 64byte Note
|7-Undefined
|Count
|Offset
|}

After the IFDs comes a 4 byte Zero ( {0,0,0,0} ).

And then the Data the IFDs point at (if at all)

'''Nintendo's 64Byte Note'''

{| class="wikitable" border="1"
|-
! Offset
! Description
! Type
! Default Value
|-
|0
|Magic
|Byte[4]
|{'3','D','S','1'}
|-
|24
|Console identifier?
|Int
|?
|-
|38
|Unknown
|Unknown
|Unknown
|-
|40
|3D Parallax*
|NegInt?
|?
|-
|48
|Category?
|Int?
|0x02000 for a man, 0x04000 a woman, 0x10000 a mii...
|}

*The 3D Parallax value is the distance that the right image needed to move in order to get focus.

My formula to get that value isn't so good but here it is:

x = (lsb - 0xC0) << 8 + msb;

Parallax = - round( 2 ^ (x/128 + 2) )

If someone makes sense of this, please explain or maybe correct..