В сети сотни статей про использование ESP32 для съема показаний приборов учета, но практически все из них про интеграцию с «умным домом». Мой вариант реализации решает практическую задачу — просто сам передает показания, снимая с меня эту задачу.
Основное отличие моего решения от тех, что я видел, заключается в максимальной автономности и легкости контроля и управления. E SP32 самостоятельно общается с сайтом, который принимает показания приборов учета посредством встроенного http клиента. Процесс контролируется и управляется встроенным в ESP32 telegram ботом.
Сам проект опубликован здесь.
API сайта принимающего показания
Решать эту задачу я начал с изучения API тех сайтов, которые я использовал для передачи показаний. В моем случае это были сайты https://www.mosenergosbyt.ru/ и https://мособлеирц.рф/. Исследовал API банально, используя F12 в своем браузере. Запускаем режим отладки страницы, включаем запись, аутентифицируемся, передаем показания и исследуем методы POST, которые обычно передают и принимают в качестве ответов объекты json.
Сразу скажу, что ГИС ЖКХ отбросил сразу из-за сложности аутентификации, привязки к госуслугам и 2FA. Однако, если там есть система авторизации по токенам и кто-то знает как ей пользоваться, то было бы интересно перенять такой опыт.
API сайта мосэнергосбыта мне не понравился: там используются плагины, и для разных городов и улиц АPI запросы могут существенно различаться, делая публикацию результатов работы практически бесполезной и не интересной. А вот сайт мособлеирц имеет достаточно понятный и унифицированный API.
Для исследования API сайта я написал python скрипт. Он лежит в проекте. С его помощь Вы можете исследовать свой личный кабинет в мособлеирц или использовать как отправную точку для исследования API своего поставщика.
Для аутентификации на сайте нужно методом POST отправить JSON объект со своими учетными данными
Если аутентификация прошла успешно, то нам в ответе пришлют токен, который далее нужно подставлять в атрибут X-Auth-Tenant-Token в заголовки всех последующих запросов.
Здесь я использую StaticJsonDocument фиксированного размера, который подобрал экспериментальным путем. Замечу, что этот объект создается в куче. Также в проекте я использую DynamicJsonDocument, которые размещаются в стеке. Если размер выбрать меньше необходимого, то возникнет исключительная ситуация, и ESP32 будет перезагружаться.
Далее методом GET нам нужно запросить список своих «домов». Это объекты, в которых указаны почтовые адреса и какие счетчики по этим адресам установлены. У меня в личном кабинете зарегистрировано несколько адресов, поэтому мне нужно искать объект с нужными мне счетчиками.
Этот запрос возвращает такие объекты:
Здесь нам интересны id и name. На Id будут ссылаться счетчики, а name будет использовать telegram бот. Из любопытного здесь еще есть баланс в поле utilitiesBalance, но нам он в этой задаче не интересен.
Теперь можно запросить список счетчиков для id того дома, который мы выбрали:
Этот запрос вернет нам такие объекты:
Здесь и текущие показания по тарифам (в случае нашего аналогового счетчика, это единый тариф), и дата поверки attorneyDeadline, и период, когда данные счетчиков принимаются valueSendInfo — из этих данных ESP32 узнает, когда нужно передавать показания за текущий месяц.
Когда наступит время передавать показания, ESP отправит такой запрос:
Кстати о времени: время берется по протоколу NTP, хотя также можно брать и из telegram бота, так как там в каждом запросе передается время UTC.
Бот
Контролировать процесс было решено с помощью telegram бота, встроенного в сам ESP32. Бот сделан на базе библиотеки https://github.com/GyverLibs/FastBot. Бот позволяет задать начальные значения отсчета, корректировать их по необходимости, посмотреть текущее состояние, контролировать процесс передачи показаний и заодно напомнит о дате очередной поверки счетчиков.
Команд у бота не много:
Формат команды такой:
Здесь hot и col — это целые числа в десятках литров.
Например, если прибор сейчас показывает значение 00012,345 (345 красные цифры единиц литров), нам нужно отбросить последнюю красную цифру и запятую. Таким образом, нужно передать боту только 1234. При этом, в мособлеирц бот отправит только количество целых кубометров, т.е. 12.
Мои текущие показания:
Горячая вода — 00145,765
Холодная вода — 00305,236
Отбрасываем запятые и по одной последней цифре!!! Получается, что боту нужно отправить такую команду
/set 14576 30523
Устройство счетчиков
Физические счетчики воды (приборы учета), конечно, должны быть оснащены герконами, импульсы которых считывает контроллер.
Программные счетчики импульсов пробовал делать и на основе прерываний, и с аппаратной, и с программной защитой от дребезга. Остановился на программной защите, основанной на таймерах. Оказалось, это самый практичный и надежный вариант. Тестовая эксплуатация на протяжении двух месяцев показала практически 100% точность подсчета импульсов. Такой вариант не требует никакой обвязки, провода от счетчиков можно подключить непосредственно к пинам контроллера. Отсутствие обвязки значительно упрощает проект и делает его более доступным для повторения, причем незначительно влияет на качество работы.
Подсчитанные значения сохраняются в энергонезависимой памяти контроллера, чтобы можно было пережить пропадания питания. Я использовал библиотеку preferences, но позже внимательно на нее посмотрев, решил, что в перспективе переделаю эту часть для повышения срока службы flash памяти.
Дело в том, что в ESP32 eeprom эмулируется в одной из страниц flash памяти. Подробнее об этом можно прочитать здесь https://docs.espressif.com/projects/esp-idf/en/stable/esp32/api-reference/storage/nvs_flash.html
При этом, если я правильно понял, сами значения библиотекой preferences пишутся оптимально, когда каждое обновление счетчиков занимает новый 32 байтный блок, но вот в начале страницы заголовок обновляется с каждой записью. Это значит, что ресурс этого сегмента памяти иссякнет быстрее всего. Тут не стоит сильно переживать. Объявленный ресурс 100 000 циклов, и этого должно хватить на 1000 кубометров, но все равно небольшая неудовлетворенность присутствует :).
В ближайшее время попробую доработать проект, чтобы увеличить ресурс flash. Планирую воспользоваться советами, которые мне уже дали в комментариях, и сделать запись в циклический буфер.
Личный кабинет и мобильное приложение, контактный центр и чат-бот!
В личном кабинете МосОблЕИРЦ можно:
— без комиссии оплачивать счета через «Систему быстрых платежей»;
— передавать показания счетчиков коммунальных ресурсов;
— контролировать баланс лицевого счета;
— задавать вопросы;
— заказывать справки и выписки;
— воспользоваться сервисом «Умная платежка»;
— заказать поверку счетчиков и еще десятки услуг для дома и семьи;
Как оформить подписку на электронный счет?
Подписку на электронный счет можно оформить в личном кабинете на сайте МосОблЕИРЦ и в мобильном приложении «МосОблЕИРЦ Онлайн». В разделе «Платежи» в настройках нужно выбрать опцию «Получать платежные документы по почте и в электронном виде» и указать адрес электронной почты.
Контактный центр МосОблЕИРЦ
С 1 мая контактный центр МосОблЕИРЦ перешёл на автоматический режим приема показаний. Теперь не нужно тратить время на ожидание ответа оператора, передать показания можно через автоматического голосового помощника.
Просто позвоните по номеру 8(499)444-01-00 и на вопрос автоматической системы «Скажите, что вас интересует?» ответьте «Показания», затем следуйте голосовым инструкциям.
Информация будет мгновенно обработана с помощью технологии интеллектуального распознавания речи и внесена в базу данных МосОблЕИРЦ. Единожды подтвердив свой номер телефона через голосового помощника, при последующих звонках в контактный центр не придется называть свой номер лицевого счета, голосовой помощник Вас запомнит и узнает.
Чат-бот Федот на сайте МосОблЕИРЦ
С его помощью можно передать показания, узнать баланс, адреса и режим работы клиентских офисов. Достаточно нажать на оранжевый значок чата в правом углу главной страницы сайта и ввести запрос в диалоговом окне — «передать показания» или «узнать баланс лицевого счета». После этого виртуальный помощник подскажет порядок действий.
Больше новостей о жизни округа читайте в официальном телеграм-канале «Красногорск. Новости»
В 2008 году наши дорогие депутаты приняли Федеральный закон Закон 102-ФЗ о поверке ИПУ.
А у всяких поверочных контор появился стабильный источник дохода.
И у мошенников, кстати, тоже такой источник появился, об этом я пишу в своём отзыве:
СТМ. Поверка и установка счётчиков воды, Москва.
Но мало хозяину просто вызвать мастера для проведения поверки и оплатить её,
а мастеру, со своей стороны, передать результаты в контору «Аршин», Госреестр средств измерений, созданный в том же богатом на выдумки 2008 году, все лицензированные поверяльщики туда свои сведения передают.
НЕТ! Этого не достаточно!
Результаты нужно передать ещё и в Управляющую компанию, чтобы они внесли эту бесценную инфу в свои анналы.
И эта обязанность ложится на плечи хозяина квартиры.
Но есть и хорошая новость. С недавних пор все нормальные УК принимают Акт метрологической поверки по электронной почте.
И это было довольно просто и удобно, пока в игру не вступил Мособлеирц.
Многие Управляющие компании теперь контактируют с жителями через этого посредника-монополиста.
И вот перехожу к сути — опишу интернет ресурсы Мособлеирц.
У меня в телефоне не было установлено это приложение.
Я всегда заходила в личный кабинет с компа. На мониторе мне лучше видно и удобнее работать.
Проблем с передачей показаний и оплатой никогда не было.
Хотела отправить акт, но как это сделать — хоть убейте, разобраться я не смогла.
Все кнопки нажимала, ни одна подсказка на верный путь не натолкнула.
Есть раздел ОБРАЩЕНИЯ, в котором отображаются уже поданные ранее обращения и ответы на них.
НО! При этом вы нигде не найдёте кнопки «НАПИСАТЬ ОБРАЩЕНИЕ» или что-то подобное.
Как нигде не найдёте кнопки «Отправить документ (акт о поверке и т.п.)»
Таких там НЕТ.
Чтобы создать обращение по любому вопросу, в том числе направить копии документов, нужно действовать через кнопку СЛУЖБА ПОДДЕРЖКИ, ЗАДАТЬ ВОПРОС:
И это я не сама догадалась.
Пришлось позвонить в СЛУЖБУ ПОДДЕРЖКИ, ЗАДАТЬ ВОПРОС, потом прослушать бота, дождаться ответа оператора и — о чудо! — через 15 минут получить драгоценные ЗНАНИЯ, которыми я сейчас с вами поделюсь.
Акт метрологической поверки счётчика воды
И только тогда вы увидите окно, где есть возможность связаться с этой самой поддержкой:
а в перечне вопросов выбираем ПРИБОРЫ УЧЁТА — ИНОЕ ПО ТЕМЕ ПРИБОРЫ УЧЁТА:
Если выбрать НЕ иное, а просто Приборы учёта (изменение, закрытие, акты об установке, опломбировке, поверке ИПУ), как подсказывает логика, то не получится прикрепить копию Акта. Там такой опции нет.
Поэтому нужно выбирать ИНОЕ.
Я написала в свободной форме, типа сделали поверку, высылаю акт.
После этого моё обращение появилось в окне ОБРАЩЕНИЯ.
А уже на следующий день пришёл исчерпывающий ответ:
Всё в порядке, поверка пройдена, доступ к передаче показаний появится в июне, так как информация в личном кабинете обновляется 1 раз в месяц.
Всё понятно, можно не беспокоиться.
Друзья, прочитав всё вышеизложенное вы можете подумать, что это сложно, проще в офис сходить и отнести.
Нет, нет, совсем это не сложно. Это элементарно.
Беда в том, что сайт сделали такие умельцы, которые ходовые кнопки запрятали так далеко, что надо в поддержку звонить, чтобы спрашивать, как до них добраться.
И в поддержке мне посоветовали установить ПРИЛОЖЕНИЕ.
Я специально это сделала, чтобы посмотреть, как оно работает, проще ли.
И вы знаете, ПРОЩЕ.
Скачалось и поставилось моментально. Зашла в него через Госуслуги. Сразу всё работает, стало видно 2 моих счёта. При желании можно добавить сколько нужно счетов, на квартиры всех родственников, например.
Ну то есть, так же как на сайте.
Жаль, что всё это надо делать заново, а не просто весь личный кабинет с сайта отображается в приложении.
Это недостаток для меня, тк у меня много счетов.
Прямо на Главной странице есть кнопка ОТПРАВИТЬ ОБРАЩЕНИЕ:
Нужно выбрать тему ПРИБОР УЧЁТА:
Далее, ! внимание ! ДРУГОЕ ( не ИНОЕ!)
И вот окошко, куда можно фото акта или любой файл приложить:
В 4 касания. Очень удобно.
Что ж на компютере-то сайт такой запутанный? Ведь не все могут с телефона работать.
Мне, например, лучше с компа.
