WiiBrew

Changes

/dev/di (view source)

Revision as of 22:39, 5 November 2019

5,093 bytes added ,  22:39, 5 November 2019
Document version history
Line 1: Line 1:  
{{seealso|Hardware/Drive Interface}}
 
{{seealso|Hardware/Drive Interface}}
   −
'''/dev/di''' is the IOS driver used to control the disc drive.  This documentation is based on the most recent version (dated Jun  3 2009 07:49:09 and included in [[IOS58]] and [[IOS80]]).  Names are based on function names found in Nintendo titles (which print an error message including the name if the Ioctl or Ioctlv fails).  DVDLowRequestAudioStatus and DVDLowAudioStream are not found in Wii titles, but the names can be found in [https://wiki.dolphin-emu.org/index.php?title=Ships_with_Debugging_Symbols debug symbols included in various Gamecube games].
+
'''/dev/di''' is the [[IOS]] driver used to control the disc drive.  This documentation is mostly based on the most recent version (dated Jun  3 2009 07:49:09 and included in [[IOS58]] and [[IOS80]]).  Names are based on function names found in Nintendo titles (which print an error message including the name if the Ioctl or Ioctlv fails).  DVDLowRequestAudioStatus and DVDLowAudioStream are not found in Wii titles, but the names can be found in [https://wiki.dolphin-emu.org/index.php?title=Ships_with_Debugging_Symbols debug symbols included in various Gamecube games].
    
The input to all /dev/di commands (other than enable DVD video) is the following struct, which must be sized 0x20 and aligned 4:
 
The input to all /dev/di commands (other than enable DVD video) is the following struct, which must be sized 0x20 and aligned 4:
Line 73: Line 73:  
  | Bad argument
 
  | Bad argument
 
  |}
 
  |}
 +
 +
== Version history ==
 +
 +
There are '''10''' known versions of the DI driver found in various [[IOS History|IOS versions]], based on the IOS versions still present on NUS.  It is quite likely that there are additional changes not noted here.
 +
 +
=== Oct  5 2006 17:41:21 ===
 +
 +
Used in monolithic IOS versions (those prior to IOS28, obviously excluding stubbed IOS versions).  As these versions have only a single ELF file for all modules, there is no single hash for the DI driver.
 +
 +
In this version, [[#0x8D DVDLowUnencryptedRead|0x8D DVDLowUnencryptedRead]] only accepted the start and end being between 0 and 0x14000, and IOCtls [[#0x95 DVDLowGetStatusRegister|0x95 DVDLowGetStatusRegister]] and [[#0x96 DVDLowGetControlRegister|0x96 DVDLowGetControlRegister]] and all IOCtlVs other than [[#0x8B DVDLowOpenPartition|0x8B DVDLowOpenPartition]] did not exist.  [[#0x87|0x87]] and [[#0x7F DVDLowSetSpinupFlag|0x7F DVDLowSetSpinupFlag]] did exist as the current stubs.
 +
 +
=== Jun  8 2007 18:17:09 ===
 +
 +
Used by early builds of certain IOS versions.  No current version of IOS uses this build.
 +
 +
* [[IOS30]] prior to v2816 (stubbing)
 +
* [[IOS31]] prior to v3088
 +
* [[IOS33]] prior to v2832 (v1040 only)
 +
* [[IOS34]] prior to v3087 (v1039 only)
 +
* [[IOS35]] prior to v3088 (v1040 only)
 +
* [[IOS36]] prior to v3090 (v1042 only)
 +
* [[IOS37]] prior to v3609 (v2070 only)
 +
 +
This version adds [[#0x95 DVDLowGetStatusRegister|0x95 DVDLowGetStatusRegister]], but [[#0x96 DVDLowGetControlRegister|0x96 DVDLowGetControlRegister]] is still missing.  It also allows all 3 ranges in [[#0x8D DVDLowUnencryptedRead|0x8D DVDLowUnencryptedRead]].  Finally, it adds <em>all</em> of the IOCtlVs (which are also exposed as IOCtls): [[#0x90 DVDLowGetNoDiscOpenPartitionParams|0x90 DVDLowGetNoDiscOpenPartitionParams]], [[#0x91 DVDLowNoDiscOpenPartition|0x91 DVDLowNoDiscOpenPartition]], [[#0x92 DVDLowGetNoDiscBufferSizes|0x92 DVDLowGetNoDiscBufferSizes]], [[#0x93 DVDLowOpenPartitionWithTmdAndTicket|0x93 DVDLowOpenPartitionWithTmdAndTicket]], and [[#0x94 DVDLowOpenPartitionWithTmdAndTicketView|0x94 DVDLowOpenPartitionWithTmdAndTicketView]].
 +
 +
=== Jul 11 2008 14:34:27 ===
 +
 +
Used by several IOS builds:
 +
 +
* [[IOS37]] starting with v2816
 +
* [[IOS50]] v4889 (v5120 is a stub)
 +
* [[IOS51]] v4633 (v4864 is a stub)
 +
* [[IOS52]] v5661 (v5888 is a stub)
 +
* [[IOS53]] (all versions)
 +
* [[IOS55]] (all versions)
 +
 +
Adds [[#0x96 DVDLowGetControlRegister|0x96 DVDLowGetControlRegister]].  Removes IOCtlVs [[#0x90 DVDLowGetNoDiscOpenPartitionParams|0x90 DVDLowGetNoDiscOpenPartitionParams]], [[#0x91 DVDLowNoDiscOpenPartition|0x91 DVDLowNoDiscOpenPartition]], and [[#0x92 DVDLowGetNoDiscBufferSizes|0x92 DVDLowGetNoDiscBufferSizes]].
 +
 +
=== Jul 14 2008 19:25:32 ===
 +
 +
Replaces the Jun 8 build for IOS versions other than IOS37:
 +
 +
* [[IOS31]] starting with v3088
 +
* [[IOS33]] starting with v2832
 +
* [[IOS34]] starting with v3087
 +
* [[IOS35]] starting with v3088
 +
* [[IOS36]] starting with v3090
 +
 +
Does not have [[#0x96 DVDLowGetControlRegister|0x96 DVDLowGetControlRegister]].  Also removes IOCtlVs [[#0x90 DVDLowGetNoDiscOpenPartitionParams|0x90]], [[#0x91 DVDLowNoDiscOpenPartition|0x91]], and [[#0x92 DVDLowGetNoDiscBufferSizes|0x92]].
 +
 +
=== Jul 14 2008 19:32:38 ===
 +
 +
Only found in [[IOS28]] (which is the first build that split things into modules).  There are negligbable differences from the build that's 7 minutes earlier; all commands match.
 +
 +
=== Jul 24 2008 00:30:13 ===
 +
 +
Only found in [[IOS48]].  Has both [[#0x95 DVDLowGetStatusRegister|0x95]] and [[#0x96 DVDLowGetControlRegister|0x96]]; does not have [[#0x90 DVDLowGetNoDiscOpenPartitionParams|0x90]], [[#0x91 DVDLowNoDiscOpenPartition|0x91]], and [[#0x92 DVDLowGetNoDiscBufferSizes|0x92]].
 +
 +
=== Jul 24 2008 20:08:45 ===
 +
 +
Only found in [[IOS38]].  Has [[#0x95 DVDLowGetStatusRegister|0x95]] but not [[#0x96 DVDLowGetControlRegister|0x96]]; also does not have [[#0x90 DVDLowGetNoDiscOpenPartitionParams|0x90]], [[#0x91 DVDLowNoDiscOpenPartition|0x91]], and [[#0x92 DVDLowGetNoDiscBufferSizes|0x92]].
 +
 +
=== Nov 24 2008 15:39:09 ===
 +
 +
Used in the first builds of a few IOS versions:
 +
 +
* [[IOS56]] v4890 only
 +
* [[IOS57]] v5404 only
 +
* [[IOS60]] v6174 only (other version is a stub)
 +
* [[IOS61]] v4890 only
 +
 +
Has both [[#0x95 DVDLowGetStatusRegister|0x95]] and [[#0x96 DVDLowGetControlRegister|0x96]]; does not have [[#0x90 DVDLowGetNoDiscOpenPartitionParams|0x90]], [[#0x91 DVDLowNoDiscOpenPartition|0x91]], and [[#0x92 DVDLowGetNoDiscBufferSizes|0x92]].
 +
 +
=== Dec 24 2008 13:51:06 ===
 +
 +
Used in all versions of [[IOS41]], [[IOS43]], [[IOS45]], and [[IOS46]].  Has both [[#0x95 DVDLowGetStatusRegister|0x95]] and [[#0x96 DVDLowGetControlRegister|0x96]]; does not have [[#0x90 DVDLowGetNoDiscOpenPartitionParams|0x90]], [[#0x91 DVDLowNoDiscOpenPartition|0x91]], and [[#0x92 DVDLowGetNoDiscBufferSizes|0x92]].
 +
 +
=== Jun  3 2009 07:49:09 ===
 +
 +
Used in several IOS versions, and also updated versions of builds that used the Nov 24 2008 version.
 +
 +
* [[IOS56]] starting with v5405
 +
* [[IOS57]] starting with v5661
 +
* [[IOS61]] starting with v5405
 +
* [[IOS70]] v6687 (v6912 is a stub)
 +
* [[IOS80]] in all versions
    
== IoctlVs ==
 
== IoctlVs ==
Pokechu22
303

edits

Retrieved from "https://wiibrew.org/wiki/Special:MobileDiff/108005"