Changes

'''/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].

'''/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:

(DiIoctl) Note: This is normal for DVD software before 6-24

(DiIoctl) Note: This is normal for DVD software before 6-24

</pre></blockquote>

</pre></blockquote>

== Return values ==

== Return values ==

<li>0x83 DVDLowGetLength</li>

<li>0x83 DVDLowGetLength</li>

<li>0x84 Get DIIMMBUF</li>

<li>0x84 Get DIIMMBUF</li>

<li>0x85 DVDLowUnmaskCoverInterrupt</li>

<li>0x85 DVDLowMaskCoverInterrupt</li>

<li>0x86 DVDLowClearCoverInterrupt</li>

<li>0x86 DVDLowClearCoverInterrupt</li>

<li>0x87</li>

<li>0x87 DVDLowUnmaskStatusInterrupts</li>

<li>0x88 DVDLowGetCoverStatus</li>

<li>0x88 DVDLowGetCoverStatus</li>

<li>0x89 Enable Cover Interrupt</li>

<li>0x89 DVDLowUnmaskCoverInterrupt</li>

<li>0x8B DVDLowOpenPartition ioctl</li>

<li>0x8B DVDLowOpenPartition ioctl</li>

<li>0x8E DVDLowEnableDvdVideo</li>

<li>0x8E DVDLowEnableDvdVideo</li>

  |}

  |}

=== 0x85 DVDLowUnmaskCoverInterrupt ===

=== 0x85 DVDLowMaskCoverInterrupt ===

 

Disables the cover interrupt by clearing bit 1 of DICVR (leaving bit zero unchanged).  Does not clear the cover interrupt if it is currently asserted (does not write bit 2).

Titles have a DVDLowMaskCoverInterrupt function that is dummied out to always return 1; this function is used by DVDInit in the exact same place that gamecube titles write <code>DICVR = 0</code> (which should be equivalent, as writes to bit 0 which indicates the cover status presumably do nothing{{check}}).  However, since it is stubbed out, there is no way of being sure that 0x85 was actually used by that function.

The output buffer is not used, and it may be null.  Its size is not checked.

The output buffer is not used, and it may be null.  Its size is not checked.

  |}

  |}

=== <s>0x87</s> ===

=== <s>0x87 DVDLowUnmaskStatusInterrupts</s> ===

 

Dummied out; does nothing (and always returns 1).  Possibly an ID reserved for a PPC-only command (DVDLowBreak?), as is also done with DVDLowSetSpinupFlag?

Titles have a DVDLowUnmaskStatusInterrupts function that is dummied out to always return 1; this function is used by DVDInit in the exact same place that gamecube titles write <code>DISR = 0x2a</code> (which enables DEINTMASK, TCINTMASK, and BRKINTMASK, and does not clear any asserted interrupts).  However, since it is stubbed out, there is no way of being sure that 0x87 was actually used by that function.

The output buffer is not used, and it may be null.  Its size is not checked.

The output buffer is not used, and it may be null.  Its size is not checked.

  |}

  |}

=== 0x89 Enable Cover Interrupt ===

=== 0x89 DVDLowUnmaskCoverInterrupt ===

 

Enables the cover interrupt by setting bit 1 of DICVR (leaving bit zero unchanged).  Does not clear the cover interrupt if it is currently asserted (does not write bit 2).

Debug symbols list a function called DVDLowUnmaskCoverInterrupt, but no actual function remains as it was removed as unused (and even if it did still exist, it presumably would be dummied out to just return 1 as it is only 8 bytes).  Therefore, there is no way to be certain that 0x89 actually was called DVDLowUnmaskCoverInterrupt, but it seems very likely based on DVDLowMaskCoverInterrupt.

The output buffer is not used, and it may be null.  Its size is not checked.

The output buffer is not used, and it may be null.  Its size is not checked.

=== 0x8A DVDLowReset ===

=== 0x8A DVDLowReset ===

Resets the drive, using [[IOS/Syscalls|syscalls]] 0x44, 0x45, and 0x46.  If a reset is already in progress (syscall_check_di_reset returns true), then it immediately calls syscall_deassert_di_reset; otherwise, it calls syscall_assert_di_reset, waits 12&micro;s, and then calls syscall_deassert_di_reset.  Afterwards, registers are reset in the same way as DVDLowNotifyReset other than the cover interrupt.  The cover interrupt is temporarilly disabled during this process, but is reenabled afterwards if it was enabled before.

Resets the drive, using [[IOS/Syscalls|syscalls]] 0x44, 0x45, and 0x46.  If a reset is already in progress (check_di_reset returns true), then it immediately calls deassert_di_reset; otherwise, it calls assert_di_reset, waits 12&micro;s, and then calls deassert_di_reset.  Afterwards, registers are reset in the same way as DVDLowNotifyReset other than the cover interrupt.  The cover interrupt is temporarilly disabled during this process, but is reenabled afterwards if it was enabled before.

Enable spinup is passed to syscall 0x4e, which activates the DI_SPIN [[Hardware/Hollywood_GPIOs|GPIO]] if it is 0 and disables it otherwise.

Enable spinup is passed to syscall 0x4e, which activates the DI_SPIN [[Hardware/Hollywood_GPIOs|GPIO]] if it is 0 and disables it otherwise.