> 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
A ferramenta de data warehouse permite exportar um arquivo de dados brutos contendo todos os pacotes recebidos do seu dispositivo, sem qualquer filtro ou cálculo aplicado 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, consulte nosso [artigo anterior](/docs/expert-center/pt-br/faq-and-troubleshooting/access-iot-data/save-iot-data-to-csv-file.md). Aqui, nosso objetivo é explorar com mais detalhes como ler esse arquivo e interpretar as várias colunas nele contidas.
{% endhint %}
## Abrindo um arquivo
O nome do arquivo sempre contém o seguinte:
* ID do dispositivo: O número de ID do dispositivo, frequentemente representando seu IMEI.
* Rótulo do dispositivo na plataforma: Um rótulo para facilitar a busca do arquivo.
* De e até horário: Representando o início e o fim do arquivo no formato dia\_mês\_ano\_horas\_minutos\_AM/PM.
* Fuso horário em formato UTC.
Você pode abrir o arquivo de dados brutos com qualquer editor de texto, como WordPad, Notepad++ ou Sublime Text. Esse formato é facilmente entendido por programas e máquinas, mas pode não ser 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 de todo o arquivo.
## Parâmetros de dados brutos
O arquivo incluirá parâmetros selecionados em colunas, juntamente com uma entrada consistente - 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`: Hora em que o rastreador 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. Indicado de acordo com o fuso horário escolhido.
* `gps_fix_type`
* NO\_FIX: O rastreador GPS marcou a localização como inválida.
* HAS\_FIX: O rastreador GPS marcou a localização como válida.
* LAST\_KNOWN\_POSITION: Caso o rastreador forneça 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 GPS para este pacote.
* `lat`: Latitude da localização.
* `lng`: Longitude da localização.
* `speed`: Velocidade determinada pelo rastreador 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 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 rastreador 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 de precisão da posição - indica a exatidão da posição de um rastreador GPS com base na geometria dos satélites em relação ao rastreador. Valores menores de PDOP significam melhor posicionamento por satélite, 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 tais dados ou não conseguir fazê-lo para esta mensagem específica, será `-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 tais dados ou não conseguir fazê-lo para esta mensagem específica, será `99` (desconhecido).
* `mn_type`: Tipo de rede móvel. É determinado pelo dispositivo.
* Se o dispositivo não puder fornecer tais dados ou não conseguir fazê-lo para esta mensagem específica, será `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 de código 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.
| **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 suspensão |
| 37 | Início do modo de suspensão |
| 40 | Energia principal baixa |
| 41 | Energia perdida ou corte da alimentação externa |
| 42 | Botão Ligar pressionado |
| 43 | Energia restabelecida ou alimentação externa conectada |
| 44 | OBD desconectado do conector do carro |
| 45 | OBD conectado |
| 46 | Bateria do dispositivo de backup fraca |
| 50 | Fim da ociosidade (relacionado ao hardware) |
| 51 | Início da ociosidade (relacionado ao hardware) |
| 71 | Início da suspensão por inatividade |
| 72 | Início da suspensão por bateria de backup fraca |
| 73 | Despertar por temporizador |
| 74 | Despertar por movimento |
| 75 | Despertar por alimentação externa |
| 76 | Alerta de suspensão 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 removido 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 do aplicativo móvel |
| 798 | Envio de formulário de 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 do rastreamento |
| 812 | Fim do movimento do rastreamento |
| 813 | Fim do movimento não autorizado |
| 814 | Mensagem sem rastreamento |
| 900 | Mudança rápida de faixa na direção agressiva |
| 901 | Interferência de GPS |
| 928 | Desconectar 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 dispositivo ao objeto rastreado |
| 935 | MDSM 7 desconectado |
| 936 | MDSM 7 conectado |
| 937 | Reportar 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 desligamento 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 com fadiga) |
| 946 | Motorista parou a distração (Distração do motorista) |
| 947 | Motorista iniciou a distração (Distração do motorista) |
| 948 | Motorista parou a sonolência (Direção com fadiga) |
| 949 | Motorista iniciou a sonolência (Direção com 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 em zona de perigo (ADAS) |
| 957 | Reconhecimento de sinalização de trânsito (ADAS) |
| 958 | Alerta de colisão com pedestres (ADAS) |
| 959 | Luz de verificação do motor |
| 960 | Condução por fadiga |
| 961 | Alerta de distância do veículo à frente (ADAS) |
| 962 | Saída da faixa à direita (ADAS) |
| 963 | Saída da faixa à esquerda (ADAS) |
| 964 | Saída de faixa (ADAS) |
| 965 | Alerta de colisão frontal (ADAS) |
| 966 | Rastreador entrou em cerca geográfica automática |
| 967 | Rastreador saiu da cerca geográfica automática |
| 968 | Forçar resposta de localização por SMS a partir da 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 | 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 | Direção agressiva com aceleração e curva |
| 988 | Direção agressiva com frenagem e curva |
| 989 | Curva na direção agressiva |
| 990 | Aceleração na direção agressiva |
| 991 | Frenagem na direção agressiva |
| 992 | Sinal GPS recuperado |
| 993 | Sinal GPS perdido |
| 994 | Alarme de colisão |
| 995 | Alarme de enfraquecimento do sinal GSM |
| 996 | Direção brusca |
| 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 sinalizadores que representa a validade da localização e 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 medição. 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 informações em arquivos de dados brutos e utilizá-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.