Столбцы в CSV-файле

Справочник по структуре CSV-файла Сырые данные, экспортируемого из Navixy: типы параметров, идентификаторы событий и способы интерпретации полей GPS, датчиков и состояний.

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

Чтобы узнать, как скачать эту информацию, см. Сохранение данных IoT в CSV-файл. Здесь мы подробнее рассмотрим, как читать этот файл и интерпретировать различные столбцы в нем.

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

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

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

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

• Время начала и окончания: обозначает начало и конец файла в формате день_месяц_год_часы_минуты_AM/PM.

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

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

Параметры сырых данных

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

Эти параметры можно разделить на простые и сложные.

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

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

• msg_time: Время, когда GPS-устройство зафиксировало точку. Всегда включается в CSV-вывод. Указывается согласно выбранному часовому поясу.

• server_time: Время получения сообщения сервером. Указывается согласно выбранному часовому поясу.

• gps_fix_type

  • NO_FIX: GPS-устройство пометило местоположение как недействительное.

  • HAS_FIX: GPS-устройство пометило местоположение как действительное.

  • LAST_KNOWN_POSITION: Если GPS-устройство предоставляет текущие входы и другие состояния вместе с последним известным местоположением.

  • UNKNOWN: Если устройство не может предоставить такую информацию или не определило тип GPS-фикса для этого пакета.

• lat: Широта местоположения.

• lng: Долгота местоположения.

• speed: Скорость, определенная GPS-устройством в км/ч. В большинстве случаев это скорость, определенная GPS-устройством.

• alt: Высота местоположения в метрах.

• satellites: Количество подключенных спутников в тот момент. -1 означает неизвестно и, в большинстве случаев, представляет точку LBS.

• heading: Курс объекта в градусах, где 0 соответствует северу.

• precision: Точность определения местоположения в метрах.

• hdop: Горизонтальный фактор снижения точности, показывает точность оценки горизонтального положения GPS-устройства. Значения варьируются от 1 (отлично) до более 20 (плохо). Значения от 1 до 2 считаются хорошими для большинства навигационных задач. -1 означает неизвестно.

• pdop: Фактор снижения точности по позиции, указывает точность определения положения GPS-устройства на основе геометрии спутников относительно 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: Идентификатор события платформы. Ниже приведен список всех кодов идентификаторов событий.

Идентификаторы кодов событий платформы и их определения

В пакетах устройства могут быть определены различные коды событий, каждый из которых обозначает конкретный случай.

Некоторые протоколы ретрансляции передают этот идентификатор без изменений как собственный код события. См. Коды событий Recurso Confiable для примера.

Идентификатор события	Определение
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	Предупреждение о дистанции (ADAS)
962	Выезд из правой полосы (ADAS)
963	Выезд из левой полосы (ADAS)
964	Выезд из полосы (ADAS)
965	Предупреждение о фронтальном столкновении (ADAS)
966	Трекер въехал в автоматическую зону
967	Трекер покинул автоматическую зону
968	Принудительный ответ о местоположении по SMS из интерфейса
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 : Показывает то же, что и дискретные входы, но для дискретных выходов. Каждый дискретный выход находится в отдельном столбце, пронумерованном от 1.

• inputs: Представляет данные от различных датчиков, таких как топливо или различные измерительные датчики. Каждый вход находится в отдельном столбце, а список входов зависит от модели устройства.

• states: Отображает значения параметров состояния. Большинство из них могут быть 1 или 0, но у некоторых есть специальные текстовые значения, например коды DTC.

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