View source for NUS

'''NUS''' (short for '''Nintendo Update Server''') is a set of HTTP servers used to serve [[System Update|updates]] for Nintendo's consoles. For the Wii and Wii U, this server is located at http://nus.cdn.shop.wii.com.

https://ccs.shop.wii.com suddenly went offline with no announcement around 2022/3/16 21:40 UTC. NUS clients have since modified to download using a different method, although Nintendo has since [https://web.archive.org/web/20220325012700/https://www.gamedeveloper.com/business/the-wii-shop-and-dsi-shop-are-offline-and-nobody-knows-why announced the maintenance]. There has been no further information from Nintendo, and the status reports on Nintendo's website still say everything is operational. The servers came back on July 6.

= Protocol =
The Wii uses user agent <code>wii libnup/1.0</code> for all requests.

== Query a list of titles ==
To query a list of titles, a SOAP request is sent to /nus/services/NetUpdateSOAP, with action urn:nus.wsapi.broadon.com/. The result is an XML structure containing all titles that require updating.

=== Request structure ===
'''GetSystemUpdateRequest''' xmlns=urn:nus.wsapi.broadon.com
:'''Version''' - always 1.0?
:'''MessageId''' - unknown
:'''DeviceId''' - unknown
:'''RegionId''' - USA, JAP, EUR, or KOR
:'''CountryCode''' - unknown
:Several '''TitleVersion''' structs:
::'''TitleId''' - 16-digit title ID in hex
::'''Version''' - decimal version
:'''Attribute''' - unknown
:'''AuditData''' - unknown

=== Response structure ===
'''GetSystemUpdateResponse''' xmlns=urn:nus.wsapi.broadon.com
:'''Version''' - same as version in request?
:'''MessageId''' - same as MessageId from client
:'''DeviceId''' - same as DeviceId from client
:'''ErrorCode''' - 0 on success
:'''ContentPrefixURL''' - always https://nus.cdn.shop.wii.com/ccs/download (HTTP before [[2.0rev03]])
:'''UncachedPrefixURL''' - always https://ccs.shop.wii.com/ccs/download (HTTP before 2.0rev03, this is the URL the Wii uses)
:Several '''TitleVersion''' structs:
::'''TitleId''' - 16-digit title ID in hex
::'''Version''' - latest title version available
::'''FsSize''' - size in bytes?
:'''UploadAuditData''' - unknown, possibly boolean?

== Download a TMD, ticket, or content ==
There are a few prefixes that point to NUS. HTTP and HTTPS do not matter.
* https://nus.cdn.shop.wii.com/ccs/download (does not seem to work)
* https://ccs.shop.wii.com/ccs/download
* https://ccs.cdn.c.shop.nintendowifi.net/ccs/download

These can be downloaded from <prefix>/<titleid>/<name>, where prefix is the base URL returned from the SOAP request, titleid is the title ID in hex, and name is one of three things:
* tmd - downloads the TMD for the latest version
* tmd.<version> - downloads the TMD for a given version
* cetk - downloads the ticket (free titles only)
* <contentid> - downloads a specific content

The TMDs and ticket are stored as contents with large IDs on the server. Information about these special content IDs is available on [https://dsibrew.org/wiki/Nintendo_CDN_Files DSiBrew].

[[Category:Online services]]