Seite 1 von 1

Übersicht der API (Stand FW1.0a)

Verfasst: Do 13. Jun 2019, 12:58
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 '.'

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

Verfasst: So 3. Mai 2020, 11:12
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}

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

Verfasst: So 3. Mai 2020, 11:15
von LegoSpieler
cmd=push

akzeptiert:
&mode=get oder mode=post (deaktivieren hab ich noch nicht rausgefunden)
name="LegoSpieler" (name="" deaktiviert Benutzerdaten)
pass="12345678"