> 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 armazém de dados permite exportar um arquivo de dados brutos contendo todos os pacotes recebidos do seu dispositivo, sem qualquer filtragem ou cálculo realizado do 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 aprender a baixar essas informações, veja [Salvar dados de IoT em um arquivo CSV](/docs/expert-center/pt-br/faq-and-troubleshooting/access-iot-data/save-iot-data-to-csv-file.md). Aqui, queremos explorar mais a fundo como ler este 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, em vez disso é usado 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: Representam 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 ser tão claro para as pessoas. Para simplificar a leitura do arquivo, recomendamos usar um editor de tabelas. Basta abrir o arquivo CSV com Excel, Google Sheets ou qualquer outro editor de tabelas. No editor de tabelas, todos os parâmetros ficarão em suas próprias colunas. Além disso, você pode congelar a primeira linha para ver os nomes das colunas ao longo de todo o arquivo.
## Parâmetros dos dados brutos
O arquivo inclui parâmetros selecionados em colunas, juntamente com uma entrada fixa, msg\_time.
Esses parâmetros podem ser categorizados como simples ou complexos.
### Colunas simples
Os parâmetros simples fornecem nomes completos e representam principalmente informações específicas de rastreamento.
* `msg_time`: Horário 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`: Horário de recebimento da mensagem pelo servidor. Indicado 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 a entrada atual e outros estados na última posição conhecida.
* UNKNOWN: Se um dispositivo não puder fornecer essas informações ou não tiver determinado o tipo de fixação de GPS para este 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 da 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 da 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 de PDOP mais baixos significam um melhor posicionamento dos satélites, resultando em 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 sem roaming,
* `1` significa que este 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, ele é `-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, ele é `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, ele é `UNKNOWN`
* `GSM`: Se o dispositivo determinou o tipo GSM.
* `CDMA`: Se o dispositivo determinou o tipo CDMA.
* `WCDMA`: Se o dispositivo determinou o tipo WCDMA.
* `LTE`: Se o dispositivo determinou o tipo LTE.
* `NR`: Se o dispositivo determinou o tipo NR.
* `event_id`: O ID de evento da plataforma. Encontre a lista de todos os códigos de ID de evento abaixo.
IDs dos códigos de evento da plataforma e suas definições
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 repassam esse ID sem alterações como seu próprio código de evento. Veja [códigos de evento do Recurso Confiável](/docs/qna/using-navixy/recurso-confiable-event-codes.md) como exemplo.
| **ID do evento** | **Definição** |
| ---------------- | -------------------------------------------------------------------- |
| 2 | Rastreamento. Sem evento específico, apenas um ponto de rastreamento |
| 4 | Ligação para o número de contato de emergência |
| 5 | Evento de movimento não autorizado detectado pelo dispositivo |
| 11 | Alteração do estado da entrada 1 |
| 12 | Alteração do estado da entrada 2 |
| 13 | Alteração do estado da entrada 3 |
| 14 | Alteração do estado da entrada 4 |
| 15 | Alteração do estado da entrada 5 |
| 16 | Alteração do estado da entrada 6 |
| 17 | Alteração do estado da entrada 7 |
| 18 | Alteração do estado da entrada 8 |
| 34 | O dispositivo sai do modo de repouso |
| 37 | Início do modo de repouso |
| 40 | Alimentação principal baixa |
| 41 | Perda de energia ou corte de alimentação externa |
| 42 | Botão de ligar pressionado |
| 43 | Energia restabelecida ou alimentação externa conectada |
| 44 | OBD desconectado do conector do carro |
| 45 | OBD conectado |
| 46 | Bateria de backup do dispositivo fraca |
| 50 | Fim da inatividade (relacionado ao hardware) |
| 51 | Início da inatividade (relacionado ao hardware) |
| 71 | Início do modo de repouso por inatividade |
| 72 | Início do modo de repouso por bateria de backup baixa |
| 73 | Ativação por temporizador |
| 74 | Ativação por movimento |
| 75 | Ativação 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 desprendido do objeto |
| 111 | Alteração do estado da saída 1 |
| 112 | Alteração do estado da saída 2 |
| 113 | Alteração do estado da saída 3 |
| 114 | Alteração do estado da saída 4 |
| 115 | Alteração do estado da saída 5 |
| 116 | Alteração do estado da saída 6 |
| 117 | Alteração do estado da saída 7 |
| 118 | Alteração do 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, mudança rápida de faixa |
| 901 | Sinal de GPS fraco |
| 928 | Desconectar do objeto rastreado |
| 929 | Mudança frequente de faixa |
| 930 | O dispositivo não consegue detectar um rosto humano |
| 931 | Cinto de segurança desatado |
| 932 | Bebendo |
| 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 | Início da ausência do motorista |
| 940 | Motorista parou de fumar (distração do motorista) |
| 941 | Botão de desligar pressionado |
| 942 | Motorista começou a fumar (distração do motorista) |
| 943 | Motorista terminou de usar o telefone (distração do motorista) |
| 944 | Motorista começou a usar o telefone (distração do motorista) |
| 945 | Bocejo (direção sob fadiga) |
| 946 | Motorista parou de se distrair (distração do motorista) |
| 947 | Motorista começou a se distrair (distração do motorista) |
| 948 | Fim da sonolência do motorista (direção sob fadiga) |
| 949 | Início da sonolência do motorista (direção sob fadiga) |
| 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 na zona de perigo (ADAS) |
| 957 | Reconhecimento de sinais de trânsito (ADAS) |
| 958 | Alerta de colisão com pedestres (ADAS) |
| 959 | Luz de advertência do motor |
| 960 | Direção sob fadiga |
| 961 | Alerta de distância de segurança (ADAS) |
| 962 | Saída da faixa à direita (ADAS) |
| 963 | Saída da faixa à esquerda (ADAS) |
| 964 | Saída da faixa (ADAS) |
| 965 | Alerta de colisão frontal (ADAS) |
| 966 | Rastreador entrou na geocerca automática |
| 967 | Rastreador saiu da geocerca automática |
| 968 | Forçar resposta de localização por SMS pela interface do usuário |
| 969 | Alarme da porta |
| 970 | Ignição desligada |
| 971 | Ignição ligada |
| 972 | Motorista não identificado |
| 973 | Motorista identificado |
| 974 | Trava fechada |
| 975 | Trava aberta |
| 976 | Energia do dispositivo desligada |
| 977 | Energia do dispositivo ligada |
| 978 | Gabinete fechado |
| 979 | Gabinete aberto |
| 980 | Botão de chamada pressionado |
| 981 | Sensor de luz detectou escuridão |
| 982 | Sensor de luz detectou claridade |
| 983 | Fim da vibração |
| 984 | Início da vibração |
| 985 | Pino da cinta inserido |
| 986 | Pino da cinta cortado |
| 987 | Condução agressiva, aceleração e curva |
| 988 | Condução agressiva, frenagem e curva |
| 989 | Condução agressiva, curva |
| 990 | Condução agressiva, aceleração |
| 991 | Condução agressiva, frenagem |
| 992 | Sinal de GPS recuperado |
| 993 | Sinal de GPS perdido |
| 994 | Alarme de colisão |
| 995 | Alarme de sinal GSM enfraquecido |
| 996 | Condução agressiva |
| 997 | Pulseira aberta |
| 998 | Pulseira fechada |
| 999 | Alerta do sensor G |
### Parâmetros complexos
Os parâmetros complexos incluem tanto o nome do grupo quanto o nome específico. Eles são categorizados da seguinte forma:
* `flags`: Um mapa de bits de sinalizadores 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 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 de 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=&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.