Skip to content

Commit

Permalink
refactor: readme.md
Browse files Browse the repository at this point in the history
  • Loading branch information
davidrapan committed Jul 15, 2024
1 parent e1bda5c commit a9e7f23
Showing 1 changed file with 15 additions and 15 deletions.
30 changes: 15 additions & 15 deletions readme.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,14 @@

Integration for Solarman Stick Logger

> [!NOTE]
> Use πŸ’¬ Discussions for πŸ™ Q&A and πŸ’‘ Development Planning, etc. and leave 🚩 Issues for 🐞 bug reporting, 🎁 feature requests and such...
> [!NOTE]
> It's still 🚧 work in progress but it's currently 🐎 very stable πŸ˜‰
>
> *I mean at least for my device as I'm not able to* πŸ§ͺ *test it for any other so any* 🧍 *volunteers?*
> [!IMPORTANT]
> This integration builds on and is heavily inspired by [@StephanJoubert](https://github.com/StephanJoubert/home_assistant_solarman) (but W/ decent amount of changes):
> - Using asynchronous part of [@jmccrohan](https://github.com/jmccrohan/pysolarmanv5) + small adjustments to the inner workings of the library itself
Expand All @@ -25,18 +33,10 @@ Integration for Solarman Stick Logger
> So look through the file and change them as you see fit manually before I'll make it available from the HA configuration.
>
> One more thing.. It's not possible to use this integration side by side (with the same device) with the implementation from Stephan! It will override it.
> [!NOTE]
> It's still work in progress but I'm now over 3 weeks of uptime so it's really stable ;)
>
> *I mean at least for my device as I'm not able to test it for any other so any volunteers?*
>
> ...
> [!WARNING]
> TODO: Rest of the info :-D
> TODO: Rest of the info... πŸ˜ƒ
## Miscellaneous
## πŸš€ Miscellaneous

Some might wonder why Energy Dashboard shows different(higher) Load Consumption than sensor like for example "Today(Daily) Load Consumption. And it's because the Energy Dashboard does it's own calculations by summing up Imported(Bought) and Produced energy which also includes consumption of the inverter itself + some AC/DC losses along the way."

Expand All @@ -59,7 +59,7 @@ Today(Daily) losses = Today(Daily) Energy Imported(Bought) + Today(Daily) Produc

_To get value which is in Energy Dashboard as "Home Consumption" remove subtraction of Load Consumption from the above._

## Diagnostics
## 🏭 Diagnostics

I was using during the development also this sensor bundle:
```
Expand Down Expand Up @@ -89,15 +89,15 @@ template:
Which provides informantion about how long it is since last update (with resolution of seconds).
Maybe it will be useful for some, but since the stability of the polling improved a lot it's not really needed.

## Installation
## πŸ”¨ Installation

[![Open your Home Assistant instance and open a repository inside the Home Assistant Community Store.](https://my.home-assistant.io/badges/hacs_repository.svg)](https://my.home-assistant.io/redirect/hacs_repository/?owner=davidrapan&repository=ha-solarman&category=integration)
[![πŸ”Œ Open your Home Assistant instance and open a repository inside the Home Assistant Community Store.](https://my.home-assistant.io/badges/hacs_repository.svg)](https://my.home-assistant.io/redirect/hacs_repository/?owner=davidrapan&repository=ha-solarman&category=integration)

### HACS (Manually)
### πŸͺ› HACS (Manually)
- Follow the link [here](https://hacs.xyz/docs/faq/custom_repositories/)
- Add custom repository: https://github.com/davidrapan/ha-solarman
- Select type of the category: integration
- Find newly added Solarman, open it and then click on the DOWNLOAD button

### Manually
### πŸ”§ Manually
- Copy the contents of 'custom_components/solarman' directory into the Home Assistant with exactly the same hirearchy withing the '/config' directory

0 comments on commit a9e7f23

Please sign in to comment.