# Столбцы в файле CSV Инструмент хранилища данных позволяет экспортировать необработанный файл данных, содержащий все пакеты, полученные от вашего устройства, без какой-либо фильтрации или вычислений на стороне платформы. Эти параметры представляют информацию, изначально декодированную из пакета вашего устройства в формате, связанном с протоколом, и представлены в удобочитаемом виде. Вам не нужно знать протокол, чтобы прочитать и проверить информацию в этих пакетах. {% hint style="info" %} Чтобы узнать, как загрузить эту информацию, вы можете обратиться к нашему [предыдущей статье](https://www.navixy.com/docs/expert-center/ru/faq-and-troubleshooting/access-iot-data/save-iot-data-to-csv-file). Здесь мы стремимся более подробно исследовать, как читать этот файл и интерпретировать различные столбцы в нём. {% endhint %} ## Открытие файла Имя файла всегда содержит следующее: * ID устройства: номер идентификатора устройства, часто представляющий его IMEI. * Метка устройства на платформе: метка для облегчения поиска файла. * Время «от» и «до»: представляет начало и конец файла в формате day\_month\_year\_hours\_minutes\_AM/PM. * Часовой пояс в формате UTC. Вы можете открыть необработанный файл данных в любом текстовом редакторе, таком как WordPad, Notepad++ или Sublime Text. Этот формат легко понимается программами и машинами, но может быть не столь удобен для человека. Чтобы упростить чтение файла, мы рекомендуем использовать табличный редактор. Просто откройте CSV-файл в Excel, Google Sheets или любом другом табличном редакторе. В табличном редакторе все параметры будут расположены в отдельных столбцах. Дополнительно вы можете зафиксировать первую строку, чтобы видеть названия столбцов во всём файле. ## Параметры необработанных данных Файл будет включать выбранные параметры в столбцах, вместе с одной постоянной записью — msg\_time. ![](https://3533348223-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIgDb43gtyXcm1Av4h1np%2Fuploads%2Fgit-blob-2f5edca71dd9b788133c28403e6c7f4d95373331%2Fimage-20240209-073506.png?alt=media) Эти параметры можно классифицировать как простые или сложные. ### Простые столбцы Простые параметры дают полные названия и в основном представляют конкретную информацию отслеживания. * `msg_time`: Время, когда трекер зафиксировал точку. Всегда включено в CSV-вывод. Указывается в соответствии с выбранным часовым поясом. * `server_time`: Время получения сообщения сервером. Указывается в соответствии с выбранным часовым поясом. * `gps_fix_type` * NO\_FIX: Трекер GPS пометил местоположение как недействительное. * HAS\_FIX: Трекер GPS пометил местоположение как действительное. * LAST\_KNOWN\_POSITION: В случаях, когда трекер предоставляет текущие входные данные и другие состояния в пределах последнего известного местоположения. * UNKNOWN: Если устройство не может предоставить такую информацию или не определило тип GPS-fix для этого пакета. * `lat`: Широта местоположения. * `lng`: Долгота местоположения. * `speed`: Скорость, определённая трекером, в км/ч. В большинстве случаев это скорость, определённая GPS-устройством. * `alt`: Высота местоположения в метрах. * `satellites`: Количество подключённых спутников в данный момент; `-1` означает неизвестно и, в большинстве случаев, представляет точку LBS-локации. * `heading`: Направление объекта в градусах, где 0 соответствует северу. * `precision`: Точность местоположения в метрах. * `hdop`: Горизонтальное разведение погрешности (Horizontal Dilution of Precision) — характеризует точность оценки горизонтальной позиции GPS-трекера. Значения варьируются от 1 (отлично) до выше 20 (плохо). Значения между 1 и 2 считаются хорошими для большинства навигационных целей. `-1` означает неизвестно. * `pdop`: Позиционное разведение погрешности (Position Dilution of Precision) — указывает на точность определения позиции GPS-трекера на основе геометрии расположения спутников относительно трекера. Более низкие значения PDOP означают лучшее расположение спутников, что приводит к более точным данным о местоположении, но `-1` означает неизвестно. * `mn_name`: Название мобильной сети. Определяется устройством. * `mn_roaming`: Статус роуминга. Определяется устройством. * `0` означает отсутствие роуминга, * `1` означает, что эта точка была сгенерирована устройством в роуминге, * Если устройство не может предоставить такие данные или не сделало это для данного сообщения, это будет `-1` (неизвестно). * `mn_code`: Код оператора мобильной сети. Определяется устройством. * `mn_csq`: Уровень сигнала мобильной сети, CSQ, значения от 0 до 31. Определяется устройством. Если устройство не может предоставить такие данные или не сделало это для данного сообщения, это будет `99` (неизвестно). * `mn_type`: Тип мобильной сети. Определяется устройством. * Если устройство не может предоставить такие данные или не сделало это для данного сообщения, это будет `UNKNOWN` * `GSM`: Если устройство определило тип GSM. * `CDMA`: Если устройство определило тип CDMA. * `WCDMA`: Если устройство определило тип WCDMA. * `LTE`: Если устройство определило тип LTE. * `NR`: Если устройство определило тип NR. * `event_id`: ID события платформы. Найдите список всех кодов ID событий ниже.
Коды ID событий платформы и их определения В пакетах устройства могут быть определены различные коды событий, каждый из которых обозначает определённое происшествие. | **ID события** | **Определение** | | -------------- | ------------------------------------------------------------ | | 2 | Трек. Нет конкретного события, просто точка трека | | 4 | Набран номер экстренного контакта | | 5 | Определено несанкционированное движение устройством | | 11 | Изменение состояния входа 1 | | 12 | Изменение состояния входа 2 | | 13 | Изменение состояния входа 3 | | 14 | Изменение состояния входа 4 | | 15 | Изменение состояния входа 5 | | 16 | Изменение состояния входа 6 | | 17 | Изменение состояния входа 7 | | 18 | Изменение состояния входа 8 | | 34 | Устройство просыпается из режима сна | | 37 | Начало режима сна | | 40 | Основная питание низкое | | 41 | Питание потеряно или внешнее питание отключено | | 42 | Нажата кнопка включения питания | | 43 | Питание восстановлено или внешнее питание подключено | | 44 | OBD отключен от автомобильного разъёма | | 45 | OBD подключен | | 46 | Запасная батарея устройства низкая | | 50 | Конец простоя (связанный с аппаратной частью) | | 51 | Начало простоя (связанный с аппаратной частью) | | 71 | Начало сна в простое | | 72 | Начало сна из-за низкой резервной батареи | | 73 | Пробуждение по таймеру | | 74 | Пробуждение по движению | | 75 | Пробуждение от внешнего питания | | 76 | Предупреждение о сне по таймеру | | 81 | Режим безопасности включён | | 82 | Пользовательское событие | | 83 | Событие нажатия кнопки SOS | | 84 | Режим безопасности выключен | | 90 | Отключение антенны | | 100 | Устройство отсоединено от объекта | | 111 | Изменение состояния вывода 1 | | 112 | Изменение состояния вывода 2 | | 113 | Изменение состояния вывода 3 | | 114 | Изменение состояния вывода 4 | | 115 | Изменение состояния вывода 5 | | 116 | Изменение состояния вывода 6 | | 117 | Изменение состояния вывода 7 | | 118 | Изменение состояния вывода 8 | | 797 | Чек-ин отправлен из мобильного приложения | | 798 | Отправка формы задания | | 799 | Изменение рабочего статуса | | 800 | GSM LBS-точка определена устройством | | 802 | Трек-точка по времени | | 803 | Трек-точка по дистанции | | 804 | Трек-точка по углу | | 811 | Начало движения трека | | 812 | Окончание движения трека | | 813 | Окончание несанкционированного движения | | 814 | Не-трековое сообщение | | 900 | Резкий манёвр — быстрое перестроение полосы | | 901 | Глушение GPS | | 928 | Отключение от отслеживаемого объекта | | 929 | Частая смена полосы | | 930 | Устройство не может распознать человеческое лицо | | 931 | Ремень безопасности расстёгнут | | 932 | Употребление алкоголя | | 933 | Глаза закрыты | | 934 | Прикрепить устройство к отслеживаемому объекту | | 935 | MDSM 7 отключен | | 936 | MDSM 7 подключен | | 937 | Сообщить о новом водителе | | 938 | Водитель входит в кабину | | 939 | Начало отсутствия водителя | | 940 | Водитель перестал курить (отвлечение водителя) | | 941 | Нажата кнопка выключения питания | | 942 | Водитель начал курить (отвлечение водителя) | | 943 | Водитель закончил использовать телефон (отвлечение водителя) | | 944 | Водитель начал использовать телефон (отвлечение водителя) | | 945 | Зевота (усталость водителя) | | 946 | Водитель прекратил отвлечение (отвлечение водителя) | | 947 | Водитель начал отвлечение (отвлечение водителя) | | 948 | Водитель прекратил дремоту (усталость водителя) | | 949 | Водитель начал дремоту (усталость водителя) | | 950 | Превышение скорости, определённое аппаратным событием | | 951 | Круиз-контроль включён | | 952 | Круиз-контроль выключен | | 953 | Начало неожиданного движения | | 954 | Окончание неожиданного движения | | 955 | Сработала сигнализация автомобиля | | 956 | Пешеходы в зоне опасности (ADAS) | | 957 | Распознавание дорожных знаков (ADAS) | | 958 | Предупреждение о столкновении с пешеходом (ADAS) | | 959 | Контрольная лампа двигателя | | 960 | Усталое вождение | | 961 | Предупреждение о дистанции (Headway) (ADAS) | | 962 | Выход из правой полосы (ADAS) | | 963 | Выход из левой полосы (ADAS) | | 964 | Выход из полосы (ADAS) | | 965 | Предупреждение о фронтальном столкновении (ADAS) | | 966 | Трекер вошёл в авто-геозону | | 967 | Трекер покинул авто-геозону | | 968 | Принудительный ответ о местоположении по SMS из UI | | 969 | Сигнализация двери | | 970 | Зажигание выключено | | 971 | Зажигание включено | | 972 | Водитель не идентифицирован | | 973 | Водитель идентифицирован | | 974 | Замок закрыт | | 975 | Замок открыт | | 976 | Питание устройства выключено | | 977 | Питание устройства включено | | 978 | Корпус закрыт | | 979 | Корпус открыт | | 980 | Нажата кнопка вызова | | 981 | Датчик света определил темноту | | 982 | Датчик света определил светло | | 983 | Конец вибрации | | 984 | Начало вибрации | | 985 | Ремешковый болт вставлен | | 986 | Ремешковый болт перерезан | | 987 | Жёсткое вождение: ускорение и поворот | | 988 | Жёсткое вождение: торможение и поворот | | 989 | Жёсткое вождение: поворот | | 990 | Жёсткое вождение: ускорение | | 991 | Жёсткое вождение: торможение | | 992 | GPS-сигнал восстановлен | | 993 | GPS-сигнал потерян | | 994 | Сработала аварийная сигнализация при аварии | | 995 | Тревога ослабления GSM-сигнала | | 996 | Агрессивное вождение | | 997 | Браслет открыт | | 998 | Браслет закрыт | | 999 | Предупреждение датчика G |
### Сложные параметры Сложные параметры включают как имя группы, так и конкретное имя. Они классифицируются следующим образом: * `flags`: Битовая карта флагов, представляющая действительность местоположения и LBS: * Бит 0 (location\_valid): Указывает статус действительности местоположения. Он `0` если местоположение недействительно, и `1` если местоположение действительно. * Бит 1 (lbs): Указывает статус LBS точки. Если `0`, точка получена по GPS; если `1`, точка получена по LBS. * Бит 2 (soft\_lbs): Указывает источник LBS-точки. Если `0`, точка определена LBS устройства; если `1`, — LBS платформы. * `discrete_inputs`: Представляет информацию от каждого дискретного входа. Каждый дискретный вход представлен в отдельном столбце, пронумерованном, начиная с 1. Возможные значения — 1 и 0, где 0 означает выключено, а 1 означает включено. * `discrete_outputs` : Показывает то же, что и discrete\_inputs, но для дискретных выходов. Каждый дискретный выход находится в отдельном столбце, пронумерованном, начиная с 1. * `inputs`: Представляет данные от различных датчиков, таких как датчик топлива или различные измерительные датчики. Каждый вход расположен в отдельном столбце, а список входов зависит от модели устройства. * `states`: Отображает значения параметров состояний. Большинство из них могут быть 1 или 0, но некоторые имеют специфические текстовые значения, такие как коды DTC. С этими определениями мы надеемся, что вам будет легко читать информацию в файлах необработанных данных и использовать их при устранении неполадок устройства и в программах для ваших клиентов.