enumerazione UFS_ATTRIBUTES_DESCRIPTOR (ufs.h)

Articolo
04/03/2024

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_bCurrentPowerMode
Indica la modalità di alimentazione corrente. 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	Universal Flash Storage (UFS)-Modalità di alimentazione sospensione.
0x30	È stato usato dal 40% al 50% del tempo di vita stimato del dispositivo.
0x33	È stato usato dal 50% al 60% del tempo di vita stimato del dispositivo.
Tutti gli altri valori	Riservato per utilizzi futuri.

UFS_bActiveICCLevel
Specifica il valore massimo
consumo corrente consentito durante
Modalità attiva. Il valore è compreso tra 0x00 e 0x0F.

UFS_bOutOfOrderDataEn
Specifica se il trasferimento dei dati non in ordine è
Enabled

UFS_bBackgroundOpStatus
Specifica se il dispositivo ha bisogno di operazioni in background. 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 un'esigenza critica di operazioni in background.

UFS_bPurgeStatus
Specifica lo stato dell'operazione di eliminazione corrente.

UFS_bMaxDataInSize
Specifica le dimensioni massime dei dati in un'unità di informazioni sui protocolli UFS (UPIU). Questo parametro può essere scritto da
host solo quando tutte le code di attività delle unità logiche sono
vuoto

UFS_bMaxDataOutSize
Specifica la dimensione massima di uscita dei dati. Questo parametro può essere scritto da
host solo quando tutte le code di attività delle unità logiche sono
vuoto

UFS_dDynCapNeeded
Specifica la capacità dinamica necessaria.

UFS_bRefClkFreq
Specifica il valore della frequenza di clock di riferimento.

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

UFS_bConfigDescrLock
Specifica se il descrittore di configurazione è bloccato.

UFS_bMaxNumOfRTT
Definisce il numero massimo corrente di operazioni READY TO TRANSFER UPIU (RTT) in sospeso
Consentito. Questo valore può essere impostato dall'host.

UFS_wExceptionEventControl
Specifica il controller eventi di eccezione. UFS_wExceptionEventControl abilita l'impostazione di
EVENT_ALERT bit nel dispositivo
Campo informativo, contenuto in
RISPOSTA UPIU.

UFS_wExceptionEventStatus
Specifica una bitmap di ogni stato dell'evento di eccezione. Un bit verrà impostato solo se
si è verificato un evento rilevante
(indipendentemente dal
UFS_wExceptionEventControl stato). Contiene i bit seguenti:

bit	Valore
0	DYNCAP_NEEDED
1	SYSPOOL_EXHAUSTED
2	URGENT_BKOPS
da 3 a 15	Riservato.

UFS_dSecondsPassed
Specifica il tempo trascorso in secondi.

UFS_wContextConf
Specifica l'attributo di contesto.

UFS_Obsolete
Obsoleti

UFS_bDeviceFFUStatus
Specifica lo stato FFU (Device Field Firmware Update).

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

UFS_bPSAState
Specifica lo stato corrente di Consapevolezza dello stato del prodotto (PSA).

Valore	State	Descrizione
0x00	Off	La funzionalità PSA è disattivata.
0x01	Pre-solder	La funzionalità PSA è attiva e il dispositivo si trova in uno stato di pre-soldering.
0x02	Caricamento completo	La funzionalità PSA è attivo. L'host verrà impostato su questo valore dopo il completamento dell'host scrittura di dati durante il soldering .
0x03	Saldato	La funzionalità PSA non è disponibile più a lungo. Imposta in base all'oggetto Dispositivo per indicare che si trova in uno stato post-soldering. Questo attributo è bloccato dopo che è in Stato "Soldered".

UFS_dPSADataSize
Specifica la quantità di dati che i piani host
per caricare in tutte le unità logiche con
bPSASensitive impostato su 1.

Commenti

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'UPIU RICHIESTA QUERY per accedere ai descrittori, ai flag o agli attributi diversi da bCurrentPowerMode potrebbe non riuscire.

UFS_bDeviceFFUStatuvalore 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.