Котельная

Подключить оператора к Telegram

1. Котельная → Операторы → создайте оператора или выберите существующего.
2. Создайте код привязки Telegram и передайте оператору только этот код.
3. Оператор открывает операторский бот в личном чате и отправляет код одним сообщением.

Код одноразовый и ограничен по времени. Не отправляйте его в группу.

Права и отзыв доступа

Как узнать Telegram ID

1. Откройте в Telegram @userinfobot и нажмите Start.
2. Скопируйте числовой Id, который он покажет.

Логин вида @name не заменяет числовой Telegram ID.

Безопасная смена токена

1. В @BotFather: /mybots → нужный бот → API Token.
2. При утечке выберите Revoke current token.
3. Замените токен в конфигурации только этого бота на сервере, перезапустите службу и проверьте /start.
4. Только затем меняйте токен второго бота.

systemctl list-units --type=service --all | grep -Ei 'boiler|admin'
systemctl cat boiler-bot.service
systemctl restart boiler-bot.service

OTA и восстановление ESP32

1. Для штатного обновления: котельная → OTA-прошивка.
2. Загрузите новый .ino.bin либо выберите ранее сохранённый файл для отката.
3. Выбор не запускает прошивку. Нажимайте Запустить OTA только когда ESP онлайн.
4. Не отключайте питание до завершения обновления.

Если ESP не выходит в сеть, используйте USB-прошивку по инструкции ниже.

Статус и перезапуск

# Веб-панель
systemctl status boiler-web.service --no-pager
systemctl restart boiler-web.service

# Основной Telegram-бот операторов
systemctl status boiler-bot.service --no-pager
systemctl restart boiler-bot.service

# Найти точное имя службы админ-бота
systemctl list-units --type=service --all | grep -Ei 'boiler|admin'

После перезапуска проверьте, что в статусе указано active (running).

Последние ошибки и журналы

# Последние 100 записей журналов
journalctl -u boiler-web.service -n 100 --no-pager
journalctl -u boiler-bot.service -n 100 --no-pager

# Смотреть новые записи в реальном времени; остановить Ctrl+C
journalctl -u boiler-bot.service -f

Проверка конфигурации без паролей

# Какие службы сейчас работают
systemctl is-active boiler-web.service boiler-bot.service

# Версия Python-файлов перед перезапуском
python3 -m py_compile /opt/boiler-web/app.py
python3 -m py_compile /opt/boiler/server_bot_current.py

# Безопасная сводка аккаунтов: без паролей, хешей и Telegram ID
python3 - <<'PY'
import json
from pathlib import Path
data=json.loads(Path('/opt/boiler-web/users.json').read_text(encoding='utf-8'))
for login, user in data.get('users', {}).items():
    if isinstance(user, dict):
        print(login, user.get('role'), user.get('devices', []),
              'disabled='+str(user.get('disabled') is True),
              'alerts='+str(user.get('alert_devices', [])))
PY

Смена токена Telegram

1. В @BotFather откройте нужного бота и при необходимости выполните Revoke current token.
2. Сохраните новый токен только в конфигурации соответствующего бота на сервере. Не вставляйте его в чат, заметки, скриншоты и команды shell.
3. Перезапустите только соответствующую службу и проверьте у бота /start.

# Основной бот: откройте файл в редакторе, замените только значение BOT_TOKEN
nano /opt/boiler/server_bot_current.py
systemctl restart boiler-bot.service
systemctl status boiler-bot.service --no-pager

# Для админ-бота сначала узнайте его службу и файл конфигурации:
systemctl list-units --type=service --all | grep -Ei 'boiler|admin'
systemctl show ИМЯ_СЛУЖБЫ -p FragmentPath -p EnvironmentFiles

Перед заменой токенов дождитесь окончания всех текущих доработок. Старый токен сразу перестаёт работать после revoke.

1. Подключение платы

1. Подключить ESP32 исправным USB-кабелем с передачей данных.
2. Открыть Arduino IDE.
3. Выбрать плату ESP32 Dev Module.
4. Выбрать появившийся COM-порт.

2. Настройки Arduino IDE

3. Версия и устройство

Перед компиляцией проверить в исходнике:

#define DEVICE_KEY "boiler2"
#define FIRMWARE_VERSION 49

DEVICE_KEY должен соответствовать котельной. Версия должна быть на единицу больше версии на ESP.

4. Первая прошивка по USB

1. Нажать кнопку «Загрузить» в Arduino IDE.
2. Если долго отображается Connecting, удерживать BOOT, кратко нажать EN и отпустить BOOT после начала записи.
3. Дождаться сообщения об успешном завершении загрузки.
4. После первого запуска подключиться к сети Boiler_Setup или Boiler3_Setup и указать Wi-Fi.

5. Создание BIN-файла

1. Открыть готовый файл .ino в Arduino IDE.
2. Выбрать меню «Скетч → Экспорт бинарного файла».
3. Дождаться окончания компиляции.
4. Открыть папку скетча и выбрать файл, заканчивающийся на .ino.bin.

Для OTA используется файл приложения .ino.bin. Файлы bootloader и partitions загружать нельзя.

6. Обновление через OTA

1. Открыть нужную котельную в административной панели.
2. Нажать «OTA-прошивка».
3. Выбрать подготовленный файл .ino.bin.
4. Поле версии оставить пустым, если в исходнике уже указана следующая версия.
5. Нажать «Загрузить прошивку».
6. Проверить выбранную версию и нажать «Запустить OTA».
7. Дождаться статуса «Успешно» и появления новой версии на ESP.

Во время OTA нельзя отключать питание контроллера.

7. Если COM-порт не появился

• Проверить кабель с передачей данных и другой USB-порт.
• Проверить диспетчер устройств Windows.
• Установить драйвер USB–UART платы: CH340, CH9102/CH343 или CP2102.
• Если компьютер вообще не реагирует на подключение, проверить плату либо использовать внешний USB–UART.