Ü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.
Antworten
LaborEtArs
Beiträge: 4
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?'

/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=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?cmd=remote

PS: Leider 'frißt' das Forum führende Tabs und Leerzeichen, daher die '.'
Zuletzt geändert von LaborEtArs am Fr 13. Sep 2019, 15:55, insgesamt 16-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: 146
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.0a

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

Antworten

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