EKO / NODE 01
Un nodo Meshtastic de bolsillo, diseñado para Ekoparty 2026. El teléfono sirve para escribir y configurar; el badge transmite y recibe por LoRa.
nRF_RESET). Para entrar en EKOBOOT, apagá el badge, mantené presionado este botón mientras conectás el USB-C y encendé el badge sin soltarlo. Soltalo cuando aparezca la unidad EKOBOOT en la computadora.R19 a R21; consultá la sección de antena externa.Debido al uso de componentes especiales, el badge se ensambló con soldadura de baja temperatura. Esta soldadura es más susceptible a los impactos, por lo que un golpe o una caída pueden desprender componentes e inutilizar el badge.
Todo badge electrónico expone sus circuitos, componentes y terminales de contacto, lo cual implica un riesgo de cortocircuitos que se pueden evitar fácilmente:
Despierta la OLED si está apagada. Con la pantalla encendida, avanza de pantalla o recorre opciones.
Abre el menú de la pantalla actual o confirma una opción. En la animación Ekoparty abre la configuración propia del BADGE.
Estas capturas muestran la aplicación Meshtastic para Android. En otras versiones y en iPhone pueden cambiar los nombres o la ubicación de algunos controles.
Mové el interruptor a ON. La intro dura alrededor de 12 segundos; después aparece el QR de esta guía. El badge acepta el emparejamiento Bluetooth cuando termina la intro.
Si cuesta escanear el QR de la OLED, bajá la exposición de la cámara y acercá o alejála hasta enfocar.
Instalá la aplicación oficial Meshtastic en tu teléfono y activá Bluetooth. Abrí la app cuando termine la instalación.
En la app, abrí Connection, seleccioná Bluetooth y pulsá Scan for Bluetooth devices para buscar badges cercanos.
Para reconocer el tuyo, avanzá con pulsaciones cortas del botón del badge hasta la pantalla Home. Ahí aparece el nombre del nodo y su identificador corto; compará ese identificador con los dispositivos de la app (por ejemplo, E001 en E001_d8aa). Seleccioná tu nodo en la lista.
Seleccioná el badge en la lista. El PIN aparece en su OLED; ingresalo cuando lo solicite el teléfono.
Esperá a que termine la sincronización. El pixel de estado del badge queda verde tenue fijo mientras el teléfono está conectado. En la app ya podrás ver conversaciones y nodos escuchados.
Si no lográs conectarte, comprobá que Bluetooth esté encendido, cerrá y volvé a abrir la app, y repetí la búsqueda. Una vez emparejado, no tendrás que volver a ingresar el PIN en cada conexión.
Si preferís usar un cable, conectá el badge al teléfono con un USB-C de datos y elegí USB en Connection, siempre que tu teléfono admita esa conexión.
El teléfono habla con tu badge por Bluetooth. Los mensajes entre badges viajan por LoRa; el teléfono puede desconectarse y el badge sigue formando parte de la red.
Con el badge conectado a Meshtastic, podés elegir cómo se identifica tu nodo.
En la app, entrá en la pestaña Settings (ícono de engranaje) y pulsá User.
Editá Long Name (nombre largo) y Short Name (nombre corto). Elegí los nombres que quieras; también podés usar emojis en el nombre largo 🙂.
Cuando termines, pulsá Save para guardar los cambios.
La red está formada por nodos de radio. Pueden pasar mensajes entre sí sin Wi-Fi, datos móviles ni servidor central.
Cada badge es un nodo de la red. La lista de nodos muestra los dispositivos de los que tu badge recibió información.
Es una conversación compartida. Para leer los mensajes, los dispositivos necesitan una configuración de canal compatible.
Se transmite para los nodos que comparten ese canal. Es la primera prueba recomendada después de conectarte.
Va dirigido a un nodo concreto. Esperá a que ambos nodos intercambien su información antes de probarlo.
El perfil de este firmware usa región ANZ, preset MEDIUM_FAST y rol CLIENT_MUTE. La organización define los parámetros y canales del evento. Cambiarlos puede impedir la comunicación con los demás badges.
Con el badge conectado, la pestaña de conversaciones de Meshtastic separa los canales de los mensajes directos.
MediumFast o el indicado por la organización.Un canal puede tener varios participantes. El nombre y los canales visibles dependen de la configuración cargada en tu badge.
Un mensaje directo está dirigido a un nodo específico; no es la misma conversación que un canal.
La lista se completa a medida que llegan transmisiones de la red. Acercá dos badges, comprobá que compartan los parámetros del evento y empezá con un mensaje de canal.
El firmware incluye frases listas para enviar, como Aguante EKOPARTY!, Test y Copiado. Navegás con pulsaciones cortas y confirmás con una larga.
Con la OLED encendida, pulsá brevemente hasta llegar a Messages. Mantené pulsado para abrir las acciones de esa pantalla.
Si ya hay mensajes, elegí Reply. Si aún no hay conversaciones, abrí la opción de mensaje predefinido nuevo que aparece en esa pantalla.
En Reply, seleccioná With Preset. La lista de frases comienza con [Select Destination]; ahí podés cambiar el destinatario. Recorré la lista con pulsaciones cortas hasta la frase que quieras enviar.
Antes de confirmar, revisá la línea To: — # indica un canal y @ un nodo concreto.
Mantené pulsado para enviar la frase seleccionada. La OLED muestra Sending... durante la transmisión. Después podés mirar la conversación en el badge o, si conectás el teléfono, en la app.
El vínculo Bluetooth no hace falta para enviar estas frases. Sí necesitás otro nodo compatible, dentro del alcance de radio, para que alguien reciba el mensaje.
Con el badge conectado a la app, abrí Settings → Module configuration → Canned Message.
|. Por ejemplo: Hola|Ya llegué|Nos vemos.
|.En la pantalla animada de Ekoparty, una pulsación larga abre el menú BADGE. Una corta recorre las opciones; una larga confirma.
Elegí qué aparece en el frame Ekoparty y el patrón de las seis luces traseras. Las opciones son Ojo, Logo glitch, Calavera, Risa y Mesh ARG. Ojo es la inicial.
Configurá los seis LEDs decorativos traseros como Apagados, Tenues o Brillantes. El pixel de estado funciona por separado.
Mostrar deja el QR dentro del carrusel de pantallas y al final de la intro. Ocultar lo retira de la navegación.
Completo muestra Bluetooth y mensajes. Solo Bluetooth, Solo mensajes y Apagado filtran esas señales. La alerta de batería crítica se mantiene siempre.
| Señal | Significado |
|---|---|
| Dos destellos rojos cada 3 s | Batería crítica, 5 % o menos sin USB. |
| Azul rápido intermitente | Emparejamiento Bluetooth en curso. |
| Dos destellos ámbar | Mensaje recibido en un canal por LoRa. |
| Cuatro destellos verdes | Mensaje directo recibido por LoRa. |
| Verde tenue fijo | Teléfono conectado por Bluetooth. |
| Pulso azul tenue cada 2 s | Bluetooth activo, sin teléfono conectado. |
El buzzer avisa sobre mensajes y acciones. Su modo se cambia desde la configuración del dispositivo en Meshtastic: todos los sonidos, sólo notificaciones, sólo sistema, sólo mensajes directos o desactivado.
Acerca de muestra créditos y versión. Reproducir intro vuelve a mostrar la secuencia audiovisual. Durante la reproducción manual, el vínculo Bluetooth continúa activo.
Devuelve las preferencias locales de animación, backlights, QR y status LED a sus valores iniciales. No borra canales, claves ni el emparejamiento Meshtastic.
Podés desactivar el buzzer para que el badge no suene al recibir mensajes. La recepción de mensajes continúa funcionando normalmente.
Con el badge conectado, entrá en Settings → Module configuration y seleccioná External Notification.
En la sección Notifications on message receipt, desactivá el switch Alert GPIO buzzer when receiving a message, identificado también como Buzz on incoming message.
Tu badge funciona como un nodo Meshtastic. Estas son sus pantallas principales; para conocer todas las funciones, consultá la documentación oficial de Meshtastic.
Con la OLED encendida, una pulsación corta avanza al siguiente frame. Si estaba apagada, la primera pulsación sólo la despierta. Los datos de nodos y distancias aparecen a medida que el badge recibe información de la red.
? indica que falta alguna.
Los canales separan las conversaciones de la red. El badge tiene un canal primario de difusión y puede sumar canales secundarios privados para grupos específicos.
Es el canal principal de la red y se usa para los mensajes generales. Los mensajes enviados allí llegan a los nodos que comparten su configuración.
Están cifrados con una clave compartida o PSK. Sólo los nodos que tengan el mismo nombre de canal y la misma PSK podrán participar de la conversación.
Con el badge conectado, entrá en Settings y seleccioná Channels.
El canal con índice 0 es el Primary. Los demás aparecen como Secondary y pueden usarse como canales privados.
Para crear un canal secundario nuevo, pulsá el botón + de la esquina inferior derecha.
Escribí un Channel Name y usá la PSK generada para cifrar el canal. Si querés compartir tu ubicación con quienes participan de ese canal, activá Position enabled; si no, dejalo desactivado.
Guardá la configuración y compartí el nombre exacto del canal y la PSK únicamente con las personas que quieras sumar. Sus nodos deben configurar ambos valores iguales para poder intercambiar mensajes en ese canal privado.
Quien tenga el nombre y la PSK puede sumarse al canal privado y leer sus mensajes. Compartí esos datos sólo con las personas que deban participar.
El firmware llega preparado para comunicarse durante el evento. Podés modificar sus parámetros desde Meshtastic si te sumás a otra red.
En la app de Android, abrí Settings → LoRa. La región ANZ selecciona la banda ISM que Meshtastic indica para Argentina; MEDIUM_FAST es el preset de radio elegido para la red del evento en CABA. El preset define cómo transmite la radio; no es el nombre de un canal.
En otra provincia de Argentina, la región sigue siendo ANZ, pero otra red puede usar un preset o canales distintos. En otro país, elegí la región permitida allí. Más abajo, Max Hops limita cuántas retransmisiones puede hacer un mensaje.
Se borra tu configuración personal de Meshtastic y se cargan de nuevo los valores de esta compilación: ANZ, MEDIUM_FAST, CLIENT_MUTE y 3 saltos. Los podés volver a cambiar después. BADGE → Restaurar sólo restablece las preferencias visuales del badge.
En Settings → Device configuration → Device encontrás Device Role. El rol determina si el nodo retransmite mensajes de otros y cómo participa en la red. El badge viene en CLIENT_MUTE para reducir retransmisiones en un evento con muchos nodos.
Envía y recibe tus mensajes, pero no retransmite los de otros nodos. Es el ajuste inicial del badge.
Uso personal general. Puede retransmitir un paquete si hace falta.
Retransmite para ampliar cobertura. Está pensado para un nodo de infraestructura bien ubicado y puede cambiar el uso de la pantalla y Bluetooth.
Prioriza los avisos de posición y puede apagar la pantalla. Este badge necesita una posición fija o la ubicación del teléfono porque no trae GPS.
La pestaña Mesh Map muestra los nodos que compartieron una posición. Compartir la tuya es opcional: podés fijar una ubicación en Settings → Device configuration → Position o permitir que la app use la ubicación GPS de tu teléfono mientras esté conectado.
El Ekoparty Badge no tiene GPS incorporado, pero recibe posiciones de la mesh. Cuando conoce su ubicación y la de otro nodo, el frame Distance calcula la distancia entre ambos. El firmware no fuerza position sharing ni su precisión en el canal primario.
Más detalles en la documentación oficial: LoRa, roles, posición y regiones por país.
El USB-C alimenta y carga el badge; también permite actualizar la aplicación mediante el bootloader EKOBOOT.
Usá una batería 18650 recargable con la polaridad correcta. Para consumir menos, apagá los backlights y dejá que la OLED se apague cuando no la uses.
La OLED se apaga después de unos 10 minutos sin actividad, según la configuración. Una pulsación corta la despierta; otra avanza al siguiente frame.
Descargá el archivo UF2 de ekoparty_badge_v1 desde la release v1.0.4.
ekoparty_badge_v1 y, si está disponible, verificá su suma SHA-256.OFF y desconectá el USB si estaba conectado.nRF_RESET. Sin soltarlo, conectá el cable USB-C a la computadora.ON. Mantenelo pulsado hasta que aparezca la unidad EKOBOOT en la computadora.EKOBOOT.BADGE → Acerca de, comprobá la versión instalada.La unidad puede desaparecer durante la copia cuando el bootloader acepta el firmware. Si el badge no inicia, seguí la guía técnica de compilación y carga.
El badge viene configurado para usar la antena LoRa integrada en el PCB. Para conectar una antena externa al conector IPEX, hay que cambiar la posición del puente de 0 Ω.
No enciendas el badge sin una antena conectada. Si cambiás el puente a R21, conectá la antena externa al IPEX antes de volver a encenderlo.
R19, que conecta la radio con la antena integrada, y soldala en los pads R21. Así la señal se dirige al conector IPEX.
Probá estas comprobaciones antes de modificar la configuración de radio o restaurar Meshtastic.
Hacé una pulsación corta para despertarla. Esa primera pulsación no cambia de frame. Si no responde, conectá el badge por USB y probá otra vez.
Esperá a que termine la intro, activá Bluetooth en el teléfono y acercalo al badge. Cerrá y reabrí la app. Si existe un vínculo antiguo que falla, olvidá ese dispositivo desde los ajustes Bluetooth del teléfono e intentá emparejarlo de nuevo.
Probá primero un mensaje de canal con otro badge cercano. Verificá que compartan región, preset y canal. La lista de nodos puede tardar en completarse; los mensajes directos requieren que los nodos ya se conozcan.
Revisá el modo del buzzer en Meshtastic y las opciones BADGE → Backlights y BADGE → Status LED. Las luces traseras y el pixel de estado son independientes.
Puede ser el reinicio normal tras aceptar el UF2. Esperá la intro y comprobá la versión en BADGE → Acerca de.
Este badge usa una adaptación del firmware Meshtastic para el PCB Ekoparty Badge v1.
Para aprender más y sacarte dudas sobre Meshtastic, visitá Mesh Argentina y su grupo de Telegram.
Estos son los componentes principales del PCB ekoparty_badge_v1.
nRF52840-QIAA-R, encargado del firmware y la conexión Bluetooth.Ra-01SH con transceptor Semtech SX1262.HS96L03W2C03 conectada por I²C.SK6812mini-012 y un séptimo pixel independiente para el estado.TP4056 y protección de batería DW01 con MOSFET 8205A.AP2112K-3.3 para la línea de 3,3 V.RFANT5220110A0T, antena LoRa integrada en el PCB y conector IPEX para una externa.Detalle eléctrico: esquema del PCB y mapa de pines.
Este badge fue creado en el marco de la Ekoparty 2026 por el equipo de desarrollo.
a.k.a. Fabrica Marciana
Fabrica Marciana ↗a.k.a. Monstruo Midi
Sitio personal ↗Buenos Aires, 2026.