Added TagoTiP

.gitignore

@@ -28,6 +28,10 @@ dist/
 .env.test.local
 .env.production.local
 
+# Generated from tago-io/tagotip GitHub repo (scripts/sync-tagotip.mjs)
+docs/tagotip/specification.md
+docs/tagotip/tagotips-specification.md
+
 npm-debug.log*
 yarn-debug.log*
 yarn-error.log*

docs/tagotip/http/_category_.json

@@ -0,0 +1,4 @@
+{
+  "label": "TagoTiP HTTP",
+  "position": 7
+}

docs/tagotip/http/overview.md

@@ -0,0 +1,41 @@
+---
+sidebar_position: 1
+title: Overview
+---
+
+# TagoTiP HTTP
+
+:::info Work in Progress
+This documentation is currently being developed. Check back soon for updates.
+:::
+
+## Overview
+
+TagoTiP HTTP uses standard HTTP request/response communication for integrating with TagoIO. HTTP is the most widely supported protocol and is ideal for simple integrations and environments where HTTP infrastructure is already in place.
+
+## When to Use HTTP
+
+- Simple device-to-cloud data submissions
+- Environments with existing HTTP infrastructure
+- Integrations from web applications or servers
+- Scenarios where request/response confirmation is needed
+
+## Quick Start
+
+_Coming soon._
+
+## Configuration
+
+_Coming soon._
+
+## Endpoints
+
+_Coming soon._
+
+## Authentication
+
+_Coming soon._
+
+## Examples
+
+_Coming soon._

docs/tagotip/mqtt/_category_.json

@@ -0,0 +1,4 @@
+{
+  "label": "TagoTiP MQTT",
+  "position": 6
+}

docs/tagotip/mqtt/overview.md

@@ -0,0 +1,41 @@
+---
+sidebar_position: 1
+title: Overview
+---
+
+# TagoTiP MQTT
+
+:::info Work in Progress
+This documentation is currently being developed. Check back soon for updates.
+:::
+
+## Overview
+
+TagoTiP MQTT leverages the MQTT publish/subscribe messaging protocol for IoT-optimized communication with TagoIO. MQTT is designed for constrained devices and unreliable networks, making it one of the most popular choices for IoT applications.
+
+## When to Use MQTT
+
+- Devices with intermittent connectivity
+- Publish/subscribe messaging patterns
+- Scenarios requiring Quality of Service (QoS) levels
+- Low-bandwidth, high-latency networks
+
+## Quick Start
+
+_Coming soon._
+
+## Configuration
+
+_Coming soon._
+
+## Topics
+
+_Coming soon._
+
+## QoS Levels
+
+_Coming soon._
+
+## Examples
+
+_Coming soon._

docs/tagotip/tcp/_category_.json

@@ -0,0 +1,4 @@
+{
+  "label": "TagoTiP TCP",
+  "position": 5
+}

docs/tagotip/tcp/overview.md

@@ -0,0 +1,37 @@
+---
+sidebar_position: 1
+title: Overview
+---
+
+# TagoTiP TCP
+
+:::info Work in Progress
+This documentation is currently being developed. Check back soon for updates.
+:::
+
+## Overview
+
+TagoTiP TCP provides a reliable, connection-oriented transport for communicating with TagoIO. TCP ensures guaranteed delivery and ordering of data, making it suitable for critical data transmissions.
+
+## When to Use TCP
+
+- Data that must be reliably delivered without loss
+- Bidirectional communication between device and platform
+- Scenarios requiring acknowledgment of data receipt
+- Devices with stable network connections
+
+## Quick Start
+
+_Coming soon._
+
+## Configuration
+
+_Coming soon._
+
+## Data Format
+
+_Coming soon._
+
+## Examples
+
+_Coming soon._

docs/tagotip/udp/_category_.json

@@ -0,0 +1,4 @@
+{
+  "label": "TagoTiP UDP",
+  "position": 4
+}

docs/tagotip/udp/overview.md

@@ -0,0 +1,37 @@
+---
+sidebar_position: 1
+title: Overview
+---
+
+# TagoTiP UDP
+
+:::info Work in Progress
+This documentation is currently being developed. Check back soon for updates.
+:::
+
+## Overview
+
+TagoTiP UDP provides a lightweight, connectionless transport for sending data to TagoIO. UDP is ideal for scenarios where low latency and minimal overhead are more important than guaranteed delivery.
+
+## When to Use UDP
+
+- High-frequency sensor data where occasional packet loss is acceptable
+- Battery-powered devices that need to minimize power consumption
+- Fire-and-forget telemetry data
+- Scenarios where network bandwidth is limited
+
+## Quick Start
+
+_Coming soon._
+
+## Configuration
+
+_Coming soon._
+
+## Data Format
+
+_Coming soon._
+
+## Examples
+
+_Coming soon._

docs/tagotip/welcome.md

@@ -0,0 +1,120 @@
+---
+sidebar_position: 1
+title: Welcome
+slug: /tagotip/
+---
+
+# TagoTiP — Transport IoT Protocol
+
+Send IoT data to TagoIO in **130 bytes** instead of 487. No JSON, no HTTP headers — just a single human-readable line your microcontroller can build with `sprintf`.
+
+```
+PUSH|ate2bd...c0d0|sensor-01|[temperature:=32.5#C;humidity:=65#%]
+```
+
+## Why TagoTiP?
+
+| | HTTP/JSON | TagoTiP | TagoTiP/S (encrypted) |
+|---|---|---|---|
+| **Payload size** | ~487 bytes | ~130 bytes | ~115 bytes |
+| **vs. HTTP/JSON** | — | 3.7× smaller | 4.2× smaller |
+| **TLS required?** | Yes | Recommended | No — AEAD encryption built-in |
+| **Parse complexity** | JSON parser | Linear scan, no backtracking | Envelope + linear scan |
+
+### Built for constrained devices
+
+- **Human-readable** — debug frames in a terminal, compose them by hand
+- **Type-safe** — explicit operators for numbers (`:=`), strings (`=`), booleans (`?=`), and locations (`@=`)
+- **C-friendly** — predictable buffer sizes, no dynamic allocation, linear parsing
+- **Compact** — variable, value, unit, timestamp, group, location, and metadata in a single frame
+- **Transport-agnostic** — works over UDP, TCP, HTTP(S), MQTT, or any byte-capable channel
+
+### Runs over anything
+
+TagoTiP is transport-agnostic. Pick the transport that fits your hardware and network:
+
+| Transport | Best For | Guide |
+|-----------|----------|-------|
+| **[UDP](/docs/tagotip/udp/overview)** | High-frequency telemetry, fire-and-forget | Lowest overhead, no connection setup |
+| **[TCP](/docs/tagotip/tcp/overview)** | Reliable delivery, bidirectional commands | Persistent connections, server-pushed CMDs |
+| **[MQTT](/docs/tagotip/mqtt/overview)** | Pub/sub patterns, intermittent connectivity | Native topic-based routing |
+| **[HTTP](/docs/tagotip/http/overview)** | Simple integrations, request/response | Works through firewalls and proxies |
+
+### Encryption without TLS
+
+Need security on LoRa, Sigfox, NB-IoT, or raw UDP where TLS is too expensive? **TagoTiP/S** wraps frames in an AEAD authenticated encryption envelope — as little as **25 bytes** of overhead, with built-in replay protection and integrity verification.
+
+Choose the cipher suite that fits your security and resource constraints:
+
+| Cipher Suite | Key | Tag | Envelope Overhead |
+|---|---|---|---|
+| **AES-128-CCM** | 128-bit | 8 B | 25 bytes |
+| AES-128-GCM | 128-bit | 16 B | 33 bytes |
+| AES-256-CCM | 256-bit | 8 B | 25 bytes |
+| AES-256-GCM | 256-bit | 16 B | 33 bytes |
+| ChaCha20-Poly1305 | 256-bit | 16 B | 33 bytes |
+
+Read the full [TagoTiP/S Specification](/docs/tagotip/tagotips-specification).
+
+## How it compares
+
+### TagoTiP vs. other IoT data formats
+
+| | TagoTiP | HTTP + JSON | MQTT + JSON | Protobuf |
+|---|---|---|---|---|
+| **Typical payload** | ~130 bytes | ~487 bytes | ~210 bytes | ~80 bytes |
+| **Human-readable** | Yes | Partially | Partially | No |
+| **Schema required** | No | No | No | Yes |
+| **Debug in a terminal** | Yes | Verbose | Binary framing | No |
+| **Build with `sprintf`** | Yes | Complex | Needs MQTT library | Needs code generator |
+| **IoT type system** | Built-in (number, string, bool, location) | Application-defined | Application-defined | Schema-defined |
+| **Metadata, unit, group, timestamp** | Native syntax | Application-defined | Application-defined | Schema-defined |
+
+### TagoTiP/S vs. other IoT security
+
+| | TagoTiP/S | TLS 1.3 | DTLS 1.2 |
+|---|---|---|---|
+| **Handshake** | None — 0 bytes | ~2–4 KB | ~2–5 KB |
+| **Round trips before first data** | 0 | 1–2 | 2–3 |
+| **Per-message overhead** | 25–33 bytes | ~29 bytes + TCP | ~29 bytes |
+| **Session state** | Stateless | Per-connection | Per-connection |
+| **Certificate management** | None | Required | Required or PSK |
+| **Works over LoRa / Sigfox / NB-IoT** | Yes | No | No |
+| **Works without TCP** | Yes | No | UDP only |
+
+## Quick example
+
+Push a temperature reading with unit, timestamp, and metadata — all in one frame:
+
+```
+PUSH|ate2bd319014b24e0a8aca9f00aea4c0d0|sensor-01|^batch_42@1694567890000{firmware=2.1}[temperature:=32.5#C;position@=39.74,-104.99]
+```
+
+Pull the last value back:
+
+```
+PULL|ate2bd319014b24e0a8aca9f00aea4c0d0|sensor-01|[temperature]
+← ACK|OK|[temperature:=32.5#C@1694567890000]
+```
+
+## SDKs
+
+All language SDKs share a single Rust core (`tagotip-codec`, `no_std`), so parsing and frame building behave identically everywhere.
+
+| Package | Language | Install |
+|---------|----------|---------|
+| [`@tagoio/tagotip`](https://github.com/tago-io/tagotip-sdk/tree/main/tagotip-node) | TypeScript / Node.js | `npm install @tagoio/tagotip` |
+| [`tagotip`](https://github.com/tago-io/tagotip-sdk/tree/main/tagotip-go) | Go | `go get github.com/tago-io/tagotip-sdk/tagotip-go` |
+| [`tagotip`](https://github.com/tago-io/tagotip-sdk/tree/main/tagotip-python) | Python | `pip install tagotip` |
+| [`TagoTiP`](https://github.com/tago-io/tagotip-sdk/tree/main/tagotip-arduino) | C / Arduino | Arduino Library Manager |
+| [`tagotip-codec`](https://github.com/tago-io/tagotip-sdk/tree/main/tagotip-codec) | Rust | `cargo add tagotip-codec` |
+
+Browse the full SDK source at [github.com/tago-io/tagotip-sdk](https://github.com/tago-io/tagotip-sdk).
+
+## Specification
+
+For the complete protocol grammar, parsing rules, and ABNF, see the [TagoTiP Specification](/docs/tagotip/specification).
+
+## Open source
+
+TagoTiP is open source under the [Apache License 2.0](https://github.com/tago-io/tagotip). Implement clients, servers, libraries, or gateways — for any purpose, including commercial use.

docusaurus.config.ts

@@ -186,6 +186,12 @@ const config: Config = {
           position: "left",
           label: "TagoCore",
         },
+        {
+          type: "docSidebar",
+          sidebarId: "tagotipSidebar",
+          position: "left",
+          label: "TagoTiP",
+        },
         {
           type: "docSidebar",
           sidebarId: "apiSidebar",

package.json

@@ -4,7 +4,10 @@
   "private": true,
   "scripts": {
     "docusaurus": "docusaurus",
+    "sync:tagotip": "node scripts/sync-tagotip.mjs",
+    "prestart": "npm run sync:tagotip",
     "start": "docusaurus start -h 0.0.0.0",
+    "prebuild": "npm run sync:tagotip",
     "build": "rm -rf build && docusaurus build",
     "swizzle": "docusaurus swizzle",
     "deploy": "docusaurus deploy",