Übersicht der API (Stand FW1.0a)

Du möchtest Deinen Automower in Deine Hausautomatisierung einbinden oder eine eigene App entwicklen?
Hier wird diese offene Schnittstelle zum Robonect Hx Modul beschrieben.
LaborEtArs
Beiträge: 6
Registriert: Sa 25. Mai 2019, 14:17
Mäher: Husqvarna Automower 420
Herstellungsjahr: 2017 (Modell 2018)
Robonect-Modul: Robonect Hx (Rev.5)
Robonect Firmware: V1.0 Beta 7a

Übersicht der API (Stand FW1.0a)

Beitrag von LaborEtArs » Do 13. Jun 2019, 12:58

Nachdem es (aktuell) noch keine vollständige Übersicht der aktuellen API gibt (ist ja von @admin angekündigt), habe ich übergangsweise mal den recherchierten Stand zusammengestellt.
Das ist sicher nicht vollständig und ich habe keine Doku, sondern nur (Teile) der puren API, aber vielleicht hilft es dem ein- oder anderen dennoch...
Anstelle von '/json?' geht natürlich auch '/xml?'

PS: Hinweise aus den Kommentaren nehme ich natürlich gern in die Liste auf :)


/json?cmd=battery
....battery
....id
....charge
....voltage
....current
....temperature
....capacity
....full
....remaining

/json?cmd=direct&left=%il&right=%ir&timeout=%ut
....%il: Drehzahl(?) linkes Rad; kann auch ein negativer Wert sein
....%ir: Drehzahl(?) rechtes Rad; kann auch ein negativer Wert sein
....%ut: Dauer in Millisekunden (1/1000 Sekunden), maximaler Wert: 5000

/json?cmd=error [&reset]
....errors
....0..4
........error_code
........error_message
........date
........time
........unix

/json?cmd=ext
....ext
........gpio1
............inverted
............status
........gpio2
............inverted
............status
........out1
............inverted
............status
........out2
............inverted
............status

/json?cmd=ext&ext=[0..1]

/json?cmd=hour
....general
........run
........mow
........search
........charge
........charges
........errors
........since

/json?cmd=mode&mode=<neuer Modus>
Erlaubte Modi:
....home <1: Mäher fährt in die Ladestation>
....eod <2: Mäher schalte aus 'home' und um 00:00 Uhr wieder in den vorherigen Modus>
....man <3: Mäher schaltet in den manuellen Betrieb; i.S. 'auto aus'>
....auto <4: Mäher schaltet in den automatischen, d.h. timergesteuerten Betrieb>
....job <Mäher führt einen Mähauftrag aus>
........duration <Dauer des Auftrages. Wenn der Mäher lädt, läuft die 'Uhr' dennoch!>
........start <Startuhrzeit 'hh:mm', kann entfallen, dann gilt 'sofort'
........end <Endzeit 'hh:mm'>
........after <Modus, der nach diesem Mähauftrag aktiviert werden soll. '0' bedeutet, den Modus nicht ändern>
........remotestart <Fernstartpunkt; 0:Ladestation, 1:Startpunkt 1, 2: Startpunkt 2; evtl. <Danke an demichve> 0:Standard(?), 1:Normal(?), 2: Pkt 1, 3: Pkt 2>

/json?cmd=motor
....drive
........left
............current
............power
............speed
........right
............current
............power
............speed
....blade
........current
........average
........speed

/json?cmd=portal
....enabled
....connected
....address
........domain
........url
........host
............default
............friendly

/json?cmd=push
....push
........server
............url
........trigger
............interval
............trigger%i
................name <z.B. 'Parked', 'Mowing', ...>
................enter
................leave
............mit i=0..9

/json?cmd=push&url=192.168.1.1:80 <Danke an LegoSpieler!>
/json?cmd=push&interval=n (n Sekunden)
/json?cmd=push&trigger%i=[0 (AUS), 1 (Enter EIN, Leave AUS), 2 (Enter AUS Leave EIN), 3 (Enter EIN, Leave EIN)]
....mit i=0..9
Info:Die einzelnen Anweisungen können verkettet werden; z.B.: /json?cmd=push&trigger0=1&trigger4=3

/json?cmd=status
....name
....id
....status
........status
............> 0: Status wird ermittelt
............> 1: Automower parkt
............> 2: Automower mäht
............> 3: Automower sucht die Ladestation
............> 4: Automower lädt
............> 5: Automower sucht (wartet auf das Umsetzen im manuellen Modus)
............> 7: Fehlerstatus
............> 8: Schleifensignal verloren
............> 16: Automower abgeschaltet
............> 17: Automower schläft
........duration
........mode
............> 0: Auto
............> 1: Manuell
............> 2: Home
............> 3: Demo
........battery
........hours
....timer
........status
............> 0: Deaktiviert
............> 1: Aktiv
............> 2: Standby
........next
............date
............time
............unix
....blades
........quality
........hours
........days
....wlan
........signal
....health
........temperature
........humidity
<
....alarm
........voltage3v3extmin
........voltage3v3extmax
........voltage3v3intmin
........voltage3v3intmax
........voltagebattmin
........voltagebattmax
........temperatureMin
........temperatureMax
........humidityMax
............voltages
................ext3v3
................int3v3
................batt
............climate
................temperature
................humidity
>
....clock
........date
........time
........unix

/json?cmd=timer
....timer
........0..13
............id
............enabled
............start
............end
............weekdays
................mo
................tu
................we
................th
................fr
................sa
................su
........save=1 // Sichert die Daten im Roboter <Danke an kobelka>

/json?cmd=timer&timer=1&start=06:00&end=09:00&mo=1&tu=1&we=1&th=1&fr=1&sa=1&su=1&enable=1

/json?cmd=version
....mower
........hardware
............production
............serial
........msw
............compiled
............title
............version
........sub
............version
....serial
....application
........comment
........compiled
........version
....bootloader
........comment
........compiled
........version
....wlan
........at-version
........sdk-version

/json?cmd=wlan
....ap
........enable
........mac
........hidden
........ssid
........password
........channel
........encryption
........maxconn
........ip
........netmask
........gateway
........dhcp
............enable
............start
............end
....station
........enable
........mac
........signal
........ssid
........password
........dhcp
........ip
........netmask
........gateway

/json?cmd=name [&name=<newname>]

/json?cmd=start

/json?cmd=stop

/json?cmd=service&<reboot, shutdown, sleep>

/json?cmd=weather
....service
........enable
........location
............zip
............country
........config
............maxrain
............mintemp
............maxtemp
............minhumidity
............maxhumidity
....weather
........break
........rain
........temperature
........humidity
........icon <Icon-URL für OpenWeatherMap>
........condition
............toorainy
............toocold
............toowarm
............toodry
............toowet
........timestamp
............date
............time
............unix

/json?cmd=weather&service=[0 (Service aus), 1 (Service ein)] <Danke an Lampi!>


/json?cmd=wire Info: Aktuell wird syntaktisch falsches JSON zurückgegeben
....sensor <Vorn/links>
........description
........quality
........a
........n
........f
........g1
........g2
....sensor <vorn/rechts>
........description
........quality
........a
........n
........f
........g1
........g2
....sensor <hinten/rechts>
........description
........quality
........a
........n
........f
........g1
........g2
....sensor <hinten/links>
........description
........quality
........a
........n
........f
........g1
........g2

/json?cmd=gps

/json?door <Danke an LegoSpieler!>
....door
........enabled
........open
........arrested
........delay
...............total

/json?door&delay= [0 (Aus), -1 (An), 0-240 Zeit]
/json?door&release (geöffnetes Tor bestätigen)
/json?door&open=1 (Tor öffnen) <Danke an 9.st.h.2!>
/json?door&close=1 (Tor schließen)

/json?cmd=remote

PS: Leider 'frißt' das Forum führende Tabs und Leerzeichen, daher die '.'
Zuletzt geändert von LaborEtArs am So 27. Okt 2019, 06:34, insgesamt 18-mal geändert.

LegoSpieler
Beiträge: 53
Registriert: Do 18. Apr 2019, 14:20
Wohnort: Blaustein
Mäher: Gardena R50Li
Firmware des Mähers (MSW): MSW 5.xx.xx
Herstellungsjahr: 2015
Robonect-Modul: Robonect Hx (Rev.4)
Robonect Firmware: 1.0beta7

Re: Übersicht der API

Beitrag von LegoSpieler » Fr 14. Jun 2019, 07:58

Super, Vielen Dank!!

Füge noch bitte hinzu:

json?door


...door
......enabled
......open
......arrested
......delay
............total

json?door&delay= (0 aus, -1 AN, 0-240 Zeit)
json?door&release (geöffnetes Tor bestätigen)

Grüße LegoSpieler
HomeServer Logikbaustein viewtopic.php?f=23&t=2370

kobelka
Beiträge: 11
Registriert: Do 22. Jun 2017, 13:45
Wohnort: Hamburg
Mäher: Husqvarna Automower 315
Firmware des Mähers (MSW): MSW 7.xx.xx
Herstellungsjahr: 2016
Robonect-Modul: Robonect Hx (Rev.5)
Robonect Firmware: 1.0 Beta 7a
Kontaktdaten:

Re: Übersicht der API (Stand FW1.0 Beta7a)

Beitrag von kobelka » Do 22. Aug 2019, 07:14

Moin,
bei dem Timer Command

Code: Alles auswählen

/json?cmd=timer&timer=1&start=06:00&end=09:00&mo=1&tu=1&we=1&th=1&fr=1&sa=1&su=1&enable=1
muss auf jeden Fall noch ein save=1 dahinter, sonst werden die Timer nur im Robonect gespeichert aber nicht im Rasenrobi...
LG

demichve
Beiträge: 43
Registriert: So 8. Apr 2018, 13:38
Mäher: Gardena SILENO City 250
Firmware des Mähers (MSW): MSW 11.xx.xx
Herstellungsjahr: 2018
Robonect-Modul: Robonect Hx (Rev.5)
Robonect Firmware: 1.0a

Re: Übersicht der API (Stand FW1.0 Beta7a)

Beitrag von demichve » Mi 11. Sep 2019, 09:28

Fernstartpunkt verhält sich nicht so, wie hier beschrieben:
Wenn man "2" eingibt, dann startet er am Fernstartpunkt 1 !!!

Es hatte auch mal jemand folgendes gepostet, das kann ich bestätigen.

remotestart
0 : Standardeinstellung verwenden
1: Normal
2 : Mähauftrag bei Fernstart-Punkt 1 beginnen
3 : Mähauftrag bei Fernstart-Punkt 2 beginnen

Ich nutze die V1.0a

der_oBi
Beiträge: 2
Registriert: Do 15. Aug 2019, 09:11
Mäher: Gardena SILENO Life SMART
Firmware des Mähers (MSW): MSW 15.xx.xx
Herstellungsjahr: 2019
Robonect Firmware: -

Re: Übersicht der API (Stand FW1.0a)

Beitrag von der_oBi » Sa 28. Sep 2019, 17:01

demichve hat geschrieben:
Mi 11. Sep 2019, 09:28
Fernstartpunkt verhält sich nicht so, wie hier beschrieben:
Wenn man "2" eingibt, dann startet er am Fernstartpunkt 1 !!!

Es hatte auch mal jemand folgendes gepostet, das kann ich bestätigen.

remotestart
0 : Standardeinstellung verwenden
1: Normal
2 : Mähauftrag bei Fernstart-Punkt 1 beginnen
3 : Mähauftrag bei Fernstart-Punkt 2 beginnen

Ich nutze die V1.0a
Das ist richtig.
Die 0 bedeutet, er sucht aus, je nachdem wie die Häufigkeit der einzelnen (Fern)Startpunkte eingestellt wurde.
1: Start von der Ladestation
2: Fernstartpunkt 1
usw.

Mal eine andere Frage:
Gibt es auch einen API-Befehl zum Setzen/Abfragen/Zurücksetzen des Wettertimers (bei Gardena: "Sensor Control")?

Lampi
Beiträge: 150
Registriert: Di 14. Feb 2017, 17:07
Mäher: Husqvarna Automower 330X
Firmware des Mähers (MSW): MSW 7.xx.xx
Herstellungsjahr: 2014
Robonect-Modul: Robonect Hx (Rev.1)
Robonect Firmware: V1.1b

Re: Übersicht der API (Stand FW1.0a)

Beitrag von Lampi » So 29. Sep 2019, 11:13

Hallo der_oBi und willkommen im Forum.
der_oBi hat geschrieben:
Sa 28. Sep 2019, 17:01
Gibt es auch einen API-Befehl zum Setzen/Abfragen/Zurücksetzen des Wettertimers (bei Gardena: "Sensor Control")?

Mit der Abfrage cmd=report bekommt man unter anderem Infos zum Wettertimer.
Unter weatherTimerArmed kommt eine 1 wenn aktiviert und vermutlich eine 0 wenn deaktiviert, habe ich aber nicht ausprobiert da der Wettertimer bei mir immer aktiviert ist und es mich bisher noch nicht weiter interessiert hat.

Unter preventMowing ist es nicht ganz so eindeutig. Wenn der Wettertimer wirksam ist bekomme ich entweder eine 1 oder 5. Ich vermute mal, dass es der Dezimalwert einer Bitleiste ist, dann wäre bei 1 nur Bit 0 gesetzt und bei 5 zusätzlich noch Bit 2. Welche Funktion hinter Bit 2 steht weiß ich allerdings nicht.

Ob es auch die Möglichkeit des Setzens oder Rücksetzen gibt kann ich dir leider nicht sagen.

Ich hoffe mal das dir die wenigen Infos etwas weiterhelfen können. Vielleicht weiß aber jemand anderes mehr darüber.

Gruß
Lampi

9.st.h.2
Beiträge: 18
Registriert: Do 18. Mai 2017, 10:43
Wohnort: München
Mäher: Gardena R38Li
Firmware des Mähers (MSW): MSW 5.xx.xx
Herstellungsjahr: 2015
Robonect-Modul: Robonect Hx (Rev.4)
Robonect Firmware: 1.0 Beta 2

Re: Übersicht der API (Stand FW1.0a)

Beitrag von 9.st.h.2 » Fr 18. Okt 2019, 10:15

Danke für diese Liste, die habe ich seit langem gesucht :-)

Was bei mir allerdings noch nicht ganz klappt ist das manuelle öffnen und schließen des Tores....

Damit hab ich es unter anderem versucht, komme aber nicht ganz ans Ziel:

http://192.168.178.60/json?user=XXX&pass=XXX&door&open

Wie sieht da der genaue Befehl für öffnen und schließen aus?

LaborEtArs
Beiträge: 6
Registriert: Sa 25. Mai 2019, 14:17
Mäher: Husqvarna Automower 420
Herstellungsjahr: 2017 (Modell 2018)
Robonect-Modul: Robonect Hx (Rev.5)
Robonect Firmware: V1.0 Beta 7a

Re: Übersicht der API (Stand FW1.0a)

Beitrag von LaborEtArs » Sa 19. Okt 2019, 10:00

Hallo 9.st.h.2, habe leider selbst kein Tor, daher ist dieser Antwortversuch eher theoretisch...
Ich vermute, dass hinter dem 'open' ein Parameter kommt; vmtl. '0' für 'zu' und '1' für 'offen.
Vollständig also: http://...../json=door&open=1

9.st.h.2
Beiträge: 18
Registriert: Do 18. Mai 2017, 10:43
Wohnort: München
Mäher: Gardena R38Li
Firmware des Mähers (MSW): MSW 5.xx.xx
Herstellungsjahr: 2015
Robonect-Modul: Robonect Hx (Rev.4)
Robonect Firmware: 1.0 Beta 2

Re: Übersicht der API (Stand FW1.0a)

Beitrag von 9.st.h.2 » Mi 23. Okt 2019, 02:41

ich habe es hinbekommen....

http://192.168.178.60/json?user=XXX&pas ... oor&open=1
http://192.168.178.60/json?user=XXX&pas ... or&close=1

ich hab soviele sachen getestet, ein kleiner Anstoß deiner Seits hat mir den richtigen Tipp gegeben, danke :-)

Automower_KI
Beiträge: 10
Registriert: Mi 28. Sep 2016, 20:31
Mäher: Husqvarna Automower 420
Firmware des Mähers (MSW): MSW 6.xx.xx
Herstellungsjahr: 2016
Robonect-Modul: Robonect Hx (Rev.3)
Robonect Firmware: Release V1.0 Beta2

Re: Übersicht der API (Stand FW1.0a)

Beitrag von Automower_KI » Sa 26. Okt 2019, 20:07

Hallo,

gibt es einen Befehl, um den Wetterdienst (OpenWeatherMap) auszuschalten und wieder einzuschalten? Hintergrund: Ich möchte den Mäher manuell mähen lassen können, wenn der Wetterdienst dies unterbindet, funktioniert das manuelle Mähen nicht.
Alternativ: Gibt es einen Befehl fürs manuelle Mähnen, ohne dass der Wetterdienst aktiv ist?

mfg.
Husqvarna Automower 420 (2016)

Antworten

Zurück zu „API für Robonect® Hx“