tPERSONAL_DATA Struct Reference

User's DS settings. More...

#include <system.h>

Data Fields
u8	alarmHour
	What hour the alarm clock is set to (0-23).
u8	alarmMinute
	What minute the alarm clock is set to (0-59).
u8	birthDay
	The user's birth day (1-31).
u8	birthMonth
	The user's birth month (1-12).
u16	calX1
	Touchscreen calibration: first X touch.
u8	calX1px
	Touchscreen calibration: first X touch pixel.
u16	calX2
	Touchscreen calibration: second X touch.
u8	calX2px
	Touchscreen calibration: second X touch pixel.
u16	calY1
	Touchscreen calibration: first Y touch.
u8	calY1px
	Touchscreen calibration: first X touch pixel.
u16	calY2
	Touchscreen calibration: second Y touch.
u8	calY2px
	Touchscreen calibration: second Y touch pixel.
s16	message [26]
	The user's message in UTF-16LE format.
u16	messageLen
	The length of the user's message in characters.
s16	name [10]
	The user's name in UTF-16LE format.
u16	nameLen
	The length of the user's name in characters.
u8	rtcClockAdjust
	Real Time Clock adjustment register value.
u32	rtcOffset
	Real Time Clock offset.
u8	theme
	The user's theme color (0-15).
u8	year
	Year (0 = 2000 .. 255 = 2255)

Detailed Description

User's DS settings.

Defines the structure the DS firmware uses for transfer of the user's settings to the booted program.

Warning

This struct is initialized by the ARM7 when readUserSettings() is called. This function is called by default at the beginning of main(), but this means that the personal data isn't accessible from the ARM9 right at the start of main(). It may take a frame or two to be actually available.

Field Documentation

language

u32 tPERSONAL_DATA::language

User's language.

Language values:

• 0 = Japanese
• 1 = English
• 2 = French
• 3 = German
• 4 = Italian
• 5 = Spanish
• 6 = Chinese(?)
• 7 = Unknown/Reserved

rtcOffset

u32 tPERSONAL_DATA::rtcOffset

Real Time Clock offset.

Whenever the time/date of the NDS is changed in the system settings menu from time A to time B, the firmware adds (epoch(B) - epoch(A)) to this field. libnds doesn't do this in rtcTimeSet() or rtcTimeAndDateSet(), so any game that relies on this firmware field to detect time/date modifications won't be able to do it.

theme

u8 tPERSONAL_DATA::theme

The user's theme color (0-15).

Theme/Color values:

• 0 = Gray
• 1 = Brown
• 2 = Red
• 3 = Pink
• 4 = Orange
• 5 = Yellow
• 6 = Yellow/Green-ish
• 7 = Green
• 8 = Dark Green
• 9 = Green/Blue-ish
• 10 = Light Blue
• 11 = Blue
• 12 = Dark Blue
• 13 = Dark Purple
• 14 = Purple
• 15 = Purple/Red-ish

---

The documentation for this struct was generated from the following file:

• system.h