> 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 que você exporte um arquivo de dados brutos contendo todos os pacotes recebidos do seu dispositivo, sem qualquer filtragem ou cálculos feitos 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 como baixar essas informações, veja [Salvar dados IoT em arquivo CSV](/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 este arquivo e interpretar várias colunas nele.
{% endhint %}
## Abrindo 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 seu provedor de serviço tiver escolhido ocultar os IMEIs do dispositivo, será usado 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 ser tão claro para as 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 fixar a primeira linha para ver os nomes das colunas ao longo de todo o arquivo.
## Parâmetros de 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
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 em que a mensagem foi recebida 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 a 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 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`: Orientaçã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 fins de navegação. `-1` significa desconhecido.
* `pdop`: Diluição posicional da precisã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 mais baixos de PDOP significam um 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 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 tiver conseguido fazer isso para esta mensagem específica, ele é `-1` (desconhecido).
* `mn_code`: Código da operadora da 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 tiver conseguido fazer isso 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 tiver conseguido fazer isso 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 do 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 indicando 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](/docs/qna/using-navixy/recurso-confiable-event-codes.md) para um 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 | 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 | Energia 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 ociosidade (relacionado ao hardware) |
| 51 | Início da ociosidade (relacionado ao hardware) |
| 71 | Início do repouso por ociosidade |
| 72 | Início do modo de repouso por bateria de backup 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 destacado 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 | Alteração do 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 | Mudança rápida de faixa em Condução agressiva |
| 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 desafivelado |
| 932 | Bebendo |
| 933 | olhos fechados |
| 934 | Fixar o dispositivo ao objeto rastreado |
| 935 | MDSM 7 desconectado |
| 936 | MDSM 7 conectado |
| 937 | Novo motorista reportado |
| 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 a distração (distração do motorista) |
| 947 | Motorista começou a distração (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 do movimento inesperado |
| 954 | Fim do movimento inesperado |
| 955 | Alarme do carro |
| 956 | Pedestres na zona de perigo (ADAS) |
| 957 | Reconhecimento de sinal 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 | Aviso 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 de porta |
| 970 | Ignição desligada |
| 971 | Ignição ligada |
| 972 | Motorista não identificado |
| 973 | Motorista identificado |
| 974 | Trava fechada |
| 975 | Trava aberta |
| 976 | Alimentação do dispositivo desligada |
| 977 | Alimentação do dispositivo ligada |
| 978 | Caixa fechada |
| 979 | Caixa aberta |
| 980 | Botão de chamada pressionado |
| 981 | Sensor de luz detectou escuro |
| 982 | Sensor de luz detectou 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 em 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 |
### 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 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 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 as saídas discretas. Cada saída discreta fica 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 fica 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 dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
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 optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
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.