интерфейс к PVOutput.org

Адаптер PvOutput.org: читает и записывает данные на PVOutput.org.

Текущий релиз
2.0.1
Разработчик
René G.
Лицензия
MIT

Этот адаптер использует библиотеки Sentry для автоматического сообщения разработчикам об исключениях и ошибках в коде. Более подробную информацию, а также инструкции по отключению отправки сообщений об ошибках см. в документации Sentry-Plugin ! Система отчетности Sentry используется начиная с js-controller 3.0.

Если вам понравилось, пожалуйста, рассмотрите возможность пожертвования:

PayPal

Адаптер подключается к PvOutput.org . Для установления соединения используются System-ID и API-ключ. Оба параметра необходимо настроить на странице администратора. В настоящее время считываются и отображаются в виде точек данных системные, статусные и статистические данные для всех настроенных систем. Выработанную энергию можно постоянно загружать на PvOutput.org.

Для получения более подробной информации, пожалуйста, ознакомьтесь с разделом справки на сайте pvoutput.org.

Если вы поддержите pvoutput.org пожертвованием, вам станут доступны дополнительные функции. В настоящий момент они ещё не поддерживаются в адаптере.

Скачать

Адаптер загружает три типа данных.

  • Системные данные
  • Данные о состоянии
  • Статистические данные

Для загрузки данных адаптер запускает настраиваемое задание cron. Частоту загрузки можно настроить на странице администратора с помощью параметра "интервал чтения данных [мин]". Обычно значение частоты загрузки составляет 15 минут, но не более 59 минут.

Системные данные

Адаптер получает информацию о состоянии системы и данные о текущем состоянии.

Подробнее в документации API.

Данные о состоянии

Данные о состоянии (или данные в реальном времени) включают все возможные системные данные, доступные для вашей системы.

Подробнее в документации API.

Статистические данные

Адаптер получает статистическую информацию о системе.

Подробнее в документации API.

Загрузить

Загрузка данных — это лишь опция. Если вы загружаете данные с помощью других приложений, например sbfspot, отключите загрузку здесь, в адаптере.

Загрузка данных в режиме реального времени

Для загрузки данных в режиме реального времени/данных о состоянии адаптер запускает настраиваемое задание cron. Частоту загрузки можно настроить на странице администратора с помощью параметра "интервал записи данных [мин]". Обычно значение частоты загрузки составляет от 5 до 15 минут, но не более 59 минут.

Адаптер предоставляет множество точек данных в папке "upload" для каждой системы. Необходимо использовать только точку данных "мощность" или "энергопотребление". Все остальные являются необязательными.

Подробнее в документации API.

Расчет мощности и энергии

Значения мощности и энергии могут быть получены из друг друга. Когда система отправляет только значения мощности, соответствующие значения энергии рассчитываются автоматически. Аналогично, когда отправляются только значения энергии, PVOutput рассчитает среднюю мощность.

Подробнее в документации API.

Накопленная энергия - CumulativeFlag в конфигурации системы

Для накопительного флага допустимы следующие значения: 1 — значения выработки и потребления энергии являются значениями энергии за весь период работы. Потребление и выработка энергии обнуляются в начале дня. 2 — только выработка энергии является значением энергии за весь период работы. 3 — только потребление энергии является значением энергии за весь период работы.

По умолчанию: 1

Подробнее в документации API.

Net Data — NetDataFlag в конфигурации системы.

Параметр, установленный на 1, указывает на то, что передаваемые значения мощности представляют собой чистый экспорт/импорт, а не валовую выработку/потребление. Эта опция используется для устройств, которые не могут предоставлять данные о валовом потреблении. Предоставленные данные об импорте/экспорте объединяются с существующими данными о выработке для определения потребления.

По умолчанию: не отмечено

Подробнее в документации API.

Загрузка данных на конец дня

В конце дня будет выполнена отдельная команда загрузки. Можно загрузить множество различных данных. Эти данные доступны в виде точек данных в папке загрузки для каждой системы. Все они являются необязательными.

Подробнее в документации API.

известные проблемы

  • Пожалуйста, создавайте запросы на GitHub , если обнаружите ошибки или пожелаете добавить новые функции.

Changelog

2.0.1 (2026-09-12)

  • (René) update dependencies

2.0.0 (2026-06-30)

  • (René) rewritten in typescript
  • (René) support of new version of DasWetter adapter
  • (copilot) Adapter requires node.js >= 22 now
  • (René) update dependencies

1.9.7 (2026-03-15)

  • (René) update dependencies + changes based on adapter checker

1.9.6 (2025-10-26)

  • (René) bug fix sentry

1.9.5 (2025-10-21)

  • (René) update dependencies + changes based on adapter checker

License

MIT License

Copyright (c) 2022-2026 René G. info@rg-engineering.eu

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.