enumeración UFS_ATTRIBUTES_DESCRIPTOR (ufs.h)

Artículo
02/07/2025

UFS_ATTRIBUTES_DESCRIPTOR describe los distintos tipos de atributos usados por los descriptores de Almacenamiento flash universal (UFS).

Sintaxis

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` Indica si el número de unidad lógica de arranque (LUN) está habilitado.
`UFS_Reserved_01` Reservado para uso futuro.
`UFS_bCurrentPowerMode` Indica el modo de energía actual. Vea Comentarios para ver los valores posibles.
`UFS_bActiveICCLevel` Especifica el consumo actual máximo permitido durante el modo activo. El valor oscila entre 0x00 y 0x0F.
`UFS_bOutOfOrderDataEn` Especifica si está habilitada la transferencia de datos desordenados.
`UFS_bBackgroundOpStatus` Especifica si el dispositivo tiene una necesidad de operaciones en segundo plano. Vea Comentarios para ver los valores posibles.
`UFS_bPurgeStatus` Especifica el estado de la operación de purga actual.
`UFS_bMaxDataInSize` Especifica el tamaño máximo de los datos en una unidad de información del protocolo DATA IN UFS (UPIU). El host puede escribir este parámetro solo cuando todas las colas de tareas de unidad lógica están vacías.
`UFS_bMaxDataOutSize` Especifica el tamaño máximo de salida de datos. El host puede escribir este parámetro solo cuando todas las colas de tareas de unidad lógica están vacías.
`UFS_dDynCapNeeded` Especifica la necesidad de capacidad dinámica.
`UFS_bRefClkFreq` Especifica el valor de frecuencia del reloj de referencia. Vea Comentarios para ver los valores posibles.
`UFS_bConfigDescrLock` Especifica si el descriptor de configuración está bloqueado.
`UFS_bMaxNumOfRTT` Define el número máximo actual de pendientes READY TO TRANSFER UPIU (RTT) que se permiten. El host puede establecer este valor.
`UFS_wExceptionEventControl` Especifica el controlador de eventos de excepción. UFS_wExceptionEventControl habilita la configuración del EVENT_ALERT bit en el campo Información del dispositivo, que se encuentra en el UPIU DE RESPUESTA.
`UFS_wExceptionEventStatus` Especifica un mapa de bits de cada estado de evento de excepción. Un bit solo se establecerá si se ha producido el evento pertinente (independientemente del estado de UFS_wExceptionEventControl). Vea Comentarios para ver los valores posibles.
`UFS_dSecondsPassed` Especifica el tiempo transcurrido en segundos.
`UFS_wContextConf` Especifica el atributo de contexto.
`UFS_Obsolete` Obsoleto
`UFS_Reserved_12` Reservado para uso futuro.
`UFS_Reserved_13` Reservado para uso futuro.
`UFS_bDeviceFFUStatus` Especifica el estado actualización de firmware del campo de dispositivo (FFU). Vea Comentarios para ver los valores posibles.
`UFS_bPSAState` Especifica el estado actual de reconocimiento del estado del producto (PSA). Vea Comentarios para ver los valores posibles.
`UFS_dPSADataSize` Especifica la cantidad de datos que el host planea cargar en todas las unidades lógicas con bPSASensitive establecido en 1.
`UFS_bRefClkGatingWaitTime` Especifica el tiempo de espera de acceso del reloj de referencia.
`UFS_bDeviceCaseRoughTemperature` Especifica la temperatura aproximada del caso del dispositivo.
`UFS_bDeviceTooHighTempBoundary` Especifica el límite superior de la temperatura del dispositivo.
`UFS_bDeviceTooLowTempBoundary` Especifica el límite inferior para la temperatura del dispositivo.
`UFS_bThrottlingStatus` Especifica el estado de limitación.
`UFS_bWriteBoosterBufferFlushStatus` Especifica el estado de vaciado del búfer de refuerzo de escritura.
`UFS_bAvailableWriteBoosterBufferSize` Especifica el tamaño de búfer de refuerzo de escritura disponible.
`UFS_bWriteBoosterBufferLifeTimeEst` Especifica la estimación de duración del búfer de refuerzo de escritura.
`UFS_dCurrentWriteBoosterBufferSize` Especifica el tamaño actual del búfer de refuerzo de escritura.
`UFS_Reserved_20` Reservado para uso futuro.
`UFS_Reserved_21` Reservado para uso futuro.
`UFS_Reserved_22` Reservado para uso futuro.
`UFS_Reserved_23` Reservado para uso futuro.
`UFS_Reserved_24` Reservado para uso futuro.
`UFS_Reserved_25` Reservado para uso futuro.
`UFS_Reserved_26` Reservado para uso futuro.
`UFS_Reserved_27` Reservado para uso futuro.
`UFS_Reserved_28` Reservado para uso futuro.
`UFS_Reserved_29` Reservado para uso futuro.
`UFS_Reserved_2A` Reservado para uso futuro.
`UFS_Reserved_2B` Reservado para uso futuro.
`UFS_bRefreshStatus` Especifica el estado de actualización.
`UFS_bRefreshFreq` Especifica la frecuencia de actualización.
`UFS_bRefreshUnit` Especifica las unidades de actualización.
`UFS_bRefreshMethod` Especifica el método refresh.

Observaciones

UFS_bCurrentPowerMode es el único atributo que el dispositivo debe devolver en cualquier modo de alimentación. Si el dispositivo no está en modo de energía activo o modo de energía inactiva, se puede producir un error en un QUERY REQUEST UPIU acceder a descriptores, marcas o atributos distintos de bCurrentPowerMode.

Tje UFS_bDeviceFFUStatus valor se mantiene después del ciclo de energía, el restablecimiento de hardware o cualquier otro tipo de restablecimiento. Este atributo puede cambiar el valor cuando se produce un evento de activación de microcódigo.

UFS_bMaxDataInSize es igual a bMaxInBufferSize cuando se envía un dispositivo UFS.

Valores posibles para algunos campos

UFS_bCurrentPowerMode contiene uno de los siguientes valores:

Valor	Descripción
0x00	Modo de energía inactiva.
0x10	Modo de energía preactivo.
0x11	Modo de energía activa.
0x20	Modo de alimentación pre-suspensión.
0x22	Almacenamiento flash universal (UFS): modo de alimentación de suspensión.
0x30	Se han usado 40% a 50% del tiempo de vida estimado del dispositivo.
0x33	Se han usado 50% a 60% del tiempo de vida estimado del dispositivo.
Todos los demás valores	Reservado para uso futuro.

UFS_bBackgroundOpStatus contiene uno de los siguientes valores:

Valor	Descripción
0x00	El dispositivo no requiere operaciones en segundo plano.
0x01	El dispositivo tiene una necesidad no crítica de operaciones en segundo plano.
0x02	El dispositivo tiene una necesidad basada en el rendimiento afectada de las operaciones en segundo plano.
0x03	El dispositivo tiene una necesidad crítica de operaciones en segundo plano.

UFS_bRefClkFreq contiene uno de los siguientes valores:

Valor	Descripción
0x00	19,2 MHz
0x01	26 MHz
0x02	38,4 MHz
0x03	52 MHz

UFS_wExceptionEventStatus contiene los bits siguientes:

Bit	Valor
0	DYNCAP_NEEDED
1	SYSPOOL_EXHAUSTED
2	URGENT_BKOPS
De 3 a 15	Reservado.

UFS_bDeviceFFUStatus contiene uno de los siguientes valores:

Valor	Descripción
0x00	No hay información sobre el estado de la FFU.
0x01	Actualización correcta del microcódigo.
0x02	Error de daños en microcódigo.
0x03	Error interno.
0x04	Error de coincidencia de la versión de microcódigo.
0x05 0xFE	Reservado.
0xFF	Error general.

UFS_bPSAState contiene uno de los siguientes valores:

Valor	Estado	Descripción
0x00	Apagado	La característica PSA está desactivada.
0x01	Pre-solder	La característica PSA está activada y el dispositivo está en estado de soldadura previa.
0x02	Carga completa	La característica PSA está activada. El host se establecerá en este valor después de que el host haya terminado de escribir datos durante el estado de soldadura previa.
0x03	Soldado	La característica PSA ya no está disponible. Establezca el dispositivo para indicar que está en un estado posterior a la soldadura. Este atributo está bloqueado después de que esté en estado "Soldered".

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows 10, versión 1709
servidor mínimo admitido	Windows Server 2016
encabezado de	ufs.h

Consulte también

UFS_CONFIG_DESCRIPTORUFS_DEVICE_DESCRIPTORUFS_DEVICE_HEALTH_DESCRIPTORUFS_GEOMETRY_DESCRIPTORUFS_INTERCONNECT_DESCRIPTORUFS_POWER_DESCRIPTORUFS_RPMB_UNIT_DESCRIPTORUFS_STRING_DESCRIPTORUFS_UNIT_CONFIG_DESCRIPTORUFS_UNIT_DESCRIPTOR

Compartir a través de