Ü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.
Gesperrt
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 »

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: 75
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.2RC0

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

Beitrag von LegoSpieler »

cmd=status liefert bei Error auch folgende Daten:

....error
........error_code
........error_message
........date
........time
........unix

"error": {"error_code": 10, "error_message": "Maehi ist umgedreht", "date": "2020-05-03", "time": "11:06:19", "unix": 1588503979}
HomeServer Logikbaustein viewtopic.php?f=23&t=2370

LegoSpieler
Beiträge: 75
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.2RC0

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

Beitrag von LegoSpieler »

cmd=push

akzeptiert:
&mode=get oder mode=post (deaktivieren hab ich noch nicht rausgefunden)
name="LegoSpieler" (name="" deaktiviert Benutzerdaten)
pass="12345678"
HomeServer Logikbaustein viewtopic.php?f=23&t=2370

Gesperrt

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