Driver De Dispositivo Cliente USB Mass Storage

Um dispositivo pode ser aberto no modo Diagnostic apenas se o dispositivo de destino não for aberto atualmente. Se você abrir um dispositivo noDiagnostic modo quando o dispositivo de destino já está aberto, a sub-rotina retorna um valor de-1 e define o errno variável global para um valor deEACCES .

Um dispositivo pode ser aberto no modo Exclusive Access apenas se o dispositivo não estiver atualmente aberto. Se você abrir um dispositivo noExclusive Access modo e o dispositivo já está aberto, a sub-rotina retorna um valor de-1 e define o errno variável global para um valor deEBUSY . Se a sinalização SC_DIAGNOSTIC for especificada juntamente com a sinalização SC_SINGLE , o dispositivo será colocado no modo Diagnostic .

A operação DKIORDSE é fornecida para uso diagnóstico. Ele permite o uso limitado do dispositivo de destino enquanto opera em um ambiente de sistema ativo. O parâmetro arg da operação DKIORDSE contém o endereço de uma estrutura sc_rdwrt . Essa estrutura é definida no arquivo /usr/include/sys/scsi.h .

A estrutura devinfo define o tamanho máximo de transferência para uma operação de leitura. Se você transferir mais que o limite máximo, a sub-rotina retornará um valor de-1 e define o errno variável global para um valor deEINVAL .

O byte de status SCSI e o status do adaptador bytes são retornados através do parâmetro arg que contém o endereço de uma estrutura sc_iocmd , que é definido no arquivo /usr/include/sys/scsi.h . Se oDKIOCMD operação falha, a sub-rotina retorna um valor de-1 e define o errno variável global para um valor diferente de zero. Neste caso, o responsável pela chamada deve avaliar os bytes de status retornado para determinar a causa de falha de operação e as ações de recuperação.

A estrutura devinfo define o tamanho máximo de transferência para o comando. Se você transferir mais que o valor máximo, a sub-rotina retornará um valor de-1 e define o errno variável global para um valor deEINVAL .

    char sense_data[255];
    char *data_buffer=NULL;
    struct sc_iocmd sciocmd;
....

    fd = open("/dev/usbms0", O_RDWR);
    if (fd == -1){
        printf("\niocmd: Open FAIL\n");
        exit(-1);
    }

    memset(&sciocmd, '\0', sizeof(struct scsi_iocmd));
    sciocmd.version = SCSI_VERSION_1;
    sciocmd.timeout_value = 30;
    sciocmd.command_length = 6;
    sciocmd.flags = B_READ;
    sciocmd.autosense_length = 255;
    sciocmd.autosense_buffer_ptr = &sense_data[0];

    sciocmd.data_length = 0xFF;
    sciocmd.buffer = inq_data;
    sciocmd.scsi_cdb[0] = SCSI_INQUIRY;
    sciocmd.scsi_cdb[1] = 0x00; /* Standard Inquiry*/
    sciocmd.scsi_cdb[2] = 0x00;
    sciocmd.scsi_cdb[3] = 0x00;
    sciocmd.scsi_cdb[4] = 0xFF;
    sciocmd.scsi_cdb[5] = 0x00;

    if ((rc=ioctl(fd, DKIOCMD, &sciocmd)) != 0){
        printf("iocmd: Ioctl FAIL errno %d\n",errno);
        printf("status_validity: %x, scsi_status: %x, adapter_status:%x\n",
               sciocmd.status_validity, sciocmd.scsi_bus_status,
               sciocmd.adapter_status);
        hexdump(sense_data, (long)20);
        close(fd);
        exit(-1);
    } else {
        printf("cdiocmd : Ioctl PASS\n");
        if (cmd = SCSI_INQUIRY)
            hexdump(inq_data,0x20);
    }

    close(fd);

Esta operação ioctl é semelhante à operação DKIOCMD16 que é usada para emitir 16-byte comandos SCSI para o dispositivo de armazenamento em massa USB.

O byte de status SCSI e o status do adaptador bytes são retornados através do parâmetro arg que contém o endereço de uma estrutura sc_iocmd16cdb . Essa estrutura é definida no arquivo /usr/include/sys/scsi.h . Se oDKIOLCMD operação falha, a sub-rotina retorna um valor de-1 e define o errno variável global para um valor diferente de zero. Neste caso, o responsável pela chamada deve avaliar os bytes de status retornado para determinar a causa de falha de operação e as ações de recuperação.

Na conclusão da solicitação DKIOLCMD ioctl , o campo residual indica os dados de sobra que o dispositivo não satisfez totalmente a este pedido. Em uma conclusão bem-sucedida, o campo residual indica que o dispositivo não possui todos os dados solicitados ou o dispositivo possui menor quantidade de dados do que o solicitado. Em uma falha de solicitação, você deve verificar o campo status_validity para determinar se um problema de barramento SCSI válido existe. Neste caso, o campo residual indica o número de bytes que o dispositivo não conseguiu concluir para esta solicitação.

A estrutura devinfo define o tamanho máximo de transferência para o comando. Se você transferir mais que o valor máximo, a sub-rotina retornará um valor de-1 e define o errno variável global para um valor deEINVAL .

    char sense_data[255];
    char *data_buffer=NULL;
    struct sc_iocmd16cdb sciocmd;
....

    fd = open("/dev/usbms0", O_RDWR);
    if (fd == -1){
        printf("\niocmd: Open FAIL\n");
        exit(-1);
    }

    memset(&sciocmd, '\0', sizeof(struct scsi_iocmd));
    sciocmd.version = SCSI_VERSION_1;
    sciocmd.timeout_value = 30;
    sciocmd.command_length = 6;
    sciocmd.flags = B_READ;
    sciocmd.autosense_length = 255;
    sciocmd.autosense_buffer_ptr = &sense_data[0];

    sciocmd.data_length = 0xFF;
    sciocmd.buffer = inq_data;
    sciocmd.scsi_cdb[0] = SCSI_INQUIRY;
    sciocmd.scsi_cdb[1] = 0x00; /* Standard Inquiry*/
    sciocmd.scsi_cdb[2] = 0x00;
    sciocmd.scsi_cdb[3] = 0x00;
    sciocmd.scsi_cdb[4] = 0xFF;
    sciocmd.scsi_cdb[5] = 0x00;

    if ((rc=ioctl(fd, DKIOCMD, &sciocmd)) != 0){
        printf("iocmd: Ioctl FAIL errno %d\n",errno);
        printf("status_validity: %x, scsi_status: %x, adapter_status:%x\n",
               sciocmd.status_validity, sciocmd.scsi_bus_status,
               sciocmd.adapter_status);
        hexdump(sense_data, (long)20);
        close(fd);
        exit(-1);
    } else {
        printf("cdiocmd : Ioctl PASS\n");
        if (cmd = SCSI_INQUIRY)
            hexdump(inq_data,0x20);
    }

    close(fd);

O byte de status SCSI e o status do adaptador bytes são retornados através do parâmetro arg que contém o endereço de uma estrutura sc_passthru . Essa estrutura é definida no arquivo /usr/include/sys/scsi.h . Se oDK_PASSTHRU operação falha, a sub-rotina retorna um valor de-1 e define o errno variável global para um valor diferente de zero. Neste caso, o responsável pela chamada deve avaliar os bytes de status retornado para determinar a causa de falha de operação e as ações de recuperação.

Se umDK_PASSTHRU operação falha porque um campo nosc_passthru estrutura tem um valor inválido, a sub-rotina retorna um valor de-1 e definir o errno variável global paraEINVAL . O campo einval_arg é definido para o número do campo (começando com 1 para o campo da versão) do campo que tinha um valor inválido. Um valor de 0 para o campo einval_arg indica que nenhuma informação adicional sobre a falha está disponível.

Na conclusão da solicitação DK_PASSTHRU , o campo residual indica os dados de sobra que o dispositivo não satisfez totalmente a este pedido. Em uma conclusão bem-sucedida, o campo residual indica que o dispositivo não possui todos os dados solicitados ou o dispositivo possui menor quantidade de dados do que o solicitado. Em uma falha de solicitação, você deve verificar o campo status_validity para determinar se um problema de barramento SCSI válido existe. Neste caso, o campo residual indica o número de bytes que o dispositivo não conseguiu concluir para esta solicitação.

A estrutura devinfo define o tamanho máximo de transferência para o comando. Se for feita uma tentativa de transferir mais do que o tamanho máximo de transferência, a sub-rotina retornará um valor de-1 , define o errno variável global para um valor deEINVAL , e define oeinval_arg campo para um valor deSC_PASSTHRU_INV_D_LEN . Esses valores são definidos no arquivo /usr/include/sys/scsi.h .

    char sense_data[255];
    char *data_buffer=NULL;
    struct sc_passthru sciocmd;
....

    fd = open("/dev/usbms0", O_RDWR);
    if (fd == -1){
        printf("\npassthru: Open FAIL\n");
        exit(-1);
    }

    memset(&sciocmd, '\0', sizeof(struct sc_passthru));
    sciocmd.version = SCSI_VERSION_1;
    sciocmd.timeout_value = 30;
    sciocmd.command_length = 6;
    sciocmd.autosense_length = 255;
    sciocmd.autosense_buffer_ptr = &sense_data[0];

    sciocmd.data_length = 0xFF;
    sciocmd.buffer = inq_data;

    sciocmd.flags = B_READ;

    sciocmd.scsi_cdb[0] = SCSI_INQUIRY;
    sciocmd.scsi_cdb[1] = 0x00; /* Standard Inquiry*/
    sciocmd.scsi_cdb[2] = 0x00;
    sciocmd.scsi_cdb[3] = 0x00;
    sciocmd.scsi_cdb[4] = 0xFF;
    sciocmd.scsi_cdb[5] = 0x00;

    if ((rc=ioctl(fd, DK_PASSTHRU, &sciocmd)) != 0){
        if (sciocmd.adap_set_flags & SC_AUTOSENSE_DATA_VALID) {
            /* look at sense data */
        } /* end SC_AUTOSENSE_DATA_VALID */

        printf("passthru: Ioctl FAIL errno %d\n",errno);
        printf("status_validity: %x, scsi_status: %x, adapter_status:%x\n",
               sciocmd.status_validity, sciocmd.scsi_bus_status,
               sciocmd.adapter_status);
        printf("Residual: %x\n", sciocmd.residual);
        exit(-1);
    } else {
        printf("passthru: Ioctl PASS\n");
        printf("status_validity: %x, scsi_status: %x, adapter_status:%x\n",
               sciocmd.status_validity, sciocmd.scsi_bus_status,
               sciocmd.adapter_status);
        printf("Residual: %x\n", sciocmd.residual);
        /* inq_data buffer has valid Standard Inquiry data */
    }

devinfo.devtype = DD_SCDISK;
devinfo.flags =(uchar)DF_RAND;
devinfo.devsubtype = 0x00;
devinfo.un.scdk.max_request = Maximum_transfer_supported_by_usbcd_driver;
devinfo.un.scdk.numblks = Largest_LBA_supported_by_device+1;
devinfo.un.scdk.blksize = Block_size_set_for_the_USB_Disk/Flash/RDX_Device;

devinfo.devtype = DD_CDROM;
devinfo.flags = (uchar)DF_RAND;
devinfo.devsubtype = 0x00;
devinfo.un.idecd.numblks = 
  Largest logical block addressing (LBA) supported by device + 1;
devinfo.un.idecd.blksize = Block size set for the USB Disk, flash, or RDX device;

Os bytes de status do AT Attachment (ATA) e os bytes de erro ATA são retornados através do parâmetro arg . Este parâmetro contém o endereço de uma estrutura ide_ata_passthru que é definida no arquivo /usr/include/sys/ide.h . Se oIDEPASSTHRU operação falha, a sub-rotina retorna um valor de-1 e define o errno variável global para um valor diferente de zero. Neste caso, o ouvinte avalia os bytes de status retornado para determinar a causa da falha de operação e as ações de recuperação.

Se a operação IDEPASSTHRU falhar, o driver do dispositivo executa cobrança de erro limitada. Se esta operação falhar porque um campo noide_ata_passthru estrutura tem um valor inválido, a sub-rotina retorna um valor de-1 e define o errno variável global paraEINVAL .

Na conclusão bem-sucedida da solicitação IDEPASSTHRU , o campo residual indica que o dispositivo não possui todos os dados solicitados, ou o dispositivo tem menos do que a quantidade de dados que é solicitada. Se a solicitação IDEPASSTHRU falhar, o campo residual indica o número bytes que o dispositivo falhou ao concluir para esta solicitação.

O código de exemplo a seguir emite um comando de consulta SCSI que usa a operação IDEPASSTHRU :

    struct ide_atapi_passthru atapicmd;
    char inq_buffer[255];
    uchar sense_data[255];
 
    /* set up the arg parameter block */
    memset(&atapicmd, '\0', sizeof(struct ide_atapi_passthru));
    memset(sense_data, '\0', 255);

    atapicmd.ide_device = 0;
    atapicmd.flags = IDE_PASSTHRU_READ;
    atapicmd.timeout_value    = 30;
    atapicmd.rsv0             = IDE_PASSTHRU_VERSION_01;
    atapicmd.rsv1             = 0;
    atapicmd.atapi_cmd.length = 12;
    atapicmd.atapi_cmd.resvd  = 0;
    atapicmd.atapi_cmd.resvd1 = 0;
    atapicmd.atapi_cmd.resvd2 = 0;

    atapicmd.data_ptr = inq_buffer;
    atapicmd.buffsize = 0xFF;

    atapicmd.atapi_cmd.packet.opcode  = SCSI_INQUIRY;
    atapicmd.atapi_cmd.packet.byte[0] = (0x00 | vpd)  ;  /*Standard Inquiry */
    atapicmd.atapi_cmd.packet.byte[1] = page_code;  /*Page Code-Valid if vpd=1 */
    atapicmd.atapi_cmd.packet.byte[2] = 0x00;
    atapicmd.atapi_cmd.packet.byte[3] = 0xFF;
    atapicmd.atapi_cmd.packet.byte[4] = 0x00;

    atapicmd.sense_data        = sense_data;
    atapicmd.sense_data_length = 255;

    fd = openx(“/dev/cd0”, O_RDWR, NULL, SC_DIAGNOSTIC);
    if (fd == -1) {
         printf("IDEPASSTHRU: Openx failed with errno %x \n", errno);
         exit(-1);
    }

   if ((rc = ioctl(fd, IDEPASSTHRU, &atapicmd) != 0)) {
         printf("IDEPASSTHRU: IOCTL Failed");
         printf("errno %d\n",errno);
         printf("ata_status: %x, ata_error:%x\n",
                atapicmd.ata_status, atapicmd.ata_error);
         close(fd);
         exit(-1);
     } else {
         printf("IDEPASSTHRU : Ioctl PASS\n");
         printf("ata_status: %x, ata_error: %x\n",
                atapicmd.ata_status, atapicmd.ata_error);
     }
     close(fd);

Se oDKAUDIO a operação é tentada quando o atributo de suporte de áudio do dispositivo está definido comoNo , a sub-rotina retorna um valor de-1 e define o errno variável global para um valor deEINVAL . Se oDKAUDIO operação falha, a sub-rotina retorna um valor de-1 e define o errno variável global para um valor diferente de zero. Neste caso, o responsável pela chamada deve avaliar os bytes de status retornado para determinar a causa de falhas de operação e ações de recuperação.

CD_GET_MODE

Retorna o modo de dados do CD-ROM atual no campo cd_mode_form da estrutura mode_form_op quando o dispositivo é aberto com sucesso.

CD_CHG_MODE

Altera o modo de dados do CD-ROM para o modo que é especificado no campo cd_mode_form da estrutura mode_form_op quando o dispositivo é aberto com sucesso no modo de acesso exclusivo.

Se um CD-ROM não estiver configurado para diferentes modos de dados usando os códigos de densidade de seleção de modo, e se você alterar o modo de dados do CD-ROM definindo o campo de ação dochange_mode_form estrutura para oCD_CHG_MODE comando, a sub-rotina retorna um valor de-1 e define o errno variável global para um valor deEINVAL . As tentativas de alterar o modo CD-ROM para qualquer um dos modos DVD também resultam em um valor de retorno de-1 e a errno variável global está definida comoEINVAL . Se oDK_CD_MODE operação para oCD_CHG_MODE comando é tentado quando o dispositivo não está no modo de acesso exclusivo, a sub-rotina retorna um valor de-1 e define o errno variável global para um valor deEACCES . Para qualquer outra causa de falha na operação, a sub-rotina retorna um valor de-1 e define o errno variável global para um valor deEIO .