> For the complete documentation index, see [llms.txt](https://navixy.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://navixy.com/docs/expert-center/pt-br/faq-and-troubleshooting/access-iot-data/save-iot-data-to-csv-file/columns-in-csv-file.md).

# Colunas no arquivo CSV

Referência para a estrutura do arquivo CSV de dados brutos exportado da Navixy: tipos de parâmetros, IDs de eventos e como interpretar campos de GPS, sensores e estado.

A ferramenta de data warehouse permite exportar um arquivo de dados brutos contendo todos os pacotes recebidos do seu dispositivo, sem qualquer filtragem ou cálculo feitos no lado da plataforma. Esses parâmetros representam informações inicialmente decodificadas do pacote do seu dispositivo em formato relacionado ao protocolo, apresentadas de forma legível para humanos. Você não precisa conhecer o protocolo para ler e verificar as informações nesses pacotes.

{% hint style="info" %}
Para saber como baixar essas informações, veja [Salvar dados IoT em arquivo CSV](https://navixy.com/docs/expert-center/pt-br/faq-and-troubleshooting/access-iot-data/save-iot-data-to-csv-file.md). Aqui, nosso objetivo é explorar mais como ler esse arquivo e interpretar as várias colunas nele.
{% endhint %}

## Abrir um arquivo

O nome do arquivo contém o seguinte:

* ID do dispositivo: O número de ID do dispositivo, geralmente o IMEI do dispositivo. Se o provedor de serviço tiver escolhido ocultar os IMEIs dos dispositivos, usa-se em vez disso o ID da plataforma do objeto.
* Rótulo do dispositivo na plataforma: um rótulo para ajudar na busca do arquivo.
* Horário de início e término: representando o início e o fim do arquivo no formato dia\_mês\_ano\_horas\_minutos\_AM/PM.
* Fuso horário no formato UTC.

Você pode abrir o arquivo de dados brutos com qualquer editor de texto, como WordPad, Notepad++, ou Sublime Text. Esse formato é facilmente compreendido por programas e máquinas, mas pode não ficar tão claro para pessoas. Para simplificar a leitura do arquivo, recomendamos usar um editor de planilhas. Basta abrir o arquivo CSV com Excel, Google Sheets ou qualquer outro editor de planilhas. No editor de planilhas, todos os parâmetros estarão em suas próprias colunas. Além disso, você pode congelar a primeira linha para ver os nomes das colunas ao longo do arquivo.

## Parâmetros de dados brutos

O arquivo inclui parâmetros selecionados em colunas, junto com uma entrada consistente, msg\_time.

![](https://1173629567-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIgDb43gtyXcm1Av4h1np%2Fuploads%2Fgit-blob-2f5edca71dd9b788133c28403e6c7f4d95373331%2Fimage-20240209-073506.png?alt=media\&token=67ddd84f-aa04-4f86-b9c5-f630eb575a8f)

Esses parâmetros podem ser categorizados como simples ou complexos.

### Colunas simples

Parâmetros simples fornecem nomes completos e representam principalmente informações específicas de rastreamento.

* `msg_time`: Hora em que o dispositivo GPS registrou um ponto. Sempre incluído na saída CSV. Indicado de acordo com o fuso horário escolhido.
* `server_time`: Hora de recebimento da mensagem pelo servidor. Indicada de acordo com o fuso horário escolhido.
* `gps_fix_type`
  * NO\_FIX: O dispositivo GPS marcou a localização como inválida.
  * HAS\_FIX: O dispositivo GPS marcou a localização como válida.
  * LAST\_KNOWN\_POSITION: No caso de o dispositivo GPS fornecer entrada atual e outros estados dentro da última localização conhecida.
  * UNKNOWN: Se um dispositivo não puder fornecer essas informações ou não tiver determinado o tipo de fix do GPS para esse pacote.
* `lat`: Latitude da localização.
* `lng`: Longitude da localização.
* `speed`: Velocidade determinada pelo dispositivo GPS em km/h. Na maioria dos casos, é a velocidade determinada pelo GPS do dispositivo.
* `alt`: Altitude da localização em metros.
* `satellites`: Número de satélites conectados naquele momento. `-1` significa desconhecido e, na maioria dos casos, representa um ponto de localização LBS.
* `heading`: Direção do objeto em graus, em que 0 representa o norte.
* `precision`: Precisão da localização em metros.
* `hdop`: Diluição horizontal de precisão, representa a exatidão das estimativas de posição horizontal do dispositivo GPS. Os valores variam de 1 (excelente) a acima de 20 (ruim). Valores entre 1 e 2 são considerados bons para a maioria dos propósitos de navegação. `-1` significa desconhecido.
* `pdop`: Diluição de precisão da posição, indica a exatidão da posição de um dispositivo GPS com base na geometria dos satélites em relação ao dispositivo GPS. Valores menores de PDOP significam melhor posicionamento dos satélites, levando a dados de localização mais precisos, mas `-1` significa desconhecido.
* `mn_name`: Nome da rede móvel. Determinado pelo dispositivo.
* `mn_roaming`: Status de roaming. É determinado pelo dispositivo.
  * `0` significa ausência de roaming,
  * `1` significa que esse ponto foi gerado por um dispositivo em roaming,
  * Se o dispositivo não puder fornecer esses dados ou não conseguir fazê-lo para esta mensagem específica, é `-1` (desconhecido).
* `mn_code`: Código da operadora de rede móvel. Determinado pelo dispositivo.
* `mn_csq`: Intensidade do sinal da rede móvel, CSQ, valores de 0 a 31. Determinada pelo dispositivo. Se o dispositivo não puder fornecer esses dados ou não conseguir fazê-lo para esta mensagem específica, é `99` (desconhecido).
* `mn_type`: Tipo de rede móvel. É determinado pelo dispositivo.
  * Se o dispositivo não puder fornecer esses dados ou não conseguir fazê-lo para esta mensagem específica, é `UNKNOWN`
  * `GSM`: Se o dispositivo tiver determinado o tipo GSM.
  * `CDMA`: Se o dispositivo tiver determinado o tipo CDMA.
  * `WCDMA`: Se o dispositivo tiver determinado o tipo WCDMA.
  * `LTE`: Se o dispositivo tiver determinado o tipo LTE.
  * `NR`: Se o dispositivo tiver determinado o tipo NR.
* `event_id`: O ID do evento da plataforma. Encontre abaixo a lista de todos os códigos de ID de evento.

<details>

<summary>IDs dos códigos de eventos da plataforma e suas definições</summary>

Nos pacotes do dispositivo, vários códigos de evento podem ser definidos, cada um significando uma ocorrência específica.

Alguns protocolos de encaminhamento de dados passam esse ID inalterado como seu próprio código de evento. Veja [códigos de evento do Recurso Confiável](https://navixy.com/docs/qna/using-navixy/recurso-confiable-event-codes.md) como exemplo.

| **ID do evento** | **Definição**                                                           |
| ---------------- | ----------------------------------------------------------------------- |
| 2                | Rastreamento. Nenhum evento específico, apenas um ponto de rastreamento |
| 4                | Número de contato de emergência chamado                                 |
| 5                | Evento de movimento não autorizado determinado pelo dispositivo         |
| 11               | Mudança de estado da entrada 1                                          |
| 12               | Mudança de estado da entrada 2                                          |
| 13               | Mudança de estado da entrada 3                                          |
| 14               | Mudança de estado da entrada 4                                          |
| 15               | Mudança de estado da entrada 5                                          |
| 16               | Mudança de estado da entrada 6                                          |
| 17               | Mudança de estado da entrada 7                                          |
| 18               | Mudança de estado da entrada 8                                          |
| 34               | O dispositivo sai do modo de repouso                                    |
| 37               | Início do modo de repouso                                               |
| 40               | Energia principal baixa                                                 |
| 41               | Perda de energia ou Corte de alimentação externa                        |
| 42               | Botão de ligar pressionado                                              |
| 43               | Energia restaurada ou alimentação externa conectada                     |
| 44               | OBD desconectado do conector do carro                                   |
| 45               | OBD conectado                                                           |
| 46               | Bateria de reserva do dispositivo fraca                                 |
| 50               | Fim da inatividade (relacionada ao hardware)                            |
| 51               | Início da inatividade (relacionada ao hardware)                         |
| 71               | Início do modo de repouso de inatividade                                |
| 72               | Início do modo de repouso com bateria reserva fraca                     |
| 73               | Despertar por temporizador                                              |
| 74               | Despertar por movimento                                                 |
| 75               | Despertar por alimentação externa                                       |
| 76               | Alerta de repouso por temporizador                                      |
| 81               | Modo de segurança ativado                                               |
| 82               | Evento do usuário                                                       |
| 83               | Evento de botão SOS pressionado                                         |
| 84               | Modo de segurança desativado                                            |
| 90               | Desconexão da antena                                                    |
| 100              | Dispositivo desacoplado do objeto                                       |
| 111              | Mudança de estado da saída 1                                            |
| 112              | Mudança de estado da saída 2                                            |
| 113              | Mudança de estado da saída 3                                            |
| 114              | Mudança de estado da saída 4                                            |
| 115              | Mudança de estado da saída 5                                            |
| 116              | Mudança de estado da saída 6                                            |
| 117              | Mudança de estado da saída 7                                            |
| 118              | Mudança de estado da saída 8                                            |
| 797              | Check-in enviado pelo aplicativo móvel                                  |
| 798              | Envio do formulário da tarefa                                           |
| 799              | Mudança de status de trabalho                                           |
| 800              | Ponto LBS GSM determinado por um dispositivo                            |
| 802              | Ponto de rastreamento por tempo                                         |
| 803              | Ponto de rastreamento por distância                                     |
| 804              | Ponto de rastreamento por ângulo                                        |
| 811              | Início do movimento de rastreamento                                     |
| 812              | Fim do movimento de rastreamento                                        |
| 813              | Fim do movimento não autorizado                                         |
| 814              | Mensagem sem rastreamento                                               |
| 900              | Condução agressiva com mudança rápida de faixa                          |
| 901              | Sinal de GPS Fraco                                                      |
| 928              | Desconectado do objeto rastreado                                        |
| 929              | Mudança frequente de faixa                                              |
| 930              | O dispositivo não consegue detectar o rosto humano                      |
| 931              | Cinto de segurança desafivelado                                         |
| 932              | Beber                                                                   |
| 933              | Olhos fechados                                                          |
| 934              | Anexar o dispositivo ao objeto rastreado                                |
| 935              | MDSM 7 desconectado                                                     |
| 936              | MDSM 7 conectado                                                        |
| 937              | Registrar novo motorista                                                |
| 938              | Motorista entra na cabine                                               |
| 939              | Iniciar ausência do motorista                                           |
| 940              | O motorista parou de fumar (Distração do motorista)                     |
| 941              | Botão de desligar pressionado                                           |
| 942              | O motorista começou a fumar (Distração do motorista)                    |
| 943              | O motorista terminou de usar o telefone (Distração do motorista)        |
| 944              | O motorista começou a usar o telefone (Distração do motorista)          |
| 945              | Bocejo (Direção sob fadiga)                                             |
| 946              | Fim da distração do motorista                                           |
| 947              | Início da distração do motorista                                        |
| 948              | Fim da sonolência do motorista                                          |
| 949              | Início da sonolência do motorista                                       |
| 950              | Excesso de velocidade por evento de hardware                            |
| 951              | Controle de cruzeiro ativado                                            |
| 952              | Controle de cruzeiro desativado                                         |
| 953              | Início de movimento inesperado                                          |
| 954              | Fim de movimento inesperado                                             |
| 955              | Alarme do carro                                                         |
| 956              | Pedestres em zona de perigo (ADAS)                                      |
| 957              | Reconhecimento de placas de trânsito (ADAS)                             |
| 958              | Aviso de colisão com pedestres (ADAS)                                   |
| 959              | Luz de verificação do motor                                             |
| 960              | Direção sob fadiga                                                      |
| 961              | Alerta de distância de seguimento (ADAS)                                |
| 962              | Saída da faixa à direita (ADAS)                                         |
| 963              | Saída da faixa à esquerda (ADAS)                                        |
| 964              | Saída de faixa (ADAS)                                                   |
| 965              | Aviso de colisão frontal (ADAS)                                         |
| 966              | O rastreador entrou na geocerca automática                              |
| 967              | O rastreador saiu da geocerca automática                                |
| 968              | Forçar resposta de localização por SMS pela interface                   |
| 969              | Alarme da porta                                                         |
| 970              | Ignição desligada                                                       |
| 971              | Ignição ligada                                                          |
| 972              | Motorista não identificado                                              |
| 973              | Motorista identificado                                                  |
| 974              | Fechadura fechada                                                       |
| 975              | Fechadura aberta                                                        |
| 976              | Energia do dispositivo desligada                                        |
| 977              | Energia do dispositivo ligada                                           |
| 978              | Caixa fechada                                                           |
| 979              | Caixa aberta                                                            |
| 980              | Botão de chamada pressionado                                            |
| 981              | O sensor de luz determinou escuro                                       |
| 982              | O sensor de luz determinou claro                                        |
| 983              | Fim da vibração                                                         |
| 984              | Início da vibração                                                      |
| 985              | Parafuso da cinta inserido                                              |
| 986              | Parafuso da cinta cortado                                               |
| 987              | Condução agressiva com aceleração e curva                               |
| 988              | Condução agressiva com frenagem e curva                                 |
| 989              | Condução agressiva com curva                                            |
| 990              | Condução agressiva com aceleração                                       |
| 991              | Condução agressiva com frenagem                                         |
| 992              | Sinal de GPS recuperado                                                 |
| 993              | Sinal de GPS perdido                                                    |
| 994              | Alarme de colisão                                                       |
| 995              | Alarme de sinal GSM fraco                                               |
| 996              | Condução agressiva                                                      |
| 997              | Pulseira aberta                                                         |
| 998              | Pulseira fechada                                                        |
| 999              | Alerta do sensor G                                                      |

</details>

### Parâmetros complexos

Os parâmetros complexos incluem o nome do grupo e o nome específico. Eles são categorizados da seguinte forma:

* `flags`: Um bitmap de flags que representa a validade da localização e o LBS:
  * Bit 0 (location\_valid): Indica o status de validade da localização. É `0` se a localização for inválida, e `1` se a localização for válida.
  * Bit 1 (lbs): Indica o status de LBS do ponto. Se `0`, o ponto é recebido por GPS; se `1`, o ponto é recebido por LBS.
  * Bit 2 (soft\_lbs): Indica a origem do ponto LBS. Se `0`, o ponto é determinado pelo LBS do dispositivo; se `1`, pelo LBS da plataforma.
* `discrete_inputs`: Representa informações de cada entrada discreta. Cada entrada discreta é apresentada em uma coluna separada, enumerada a partir de 1. Os valores possíveis são 1 e 0, em que 0 significa desligado e 1 significa ligado.
* `discrete_outputs` : Mostra o mesmo que as entradas discretas, mas para saídas discretas. Cada saída discreta está em uma coluna separada, enumerada a partir de 1.
* `inputs`: Representa dados de diferentes sensores, como combustível ou vários Sensores de medida. Cada entrada está em uma coluna separada, e a lista de entradas depende do modelo do dispositivo.
* `states`: Exibe valores dos parâmetros de estado. A maioria deles pode ser 1 ou 0, mas alguns têm valores de texto específicos como códigos DTC.

Com essas definições, esperamos que você ache fácil ler as informações em arquivos de dados brutos e usá-las na solução de problemas do dispositivo e em programas para seus clientes.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://navixy.com/docs/expert-center/pt-br/faq-and-troubleshooting/access-iot-data/save-iot-data-to-csv-file/columns-in-csv-file.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
