UFS_ATTRIBUTES_DESCRIPTOR enumeração (ufs.h)

Artigo
02/07/2025

UFS_ATTRIBUTES_DESCRIPTOR descreve os diferentes tipos de atributos usados pelos descritores do UFS (Armazenamento Flash Universal).

Sintaxe

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 se o LUN (Número de Unidade Lógica de Inicialização) está habilitado.
`UFS_Reserved_01` Reservado para uso futuro.
`UFS_bCurrentPowerMode` Indica o modo de energia atual. Consulte Comentários para obter valores possíveis.
`UFS_bActiveICCLevel` Especifica o consumo máximo atual permitido durante o Modo Ativo. O valor varia de 0x00 a 0x0F.
`UFS_bOutOfOrderDataEn` Especifica se a transferência de dados fora de ordem está habilitada.
`UFS_bBackgroundOpStatus` Especifica se o dispositivo precisa de operações em segundo plano. Consulte Comentários para obter valores possíveis.
`UFS_bPurgeStatus` Especifica o status da operação de limpeza atual.
`UFS_bMaxDataInSize` Especifica o tamanho máximo de dados em uma UPIU (Unidades de Informações do Protocolo DATA IN UFS). Esse parâmetro só pode ser gravado pelo host quando todas as filas de tarefas de unidade lógica estiverem vazias.
`UFS_bMaxDataOutSize` Especifica o tamanho máximo de data-out. Esse parâmetro só pode ser gravado pelo host quando todas as filas de tarefas de unidade lógica estiverem vazias.
`UFS_dDynCapNeeded` Especifica a necessidade de capacidade dinâmica.
`UFS_bRefClkFreq` Especifica o valor de frequência do relógio de referência. Consulte Comentários para obter valores possíveis.
`UFS_bConfigDescrLock` Especifica se o descritor de configuração está bloqueado.
`UFS_bMaxNumOfRTT` Define o número máximo atual de PRONTO PARA TRANSFERIR UPIUs (RTT's) que são permitidos. Esse valor pode ser definido pelo host.
`UFS_wExceptionEventControl` Especifica o controlador de eventos de exceção. UFS_wExceptionEventControl habilita a configuração do bit EVENT_ALERT no campo Informações do Dispositivo, que está contido na UPIU response.
`UFS_wExceptionEventStatus` Especifica um bitmap de cada status de evento de exceção. Um bit será definido somente se o evento relevante tiver ocorrido (independentemente do status de UFS_wExceptionEventControl). Consulte Comentários para obter valores possíveis.
`UFS_dSecondsPassed` Especifica o tempo passado em segundos.
`UFS_wContextConf` Especifica o atributo de contexto.
`UFS_Obsolete` Obsoleto
`UFS_Reserved_12` Reservado para uso futuro.
`UFS_Reserved_13` Reservado para uso futuro.
`UFS_bDeviceFFUStatus` Especifica o status da FFU (Atualização de Firmware de Campo do Dispositivo). Consulte Comentários para obter valores possíveis.
`UFS_bPSAState` Especifica o estado atual do PSA (Product State Awareness). Consulte Comentários para obter valores possíveis.
`UFS_dPSADataSize` Especifica a quantidade de dados que o host planeja carregar em todas as unidades lógicas com bPSASensitive definido como 1.
`UFS_bRefClkGatingWaitTime` Especifica o tempo de espera do relógio de referência.
`UFS_bDeviceCaseRoughTemperature` Especifica a temperatura aproximada da caixa do dispositivo.
`UFS_bDeviceTooHighTempBoundary` Especifica o limite superior para a temperatura do dispositivo.
`UFS_bDeviceTooLowTempBoundary` Especifica o limite inferior para a temperatura do dispositivo.
`UFS_bThrottlingStatus` Especifica o status de limitação.
`UFS_bWriteBoosterBufferFlushStatus` Especifica o status de liberação do buffer do booster de gravação.
`UFS_bAvailableWriteBoosterBufferSize` Especifica o tamanho do buffer do booster de gravação disponível.
`UFS_bWriteBoosterBufferLifeTimeEst` Especifica a estimativa de tempo de vida do buffer do booster de gravação.
`UFS_dCurrentWriteBoosterBufferSize` Especifica o tamanho atual do buffer do booster de gravação.
`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 o status da atualização.
`UFS_bRefreshFreq` Especifica a frequência de atualização.
`UFS_bRefreshUnit` Especifica as unidades de atualização.
`UFS_bRefreshMethod` Especifica o método de atualização.

Observações

UFS_bCurrentPowerMode é o único atributo que o dispositivo precisa retornar em qualquer modo de energia. Se o dispositivo não estiver no modo de energia ativo ou no modo de energia ocioso, um SOLICITAÇÃO DE CONSULTA UPIU para acessar descritores, sinalizadores ou atributos diferentes de bCurrentPowerMode poderá falhar.

Tje UFS_bDeviceFFUStatus valor é mantido após o ciclo de energia, redefinição de hardware ou qualquer outro tipo de redefinição. Esse atributo pode alterar o valor quando ocorre um evento de ativação de microcódigo.

UFS_bMaxDataInSize é igual a bMaxInBufferSize quando um dispositivo UFS é enviado.

Valores possíveis para alguns campos

UFS_bCurrentPowerMode contém um dos seguintes valores:

Valor	Descrição
0x00	Modo de energia ocioso.
0x10	Modo de energia pré-ativo.
0x11	Modo de energia ativo.
0x20	Modo de energia pré-suspensão.
0x22	UFS (Armazenamento Flash Universal)-Modo de energia de suspensão.
0x30	Foram usados 40% a 50% do tempo de vida estimado do dispositivo.
0x33	Foram usados 50% a 60% do tempo de vida estimado do dispositivo.
Todos os outros valores	Reservado para uso futuro.

UFS_bBackgroundOpStatus contém um dos seguintes valores:

Valor	Descrição
0x00	O dispositivo não requer operações em segundo plano.
0x01	O dispositivo tem uma necessidade não crítica de operações em segundo plano.
0x02	O dispositivo tem uma necessidade baseada em desempenho de operações em segundo plano.
0x03	O dispositivo tem uma necessidade crítica de operações em segundo plano.

UFS_bRefClkFreq contém um dos seguintes valores:

Valor	Descrição
0x00	19,2 MHz
0x01	26 MHz
0x02	38,4 MHz
0x03	52 MHz

UFS_wExceptionEventStatus contém os seguintes bits:

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

UFS_bDeviceFFUStatus contém um dos seguintes valores:

Valor	Descrição
0x00	Não há informações sobre o status da FFU.
0x01	Atualização de microcódigo bem-sucedida.
0x02	Erro de corrupção de microcódigo.
0x03	Erro interno.
0x04	Incompatibilidade de versão do microcódigo.
0x05 0xFE	Reservado.
0xFF	Erro geral.

UFS_bPSAState contém um dos seguintes valores:

Valor	Estado	Descrição
0x00	Desligado	O recurso PSA está desativado.
0x01	Pré-solda	O recurso PSA está ativado e o dispositivo está em um estado de pré-venda.
0x02	Carregando Concluído	O recurso PSA está ativado. O host será definido como esse valor depois que o host terminar de gravar dados durante o estado de pré-venda.
0x03	Soldado	O recurso PSA não está mais disponível. Definido pelo Dispositivo para indicar que ele está em um estado pós-solda. Esse atributo é bloqueado depois que ele está no estado 'Soldado'.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 10, versão 1709
servidor com suporte mínimo	Windows Server 2016
cabeçalho	ufs.h

Consulte também

UFS_CONFIG_DESCRIPTORUFS_DEVICE_DESCRIPTORUFS_DEVICE_HEALTH_DESCRIPTORUFS_GEOMETRY_DESCRIPTORUFS_INTERCONNECT_DESCRIPTORUFS_POWER_DESCRIPTORUFS_RPMB_UNIT_DESCRIPTORUFS_STRING_DESCRIPTORUFS_UNIT_CONFIG_DESCRIPTORUFS_UNIT_DESCRIPTOR

Compartilhar via