303
edits
Changes
More accurate information about audio commands; also, use sector in all cases instead of mixing it with cluster
Line 681:
Line 681:
clusterNum = position / 0x1F00+
+
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.
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 cluster-aligned (sizes that are multiples of 0x7C00 and offsets that are multiples of 0x1F00) avoid copies for the first and/or last cluster that needs to be read and decrypted. Each individual partition is read using command 0xA8.
+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.
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.
Line 1,111:
Line 1,111:
=== 0xAB DVDLowSeek ===
=== 0xAB DVDLowSeek ===
−Seeks to the cluster containing a specific position on the disc.
+Seeks to the sector containing a specific position on the disc.
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.
if (encryptionEnabled) {
if (encryptionEnabled) {
− sectorNum = position / 0x1F00
− start = partitionOffset + clusterNum * 0x2000
+ start = partitionOffset + sectorNum * 0x2000
} else {
} else {
start = partitionOffset + position
start = partitionOffset + position
Line 1,404:
Line 1,404:
=== 0xE1 Play Audio Stream ===
=== 0xE1 Play Audio Stream ===
−Plays an audio stream, according to [http://hitmen.c02.at/files/yagcd/yagcd/chap5.html#sec5.7.1 yagcd §5.7.1] and [https://web.archive.org/web/20070602090342/http://www.crazynation.org/GC/GC_DD_TECH/GCTech.htm this article]{{check}}. The audio stream is played through the [[Hardware/Audio Interface|Audio Interface]]. Audio is almost certainly not decrypted, making this command useless for Wii games{{check}}.
+Plays an audio stream, according to [http://hitmen.c02.at/files/yagcd/yagcd/chap5.html#sec5.7.1 yagcd §5.7.1] and [https://web.archive.org/web/20070602090342/http://www.crazynation.org/GC/GC_DD_TECH/GCTech.htm this article]. The audio stream is played through the [[Hardware/Audio Interface|Audio Interface]]. Audio is not decrypted, making this command useless for Wii games.
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.
Line 1,415:
Line 1,415:
Modes:
Modes:
−* 0 → Immediately stop the current stream, and start the new one (if present)
+* 0 → Wait for the current stream to finish before starting the new one (if present)
−* 1 → Wait for the current stream to finish before starting the new one (if present)
+* 1 → Immediately stop the current stream. The parameters are ignored (and will not be reflected by 0xE2).
* 2 → Invalid, fails with error 0x052401 (invalid audio command) and returns 2
* 2 → Invalid, fails with error 0x052401 (invalid audio command) and returns 2
* 3 → Invalid, fails with error 0x052401 (invalid audio command) and returns 2
* 3 → Invalid, fails with error 0x052401 (invalid audio command) and returns 2
Line 1,447:
Line 1,447:
=== 0xE2 Request Audio Status ===
=== 0xE2 Request Audio Status ===
−Requests information about an audio stream, according to [http://hitmen.c02.at/files/yagcd/yagcd/chap5.html#sec5.7.1 yagcd §5.7.1] and [https://web.archive.org/web/20070602090342/http://www.crazynation.org/GC/GC_DD_TECH/GCTech.htm this article]{{check}}.
+Requests information about an audio stream, according to [http://hitmen.c02.at/files/yagcd/yagcd/chap5.html#sec5.7.1 yagcd §5.7.1] and [https://web.archive.org/web/20070602090342/http://www.crazynation.org/GC/GC_DD_TECH/GCTech.htm this article].
The output buffer is not used, and it may be null. Its size is not checked. This is somewhat odd, as the response is put into into DIIMMBUF.
The output buffer is not used, and it may be null. Its size is not checked. This is somewhat odd, as the response is put into into DIIMMBUF.
Line 1,456:
Line 1,456:
Requests:
Requests:
−* 0 → Is stream playing (sets DIIMMBUF to 0/1)
+* 0 → Is stream playing (sets DIIMMBUF to 0 or 1)
−* 1 → Current playback address (sets DIIMMBUF to current location, with sector-level granularity, byte >> 2)
+* 1 → Current playback address (sets DIIMMBUF to current location, with sector-level granularity, and as a 32-bit offset; the result is always a multiple of 0x2000)
* 2 → Playback start address (sets DIIMBUF to the value previously configured from play audio stream)
* 2 → Playback start address (sets DIIMBUF to the value previously configured from play audio stream)
* 3 → Playback length (sets DIIMBUF to the value previously configured from play audio stream)
* 3 → Playback length (sets DIIMBUF to the value previously configured from play audio stream)
Line 1,514:
Line 1,514:
DICR = TSTART
DICR = TSTART
−The system menu issues this based off of the audio streaming and streaming buffer size fields in the [[Wii Disc]] header; byte 8 indicates whether or not it is enabled and byte 9 indicates the buffer size (defaulting to 10 if set to 0 while streaming is enabled).
+The system menu issues this for Gamecube games based off of the audio streaming and streaming buffer size fields in the [[Wii Disc]] header; byte 8 indicates whether or not it is enabled and byte 9 indicates the buffer size (defaulting to 10 if set to 0 while streaming is enabled).
+This command can only be issued immediately after reading the disc ID; calls before that will return 0x05020401 (Disk ID not read) and calls after a read will error with 0x052402 (Configuration out of permitted period). Since DVDLowReadDiskID does an additional read for Wii discs, this command cannot be used on a Wii disc. Bypassing /dev/di and manually writing the DI registers does allow the other commands to be used.
{| class="wikitable"
{| class="wikitable"