bioreactor-multiparametric-daq-shield/docs/QUICK_START.md

Inicio Rapido

Esta guia es para levantar el proyecto sin entrar todavia en todos los detalles tecnicos.

Que Necesitas

Para desarrollo sin sensores:

• Una computadora con Node.js.
• El repositorio clonado.

Para Raspberry Pi:

• Raspberry Pi con Raspberry Pi OS.
• I2C habilitado.
• Modulos Atlas Scientific EZO en modo I2C.
• Red local para abrir el dashboard.

Probar Sin Sensores

Instale dependencias:

npm ci

Ejecute pruebas:

npm test

Abra dos terminales.

Terminal 1:

EZO_MODE=demo npm run acquire

Terminal 2:

EZO_MODE=demo npm start

Abra:

http://localhost:3000/frontend/index.html

En Windows PowerShell:

$env:EZO_MODE = "demo"
npm run acquire

$env:EZO_MODE = "demo"
npm start

Instalar En Raspberry Pi

Clone el repositorio:

git clone ssh://git@gitea.itmorelia.com:222/Verano-Delfin-2026/bioreactor-multiparametric-daq-shield.git
cd bioreactor-multiparametric-daq-shield

Ejecute el instalador:

chmod +x scripts/install-raspberry-pi.sh
sudo ./scripts/install-raspberry-pi.sh

Abra el dashboard desde otra computadora:

http://IP_DE_LA_RASPBERRY/frontend/index.html

Verificar Que Esta Corriendo

systemctl status photobioreactor-api --no-pager
systemctl status photobioreactor-acquisition --no-pager
systemctl status nginx --no-pager

Si todo esta bien, los servicios deben aparecer como active (running).

Ver Sensores En I2C

i2cdetect -y 1

Mapa esperado:

Direccion	Sensor
0x61	EZO-DO
0x63	EZO-pH
0x64	EZO-EC
0x66	EZO-RTD

Si falta un sensor, revise cableado, alimentacion y modo I2C.

Habilitar Solo Sensores Conectados

Edite:

sudo nano /opt/photobioreactor/config/runtime.json

Ejemplo con RTD, pH y EC:

{
  "loggingRateSeconds": 5,
  "historyRetentionDays": 30,
  "enabledSensors": [
    "temperature",
    "ph",
    "ec"
  ]
}

Reinicie adquisicion:

sudo systemctl restart photobioreactor-acquisition

Revisar Datos

cat /opt/photobioreactor/data/EZORTD.json
cat /opt/photobioreactor/data/EZOPH.json
cat /opt/photobioreactor/data/EZOEC.json

tail /opt/photobioreactor/logs/temperature.csv
tail /opt/photobioreactor/logs/ph.csv
tail /opt/photobioreactor/logs/ec.csv

Si Algo Falla

Lea:

docs/TROUBLESHOOTING.md