New Adapter - Soliscloud

[Trixx]

Hi,

I've created an adapter to read data from the API of soliscloud.com.
The adapter can be installed in the expert settings / Custom.

https://github.com/Trixx34/ioBroker.soliscloud

At the moment it reads and stores the following values:

• battery_current_usage
• battery_percent
• bought_Today
• consumption_Today
• current_Consumption
• current_From_Net
• current_Power
• generated_Today
• sold_Today
  More values can be added if people are interested. I'll link the documentation to what's available.
  Edit; The api information with all values is available >HERE<

To use the API, you do need to request access trough suppport (service@ginlong.com).

Once API access is enabled:

• Go to https://www.soliscloud.com/#/apiManage.
• Activate API management and agree with the usage conditions.
• After activation, click on view key tot get a pop-up window asking for the verification code.
• First click on "Verification code" after which you get an image with 2 puzzle pieces, which you need to overlap each other using the slider below.
• After that, you will receive an email with the verification code you need to enter (within 60 seconds).
• Once confirmed, you get the API ID, secret and API URL

The configuration needs the API ID / API secret / PlantID to work, a polling interval also needs to be configured.

All comments and feedback welcome.

[mcm1957]

@trixx
DANKE für deinen Einsatz iun die Entwicklung des Adapters.

Neue Adapter zum Test bitte in TESTER veröffentlichen und Titel nach Möglichkeit wie dort üblich anpassen. (Test Adapter Soliscloud v1.2.3)

@Homoran

• Kannst du den Beitrag bitte verschieben, hier erreicht er die potenziellen Tester schlechter.
• Kannst du bitte @Trixx ggF für Tester freischalten?
  DANKE

[Homoran]

@mcm57 hab schon überlegt warum es in der Englischen Sektion unter Dev steht.

Als der Text dann auch auf Englisch war, war das für mich ok.

if it wasn't published here intentionally, I will move it.

[mcm1957]

@homoran
Ups, das ENGLISH hab ich gar nicht bemerkt.
Bin ziemlich sicher es ist nur Irrtum / Unerfahrenheit. (Und damits nicht falsch rüberkommt .- ich hab auch einige Zeit gebracuht bis ich die Forumsstruktur kapiert habe )

Siehe auch https://github.com/ioBroker/AdapterRequests/issues/864#issuecomment-1758331956

@Trixx - bitte melden

[mcm1957]

@all

I missed, that the complete article ist written in english. So I will post a short statement of me german posts here:Trtrixx

a) I asked homoran to move the topic to TESTER. But this is a german area. So this is NOT desired, if the authors preferred language is english. So please ognore my last two posts - I keep them to minimize confusion.

b) So @trixx if you prefer english communication, its ok to post here. Sadly to say, that most testers are reading the german TESTER area only. So if you are capable of writing in german, I suggest to open a topic at german TESTER area.

c) If you (@trixx) prefer to communicate in english, I can offer to add a german version at tester area which links to this english topic. Please legt me know if this would be ok for you.

THANKS for writen the adapter,
hope that many user / tester will check ist out.

If you need help, please feel free to ask (eventually ping me multiple times if I miss a comment)

mcm1957

P.S: SORRY that I firt answered in german

[Trixx]

@mcm57 Hi,
If you would be so kind to create a German thread that would be great. Otherwise I can do it, but I'll have to use Google translate or deepl.

Regards,
Trixx

[Homoran]

@trixx
thank you

@Trixx
@mcm57

I suggest we should create an announcement in the german tester forum with some explanations and link this Thread

[mcm1957]

I've added a german tester topic which links to this topic:

https://forum.iobroker.net/topic/69040/test-neuer-adapter-soliscloud-1-x-x

Aktuelle Test Version	1.0.0
Veröffentlichungsdatum	12.10.2023
Github Link	https://github.com/Trixx34/ioBroker.soliscloud

[Schneider_Helmut]

@Trixx

If I want to install the adapter over this link

https://github.com/Trixx34/ioBroker.SolisCloud

I get this error message:

ERROR: Process exited with code 25
Siobroker url https://github. com/Trixx34/ioBroker SolisCloud --host raspberrypi debug install Trixx34/ioBroker.SolisCloud#b39242521a5f9f1b7eee929cc658b9b1c4af0f70
NPM version: 8.19.4
Installing Trixx34/ioBroker. SolisCloud#b39242521a5f9f1b7eee929cc6589b1c4af0170... (System call) npm WARN skipping integrity check for git dependency ssh://git@github.com/Trixx34/ioBroker.SolisCloud.git
added 76 packages in 1m126 packages are looking for funding run npm fund for details
pm WARN skipping integrity check for git dependency ssh://git@github.com/Trixx34/ioBroker SolisCloud git host.raspberrypi
Cannot install Trixx34/ioBroker. SolisCloud#b39242521a5f9f1b7eee929cc658b9b1c4af0f70: 0
ERROR: Process exited with code 25

MOD-EDIT: added code tags!

[mcm1957]

@schneider_helmut

Sorry to say - this adapter is not written or maintained by me. I only created the links from the german forum part.

For support please mention @Trixx

mcm1957

P.S. NOT releated to you feedback but a general remark to this adapter. Please respect that this is Trix's first adapter, a short code review looked very good. So please be patient if required - we all had to learn. I'll take a look later if I can see whats the problem.

[Trixx]

@schneider_helmut

Could you try again and activate the debug option active ? Maybe we'll find out more then.

Which versions of iobroker / npm / node are you running on your system ?
In the logging I see the npm version is 8.19.4.
My versions on my test setup are:

• iobroker: 5.0.12
• npm: 9.8.1
• node: 20.6.1

Thanks for testing.

[Homoran]

@trixx sagte in New Adapter - Soliscloud:

My versions on my test setup are:

iobroker: 5.0.12
npm: 9.8.1
node: 20.6.1

node v20 isn't yet recommended for iobroker!

the recommended version is 18

[Trixx]

@homoran said in New Adapter - Soliscloud:

@trixx sagte in New Adapter - Soliscloud:

My versions on my test setup are:

iobroker: 5.0.12
npm: 9.8.1
node: 20.6.1

node v20 isn't yet recommended for iobroker!

the recommended version is 18

Oh, I'll have to fix that on my system and retest!

[Trixx]

@schneider_helmut said in New Adapter - Soliscloud:

@Trixx

If I want to install the adapter over this link

https://github.com/Trixx34/ioBroker.SolisCloud

Could you try using: https://github.com/Trixx34/ioBroker.soliscloud (without caps).

[Homoran]

@trixx sagte in New Adapter - Soliscloud:

without caps

I fixed this in both threads.
please tell me if there are more typos

[mcm1957]

@schneider_helmut
@Trixx

I tried now and the installation worked as expected (I did not test the functionality).

BUT a look at the console output look a little supect:

Installing Trixx34/ioBroker. SolisCloud#b39242521a5f9f1b7eee929cc6589b1c4af0170

For me, there seems to be a SPACE between the dot and the S of SolisCloud. Please retry and check your input.

I do not think that capital letters cause a problem here, as urls are case insensitive.

[Homoran]

@mcm57 sagte in New Adapter - Soliscloud:

there seems to be a SPACE between the dot and the S of SolisCloud.

@schneider_helmut sagte in New Adapter - Soliscloud:

Installing Trixx34/ioBroker. SolisCloud#b39242521a5f9f1b7eee929cc6589b1c4af0170... (System call)

here it is, too!

[Schneider_Helmut]

@trixx

Thank you. Everything works great now. Grate job! I waited over a year for a Solis adapter for IO Broker because I wasn't able to use the Solis API myself.
Perhaps it would be important to mention that for "Station/Plant ID" you do not have to enter the ID "1668XX" from the Soli portal as expected, but rather the id from the browser address while you are logged in to your solis account "https://www.soliscloud.com/#/station/stationdetail_1?id=12984919194490002YY". "Station/Plant ID" must be entered here "12984919194490002YY".

[Trixx]

@Schneider_Helmut

Good to hear everything is working now for you!

You're correct on the information regarding the plant ID, I'll update the documentation to make that more clear.
If there's any value you are missing and would like to have available in in ioBroker, let me know and I'll see what I can do!

Regards,
Trixx

[Schneider_Helmut]

@trixx
I really appreciate your support. Your adapter will be very useful to Solis as people increasingly want to network systems. I can't understand why manufacturers don't make an effort to open up to common automation solutions and offer adapters themselves. For example, I have been looking for a wallbox for months where the manufacturer offers an IoBroker adapter with which I can start charging via IO-Broker and specify the charging current for the car myself.
And I still did not find one.