UFS_DEVICE_DESCRIPTOR 結構 (ufs.h)

UFS_DEVICE_DESCRIPTOR 是通用 Flash 記憶體 (UFS) 裝置的主要描述元，而且應該是擷取的第一個描述元，因為它指定裝置類別和子類別，以及用來存取此裝置的通訊協定 (命令) 集，以及裝置內所含的邏輯單元數目上限) (RU 數目。

語法

typedef struct {
  UCHAR  bLength;
  UCHAR  bDescriptorIDN;
  UCHAR  bDevice;
  UCHAR  bDeviceClass;
  UCHAR  bDeviceSubClass;
  UCHAR  bProtocol;
  UCHAR  bNumberLU;
  UCHAR  bNumberWLU;
  UCHAR  bBootEnable;
  UCHAR  bDescrAccessEn;
  UCHAR  bInitPowerMode;
  UCHAR  bHighPriorityLUN;
  UCHAR  bSecureRemovalType;
  UCHAR  bSecurityLU;
  UCHAR  bBackgroundOpsTermLat;
  UCHAR  bInitActiveICCLevel;
  UCHAR  wSpecVersion[2];
  UCHAR  wManufactureDate[2];
  UCHAR  iManufacturerName;
  UCHAR  iProductName;
  UCHAR  iSerialNumberID;
  UCHAR  iOemID;
  UCHAR  wManufacturerID[2];
  UCHAR  bUD0BaseOffset;
  UCHAR  bUDConfigPLength;
  UCHAR  bDeviceRTTCap;
  UCHAR  wPeriodicRTCUpdate[2];
  UCHAR  bUFSFeaturesSupport;
  UCHAR  bFFUTimeout;
  UCHAR  bQueueDepth;
  UCHAR  wDeviceVersion[2];
  UCHAR  bNumSecureWPArea;
  UCHAR  dPSAMaxDataSize[4];
  UCHAR  dPSAStateTimeout;
  UCHAR  iProductRevisionLevel;
  UCHAR  Reserved[5];
  UCHAR  Reserved2[16];
  USHORT wHPBVersion;
  UCHAR  bHPBControl;
  UCHAR  Reserved3[12];
  UCHAR  dExtendedUFSFeaturesSupport[4];
  UCHAR  bWriteBoosterBufferPreserveUserSpaceEn;
  UCHAR  bWriteBoosterBufferType;
  UCHAR  dNumSharedWriteBoosterBufferAllocUnits[4];
} UFS_DEVICE_DESCRIPTOR, *PUFS_DEVICE_DESCRIPTOR;

成員

bLength

指定這個描述元的長度，以位元組為單位。

bDescriptorIDN

指定描述項的類型。 這個描述項的值會是 UFS_DESC_DEVICE_IDN。

bDevice

指定裝置類型。

bDeviceClass

指定裝置類別。

bDeviceSubClass

指定位對應中的 UFS 大型記憶體子類別，如下所示：

bProtocol

指定UFS裝置的通訊協議支援。

bNumberLU

指定邏輯單元的數目。 這不包括已知的邏輯單元數目。

bNumberWLU

指定已知的邏輯單元數目。

bBootEnable

指定裝置的開機功能是否已啟用。

bDescrAccessEn

指出裝置描述元是否可以在開機順序的部分初始化階段之後讀取。

bInitPowerMode

bInitPowerMode 會在裝置初始化或硬體重設之後定義電源模式。

bHighPriorityLUN

bHighPriorityLUN 會定義高優先順序邏輯單元。

bSecureRemovalType

指定安全移除類型。

bSecurityLU

指定是否支援安全性邏輯單元。

bBackgroundOpsTermLat

bBackgroundOpsTermLat 會定義在背景作業進行時啟動數據傳輸的最大延遲。 終止延遲限制適用於兩種情況：

• 當裝置收到命令 UFS 通訊協定資訊單位時， (UPIU) 傳送要求。 裝置應啟動數據傳輸，並在延遲限制內傳送數據 IN UPIU 或 RTT UPIU。
• 當裝置收到 QUERY REQUEST UPIU 以清除 fBackgroundOpsEn 旗標時。 裝置預期會在延遲限制內終止背景作業。

bInitActiveICCLevel

bInitActiveICCLevel 會在開啟電源或重設之後定義 bActiveICCLevel 值。 值的範圍是從0x00到0x0F。

wSpecVersion[2]

表示二進位編碼十進位 (BCD) 格式的規格版本。

wManufactureDate[2]

將 BCD 格式的製造日期指定為 0xMMYYY。

iManufacturerName

包含包含製造商名稱之字串的索引值。

iProductName

包含包含產品名稱之字串的索引值。

iSerialNumberID

包含包含序號之字串的索引值。

iOemID

包含包含 OEM 識別符之字串的索引值。

wManufacturerID[2]

指定裝置的製造商標識碼。

bUD0BaseOffset

指定組態描述元內單位描述元0的可設定參數位移， UFS_CONFIG_DESCRIPTOR。

bUDConfigPLength

UFS_UNIT_CONFIG_DESCRIPTOR參數的大小總計。

bDeviceRTTCap

指定裝置所支援未完成的 READY TO TRANSFER UPIU 數目上限。 最小值為 2。

wPeriodicRTCUpdate[2]

指定即時時鐘更新的頻率和方法。 保留位 10 到 15。

bUFSFeaturesSupport

指定此裝置支援哪些功能。 如果功能的相關位設定為 1，則支援此功能。

bFFUTimeout

存取裝置的時間上限，以秒為單位，會因為執行 WRITE BUFFER 命令而受限或無法透過任何相關聯的埠。

bQueueDepth

指定佇列深度。 如果此成員等於 0，裝置會實作每個 LU 佇列架構。

wDeviceVersion[2]

指定裝置版本。

bNumSecureWPArea

指定裝置所支援的安全寫入保護區域總數。 此成員的值介於 bNumberLU 和 32 之間。

dPSAMaxDataSize[4]

指定在儲存前的一個階段內可寫入之數據量上限。

dPSAStateTimeout

此成員對應於 JEDEC 規格中的 bPSAStateTimeout (29h) 。

iProductRevisionLevel

指定包含產品修訂層級之字串的索引。

Reserved[5]

保留供未來使用。

Reserved2[16]

保留供未來使用。

wHPBVersion

指定主機效能提升器版本。

bHPBControl

Reserved3[12]

保留供未來使用。

dExtendedUFSFeaturesSupport[4]

dExtendedUFSFeaturesSupport 是位掩碼，指出支援哪些擴充功能。

bWriteBoosterBufferPreserveUserSpaceEn

將 bWriteBoosterBufferPreserveUserSpaceEn 設定為 0x01 可避免在布建期間設定的使用者空間總計，但可能會導致效能降低。 如果 bWriteBoosterBufferPreserveUserSpaceEn 設定為 0x00，寫入提升器緩衝區會減少布建期間可設定的用戶空間總數。

bWriteBoosterBufferType

bWriteBoosterBufferType 會設定寫入提升器緩衝區類型。 值0x00指定邏輯單元專用緩衝區模式。 值0x01指定共用緩衝區模式。

dNumSharedWriteBoosterBufferAllocUnits[4]

dNumSharedWriteBoosterBufferAllocUnits 會指定共用寫入提升器緩衝區設定的寫入提升器緩衝區大小。

備註

如果UFS_DEVICE_DESCRIPTOR中的 bBootEnable 設定為零，或開機已知邏輯單元未對應至啟用的邏輯單元，則開機已知邏輯單元應終止。

UFS_DEVICE_DESCRIPTOR 是只讀的，其部分參數可能會變更，方法是變更 UFS_UNIT_CONFIG_DESCRIPTOR中的對應參數。

規格需求

另請參閱

• UFS_CONFIG_DESCRIPTOR
• UFS_DEVICE_HEALTH_DESCRIPTOR
• UFS_GEOMETRY_DESCRIPTOR
• UFS_INTERCONNECT_DESCRIPTOR
• UFS_POWER_DESCRIPTOR
• UFS_RPMB_UNIT_DESCRIPTOR
• UFS_STRING_DESCRIPTOR
• UFS_UNIT_CONFIG_DESCRIPTOR
• UFS_UNIT_DESCRIPTOR
• 通用 Flash 記憶體 4.0 規格