WavIoT — беспроводная система учета ресурсов
Последние статьи
API авторизации в веб-сервисах
Единая авторизация Запрос: POST https://auth.waviot.ru/?action=user-login Content-type: application/json X-requested-with: XMLHttpRequest {"login": "example@example.com","password":"your_password"} Ответ в случае, если указаны правильные логин и пароль HTTP/1.1 200 OK Content-Type: application/json; charset=UTF-8 { "sc": "...", "rt": "...", "WAVIOT_JWT": "...", "sessid": "..." } Ответ в случае, если указаны неправильные логин и пароль: HTTP/1.1 302 Moved Temporarily Далее для запросов на auth.waviot.ru/lk.waviot.ru/api.waviot.ru используем полученный JWT в заголовках ко всем запросам, требующим авторизацию. Обновление токенов или авторизация пользователя. Запрос может быть как get так и post Запрос: POST|GET https://auth.waviot.ru/?action=user-refresh Content-type: application/json X-requested-with: XMLHttpRequest {"login": "example@example.com","password":"your_password"} Ответ в случае, если...
01 Sep, 2021 Комментарии: 0
Структура тарифного расписания по DLMS
Структура тарифного расписания по DLMS { active: timestamp, seasons: { day_start: week_name, ... }, weeks: { week_name: [ day_id_1 ... day_id_7 ], ... }, days: { day_id: { start_time: tariff, ... }, ... }, special_days: { day_start: day_id, ... } } где active – время активации расписания seasons – объект содержащий описание сезонов “day_start“ – дата в формате MMDD (месяц-день) – дата активации “week_name“ – идентификатор недели (0..63) weeks – объект содержание описание недель, в описании недели строго 7 дней “day_id“ – идентификатор недели (0..63) days – объект содержащий описание дней “start_time“ – время в минутах с начала суток с которого действует тариф “tariff“ – тариф (0..7) special_days – объект содержание описание специальных дней Пример минимального тарифного расписания: { "seasons": { "101": 0 // - 1 января начало сезона, действует...
01 Sep, 2021
Полный список каналов и их OBIS-кодов
OBIS — OBject Identification System code Стандарт Россетей (!) https://www.promotic.eu/en/pmdoc/Subsystems/Comm/PmDrivers/IEC62056_OBIS.htm Open Metering System Specification https://lk.waviot.ru/api/channels_list/ https://cp.waviot.com/api/channels_list/ (для западных партнёров) Краткое обозначение OBIS HEX OBIS decimal LK channel Описание Единица измерения - 0800010000FF 8.0.1.0.0.255 160 Холодная вода м³ - 0900010000FF 9.0.1.0.0.255 159 Горячая вода м³ - 0600010000FF 6.0.1.0.0.255 heat_power Тепловая энергия кВт·ч/ГКал - 0700030000FF 7.0.3.0.0.255 1053 Газ м³ A⁺ T1 0100010801FF 1.0.1.8.1.255 electro_ac_p_lsum_t1 Активная энергия к потребителю по сумме фаз тариф 1 с момента сброса кВт·ч A⁺ T2 0100010802FF 1.0.1.8.2.255 electro_ac_p_lsum_t2 Активная энергия к потребителю по сумме фаз тариф 2 с момента сброса кВт·ч A⁺ T3 0100010803FF ...
03 Nov, 2020
API модуля gateway
API - методы модуля gateway Модуль gateway выполняет функции NB-Fi базовой станции. Данный HTTP API-интерфейс предоставляет доступ к модулю gateway для администрирования и мониторинга базовой станции. Данные методы доступны как при подключении непосредственно к сетевому интерфейсу БС, так и на API – сервере http://api.waviot.ru Таблица 1. Сводная таблица всех API методов модуля gateway Описание URL Метод Требует авторизацию, роль Чтение номера БС /gateway/localid GET да, guest Чтение списка параметров БС /gateway/read_params GET да, guest Изменение параметров БС /gateway/write_params GET да, admin Конфигурирование GPS /gateway/gps GET да, admin Конфигурирование часов /gateway/time GET да, admin Чтение списка UL и DL пакетов БС /gateway/messages ...
26 May, 2020 Комментарии: 0
API модуля HES
Контракты (contracts) – сущности инкапсулирующие в себе батчи. В рамках контракта создаются батчи. Дерево прав для hes API - методы модуля HES Возможные коды ответов HES: 200 - Смотри описание метода. 400 - Не верные входные параметры 401 - Не авторизован. Нужно получить или обновить JWT токен на auth. 403 - Нет доступа к запрашиваемому ресурсу, нужно получить правильные claims 404 - такой страницы не существует. 406 - Выход из сессии или аккаунта 500 - Ошибка при котором дальнейшие исполнение не возможно. Таблица 1. Сводная таблица всех API методов модуля HES Описани URL Метод Создание контракта /contracts_add POST Изменение контракта /contracts_edit POST Получение контрактов /contracts_get GET Данные по модемам /modem_getModems POST Вернуть все модему пл батчу /modem_getBatches GET Создание батча /batches_add POST Добавление модемов в батч /batches_addModems POST...
20 Feb, 2020 Комментарии: 0
Подключение с нарушениями
Если абонент, у которого стоит Фобос Сплит однофазный, захочет украсть электроэнергию путем отключения нулевого проводника и использования в качестве нуля в обход счетчика (использование мощного заземления в качестве нуля), в таком случае счетчик будет считать без нуля или нет? Для расчета потребления счетчик использует напряжение, приложенное в соответствии со схемой включения(клеммы 1,3, для однофазных приборов) и тока протекающего через фазные клеммы(1,2 для однофазников). При сохранении указанной в документации схемы включения, использование земли вместо нуля не позволяет украсть электроэнергию, т.к. счетчик выполняет учет отпущенной электроэнергии по фазе. Возможные варианты украсть электроэнергию с нарушением указанной схемы включения: а) Подключение к фазному проводу минуя счетчик. В этом случае счетчик продиагностирует разбаланс токов. б) Подключение к фазному и нулевому проводу минуя счетчик в) Подключение к фазному проводу минуя счетчик и к земле вместо нуля. г)...
19 Dec, 2019 Комментарии: 0
API модуля driver
API - методы модуля driver Таблица 1. Сводная таблица всех API методов модуля driver Описание URL Метод Отправка DL пакетов /api/dl POST Статус отправленных DL пакетов Запрос DL пакетов /api/dl GET Чтение состояний устройств /api/setting GET Запись состояний устройств /api/setting POST Запрос данных формата ROLL /api/roll GET Запрос данных формата EAV /api/eav GET Репарсинг бинарных пакетов /api/reparse GET Запрос списка id модемов /api/app_ids GET Проверка владельца модемов /api/check_ids GET Запрос метаданных приложения /api/metadata GET Отправка DL пакетов POST запрос: URL Список параметров Пример запроса /api/dl ...
02 Dec, 2019 Комментарии: 0
API модуля telecom
API - методы модуля telecom Модуль telecom выполняет функции NB-Fi телеком-cервера. Данный HTTP API-интерфейс позволяет получать, отправлять NB-Fi пакеты данных, конфигурировать режимы работы устройств, базовых станций, выполнять мониторинг работы сети и загружать лицензии на новые устройства. Данные API - методы доступны на сервере https://api.waviot.ru Таблица 1. Сводная таблица всех API методов модуля telecom Описание URL Метод Чтение списка UL, DL, ULAPP, INFO пакетов /telecom/api/messages GET Чтение списка DLAPP пакетов /telecom/api/dl_messages GET Чтение статуса DLAPP пакета /telecom/api/dl_message_status GET Отправка DLAPP пакета /telecom/api/send_dl GET Удаление UL, DL, ULAPP, INFO пакета /telecom/api/deletemessage GET Чтение параметров устройств /telecom/api/device GET ...
26 Nov, 2019 Комментарии: 0
Порядок действий для направления оборудования на ремонт
Для оформления заявки на гарантийный возврат необходимо написать письмо на email: guarantee@waviot.ru К письму приложить заполненный Акт передачи приборов учета (ПУ) на гарантийное обслуживание/ремонт /kb_upload/file/2019_%D0%90%D0%BA%D1%82%20%D0%BF%D0%B5%D1%80%D0%B5%D0%B4%D0%B0%D1%87%D0%B8%20%D0%B2%20%D1%80%D0%B5%D0%BC%D0%BE%D0%BD%D1%82(1).docx В груз, помимо оборудования, вложить следующие документы: - Форма М15 (накладная на отпуск материалов) - Оригинал Акта передачи приборов учета (ПУ) на гарантийное обслуживание/ремонт Отгрузка до адреса: г. Москва, Варшавское шоссе 125, стр 1 ООО "Телематические Решения" Наши реквизиты: почтовый адрес: 125047, г. Москва, ул. Лесная, д.3 ИНН / КПП: 7725339890 / 773101001 ОГРН: 5167746320044 ОКПО: 05534663 Полное наименование банка: ПАО Сбербанк г. Москва Расчетный счет №: 40702810038000136228 Мы были бы Вам признательны, если отгрузка оборудования будет осуществляться транспортной компанией "Деловые линии".
17 Oct, 2019 Комментарии: 0
API личного кабинета ЖКХ
Переда началом работы не забудьте авторизоваться для получения JWT Дополнительную информацию об использовании API можно найти тут: https://lk.waviot.ru/api/ Получение основной информации о личном кабинете ЖКХ Запрос: GET https://lk.waviot.ru/api.general/info/ Ответ: HTTP/1.1 200 OK Content-Type: application/json; charset=UTF-8 { "status": "ok", "config": { "domain": "lk.waviot.ru", "logo": "/icons/logo.png", "title": "WAVIoT", "support_email": "support@waviot.ru", "support_site": "https://waviot.makekb.com/28/", "locales": { "ru_RU": "Русский", "ua_UA": "Украинский", "en_US": "English", "mn_MN": "Монгол", "rs_RS": "Србија" } } } Получение основной информации о модеме Запрос: GET https://lk.waviot.ru/api.modem/info/?id=70B3B9 Authorization: bearer [JWT] Ответ при успешном выполнении запроса: HTTP/1.1 200 OK Content-Type: application/json; charset=UTF-8 { "status": "ok", "modem": { "id":...
29 Aug, 2019 Комментарии: 0
Забыл пароль от личного кабинета, как восстановить?
Вы можете запросить восстановление пароля. Сделать это можно по ссылке: auth.waviot.ru, далее - восстановить пароль. На зарегистрированную ранее и подтвержденную Вами почту придет информация о смене пароля.
14 Aug, 2019 Комментарии: 0
API облачной платформы Вавиот
Описание API облачной платформы «Вавиот». Вступление Авторизация Доступные методы Методы модуля driver_electro5 Методы модуля gateway Методы модуля telecom Методы модуля driver Методы модуля lk Вступление Программный интерфейс API предназначен для взаимодействия облачной платформы «Вавиот» со сторонними системами верхнего уровня с целью доступа к данным, содержащимся в базе данных, прямому доступу к устройствам сети NB-Fi , конфигурирования и контроля функционирования. API представляет собой набор программных методов, исполняющихся посредством HTTP GET либо POST запросов. Сервер, предоставляющий API: https://api.waviot.ru Авторизация Все методы API предполагают предварительную авторизацию клиента. Сервер, выполняющий авторизацию и регистрацию новых пользователей: https://auth.waviot.ru Авторизация Процедура авторизации предполагает передачу логина и пароля по защищенному каналу и получение в ответ JWT-токена. Токен возвращается в теле ответа...
25 Jul, 2019 Комментарии: 0
API модуля driver_electro5
API методы модуля driver_electro5 Модуль driver_electro5 реализует поддержку приборов учета электроэнергии Вавиот Фобос. Данные методы доступны на API – сервере http://api.waviot.ru , а также при подключении непосредственно к сетевому интерфейсу УСПД. Для доступа к методам модуля необходимо использовать URL-преффикс /driver_electro5/ Получение показаний приборов учета Значение Описание Запрос Протокол http(s) Тип запроса GET или POST Путь /api/report/history Параметры modem Десятичный уникальный идентификатор модема прибора учета. Допускается массив значений через «,» profile Профиль из которого получены данные. Допускается массив значений через «,». Перечень вариантов см. ниже. Если параметр не задан – принимает все допустимые значения ...
28 Jun, 2019 Комментарии: 0
Список кодов событий для фобосов STM
Протокол Electro5 API Electro5 HEX code Decimal code Alphanumeric code Event descripton 0X0001 0,1 dlms_event_u_a_off Фаза А — пропадание напряжения 0X0002 dlms_event_u_a_on фаза а — восстановление напряжения 0X0003 dlms_event_u_b_off фаза в — пропадание напряжения 0X0004 dlms_event_u_b_on фаза в — восстановление напряжения 0X0005 dlms_event_u_c_off фаза с — пропадание напряжения 0X0006 dlms_event_u_c_on фаза с — восстановление напряжения 0X0007 dlms_event_u_lmt_up_start превышение напряжения любой фазы 0X0008 dlms_event_u_lmt_up_stop окончание перенапряжения любой фазы 0X0009 dlms_event_u_lmt_down_start низкое напряжение любой фазы — начало 0X000A dlms_event_u_lmt_down_stop низкое напряжение любой фазы — окончание 0X000B dlms_event_u_asymmetry_start превышение коэффициента несимметрии напряжений по обратной...
15 May, 2019
Я получил оборудование. Что дальше?
Если Вы приобрели оборудование напрямую в компании ВАВИОТ и у Вас еще не было доступов к нашей системе, то Вы должны сделать следующее: 1. Регистрируетесь на auth.waviot.ru (почта + пароль) 2. После регистрации отправляете на support@waviot.ru письмо со следующей информацией: - свой логин - наименование компании - регион/город 3. служба технической поддержки проведет привязку оборудования к вашей учетной записи, после чего напишет Вам об успешном завершении Если Вы приобрели оборудование у нашего партнера: 1. Регистрируетесь на auth.waviot.ru (почта + пароль) 2. После регистрации отправляете сотруднику компании, где приобретали оборудование, письмо со следующей информацией: - свой логин - наименование компании - регион/город 3. сотрудник компании проведет окончательное оформление Вашей учетной записи и предоставит Вам доступ. Если Вы интегратор и хотите предоставить доступ своим клиентам: 1. Пользователь регистрируется на auth.waviot.ru (почта + пароль) ...
13 May, 2019 Комментарии: 0
Я установил оборудование «ВАВИОТ», как получить доступ в личный кабинет?
Если Вы приобрели оборудование напрямую в компании ВАВИОТ и у Вас еще не было доступов к нашей системе, то Вы должны сделать следующее: 1. Регистрируетесь на auth.waviot.ru (почта + пароль) 2. После регистрации отправляете на support@waviot.ru письмо со следующей информацией: - свой логин - наименование компании - регион/город 3. служба технической поддержки проведет привязку оборудования к вашей учетной записи, после чего напишет Вам об успешном завершении Если Вы приобрели оборудование у нашего партнера: 1. Регистрируетесь на auth.waviot.ru (почта + пароль) 2. После регистрации отправляете сотруднику компании, где приобретали оборудование, письмо со следующей информацией: - свой логин - наименование компании - регион/город 3. сотрудник компании проведет окончательное оформление Вашей учетной записи и предоставит Вам доступ. Если Вы интегратор и хотите предоставить доступ своим клиентам: 1. Пользователь регистрируется на auth.waviot.ru (почта + пароль) ...
26 Apr, 2019 Комментарии: 0
Работа с auth
Логика работы auth строится на 3х сессионных куках. "sc": "Секретный ключ", "rt": "токен выдачи новых значений ", "WAVIOT_JWT": " jwt токен который выдается для работы с остальными нашими сервисами" “sessid”: «сама сессия на auth сервер» Чтобы обратится к auth обязательно наличие 3х значений в куках (sc,rt,sessid). Если они не указаны то будет создана новая сессия. WAVIOT_JWT выдается только auth сервером и только авторизованным пользователям
04 Mar, 2019 Комментарии: 0
Общие положение
Сервер аутентификации и авторизации представляет собой отдельный инстанс. Со своей отдельной базой пользователей и доступов к различный сущностям (модемам, БС) . Так же в отдельной базе хранятся сессионные данные. В дальнейшем именно эту базу можно будет реплицировать но все ноды, в которых нужно знать о доступах пользователя.
04 Mar, 2019 Комментарии: 0
API УСПД Вавиот
Описание API УСПД «Вавиот». Вступление Подключение к УСПД Авторизация Доступные методы Методы модуля driver_electro5 Методы модуля gateway Методы модуля telecom Коды ошибок Вступление Программный интерфейс API предназначен для взаимодействия УСПД «Вавиот» со сторонними системами верхнего уровня с целью доступа к данным, содержащимся в базе данных УСПД, прямому доступу к устройствам сети NB-Fi (приборам учета электроэнергии), конфигурирования и контроля функционирования. API представляет собой набор программных методов, исполняющихся посредством HTTP GET либо POST запросов. Подключение к УСПД Для осуществления обмена данными с УСПД необходимо наличие TCP/IP канала между ПО верхнего уровня и физическим Ethernet интерфейсом УСПД. Порт для HTTP- обмена: 80 Авторизация Большинство методов API предполагают предварительную авторизацию клиента. В УСПД поддерживается два пользователя, имеющих роли guest и admin. Ниже описана последовательность действий...
14 Jan, 2019 Комментарии: 0
Какое максимальное количество приборов учета поддерживает одна базовая станция?
Базовая станция NB-Fi имеет как приемный, так и передающий канал и функционирует в полном дуплексе, то есть выполняет одновременный прием и передачу данных. Пропускная способность приемного канала составляет около 2 млн. NB-Fi - пакетов в сутки, независимо от скоростей на которых были отправлены пакеты, при вероятности потери пакета не более 5%. В теории это означает, что одна базовая станция может выполнять прием данных от 2 млн. счетчиков расхода воды, для которых достаточно одного пакета в сутки(типовой режим счетчиков воды Нептун и АКВА2). Канал передачи данных от базовой станции к счетчикам воды не используется. Приборы учета электроэнергии требуют наличия обратного канала и функционируют в режиме работы с поддержкой всех функций транспортного протокола NB-Fi(автоматический выбор оптимальной скорости связи и мощности передачи, гарантированная доставка данных в обоих направлениях и др). Данные функции требуют регулярную отправку данных по обратному каналу и количество...
17 Dec, 2018 Комментарии: 0
Что означает параметр DL(Downlink status) на странице отображения списка базовых станций.
Данный статус отображает текущее(усредненное за последние 10 минут) значение степени загруженности канала отправки даунлинк-пакетов. Причины высокой степени загрузки могут быть следующими: 1) Базовая станция была введена в работу недавно. Все приборы учета изначально работают на низких скоростях передачи данных и для их работы требуется большая загрузка обратного канала. Устройства, имеющие запас по уровню радиосигнала, автоматически выполняют повышение скорости отправки/приема данных, что приводит к сокращению загруженности канала отправки даунлинк-пакетов. Процесс этот постепенный и требует некоторого времени, в зависимости от кол-ва приборов и их режимов работы. Порядок времени - от 6 до 24 часов. 2) Слишком большое кол-во устройств или низкий уровень сигнала. Расчетное максимальное кол-во приборов учета на одну базовую станцию зависит от объемов данных и, например, для электросчетчиков Фобос составляет 300 устройств, работающих на самой низкой скорости связи. В реальности,...
16 Nov, 2018 Комментарии: 0
В личном кабинете показания выше чем фактические на счетчике. Что делать?
Для выявления причины возникновения завышенных показаний в личном кабинете необходимо убедиться, что при установке счетчика не забыли установить клапан обратного хода. Если клапан был не установлен - установите клапан. После установки клапана проведите калибровку счетчика на месте установки. Для проведения новой калибровки счетчика необходимо будет приобрести неодимовый магнит и совершить следующий порядок действий: открыть кран, чтобы через счетчик текла вода приложить магнит к прозрачной крышке счетчика дожидаться ровно 7 морганий (справа начнет моргать светодиод красным цветом) убрать магнит и подождать не менее 20 сек для выполнения калибровки закрыть кран после снова приложить магнит дожидаться ровно 5 морганий. записать серийный номер, показания на счетчике, время и дату калибровки Далее заходите в личный кабинет, настройки - калибровка - и вводите начальные показания, нажимаете кнопку "сохранить". Наблюдаете несколько дней, как будут вести себя счетчики...
31 Oct, 2018 Комментарии: 0
Правильно ли я понял, что базовые станции принимают и отправляют данные со всеми датчиками в данной области? Или датчики подвязываются к конкретным базовым станциям в личном кабинете? Если да, то можно ли запретить привязку к «своей» базовой станции «чужих» датчиков?
Наши устройства принимаются всеми базовыми радиостанциями, работающими в используемой полосе частот. Программно на сервере можно ограничить доступ владельцу базовой станции к принятым сообщениям «чужих модемов» (они не будут даже видны в отчете о принятых сообщениях). В личный кабинет «ВАВИОТ» или через API с сервера клиенту передается только расшифрованная и обработанная информация о модемах, привязанных к конкретному клиенту. Данные с «чужих» датчиков недоступны для «чужих» клиентов благодаря шифрованию
26 Oct, 2018 Комментарии: 0
Как мне узнать, что станция включилась и принимает сообщения?
После установки базовой станции необходимо зайти на https://b.waviot.ru/stations/. Здесь Вы проверяете статус БС. Зеленый кружок означает, что станция онлайн, красный - оффлайн. Если кружок зеленый, заходите на https://b.waviot.ru/reports/bsmessages/. Этот раздел позволяет провести анализ полученных сообщений от устройств на станции и уровни сигналов (SNR + RSSI) сообщений.
26 Oct, 2018 Комментарии: 0
Могу ли я как владелец БС запретить регистрацию на сервере пакетов, принятых от «чужих» устройств?
Если вы подключаете БС к нашему облаку, то нет, “чужие” будут обрабатываться невидимо для вас. При этом вы будете иметь доступ только к своим сообщениям. На БС сообщения приходят и уходят в зашифрованном виде, так что возможности подслушать чужие пакеты у владельца БС нет. Кроме того в БС нет базы данных, по которой она могла бы отличить свои от чужих модемов. Если у вас свое облако, то БС будет обрабатывать только ваши устройства.
26 Oct, 2018 Комментарии: 0