Übersicht der API (Stand FW1.0 Beta7a)

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.0 Beta7a)

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>

/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

/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 Mo 17. Jun 2019, 16:36, insgesamt 13-mal geändert.

LegoSpieler
Beiträge: 42
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

Antworten

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