énumération UFS_ATTRIBUTES_DESCRIPTOR (ufs.h)

Article
05/29/2024

UFS_ATTRIBUTES_DESCRIPTOR décrit les différents types d’attributs utilisés par les descripteurs de stockage Flash universel (UFS).

Syntax

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;

Constantes


`UFS_bBootLunEn` Indique si le numéro d’unité logique de démarrage (LUN) est activé.
`UFS_Reserved_01` Réservé pour un usage futur.
`UFS_bCurrentPowerMode` Indique le mode d’alimentation actuel. Consultez Notes pour connaitre les valeurs possibles.
`UFS_bActiveICCLevel` Spécifie la consommation actuelle maximale autorisée en mode actif. La valeur varie de 0x00 à 0x0F.
`UFS_bOutOfOrderDataEn` Spécifie si le transfert de données en désordre est activé.
`UFS_bBackgroundOpStatus` Spécifie si l’appareil a besoin d’opérations en arrière-plan. Consultez Notes pour connaitre les valeurs possibles.
`UFS_bPurgeStatus` Spécifie l’état de l’opération de vidage en cours.
`UFS_bMaxDataInSize` Spécifie la taille maximale des données dans un UPIU (DATA IN UFS Protocol Information Units). Ce paramètre peut être écrit par l’hôte uniquement lorsque toutes les files d’attente de tâches d’unité logique sont vides.
`UFS_bMaxDataOutSize` Spécifie la taille maximale des données sortantes. Ce paramètre peut être écrit par l’hôte uniquement lorsque toutes les files d’attente de tâches d’unité logique sont vides.
`UFS_dDynCapNeeded` Spécifie le besoin de capacité dynamique.
`UFS_bRefClkFreq` Spécifie la valeur de la fréquence d’horloge de référence. Consultez Notes pour connaitre les valeurs possibles.
`UFS_bConfigDescrLock` Spécifie si le descripteur de configuration est verrouillé.
`UFS_bMaxNumOfRTT` Définit le nombre maximal actuel d’UPIU PRÊTS À TRANSFÉRER (RTT) en attente autorisés. Cette valeur peut être définie par l’hôte.
`UFS_wExceptionEventControl` Spécifie le contrôleur d’événements d’exception. UFS_wExceptionEventControl active la définition du bit EVENT_ALERT dans le champ Informations sur l’appareil, qui est contenu dans l’UPIU RESPONSE.
`UFS_wExceptionEventStatus` Spécifie une bitmap de chaque état d’événement d’exception. Un bit est défini uniquement si l’événement approprié s’est produit (quel que soit l’état UFS_wExceptionEventControl ). Consultez Notes pour connaitre les valeurs possibles.
`UFS_dSecondsPassed` Spécifie le temps écoulé en secondes.
`UFS_wContextConf` Spécifie l’attribut de contexte.
`UFS_Obsolete` Obsolète
`UFS_Reserved_12` Réservé à un usage ultérieur.
`UFS_Reserved_13` Réservé à un usage ultérieur.
`UFS_bDeviceFFUStatus` Spécifie l’état FFU (Device Field Firmware Update). Consultez Notes pour connaitre les valeurs possibles.
`UFS_bPSAState` Spécifie l’état actuel de la reconnaissance de l’état du produit (PSA). Consultez Notes pour connaitre les valeurs possibles.
`UFS_dPSADataSize` Spécifie la quantité de données que l’hôte prévoit de charger sur toutes les unités logiques avec bPSASensitive défini sur 1.
`UFS_bRefClkGatingWaitTime` Spécifie le temps d’attente de l’horloge de référence.
`UFS_bDeviceCaseRoughTemperature` Spécifie la température approximative du boîtier de l’appareil.
`UFS_bDeviceTooHighTempBoundary` Spécifie la limite supérieure de la température de l’appareil.
`UFS_bDeviceTooLowTempBoundary` Spécifie la limite inférieure de la température de l’appareil.
`UFS_bThrottlingStatus` Spécifie l’état de limitation.
`UFS_bWriteBoosterBufferFlushStatus` Spécifie l’état de vidage de la mémoire tampon de rappel d’écriture.
`UFS_bAvailableWriteBoosterBufferSize` Spécifie la taille de la mémoire tampon de rappel d’écriture disponible.
`UFS_bWriteBoosterBufferLifeTimeEst` Spécifie l’estimation de la durée de vie de la mémoire tampon du rappel d’écriture.
`UFS_dCurrentWriteBoosterBufferSize` Spécifie la taille actuelle de la mémoire tampon de rappel d’écriture.
`UFS_Reserved_20` Réservé à un usage ultérieur.
`UFS_Reserved_21` Réservé à un usage ultérieur.
`UFS_Reserved_22` Réservé à un usage ultérieur.
`UFS_Reserved_23` Réservé à un usage ultérieur.
`UFS_Reserved_24` Réservé à un usage ultérieur.
`UFS_Reserved_25` Réservé à un usage ultérieur.
`UFS_Reserved_26` Réservé à un usage ultérieur.
`UFS_Reserved_27` Réservé à un usage ultérieur.
`UFS_Reserved_28` Réservé à un usage ultérieur.
`UFS_Reserved_29` Réservé à un usage ultérieur.
`UFS_Reserved_2A` Réservé à un usage ultérieur.
`UFS_Reserved_2B` Réservé à un usage ultérieur.
`UFS_bRefreshStatus` Spécifie l’état d’actualisation.
`UFS_bRefreshFreq` Spécifie la fréquence d’actualisation.
`UFS_bRefreshUnit` Spécifie les unités d’actualisation.
`UFS_bRefreshMethod` Spécifie la méthode refresh.

Remarques

UFS_bCurrentPowerMode est le seul attribut que l’appareil doit retourner dans n’importe quel mode d’alimentation. Si l’appareil n’est pas en mode d’alimentation actif ou inactif, un UPIU REQUÊTE REQUEST pour accéder aux descripteurs, indicateurs ou attributs autres que bCurrentPowerMode peut échouer.

Tje UFS_bDeviceFFUStatus valeur est conservée après le cycle d’alimentation, la réinitialisation matérielle ou tout autre type de réinitialisation. Cet attribut peut changer de valeur lorsqu’un événement d’activation de microcode se produit.

UFS_bMaxDataInSize est égal à bMaxInBufferSize lorsqu’un appareil UFS est expédié.

Valeurs possibles pour certains champs

UFS_bCurrentPowerMode contient l’une des valeurs suivantes :

Valeur	Description
0x00	Mode d’alimentation inactif.
0x10	Mode d’alimentation pré-actif.
0x11	Mode d’alimentation actif.
0x20	Mode d’alimentation pré-veille.
0x22	Stockage Flash universel (UFS) - Mode veille.
0x30	40 % à 50 % de la durée de vie estimée de l’appareil a été utilisée.
0x33	50 % à 60 % de la durée de vie estimée de l’appareil a été utilisée.
Toutes les autres erreurs	Réservé pour un usage futur.

UFS_bBackgroundOpStatus contient l’une des valeurs suivantes :

Valeur	Description
0x00	L’appareil ne nécessite aucune opération en arrière-plan.
0x01	L’appareil a un besoin non critique d’opérations en arrière-plan.
0x02	L’appareil a un besoin d’opérations en arrière-plan, basé sur les performances.
0x03	L’appareil a un besoin critique d’opérations en arrière-plan.

UFS_bRefClkFreq contient l’une des valeurs suivantes :

Valeur	Description
0x00	19,2 MHz
0x01	26 MHz
0x02	38,4 MHz
0x03	52 MHz

UFS_wExceptionEventStatus contient les bits suivants :

bit	Valeur
0	DYNCAP_NEEDED
1	SYSPOOL_EXHAUSTED
2	URGENT_BKOPS
3 à 15	Réservé.

UFS_bDeviceFFUStatus contient l’une des valeurs suivantes :

Valeur	Description
0x00	Aucune information sur l’état du FFU.
0x01	Mise à jour du microcode réussie.
0x02	Erreur d’altération du microcode.
0x03	Erreur interne.
0x04	Incompatibilité de la version du microcode.
0x05 à 0xFE	Réservé.
0xFF	Erreur générale.

UFS_bPSAState contient l’une des valeurs suivantes :

Valeur	State	Description
0x00	Désactivé	La fonctionnalité PSA est désactivée.
0x01	Pré-braseur	La fonctionnalité PSA est activée et l’appareil est dans un état de pré-brasage.
0x02	Chargement terminé	La fonctionnalité PSA est activée. L’hôte a cette valeur une fois que l’hôte a terminé d’écrire les données pendant l’état de pré-brasage.
0x03	Soudé	La fonctionnalité PSA n’est plus disponible. Défini par l’appareil pour indiquer qu’il est dans un état post-brasage. Cet attribut est verrouillé une fois qu’il est à l’état « Soldered ».

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 10, version 1709
Serveur minimal pris en charge	Windows Server 2016
En-tête	ufs.h

Voir aussi

UFS_CONFIG_DESCRIPTORUFS_DEVICE_DESCRIPTORUFS_DEVICE_HEALTH_DESCRIPTORUFS_GEOMETRY_DESCRIPTORUFS_INTERCONNECT_DESCRIPTORUFS_POWER_DESCRIPTOR UFS_RPMB_UNIT_DESCRIPTORUFS_STRING_DESCRIPTORUFS_UNIT_CONFIG_DESCRIPTOR UFS_UNIT_DESCRIPTOR

Partager via