ctruLua/source/apt.c

/***
The `apt` module.
Used to manage the applets and application status.
@module ctr.apt
@usage local apt = require("ctr.apt")
*/

#include <stdlib.h>

#include <3ds/types.h>
#include <3ds/services/apt.h>

#include <lua.h>
#include <lauxlib.h>

/***
Open an APT session. Should only work if you don't use the homebrew menu.
@function openSession
*/
static int apt_openSession(lua_State *L) {
	aptOpenSession();
	return 0;
}

/***
Close the current APT session.
@function closeSession
*/
static int apt_closeSession(lua_State *L) {
	aptCloseSession();
	return 0;
}

/***
Set the app status.
@function setStatus
*/
static int apt_setStatus(lua_State *L) {
	APT_AppStatus status = luaL_checkinteger(L, 1);
	
	aptSetStatus(status);
	
	return 0;
}

/***
Get the app status.
@function getStatus
*/
static int apt_getStatus(lua_State *L) {
	APT_AppStatus status = aptGetStatus();
	
	lua_pushinteger(L, status);
	return 1;
}

/***
Return to the Home menu.
@function returnToMenu
*/
static int apt_returnToMenu(lua_State *L) {
	aptReturnToMenu();
	return 0;
}

/***
Get the power status.
@function getStatusPower
@treturn boolean true if the power button has been pressed
*/
static int apt_getStatusPower(lua_State *L) {
	u32 status = aptGetStatusPower();
	
	lua_pushboolean(L, status);
	return 1;
}

/***
Set the power status.
@function setStatusPower
@tparam boolean status new power status
*/
static int apt_setStatusPower(lua_State *L) {
	u32 status = lua_toboolean(L, 1);
	
	aptSetStatusPower(status);
	
	return 0;
}

/***
Signal that the application is ready for sleeping.
@function signalReadyForSleep
*/
static int apt_signalReadyForSleep(lua_State *L) {
	aptSignalReadyForSleep();
	return 0;
}

/***
Return the Home menu AppID.
@function getMenuAppID
@treturn number the AppID
*/
static int apt_getMenuAppID(lua_State *L) {
	lua_pushinteger(L, aptGetMenuAppID());
	return 1;
}

/***
Allow or not the system to enter sleep mode.
@function setSleepAllowed
@tparam boolean allowed `true` to allow, `false` to disallow
*/
static int apt_setSleepAllowed(lua_State *L) {
	bool allowed = lua_toboolean(L, 1);
	
	aptSetSleepAllowed(allowed);
	
	return 0;
}

/***
Check if sleep mode is allowed.
@function isSleepAllowed
@treturn boolean `true` is allowed, false if not.
*/
static int apt_isSleepAllowed(lua_State *L) {
	lua_pushboolean(L, aptIsSleepAllowed());
	
	return 1;
}

static const struct luaL_Reg apt_lib[] = {
	{"openSession",         apt_openSession        },
	{"closeSession",        apt_closeSession       },
	{"setStatus",           apt_setStatus          },
	{"getStatus",           apt_getStatus          },
	{"returnToMenu",        apt_returnToMenu       },
	{"getStatusPower",      apt_getStatusPower     },
	{"setStatusPower",      apt_setStatusPower     },
	{"signalReadyForSleep", apt_signalReadyForSleep},
	{"getMenuAppID",        apt_getMenuAppID       },
	{"setSleepAllowed",     apt_setSleepAllowed    },
	{"isSleepAllowed",      apt_isSleepAllowed     },
	{NULL, NULL}
};

struct { char *name; int value; } apt_constants[] = {
	/***
	@field APPID_HOMEMENU
	*/
	{"APPID_HOMEMENU",           APPID_HOMEMENU          },
	/***
	@field APPID_CAMERA
	*/
	{"APPID_CAMERA",             APPID_CAMERA            },
	/***
	@field APPID_FRIENDS_LIST
	*/
	{"APPID_FRIENDS_LIST",       APPID_FRIENDS_LIST      },
	/***
	@field APPID_GAME_NOTES
	*/
	{"APPID_GAME_NOTES",         APPID_GAME_NOTES        },
	/***
	@field APPID_WEB
	*/
	{"APPID_WEB",                APPID_WEB               },
	/***
	@field APPID_INSTRUCTION_MANUAL
	*/
	{"APPID_INSTRUCTION_MANUAL", APPID_INSTRUCTION_MANUAL},
	/***
	@field APPID_NOTIFICATIONS
	*/
	{"APPID_NOTIFICATIONS",      APPID_NOTIFICATIONS     },
	/***
	@field APPID_MIIVERSE
	*/
	{"APPID_MIIVERSE",           APPID_MIIVERSE          },
	/***
	@field APPID_MIIVERSE_POSTING
	*/
	{"APPID_MIIVERSE_POSTING",   APPID_MIIVERSE_POSTING  },
	/***
	@field APPID_AMIIBO_SETTINGS
	*/
	{"APPID_AMIIBO_SETTINGS",    APPID_AMIIBO_SETTINGS   },
	/***
	@field APPID_APPLICATION
	*/
	{"APPID_APPLICATION",        APPID_APPLICATION       },
	/***
	@field APPID_ESHOP
	*/
	{"APPID_ESHOP",              APPID_ESHOP             },
	/***
	@field APPID_SOFTWARE_KEYBOARD
	*/
	{"APPID_SOFTWARE_KEYBOARD",  APPID_SOFTWARE_KEYBOARD },
	/***
	@field APPID_APPLETED
	*/
	{"APPID_APPLETED",           APPID_APPLETED          },
	/***
	@field APPID_PNOTE_AP
	*/
	{"APPID_PNOTE_AP",           APPID_PNOTE_AP          },
	/***
	@field APPID_SNOTE_AP
	*/
	{"APPID_SNOTE_AP",           APPID_SNOTE_AP          },
	/***
	@field APPID_ERROR
	*/
	{"APPID_ERROR",              APPID_ERROR             },
	/***
	@field APPID_MINT
	*/
	{"APPID_MINT",               APPID_MINT              },
	/***
	@field APPID_EXTRAPAD
	*/
	{"APPID_EXTRAPAD",           APPID_EXTRAPAD          },
	/***
	@field APPID_MEMOLIB
	*/
	{"APPID_MEMOLIB",            APPID_MEMOLIB           },
	/***
	@field APP_NOTINITIALIZED
	*/
	{"APP_NOTINITIALIZED",    APP_NOTINITIALIZED   },
	/***
	@field APP_RUNNING
	*/
	{"APP_RUNNING",           APP_RUNNING          },
	/***
	@field APP_SUSPENDED
	*/
	{"APP_SUSPENDED",         APP_SUSPENDED        },
	/***
	@field APP_EXITING
	*/
	{"APP_EXITING",           APP_EXITING          },
	/***
	@field APP_SUSPENDING
	*/
	{"APP_SUSPENDING",        APP_SUSPENDING       },
	/***
	@field APP_SLEEPMODE
	*/
	{"APP_SLEEPMODE",         APP_SLEEPMODE        },
	/***
	@field APP_PREPARE_SLEEPMODE
	*/
	{"APP_PREPARE_SLEEPMODE", APP_PREPARE_SLEEPMODE},
	/***
	@field APP_APPLETSTARTED
	*/
	{"APP_APPLETSTARTED",     APP_APPLETSTARTED    },
	/***
	@field APP_APPLETCLOSED
	*/
	{"APP_APPLETCLOSED",      APP_APPLETCLOSED     },
	/***
	@field APTSIGNAL_HOMEBUTTON
	*/
	{"APTSIGNAL_HOMEBUTTON",   APTSIGNAL_HOMEBUTTON  },
	/***
	@field APTSIGNAL_PREPARESLEEP
	*/
	{"APTSIGNAL_PREPARESLEEP", APTSIGNAL_PREPARESLEEP},
	/***
	@field APTSIGNAL_ENTERSLEEP
	*/
	{"APTSIGNAL_ENTERSLEEP",   APTSIGNAL_ENTERSLEEP  },
	/***
	@field APTSIGNAL_WAKEUP
	*/
	{"APTSIGNAL_WAKEUP",       APTSIGNAL_WAKEUP      },
	/***
	@field APTSIGNAL_ENABLE
	*/
	{"APTSIGNAL_ENABLE",       APTSIGNAL_ENABLE      },
	/***
	@field APTSIGNAL_POWERBUTTON
	*/
	{"APTSIGNAL_POWERBUTTON",  APTSIGNAL_POWERBUTTON },
	/***
	@field APTSIGNAL_UTILITY
	*/
	{"APTSIGNAL_UTILITY",      APTSIGNAL_UTILITY     },
	/***
	@field APTSIGNAL_SLEEPSYSTEM
	*/
	{"APTSIGNAL_SLEEPSYSTEM",  APTSIGNAL_SLEEPSYSTEM },
	/***
	@field APTSIGNAL_ERROR
	*/
	{"APTSIGNAL_ERROR",        APTSIGNAL_ERROR       },
	/***
	@field APTHOOK_ONSUSPEND
	*/
	{"APTHOOK_ONSUSPEND", APTHOOK_ONSUSPEND},
	/***
	@field APTHOOK_ONRESTORE
	*/
	{"APTHOOK_ONRESTORE", APTHOOK_ONRESTORE},
	/***
	@field APTHOOK_ONSLEEP
	*/
	{"APTHOOK_ONSLEEP",   APTHOOK_ONSLEEP  },
	/***
	@field APTHOOK_ONWAKEUP
	*/
	{"APTHOOK_ONWAKEUP",  APTHOOK_ONWAKEUP },
	/***
	@field APTHOOK_ONEXIT
	*/
	{"APTHOOK_ONEXIT",    APTHOOK_ONEXIT   },
	/***
	@field APTHOOK_COUNT
	*/
	{"APTHOOK_COUNT",     APTHOOK_COUNT    },
	{NULL, 0}
};

int luaopen_apt_lib(lua_State *L) {
	aptInit();
	
	luaL_newlib(L, apt_lib);
	
	for (int i = 0; apt_constants[i].name; i++) {
		lua_pushinteger(L, apt_constants[i].value);
		lua_setfield(L, -2, apt_constants[i].name);
	}
	
	return 1;
}

void load_apt_lib(lua_State *L) {
	luaL_requiref(L, "ctr.apt", luaopen_apt_lib, false);
}

void unload_apt_lib(lua_State *L) {
	aptExit();
}