Этот адаптер заменяет JavaScript-код с форума ioBroker.
Адаптер получает основные данные из различных сервисов прогнозирования и предоставляет их в соответствии с указаниями ioBroker.
Поддерживаемые сервисы прогнозирования
- Forecast.solar - https://forecast.solar
- Solcast - https://solcast.com
- SolarPredictionAPI — через RapidAPI
- pvnode - https://pvnode.com
Настройки
- Долгота (-180 (запад) … 180 (восток))
- Широта -90° (юг) … 90° (север)
- Ссылка на страницу
- ключ API
- Схема расположения элементов по оси Y
- Запланированный запрос данных (мин) - расписание, согласно которому данные должны извлекаться с сервера каждые x минут.
Информацию о погоде также можно получить, используя ключ API (только для Forecast.solar).
- дата и время - Дата и время
- небо - значение от 0 до 1 в процентах для ясного неба [1 = ясное небо].
- Температура [°C]
- Условие - текст
- значок - текст + число
- Скорость ветра - [км/ч]
- Угол ветра - Север 0° [по часовой стрелке]. (Если скорость ветра равна нулю, значение не определено)
- Направление ветра - Краткое название
- Более высокое временное разрешение
Для системы доступны следующие настройки.
- Наклон (0°-90°)
- Азимут (-180 = север, -90 = восток, 0 = юг, 90 = запад, 180 = север)
- Мощность системы (кВтп)
- Название растения
- Название легенды диаграммы
- Цвет диаграммы
- Цвет метки диаграммы
Вся эта информация необходима для обеспечения корректной работы адаптера.
Если широта и долгота уже сохранены в системе, система автоматически внесет данные в соответствующие поля.
pvnode
pvnode — это немецкий сервис для получения высокоточных прогнозов выработки солнечной энергии с 15-минутными интервалами. Адаптер поддерживает как API v1 (конфигурация системы в адаптере), так и API v2 (конфигурация системы на портале pvnode через идентификатор сайта).
Внимание : API pvnode версии 1 будет отключен 31 декабря 2026 года. С 1 января 2027 года адаптер будет возвращать ошибку и прекратит опрос, если настроена версия 1. Требуется переход на API версии 2 — см. информацию о pvnode API v2 ниже.
уровни учетных записей pvnode
| функция | Бесплатно | Свет | Плюс |
|---|---|---|---|
| API-запросов в месяц | 250 | 3.000 | 3.000 |
| Обновления ежедневно | 1 | 24 (ежечасно) | 144 (каждые 10 минут) |
| Прогнозируемые дни | 1-2 (сегодня + завтра) | 1-7 | 1-7 |
| солнечные панели | до 4 | до 4 | до 8 |
| Исторические данные | нет | нет | 30 дней |
Интервал запроса устанавливается адаптером автоматически в зависимости от выбранного уровня учетной записи и не требует ручной настройки:
| Уровень | Автоматический интервал |
|---|---|
| Бесплатно | 24 часа |
| Свет | 60 минут |
| Плюс | 10 минут (текущая версия прогноза) |
API pvnode версии 2 (рекомендуется)
В API v2 вся конфигурация системы (ориентация, наклон, питание) управляется непосредственно на портале pvnode через идентификатор сайта . Адаптеру требуется только идентификатор сайта — информация об азимуте/наклоне/питании в самом адаптере не нужна.
Предварительное условие: Перед настройкой адаптера необходимо создать объект на портале pvnode: https://pvnode.com/sites/new . Там вводятся все солнечные батареи (цепочки), включая их ориентацию, наклон и пиковую мощность. После сохранения портал предоставит идентификатор объекта.
Конфигурация:
- Ключ API : Создайте на https://pvnode.com/api-keys
- Используйте API pvnode версии 2 : включите флажок
- Идентификатор сайта pvnode : идентификатор сайта из портала pvnode (например,
site_xxxx…) - Уровень подписки : Бесплатный / Облегченный / Плюс (интервал получения данных определяется автоматически)
- Количество дней с прогнозом погоды : Количество дней с прогнозом погоды (Бесплатно: максимум 2 – сегодня и завтра; Легко/Плюс: максимум 7)
Таблица параметров электростанций (v2): Требуется как минимум одна запись. Имя используется для отображения; необязательная пиковая мощность используется для состояния «Установленная мощность». Адаптер запрашивает строковые данные из API v2 и присваивает каждую строку настроенной электростанции в соответствии с ее положением (Электростанция 1 → Строка 0, Электростанция 2 → Строка 1 и т. д.). Это позволяет получать прогнозы для каждой области отдельно. Если строковые данные отсутствуют, общее значение для объекта сохраняется под первой электростанцией.
API pvnode v1
В API версии 1 азимут, наклон и мощность настраиваются непосредственно в адаптере для каждой системы. Каждая система получает свой собственный вызов API.
Конфигурация:
- Ключ API : Создайте на https://pvnode.com/api-keys
- Используйте API pvnode версии 2 : Оставьте флажок снятым.
- Уровень подписки : Бесплатная / Облегченная / Плюс
- Количество дней с прогнозом погоды : Количество дней с прогнозом погоды (Бесплатно: максимум 2 – сегодня и завтра; Легко/Плюс: максимум 7)
- Дополнительные параметры : Необязательные параметры API (только для версии 1), например:
diffuse_radiation_model=perez&snow_slide_coefficient=0.5
Процедура ротационного запроса (v1): Для нескольких систем каждая система запрашивается один раз при запуске. Затем за цикл (по ротации) запрашивается только одна система. При N системах и интервале T каждая система обновляется каждые N×T. Пример: 3 системы, облегченный уровень (60 мин) → каждая система каждые 3 часа, 1 вызов API в час.
Дополнительные параметры pvnode (только для версии 1)
| параметр | Описание | Пример |
|---|---|---|
diffuse_radiation_model | Радиационная модель | perez |
snow_slide_coefficient | Коэффициент скольжения снега (0,0–0,8) | 0.5 |
shading_config | конфигурация затенения | 7:2:3:1_1:1:0:0_0:0:0:0 |
Формат:key1=value1&key2=value2
специальные возможности pvnode
- 15-минутное разрешение : pvnode предоставляет прогнозные данные с 15-минутными интервалами (v1 и v2)
- Преобразование азимута : адаптер автоматически преобразует значение азимута (адаптер: 0 = Юг) в формат pvnode (180 = Юг).
- Интервал опроса : устанавливается автоматически в зависимости от уровня учетной записи — ручная настройка не требуется.
- Прогнозы для отдельных районов (v2) : Если учетная запись pvnode предоставляет строковые данные, каждая настроенная система получает свой собственный прогноз. Значения Clearsky, температура и код погоды берутся из общесистемных данных.
- Сводные данные : JSON-файл со сводными данными содержит значения Clearsky, а также коды температуры и погоды.
- Поля "Увлажнение утром" и "Увлажнение вечером" не используются для pvnode.
Пример VIS
Перед загрузкой примера установите Material Design . Если вы хотите использовать JSON-диаграммы и таблицы в ioBroker Vis, пример можно найти здесь.
Changelog
WORK IN PROGRESS
- (@patricknitsch) Change Free Tier Forecast from only today to today and tomorrow
6.2.0 (2026-07-06)
- (@patricknitsch) pvnode API v2 support: plant configuration via Site ID in the pvnode portal — create a site at https://pvnode.com/sites/new
- (@patricknitsch) pvnode v2: per-string forecasts — each configured plant receives its own forecast matched by index (plant 1 → string 0, etc.)
- (@patricknitsch) pvnode subscription tiers (Free / Light / Plus) replace the old paid-account checkbox; poll interval is set automatically per tier
- (@patricknitsch) pvnode v1: rotating round-robin fetch — one plant per poll cycle instead of one combined request; each plant receives an individual API call
- (@patricknitsch) Poll interval field hidden for pvnode (auto-managed)
- (@patricknitsch) Update Documentation of pvnode
- (@patricknitsch) Include warning for v1 and error after 31.12.26. The adapter cannot use v1 after this date anymore
6.1.0 (2026-04-26)
- (@mcm1957) Adapter requires node.js >= 22, js-controller >= 6.0.11 and admin >= 7.7.22 now
- (@mcm1957) Dependencies have been updated
6.0.0 (2026-04-10)
- (@patricknitsch) Added pvnode als alternative Provider
- (copilot) Adapter requires admin >= 7.7.22 now
5.1.0 (2026-02-03)
- (@klein0r) admin 7.6.17 and js-controller 6.0.11 (or later) are required
- (@Scrounger) solcast user agent bug fix
- (@klein0r) Updated dependencies
5.0.0 (2025-04-23)
NodeJS >= 20.x and js-controller >= 6 is required
- (@klein0r) Minimum peak power is 0.1 kWp
License
MIT License
Copyright (c) 2026 iobroker-community-adapters iobroker-community-adapters@gmx.de
Copyright (c) 2021-2025 Patrick-Walther
Matthias Kleine info@haus-automatisierung.com
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.