# 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 filtragem ou cálculos realizados no lado da plataforma. Esses parâmetros representam informações inicialmente decodificadas a partir do pacote do seu dispositivo em formato relacionado ao protocolo, apresentadas de forma legível por 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, você pode consultar nosso [artigo anterior](https://www.navixy.com/docs/expert-center/pt-br/faq-and-troubleshooting/access-iot-data/save-iot-data-to-csv-file). Aqui, temos como objetivo explorar mais detalhadamente como ler este arquivo e interpretar várias colunas nele. {% 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. * Hora de início e fim: Representando o início e o fim do arquivo no formato dia\_mes\_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 compreendido 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 tabelas. No editor de tabelas, 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 dos dados brutos O arquivo incluirá parâmetros selecionados em colunas, juntamente com uma entrada consistente - msg\_time. ![](https://786860322-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIgDb43gtyXcm1Av4h1np%2Fuploads%2Fgit-blob-2f5edca71dd9b788133c28403e6c7f4d95373331%2Fimage-20240209-073506.png?alt=media) 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 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 entrada atual e outros estados dentro da última localização conhecida. * UNKNOWN: Se um dispositivo não puder fornecer tal informação ou não determinou o tipo de fixação 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, onde 0 representa o Norte. * `precision`: Precisão da localização em metros. * `hdop`: Diluição horizontal da precisão - representa a acurácia das estimativas da 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 propósitos de navegação. `-1` significa desconhecido. * `pdop`: Diluição da precisão de posição - indica a acurácia da posição do rastreador GPS com base na geometria dos satélites em relação ao rastreador. Valores de PDOP mais baixos significam melhor posicionamento pelos 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 tais dados ou não pôde fazê-lo para esta mensagem em particular, ele será `-1` (desconhecido). * `mn_code`: Código do operador de rede móvel. Determinado pelo dispositivo. * `mn_csq`: Intensidade do sinal da rede móvel, CSQ, valores de 0 a 31. Determinado pelo dispositivo. Se o dispositivo não puder fornecer tais dados ou não pôde fazê-lo para esta mensagem em particular, 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 pôde fazê-lo para esta mensagem em particular, ele 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 do 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 | Dispositivo acorda de um modo de suspensão | | 37 | Início do modo de suspensão | | 40 | Energia principal baixa | | 41 | Perda de energia ou corte de energia externa | | 42 | Botão Power On pressionado | | 43 | Energia recuperada ou energia externa conectada | | 44 | OBD desconectado do conector do carro | | 45 | OBD conectado | | 46 | Bateria auxiliar do dispositivo baixa | | 50 | Fim de inatividade (relacionado ao hardware) | | 51 | Início de inatividade (relacionado ao hardware) | | 71 | Início de sono por inatividade | | 72 | Início de sono por bateria auxiliar baixa | | 73 | Despertar por temporizador | | 74 | Despertar por movimento | | 75 | Despertar por energia externa | | 76 | Alerta de sono 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 | 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 de formulário de 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 não relacionada a rastreamento | | 900 | Mudança rápida de faixa por direção brusca | | 901 | Interferência de GPS | | 928 | Desconectado do objeto rastreado | | 929 | Mudança frequente de faixa | | 930 | Dispositivo não consegue detectar rosto humano | | 931 | Cinto de segurança desabotoado | | 932 | Ingestão de bebida | | 933 | Olhos fechados | | 934 | Anexar dispositivo ao objeto rastreado | | 935 | MDSM 7 desconectado | | 936 | MDSM 7 conectado | | 937 | Relatar 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 (fadiga ao dirigir) | | 946 | Motorista parou distração (distração do motorista) | | 947 | Motorista começou distração (distração do motorista) | | 948 | Motorista parou sonolência (fadiga ao dirigir) | | 949 | Motorista iniciou sonolência (fadiga ao dirigir) | | 950 | Excesso de velocidade por evento de hardware | | 951 | Controle de cruzeiro ligado | | 952 | Controle de cruzeiro desligado | | 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 sinal de trânsito (ADAS) | | 958 | Alerta de colisão com pedestre (ADAS) | | 959 | Luz de verificação do motor | | 960 | Condução fatigada | | 961 | Alerta de distância segura (Headway) (ADAS) | | 962 | Saída de faixa à direita (ADAS) | | 963 | Saída de 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 de cerca geográfica automática | | 968 | Forçar resposta de localização por SMS a partir da interface | | 969 | Alarme de porta | | 970 | Ignição desligada | | 971 | Ignição ligada | | 972 | Motorista não identificado | | 973 | Motorista identificado | | 974 | Tranca fechada | | 975 | Tranca aberta | | 976 | Dispositivo desligado | | 977 | Dispositivo ligado | | 978 | Case fechado | | 979 | Case aberto | | 980 | Botão de chamada pressionado | | 981 | Sensor de luz determinou escuridão | | 982 | Sensor de luz determinou claridade | | 983 | Fim de vibração | | 984 | Início de vibração | | 985 | Parafuso da alça inserido | | 986 | Parafuso da alça cortado | | 987 | Aceleração brusca e curva (condução agressiva) | | 988 | Frenagem brusca e curva (condução agressiva) | | 989 | Curva brusca (condução agressiva) | | 990 | Aceleração brusca (condução agressiva) | | 991 | Frenagem brusca (condução agressiva) | | 992 | Sinal GPS recuperado | | 993 | Sinal GPS perdido | | 994 | Alarme de colisão | | 995 | Alarme de atenuação de sinal GSM | | 996 | Direção brusca | | 997 | Pulseira aberta | | 998 | Pulseira fechada | | 999 | Alerta do sensor G |
### Parâmetros complexos 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 flags representando 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, onde 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 de parâmetros de estado. A maioria pode ser 1 ou 0, mas alguns possuem valores textuais 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 utilizá-las na resolução de problemas do dispositivo e em programas para seus clientes.