Changes

Jump to navigation Jump to search
1,997 bytes added ,  22:43, 15 June 2019
=nim=
This is "nn::nim::detail::INetworkInstallManager".
! Cmd || Name
|-
| 0 || CreateSystemUpdateTask|-| 1 || [[#DestroySystemUpdateTask]]|-| 2 || [[#ListSystemUpdateTask]]|-| 3 || RequestSystemUpdateTaskRun|-| 4 || [[#GetSystemUpdateTaskInfo]]|-| 5 || [[#CommitSystemUpdateTask]]|-| 6 || CreateNetworkInstallTask|-| 7 || DestroyNetworkInstallTask|-| 8 || ListNetworkInstallTask|-| 9 || RequestNetworkInstallTaskRun|-| 10 || GetNetworkInstallTaskInfo|-| 11 || CommitNetworkInstallTask|-| 12 || RequestLatestSystemUpdateMeta|-| 14 || ListApplicationNetworkInstallTask|-| 15 || ListNetworkInstallTaskContentMeta|-| 16 || RequestLatestVersion|-| 17 || SetNetworkInstallTaskAttribute|-| 18 || AddNetworkInstallTaskContentMeta|-| 19 || [[#GetDownloadedSystemDataPath]]|-| 20 || CalculateNetworkInstallTaskRequiredSize|-| 21 || [[#IsExFatDriverIncluded]]|-| 22 || GetBackgroundDownloadStressTaskInfo|-| 23 || [2.0.0+] RequestDeviceAuthenticationToken|-| 24 || [2.0.0+] RequestGameCardRegistrationStatus|-| 25 || [2.0.0+] RequestRegisterGameCard|-| 26 || [2.0.0+] RequestRegisterNotificationToken|-| 27 || [2.0.0+] RequestDownloadTaskList|-| 28 || [2.0.0+] RequestApplicationControl|-| 29 || [2.0.0+] RequestLatestApplicationControl|-| 30 || [2.0.0+] RequestVersionList|-| 31 || [2.0.0+] CreateApplyDeltaTask|-| 32 || [2.0.0+] DestroyApplyDeltaTask|-| 33 || [2.0.0+] ListApplicationApplyDeltaTask|-| 34 || [2.0.0+] RequestApplyDeltaTaskRun|-| 35 || [2.0.0+] GetApplyDeltaTaskInfo|-| 36 || [2.0.0+] ListApplyDeltaTask|-| 37 || [2.0.0+] CommitApplyDeltaTask|-| 38 || [2.0.0+] CalculateApplyDeltaTaskRequiredSize|-| 39 || [2.0.0+] PrepareShutdown|-| 40 || [2.0.0+] ListApplyDeltaTask2|-| 41 || [2.0.0+] ClearNotEnoughSpaceStateOfApplyDeltaTask|-| 42 || [3.0.0+]|-| 43 || [3.0.0+]|-| 44 || [3.0.0+]|-| 45 || [3.0.0+]|-| 46 || [3.0.0+]|-| 47 || [4.0.0+]|-| 48 || [4.0.0+]|-| 49 || [4.0.0+]|-| 50 || [4.0.0+]|-| 51 || [4.0.0+]|-| 52 || [4.0.0+]|-| 53 || [4.0.0+]|-| 54 || [4.0.0+]|-| 55 || [4.0.0+]|-| 56 || [4.0.0+]|-| 57 || [4.0.0+]|-| 58 || [4.0.0+]|-| 59 || [4.0.0+]|-| 60 || [4.0.0+]|-| 61 || [4.0.0+]|-| 62 || [4.0.0+]|-| 63 || [4.0.0+]|-| 64 || [4.0.0+]|-| 65 || [4.0.0+]|-| 66 || [4.0.0+]|-| 67 || [4.0.0+]|-| 68 || [4.0.0+]|-| 69 || [4.0.0+]|-| 70 || [4.0.0+]|-| 71 || [4.0.0+]|-| 72 || [4.0.0+]|-| 73 || [4.0.0+]|-| 74 || [4.0.0+]|-| 75 || [4.0.0+]|-| 76 || [4.0.0+]|-| 77 || [4.0.0+]|-| 78 || [4.0.0+]|-| 79 || [4.0.0+]|-| 80 || [4.0.0+]|-| 81 || [4.0.0+]|-| 82 || [4.0.0+]|-| 83 || [4.0.0+]|-| 84 || [5.0.0+]|-| 85 || [5.0.0+]|-| 86 || [5.0.0+]|-| 87 || [6.0.0+]|-| 88 || [6.0.0+]|-| 89 || [6.0.0+]|-| 90 || [6.0.0+]|-| 91 || [6.0.0+]|-| 92 || [6.0.0+]|-| 93 || [6.0.0+]|-| 94 || [6.0.0+]|-| 95 || [6.0.0+]|-| 96 || [6.0.0+]|-| 97 || [6.0.0+]|-| 98 || [6.0.0+]
|-
| 2 99 || [7.0.0+]
|}
[3.0.0+] GetSystemUpdateTaskInfo now returns an additional 0x10-bytes of output. GetNetworkInstallTaskInfo now returns an additional 0x18-bytes of output. GetApplyDeltaTaskInfo now returns an additional 0x10-bytes of output. [5.0.0+] GetSystemUpdateTaskInfo now returns an additional 8-bytes of output. RequestGameCardRegistrationStatus/RequestRegisterGameCard removed 8-bytes of input, and now takes an additional type-0x5 input buffer. [8.0.0+] Cmd76 now takes an additional 0x8-bytes of input. ==Cmd1DestroySystemUpdateTask ==Takes an input [[#SystemUpdateTask]], no output. == ListSystemUpdateTask ==Takes a 0x10type-byte 0x6 output buffer, for an array of [[#SystemUpdateTask]]. Returns an u32 for total output entries. == GetSystemUpdateTaskInfo ==Takes an input [[#SystemUpdateTask]], returns an output [[#SystemUpdateTaskInfo]]. == CommitSystemUpdateTask ==Takes an input struct[[#SystemUpdateTask]], from no output. == GetDownloadedSystemDataPath ==Takes an input u64 titleID, a [[#SystemUpdateTask]], and an type-0x16 output buffer containing the [[Filesystem_services|ContentPath]]. Gets the FS ContentPath for the specified task and title. == IsExFatDriverIncluded ==Takes an input [[#SystemUpdateTask]], returns an output of cmd2u8 bool flag.
==Cmd2SystemUpdateTask ==Takes This is a type-0x6 output buffer, for an array of 0x10-byte entries. Returns an u32 for total output entriesstruct.
Doesn't return anything on == SystemUpdateTaskInfo ==This is a v2.1 system where sysupdate domains are blocked0x28-byte struct.
=nim:shp=
This is "nn::nim::detail::IShopServiceManager".
{| class=ntc"wikitable" border="1"|-! Cmd || Name|-| 0 || RequestDeviceAuthenticationToken|-| 1 || [3.0.0+] RequestCachedDeviceAuthenticationToken|-| 100 || RequestRegisterDeviceAccount|-| 101 || RequestUnregisterDeviceAccount|-| 102 || RequestDeviceAccountStatus|-| 103 || GetDeviceAccountInfo|-| 104 || RequestDeviceRegistrationInfo|-| 105 || RequestTransferDeviceAccount|-| 106 || [3.0.0+] RequestSyncRegistration|-| 107 || [3.0.0+] IsOwnDeviceId|-| 200 || RequestRegisterNotificationToken|-| 300 || RequestUnlinkDevice|-| 301 || RequestUnlinkDeviceIntegrated|-| 302 || RequestLinkDevice|-| 303 || HasDeviceLink|-| 304 || [4.0.0+] RequestUnlinkDeviceAll|-| 305 || [4.0.0+] RequestCreateVirtualAccount|-| 306 || [4.0.0+] RequestDeviceLinkStatus|-| 400 || GetAccountByVirtualAccount|-| 401 || [6.0.0+]|-| 500 || RequestSyncTicket|-| 501 || RequestDownloadTicket|-| 502 || [4.0.0+] RequestDownloadTicketForPrepurchasedContents. [6.0.0+]: Now takes an additional 4-bytes of input.|} = nim:eca =This is "nn::ntcnim::detail::serviceIShopServiceAccessServerInterface". This was added with [5.0.0+]. {| class="wikitable" border="1"|-! Cmd || Name|-| 0 || CreateServerInterface|-| 1 || [6.0.0+] RefreshDebugAvailability|-| 2 || [6.0.0+] ClearDebugResponse|-| 3 || [6.0.0+] RegisterDebugResponse|} == IShopServiceAccessServer ==This is "nn::nim::detail::IShopServiceAccessServer". This was added with [5.0.0+]. {| class="wikitable" border="1"|-! Cmd || Name|-| 0 || CreateAccessorInterface|} === IShopServiceAccessor ===This is "nn::nim::detail::IShopServiceAccessor". This was added with [5.0.0+]. {| class="wikitable" border="1"|-! Cmd || Name|-| 0 || CreateAsyncInterface|} ==== IShopServiceAsync ====This is "nn::nim:IStaticService:detail::IShopServiceAsync". This was added with [5.0.0+].
Presumably Network Time Sync?{| class="wikitable" border="1"|-! Cmd || Name|-| 0 || Cancel|-| 1 || GetSize|-| 2 || Read|-| 3 || GetErrorCode|-| 4 || Request|-| 5 || Prepare|}
Network-time-sync uses the = nim:ecas =This is "<...>/timenn::nim::detail::IShopServiceAccessSystemInterface" HTTPS URL listed in the below Network section. This just returns an UTC Unix time string.
=Network=* <nowiki>https://sun.hac.%%.d4c.nintendo.net/v1/system_update_meta?device_id=%016llx</nowiki>* <nowiki>https://aqua.hac.%%.d4c.nintendo.net/required_system_update_meta?device_id=%016llx</nowiki>* <nowiki>https://%s.hac.%%.d4c.nintendo.net/t/%c/%016llx/%u?device_id=%016llx</nowiki> Returns content like the below URL. This is the content for [was added with [NCA]]-type0. See below for %c. %016llx is titleID, %u is title-version.* <nowiki>https://%s.hac.%%.d4c.nintendo.net/c/%c/%s</nowiki> Used for downloading content. First %s is atumn or atum. %c is one of: 'c', 'a', or 's'. %s is just the hex-string NcaId. The server also returns two HTTP headers: "X-Nintendo-Content-Hash: {entire lowercase hex-string of the content SHA256 hash}" and "X-Nintendo-Content-ID: {lowercase hex-string for NcaId}"* <nowiki>https://superfly7.hac0.%%.d4c.nintendo.net/v1/t/%016llx/dv</nowiki> %016llx is titleID, only for eShop titles it appears. Returns .json title-info.* <nowiki>https://superfly.hac.%%.d4c.nintendo.net/v1/a/%016llx/dv</nowiki> %016llx is titleID, only for eShop titles it appears. Output is similar to above URL.* <nowiki>https://aauth-%.ndas.srv.nintendo.net/v1/time</nowiki>* <nowiki>https://beach.hac.%.eshop.nintendo.net/v1/rom_cards?application_id=%016llx&rom_card_cert=%s</nowiki>* <nowiki>https://beach.hac.%.eshop.nintendo.net/v1/rom_cards/register?application_id=%016llx&rom_card_cert=%s&expected_gold_point=%d</nowiki>* <nowiki>https://beach.hac.%.eshop.nintendo.net/v1/my/devices/hac/link?lang=en</nowiki>* <nowiki>https://beach.hac.%.eshop.nintendo.net/v1/my/virtual_account?lang=en</nowiki>* <nowiki>https://tagaya.hac.%.eshop.nintendo.net/tagaya/hac_versionlist</nowiki>* ...* <nowiki>"https://dauth-%.ndas.srv.nintendo.net/v1/device_auth_token"</nowiki> CURLOPT_POSTFIELDS is set to the output from: snprintf(..., "system_version=%08x&client_id=%s", <byte-swapped first 3 bytes from [[System_Version_Title]0+] loaded via [[Settings_services|settings]] cmd>, "<hard-coded hex string>");* <nowiki>https://ecs-%.hac.shop.nintendo.net/ecs/services/rest/AccountGetETickets</nowiki>* <nowiki>https://ecs-%.hac.shop.nintendo.net/ecs/services/rest/GetAccountStatus</nowiki>* <nowiki>https://ias-%.hac.shop.nintendo.net/ias/services/rest/Register</nowiki>* <nowiki>https://ias-%.hac.shop.nintendo.net/ias/services/rest/GetChallenge</nowiki>* <nowiki>https://ias-%.hac.shop.nintendo.net/ias/services/rest/Unregister</nowiki>* <nowiki>https://ias-%.hac.shop.nintendo.net/ias/services/rest/GetRegistrationInfo</nowiki>* <nowiki>https://ias-%.hac.shop.nintendo.net/ias/services/rest/CompleteETicketSync</nowiki>* <nowiki>https://ias-%.hac.shop.nintendo.net/ias/services/rest/AccountTransfer</nowiki>* <nowiki>https://ias-%.hac.shop.nintendo.net/ias/services/rest/SyncRegistration</nowiki>
These are not accessible without the required TLS client cert+privk, minus the time URL which can be accessed without any client cert+privk at all.{| class="wikitable" border="1"|-! Cmd || Name|-| 0 || RegisterSpecialClient|-| 1 || UnregisterSpecialClient|}
The returned content data from CDN, for both system-titles and eShop-titles, = ntc =This is identical to the data readable by [[Content_Manager_services#ReadEntryRaw]]"nn::ntc::detail::service::IStaticService".
While atumn seems to be for system-titles, and atum for eShop titles, the latter titles are accessible fine with atumn(with {| class="wikitable" border="/t/1" for NCA|-type0 at least)! Cmd || Name|-| 0 || OpenEnsureNetworkClockAvailabilityService|-| 100 || [3.0.0+] SuspendAutonomicTimeCorrection|-| 101 || [3.0.0+] ResumeAutonomicTimeCorrection|}
'a' is used when an input u8 is not 0x3, otherwise 's' is used. This is [[Content_Manager_services#Title_Types|titleNetwork-time-type]]? A seperate function using sync uses the "<...>/c/time" HTTPS URL is hard-coded to use 'c'listed in the below Network section. This appears to match 's' usage attempts: the only URL that returned actual data with 's' was with titleID 0100000000000816just returns an UTC Unix time string.
As of June 30, 2017, accessing old content via the atumn == IEnsureNetworkClockAvailabilityService ==This is "/c/nn::ntc::detail::service::IEnsureNetworkClockAvailabilityService" and "/t/" URLs works fine.
Going by strings in NIM, it appears SOAP isn't used anymore{| class="wikitable" border="1"|-! Cmd || Name|-| 0 || StartTask|-| 1 || GetFinishNotificationEvent|-| 2 || GetResult|-| 3 || Cancel|-| 4 || IsProcessing|-| 5 || [3. ecs appears to use REST API?0.0+] GetServerTime|}
== User-Agent =IAsyncValue =NIM generates two User-Agent strings: snprintf(..., This is "User-Agentnn: NintendoSDK Firmware/%s-%u (platform:%s; didnim:%016llx; eid:%s)", <string at [[System_Version_Title|sysver]]+0x68>, {u32 from [[System_Version_Title|sysver]]+4}, "NX", DeviceId, {[[NSD_services|NSD]] cmd11 output}); snprintf(..., "User-Agentdetail: NintendoSDK Firmware/%s-%u (platform:%s; eid:%s)IAsyncValue", <string at [[System_Version_Title|sysver]]+0x68>, {u32 from [[System_Version_Title|sysver]]+4}, "NX", DeviceId, {[[NSD_services|NSD]] cmd11 output});.
Where the 64bit DeviceId is parsed from the 0x10{| class="wikitable" border="1"|-bytes at outbuf+0xC6 from [[Settings_services! Cmd || Name|-| 0 || |-| 1 || |-|set:cal]] GetDeviceCert(DeviceCert_certname+2, aka where the hex string for the DeviceId is)|| |-| 3 || [4.0.0+]|}
== sun =IAsyncResult =NIM sends a HTTP GET with the sun URL listed above to get the title-listing of the latest system-titles, as .json. The deviceid in the URL This is the same one in the above User-Agent section. HTTP header "Acceptnn::nim::detail::application/jsonIAsyncResult" is sent in the request.
The response is json with a {| class="system_update_metaswikitable" block, containing border="title_id1" and "title_version" entries|-! Cmd || Name|-| 0 || |-| 1 || |-| 2 || [4. The actual server response only contains 1 title0.0+]|}
Example, from 2= IAsyncProgressResult =This is "nn::nim::detail::IAsyncProgressResult".0 system:
<code>{| class="timestampwikitable":REDACTED-TIMESTSAMP,border="system_update_metas1":|-! Cmd || Name|-| 0 || |-| 1 || |-| 2 || |-| 3 || [{"title_id":"0100000000000816","title_version":201327002}4.0.0+]|}</code>
== aqua =IAsyncData =The following response This is json from accessing the above aqua URL"nn::nim::detail::IAsyncData".
<code>{| class="contents_delivery_required_title_idwikitable": border="01000000000008161","contents_delivery_required_title_version": |-! Cmd || Name|-| 0 || |-| 1 || |-| 2 || |-| 3 || |-| 4 || |-| 5 || [4.0.0+]|}</code>
A while after [[3.0.0Category:Services]] release, the above title-version was changed to the one for v3.0("Last-Modified: Thu, 29 Jun 2017 00:00:04 GMT").

Navigation menu