Точки

Обзор

Точка (point) — это величина, которую вы измеряете: ваш ввод электросети, линия, прибор. Каждая точка привязана к каналу модуля rbAmp. Хаб хранит её текущие значения, историю и стоимость по вашему тарифу.

Есть три вида точек:

• Шина напряжения: напряжение, измеренное модулем. По нему считается мощность каждой точки.
• Ввод (Main): ваше электропитание, подключение к сети. Показывает всё подключение целиком: что вы потребляете, отдаёте и оплачиваете. (Стоимость считается для каждой точки.)
• Обычные точки: всё остальное, например линии и приборы.

Ввод и шина напряжения создаются автоматически и не удаляются: "The main input and the voltage bus cannot be deleted." По умолчанию ввод — это модуль 0, канал I0. Роль ввода в приложении изменить нельзя.

Сами модули и то, как добавить модуль, описаны на странице Sensors and modules.

Страница «Точки»

Откройте Management → Points. На странице перечислены ваши модули rbAmp, ваши точки и свободные каналы. Вверху находятся Добавить модуль (см. Adding modules) и Обновить.

Пока страница загружается, вы можете увидеть «Device is initializing — retrying…» (хаб только что запустился) или «Couldn't load sensors.» с кнопкой Повторить. «No sensors detected.» означает, что хаб не нашёл ни одного модуля.

Предупреждения шины

Модули используют общую шину I2C. Если на ней что-то идёт не так, вверху появляется предупреждение:

Разделы

На странице есть такие разделы, в этом порядке:

1. Удалённые узлы (ESP-NOW): на хабе, который умеет работать с узлами, этот раздел стоит вверху — радиомодуль хаба для узлов и карточка для каждого сопряжённого узла. Каналы узла — такие же точки, как и остальные (см. Remote nodes).
2. rbAmp modules (n): карточка для каждого модуля (см. Module cards).
3. Points (n): ваши привязанные точки, каждая в виде живой плитки. Под плиткой указан её адрес «module m · channel · I2C bus b · 0xaddr · model» (для трёхфазного ввода: «module m · L1–L3 (3 phases) · I2C bus b») и кнопка Отвязать.
4. Free sensors (n): каналы, ещё не привязанные к точке, у каждого кнопка Привязать. Канал, которого нет на установленном модуле, не предлагается. Когда все каналы заняты, страница сообщает: «No free channels. To add a point, connect another rbAmp module or unbind a point you don't need.»

Отвязка точки

Отвязать убирает точку с её канала. У входа, резервного входа и шины напряжения кнопки Отвязать нет, а их роль в приложении не меняется.

Приложение просит подтверждения. Точка перестаёт измеряться и исчезает из обзора; канал датчика снова становится свободным и может быть привязан заново. Отвязать и Удалить точку (на странице точки) — одно и то же действие: и то и другое удаляет точку и навсегда стирает её сохранённую историю. Если записи точки могут понадобиться позже, сначала выгрузите их в History (CSV).

Если хаб недоступен, приложение пишет «Couldn't unbind the point» или «Unbind request failed (device unreachable?)».

Привязка точки

Нажмите Привязать у свободного датчика. В диалоге Привязать датчик как точку вверху указан адрес датчика («Module m · channel · I2C bus b · 0xaddr»).

Внизу: «Home Assistant entities for the new point appear after the hub restarts.»

Роли

Генерация и Накопитель не предлагаются на каналах модулей BASIC. Ввод и Резервный ввод в этом списке не появляются: роль ввода в приложении не меняется.

Измерение точки генерации

Установите клещи точно так же, как любые другие: стрелка по обычному направлению потока, которое на линии генерации идёт от инвертора к дому. Перевёрнутых клещей, особого подключения и программного переключателя не существует. Всё решает роль: начиная с прошивки v1.1.5 точка с ролью Generation считает поток по направлению стрелки — от источника к потребителям — как выработку; поэтому она показывает отрицательную мощность, а её энергия попадает в Energy out.

⚠️ Отрицательная мощность у точки генерации — это правильно, не «исправляйте» её. Для этого и нужна роль. Переворачивать клещи, чтобы знак стал положительным, — единственный способ испортить правильно установленную точку генерации: выработка тогда уйдёт в Energy in, а Produced останется нулём.

Однако могут пойти не так две вещи:

• invert_sign, оставшийся от старой прошивки. До v1.1.5 точке генерации он был нужен, чтобы вообще читать выработку. После обновления его нужно очистить (POST /api/v1/units/<id> {"invert_sign": false}), иначе точка снова будет показывать потребление: invert_sign меняет результат поверх роли.
• Неподходящий тип канала. Каналы модуля BASIC учитывают только потребление — они не видят выдачу в сеть, поэтому Генерация и Накопитель на них не предлагаются. Для выработки нужен канал, который измеряет направление. Какие модули измеряют направление: the rbAmp module guide.

Фаза

Фаза определяет, к какой линии питания относится нагрузка канала в сводках по линиям. На модуле BASIC каждый канал использует единственный вход напряжения модуля, какую бы фазу вы ни выбрали.

Варианты зависят от вашего питания:

• система электропитания ещё не задана: не задано, L1, L2, L3, 3 фазы;
• однофазное: не задано, L1;
• трёхфазное: не задано, L1, L2, L3, 3 фазы, L1–L2 (two-pole), L2–L3 (two-pole), L3–L1 (two-pole).

Вариант с пометкой «not validated on hardware» ещё не проверен на реальном оборудовании. Трёхфазный ввод — это набор модулей STD-U3I3 с Сделать трёхфазным вводом на карточке модуля (см. Sensors and modules).

Повторное использование идентификатора

Если выбрать идентификатор удалённой точки, диалог предупредит, что Home Assistant и MQTT знают точку по её идентификатору и продолжат её старую историю как одну точку. Если канал теперь питает другую нагрузку, задайте новый идентификатор. Кнопка тогда называется Привязать с прежним идентификатором. Начиная с прошивки v1.1.6, хаб вместе с точкой удаляет и её запись чистого учёта, поэтому повторно использованный идентификатор начинает кредит с нуля; в v1.1.5 и ранее он наследовал кредитный баланс и остаток периода удалённой точки.

Сообщения

• «This point will show live values only: the hub keeps history for 12 points.» — все 12 мест под историю заняты. Точка всё равно показывает текущие значения.
• «ID «id» is already used by another point.» — выберите другой идентификатор.
• «Could not bind» / «Bind request failed (device unreachable?)» — проверьте связь с хабом и повторите попытку.

Точка, привязанная, пока хаб работает, начнёт хранить историю после следующего перезапуска. Хаб сохраняет историю каждой точки по часам и строит сутки, месяцы и годы из часов, поэтому при привязке никакой настройки истории выбирать не нужно.

Страница точки

Нажмите на плитку точки, чтобы открыть её страницу.

Заголовок

Назад, название точки и строка «role · source · status». Источник — rbAmp или rbAmp BASIC. Статус — норма, нет данных или нет канала в модуле.

Метки под заголовком показывают, что точка способна измерять:

• видит и потребление, и отдачу, только потребление или только потребление (модуль BASIC);
• current only — monitoring, not energy metering: модуль, который измеряет только ток;
• энергия не теряется при перезапуске;
• phase: phase.

Оповещения

Когда что-то требует внимания, под заголовком появляется оповещение:

Текущие значения

Напряжение (у трёхфазной точки — среднее по фазам), Ток (сумма фаз), Мощность и, если источник их измеряет, Реактивная и cos φ. Напряжение, отличающееся от номинала более чем на 10 %, отмечается красным как низкое или высокое. Выдача в сеть показывается как «↑ W» цветом экспорта.

Трёхфазный ввод добавляет таблицу По фазам (U3I3): L1, L2, L3 с напряжением, током, мощностью, реактивной мощностью и PF.

График

Небольшой график с Мощность, Напряжение или Энергия, по Часы, Дни или Недели. Для линий показываются последние 48 точек, для энергии — последние 24 столбца. Точки генерации рисуют выработку как положительную. Таблицей открывает те же данные в History.

Счётчики

Не показываются для модулей, которые измеряют только ток.

• Сегодня взято с «≈ сумма» по средней цене покупки за день;
• Сегодня отдано (для точки генерации — Сегодня выработано), с значением, если оно больше нуля;
• Всего взято;
• Всего отдано (для точки генерации — Всего выработано), если больше нуля; на модулях BASIC не показывается.

Зарядная станция

Точка с ролью Зарядная станция показывает также Текущая сессия: Статус и Энергия сегодня.

Статус определяется по мощности точки на любом канале — в том числе на обычном канале rbAmp; контроллер станции здесь не участвует, а у метки есть подсказка «derived from power». Он показывает Заряжает, пока мощность точки выше порога зарядки — порога самой станции, иначе порога хаба, иначе 500 Вт, — и Свободна ниже. Энергия сегодня — это потребление точки за сегодня; хаб не ведёт истории зарядки по сессиям.

Настройка точки

Внизу Настройка точки открывает настройки точки (см. Point settings), Технические детали (идентификаторы и канал, полезны для поддержки) и Удалить точку.

Удалить точку требует подтверждения: точка перестаёт измеряться и исчезает из обзора и списка точек, а её сохранённая история стирается навсегда — начиная с прошивки v1.1.6 вместе с записью чистого учёта. Канал датчика снова становится свободным и может быть привязан заново. После этого вы возвращаетесь к Точки. Если записи точки могут понадобиться позже, сначала выгрузите их в History (CSV). Ввод и шина напряжения не удаляются.

Настройки точки

Параметры точки сохраняет только поля, которые вы изменили. Пока есть несохранённые изменения, Сохранить и Отмена остаются внизу экрана; если вы попытаетесь уйти, приложение сначала спросит. Отдельного режима редактирования нет.

Fixed in v1.1.4: на прошивке хаба v1.1.3 и ранее, на ревизиях чипа ESP32 раньше v3, переименование точки могло привести к тому, что она пропадала после следующего перезапуска вместе с историей. Обновите хаб до v1.1.4 перед переименованием точек. Чтобы узнать ревизию вашего чипа, подключите плату по USB и выполните python -m esptool --chip esp32 -p <PORT> chip_id: в выводе будет, например, «ESP32-D0WD (revision v1.1)».

Точки внутри других точек

Начиная с прошивки v1.1.8, точку можно отметить как измеряемую внутри другой. Используйте это всякий раз, когда одни клещи уже включают в себя другие: подщиток и питаемая от него линия, магистральный счётчик и нагрузка за ним. Поле говорит об этом одной строкой: "If this load sits behind another point's meter (a sub-panel with its own meter, say), pick that point. Its power then counts once, in that point, and not again in the rest of the input."

Что это меняет и что нет:

• итоги хаба не меняются — они берутся на вводе и никогда не зависели от ваших точек;
• цифра неучтённого перестаёт дважды вычитать внутреннюю нагрузку. Без отметки подщиток и нагрузка в нём оба вычитаются из ввода, поэтому неучтённое получается занижено, а на хорошо измеренном щите может стать отрицательным. → Economics

⚠️ Отмечайте внутреннюю точку, а не внешнюю. Настройка означает «эта точка уже внутри той». Обратная запись описывает щит, которого у вас нет.

Когда точка удаляется — в том числе вместе с узлом, который её нёс, — вложенные в неё точки становятся верхнего уровня: цифра исправляется сама, а не сохраняет молча родительскую точку, которой уже нет.

Через API это делается запросом PATCH /api/v1/units/{id} с телом {"inside": <point id>}; значения 0, "" или null снимают отметку, а units-config возвращает inside для каждой точки.

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

• Свыше 1000 кВт: приложение просит проверить единицы измерения (поле в кВт) и не сохраняет.
• Больше, чем допускает автомат, или (для ввода) заметно меньше: приложение предупреждает и предлагает подходящее значение, рассчитанное по автомату, номинальному напряжению и числу проводников.
• Если автомат выше предела датчика, приложение предупреждает, что ток сверх предела обрезается и учёт занижается: установите датчик с большим номиналом. Предел — это ток, с которого клещи начинают обрезать, как его сообщает хаб: для клещей SCT-013 примерно на 16 % выше номинала, то есть около 11.6 А для клещей на 10 А, — и это верхняя граница диапазона «accurate … A», которая показывается на карточке модуля и в Point settings. Клещи с номиналом, равным автомату, не предупреждают. Если хаб такой величины не сообщает, диапазона и предупреждения нет; так обстоит дело с заводски сопряжёнными датчиками модуля STD. В приложении v1.1.4 и ранее проверка использовала предел на 10 % ниже номинала клещей, поэтому предупреждала даже тогда, когда номинал совпадал с автоматом.

Датчик тока

На канале SCT выберите модель клещей, которые действительно установлены. Новая модель применяется сразу, и модуль перезапускается; хаб — нет. Если канал был откалиброван на заводе с вашим датчиком, эта калибровка теряется и не восстанавливается, поэтому меняйте модель, только если установлен другой датчик. На модуле серии CT или на некалиброванном модуле модель выбрать нельзя. Поддерживаемые модели перечислены в Channel CT model.

После сохранения

• «Point settings saved.»
• После смены роли: «Saved. The role applies immediately; history depth for the new role takes effect after the device reboots.»
• «Not saved: …» с причиной. Если хабу нужен токен администратора, приложение об этом сообщит.

Что хаб хранит для каждой точки

Каждая запись содержит:

• электрические значения: среднее напряжение, ток и мощность, реактивную и полную мощность, коэффициент мощности, частоту, а также минимум и максимум напряжения, тока и мощности;
• энергию: импортированную и экспортированную за период, плюс накопительные счётчики;
• стоимость и стоимость выдачи по вашему тарифу;
• признак качества: например, неполный период, часы без синхронизации или пропуск.

Сколько хранится история

Всё хранится во внутренней флеш-памяти хаба; никакой модуль хранения не нужен.

Сколько точек хранят историю

До 12 точек хранят историю (первые двенадцать, которые вы добавили). Точки сверх двенадцати показывают текущие значения, но историю не хранят.

Точка, привязанная, пока хаб работает, начнёт хранить историю после следующего перезапуска: приложение об этом напоминает («Restart the hub to start its history»).

Чтение данных

• История показывает точку по часу, дню или месяцу (см. History). График на странице точки может показывать и недели.
• Экономика показывает стоимость и стоимость выдачи точки по периодам (см. Tariffs).
• REST API и выгрузка CSV дают те же записи (см. Source & API).

Поиск неисправностей

Точка не показывает данных

• Проверьте, что модуль подключён и его карточка отображается в Точки → модули rbAmp (см. Sensors and modules).
• Проверьте, что точка привязана к каналу, на котором стоят клещи.
• Если страница показывает предупреждение шины, см. Bus warnings.

Показания точки выглядят неверно

• Проверьте модель клещей на каналах SCT (Датчик тока) и что клещи стоят на своём канале.
• Проверьте направление клещей по метке стрелки (см. документацию модулей rbAmp).

Точка пропала после перезапуска

• Если вы переименовали её на прошивке хаба v1.1.3 или ранее: это известная проблема на ревизиях чипа ESP32 раньше v3, исправленная в v1.1.4 (см. Point settings). Обновите хаб, затем привяжите канал заново как новую точку.

У точки есть текущие значения, но нет истории

• Если вы добавили её, пока хаб работал, перезапустите хаб.
• Возможно, это тринадцатая точка или более поздняя: историю хранят только двенадцать точек, точки хаба и его узлов вместе.
• Проверьте, что время на хабе установлено (см. Time). Записи без реальной даты пропускаются.

Неучтённое отрицательное или слишком маленькое

• Одна из ваших точек уже измеряется другой — подщиток и линия за ним. Отметьте внутреннюю как measured inside внешней (прошивка v1.1.8, см. Points inside other points выше).
• Линия с выработкой, привязанная с неверной ролью, попадает не в тот блок: генерация — не линия и никогда не вычитается. → Economics

Точка генерации показывает потребление

• Начиная с прошивки v1.1.5 направление задаёт сама роль; invert_sign, оставшийся от старой прошивки, переворачивает его обратно. Очистите его (см. Roles).

У точки узла пропали имя, роль или номиналы после перезапуска

• Это исправлено в прошивке v1.1.8: точки узлов пересобираются из списка узлов при загрузке, а до v1.1.8 их имя, роль, номиналы, ориентация клещей и measured inside сбрасывались к значениям по умолчанию. На v1.1.7 и ранее задавайте их заново после каждого перезапуска — или обновите хаб. → Remote nodes

Не получается задать «Внутри точки»

• Целью должна быть существующая точка, не эта и не ввод, и цепочка не должна возвращаться по кругу. Поле появляется только начиная с прошивки v1.1.8.