diff --git a/docs/tagotip/introduction.md b/docs/tagotip/introduction.md index 7c32b56d..7a1e5a54 100644 --- a/docs/tagotip/introduction.md +++ b/docs/tagotip/introduction.md @@ -77,7 +77,7 @@ Learn more in the [Encryption](./specification/encryption) guide. Push a temperature reading with unit, timestamp, and metadata - all in one frame: ``` -PUSH|4deedd7bab8817ec|sensor-01|@1694567890000^batch_42{firmware=2.1}[temperature:=32.5#C;position@=39.74,-104.99] +PUSH|4deedd7bab8817ec|sensor-01|@=39.74,-104.99@1694567890000^batch_42{firmware=2.1}[temperature:=32.5#C] ``` Pull the last value back: diff --git a/docs/tagotip/transports/http.md b/docs/tagotip/transports/http.md index b06da1eb..ecfef501 100644 --- a/docs/tagotip/transports/http.md +++ b/docs/tagotip/transports/http.md @@ -122,7 +122,7 @@ curl -X POST https://http.tip.us-e1.tago.io/v1/tip/sensor-01 \ curl -X POST https://http.tip.us-e1.tago.io/v1/tip/sensor-01 \ -H "Authorization: TagoTiP 4deedd7bab8817ec" \ -H "Content-Type: text/plain" \ - -d '@1694567890000^batch_01{firmware=2.1}[temperature:=25.5#C;humidity:=60#%]' + -d '@=39.74,-104.99@1694567890000^batch_01{firmware=2.1}[temperature:=25.5#C;humidity:=60#%]' ``` ### Push location data @@ -131,7 +131,7 @@ curl -X POST https://http.tip.us-e1.tago.io/v1/tip/sensor-01 \ curl -X POST https://http.tip.us-e1.tago.io/v1/tip/tracker-01 \ -H "Authorization: TagoTiP 4deedd7bab8817ec" \ -H "Content-Type: text/plain" \ - -d '[position@=39.74,-104.99,1609;speed:=45.2#km/h]' + -d '[position@=39.74,-104.99,1609;speed:=45.2#km/h@=39.74,-104.99]' ``` ### Push raw payload (passthrough) diff --git a/docs/tagotip/transports/mqtt.md b/docs/tagotip/transports/mqtt.md index dc2d4b2d..fb08bf2f 100644 --- a/docs/tagotip/transports/mqtt.md +++ b/docs/tagotip/transports/mqtt.md @@ -85,7 +85,7 @@ Structured variables or passthrough: ``` [temp:=32#C;humidity:=65#%] -@1694567890000^batch_42[temp:=32#C] +@=39.74,-104.99@1694567890000^batch_42[temp:=32#C] >xDEADBEEF01020304 >b3q2+7wECAwQ= !42|[temp:=32#C;humidity:=65#%] @@ -258,11 +258,12 @@ Append after the value, in this order: | Suffix | Prefix | Example | | --------- | ------ | --------------------------------- | | Unit | `#` | `temperature:=25.5#C` | +| Location | `@=` | `speed:=10@=39.74,-104.99` | | Timestamp | `@` | `temperature:=25.5@1694567890000` | | Group | `^` | `temperature:=25.5^batch_01` | | Metadata | `{}` | `temperature:=25.5{source=dht22}` | -All combined: `temperature:=25.5#C@1694567890000^batch_01{source=dht22,quality=high}` +All combined: `temperature:=25.5#C@=39.74,-104.99@1694567890000^batch_01{source=dht22,quality=high}` ## Response codes diff --git a/docs/tagotip/transports/tcp.md b/docs/tagotip/transports/tcp.md index 8376f8ef..81fda92a 100644 --- a/docs/tagotip/transports/tcp.md +++ b/docs/tagotip/transports/tcp.md @@ -204,11 +204,12 @@ Append after the value, in this order: | Suffix | Prefix | Example | | --------- | ------ | --------------------------------- | | Unit | `#` | `temperature:=25.5#C` | +| Location | `@=` | `speed:=10@=39.74,-104.99` | | Timestamp | `@` | `temperature:=25.5@1694567890000` | | Group | `^` | `temperature:=25.5^batch_01` | | Metadata | `{}` | `temperature:=25.5{source=dht22}` | -All combined: `temperature:=25.5#C@1694567890000^batch_01{source=dht22,quality=high}` +All combined: `temperature:=25.5#C@=39.74,-104.99@1694567890000^batch_01{source=dht22,quality=high}` ## Response codes diff --git a/docs/tagotip/transports/udp.md b/docs/tagotip/transports/udp.md index 9a795173..733de7db 100644 --- a/docs/tagotip/transports/udp.md +++ b/docs/tagotip/transports/udp.md @@ -112,7 +112,7 @@ ACK|OK|3 ### Push location data ```bash -echo -n 'PUSH|4deedd7bab8817ec|tracker-01|[position@=39.74,-104.99,1609;speed:=45.2#km/h]' \ +echo -n 'PUSH|4deedd7bab8817ec|tracker-01|[position@=39.74,-104.99,1609;speed:=45.2#km/h@=39.74,-104.99]' \ | nc -u -w1 udp.tip.us-e1.tago.io 5683 ``` @@ -169,11 +169,12 @@ Append after the value, in this order: | Suffix | Prefix | Example | | --------- | ------ | --------------------------------- | | Unit | `#` | `temperature:=25.5#C` | +| Location | `@=` | `speed:=10@=39.74,-104.99` | | Timestamp | `@` | `temperature:=25.5@1694567890000` | | Group | `^` | `temperature:=25.5^batch_01` | | Metadata | `{}` | `temperature:=25.5{source=dht22}` | -All combined: `temperature:=25.5#C@1694567890000^batch_01{source=dht22,quality=high}` +All combined: `temperature:=25.5#C@=39.74,-104.99@1694567890000^batch_01{source=dht22,quality=high}` ## Response codes