Avatar
www.fr-an.de

Hardwareinformationen

Firmware Information

GET CONFIGURATION Command - Operation Code $46
FIRMWARE INFORMATION FEATURE - Feature Number $010C

Multi-Media Commands - 6 Kapitel 6.5: Mit dem GET CONFIGURATION Command werden Informationen über die Eigenschaften des Laufwerkes ermittelt. Die Eigenschaften können insgesamt oder einzeln abgerufen werden. Das FIRMWARE INFORMATION Feature in Kapitel 5.3.43 ist optional. Bis zu den MMC-3 war das Feature reserviert. Es sollte jedoch bei echten Laufwerken vorhanden sein, welche die MMC-4 und neuer unterstützen. Virtuelle Laufwerke scheinen dieses Feature nicht zu unterstützen.

Diese Eigenschaft gibt an, wann die gegenwärtige Firmware des Laufwerkes entwickelt wurde. Es wird das Datum und die Uhrzeit zur Verfügung gestellt. Sie werden in GMT angegeben. Wenn diese Eigenschaft unterstützt wird, kann der Wert nicht geändert werden und die Eigenschaft ist immer aktiv.

Der GET CONFIGURATION Command Descriptor Block:

  7 6 5 4 3 2 1 0
0 Operation Code ($46)
1 Reserviert RT
2 Starting Feature Number
3
4 Reserviert
5
6
7 Allocation Length
8
9 Control

 

Die zu setzenden Werte:

Byte 0: Operation Code - $46

Byte 1: RT - Request Type:

Wert Beschreibung
00b Das Laufwerk soll den Feature Header und alle durch das Laufwerk unterstützten Feature Beschreibungen zurückgeben ohne Rücksicht auf Geltung.
01b Das Laufwerk soll den Feature Header und nur die gewählte Feature Beschreibung zurückgeben.
10b Das Laufwerk soll den Feature Header und nur die gewählte Feature Beschreibung zurückgeben. Wird das Feature nicht unterstützt, soll nur der Feature Header zurückgegeben werden.
11b Reserviert

 
Byte 2 und 3: Starting Feature Number - Gibt die Nummer des Feature, welches zuerst ausgegeben werden soll, an. Abhängig vom Request Type kann es auch das einzige sein. Das FIRMWARE INFORMATION FEATURE hat die Featurenummer $010C.

Byte 7 und 8: Länge der Antwortstruktur. Die Länge muss mindestens so groß gewählt werden, dass die erwartete Antwort auf jeden Fall hineinpasst. Die Beschreibung des FIRMWARE INFORMATION FEATURE hat eine Länge von 20 Byte. Mit den acht Byte des Feature Headers ergeben sich 28 Byte.

Byte 9: Control - ?

Die Werte werden ein- und übertragen. Das Beispiel ist vielleicht etwas umständlich, aber übersichtlicher und eben nur ein Beispiel:

 
  const
    SCSIOP_GET_CONFIGURATION     = $46;
    FEATURE_FIRMWARE_INFORMATION = $010C;
    RT_All                       = 0;
    RT_Current                   = 1;
    RT_Identified                = 2;
 
  type
    TGET_CONFIGURATION_CDB = record
      OperationCode         : Byte;
      RequestType           : Byte;
      StartingFeatureNumber : Word;
      AllocationLength      : Word;
    end;
 
    ...
 
  begin
 
    ...
 
    {
    *  Den Command Descriptor Block füllen.
    }
    ZeroMemory(@GET_CONFIGURATION_CDB, SizeOf(TGET_CONFIGURATION_CDB));
    GET_CONFIGURATION_CDB.OperationCode         := SCSIOP_GET_CONFIGURATION;
    GET_CONFIGURATION_CDB.RequestType           := RT_Identified;
    GET_CONFIGURATION_CDB.StartingFeatureNumber := FEATURE_FIRMWARE_INFORMATION;
    GET_CONFIGURATION_CDB.AllocationLength      := SizeOf(TGET_CONFIGURATION_FIRM);
    {
    *  Den Command Descriptor Block übertragen.
    }
    SetLength(aCDB, 10);
    aCDB[0] := GET_CONFIGURATION_CDB.OperationCode;
    aCDB[1] := GET_CONFIGURATION_CDB.RequestType;
    aCDB[2] := HiByte(GET_CONFIGURATION_CDB.StartingFeatureNumber);
    aCDB[3] := LoByte(GET_CONFIGURATION_CDB.StartingFeatureNumber);
    aCDB[7] := HiByte(GET_CONFIGURATION_CDB.AllocationLength);
    aCDB[8] := LoByte(GET_CONFIGURATION_CDB.AllocationLength);
 
    ...
 
  end;

 

Die Antwortstruktur - Firmware Information Feature:

Diese Struktur hat eine Länge von 28 Byte. Wenn das Feature nicht unterstützt wird, ist sie acht Byte lang. Zuerst der Feature Header:

  7 6 5 4 3 2 1 0
0 Data Length
1
2
3
4 Reserviert
5
6 Current Profile
7

 
Anschließend folgt die FIRMWARE INFORMATION FEATURE Beschreibung, falls dieses Feature unterstützt wird:

  7 6 5 4 3 2 1 0
0 Feature Code = $010C
1
2 Reserviert Version = 0000b Persistent Current
3 Additional Length = $10
4 Century = Jahrhundert
5
6 Year = Jahr
7
8 Month = Monat
9
10 Day = Tag
11
12 Hour = Stunde
13
14 Minute = Minute
15
16 Second = Sekunde
17
18 Reserviert
19 
 
  type
    TFEATURE_FIRMWARE_INFORMATION = record
      Data     : array[0..3] of Byte;
      Century  : array[0..1] of AnsiChar;
      Year     : array[0..1] of AnsiChar;
      Month    : array[0..1] of AnsiChar;
      Day      : array[0..1] of AnsiChar;
      Hour     : array[0..1] of AnsiChar;
      Minute   : array[0..1] of AnsiChar;
      Second   : array[0..1] of AnsiChar;
      Reserved : array[0..1] of AnsiChar;
    end;

    TGET_CONFIGURATION_FIRMWARE_INFORMATION = record
      Header : array[0..7] of Byte;
      Info   : TFEATURE_FIRMWARE_INFORMATION;
    end;

 

Ausführung und Auswertung

Nach der Ausführung wird die Antwortstruktur ausgewertet.

 
  type
    TGetConfigurationHeader = record
      DataLength     : DWord;
      CurrentProfile : Word;
    end;
 
    TFeatureFirmwareInformation = record
      FeatureCode  : Word;
      Version      : Byte;
      Persistent   : Boolean;
      Current      : Boolean;
      AddLength    : Byte;
      CenturyYear  : AnsiString;
      Month        : AnsiString;
      Day          : AnsiString;
      Hour         : AnsiString;
      Minute       : AnsiString;
      Second       : AnsiString;
    end;
 
    ...
 
  begin
 
    ...
 
    {
    *  Befehl ausführen
    }
    if GET_SCSI_PASS_THROUGH_DIRECT(aDrive, aCDB, @GET_CONFIGURATION_FIRMWARE,
                                    SizeOf(TGET_CONFIGURATION_FIRMWARE_INFORMATION))
    then begin
      ConfigHead.DataLength     := GET_CONFIGURATION_FIRM.Header[0] shl 24 or
                                   GET_CONFIGURATION_FIRM.Header[1] shl 16 or
                                   GET_CONFIGURATION_FIRM.Header[2] shl  8 or
                                   GET_CONFIGURATION_FIRM.Header[3];
      ConfigHead.CurrentProfile := GET_CONFIGURATION_FIRM.Header[6] shl 8 or
                                   GET_CONFIGURATION_FIRM.Header[7];
      FirmwareInfo.FeatureCode  := GET_CONFIGURATION_FIRM.Data[0] shl 8 or
                                   GET_CONFIGURATION_FIRM.Data[1];
      FirmwareInfo.Version      := GET_CONFIGURATION_FIRM.Data[2] and $3C shr 2;
      FirmwareInfo.Persistent   := GET_CONFIGURATION_FIRM.Data[2] and $02 > 0;
      FirmwareInfo.Current      := GET_CONFIGURATION_FIRM.Data[2] and $01 > 0;
      FirmwareInfo.AddLength    := GET_CONFIGURATION_FIRM.Data[3];
      FirmwareInfo.Century      := GET_CONFIGURATION_FIRM.Info.Century;
      FirmwareInfo.Year         := GET_CONFIGURATION_FIRM.Info.Year;
      FirmwareInfo.Month        := GET_CONFIGURATION_FIRM.Info.Month;
      FirmwareInfo.Day          := GET_CONFIGURATION_FIRM.Info.Day;
      FirmwareInfo.Hour         := GET_CONFIGURATION_FIRM.Info.Hour;
      FirmwareInfo.Minute       := GET_CONFIGURATION_FIRM.Info.Minute;
      FirmwareInfo.Second       := GET_CONFIGURATION_FIRM.Info.Second;
    end;
 
    ...
 
  end;

 

Data Length - Die Datenlänge im Header gibt die Länge des noch folgenden Headerrestes und der Feature Bechreibung an. Wird das Feature nicht unterstützt ist der Wert vier, sonst 24.

Current Profile - Gibt das aktive Profil an. Das Profil ist vom Laufwerk und dem eingelegten Datenträger abhängig. Sind mehrere Profile aktiv wird das Profil mit der höchsten Nummer angegeben. (Liste der Profile in einem Fenster öffnen.)

Feature Code - Muss der selbe wie im CDB sein. Hier war das FIRMWARE INFORMATION Feature mit der Nummer $010C ausgewählt.

Version - Die Versionsnummer muss 0000b sein.

Persistent und Current - Müssen, wenn das Feature unterstützt wird gesetzt sein.

Additional Length - Der Wert muss $10 betragen.

Century, Year, Month, Day, Hour, Minute und Second sind numerische Werte als ASCII-Zeichen. Deshalb sind diese Felder in der Antwortstruktur als Character vereinbart.

 

Demo, welche diese Funktion nutzt:

Hardware Firmware (podHardFirm.7z - 255 kb) MD5 (1 kb). Stand: 10. Januar 2012

 

Fr_An - Erstellt: 9. Januar 2012 - Letzte Änderung: 21. Januar 2012

seit 28. Juli 2010