|
Packit |
dd8086 |
/*
|
|
Packit |
dd8086 |
Copyright (C) 2010, 2012, 2016 Rocky Bernstein <rocky@gnu.org>
|
|
Packit |
dd8086 |
|
|
Packit |
dd8086 |
This program is free software: you can redistribute it and/or modify
|
|
Packit |
dd8086 |
it under the terms of the GNU General Public License as published by
|
|
Packit |
dd8086 |
the Free Software Foundation, either version 3 of the License, or
|
|
Packit |
dd8086 |
(at your option) any later version.
|
|
Packit |
dd8086 |
|
|
Packit |
dd8086 |
This program is distributed in the hope that it will be useful,
|
|
Packit |
dd8086 |
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
Packit |
dd8086 |
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
Packit |
dd8086 |
GNU General Public License for more details.
|
|
Packit |
dd8086 |
|
|
Packit |
dd8086 |
You should have received a copy of the GNU General Public License
|
|
Packit |
dd8086 |
along with this program. If not, see <http://www.gnu.org/licenses/>.
|
|
Packit |
dd8086 |
*/
|
|
Packit |
dd8086 |
|
|
Packit |
dd8086 |
/**
|
|
Packit |
dd8086 |
\file mmc_ll_cmds.h
|
|
Packit |
dd8086 |
|
|
Packit |
dd8086 |
\brief Wrappers for specific Multimedia Command (MMC) commands e.g., READ
|
|
Packit |
dd8086 |
DISC, START/STOP UNIT.
|
|
Packit |
dd8086 |
|
|
Packit |
dd8086 |
The documents we make use of are described in several
|
|
Packit |
dd8086 |
specifications made by the SCSI committee T10
|
|
Packit |
dd8086 |
http://www.t10.org. In particular, SCSI Primary Commands (SPC),
|
|
Packit |
dd8086 |
SCSI Block Commands (SBC), and Multi-Media Commands (MMC). These
|
|
Packit |
dd8086 |
documents generally have a numeric level number appended. For
|
|
Packit |
dd8086 |
example SPC-3 refers to ``SCSI Primary Commands - 3'.
|
|
Packit |
dd8086 |
|
|
Packit |
dd8086 |
In year 2010 the current versions were SPC-3, SBC-2, MMC-5.
|
|
Packit |
dd8086 |
|
|
Packit |
dd8086 |
*/
|
|
Packit |
dd8086 |
|
|
Packit |
dd8086 |
#ifndef CDIO_MMC_LL_CMDS_H_
|
|
Packit |
dd8086 |
#define CDIO_MMC_LL_CMDS_H_
|
|
Packit |
dd8086 |
|
|
Packit |
dd8086 |
#include <cdio/mmc.h>
|
|
Packit |
dd8086 |
|
|
Packit |
dd8086 |
#ifdef __cplusplus
|
|
Packit |
dd8086 |
extern "C" {
|
|
Packit |
dd8086 |
#endif /* __cplusplus */
|
|
Packit |
dd8086 |
|
|
Packit |
dd8086 |
/**
|
|
Packit |
dd8086 |
Get drive capabilities via SCSI-MMC GET CONFIGURATION
|
|
Packit |
dd8086 |
@param p_cdio the CD object to be acted upon.
|
|
Packit |
dd8086 |
|
|
Packit |
dd8086 |
@param p_buf pointer to location to store mode sense information
|
|
Packit |
dd8086 |
@param i_size number of bytes allocated to p_buf
|
|
Packit |
dd8086 |
@param i_return_type value in range 0..2 giving what kind of configuration
|
|
Packit |
dd8086 |
to return:
|
|
Packit |
dd8086 |
|
|
Packit |
dd8086 |
- 0 — Full Header and Full Descriptors;
|
|
Packit |
dd8086 |
- 1 — Feature Headers and those with their Current Bit.
|
|
Packit |
dd8086 |
- 2 — One Feature header and zero or one Feature Descriptors.
|
|
Packit |
dd8086 |
|
|
Packit |
dd8086 |
@param i_starting_feature_number feature number from which to start
|
|
Packit |
dd8086 |
getting information.
|
|
Packit |
dd8086 |
|
|
Packit |
dd8086 |
@param i_timeout_ms value in milliseconds to use on timeout. Setting
|
|
Packit |
dd8086 |
to 0 uses the default time-out value stored in
|
|
Packit |
dd8086 |
mmc_timeout_ms.
|
|
Packit |
dd8086 |
q
|
|
Packit |
dd8086 |
@return DRIVER_OP_SUCCESS (0) if we got the status.
|
|
Packit |
dd8086 |
return codes are the same as driver_return_code_t
|
|
Packit |
dd8086 |
*/
|
|
Packit |
dd8086 |
driver_return_code_t
|
|
Packit |
dd8086 |
mmc_get_configuration(const CdIo_t *p_cdio, void *p_buf,
|
|
Packit |
dd8086 |
unsigned int i_size,
|
|
Packit |
dd8086 |
unsigned int i_return_type,
|
|
Packit |
dd8086 |
unsigned int i_starting_feature_number,
|
|
Packit |
dd8086 |
unsigned int i_timeout_ms);
|
|
Packit |
dd8086 |
|
|
Packit |
dd8086 |
/**
|
|
Packit |
dd8086 |
Return results of media event status via SCSI-MMC GET EVENT STATUS
|
|
Packit |
dd8086 |
|
|
Packit |
dd8086 |
@param p_cdio the CD object to be acted upon.
|
|
Packit |
dd8086 |
|
|
Packit |
dd8086 |
@param out_buf media status code from operation
|
|
Packit |
dd8086 |
|
|
Packit |
dd8086 |
@return DRIVER_OP_SUCCESS (0) if we got the status. Return codes
|
|
Packit |
dd8086 |
are the same as driver_return_code_t
|
|
Packit |
dd8086 |
*/
|
|
Packit |
dd8086 |
driver_return_code_t mmc_get_event_status(const CdIo_t *p_cdio,
|
|
Packit |
dd8086 |
uint8_t out_buf[2]);
|
|
Packit |
dd8086 |
|
|
Packit |
dd8086 |
|
|
Packit |
dd8086 |
/**
|
|
Packit |
dd8086 |
Run a SCSI-MMC MODE SELECT (10-byte) command
|
|
Packit |
dd8086 |
and put the results in p_buf.
|
|
Packit |
dd8086 |
|
|
Packit |
dd8086 |
@param p_cdio the CD object to be acted upon.
|
|
Packit |
dd8086 |
|
|
Packit |
dd8086 |
@param p_buf pointer to location to store mode sense information
|
|
Packit |
dd8086 |
|
|
Packit |
dd8086 |
@param i_size number of bytes allocated to p_buf
|
|
Packit |
dd8086 |
|
|
Packit |
dd8086 |
@param page which "page" of the mode sense command we are interested in
|
|
Packit |
dd8086 |
|
|
Packit |
dd8086 |
@param i_timeout_ms value in milliseconds to use on timeout. Setting
|
|
Packit |
dd8086 |
to 0 uses the default time-out value stored in
|
|
Packit |
dd8086 |
mmc_timeout_ms.
|
|
Packit |
dd8086 |
|
|
Packit |
dd8086 |
@return DRIVER_OP_SUCCESS if we ran the command ok.
|
|
Packit |
dd8086 |
*/
|
|
Packit |
dd8086 |
driver_return_code_t mmc_mode_select_10(CdIo_t *p_cdio, /*out*/ void *p_buf,
|
|
Packit |
dd8086 |
unsigned int i_size, int page,
|
|
Packit |
dd8086 |
unsigned int i_timeout_ms);
|
|
Packit |
dd8086 |
/**
|
|
Packit |
dd8086 |
Run a SCSI-MMC MODE SENSE command (10-byte version)
|
|
Packit |
dd8086 |
and put the results in p_buf
|
|
Packit |
dd8086 |
@param p_cdio the CD object to be acted upon.
|
|
Packit |
dd8086 |
@param p_buf pointer to location to store mode sense information
|
|
Packit |
dd8086 |
|
|
Packit |
dd8086 |
@param i_size number of bytes allocated to p_buf
|
|
Packit |
dd8086 |
|
|
Packit |
dd8086 |
@param i_page_code which "page" of the mode sense command we are
|
|
Packit |
dd8086 |
interested in
|
|
Packit |
dd8086 |
|
|
Packit |
dd8086 |
@return DRIVER_OP_SUCCESS if we ran the command ok.
|
|
Packit |
dd8086 |
*/
|
|
Packit |
dd8086 |
driver_return_code_t mmc_mode_sense_10( CdIo_t *p_cdio, /*out*/ void *p_buf,
|
|
Packit |
dd8086 |
unsigned int i_size,
|
|
Packit |
dd8086 |
unsigned int i_page_code);
|
|
Packit |
dd8086 |
|
|
Packit |
dd8086 |
/**
|
|
Packit |
dd8086 |
Run a SCSI-MMC MODE SENSE command (6-byte version)
|
|
Packit |
dd8086 |
and put the results in p_buf
|
|
Packit |
dd8086 |
@param p_cdio the CD object to be acted upon.
|
|
Packit |
dd8086 |
@param p_buf pointer to location to store mode sense information
|
|
Packit |
dd8086 |
@param i_size number of bytes allocated to p_buf
|
|
Packit |
dd8086 |
@param page which "page" of the mode sense command we are interested in
|
|
Packit |
dd8086 |
@return DRIVER_OP_SUCCESS if we ran the command ok.
|
|
Packit |
dd8086 |
*/
|
|
Packit |
dd8086 |
driver_return_code_t mmc_mode_sense_6( CdIo_t *p_cdio, /*out*/ void *p_buf,
|
|
Packit |
dd8086 |
unsigned int i_size, int page);
|
|
Packit |
dd8086 |
|
|
Packit |
dd8086 |
/**
|
|
Packit |
dd8086 |
Request preventing/allowing medium removal on a drive via
|
|
Packit |
dd8086 |
SCSI-MMC PREVENT/ALLOW MEDIUM REMOVAL.
|
|
Packit |
dd8086 |
|
|
Packit |
dd8086 |
@param p_cdio the CD object to be acted upon.
|
|
Packit |
dd8086 |
@param b_persistent make b_prevent state persistent
|
|
Packit |
dd8086 |
@param b_prevent true of drive locked and false if unlocked
|
|
Packit |
dd8086 |
|
|
Packit |
dd8086 |
@param i_timeout_ms value in milliseconds to use on timeout. Setting
|
|
Packit |
dd8086 |
to 0 uses the default time-out value stored in
|
|
Packit |
dd8086 |
mmc_timeout_ms.
|
|
Packit |
dd8086 |
|
|
Packit |
dd8086 |
@return DRIVER_OP_SUCCESS (0) if we got the status.
|
|
Packit |
dd8086 |
return codes are the same as driver_return_code_t
|
|
Packit |
dd8086 |
*/
|
|
Packit |
dd8086 |
driver_return_code_t
|
|
Packit |
dd8086 |
mmc_prevent_allow_medium_removal(const CdIo_t *p_cdio,
|
|
Packit |
dd8086 |
bool b_persistent, bool b_prevent,
|
|
Packit |
dd8086 |
unsigned int i_timeout_ms);
|
|
Packit |
dd8086 |
|
|
Packit |
dd8086 |
/**
|
|
Packit |
dd8086 |
Issue a MMC READ_CD command.
|
|
Packit |
dd8086 |
|
|
Packit |
dd8086 |
@param p_cdio object to read from
|
|
Packit |
dd8086 |
|
|
Packit |
dd8086 |
@param p_buf Place to store data. The caller should ensure that
|
|
Packit |
dd8086 |
p_buf can hold at least i_blocksize * i_blocks bytes.
|
|
Packit |
dd8086 |
|
|
Packit |
dd8086 |
@param i_lsn sector to read
|
|
Packit |
dd8086 |
|
|
Packit |
dd8086 |
@param expected_sector_type restricts reading to a specific CD
|
|
Packit |
dd8086 |
sector type. Only 3 bits with values 1-5 are used:
|
|
Packit |
dd8086 |
- 0 — all sector types
|
|
Packit |
dd8086 |
- 1 — CD-DA sectors only
|
|
Packit |
dd8086 |
- 2 — Mode 1 sectors only
|
|
Packit |
dd8086 |
- 3 — Mode 2 formless sectors only. Note in contrast to all other
|
|
Packit |
dd8086 |
values an MMC CD-ROM is not required to support this mode.
|
|
Packit |
dd8086 |
- 4 — Mode 2 Form 1 sectors only
|
|
Packit |
dd8086 |
- 5 — Mode 2 Form 2 sectors only
|
|
Packit |
dd8086 |
|
|
Packit |
dd8086 |
@param b_digital_audio_play Control error concealment when the
|
|
Packit |
dd8086 |
data being read is CD-DA. If the data being read is not CD-DA,
|
|
Packit |
dd8086 |
this parameter is ignored. If the data being read is CD-DA and
|
|
Packit |
dd8086 |
DAP is false zero, then the user data returned should not be
|
|
Packit |
dd8086 |
modified by flaw obscuring mechanisms such as audio data mute and
|
|
Packit |
dd8086 |
interpolate. If the data being read is CD-DA and DAP is true,
|
|
Packit |
dd8086 |
then the user data returned should be modified by flaw obscuring
|
|
Packit |
dd8086 |
mechanisms such as audio data mute and interpolate.
|
|
Packit |
dd8086 |
|
|
Packit |
dd8086 |
b_sync_header return the sync header (which will probably have
|
|
Packit |
dd8086 |
the same value as CDIO_SECTOR_SYNC_HEADER of size
|
|
Packit |
dd8086 |
CDIO_CD_SYNC_SIZE).
|
|
Packit |
dd8086 |
|
|
Packit |
dd8086 |
@param header_codes Header Codes refer to the sector header and
|
|
Packit |
dd8086 |
the sub-header that is present in mode 2 formed sectors:
|
|
Packit |
dd8086 |
|
|
Packit |
dd8086 |
- 0 — No header information is returned.
|
|
Packit |
dd8086 |
- 1 — The 4-byte sector header of data sectors is be returned,
|
|
Packit |
dd8086 |
- 2 — The 8-byte sector sub-header of mode 2 formed sectors is
|
|
Packit |
dd8086 |
returned.
|
|
Packit |
dd8086 |
- 3 &mdash Both sector header and sub-header (12 bytes) is returned.
|
|
Packit |
dd8086 |
|
|
Packit |
dd8086 |
The Header preceeds the rest of the bytes (e.g. user-data bytes)
|
|
Packit |
dd8086 |
that might get returned.
|
|
Packit |
dd8086 |
|
|
Packit |
dd8086 |
@param b_user_data Return user data if true.
|
|
Packit |
dd8086 |
|
|
Packit |
dd8086 |
For CD-DA, the User Data is CDIO_CD_FRAMESIZE_RAW bytes.
|
|
Packit |
dd8086 |
|
|
Packit |
dd8086 |
For Mode 1, The User Data is ISO_BLOCKSIZE bytes beginning at
|
|
Packit |
dd8086 |
offset CDIO_CD_HEADER_SIZE+CDIO_CD_SUBHEADER_SIZE.
|
|
Packit |
dd8086 |
|
|
Packit |
dd8086 |
For Mode 2 formless, The User Data is M2RAW_SECTOR_SIZE bytes
|
|
Packit |
dd8086 |
beginning at offset CDIO_CD_HEADER_SIZE+CDIO_CD_SUBHEADER_SIZE.
|
|
Packit |
dd8086 |
|
|
Packit |
dd8086 |
For data Mode 2, form 1, User Data is ISO_BLOCKSIZE bytes beginning at
|
|
Packit |
dd8086 |
offset CDIO_CD_XA_SYNC_HEADER.
|
|
Packit |
dd8086 |
|
|
Packit |
dd8086 |
For data Mode 2, form 2, User Data is 2 324 bytes beginning at
|
|
Packit |
dd8086 |
offset CDIO_CD_XA_SYNC_HEADER.
|
|
Packit |
dd8086 |
|
|
Packit |
dd8086 |
@param b_sync
|
|
Packit |
dd8086 |
|
|
Packit |
dd8086 |
@param b_edc_ecc true if we return EDC/ECC error detection/correction bits.
|
|
Packit |
dd8086 |
|
|
Packit |
dd8086 |
The presence and size of EDC redundancy or ECC parity is defined
|
|
Packit |
dd8086 |
according to sector type:
|
|
Packit |
dd8086 |
|
|
Packit |
dd8086 |
CD-DA sectors have neither EDC redundancy nor ECC parity.
|
|
Packit |
dd8086 |
|
|
Packit |
dd8086 |
Data Mode 1 sectors have 288 bytes of EDC redundancy, Pad, and
|
|
Packit |
dd8086 |
ECC parity beginning at offset 2064.
|
|
Packit |
dd8086 |
|
|
Packit |
dd8086 |
Data Mode 2 formless sectors have neither EDC redundancy nor ECC
|
|
Packit |
dd8086 |
parity
|
|
Packit |
dd8086 |
|
|
Packit |
dd8086 |
Data Mode 2 form 1 sectors have 280 bytes of EDC redundancy and
|
|
Packit |
dd8086 |
ECC parity beginning at offset 2072
|
|
Packit |
dd8086 |
|
|
Packit |
dd8086 |
Data Mode 2 form 2 sectors optionally have 4 bytes of EDC
|
|
Packit |
dd8086 |
redundancy beginning at offset 2348.
|
|
Packit |
dd8086 |
|
|
Packit |
dd8086 |
|
|
Packit |
dd8086 |
@param c2_error_information If true associate a bit with each
|
|
Packit |
dd8086 |
sector for C2 error The resulting bit field is ordered exactly as
|
|
Packit |
dd8086 |
the main channel bytes. Each 8-bit boundary defines a byte of
|
|
Packit |
dd8086 |
flag bits.
|
|
Packit |
dd8086 |
|
|
Packit |
dd8086 |
@param subchannel_selection subchannel-selection bits
|
|
Packit |
dd8086 |
|
|
Packit |
dd8086 |
- 0 — No Sub-channel data shall be returned. (0 bytes)
|
|
Packit |
dd8086 |
- 1 — RAW P-W Sub-channel data shall be returned. (96 byte)
|
|
Packit |
dd8086 |
- 2 — Formatted Q sub-channel data shall be transferred (16 bytes)
|
|
Packit |
dd8086 |
- 3 — Reserved
|
|
Packit |
dd8086 |
- 4 — Corrected and de-interleaved R-W sub-channel (96 bytes)
|
|
Packit |
dd8086 |
- 5-7 — Reserved
|
|
Packit |
dd8086 |
|
|
Packit |
dd8086 |
@param i_blocksize size of the a block expected to be returned
|
|
Packit |
dd8086 |
|
|
Packit |
dd8086 |
@param i_blocks number of blocks expected to be returned.
|
|
Packit |
dd8086 |
|
|
Packit |
dd8086 |
@return DRIVER_OP_SUCCESS if we ran the command ok.
|
|
Packit |
dd8086 |
*/
|
|
Packit |
dd8086 |
driver_return_code_t
|
|
Packit |
dd8086 |
mmc_read_cd(const CdIo_t *p_cdio, void *p_buf, lsn_t i_lsn,
|
|
Packit |
dd8086 |
int expected_sector_type, bool b_digital_audio_play,
|
|
Packit |
dd8086 |
bool b_sync, uint8_t header_codes, bool b_user_data,
|
|
Packit |
dd8086 |
bool b_edc_ecc, uint8_t c2_error_information,
|
|
Packit |
dd8086 |
uint8_t subchannel_selection, uint16_t i_blocksize,
|
|
Packit |
dd8086 |
uint32_t i_blocks);
|
|
Packit |
dd8086 |
|
|
Packit |
dd8086 |
/**
|
|
Packit |
dd8086 |
Request information about et drive capabilities via SCSI-MMC READ
|
|
Packit |
dd8086 |
DISC INFORMATION
|
|
Packit |
dd8086 |
|
|
Packit |
dd8086 |
@param p_cdio the CD object to be acted upon.
|
|
Packit |
dd8086 |
|
|
Packit |
dd8086 |
@param p_buf pointer to location to store mode sense information
|
|
Packit |
dd8086 |
|
|
Packit |
dd8086 |
@param i_size number of bytes allocated to p_buf
|
|
Packit |
dd8086 |
|
|
Packit |
dd8086 |
@param data_type kind of information to retrieve.
|
|
Packit |
dd8086 |
|
|
Packit |
dd8086 |
@param i_timeout_ms value in milliseconds to use on timeout. Setting
|
|
Packit |
dd8086 |
to 0 uses the default time-out value stored in
|
|
Packit |
dd8086 |
mmc_timeout_ms.
|
|
Packit |
dd8086 |
|
|
Packit |
dd8086 |
@return DRIVER_OP_SUCCESS (0) if we got the status.
|
|
Packit |
dd8086 |
*/
|
|
Packit |
dd8086 |
driver_return_code_t
|
|
Packit |
dd8086 |
mmc_read_disc_information(const CdIo_t *p_cdio, /*out*/ void *p_buf,
|
|
Packit |
dd8086 |
unsigned int i_size,
|
|
Packit |
dd8086 |
cdio_mmc_read_disc_info_datatype_t data_type,
|
|
Packit |
dd8086 |
unsigned int i_timeout_ms);
|
|
Packit |
dd8086 |
|
|
Packit |
dd8086 |
/**
|
|
Packit |
dd8086 |
Set the drive speed in K bytes per second using SCSI-MMC SET SPEED.
|
|
Packit |
dd8086 |
|
|
Packit |
dd8086 |
|
|
Packit |
dd8086 |
@param p_cdio CD structure set by cdio_open().
|
|
Packit |
dd8086 |
@param i_Kbs_speed speed in K bytes per second. Note this is
|
|
Packit |
dd8086 |
not in standard CD-ROM speed units, e.g.
|
|
Packit |
dd8086 |
1x, 4x, 16x as it is in cdio_set_speed.
|
|
Packit |
dd8086 |
To convert CD-ROM speed units to Kbs,
|
|
Packit |
dd8086 |
multiply the number by 176 (for raw data)
|
|
Packit |
dd8086 |
and by 150 (for filesystem data).
|
|
Packit |
dd8086 |
Also note that ATAPI specs say that a value
|
|
Packit |
dd8086 |
less than 176 will result in an error.
|
|
Packit |
dd8086 |
On many CD-ROM drives,
|
|
Packit |
dd8086 |
specifying a value too large will result in using
|
|
Packit |
dd8086 |
the fastest speed.
|
|
Packit |
dd8086 |
|
|
Packit |
dd8086 |
@param i_timeout_ms value in milliseconds to use on timeout. Setting
|
|
Packit |
dd8086 |
to 0 uses the default time-out value stored in
|
|
Packit |
dd8086 |
mmc_timeout_ms.
|
|
Packit |
dd8086 |
|
|
Packit |
dd8086 |
@return the drive speed if greater than 0. -1 if we had an error. is -2
|
|
Packit |
dd8086 |
returned if this is not implemented for the current driver.
|
|
Packit |
dd8086 |
|
|
Packit |
dd8086 |
@see cdio_set_speed and mmc_set_drive_speed
|
|
Packit |
dd8086 |
*/
|
|
Packit |
dd8086 |
driver_return_code_t mmc_set_speed( const CdIo_t *p_cdio,
|
|
Packit |
dd8086 |
int i_Kbs_speed,
|
|
Packit |
dd8086 |
unsigned int i_timeout_ms);
|
|
Packit |
dd8086 |
|
|
Packit |
dd8086 |
/**
|
|
Packit |
dd8086 |
Load or Unload media using a MMC START STOP UNIT command.
|
|
Packit |
dd8086 |
|
|
Packit |
dd8086 |
@param p_cdio the CD object to be acted upon.
|
|
Packit |
dd8086 |
|
|
Packit |
dd8086 |
@param b_eject eject if true and close tray if false
|
|
Packit |
dd8086 |
|
|
Packit |
dd8086 |
@param b_immediate wait or don't wait for operation to complete
|
|
Packit |
dd8086 |
|
|
Packit |
dd8086 |
@param power_condition Set CD-ROM to idle/standby/sleep. If nonzero,
|
|
Packit |
dd8086 |
eject/load is ignored, so set to 0 if you want to eject or load.
|
|
Packit |
dd8086 |
|
|
Packit |
dd8086 |
@param i_timeout_ms value in milliseconds to use on timeout. Setting
|
|
Packit |
dd8086 |
to 0 uses the default time-out value stored in
|
|
Packit |
dd8086 |
mmc_timeout_ms.
|
|
Packit |
dd8086 |
|
|
Packit |
dd8086 |
@return DRIVER_OP_SUCCESS if we ran the command ok.
|
|
Packit |
dd8086 |
|
|
Packit |
dd8086 |
@see mmc_eject_media or mmc_close_tray
|
|
Packit |
dd8086 |
*/
|
|
Packit |
dd8086 |
driver_return_code_t mmc_start_stop_unit(const CdIo_t *p_cdio, bool b_eject,
|
|
Packit |
dd8086 |
bool b_immediate,
|
|
Packit |
dd8086 |
uint8_t power_condition,
|
|
Packit |
dd8086 |
unsigned int i_timeout_ms);
|
|
Packit |
dd8086 |
|
|
Packit |
dd8086 |
/**
|
|
Packit |
dd8086 |
Check if drive is ready using SCSI-MMC TEST UNIT READY command.
|
|
Packit |
dd8086 |
|
|
Packit |
dd8086 |
@param p_cdio the CD object to be acted upon.
|
|
Packit |
dd8086 |
|
|
Packit |
dd8086 |
@param i_timeout_ms value in milliseconds to use on timeout. Setting
|
|
Packit |
dd8086 |
to 0 uses the default time-out value stored in
|
|
Packit |
dd8086 |
mmc_timeout_ms.
|
|
Packit |
dd8086 |
|
|
Packit |
dd8086 |
@return DRIVER_OP_SUCCESS if we ran the command ok.
|
|
Packit |
dd8086 |
*/
|
|
Packit |
dd8086 |
driver_return_code_t mmc_test_unit_ready(const CdIo_t *p_cdio,
|
|
Packit |
dd8086 |
unsigned int i_timeout_ms);
|
|
Packit |
dd8086 |
|
|
Packit |
dd8086 |
/**
|
|
Packit |
dd8086 |
Issue a READ SUB-CHANNEL command to read current position, ISRC or
|
|
Packit |
dd8086 |
MCN from subchannel Q.
|
|
Packit |
dd8086 |
Note: READ SUB-CHANNEL is deprecated as of MMC-5
|
|
Packit |
dd8086 |
but the alternative requires manual parsing of the subchannel.
|
|
Packit |
dd8086 |
|
|
Packit |
dd8086 |
@param p_cdio the CD object to be acted upon.
|
|
Packit |
dd8086 |
@param i_track track number (only for ISRC)
|
|
Packit |
dd8086 |
@param sub_chan_param 1 for CD current position, 2 for MCN, 3 for ISRC
|
|
Packit |
dd8086 |
@param i_length pointer to number of bytes to request.
|
|
Packit |
dd8086 |
Will be overwritten by the number of bytes available.
|
|
Packit |
dd8086 |
@param p_buf pointer to the location for the returned data
|
|
Packit |
dd8086 |
@param i_timeout_ms numober of milliseconds to wait for command completion
|
|
Packit |
dd8086 |
|
|
Packit |
dd8086 |
@return DRIVER_OP_SUCCESS on success
|
|
Packit |
dd8086 |
*/
|
|
Packit |
dd8086 |
driver_return_code_t
|
|
Packit |
dd8086 |
mmc_read_subchannel ( const CdIo_t *p_cdio,
|
|
Packit |
dd8086 |
track_t i_track,
|
|
Packit |
dd8086 |
unsigned char sub_chan_param,
|
|
Packit |
dd8086 |
unsigned int *i_length,
|
|
Packit |
dd8086 |
char *p_buf,
|
|
Packit |
dd8086 |
unsigned int i_timeout_ms
|
|
Packit |
dd8086 |
);
|
|
Packit |
dd8086 |
|
|
Packit |
dd8086 |
|
|
Packit |
dd8086 |
/**
|
|
Packit |
dd8086 |
Issue a READ TOC/PMA/ATIP command to read the CD-TEXT from R-W sub-channel.
|
|
Packit |
dd8086 |
|
|
Packit |
dd8086 |
@param p_cdio the CD object to be acted upon.
|
|
Packit |
dd8086 |
@param i_length pointer to number of bytes to request.
|
|
Packit |
dd8086 |
Will be overwritten by the number of bytes available.
|
|
Packit |
dd8086 |
@param p_buf pointer to the location for the returned data
|
|
Packit |
dd8086 |
@param i_timeout_ms value in milliseconds to use on timeout. Setting
|
|
Packit |
dd8086 |
to 0 uses the default time-out value stored in
|
|
Packit |
dd8086 |
mmc_timeout_ms.
|
|
Packit |
dd8086 |
|
|
Packit |
dd8086 |
@return DRIVER_OP_SUCCESS on success
|
|
Packit |
dd8086 |
*/
|
|
Packit |
dd8086 |
driver_return_code_t
|
|
Packit |
dd8086 |
mmc_read_toc_cdtext ( const CdIo_t *p_cdio, unsigned int *i_length,
|
|
Packit |
dd8086 |
unsigned char *p_buf, unsigned int i_timeout_ms );
|
|
Packit |
dd8086 |
|
|
Packit |
dd8086 |
|
|
Packit |
dd8086 |
#ifndef DO_NOT_WANT_OLD_MMC_COMPATIBILITY
|
|
Packit |
dd8086 |
#define mmc_start_stop_media(c, e, i, p, t) \
|
|
Packit |
dd8086 |
mmc_start_stop_unit(c, e, i, p, t, 0)
|
|
Packit |
dd8086 |
#endif /*DO_NOT_WANT_PARANOIA_COMPATIBILITY*/
|
|
Packit |
dd8086 |
|
|
Packit |
dd8086 |
#ifdef __cplusplus
|
|
Packit |
dd8086 |
}
|
|
Packit |
dd8086 |
#endif /* __cplusplus */
|
|
Packit |
dd8086 |
|
|
Packit |
dd8086 |
#endif /* CDIO_MMC_HL_CMDS_H_ */
|
|
Packit |
dd8086 |
|
|
Packit |
dd8086 |
/*
|
|
Packit |
dd8086 |
* Local variables:
|
|
Packit |
dd8086 |
* c-file-style: "gnu"
|
|
Packit |
dd8086 |
* tab-width: 8
|
|
Packit |
dd8086 |
* indent-tabs-mode: nil
|
|
Packit |
dd8086 |
* End:
|
|
Packit |
dd8086 |
*/
|