enumerazione UFS_ATTRIBUTES_DESCRIPTOR (ufs.h)

Articolo
02/07/2025

UFS_ATTRIBUTES_DESCRIPTOR descrive i diversi tipi di attributi usati dai descrittori UFS (Universal Flash Storage).

Sintassi

typedef enum {
  UFS_bBootLunEn,
  UFS_Reserved_01,
  UFS_bCurrentPowerMode,
  UFS_bActiveICCLevel,
  UFS_bOutOfOrderDataEn,
  UFS_bBackgroundOpStatus,
  UFS_bPurgeStatus,
  UFS_bMaxDataInSize,
  UFS_bMaxDataOutSize,
  UFS_dDynCapNeeded,
  UFS_bRefClkFreq,
  UFS_bConfigDescrLock,
  UFS_bMaxNumOfRTT,
  UFS_wExceptionEventControl,
  UFS_wExceptionEventStatus,
  UFS_dSecondsPassed,
  UFS_wContextConf,
  UFS_Obsolete,
  UFS_Reserved_12,
  UFS_Reserved_13,
  UFS_bDeviceFFUStatus,
  UFS_bPSAState,
  UFS_dPSADataSize,
  UFS_bRefClkGatingWaitTime,
  UFS_bDeviceCaseRoughTemperature,
  UFS_bDeviceTooHighTempBoundary,
  UFS_bDeviceTooLowTempBoundary,
  UFS_bThrottlingStatus,
  UFS_bWriteBoosterBufferFlushStatus,
  UFS_bAvailableWriteBoosterBufferSize,
  UFS_bWriteBoosterBufferLifeTimeEst,
  UFS_dCurrentWriteBoosterBufferSize,
  UFS_Reserved_20,
  UFS_Reserved_21,
  UFS_Reserved_22,
  UFS_Reserved_23,
  UFS_Reserved_24,
  UFS_Reserved_25,
  UFS_Reserved_26,
  UFS_Reserved_27,
  UFS_Reserved_28,
  UFS_Reserved_29,
  UFS_Reserved_2A,
  UFS_Reserved_2B,
  UFS_bRefreshStatus,
  UFS_bRefreshFreq,
  UFS_bRefreshUnit,
  UFS_bRefreshMethod
} UFS_ATTRIBUTES_DESCRIPTOR;

Costanti


`UFS_bBootLunEn` Indica se il numero di unità logica di avvio (LUN) è abilitato.
`UFS_Reserved_01` Riservato per uso futuro.
`UFS_bCurrentPowerMode` Indica la modalità di alimentazione corrente. Per i valori possibili, vedere la sezione Note.
`UFS_bActiveICCLevel` Specifica il consumo corrente massimo consentito durante la modalità attiva. Il valore è compreso tra 0x00 e 0x0F.
`UFS_bOutOfOrderDataEn` Specifica se il trasferimento dati non ordinato è abilitato.
`UFS_bBackgroundOpStatus` Specifica se il dispositivo ha bisogno di operazioni in background. Per i valori possibili, vedere la sezione Note.
`UFS_bPurgeStatus` Specifica lo stato dell'operazione di eliminazione corrente.
`UFS_bMaxDataInSize` Specifica le dimensioni massime dei dati in un'unità di informazione del protocollo UFS (DATA IN UFS). Questo parametro può essere scritto dall'host solo quando tutte le code di attività dell'unità logica sono vuote.
`UFS_bMaxDataOutSize` Specifica le dimensioni massime di uscita dei dati. Questo parametro può essere scritto dall'host solo quando tutte le code di attività dell'unità logica sono vuote.
`UFS_dDynCapNeeded` Specifica la necessità di capacità dinamica.
`UFS_bRefClkFreq` Specifica il valore della frequenza di clock di riferimento. Per i valori possibili, vedere la sezione Note.
`UFS_bConfigDescrLock` Specifica se il descrittore di configurazione è bloccato.
`UFS_bMaxNumOfRTT` Definisce il numero massimo corrente di elementi READY TO TRANSFER UPIU (RTT) in sospeso consentiti. Questo valore può essere impostato dall'host.
`UFS_wExceptionEventControl` Specifica il controller eventi eccezione. UFS_wExceptionEventControl abilita l'impostazione del bit EVENT_ALERT nel campo Informazioni sul dispositivo, contenuto nell'UPIU RESPONSE.
`UFS_wExceptionEventStatus` Specifica una bitmap di ogni stato dell'evento di eccezione. Verrà impostato un bit solo se si è verificato l'evento pertinente (indipendentemente dallo stato UFS_wExceptionEventControl). Per i valori possibili, vedere la sezione Note.
`UFS_dSecondsPassed` Specifica il tempo trascorso in secondi.
`UFS_wContextConf` Specifica l'attributo di contesto.
`UFS_Obsolete` Obsoleto
`UFS_Reserved_12` Riservato per uso futuro.
`UFS_Reserved_13` Riservato per uso futuro.
`UFS_bDeviceFFUStatus` Specifica lo stato FFU (Device Field Firmware Update). Per i valori possibili, vedere la sezione Note.
`UFS_bPSAState` Specifica lo stato corrente di Product State Awareness (PSA). Per i valori possibili, vedere la sezione Note.
`UFS_dPSADataSize` Specifica la quantità di dati che l'host prevede di caricare in tutte le unità logiche con bPSASensitive impostata su 1.
`UFS_bRefClkGatingWaitTime` Specifica il tempo di attesa dell'orologio di riferimento.
`UFS_bDeviceCaseRoughTemperature` Specifica la temperatura approssimativa del caso del dispositivo.
`UFS_bDeviceTooHighTempBoundary` Specifica il limite superiore per la temperatura del dispositivo.
`UFS_bDeviceTooLowTempBoundary` Specifica il limite inferiore per la temperatura del dispositivo.
`UFS_bThrottlingStatus` Specifica lo stato della limitazione.
`UFS_bWriteBoosterBufferFlushStatus` Specifica lo stato di scaricamento del buffer del booster di scrittura.
`UFS_bAvailableWriteBoosterBufferSize` Specifica le dimensioni disponibili del buffer del booster di scrittura.
`UFS_bWriteBoosterBufferLifeTimeEst` Specifica la stima della durata del buffer del booster di scrittura.
`UFS_dCurrentWriteBoosterBufferSize` Specifica le dimensioni correnti del buffer del booster di scrittura.
`UFS_Reserved_20` Riservato per uso futuro.
`UFS_Reserved_21` Riservato per uso futuro.
`UFS_Reserved_22` Riservato per uso futuro.
`UFS_Reserved_23` Riservato per uso futuro.
`UFS_Reserved_24` Riservato per uso futuro.
`UFS_Reserved_25` Riservato per uso futuro.
`UFS_Reserved_26` Riservato per uso futuro.
`UFS_Reserved_27` Riservato per uso futuro.
`UFS_Reserved_28` Riservato per uso futuro.
`UFS_Reserved_29` Riservato per uso futuro.
`UFS_Reserved_2A` Riservato per uso futuro.
`UFS_Reserved_2B` Riservato per uso futuro.
`UFS_bRefreshStatus` Specifica lo stato di aggiornamento.
`UFS_bRefreshFreq` Specifica la frequenza di aggiornamento.
`UFS_bRefreshUnit` Specifica le unità di aggiornamento.
`UFS_bRefreshMethod` Specifica il metodo refresh.

Osservazioni

UFS_bCurrentPowerMode è l'unico attributo necessario per restituire il dispositivo in qualsiasi modalità di alimentazione. Se il dispositivo non è in modalità di alimentazione attiva o inattiva, un QUERY REQUEST UPIU per accedere a descrittori, flag o attributi diversi da bCurrentPowerMode potrebbe non riuscire.

Tje UFS_bDeviceFFUStatus valore viene mantenuto dopo il ciclo di alimentazione, la reimpostazione hardware o qualsiasi altro tipo di reimpostazione. Questo attributo può modificare il valore quando si verifica un evento di attivazione di microcodice.

UFS_bMaxDataInSize è uguale a bMaxInBufferSize quando viene fornito un dispositivo UFS.

Valori possibili per alcuni campi

UFS_bCurrentPowerMode contiene uno dei valori seguenti:

Valore	Descrizione
0x00	Modalità di alimentazione inattiva.
0x10	Modalità di alimentazione pre-attiva.
0x11	Modalità di alimentazione attiva.
0x20	Modalità di alimentazione pre-sospensione.
0x22	Modalità di alimentazione UFS (Universal Flash Storage).
0x30	Sono stati usati 40% a 50% del tempo di vita stimato del dispositivo.
0x33	Sono stati usati 50% a 60% del tempo di vita stimato del dispositivo.
Tutti gli altri valori	Riservato per uso futuro.

UFS_bBackgroundOpStatus contiene uno dei valori seguenti:

Valore	Descrizione
0x00	Il dispositivo non richiede alcuna operazione in background.
0x01	Il dispositivo ha una necessità non critica di operazioni in background.
0x02	Il dispositivo ha un'esigenza basata sulle prestazioni delle operazioni in background.
0x03	Il dispositivo ha una necessità critica di operazioni in background.

UFS_bRefClkFreq contiene uno dei valori seguenti:

Valore	Descrizione
0x00	19,2 MHz
0x01	26 MHz
0x02	38,4 MHz
0x03	52 MHz

UFS_wExceptionEventStatus contiene i bit seguenti:

Pezzo	Valore
0	DYNCAP_NEEDED
1	SYSPOOL_EXHAUSTED
2	URGENT_BKOPS
Da 3 a 15	Riservato.

UFS_bDeviceFFUStatus contiene uno dei valori seguenti:

Valore	Descrizione
0x00	Nessuna informazione sullo stato FFU.
0x01	Aggiornamento del microcodice completato.
0x02	Errore di danneggiamento del microcodice.
0x03	Errore interno.
0x04	Mancata corrispondenza della versione del microcodice.
0x05 a 0xFE	Riservato.
0xFF	Errore generale.

UFS_bPSAState contiene uno dei valori seguenti:

Valore	Stato	Descrizione
0x00	Spento	La funzionalità PSA è disattivata.
0x01	Pre-venduto	La funzionalità PSA è attivata e il dispositivo è in uno stato di pre-saldatura.
0x02	Caricamento completato	La caratteristica PSA è attivata. L'host verrà impostato su questo valore dopo che l'host ha terminato la scrittura dei dati durante lo stato di pre-saldatura.
0x03	Saldato	La funzionalità PSA non è più disponibile. Impostato dal dispositivo per indicare che si trova in uno stato post-soldering. Questo attributo è bloccato dopo che si trova nello stato "Soldered".

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 10, versione 1709
server minimo supportato	Windows Server 2016
intestazione	ufs.h

Vedere anche

UFS_CONFIG_DESCRIPTORUFS_DEVICE_DESCRIPTORUFS_DEVICE_HEALTH_DESCRIPTORUFS_GEOMETRY_DESCRIPTORUFS_INTERCONNECT_DESCRIPTORUFS_POWER_DESCRIPTORUFS_RPMB_UNIT_DESCRIPTORUFS_STRING_DESCRIPTORUFS_UNIT_CONFIG_DESCRIPTORUFS_UNIT_DESCRIPTOR

Condividi tramite