AWS A IoT não FleetWise estará mais aberta a novos clientes a partir de 30 de abril de 2026. Os FleetWise clientes de AWS IoT existentes podem continuar usando o serviço. O [Guia para Mobilidade Conectada AWS](https://aws.amazon.com/solutions/guidance/connected-mobility-on-aws/) fornece orientação sobre como desenvolver e implantar serviços modulares para soluções de mobilidade conectada que podem ser usadas para obter recursos equivalentes aos da AWS IoT FleetWise.

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Casos de uso do código de problema de diagnóstico
<a name="dtc-use-cases"></a>

**Importante**  
O acesso a determinados FleetWise recursos de AWS IoT está atualmente bloqueado. Para obter mais informações, consulte [AWS Disponibilidade de regiões e recursos na AWS IoT FleetWise](fleetwise-regions.md).

Os casos de uso a seguir presumem que a `DTC_QUERY` função foi definida no [script de demonstração](https://github.com/aws/aws-iot-fleetwise-edge/blob/main/docs/dev-guide/edge-agent-uds-dtc-dev-guide.md).

## Busca periódica
<a name="dtc-periodic-fetch"></a>

Obtenha uma coleção de DTC em intervalos configurados.

O exemplo a seguir é uma campanha com busca periódica de sinais `Vehicle.DTC_INFO` para todos DTCs com uma máscara de status para todos. ECUs Há uma condição para que os dados sejam coletados`Vehicle.DTC_INFO`.

```
{
  "compression": "SNAPPY",
  "spoolingMode": "TO_DISK",
  "signalsToFetch": [
    {
      "fullyQualifiedName": "Vehicle.ECU1.DTC_INFO",
      "signalFetchConfig": {
        "timeBased": {
        // The FleetWise Edge Agent will query the UDS module for all DTCs every five seconds.
          "executionFrequencyMs": 5000
        }
      },
      "actions": [
      // Every five seconds, this action is called and its output is stored in the
      // signal history buffer of Vehicle.DTC_INFO
        "custom_function(\"DTC_QUERY\", -1, 2, -1)"
      ]
    }
  ],
  "signalsToCollect": [
    {
      "name": "Vehicle.ECU1.DTC_INFO"
    }
  ],
  "collectionScheme": {
    "conditionBasedCollectionScheme": {
      "conditionLanguageVersion": 1,
      // Whenever a new DTC is filled into the signal, the data is ingested.
      "expression": "!isNull($variable.`Vehicle.ECU1.DTC_INFO`)",
      "minimumTriggerIntervalMs": 1000,
      // Make sure that data is ingested only when there are new DTCs.
      "triggerMode": "RISING_EDGE"
    }
  },
  "dataDestinationConfigs": [
    {
      "s3Config": 
        {
          "bucketArn": "bucket-arn",
          "dataFormat": "PARQUET",
          "prefix": "campaign-name",
          "storageCompressionFormat": "GZIP"
        }
    }
  ]
}
```

## Busca baseada em condições
<a name="dtc-condition-fetch"></a>

Busque uma coleção de DTC quando uma condição for atendida. Por exemplo, quando o sinal CAN estiver`Vehicle.Ignition == 1`, busque e carregue os dados do DTC.

O exemplo de campanha a seguir tem a busca de sinal orientada por condições `Vehicle.ECU1.DTC_INFO` para verificar se o DTC (” AAA123 “) está pendente com o recorde número 1 do ECU-1. Esta campanha tem coleta e upload de dados com base no tempo.

```
{
  "compression": "SNAPPY",
  "spoolingMode": "TO_DISK",
  "signalsToFetch": [
    {
      "fullyQualifiedName": "Vehicle.ECU1.DTC_INFO",
      "signalFetchConfig": {
        "conditionBased": {
        // The action will only run when the ignition is on.
          "conditionExpression": "$variable.`Vehicle.Ignition` == 1",
          "triggerMode": "ALWAYS"
        }
      },
      // The UDS module is only requested for the specific ECU address and the specific DTC Number/Status.
      "actions": ["custom_function(\"DTC_QUERY\", 1, 2, 8, \"0xAAA123\")"]
    }
  ],
  "signalsToCollect": [
    {
      "name": "Vehicle.ECU1.DTC_INFO"
    },
    {
      "name": "Vehicle.Ignition"
    }
  ],
  "collectionScheme": {
    "timeBasedCollectionScheme": {
      "periodMs": 10000
    }
  },
  "dataDestinationConfigs": [
    {
      "s3Config": 
        {
          "bucketArn": "bucket-arn",
          "dataFormat": "PARQUET",
          "prefix": "campaign-name",
          "storageCompressionFormat": "GZIP"
        }
    }
  ]
}
```

## Busca sob demanda
<a name="fetch-dtc-for-fleet"></a>

Obtenha um DTC específico para uma frota.

Para um caso de uso sob demanda, você pode usar a mesma campanha definida na busca periódica. O efeito sob demanda é obtido suspendendo a campanha logo após a implantação da campanha usando o FleetWise console de AWS IoT ou executando o seguinte comando da CLI.
+ *command-name*Substitua pelo nome do comando.

```
aws iotfleetwise update-campaign \
    --name campaign-name \
    --action APPROVE
```

Em seguida, suspenda a campanha após a chegada dos dados do DTC.

```
aws iotfleetwise update-campaign \
    --name campaign-name \
    --action SUSPEND
```

Você pode retomar a campanha novamente para a busca de dados do DTC.

```
aws iotfleetwise update-campaign \
    --name campaign-name \
    --action RESUME
```