Перейти к содержимому
For the complete documentation index, see llms.txt. This page is also available as Markdown.

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

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

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

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

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

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

  • ID устройства: номер ID устройства, обычно IMEI устройства. Если ваш поставщик услуг решил скрыть IMEI устройств, вместо него используется платформенный ID объекта.

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

  • Время начала и окончания: обозначает начало и конец файла в формате день_месяц_год_часы_минуты_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: ID события платформы. Список всех кодов ID событий приведен ниже.

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

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

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

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 disconnected

936

MDSM 7 connected

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.

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

Последнее обновление

Это было полезно?