> For the complete documentation index, see [llms.txt](https://navixy.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://navixy.com/docs/expert-center/ru/faq-and-troubleshooting/access-iot-data/save-iot-data-to-csv-file/columns-in-csv-file.md).

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

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

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

{% hint style="info" %}
Чтобы узнать, как скачать эту информацию, см. [Сохранение IoT-данных в CSV-файл](https://navixy.com/docs/expert-center/ru/faq-and-troubleshooting/access-iot-data/save-iot-data-to-csv-file.md). Здесь мы подробнее рассмотрим, как читать этот файл и интерпретировать различные столбцы внутри него.
{% endhint %}

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

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

* ID устройства: номер ID устройства, обычно IMEI устройства. Если ваш поставщик услуг решил скрыть IMEI устройств, вместо него используется платформенный ID объекта.
* Метка устройства на платформе: метка, помогающая искать файл.
* Время начала и окончания: обозначает начало и конец файла в формате день\_месяц\_год\_часы\_минуты\_AM/PM.
* Часовой пояс в формате UTC.

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

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

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

![](https://2371323805-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIgDb43gtyXcm1Av4h1np%2Fuploads%2Fgit-blob-2f5edca71dd9b788133c28403e6c7f4d95373331%2Fimage-20240209-073506.png?alt=media\&token=67ddd84f-aa04-4f86-b9c5-f630eb575a8f)

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

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

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

* `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 событий приведен ниже.

<details>

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

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

Некоторые протоколы ретрансляции передают этот ID без изменений как свой собственный код события. См. [коды событий Recurso Confiable](https://navixy.com/docs/qna/using-navixy/recurso-confiable-event-codes.md) в качестве примера.

| **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-датчика                                               |

</details>

### Сложные параметры

Сложные параметры включают как имя группы, так и конкретное имя. Они классифицируются следующим образом:

* `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.

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


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://navixy.com/docs/expert-center/ru/faq-and-troubleshooting/access-iot-data/save-iot-data-to-csv-file/columns-in-csv-file.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
