Añadir models/dragino/lsn50-v2/README.md

models/dragino/lsn50-v2/README.md

@@ -0,0 +1,64 @@
+# Dragino LSN50 v2
+
+## Qué es
+
+`Dragino LSN50 v2` es un nodo LoRaWAN de propósito general que MESAVAULT utiliza como activo base reusable para captura de señales, sensórica simple y experimentación técnica orientada a kits y verticales.
+
+Este directorio documenta el modelo base del equipo, no una vertical concreta ni un montaje singular de cliente.
+
+## Qué pertenece aquí
+
+Aquí debe vivir la información válida para el equipo como tal:
+
+- pinout base
+- límites eléctricos
+- comportamiento de entradas y salidas relevantes
+- notas de firmware y operación
+- downlinks base
+- codec base reusable si procede
+- datasheets y fuentes técnicas del fabricante
+
+## Qué no pertenece aquí
+
+No deben vivir aquí como elemento principal:
+
+- circuitos concretos de una combinación validada con otro sensor
+- wiring específico de un caso como `LSN50 + XKC`
+- dashboards
+- SQL
+- `pg_sink.py`
+- `api.py`
+- `scheduler.py`
+- lógica de una vertical reusable
+- particularidades de un cliente concreto
+
+Eso pertenece a:
+
+- `25-kits/` si es una combinación validada
+- `30-verticals/` si es una solución reusable
+- `40-clients/` si es un despliegue singular
+
+## Casos de uso típicos dentro de MESAVAULT
+
+El mismo `LSN50 v2` puede servir como base para varios kits o verticales distintas.
+
+Ejemplo documentado:
+- lectura digital de `PA12` con un sensor capacitivo `XKC-Y25-V` para una vertical de drenaje
+
+Pero ese caso no define por completo el modelo base. Solo demuestra una de sus aplicaciones posibles.
+
+## Contenido de este directorio
+
+- `docs/datasheet-normalized.md` -> ficha técnica limpia y útil
+- `docs/pinout-base.md` -> pinout base y pines relevantes
+- `docs/downlinks-lsn50.md` -> comandos base de downlink y notas operativas
+- `docs/electrical-limits.md` -> límites y advertencias eléctricas
+- `sources/vendors/dragino/lsn50-v2/` -> PDFs originales del fabricante
+- `assets/` -> imágenes o recortes relevantes extraídos del material fuente
+
+## Referencias cruzadas
+
+- kit documentado basado en este modelo: `25-kits/lsn50-v2-xkc-y25-v-drainage/`
+- vertical reusable asociada: `30-verticals/climate-drainage-ngs/`
+- `bookstack_url`: `pendiente_de_crear`
+- `vault_ref`: `pendiente_de_crear`