Skip to content

New Share your ideas with the AWTRIX community. Keep your creations together in your account.

Sign in

Which AWTRIX do you have? Choose it once and the Hub shows what runs on it.

ScriptAWTRIX NG

Solar Status

On an AWTRIX display
Solar Status shown on an AWTRIX display
Solar Status · by donaldo_duck

On your display

solar dashboard showing battery SOC (with status indicators), current generated power via a bottom progress bar, and daily energy yields

Which AWTRIX do you have? See below where it runs, or choose your device.
Topic
Smarthome
Includes
Script

Runs on

  • Runs on 32×8 (TC001 & DIY)
  • Runs on 52×16 (TC002)
  • Does not run on 32×8 with AWTRIX 3 (TC001 & DIY) Made for AWTRIX NG.

Choose your display in the next step.

Send to AWTRIX

Choose your AWTRIX

Solar StatusAWTRIX NG script

Install this script on your AWTRIX NG. Its icons and sounds are installed with it.

Your AWTRIX’s local address, for example 192.168.178.39 or awtrix.local.

The name shown in your AWTRIX script list. Use letters, digits, hyphens or underscores.

Connection & device login

Connect your phone or computer to the same network as your AWTRIX. Allow local network access if your browser asks.

Use the device’s IP address, without a page path such as /#/apps.

If your AWTRIX requires a login, the username and password fields will appear when you connect.

Sign in to the Hub to install scripts. Attached files are installed separately.

Script description

⚠️ Crucial Prerequisite

This application DOES NOT connect to MQTT directly. It is part of a split-architecture layout to save ESP32 memory. It strictly REQUIRES the MQTT Collector background script to be installed and running on your AWTRIX device to feed data via global shared memory.

Overview

The Solar Status app is a dashboard designed to visualize your real-time photovoltaic data. It packs multiple live indicators into a single 32x8 view.


UI Features

  1. Dynamic Battery Icon (Left): Draws a custom battery structure pixel-by-pixel. The core fill changes color multi-stage depending on the SOC (Red -> Orange -> Amber -> Green).
  2. Charge/Discharge Status:
    • Charging: A green pulsating lightning bolt indicators flash inside the battery. Hues and saturation adjust fluidly based on the charging wattage.
    • Discharging: A flowing line travels downwards inside the battery
    • Standby: A dimmed single pixel glows inside the center.
  3. Centered Yield Display: your current daily generation string.
  4. PV Live Output Bar (Bottom Row): A customizable golden progress bar mapping your current generation output.

Setup Instructions

  1. Install Dependencies First:

    • Ensure your MQTT Collector script is running and configured correctly.
  2. Install this Script:

    • Open your AWTRIX web interface.
    • Go to the Scripts tab, create a new script, and name it solar_status.
    • Paste the Berry code into the editor and press Save (Ctrl+S).
  3. Configure Data Coupling:

    • Open the Apps tab and click the Gear icon next to Solar Status.
    • Name of MQTT_Collector: Enter the namespace name of your background collector (Default: MQTT_Collector).
    • Match the respective key names for your sensor array values:
      • PV Battery SOC
      • PV Battery Power
      • PV today Power
      • PV current Power
  4. Fine-Tuning:

    • Max. PV Power: Set your plant's custom (W_p) peak value (e.g., 16000) to scale the bottom progress indicator bar.
    • Customize layout looks by picking individual hex values for Text Color, PowerLine Color, and the sub-division dots (PowerLineIndicator Color).

More scripts in Smarthome

Something wrong with this script? Report it.