Solar monitoring site data retrieval

works for

• FusionSolar (Huawei) - Kiosk URL
• SunnyPortal (SMA Solar) - PV System Overview URL
• ...

Installation

You can install the package via composer:

composer require pforret/sunnysideup

Usage

$sunny = new SunnySideUp();
$response = $sunny::get("https://region04eu5.fusionsolar.huawei.com/pvmswebsite/nologin/assets/build/index.html#/kiosk?kk=$id");

Retrieved data

Huawei/FusionSolar Kiosk URL

• Example URL: region04eu5.fusionsolar.huawei.com/pvmswebsite/nologin/assets/build/index.html#/kiosk?kk=(unique ID)
• Data:

{
    "stationData": {
        "url": "https:\/\/region04eu5.fusionsolar.huawei.com\/rest\/pvms\/web\/kiosk\/v1\/station-kiosk-file?kk=(key)",
        "name": "(name)",
        "id": "(id)",
        "address": "(address)",
        "city": null,
        "country": null,
        "timezone": null,
        "panel_count": null,
        "watt_peak": null,
        "date_commissioning": null
    },
    "dayWeather": {
        "timeSunrise": null,
        "timeSunset": null,
        "maxTemperature": null,
        "currentTemperature": null,
        "currentPrecipitation": null
    },
    "currentData": {
        "currentPowerKw": 0.64,
        "timeSampled": null
    },
    "dayProduction": {
        "kwhSystem": 8.72,
        "equivalentTrees": null,
        "equivalentKgCoal": null,
        "equivalentKgCo2": null
    },
    "monthProduction": {
        "kwhSystem": 98.2,
        "equivalentTrees": null,
        "equivalentKgCoal": null,
        "equivalentKgCo2": null
    },
    "yearProduction": {
        "kwhSystem": 129.46,
        "equivalentTrees": 1,
        "equivalentKgCoal": 51.78,
        "equivalentKgCo2": 61.49
    },
    "totalProduction": {
        "kwhSystem": 184.84,
        "equivalentTrees": 1,
        "equivalentKgCoal": 73.94,
        "equivalentKgCo2": 87.8
    }
}

SMA/SunnyPortal.com URL

• Example URL: www.sunnyportal.com/Templates/PublicPageOverview.aspx?page=(pageID)&plant=(plantID)&splang=en-US
• data:

{
    "stationData": {
        "url": "https:\/\/www.sunnyportal.com\/Templates\/PublicPageOverview.aspx?page=3e371bac-b19a-4257-853c-aac4d3601c0b&plant=46e9985f-128a-4da8-a70d-e95f72085ca4&splang=en-US",
        "name": null,
        "id": null,
        "address": null,
        "city": null,
        "country": null,
        "timezone": "Romance Standard Time",
        "panel_count": null,
        "watt_peak": 1800,
        "date_commissioning": ""
    },
    "dayWeather": {
        "timeSunrise": null,
        "timeSunset": null,
        "maxTemperature": null,
        "currentTemperature": null,
        "currentPrecipitation": null
    },
    "currentData": {
        "currentPowerKw": 138,
        "timeSampled": "2023-02-24T09:45:00"
    },
    "dayProduction": {
        "kwhSystem": 0.077,
        "equivalentTrees": null,
        "equivalentKgCoal": null,
        "equivalentKgCo2": 0.054
    },
    "monthProduction": {
        "kwhSystem": null,
        "equivalentTrees": null,
        "equivalentKgCoal": null,
        "equivalentKgCo2": null
    },
    "yearProduction": {
        "kwhSystem": null,
        "equivalentTrees": null,
        "equivalentKgCoal": null,
        "equivalentKgCo2": null
    },
    "totalProduction": {
        "kwhSystem": 16385,
        "equivalentTrees": null,
        "equivalentKgCoal": null,
        "equivalentKgCo2": 11000
    }
}

Testing

composer test

Changelog

Please see CHANGELOG for more information on what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Security Vulnerabilities

Please review our security policy on how to report security vulnerabilities.

Credits

• Peter Forret
• All Contributors

License

The MIT License (MIT). Please see License File for more information.