Metainformationen zur Seite
Unterschiede
Hier werden die Unterschiede zwischen zwei Versionen angezeigt.
Beide Seiten der vorigen RevisionVorhergehende ÜberarbeitungNächste Überarbeitung | Vorhergehende Überarbeitung | ||
plugins:owntracks:start [2022/09/16 15:29] – Michael Schlenstedt | plugins:owntracks:start [2024/03/20 17:26] (aktuell) – Struct-Daten geändert Michael Schlenstedt | ||
---|---|---|---|
Zeile 1: | Zeile 1: | ||
- | ====== Owntracks | + | ====== Owntracks ====== |
===== Basic Info Owntracks ===== | ===== Basic Info Owntracks ===== | ||
- | OwnTracks is an Open Source project which provides an iOS and an Android app with which your smartphone records its current location. Whether you want your young child to know where you currently are, or you want to keep track of where you spent your last vacation, or you and a group of friends want to see each other on a map, OwnTracks does that. It consists of an app which runs on your smart phone, and which periodically, | + | OwnTracks is an Open Source project which provides an iOS and an Android app with which your smartphone records its current location. Whether you want your young child to know where you currently are, or you want to keep track of where you spent your last vacation, or you and a group of friends want to see each other on a map, OwnTracks does that. It consists of an app which runs on your smart phone, and which periodically, |
Download the Apps: | Download the Apps: | ||
Zeile 16: | Zeile 16: | ||
There is a Booklet covering tons of details how to set-up the App, your loacations and how owntracks works. Personally i can't support how to use/set-up the App in your environment. | There is a Booklet covering tons of details how to set-up the App, your loacations and how owntracks works. Personally i can't support how to use/set-up the App in your environment. | ||
- | * Owntracks documentation: | + | * Owntracks documentation: |
===== Requirements ===== | ===== Requirements ===== | ||
- | - DnyDNS or static or local IP-Address (DynDNS recommended for security reasons) available This may change in the future to use TLS. | + | - DnyDNS or static or local IP-Address (DynDNS recommended for security reasons) available This may change in the future to use to TLS. |
- configure Portwording rule for TCP-Port 1883 to xxxx(x) in your Router | - configure Portwording rule for TCP-Port 1883 to xxxx(x) in your Router | ||
- installed MQTT Plugin | - installed MQTT Plugin | ||
Zeile 29: | Zeile 29: | ||
open Plugin post installation and you have all Info required. In addition there is a tab to get the command recognition to be used for Loxone, as well as a direct link to MQTT. In case you have **weather4lox** Plugin installed your location data will be parsed in, if not a **google map** tab appears to identify your location data. | open Plugin post installation and you have all Info required. In addition there is a tab to get the command recognition to be used for Loxone, as well as a direct link to MQTT. In case you have **weather4lox** Plugin installed your location data will be parsed in, if not a **google map** tab appears to identify your location data. | ||
- | {{plugins: | + | {{plugins: |
After saving your config create a user specific App configuration file and pass it to corresponding User. Once User has completed the set-up on his Smartphone you should see incoming traffic either in Plugin Monitor or in MQTT Plugin | After saving your config create a user specific App configuration file and pass it to corresponding User. Once User has completed the set-up on his Smartphone you should see incoming traffic either in Plugin Monitor or in MQTT Plugin | ||
Zeile 37: | Zeile 37: | ||
for setting up Owntracks you need to have a LoxBerry with appropriate Plugin installed. How to do that and do how-to do the basic configuration please visit the support Wiki page here: | for setting up Owntracks you need to have a LoxBerry with appropriate Plugin installed. How to do that and do how-to do the basic configuration please visit the support Wiki page here: | ||
- | I will focus on adding | + | The Plugin installation contains automatically |
- | + | ||
- | Please select the type of data transmission to Miniserver. You can use either HTTP or UDP, How it looks like then in MS you can find under (link to MS) | + | |
- | + | ||
- | {{plugins: | + | |
- | + | ||
- | next step is switch | + | |
- | + | ||
- | {{plugins: | + | |
- | + | ||
- | The Owntrack specific settings Topic and necessary conversions will be added from the Owntracks Plugin | + | |
===== Setup Owntracks in iOS ===== | ===== Setup Owntracks in iOS ===== | ||
Zeile 61: | Zeile 51: | ||
- test data transfer by clicking on **Publish waypoints**\\ | - test data transfer by clicking on **Publish waypoints**\\ | ||
- | {{plugins: | + | {{plugins: |
Now you should open Owntracks Plugin and check either in " | Now you should open Owntracks Plugin and check either in " | ||
Zeile 87: | Zeile 77: | ||
if you have selected " | if you have selected " | ||
- | {{plugins: | + | {{plugins: |
adding virtual UDP input command and the comand recognition: | adding virtual UDP input command and the comand recognition: | ||
- | {{plugins: | + | {{plugins: |
the basic command recogniation is always " | the basic command recogniation is always " | ||
Zeile 97: | Zeile 87: | ||
===== Differences between iOS/Android ===== | ===== Differences between iOS/Android ===== | ||
- | Depending on used Hardware and Interface there are differences in the data layout/set which been send to Loxone. Those can be found here https:// | + | Depending on used Hardware and Interface there are differences in the data layout/set which been send to Loxone. Those can be found here [[https:// |
==== Data Types ==== | ==== Data Types ==== | ||
Zeile 103: | Zeile 93: | ||
OwnTracks publishes its message payloads in [[http:// | OwnTracks publishes its message payloads in [[http:// | ||
- | ^'' | + | ^ '' |
- | |'' | + | | '' |
- | |'' | + | | '' |
- | |'' | + | | '' |
- | |'' | + | | '' |
- | |'' | + | | '' |
- | |'' | + | | '' |
- | |'' | + | | '' |
- | |'' | + | | '' |
- | |'' | + | | '' |
- | |'' | + | | '' |
- | |'' | + | | '' |
==== Data ==== | ==== Data ==== | ||
Zeile 120: | Zeile 110: | ||
following data could be used for entry/leave events: | following data could be used for entry/leave events: | ||
- | ^command^description | + | ^ command ^ description |
- | |cog |Course over ground | + | | cog | Course over ground |
- | |batt | + | | batt | Device battery level | |
- | |lon |longitude | + | | lon | longitude |
- | |acc |Accuracy of the reported location in meters without unit | |meters |**X**|**X** | + | | acc | Accuracy of the reported location in meters without unit | |
- | |p |barometric pressure | + | | p | barometric pressure |
- | |vel |velocity | + | | vel | velocity |
- | |vac |vertical accuracy of the alt element | + | | vac | vertical accuracy of the alt element |
- | |lat |latitude | + | | lat | latitude |
- | |t |**p** ping issued randomly by background task | + | | t | **p** ping issued randomly by background task | Yes | |
- | | | + | | |
- | | | + | | |
- | | | + | | |
- | | | + | | |
- | | | + | | |
- | | | + | | |
- | |conn | + | | conn | Internet connectivity status (route to host) when the message is created |
- | | | + | | |
- | | | + | | |
- | | | + | | |
- | |tst |UNIX epoch timestamp in seconds of the location fix | + | | tst | UNIX epoch timestamp in seconds of the location fix | |
- | |alt |Altitude measured above sea level | + | | alt | Altitude measured above sea level | |
- | |tid |Tracker ID used to display the initials of a user | + | | tid | Tracker ID used to display the initials of a user | |
- | |enter | + | | enter | enter/leave region |
===== Tracking/ | ===== Tracking/ | ||
Zeile 149: | Zeile 139: | ||
introducing from v0.3.0 onwards the Plugin contains a real Tracking/ | introducing from v0.3.0 onwards the Plugin contains a real Tracking/ | ||
- | {{plugins: | + | {{plugins: |
- | {{plugins: | + | {{plugins: |
- | {{plugins: | + | {{plugins: |
===== Roadmap ===== | ===== Roadmap ===== | ||
Zeile 161: | Zeile 151: | ||
===== FAQ ===== | ===== FAQ ===== | ||
- | https:// | + | [[https:// |
---- struct data ---- | ---- struct data ---- | ||
Zeile 167: | Zeile 158: | ||
pluginuebersicht.logo : : | pluginuebersicht.logo : : | ||
pluginuebersicht.status : STABLE | pluginuebersicht.status : STABLE | ||
- | pluginuebersicht.version : 1.0.1 | + | pluginuebersicht.version : 1.0.3 |
- | pluginuebersicht.min_lb_version : 1.0 | + | pluginuebersicht.min_lb_version : 3.0 |
- | pluginuebersicht.url_release : https:// | + | pluginuebersicht.url_release : https:// |
pluginuebersicht.url_prerelease : | pluginuebersicht.url_prerelease : | ||
pluginuebersicht.description : Owntracks Geo Location for LoxBerry supporting Smartphone Apps for iOS as well as Android. Prerequisite is the MQTT Plugin to pass data to Loxone Miniserver | pluginuebersicht.description : Owntracks Geo Location for LoxBerry supporting Smartphone Apps for iOS as well as Android. Prerequisite is the MQTT Plugin to pass data to Loxone Miniserver |