DTC (NBIoT) — веб-платформа мониторинга IoT-устройств. Оператор работает через браузер.

Термины

Как двигаются данные

# поток данных
device  ──( NB-IoT / GPRS )──▶  DTC server  ──▶  БД  ──▶  web UI
   │                            │
   │ CBOR (настройки)           │ Commands (управление)
   ▼                            ▼
CBOR payload (метрики)       web UI → оператор

1. Открыть https://dtc.duotec.ru.
2. Ввести email и password.
3. После входа — редирект на Дашборд.

Структура экрана

Палитра маркеров

🟢 В работе 🟡 Неактивен 🔴 Ошибка ⚪ Нет данных

Формула статуса

# псевдокод
status = "В работе"    if (now - last_seen) ≤ warning_window AND errors == 0
status = "Неактивен"   if warning_window < (now - last_seen) ≤ offline_window
status = "Ошибка"      if errors ≠ 0
status = "Нет данных"  if (now - last_seen) > offline_window

Матрица приоритета

Фильтры

Колонки

Периодичность обычно 1 час. Верхняя строка — самая свежая.

Как читать

1. errors должно быть 0. Иначе — раздел 13 + калькулятор.
2. rssi < 50 — плохая связь.
3. tilt выше порога (по умолчанию 15°) — тревога наклона.
4. temp_drv высокое — перегрев драйвера.
5. vbat ниже порога отсечки — проблема с АКБ.
6. counter растёт последовательно. Разрыв = пропуск.

Пример payload (JSON-представление после распаковки CBOR)

{
  "counter": 183,  "errors": 0,   "event": 2,
  "iled":    2046, "pwm_duty": 100, "reff": 5800,
  "rssi":    100,  "temp_drv": 207, "tilt": 14,
  "vac":     240,  "vbat": 3898,     "vdc": 11972,
  "vled":    11868
}

Интерпретация

Колонки

Разбор payload

1. Найдите строку по времени или типу.
2. Нажмите <> — раскроется JSON.
3. Сопоставьте поля с разделом 08.
4. errors ≠ 0 → раздел 13 + калькулятор.
5. event & 0x04 → «Уведомления».
6. Отсутствующее поле — не передано в этом пакете.

Сверху — новейшее устройство, снизу — самое раннее. Текущее помечено как current.

Отправка

1. Карточка → вкладка «Команды».
2. Кнопка «Отправить команду».
3. Тип: Атомарная / Настройки / Прошивка.
4. Подтвердить.

Атомарные команды

Статусы команд

ожидает выполнена ошибка

// пример ошибки команды
{
  "kind":          "command",
  "name":          "calibrate_tilt_sensor",
  "error_code":    6,
  "error_message": "calibrate ESP_ERR_INVALID_STATE"
}

Типы записей

Контекст события

{
  "from":   "warning",
  "to":     "error",
  "reason": "Ошибка телеметрии (errors=32)"
}

Число в скобках — errors. Введите в калькулятор (раздел 13).

Действия оператора

1. Отметить «Прочитано».
2. Нажать «Прочитать все».
3. Перейти к «Устройству» или «Команде».
4. Развернуть «Контекст события».
5. Разложить errors в калькуляторе · применить действие.

🔴 errors · bitmap аппаратных ошибок

Число — сумма поломок. Каждая поломка = один бит.

🔵 event · bitmap причин отправки

Число показывает почему устройство прислало пакет. Несколько причин — сумма битов.

Сводная шпаргалка

// пересчёт
errors = Σ ( 1 << bit )   для активных битов
example: 0x48 = 0x40 | 0x08 = ERR_ACCEL_HW | ERR_BAT

Ошибка · status = «Ошибка»

1. Карточка → «Метрики» → errors.
2. errors=0 → ошибка ушла, отметить уведомление прочитанным.
3. errors>0 → раздел 13 → ввести число в калькулятор.
4. По каждому активному биту — действие из карточки.
5. Бит помечен «залипает» → отправить restart.
6. Обновить карточку · убедиться errors=0.
7. Зафиксировать в отчёте смены.

Неактивен · status = «Неактивен»

1. Карточка → «Метрики» → rssi последнего пакета.
2. rssi < 50 → слабый сигнал · проверить антенну, расположение.
3. rssi в норме → проверить питание, SIM.
4. Проверить event: если EV_POWER_OFF — питание пропадало.
5. Если Δt > 24 ч → эскалация.

Команда · status = «Ошибка»

1. «Уведомления» → найти запись об ошибке команды.
2. Развернуть контекст → error_code, error_message.
3. ESP_ERR_INVALID_STATE → повторить позже.
4. Повторяется → эскалация.

• Дашборд · оценить распределение статусов
• «Уведомления» за смену
• Разобрать устройства в статусе «Ошибка» (калькулятор битов)
• Проверить устройства «Нет данных» > 24 ч
• Очередь команд · ожидает > 1 ч
• Выборочно: rssi, tilt, vbat, temp_drv
• Ошибок команд ESP_ERR_INVALID_STATE — нет
• Проверить event последних пакетов критичных устройств
• Зафиксировать инциденты в отчёте
• Передать смену с комментариями

Таблица: icon, code, name, updated_at. Кнопка «+ Добавить» · иконка ✏️ · корзина.