Колонки в CSV-файле

Инструмент хранилища данных позволяет экспортировать необработанный файл данных, содержащий все пакеты, полученные от вашего устройства, без какой-либо фильтрации или вычислений на стороне платформы. Эти параметры представляют информацию, изначально декодированную из пакета вашего устройства в формате, связанном с протоколом, и представлены в удобочитаемом виде. Вам не нужно знать протокол, чтобы прочитать и проверить информацию в этих пакетах.

Чтобы узнать, как загрузить эту информацию, вы можете обратиться к нашему предыдущей статье. Здесь мы стремимся более подробно исследовать, как читать этот файл и интерпретировать различные столбцы в нём.

Открытие файла

Имя файла всегда содержит следующее:

• ID устройства: номер идентификатора устройства, часто представляющий его IMEI.

• Метка устройства на платформе: метка для облегчения поиска файла.

• Время «от» и «до»: представляет начало и конец файла в формате day_month_year_hours_minutes_AM/PM.

• Часовой пояс в формате UTC.

Вы можете открыть необработанный файл данных в любом текстовом редакторе, таком как WordPad, Notepad++ или Sublime Text. Этот формат легко понимается программами и машинами, но может быть не столь удобен для человека. Чтобы упростить чтение файла, мы рекомендуем использовать табличный редактор. Просто откройте CSV-файл в Excel, Google Sheets или любом другом табличном редакторе. В табличном редакторе все параметры будут расположены в отдельных столбцах. Дополнительно вы можете зафиксировать первую строку, чтобы видеть названия столбцов во всём файле.

Параметры необработанных данных

Файл будет включать выбранные параметры в столбцах, вместе с одной постоянной записью — msg_time.

Эти параметры можно классифицировать как простые или сложные.

Простые столбцы

Простые параметры дают полные названия и в основном представляют конкретную информацию отслеживания.

• 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.

С этими определениями мы надеемся, что вам будет легко читать информацию в файлах необработанных данных и использовать их при устранении неполадок устройства и в программах для ваших клиентов.