Documentación técnica
Todo el conocimiento técnico del proyecto Bogotá Mesh: firmware, hardware, protocolos de enrutamiento, instalación de nodos y servicios de red. Originalmente alojada en nuestro wiki, hoy reunida aquí.
Durante sus años de actividad, Bogotá Mesh produjo una extensa documentación técnica alojada en su wiki (wiki.bogota-mesh.org). Esa documentación cubría desde los fundamentos teóricos de las redes en malla hasta las guías paso a paso para instalar un nodo funcional. El material fue producido de forma colaborativa por los miembros del proyecto y publicado bajo licencias libres para que cualquier comunidad pudiera reutilizarlo.
Esta página reúne las cuatro áreas principales de documentación del proyecto.
Firmware Nightwing
Nightwing es el firmware personalizado de Bogotá Mesh, construido sobre OpenWrt y diseñado para simplificar al máximo el despliegue de nodos en la red comunitaria. Su nombre evoca la visión nocturna de un murciélago —metafórica y apropiada para el protocolo B.A.T.M.A.N. que integra de serie.
Base
OpenWrt
Distribución Linux embebida para routers. Kernel optimizado para dispositivos con recursos limitados (4–16 MB flash, 32–64 MB RAM).
Protocolo de enrutamiento
B.A.T.M.A.N. (batman-adv)
Better Approach To Mobile Adhoc Networking. Opera en capa 2 (nivel de enlace), creando una red virtual donde cada nodo es transparente para los demás.
Arquitectura de hardware
Atheros SoC (AR71xx / AR9xxx)
System-on-Chip con radio WiFi integrada. Los chips Atheros eran los mejor soportados por OpenWrt y los más habituales en routers de bajo costo.
Autoconfiguración
Dirección IP automática
Al arrancar, cada nodo Nightwing se asigna una IP única dentro del rango de la red mesh, sin intervención manual. DHCP para clientes conectados al nodo.
Proceso de flasheo
# 1. Descargar la imagen de Nightwing para tu modelo de router
wget https://firmware.bogota-mesh.org/nightwing-ar71xx-generic.bin
# 2. Conectar al router por cable Ethernet (192.168.1.1)
# 3. Acceder a la interfaz web del firmware original
# 4. Cargar la imagen .bin en la sección "Firmware Upgrade"
# 5. Esperar 3-5 minutos sin desconectar la alimentación
# 6. Verificar conectividad con el nodo
batctl o
Hardware soportado
Nightwing fue compilado para una selección específica de dispositivos, elegidos por su disponibilidad en el mercado colombiano, su relación calidad/precio y su compatibilidad con OpenWrt. A continuación, los equipos que formaron la columna vertebral de la red.
Ubiquiti NanoStation M2 / M5
exterior- SoC
- Atheros AR7241 + AR9287
- Freq
- 2.4 GHz (M2) / 5 GHz (M5)
- Ganancia
- 11 dBi (M2) / 16 dBi (M5), antena panel integrada
- PoE
- 24V pasivo (incluido)
- Uso
- Enlaces punto a punto de medio y largo alcance (1–15 km)
El dispositivo preferido para enlaces entre nodos distantes. Su antena direccional integrada y su carcasa para exterior lo hacían ideal para montaje en mástil en techos y terrazas.
Linksys WRT54G / WRT54GL
interior- SoC
- Broadcom BCM5352 / BCM5354
- Freq
- 2.4 GHz
- Ganancia
- 2 dBi, antenas dipolo externas (removibles RP-SMA)
- RAM
- 16 MB (WRT54G v4+) / 16 MB (WRT54GL)
- Uso
- Nodo de acceso local, punto de entrada a la red mesh
El router más icónico del movimiento WiFi libre a nivel mundial. Económico, abundante en el mercado de segunda mano, y con soporte maduro en OpenWrt. Sus antenas removibles permitían conectar cantennas caseras.
Antenas direccionales caseras
DIY- Tipo
- Cantenna (lata), Yagi, biquad
- Ganancia
- 8–15 dBi (según diseño)
- Material
- Latas de café, varillas de cobre, cable coaxial RG-58
- Conector
- N-type o RP-SMA (según router)
Parte fundamental de la filosofía DIY del proyecto. En los talleres se enseñaba a fabricar antenas direccionales con materiales accesibles, calculando dimensiones con fórmulas de guía de onda circular.
Ubiquiti NanoBridge M5
backbone- SoC
- Atheros AR7241
- Freq
- 5 GHz
- Ganancia
- 22–25 dBi, plato parabólico
- Alcance
- Hasta 25+ km con línea de vista
- Uso
- Enlaces backbone de largo alcance entre zonas de la ciudad
Reservado para los enlaces troncales de la red, donde se necesitaba máximo alcance y throughput. Su plato parabólico concentraba el haz para cruzar grandes distancias con mínima pérdida.
Instalación de nodos
Instalar un nodo mesh no requiere conocimientos avanzados, pero sí atención al detalle. El wiki documentaba cada paso del proceso, desde la elección del lugar hasta la verificación final de conectividad.
Selección de ubicación
Buscar un punto elevado (techo, terraza, torre) con línea de vista hacia al menos un nodo vecino existente. Usar herramientas como Google Earth para trazar perfiles de elevación y verificar la zona de Fresnel.
Montaje físico
Instalar un mástil (tubo de acero galvanizado o PVC) sujeto con abrazaderas o base de concreto. Montar la antena o el equipo NanoStation en el mástil. Orientar hacia el nodo vecino.
Cableado
Tirar cable Ethernet Cat5e desde la antena hasta el router interior (o usar PoE para alimentar el equipo exterior por el mismo cable). Crimpar conectores RJ-45 con estándar T568B.
Flasheo del firmware
Cargar la imagen de Nightwing en el router vía interfaz web o TFTP. El proceso tarda entre 3 y 5 minutos. No desconectar la alimentación bajo ninguna circunstancia durante el flasheo.
Configuración de red
Acceder por SSH al nodo recién flasheado. Verificar que B.A.T.M.A.N. está activo (batctl o). Configurar el nombre del nodo, el canal WiFi y los parámetros de potencia.
Pruebas de conectividad
Hacer ping a los nodos vecinos. Verificar las tablas de enrutamiento con batctl o. Comprobar throughput con iperf. Documentar el nodo en el mapa de la red.
Servicios de red
La red mesh de Bogotá no era solo un medio de transporte de paquetes: también alojaba servicios propios accesibles para todos los nodos conectados, sin necesidad de salir a Internet. Estos servicios demostraban el valor de tener una red local comunitaria.
Wikipedia offline
Mirror local de Wikipedia en español servido mediante Kiwix. Permitía acceder a la enciclopedia completa sin salir de la red mesh. Útil para zonas sin acceso a Internet donde la red mesh sí llegaba.
VoIP
Servicio de telefonía IP basado en Asterisk. Los nodos con teléfonos IP o softphones podían llamarse entre sí a través de la red mesh, sin costo y sin pasar por la red telefónica pública.
Servidor FTP
Repositorio compartido de archivos accesible por FTP dentro de la red mesh. Alojaba distribuciones Linux, documentación técnica, imágenes de firmware y material educativo del proyecto.
Microblogging
Instancia local de StatusNet (predecesor de GNU Social). Una red social federada accesible dentro de la mesh, donde los participantes podían publicar actualizaciones, compartir noticias del proyecto y coordinarse.
Nota sobre el archivo
La documentación original del proyecto residía en wiki.bogota-mesh.org, un MediaWiki que fue el centro de referencia técnica durante los años de mayor actividad del proyecto (2009–2014). Con el tiempo, el wiki se volvió inaccesible, pero su contenido fue parcialmente preservado en el Internet Archive.
Esta página de documentación resume las áreas principales cubiertas por el wiki original. El espíritu sigue siendo el mismo: conocimiento libre, abierto y reutilizable para cualquier comunidad que quiera construir su propia red.