commit 820bc5d2ae0386a29a261104c73e0ddc043c6368 Author: victor.fraile Date: Wed Mar 25 17:16:25 2026 +0000 Añadir models/dragino/lsn50-v2/README.md diff --git a/models/dragino/lsn50-v2/README.md b/models/dragino/lsn50-v2/README.md new file mode 100644 index 0000000..48aa837 --- /dev/null +++ b/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` \ No newline at end of file