WiiBrew

Changes

/dev/di (view source)

Revision as of 23:46, 20 September 2019

1,337 bytes added ,  23:46, 20 September 2019
Merge the two types of ioctls (the distinction isn't really meaningful), and also document the command structure for ioctlvs as best as can be done
Line 219: Line 219:     
Presumably, the ioctlv would have validated size and alignment, and then filled in additional parameters on the command before passing it on to the shared logic that it is still accessible via the ioctlv.
 
Presumably, the ioctlv would have validated size and alignment, and then filled in additional parameters on the command before passing it on to the shared logic that it is still accessible via the ioctlv.
 +
 +
{| class="wikitable"
 +
|+ Command
 +
! Offset
 +
! Type
 +
! Name
 +
|-
 +
| 0
 +
| u8
 +
| Command (0x90)
 +
|-
 +
| 4
 +
| off_t
 +
| Partition position (>> 2)
 +
|- {{no2}}
 +
| 8
 +
| nodiscopenparams*
 +
| params (probably written by ioctlv, but unverifyable)
 +
|}
    
=== <s>0x91 DVDLowNoDiscOpenPartition</s> ===
 
=== <s>0x91 DVDLowNoDiscOpenPartition</s> ===
Line 225: Line 244:     
Presumably, the ioctlv would have validated size and alignment, and then filled in additional parameters on the command before passing it on to the shared logic that it is still accessible via the ioctlv.  However, no PPC-side code exists so the exact ioctlv arguments are unknown.
 
Presumably, the ioctlv would have validated size and alignment, and then filled in additional parameters on the command before passing it on to the shared logic that it is still accessible via the ioctlv.  However, no PPC-side code exists so the exact ioctlv arguments are unknown.
 +
 +
{| class="wikitable"
 +
|+ Command
 +
! Offset
 +
! Type
 +
! Name
 +
|-
 +
| 0
 +
| u8
 +
| Command (0x91)
 +
|- {{no2}}
 +
| 4
 +
| nodiscopenparams*
 +
| params (probably written by ioctlv, but unverifyable)
 +
|- {{no2}}
 +
| 8
 +
| u32 *
 +
| ES error output (probably written by ioctlv, but unverifyable)
 +
|}
    
=== <s>0x92 DVDLowGetNoDiscBufferSizes</s> ===
 
=== <s>0x92 DVDLowGetNoDiscBufferSizes</s> ===
Line 254: Line 292:     
Presumably, the ioctlv would have validated size and alignment, and then filled in additional parameters on the command before passing it on to the shared logic that it is still accessible via the ioctlv.
 
Presumably, the ioctlv would have validated size and alignment, and then filled in additional parameters on the command before passing it on to the shared logic that it is still accessible via the ioctlv.
 +
 +
{| class="wikitable"
 +
|+ Command
 +
! Offset
 +
! Type
 +
! Name
 +
|-
 +
| 0
 +
| u8
 +
| Command (0x92)
 +
|-
 +
| 4
 +
| off_t
 +
| Partition position (>> 2)
 +
|- {{no2}}
 +
| 8
 +
| u32 *
 +
| TMD Size out (probably written by ioctlv, but unverifyable)
 +
|- {{no2}}
 +
| 12
 +
| u32 *
 +
| Cert Chain Size Out (probably written by ioctlv, but unverifyable)
 +
|}
    
=== 0x93 DVDLowOpenPartitionWithTmdAndTicket ===
 
=== 0x93 DVDLowOpenPartitionWithTmdAndTicket ===
Line 395: Line 456:  
  |}
 
  |}
   −
== Simple ioctls ==
+
== Ioctls ==
 +
 
 +
Using a number not listed here results in a return value of 0x80.  The input buffer must be sized 0x20 (except for command 0x8E).  Unless otherwise noted, commands return 1 on success.
 +
 
 +
Ioctls are implemented in two functions: DiIoctl and handleDiCommand.  handleDiCommand is actually also used by IoctlV as well, and other than for DVDLowOpenPartition, IoctlV commands are accidentally exposed as Ioctls as well.  The following commands are implemented in DiIoctl:
 +
 
 +
{{collapse|title=Commands implemented in DiIoctl|text=
 +
<ul>
 +
<li>0x79 DVDLowWaitForCoverClose</li>
 +
<li>0x7A DVDLowGetCoverRegister</li>
 +
<li>0x83 DVDLowGetLength</li>
 +
<li>0x84 Get DIIMMBUF</li>
 +
<li>0x85 DVDLowUnmaskCoverInterrupt</li>
 +
<li>0x86 DVDLowClearCoverInterrupt</li>
 +
<li>0x87</li>
 +
<li>0x88 DVDLowGetCoverStatus</li>
 +
<li>0x89 Enable Cover Interrupt</li>
 +
<li>0x8B DVDLowOpenPartition ioctl</li>
 +
<li>0x8E DVDLowEnableDvdVideo</li>
 +
<li>0x95 DVDLowGetStatusRegister</li>
 +
<li>0x96 DVDLowGetControlRegister</li>
 +
</ul>
 +
}}
   −
This page is divided into "simple" and "transfer" ioctls.  This distinction is based on whether the ioctl is implemented in DiIoctl or handleDiCommand; both are accessed using the normal IOS_Ioctl function.
+
Commands will clear the error interrupt by writing bit 2 of DISR if it is set after execution.  Furthermore, the same check happens before execution, but this should generally not happen barring other code directly writing to the DI registers (a warning is logged in this case).  These checks happen in handleDiCommand, so commands implemented in DiIoctl are not affected; additionally the second check is skipped for 0x8A DVDLowReset and 0xE0 DVDLowRequestError.
   −
If a number is not listed here, see [[#transfer ioctls|transfer ioctls]].  The input buffer must be sized 0x20 (except for command 0x8E). Unless otherwise noted, commands return 1 on success.
+
If an output buffer size check fails, DIMAR and DILENGTH will not be written, and there is code that sets the return value to 0x20.  However, the driver still attempts to start the transfer, which will fail due to not writing DILENGTH (which should have counted back down 0 after any previous successful transfer{{check}}); this will result in an eventual timeout and returning of 0x10{{check}}. <!-- This seems completely wack, but it seems to be how the code works... -->
   −
=== 0x79 DVDLowWaitForCoverClose ===
+
=== 0x12 DVDLowInquiry ===
   −
Waits for a disc to be inserted; if there is already a disc inserted, it must be removed first. This command does not time out; if no disc is inserted, it will wait forever. (As such, I'm not entirely sure how it can be cancelled; I assume but have not checked that the Wii Fit Channel uses this when waiting for the Wii Fit disc to be inserted, but that can be canceled...)
+
Retrieves information about the drive verison; see [http://hitmen.c02.at/files/yagcd/yagcd/chap5.html#sec5.7.3.1 yagcd §5.7.3.1] for more info.
   −
Continuously waits for a DI interrupt, and when it receives one it checks for the cover interrupt (bit 2 of DICVR); if it is set it then checks if the cover is closed (bit 0 of DICVR) and if sufficient time has ellapsed.  It also clears the TC and error interrupts should they occur.
+
The output buffer size must be &ge; 0x20, or DIMAR and DILENGTH will not be written.  It must also be 32-bit aligned, or else the driver will hang.
   −
The output buffer is not used, and it may be null.  Its size is not checked.
+
Note that YAGCD is incorrect and there is actually one additional byte after the drive date, [https://web.archive.org/web/20070602090342/http://www.crazynation.org/GC/GC_DD_TECH/GCTech.htm apparently] indicating the version.  This is not new to the Wii.
   −
On completion, returns 0x4.
+
DICMDBUF0 = 0x12000000
 +
DILENGTH = 0x20
 +
DIMAR = outbuf
 +
DICMDBUF1 = 0
 +
DICR = TSTART | DMA
    
{| class="wikitable"
 
{| class="wikitable"
Line 419: Line 506:  
  | 0
 
  | 0
 
  | u8
 
  | u8
−
  | Command (0x79)
+
  | Command (0x12)
 
  |}
 
  |}
   −
=== 0x7A DVDLowGetCoverRegister ===
+
=== 0x70 DVDLowReadDiskID ===
   −
Stores the current value of DICVR into outbuf, which must be at least 4 bytes in size (or else 0x20 is returned).  Note that Nintendo titles also refer to this as DVDLowPrepareCoverRegister, but that function simply asynchronously reads it into game memory so that it can be accessed by a separate function later.  (A similar name pattern is found for the other get-reg commands.)
+
Reads the current disc ID and initializes the drive.  Many other commands will not work before this (either by explicitly checking, or due to the drive returning error 0x05xxxxxx).
   −
{| class="wikitable"
+
This command cannot be used while the drive interface is resetting (if [[IOS/Syscalls|syscall]] 0x46 syscall_check_di_reset returns true); in which case it will return 0x80. 0x80 will also be returned if the output buffer is not 32-byte aligned.
−
  |+ Command
  −
! Offset
  −
! Type
  −
! Name
  −
|-
  −
| 0
  −
| u8
  −
| Command (0x7A)
  −
|}
     −
=== 0x83 DVDLowGetLength ===
+
The output buffer size must be &ge; 0x20, or DIMAR and DILENGTH will not be written.
   −
Stores the last DILENGTH value into outbuf, which must be at least 4 bytes in size (or else 0x20 is returned). Note that this doesn't directly read DILENGTH, but rather a separate value that is set when DILENGTH is set (and zero'd if a read error occurs on a command that uses DILENGTH; this means that this command cannot be used to get the amount of data still left to be transfered when the error happened).
+
DICMDBUF0 = 0xA8000040
 +
DICMDBUF1 = 0
 +
DICMDBUF2 = 0x20
 +
DILENGTH = 0x20
 +
  DIMAR = dest
 +
DICR = TSTART | DMA
    
{| class="wikitable"
 
{| class="wikitable"
Line 449: Line 532:  
  | 0
 
  | 0
 
  | u8
 
  | u8
−
  | Command (0x83)
+
  | Command (0x70)
 
  |}
 
  |}
   −
=== 0x84 Get DIIMMBUF ===
+
After this command has finished reading, the driver will also look at the 4 bytes at offset 0x18 in the output (i.e. outbuf[6] if outbuf is a u32 array) for the Wii magicword 0x5D1C9EA3 to determine if it is a [[Wii Disc|Wii disc]].  If it is a Wii disc, and it has not already read it, it will read 0x44 (padded to 0x60) bytes starting at byte 0x20 (i.e. the game title, and the disable hashing and disable encryption flags).  Thus, after the first call, DVDLowGetLength will return 0x60, and on later calls it will return 0x20.
   −
Stores the current value of DIIMMBUF into outbuf, which must be at least 4 bytes in size (or else 0x20 is returned).
+
=== 0x71 DVDLowRead ===
   −
{| class="wikitable"
+
Reads and decrypts disc data. This command can only be used if hashing and encryption are enabled for the disc. DVDLowOpenPartition needs to have been called before for the keys to be read.
−
  |+ Command
  −
! Offset
  −
! Type
  −
! Name
  −
|-
  −
| 0
  −
| u8
  −
| Command (0x83)
  −
|}
     −
=== 0x85 DVDLowUnmaskCoverInterrupt ===
+
The output buffer has no requirements on alignment, but will perform better if 32-byte aligned since it can avoid a copy from a buffer within the driver.  Similarly, the offset and size can be any value, but ones that are sector-aligned (sizes that are multiples of 0x7C00 and offsets that are multiples of 0x1F00) avoid copies for the first and/or last sector that needs to be read and decrypted.  Each individual sector is read using command 0xA8.
   −
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).
+
This command immediately returns 0x20 if the buffer is too small, and also returns 0x20 if something went wrong with decryption or hashing and 2 for a drive error.
   −
The output buffer is not used, and it may be null.  Its size is not checked.
+
If everything completed successfully, the last length value used by DVDLowGetLength is set to offset (almost certainly a mistake on Nintendo's end).  Otherwise, it is set to 0.
    
{| class="wikitable"
 
{| class="wikitable"
Line 481: Line 555:  
  | 0
 
  | 0
 
  | u8
 
  | u8
−
  | Command (0x85)
+
  | Command (0x71)
 +
|-
 +
| 4
 +
| size_t
 +
| Size (bytes)
 +
|-
 +
| 8
 +
| off_t
 +
| Offset (bytes >> 2)
 
  |}
 
  |}
   −
=== 0x86 DVDLowClearCoverInterrupt ===
+
=== 0x79 DVDLowWaitForCoverClose ===
 +
 
 +
Waits for a disc to be inserted; if there is already a disc inserted, it must be removed first.  This command does not time out; if no disc is inserted, it will wait forever. (As such, I'm not entirely sure how it can be cancelled; I assume but have not checked that the Wii Fit Channel uses this when waiting for the Wii Fit disc to be inserted, but that can be canceled...)
   −
Clears the cover interrupt by writing bit 2 of DICVR (leaving the other bits unchanged).
+
Continuously waits for a DI interrupt, and when it receives one it checks for the cover interrupt (bit 2 of DICVR); if it is set it then checks if the cover is closed (bit 0 of DICVR) and if sufficient time has ellapsed.  It also clears the TC and error interrupts should they occur.
    
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.
 +
 +
On completion, returns 0x4.
    
{| class="wikitable"
 
{| class="wikitable"
Line 498: Line 584:  
  | 0
 
  | 0
 
  | u8
 
  | u8
−
  | Command (0x86)
+
  | Command (0x79)
 
  |}
 
  |}
   −
=== <s>0x87</s> ===
+
=== 0x7A DVDLowGetCoverRegister ===
   −
Dummied out; does nothing (and always returns 1).  Possibly an ID reserved for a PPC-only command (DVDLowBreak?), as is also done with DVDLowSetSpinupFlag?
+
Stores the current value of DICVR into outbuf, which must be at least 4 bytes in size (or else 0x20 is returned).  Note that Nintendo titles also refer to this as DVDLowPrepareCoverRegister, but that function simply asynchronously reads it into game memory so that it can be accessed by a separate function later.  (A similar name pattern is found for the other get-reg commands.)
−
 
  −
The output buffer is not used, and it may be null.  Its size is not checked.
      
{| class="wikitable"
 
{| class="wikitable"
Line 515: Line 599:  
  | 0
 
  | 0
 
  | u8
 
  | u8
−
  | Command (0x87)
+
  | Command (0x7A)
 
  |}
 
  |}
   −
=== 0x88 DVDLowGetCoverStatus ===
+
=== 0x7E DVDLowNotifyReset ===
   −
Checks the current cover status and stores the result into outbuf, which must be at least 4 bytes in size (or else 0x20 is returned).
+
Resets internal flags, closes the open partition (if there is one), clears the transfer complete interrupt and drive error interrupt, enables the transfer complete interrupt and error interrupt, and disables the cover interrupt.
−
 
  −
The result is 0 right after a reset{{check}}, 1 if a disc is not inserted (bit 1 of DICVR set), and 2 if a disc is inserted (bit 1 of DICVR not set).
      
{| class="wikitable"
 
{| class="wikitable"
Line 532: Line 614:  
  | 0
 
  | 0
 
  | u8
 
  | u8
−
  | Command (0x88)
+
  | Command (0x7E)
 
  |}
 
  |}
   −
=== 0x89 Enable Cover Interrupt ===
+
=== <s>0x7F DVDLowSetSpinupFlag</s> ===
   −
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).
+
Prints the message "(handleDiCommand) DI_SET_SPINUP_FLAG_CMD should have been executed in the PPC shim layer only" and returns 0x80.
   −
The output buffer is not used, and it may be null.  Its size is not checked.
+
The PPC-side simply stores a boolean which is later used as the parameter to DVDLowReset.  For some reason, Nintendo decided to give it an ioctl number as well, even though it didn't need one.
    
{| class="wikitable"
 
{| class="wikitable"
Line 549: Line 631:  
  | 0
 
  | 0
 
  | u8
 
  | u8
−
  | Command (0x89)
+
  | Command (0x7F)
 
  |}
 
  |}
   −
=== <s>0x8B DVDLowOpenPartition ioctl</s> ===
+
=== 0x80 DVDLowReadDvdPhysical ===
 +
 
 +
Probably related to DVD-Video{{check}}.
   −
Returns 0x20 and prints a warning that "OPEN_PARTITION done through Ioctlv, not Ioctl".
+
The output buffer size must be &ge; 0x800, or DIMAR and DILENGTH will not be written.  The output buffer also needs to be 32-byte aligned, or else the driver will hang.
   −
The output buffer is not used, and it may be null. Its size is not checked.
+
  DICMDBUF0 = 0xAD000000 | (position << 8) // AD00XX00
 +
DICMDBUF1 = 0
 +
DICMDBUF2 = 0
 +
DILENGTH = 0x800
 +
DIMAR = dest
 +
DICR = TSTART | DMA
    
{| class="wikitable"
 
{| class="wikitable"
Line 566: Line 655:  
  | 0
 
  | 0
 
  | u8
 
  | u8
−
  | Command (0x8B)
+
  | Command (0x80)
 +
|-
 +
| 7
 +
| u8
 +
| Position(?)
 
  |}
 
  |}
   −
=== 0x8E DVDLowEnableDvdVideo ===
+
=== 0x81 DVDLowReadDvdCopyright ===
   −
Can only be called by uid{{check}}<!-- Or PID?--> 0.  The restrictions on inbuf are different: it only needs to have a size of at least 1.  If the value is 0, performs [[IOS/Syscalls|syscall]] 0x50 with true as the parameter; otherwise, false is the parameter.  (Syscall 0x50 takes disable as a parameter, while this takes enable).
+
Probably related to DVD-Video{{check}}.
   −
If the uid is incorrect or inbuf is size 0, returns 0x20.
+
DICMDBUF0 = 0xAD010000 | (position << 8) // AD01XX00
 +
DICMDBUF1 = 0
 +
DICMDBUF2 = 0
 +
DICR = TSTART
   −
{| class="wikitable"
+
The contents of DIIMMBUF (u32) are written to the output buffer. The output buffer size is not checked, but 4 would be a sane value.
−
  |+ Inbuf
  −
! Offset
  −
! Type
  −
! Name
  −
|-
  −
| 0
  −
| bool
  −
| Enable
  −
|}
  −
 
  −
=== 0x95 DVDLowGetStatusRegister ===
  −
 
  −
Stores the current value of DISR into outbuf, which must be at least 4 bytes in size (or else 0x20 is returned).
      
{| class="wikitable"
 
{| class="wikitable"
Line 598: Line 681:  
  | 0
 
  | 0
 
  | u8
 
  | u8
−
  | Command (0x95)
+
  | Command (0x81)
−
|}
  −
 
  −
=== 0x96 DVDLowGetControlRegister ===
  −
 
  −
Stores the current value of DICR into outbuf, which must be at least 4 bytes in size (or else 0x20 is returned).
  −
 
  −
{| class="wikitable"
  −
|+ Command
  −
! Offset
  −
! Type
  −
! Name
   
  |-
 
  |-
−
  | 0
+
  | 7
 
  | u8
 
  | u8
−
  | Command (0x96)
+
  | Position(?)
 
  |}
 
  |}
   −
== Transfer ioctls ==
+
=== 0x82 DVDLowReadDvdDiscKey ===
   −
Using a number not listed here results in a return value of 0x80.  The input buffer must be sized 0x20 (except for command 0x8E), though this check is only performed in DiIoctl.  Unless otherwise noted, commands return 1 on success.
+
Probably related to DVD-Video{{check}}.
   −
Before any of these commands are executed (other than 0x8A DVDLowReset and 0xE0 DVDLowRequestError), the error interrupt status is checked, and if it is set, it will clear it by setting bit 2 of DISR.  <!-- Note that there are messages for if clearing it fails, but no way for it to actually fail. -->
+
The output buffer size must be &ge; 0x800, or DIMAR and DILENGTH will not be written.  The output buffer also needs to be 32-byte aligned, or else the driver will hang.
   −
If an output buffer size check fails, DIMAR and DILENGTH will not be written, and there is code that sets the return value to 0x20. However, the driver still attempts to start the transfer, which will fail due to not writing DILENGTH (which should have counted back down 0 after any previous successful transfer{{check}}); this will result in an eventual timeout and returning of 0x10{{check}}. <!-- This seems completely wack, but it seems to be how the code works... -->
+
  DICMDBUF0 = 0xAD020000 | (position << 8) // AD02XX00
−
 
  −
=== 0x12 DVDLowInquiry ===
  −
 
  −
Retrieves information about the drive verison; see [http://hitmen.c02.at/files/yagcd/yagcd/chap5.html#sec5.7.3.1 yagcd §5.7.3.1] for more info.
  −
 
  −
The output buffer size must be &ge; 0x20, or DIMAR and DILENGTH will not be written.  It must also be 32-bit aligned, or else the driver will hang.
  −
 
  −
Note that YAGCD is incorrect and there is actually one additional byte after the drive date, [https://web.archive.org/web/20070602090342/http://www.crazynation.org/GC/GC_DD_TECH/GCTech.htm apparently] indicating the version.  This is not new to the Wii.
  −
 
  −
DICMDBUF0 = 0x12000000
  −
DILENGTH = 0x20
  −
DIMAR = outbuf
   
  DICMDBUF1 = 0
 
  DICMDBUF1 = 0
 +
DICMDBUF2 = 0
 +
DILENGTH = 0x800
 +
DIMAR = dest
 
  DICR = TSTART | DMA
 
  DICR = TSTART | DMA
   Line 646: Line 709:  
  | 0
 
  | 0
 
  | u8
 
  | u8
−
  | Command (0x12)
+
  | Command (0x82)
 +
|-
 +
| 7
 +
| u8
 +
| Position(?)
 
  |}
 
  |}
   −
=== 0x70 DVDLowReadDiskID ===
+
=== 0x83 DVDLowGetLength ===
   −
Reads the current disc ID and initializes the drive.  Many other commands will not work before this (either by explicitly checking, or due to the drive returning error 0x05xxxxxx).
+
Stores the last DILENGTH value into outbuf, which must be at least 4 bytes in size (or else 0x20 is returned).  Note that this doesn't directly read DILENGTH, but rather a separate value that is set when DILENGTH is set (and zero'd if a read error occurs on a command that uses DILENGTH; this means that this command cannot be used to get the amount of data still left to be transfered when the error happened).
−
 
  −
This command cannot be used while the drive interface is resetting (if [[IOS/Syscalls|syscall]] 0x46 syscall_check_di_reset returns true); in which case it will return 0x80.  0x80 will also be returned if the output buffer is not 32-byte aligned.
  −
 
  −
The output buffer size must be &ge; 0x20, or DIMAR and DILENGTH will not be written.
  −
 
  −
DICMDBUF0 = 0xA8000040
  −
DICMDBUF1 = 0
  −
DICMDBUF2 = 0x20
  −
DILENGTH = 0x20
  −
DIMAR = dest
  −
DICR = TSTART | DMA
      
{| class="wikitable"
 
{| class="wikitable"
Line 672: Line 728:  
  | 0
 
  | 0
 
  | u8
 
  | u8
−
  | Command (0x70)
+
  | Command (0x83)
 
  |}
 
  |}
   −
After this command has finished reading, the driver will also look at the 4 bytes at offset 0x18 in the output (i.e. outbuf[6] if outbuf is a u32 array) for the Wii magicword 0x5D1C9EA3 to determine if it is a [[Wii Disc|Wii disc]].  If it is a Wii disc, and it has not already read it, it will read 0x44 (padded to 0x60) bytes starting at byte 0x20 (i.e. the game title, and the disable hashing and disable encryption flags).  Thus, after the first call, DVDLowGetLength will return 0x60, and on later calls it will return 0x20.
+
=== 0x84 Get DIIMMBUF ===
   −
=== 0x71 DVDLowRead ===
+
Stores the current value of DIIMMBUF into outbuf, which must be at least 4 bytes in size (or else 0x20 is returned).
−
 
  −
Reads and decrypts disc data.  This command can only be used if hashing and encryption are enabled for the disc. DVDLowOpenPartition needs to have been called before for the keys to be read.
  −
 
  −
The output buffer has no requirements on alignment, but will perform better if 32-byte aligned since it can avoid a copy from a buffer within the driver.  Similarly, the offset and size can be any value, but ones that are sector-aligned (sizes that are multiples of 0x7C00 and offsets that are multiples of 0x1F00) avoid copies for the first and/or last sector that needs to be read and decrypted.  Each individual sector is read using command 0xA8.
  −
 
  −
This command immediately returns 0x20 if the buffer is too small, and also returns 0x20 if something went wrong with decryption or hashing and 2 for a drive error.
  −
 
  −
If everything completed successfully, the last length value used by DVDLowGetLength is set to offset (almost certainly a mistake on Nintendo's end).  Otherwise, it is set to 0.
      
{| class="wikitable"
 
{| class="wikitable"
Line 695: Line 743:  
  | 0
 
  | 0
 
  | u8
 
  | u8
−
  | Command (0x71)
+
  | Command (0x83)
−
|-
  −
| 4
  −
| size_t
  −
| Size (bytes)
  −
|-
  −
| 8
  −
| off_t
  −
| Offset (bytes >> 2)
   
  |}
 
  |}
   −
=== 0x7E DVDLowNotifyReset ===
+
=== 0x85 DVDLowUnmaskCoverInterrupt ===
 +
 
 +
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).
   −
Resets internal flags, closes the open partition (if there is one), clears the transfer complete interrupt and drive error interrupt, enables the transfer complete interrupt and error interrupt, and disables the cover interrupt.
+
The output buffer is not used, and it may be null.  Its size is not checked.
    
{| class="wikitable"
 
{| class="wikitable"
Line 718: Line 760:  
  | 0
 
  | 0
 
  | u8
 
  | u8
−
  | Command (0x7E)
+
  | Command (0x85)
 
  |}
 
  |}
   −
=== <s>0x7F DVDLowSetSpinupFlag</s> ===
+
=== 0x86 DVDLowClearCoverInterrupt ===
   −
Prints the message "(handleDiCommand) DI_SET_SPINUP_FLAG_CMD should have been executed in the PPC shim layer only" and returns 0x80.
+
Clears the cover interrupt by writing bit 2 of DICVR (leaving the other bits unchanged).
   −
The PPC-side simply stores a boolean which is later used as the parameter to DVDLowReset.  For some reason, Nintendo decided to give it an ioctl number as well, even though it didn't need one.
+
The output buffer is not used, and it may be null.  Its size is not checked.
    
{| class="wikitable"
 
{| class="wikitable"
Line 735: Line 777:  
  | 0
 
  | 0
 
  | u8
 
  | u8
−
  | Command (0x7F)
+
  | Command (0x86)
 
  |}
 
  |}
   −
=== 0x80 DVDLowReadDvdPhysical ===
+
=== <s>0x87</s> ===
   −
Probably related to DVD-Video{{check}}.
+
Dummied out; does nothing (and always returns 1).  Possibly an ID reserved for a PPC-only command (DVDLowBreak?), as is also done with DVDLowSetSpinupFlag?
   −
The output buffer size must be &ge; 0x800, or DIMAR and DILENGTH will not be written.  The output buffer also needs to be 32-byte aligned, or else the driver will hang.
+
The output buffer is not used, and it may be null.  Its size is not checked.
−
 
  −
DICMDBUF0 = 0xAD000000 | (position << 8) // AD00XX00
  −
DICMDBUF1 = 0
  −
DICMDBUF2 = 0
  −
DILENGTH = 0x800
  −
DIMAR = dest
  −
DICR = TSTART | DMA
      
{| class="wikitable"
 
{| class="wikitable"
Line 759: Line 794:  
  | 0
 
  | 0
 
  | u8
 
  | u8
−
  | Command (0x80)
+
  | Command (0x87)
−
|-
  −
| 7
  −
| u8
  −
| Position(?)
   
  |}
 
  |}
   −
=== 0x81 DVDLowReadDvdCopyright ===
+
=== 0x88 DVDLowGetCoverStatus ===
   −
Probably related to DVD-Video{{check}}.
+
Checks the current cover status and stores the result into outbuf, which must be at least 4 bytes in size (or else 0x20 is returned).
   −
DICMDBUF0 = 0xAD010000 | (position << 8) // AD01XX00
+
The result is 0 right after a reset{{check}}, 1 if a disc is not inserted (bit 1 of DICVR set), and 2 if a disc is inserted (bit 1 of DICVR not set).
−
DICMDBUF1 = 0
  −
DICMDBUF2 = 0
  −
DICR = TSTART
  −
 
  −
The contents of DIIMMBUF (u32) are written to the output buffer.  The output buffer size is not checked, but 4 would be a sane value.
      
{| class="wikitable"
 
{| class="wikitable"
Line 785: Line 811:  
  | 0
 
  | 0
 
  | u8
 
  | u8
−
  | Command (0x81)
+
  | Command (0x88)
−
|-
  −
| 7
  −
| u8
  −
| Position(?)
   
  |}
 
  |}
   −
=== 0x82 DVDLowReadDvdDiscKey ===
+
=== 0x89 Enable Cover Interrupt ===
   −
Probably related to DVD-Video{{check}}.
+
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).
   −
The output buffer size must be &ge; 0x800, or DIMAR and DILENGTH will not be written.  The output buffer also needs to be 32-byte aligned, or else the driver will hang.
+
The output buffer is not used, and it may be null.  Its size is not checked.
−
 
  −
DICMDBUF0 = 0xAD020000 | (position << 8) // AD02XX00
  −
DICMDBUF1 = 0
  −
DICMDBUF2 = 0
  −
DILENGTH = 0x800
  −
DIMAR = dest
  −
DICR = TSTART | DMA
      
{| class="wikitable"
 
{| class="wikitable"
Line 813: Line 828:  
  | 0
 
  | 0
 
  | u8
 
  | u8
−
  | Command (0x82)
+
  | Command (0x89)
−
|-
  −
| 7
  −
| u8
  −
| Position(?)
   
  |}
 
  |}
   Line 841: Line 852:  
  | u32
 
  | u32
 
  | Enable spinup
 
  | Enable spinup
 +
|}
 +
 +
=== <s>0x8B DVDLowOpenPartition ioctl</s> ===
 +
 +
Returns 0x20 and prints a warning that "OPEN_PARTITION done through Ioctlv, not Ioctl".
 +
 +
The output buffer is not used, and it may be null.  Its size is not checked.
 +
 +
{| class="wikitable"
 +
|+ Command
 +
! Offset
 +
! Type
 +
! Name
 +
|-
 +
| 0
 +
| u8
 +
| Command (0x8B)
 
  |}
 
  |}
   Line 930: Line 958:     
DVDLowUnencryptedRead without any restrictions on the regions it can be used; internal use only.  Attempting to use this from IOS_Ioctl will result in return 0x20.  Otherwise idential to DVDLowUnencryptedRead, including the alignment and size checks.
 
DVDLowUnencryptedRead without any restrictions on the regions it can be used; internal use only.  Attempting to use this from IOS_Ioctl will result in return 0x20.  Otherwise idential to DVDLowUnencryptedRead, including the alignment and size checks.
 +
 +
=== 0x8E DVDLowEnableDvdVideo ===
 +
 +
Can only be called by uid{{check}}<!-- Or PID?--> 0.  The restrictions on inbuf are different: it only needs to have a size of at least 1.  If the value is 0, performs [[IOS/Syscalls|syscall]] 0x50 with true as the parameter; otherwise, false is the parameter.  (Syscall 0x50 takes disable as a parameter, while this takes enable).
 +
 +
If the uid is incorrect or inbuf is size 0, returns 0x20.
 +
 +
{| class="wikitable"
 +
|+ Inbuf
 +
! Offset
 +
! Type
 +
! Name
 +
|-
 +
| 0
 +
| bool
 +
| Enable
 +
|}
    
=== 0x90 DVDLowGetNoDiscOpenPartitionParams ioctl ===
 
=== 0x90 DVDLowGetNoDiscOpenPartitionParams ioctl ===
Line 1,073: Line 1,118:  
  | u32 *
 
  | u32 *
 
  | ES error output
 
  | ES error output
 +
|}
 +
 +
=== 0x95 DVDLowGetStatusRegister ===
 +
 +
Stores the current value of DISR into outbuf, which must be at least 4 bytes in size (or else 0x20 is returned).
 +
 +
{| class="wikitable"
 +
|+ Command
 +
! Offset
 +
! Type
 +
! Name
 +
|-
 +
| 0
 +
| u8
 +
| Command (0x95)
 +
|}
 +
 +
=== 0x96 DVDLowGetControlRegister ===
 +
 +
Stores the current value of DICR into outbuf, which must be at least 4 bytes in size (or else 0x20 is returned).
 +
 +
{| class="wikitable"
 +
|+ Command
 +
! Offset
 +
! Type
 +
! Name
 +
|-
 +
| 0
 +
| u8
 +
| Command (0x96)
 
  |}
 
  |}
  
Pokechu22
303

edits

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