Trama · Sirius

Trama reparte un único enlace a internet (Starlink, satelital o celular) por una malla de radio LoRa de largo alcance. Con pocos nodos repetidores se cubren kilómetros de campo, montaña o selva donde no llega señal celular.

Sirius es la capa de captura agro: cada persona lleva un nodo y registra el trabajo del campo (cosecha, siembra, polinización, plagas, censo) desde cualquier parte de la finca. Los datos viajan por la mesh y llegan al gateway en segundos, aunque el punto de captura esté sin señal.

El sistema tiene cuatro capas: captura, transporte, ingesta y presentación.

  Campo (sin señal)                         Nube / internet
 ┌───────────────┐   LoRa mesh   ┌────────────┐   HTTPS   ┌──────────────┐
 │ Nodos T1000-e │◀────────────▶│  Gateway    │◀────────▶│  Supabase     │
 │ Inv1 … Inv7   │  (Meshtastic)│  (Raspberry │           │  (Postgres)   │
 └───────────────┘              │   Pi 4)      │           └──────┬───────┘
                                │  radio CTRL  │                  │
                                └────────────┘                    │
                                                     ┌────────────┼────────────┐
                                                     ▼            ▼            ▼
                                                 Webapp        App Flutter   WhatsApp
                                                (Next.js)      (offline)     (relay + bot)

Esta es una de las dos mallas soportadas. Corre firmware Meshtastic, y tres parámetros definen cómo y dónde transmite; deben ser idénticos en todos los nodos para que se escuchen. La alternativa —y lo que conviene para crecer— es MeshCore, en el capítulo siguiente.

Región, preset y slot

Sus valores dependen de la zona de operación (la banda legal de cada país) y del despliegue; Trama™ los configura en cada instalación y no se publican.

Canal y cifrado

El canal primario se llama Inverse y lleva una PSK (clave precompartida): todo el tráfico de la operación va cifrado en ese canal. Un nodo sin la PSK correcta no descifra los mensajes aunque esté en la misma frecuencia.

Difusión vs directo

Un mensaje puede ir a un nodo (DM) o a todos por difusión (dirección ^all, sin ACK). El gateway usa ambos: DM para relays 1-a-1, broadcast para avisos a toda la red.

La malla de radio es intercambiable. Todo lo que está por encima —el gateway, la captura, WhatsApp, la IA, la app— habla contra una interfaz común (MeshTransport) y no sabe qué firmware corre debajo. Por eso hay dos opciones soportadas, y elegir una es una decisión de despliegue, no una reescritura.

Cuál elegir

Regla práctica: para un despliegue pequeño y cerrado, Meshtastic es más simple porque se autoconfigura. Para crecer —más nodos, más área, repetidores— MeshCore es el que aguanta, porque en Meshtastic cada nodo repite y el aire se llena de copias del mismo mensaje.

Los cuatro parámetros de radio

Deben ser idénticos en todos los nodos, igual que en Meshtastic. Pero aquí no hay «preset» que los fije de golpe: se ponen uno por uno.

frecuencia   922.375 MHz   (la banda; separa mallas vecinas)
ancho banda  250 kHz       (BW)
spreading    11            (SF — alcance contra velocidad)
codificación 5             (CR)

Identidad y contactos

MeshCore identifica a cada nodo por su clave pública, que se genera al flashear. Los primeros 4 bytes son el id que se ve en los registros (!b3575a04). No hay NodeDB: para escribirle a alguien hay que tener su clave completa.

Consecuencia práctica: los contactos se precargan en el gateway (variable MESH_CONTACTS) y en la app. Y como un nodo companion no se anuncia solo —en MeshCore solo se anuncian los repetidores—, el gateway manda un anuncio al arrancar para que los nodos puedan dirigirse a él sin depender de la app.

Firmware por rol

Hay un release distinto por papel, y no son intercambiables: companion (nodos de usuario y el del gateway), repeater (los que relevan) y room-server.

Límites que fallan en silencio

Estos se midieron en banco antes de escribir código, y conviene respetarlos porque ninguno avisa cuando se pasa:

Por eso los envíos largos se trocean y se entregan al ritmo de drenaje de la radio, y las fotos llevan un contador de intento en la cabecera: sin él, un reenvío idéntico se descartaría por deduplicación.

Los nodos son Seeed T1000-e: trackers LoRa con GPS, batería y opción de panel solar. Cada uno tiene un short name (Inv1…Inv7, CTRL) y un ID hex (!40883c41).

El gateway es una Raspberry Pi 4 con una radio Meshtastic por USB (el nodo CTRL) y servicios en Python. Es el puente entre la malla y la nube.

Servicios (systemd)

Módulos del gateway

Operación

# Estado y logs
sudo systemctl status mesh-portatil-gateway
journalctl -u mesh-portatil-gateway -f

# Reiniciar (p. ej. tras tocar la radio)
sudo systemctl restart mesh-portatil-gateway

Los nodos emiten tramas de texto por la mesh; el gateway las parsea y las guarda en Supabase. El flujo es nodo → mesh → gateway → Supabase.

Trama de cosecha

@kg|<id_colaborador>|<cantidad>|<lat>|<lng>|t<epoch>
# ej.  @kg|12|34.5|4.812|-75.71|t1786390000

Guarda la cantidad recogida por un colaborador, con su ubicación GPS (dónde se capturó) y la marca de tiempo. El jornal se calcula como cantidad × tarifa.

Hay dos integraciones de WhatsApp, independientes:

1) Relay (radioteléfono)

Puente entre una persona en WhatsApp y los nodos de la mesh, por la WhatsApp Cloud API oficial. Desde WhatsApp se direcciona por prefijo:

Del lado mesh, un nodo manda @wa|telefono|texto para escribir a WhatsApp (dentro de la ventana de servicio de 24 h).

2) Bot Sirius (IA)

Un agente conversacional con Claude que crea la app de la finca, responde preguntas de datos reales y genera dashboards:

generar_dashboard devuelve un link meshtrama.net/d/<token> con token secreto que caduca en 7 días y muestra producción, pago y colaboradores en vivo.

Al desplegar en una zona nueva, los nodos deben migrarse a la banda legal de uso libre de esa zona. Es un cambio de configuración (región, preset y slot), no un reflasheo. Los valores concretos los define Trama™ para cada sitio, bajo licencia.

Procedimiento (runbook)

1. Inventario de todos los nodos (short name, ID, firmware).
2. Backup de la config de cada nodo ANTES de tocarlo.
3. Migrar uno por uno; verificar región + preset + slot en cada uno.
4. Verificar la FRECUENCIA efectiva, no solo la región.
5. El nodo del gateway (CTRL) se migra al FINAL:
     - detener el servicio  → aplicar  → verificar  → reiniciar.
6. Verificar de verdad: last_heard fresco + prueba extremo-a-extremo.

# Cambiar la config de radio (con el servicio detenido si es el CTRL)
meshtastic --port /dev/ttyACM0 \
  --set lora.region <REGION> \
  --set lora.modem_preset <PRESET> \
  --set lora.channel_num <SLOT>

Tablas de Supabase

Endpoints de la webapp

CLI de Meshtastic

meshtastic --port <puerto> --info            # ver config del nodo
meshtastic --port <puerto> --export-config   # backup
meshtastic --port <puerto> --configure f.yaml # restaurar