3dbrew

Services API: Difference between revisions

← Older edit
No edit summary
ElementW (talk | contribs)
164 edits
m Replace service links with new Template:Service
 
(35 intermediate revisions by 14 users not shown)
Line 1: Line 1:
Nintendo provides application developers with an API, which behind the scenes communicate with certain services. Services in this sense are system processes running in the background which wait for incoming requests. When a process wants to communicate with a service, it first needs to get a handle to the named service, and then it can communicate with the service via interprocess communication. Each service has a name up to 8 characters, for example "nim:u".
Nintendo provides application developers with an API, which communicate with certain services. Services, in this sense, are [[Title_list#00040130_-_System_Modules|system processes running in the background]] which wait for incoming requests. When a process wants to communicate with a service, it first needs to get a handle to the named service, and then it can communicate with the service via interprocess communication. Each service has a name up to 8 characters, for example {{Service|nim:u}}.


Handles for services are retrieved from the service manager port, "srv:". Services are an abstraction of ports, they operate the same way except regular ports can have their handles retrieved directly from a SVC.
Handles for services are retrieved from the [[Services|service manager port]], <code>srv:</code>. Services are an abstraction of ports, they operate the same way except regular ports can have their handles retrieved directly from a SVC.


For a description of how commands and arguments are passed to services, see [[IPC Command Structure]].
For a description of how commands and arguments are passed to services, see [[IPC Command Structure]].


List of services:
List of services (grouped by the process which provides them):
* [[Filesystem services‎]]
{| class="wikitable" border="1"
* [[Process Services‎]]
|-
* [[PXI Services‎]]
!  Old3ds
* [[Application Manager Services]]
!  Services
* [[Process Manager Services]]
!  Service names
* [[NIM Services]]
! scope="col" width="200" |  Notes
* [[Config Services]]
|-
* [[NS|NS and APT Services]]
| style="background: green" | Yes
* [[RO Services]]
| [[Filesystem services‎]]
* [[NDM Services]]
| {{Service|fs:USER}}, {{Service|fs:LDR}}, {{Service|fs:REG}}
* [[CSND Services]]
| USER: normal applications and system modules, LDR: loader, REG: register
* [[DSP Services]]
|-
* [[GSP Services]]
| style="background: green" | Yes
* [[IR Services]]
| [[Process Services‎]]
* [[I2C Services]]
| {{Service|ps:ps}}
* [[GPIO Services]]
|
* [[HID Services]]
|-
* [[PTM Services]]
| style="background: green" | Yes
* [[NWM Services]]
| [[PXI Services‎]]
* [[HTTP Services]]
| {{Service|PxiFS0}}, {{Service|PxiFS1}}, {{Service|PxiFSB}}, {{Service|PxiFSR}}, {{Service|PxiPM}}, {{Service|pxi:am9}}, {{Service|pxi:dev}}, {{Service|pxi:mc}}, {{Service|pxi:ps9}}
* [[SSL Services]]
|
* [[Socket Services]]
|-
* [[AC Services]]
| style="background: green" | Yes
* [[Friend Services]]
| [[Application Manager Services]]
* [[PDN Services]]
| {{Service|am:app}}, {{Service|am:net}}, {{Service|am:u}}, {{Service|am:sys}}, {{Service|am:pipe}}
* [[SPI Services]]
| app: am for applications, net: network installation ([[NIM_Services|nim]]), u: local installation, sys: am for system titles, pipe: not an actual port (internally used to represent the [[Application_Manager_Services#File_service|FSFile-like interface]])
* [[Loader Services]]
|-
* [[MCU Services]]
| style="background: green" | Yes
* [[MIC Services]]
| [[Process Manager Services]]
 
| {{Service|pm:app}}, {{Service|pm:dbg}}
[[New_3DS]]-only services:
| app: launching titles, dbg: launching titles with debugging enabled
* [[NFC Services]]
|-
* [[MVD Services]]
| style="background: green" | Yes
* [[QTM Services]]
| [[NIM Services]]
| {{Service|nim:aoc}}, {{Service|nim:ndm}}, {{Service|nim:s}}, {{Service|nim:u}}
| aoc: DLC, ndm: for [[NDM Services|ndm]], s: for eShop, u: for updater
|-
| style="background: green" | Yes
| [[Config Services]]
| {{Service|cfg:u}}, {{Service|cfg:s}}, {{Service|cfg:i}}, {{Service|cfg:nor}}
| u: for user, s: for system, i: for initialization/formatting, nor: accesses wifi SPI flash
|-
| style="background: green" | Yes
| [[NS|NS and APT Services]]
| {{Service|ns:s}}, {{Service|ns:p}}, {{Service|ns:c}}, {{Service|APT:A}}, {{Service|APT:S}}, {{Service|APT:U}}
| ns:s: for system, ns:p: power (shutdown/reboot), ns:c: ?, APT:A: application, APT:S: system, APT:U: user
|-
| style="background: green" | Yes
| [[RO Services]]
| {{Service|ldr:ro}}
|
|-
| style="background: green" | Yes
| [[NDM Services]]
| {{Service|ndm:u}}
|
|-
| style="background: green" | Yes
| [[CSND Services]]
| {{Service|csnd:SND}}
|
|-
| style="background: green" | Yes
| [[Camera Services]]
| {{Service|cam:u}}, {{Service|y2r:u}}, {{Service|cam:s}}, {{Service|cam:c}}, {{Service|cam:q}} (New3DS only)
|
|-
| style="background: green" | Yes
| [[Codec Services]]
| {{Service|cdc:HID}}, {{Service|cdc:MIC}}, {{Service|cdc:CSN}}, {{Service|cdc:DSP}}, {{Service|cdc:LGY}}, {{Service|cdc:CHK}}
| HID: human interface device, MIC: microphone, CSN: for [[CSND_Services|csnd]]?, DSP: for [[DSP_Services|dsp]]?, LGY: legacy (some kind of backwards compat?), CHK: ?
|-
| style="background: green" | Yes
| [[DLP Services]]
| {{Service|dlp:CLNT}}, {{Service|dlp:FKCL}}, {{Service|dlp:SRVR}}
| CLNT: client, FKCL: fake client, SRVR: server
|-
| style="background: green" | Yes
| [[DSP Services]]
| {{Service|dsp::DSP}}
|
|-
| style="background: green" | Yes
| [[GSP Services]]
| {{Service|gsp::Lcd}}, {{Service|gsp::Gpu}}
| Lcd: LCD control, Gpu: GPU control
|-
| style="background: green" | Yes
| [[BOSS Services]]
| {{Service|boss:U}}, {{Service|boss:P}}, {{Service|boss:M}}
| U: user, P: privileged, M: for [[NDM Services|ndm]]
|-
| style="background: green" | Yes
| [[CECD Services]]
| {{Service|cecd:u}}, {{Service|cecd:s}}, {{Service|cecd:ndm}}
| u: user, s: system, ndm: for [[NDM Services|ndm]]
|-
| style="background: green" | Yes
| [[IR Services]]
| {{Service|ir:u}}, {{Service|ir:USER}}, {{Service|ir:rst}}
|
|-
| style="background: green" | Yes
| [[I2C Services]]
| {{Service|i2c::MCU}}, {{Service|i2c::CAM}}, {{Service|i2c::LCD}}, {{Service|i2c::DEB}}, {{Service|i2c::HID}}, {{Service|i2c::IR}}, {{Service|i2c::EEP}}, {{Service|i2c::NFC}}, {{Service|i2c::QTM}}
|
|-
| style="background: green" | Yes
| [[GPIO Services]]
| {{Service|gpio:CDC}}, {{Service|gpio:MCU}}, {{Service|gpio:HID}}, {{Service|gpio:NWM}}, {{Service|gpio:IR}}, {{Service|gpio:NFC}}, {{Service|gpio:QTM}}
|
|-
| style="background: green" | Yes
| [[HID Services]]
| {{Service|hid:NFC}}, {{Service|hid:QTM}}, {{Service|hid:SPVR}}, {{Service|hid:USER}}
| NFC: near-field communication (amiibo), QTM: head tracking device (related to [[QTM_Services|QTM Services]])?, SPVR: system privileged?
|-
| style="background: green" | Yes
| [[PTM Services]]
| {{Service|ptm:gets}}, {{Service|ptm:play}}, {{Service|ptm:s}}, {{Service|ptm:sets}}, {{Service|ptm:sysm}}, {{Service|ptm:u}}
| gets: get system time, play: play history, s: system, sets: set system time, sysm: system menu (homemenu/testmenu), u: user
|-
| style="background: green" | Yes
| [[NWM Services]]
| {{Service|nwm::CEC}}, {{Service|nwm::EXT}}, {{Service|nwm::INF}}, {{Service|nwm::SAP}}, {{Service|nwm::SOC}}, {{Service|nwm::TST}}, {{Service|nwm::UDS}}
| CEC: streetpass, EXT: ?, INF: infrastructure, SAP: ?, SOC: socket, UDS: local WLAN, TST: ?
|-
| style="background: green" | Yes
| [[HTTP Services]]
| {{Service|http:C}}
| C: connection
|-
| style="background: green" | Yes
| [[SSL Services]]
| {{Service|ssl:C}}
| C: connection
|-
| style="background: green" | Yes
| [[Socket Services]]
| {{Service|soc:P}}, {{Service|soc:U}}
| P: privileged, U: user
|-
| style="background: green" | Yes
| [[AC Services]]
| {{Service|ac:i}}, {{Service|ac:u}}
| i: internal, u: user
|-
| style="background: green" | Yes
| [[Friend Services]]
| {{Service|frd:a}}, {{Service|frd:n}}, {{Service|frd:u}}
| a: admin, n: for [[NDM Services|ndm]], u: user
|-
| style="background: green" | Yes
| [[News Services]]
| {{Service|news:s}}, {{Service|news:u}}
| s: system, u:user
|-
| style="background: green" | Yes
| [[PDN Services]]
| {{Service|pdn:s}}, {{Service|pdn:d}}, {{Service|pdn:i}}, {{Service|pdn:g}}, {{Service|pdn:c}}
|
|-
| style="background: green" | Yes
| [[SPI Services]]
| {{Service|SPI::NOR}}, {{Service|SPI::CD2}}, {{Service|SPI::CS2}}, {{Service|SPI::CS3}}, {{Service|SPI::DEF}}
|
|-
| style="background: green" | Yes
| [[Loader Services]]
| {{Service|Loader}}
|
|-
| style="background: green" | Yes
| [[MCU Services]]
| {{Service|mcu::CAM}}, {{Service|mcu::GPU}}, {{Service|mcu::HID}}, {{Service|mcu::RTC}}, {{Service|mcu::SND}}, {{Service|mcu::NWM}}, {{Service|mcu::HWC}}, {{Service|mcu::PLS}}, {{Service|mcu::CDC}}
|
|-
| style="background: green" | Yes
| [[MIC Services]]
| {{Service|mic:u}}
|
|-
| style="background: green" | Yes
| [[ACT Services]]
| {{Service|act:a}}, {{Service|act:u}}
| a: admin, u: user
|-
| style="background: green" | Yes
| [[MP Services]]
| {{Service|mp:u}}
|
|-
| style="background: green" | Yes
| [[NFC Services]]
| {{Service|nfc:dev}}, {{Service|nfc:m}}, {{Service|nfc:p}}, {{Service|nfc:r}}, {{Service|nfc:s}}, {{Service|nfc:u}}
| dev: developer, m: ? p: passthrough?, r: raw?, s: system, u: user
|-
| style="background: red" | No
| [[MVD Services]]
|
|
|-
| style="background: red" | No
| [[QTM Services]]
|
|
|}


List of PXI services:
List of PXI services:
Retrieved from "https://www.3dbrew.org/wiki/Services_API"