> 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-файле
Инструмент хранилища данных позволяет вам экспортировать файл сырых данных, содержащий все пакеты, полученные от вашего устройства, без какой-либо фильтрации или вычислений на стороне платформы. Эти параметры представляют собой информацию, изначально декодированную из пакета вашего устройства в формате, связанном с протоколом, и представленную в удобочитаемом виде. Вам не нужно знать протокол, чтобы читать и проверять информацию в этих пакетах.
{% hint style="info" %}
Чтобы узнать, как скачать эту информацию, смотрите [Сохранение данных IoT в CSV-файл](/docs/expert-center/ru/faq-and-troubleshooting/access-iot-data/save-iot-data-to-csv-file.md). Здесь мы хотим подробнее рассмотреть, как читать этот файл и интерпретировать различные столбцы в нем.
{% endhint %}
## Открытие файла
Имя файла всегда содержит следующее:
* ID устройства: номер устройства, часто соответствующий его 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`: Идентификатор события платформы. Ниже приведен список всех кодов идентификаторов событий.
Идентификаторы кодов событий платформы и их определения
В пакетах устройства могут быть определены различные коды событий, каждый из которых обозначает конкретное событие.
Некоторые протоколы ретрансляции передают этот ID без изменений как свой собственный код события. См. [коды событий Recurso Confiable](/docs/qna/using-navixy/recurso-confiable-event-codes.md) в качестве примера.
| **Идентификатор события** | **Определение** |
| ------------------------- | --------------------------------------------------------------------- |
| 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 | Индикатор Check Engine |
| 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.
С этими определениями, надеемся, вам будет легко читать информацию в файлах сырых данных и использовать ее для диагностики устройства и в программах для ваших клиентов.
---
# 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 dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
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=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
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.