# TagoTiP | Protocolo Leve de Telemetria IoT | TagoIO

> TagoTiP é um protocolo de telemetria IoT leve e legível para UDP, TCP, HTTP e MQTT. 4.3x menor que HTTP/JSON. Gratuito e open-source.

Uma Nuvem. Todos os Transportes para IoT.

TagoTiP é um protocolo de telemetria IoT leve, legível por humanos e endpoint para **UDP**, **TCP**, **HTTP** e **MQTT**.

## Feito para dispositivos limitados e redes reais

Tudo que você precisa para enviar dados de telemetria com confiança. Menos overhead, mais clareza.

### Payloads Menores

Formato compacto delimitado por barra vertical usa uma fração da banda de HTTP/JSON. 112 bytes vs 487 bytes para os mesmos dados. Crítico para LTE-M, NB-IoT, LoRa e links via satélite.

### Legível por Humanos

Leia, escreva e faça debug de frames direto no terminal ou monitor serial. Sem parsers binários, sem ferramentas externas. Se você consegue ler uma string delimitada por barra vertical, consegue debugar o TagoTiP.

### Agnóstico de Transporte

O mesmo formato de frame funciona via UDP, TCP, MQTT e HTTP. Troque de transporte sem alterar o firmware do dispositivo ou o pipeline de dados.

### Tipagem Segura por Design

Operadores de atribuição explícitos definem números, strings, booleanos e coordenadas GPS inline. Sem casting ambíguo de JSON. O tipo é declarado na origem.

## Menos bytes. Mais sinal.

Veja como o TagoTiP se compara com uma requisição HTTP/JSON padrão para leituras de sensores IoT.

### HTTP / JSON (487 bytes)

```
POST /data HTTP/1.1
Host: api.tago.io
Content-Type: application/json
Authorization: ate2bd31...c0d0
[{
  "variable": "temperature",
  "value": 32.5,
  "unit": "C"
}, {
  "variable": "humidity",
  "value": 65,
  "unit": "%"
}]
```

### TagoTiP (112 bytes)

```
PUSH|4deedd7bab8817ec|sensor-01|
[temperature:=32.5#C;humidity:=65#%]
```

## Um protocolo. Toda rede.

O formato de frame do TagoTiP é agnóstico de transporte. Envie por qualquer protocolo que seu hardware ou rede suporte.

### UDP

Telemetria fire-and-forget. Overhead mínimo para hardware com bateria e recursos limitados.

### TCP

Entrega ordenada e garantida para ambientes onde integridade de dados é crítica.

### MQTT

Coloque frames TagoTiP no seu broker existente e pipeline TagoIO sem nenhuma alteração.

### HTTP

Zero mudanças na infra. Troque o formato do payload, mantenha seu stack REST.

## Sem ambiguidade. Sem schema externo.

Fácil de usar. Operadores de tipo fazem parte do próprio frame.

### `:=` Numbers & Units

Integer or decimal. Attach any unit with #.

`# variable := value #unit`

- `temperature:=32.5#C`
- `pressure:=1013.25#hPa`
- `battery:=3.7#V`

### `=` Strings

Any text value. Status labels, version strings, named locations.

`# variable = "text value"`

- `status="running"`
- `firmware="v2.3.1"`
- `location_name="warehouse-A"`

### `?=` Booleans

Exact lowercase true or false. No other values accepted.

`# variable ?= true | false`

- `door_open?=true`
- `alarm_active?=false`
- `connected?=true`

### `@=` GPS Coordinates

lat, lng, or lat, lng, alt. Altitude always in meters.

`# variable @= lat,lng[,alt]`

- `location@=-35.28,149.12,600`
- `# combined with number in one frame`
- `[location@=-35.28,149.12;speed:=72#kmh]`

```
PUSH|4deedd7bab8817ec|sensor-01|[temperature:=32.5#C;status="online";alarm?=false;pos@=-35.28,149.12,600]
```

## Perguntas Frequentes

### O que é o TagoTiP?

O TagoTiP é um protocolo de telemetria IoT leve e legível por humanos, criado pela TagoIO. Ele usa frames compactos delimitados por barra vertical que funcionam sobre UDP, TCP, MQTT e HTTP, para que os dispositivos enviem dados com menos banda do que HTTP/JSON.

### Quais transportes o TagoTiP suporta?

O mesmo formato de frame funciona sobre UDP, TCP, MQTT e HTTP. Você pode trocar de transporte sem alterar o firmware do dispositivo nem o seu pipeline de dados.

### Quanto menor o TagoTiP é em relação ao HTTP/JSON?

Para a mesma leitura de sensor, um frame TagoTiP tem cerca de 112 bytes contra 487 bytes do HTTP/JSON, aproximadamente 4,3 vezes menor. Isso faz diferença em links LTE-M, NB-IoT, LoRa e satélite.

### O TagoTiP é gratuito e aberto?

Sim. O TagoTiP é gratuito e aberto, disponível agora na TagoIO sem necessidade de SDK. Você monta o frame e envia.

### Preciso de um SDK para usar o TagoTiP?

Não. Como os frames são texto puro, você pode montá-los e enviá-los diretamente do seu firmware ou de qualquer cliente. O protocolo é legível por humanos por design.

## Comece a enviar dados em minutos

TagoTiP é gratuito, open-source e já está disponível na TagoIO. Sem necessidade de SDKs. Basta montar o frame e enviar.

[llms.txt](https://tago.io/llms.txt)