nodemecu/README.md

Sistema Modular para la Captura de Datos y Muestras Ambientales

nombre clave: 'nodemecu'

El Sistema Modular para la Captura de Datos y Muestras Ambientales ('nodemecu') es un desarrollo conjunto de Herramientas para el Buen Vivir A.C. (México), la cooperativa de desarrollo digital SUTTY (Argentina), BarraDev infraestructuras y telemetría (Argentina) y la Cooperativa de Producción Tecnológica, Gráfica y Audiovisual LTDA (Argentina) con el apoyo económico de Witness (USA), como parte del acompañamiento realizado al Frente de Pueblos en Defensa de la Tierra y el Agua de Puebla, Morelos y Tlaxcala en el marco del proyecto de fortalecimiento “Coral”.

'nodemecu' consiste en un sistema electrónico autónomo sumergible con sensores que en tiempo real escanean las condiciones ambientales y envían esa información hacia un servidor web que almacena y despliega los datos de Temperatura, PH, Conductividad y Turbidez. Ante la detección de algún indicador de posible contaminación en el agua captura una muestra líquida de manera automatizada y sin intervención humana.

La intención del proyecto es brindar una herramienta accequible y de bajo costo a las comunidades y organizaciones en defensa del territorio, que necesiten fortalecer su estrategia jurídica con datos y cifras que comprueben la contaminación del medio ambiente.

El sistema, tanto en su hardware como software, ha sido diseñado de manera modular, de tal manera que permite la fácil implementación de otros sensores y sistemas de captura o comportamiento a partir de los diseños originales, todos los cuales serán publicados bajo licencias de software y hardware libre y puestos a disposición de las comunidades que lo necesiten.

Durante los últimos 6 meses se ha trabajado intensamente en el desarrollo del software que permite el registro, transmisión, almacenamiento y despliegue de datos, el control de los sensores, el diseño de placa de montaje de los componentes y en los exteriores del sistema. Actualmente estamos iniciando la etapa de prototipado, que consiste en la construcción real del sistema, para en caso de cumplir con las espectativas de diseño, inicie su replicación y masificación.

Para culminar esta etapa final antes de la implementación real en campo, hemos comprometido el apoyo del Instituto de Desarrollo e Innovación Tecnológica de la Universidad Iberoamericana de Puebla (IDIT - IBERO), quienes nos brindarán acompañamiento y asesoría.

Instalación

Requisitos

• Raspberry (cualquier versión).
• Sistema operativo 'Raspberry Pi OS Lite.
• Instalador 'Raspberry Pi Imager'
• Una tarjeta MicroSD Clase 10 de al menos 4GB.

Instalación del sistema operativo

Paso 1

Descargar la ultima versión de 'Raspberry Pi OS Lite':

https://www.raspberrypi.com/software/operating-systems/

Paso 2

Descargar el instalador 'Raspberry Pi Imager':

https://downloads.raspberrypi.org/imager/imager_latest.exe

Paso 3

Insertar la tarjeta MicroSD en la computadora.

Paso 4

Abrir 'Raspberry Pi Imager':

• CHOOSE OS: Seleccionar la imagen 'Raspberry Pi OS Lite' descargada el paso 1.
• CHOOSE STORAGE: Seleccionar la tarjeta MicroSD.
• WRITE: Comienza a grabar el sistema operativo en la tarjeta.

Paso 5

Una vez que finaliza la grabación extraer la tarjeta MicroSD y colocarla en la Raspberry.

Instalación de 'nodemecu'

Paso 1

Abra una terminal e instale 'git'.

$ sudo apt update && apt install git

Paso 2

Clonar el repositorio 'nodemecu'.

$ git clone https://gitea.nulo.in/Nodemecu/nodemecu.git

Resultado.

Clonando en 'nodemecu'...
remote: Enumerating objects: 179, done.
remote: Counting objects: 100% (179/179), done.
remote: Compressing objects: 100% (176/176), done.
remote: Total 179 (delta 97), reused 0 (delta 0), pack-reused 0
Recibiendo objetos: 100% (179/179), 394.81 KiB | 933.00 KiB/s, listo.
Resolviendo deltas: 100% (97/97), listo.

Paso 3

Ingresar al directorio 'nodemecu'.

$ cd nodemecu

Lanzar script de instalación.

$ sudo ./instalador

Resultado.

...
Created symlink /etc/systemd/system/multi-user.target.wants/nodemecu.service → /lib/systemd/system/nodemecu.service.

4. Configurar

- Ejecute 'sudo nodemecu configurar' para comenzar.

-Ejecute 'sudo nodemecu modo sensores' para obtener datos desde sensores.

- Ejecute 'sudo nodemecu captura iniciar' para comenzar a tomar datos de sensores o datos de prueba.

- Ejecute 'sudo systemctl start nodemecu.service' para iniciar el envío de datos.

Configurar dispositivo

El 'CLI' es la interfaz de comandos para administrar 'nodemecu', debemos utilizarla para los primeros pasos luego de la instalación del programa:

• Determinar el nombre del dispositivo.
• Determinar la URL del servidor donde se enviarán los datos.
• Intervalo de toma de mediciones.

Paso 1: Configuración

Ejecute el asistente de configuración y complete las preguntas.

$ sudo nodemecu configurar

Resultado.

Complete los cambios a continuación: 
		
Nombre del dispositivo.
nombre: calle falsa 123 
nombre: calle_falsa_123

Servidor de entrega de datos.
servidor (ej. https://url.del/servidor): https://servidor.de.envio                 
Servidor https://servidor.de.envio

Intervalo de toma de muestras, entre 1 y 60 minutos.
intervalo: 5
Intervalo seteado en 5

Creando juego de llaves
Generating public/private ecdsa key pair.
Your identification has been saved in /opt/nodemecu/llaves/calle_falsa_123.pem.
Your public key has been saved in /opt/nodemecu/llaves/calle_falsa_123.pem.pub.
The key fingerprint is:
SHA256:7ZSKlfxybO/ssa63EeGVRDzMjcNKCOI4Kfx++V7o9vg root@raspberrypi
The key's randomart image is:
+---[ECDSA 256]---+
|      . .. . *oo |
| .   + .  . ..O..|
|  o + .    ...oo |
|   o . . o o.o   |
|    .   S + o    |
|   .   + B   .   |
|    . + + B o    |
|     . o.* o.+   |
|       o=oE*O.   |
+----[SHA256]-----+

El modo de operación por defecto es 'test' y se envían datos simulados, cambie a 'sensores' con el comando 'sudo nodemecu modo sensores'

Paso 2: Modo de operación

Determine si los datos a registrar son simulados u obtenidos de sensores físicos, 'nodemecu' por defecto esta configurado para trabajar con datos simulados, si lo prefiere así entonces salte este paso, de lo contrario cambie el modo de operación.

Cambio de modo de operación.

$ sudo nodemecu modo sensores

Paso 3: Captura o toma de datos

Al ser instalado 'nodemecu' no realiza ningún tipo de captura de datos, para ello debe activar la captura.

Activar captura.

$ sudo nodemecu captura iniciar

Resultado.

Iniciando la captura de datos en modo 'sensores'

Desea continuar? Presione 'enter' para continuar o 'ctrl-c' para cancelar...

Se tomarán datos cada 5 minutos.

Paso 4: Envío de datos

Nodemecu utiliza el administrador de servicios 'systemd' para gestionar el programa que se encarga de enviar al servidor los datos registrados, se debe activar e iniciar el servicio para comience el envío de datos.

Activar servicio con el arranque del sistema, si no realiza este paso deberá hacer el inicio manual cada vez que se arranque el sistema.

$ sudo systemctl enable nodemecu.service 

Resultado.

Created symlink /etc/systemd/system/multi-user.target.wants/nodemecu.service → /lib/systemd/system/nodemecu.service.

Iniciar el envío de datos.

$ sudo systemctl start nodemecu.service

Ver estado del servicio.

$ sudo systemctl status nodemecu.service

Resultado (se sale con 'q').

● nodemecu.service - Procesador de pila y transmisor de datos Nodemecu.
   Loaded: loaded (/lib/systemd/system/nodemecu.service; enabled; vendor preset: enabled)
   Active: active (running) since Fri 2022-03-11 16:25:57 -03; 39s ago
 Main PID: 18283 (registrador)
    Tasks: 2 (limit: 2181)
   CGroup: /system.slice/nodemecu.service
           ├─18283 /bin/bash /opt/nodemecu/registrador
           └─18567 ping -c 1 fsf.org
...

Comandos nodemecu

Lista de comandos de ' nodemecu CLI'

Establecer o cambiar nombre del dispositivo.

Establece o cambia el nombre definido para el dispositivo, se recomienda usar solo caracteres alfanuméricos y sin espacios.

$ sudo nodemecu nombre nombre_del_dispositivo

Servidor de entrega de datos

Establece o modifica el servidor de entrega de datos.

$ sudo nodemecu servidor https://url_o_ip_del.servidor

Modo de operación

Cambia al modo de operación con respecto a la captura de datos:

• 'test' genera y registra datos simulados.
• 'sensores' toma datos realoes de los sensores.

Para generar datos simulados.

$ sudo nodemecu modo test

Para tomar datos de sensores.

$ sudo nodemecu modo sensores

Toma de datos

Permite detener la toma o captura de datos ya sean simulados o de sensores.

Para iniciar la captura.

$ sudo nodemecu captura iniciar

Para detener la captura

$ sudo nodemecu captura detener

Intervalo de toma de datos

Cada cuanto tiempo se toman datos, sean simulados o de sensores. Indique en minutos (1~60).

Configurar intervalo, en el ejemplo se configura para que tome datos cada 1 minuto.

$ sudo nodemecu intervalo 1

Llaves

Cada registro va firmado para validar la autenticidad y que no haya sido modificado el envío al servidor, para ello se utilizan llaves digitales, la creación de estas llaves esta automatizada cuando se ejecuta el comando $ sudo nodemecu configurar . Puede generar en cualquier momento una nueva llave, se recomienda esta acción si modifica el nombre del dispositivo.

Generación de llave.

$ sudo nodemecu cllave

Envío de datos

El envío de datos es una operación separada de la captura, el segundo toma datos y los guarda en el dispositivo, el primero envía esos datos a un servidor para procesar y mostrar la información.

Iniciar el envío de datos.

$ sudo systemctl start nodemecu.service

Detener el envío de datos.

$ sudo systemctl stop nodemecu.service

Activar el envío de datos con el arranque del sistema.

$ sudo systemctl enable nodemecu.service

Desactivar el envío de datos con el arranque del sistema.

$ sudo systemctl disable nodemecu.service

Ver el estado del servicio de envío de datos.

$ sudo systemctl status nodemecu.service