# Comandos Y Calibracion Atlas Scientific EZO

Guia para diagnostico, lectura y calibracion de circuitos Atlas Scientific EZO
usados en el fotobiorreactor.

## Sensores Del Proyecto

| Sensor | Circuito | Direccion esperada |
|---|---|---:|
| Temperatura | EZO-RTD | `0x66` |
| pH | EZO-pH | `0x63` |
| Oxigeno disuelto | EZO-DO | `0x61` |
| Conductividad | EZO-EC | `0x64` |

## Transporte I2C

Los EZO reciben comandos ASCII. En I2C, la primera posicion de la respuesta es
un codigo de estado:

| Codigo | Significado |
|---:|---|
| `1` | Solicitud procesada correctamente |
| `2` | Error de sintaxis |
| `254` | Procesando; respuesta aun no lista |
| `255` | Sin datos disponibles |

El helper `EZO_COMMAND` escribe el comando, espera el tiempo indicado y lee la
respuesta. Tambien reintenta si el circuito responde `254`.

## Antes De Enviar Comandos Manuales

Detenga el recolector para evitar conflicto con el bus:

```bash
sudo systemctl stop photobioreactor-acquisition
sudo rm -f /tmp/photobioreactor-i2c.lock
```

Use la ruta instalada:

```bash
/opt/photobioreactor/sensors/EZOCommand/EZO_COMMAND /dev/i2c-1 0x63 300 i
```

Formato general:

```bash
/opt/photobioreactor/sensors/EZOCommand/EZO_COMMAND <bus> <direccion> <delay_ms> <comando> [--no-response]
```

Ejemplo:

```bash
/opt/photobioreactor/sensors/EZOCommand/EZO_COMMAND /dev/i2c-1 0x63 1000 R
```

## Comandos De Diagnostico

Para cada sensor:

```bash
/opt/photobioreactor/sensors/EZOCommand/EZO_COMMAND /dev/i2c-1 0x63 300 i
/opt/photobioreactor/sensors/EZOCommand/EZO_COMMAND /dev/i2c-1 0x63 300 Status
/opt/photobioreactor/sensors/EZOCommand/EZO_COMMAND /dev/i2c-1 0x63 1000 R
/opt/photobioreactor/sensors/EZOCommand/EZO_COMMAND /dev/i2c-1 0x63 300 Cal,?
```

Cambie `0x63` por la direccion correspondiente.

## Calibracion EZO-RTD

Calibracion de un punto:

```text
Cal,<temperatura>
```

Ejemplo:

```text
Cal,25.00
```

Consultar calibracion:

```text
Cal,?
```

Limpiar calibracion:

```text
Cal,clear
```

## Calibracion EZO-pH

Orden recomendado:

```text
Cal,mid,7.00
Cal,low,4.00
Cal,high,10.00
```

Notas:

- El punto medio debe hacerse primero.
- Ejecutar `Cal,mid` sobre una calibracion existente elimina los otros puntos.
- Consulte estado con `Cal,?`.
- Consulte salud de sonda con `Slope,?`.

## Calibracion EZO-DO

Calibracion de un punto en aire:

```text
Cal
```

Calibracion de dos puntos:

```text
Cal,0
Cal
```

Orden:

1. `Cal,0` en solucion de cero oxigeno.
2. `Cal` con sonda estabilizada en aire atmosferico.

Compensaciones disponibles:

```text
T,<grados Celsius>
S,<conductividad en uS/cm>
S,<salinidad>,ppt
P,<presion en kPa>
```

## Calibracion EZO-EC

Primero configure constante de celda:

```text
K,1.0
```

Calibracion en seco:

```text
Cal,dry
```

Calibracion de dos puntos:

```text
Cal,dry
Cal,<valor>
```

Calibracion de tres puntos:

```text
Cal,dry
Cal,low,<valor>
Cal,high,<valor>
```

No use `Cal,0` en EC. En EC, el punto cero corresponde a `Cal,dry`.

Compensacion de temperatura:

```text
T,<grados Celsius>
T,?
```

## Cambiar Direccion I2C

Use esto solo si sabe que la nueva direccion esta libre.

Ejemplo: cambiar a `0x61`. En decimal `0x61` es `97`.

```bash
/opt/photobioreactor/sensors/EZOCommand/EZO_COMMAND /dev/i2c-1 0x62 300 I2C,97 --no-response
```

Luego reinicie energia del modulo o reinicie la Raspberry y confirme:

```bash
i2cdetect -y 1
```

No cambie direcciones sin identificar primero el circuito con `i`.

## Modo Demo Y Modo Hardware

```text
EZO_MODE=demo
EZO_MODE=auto
EZO_MODE=hardware
```

En produccion use:

```text
EZO_MODE=hardware
```

## Fuentes Oficiales

- https://files.atlas-scientific.com/pH_EZO_Datasheet.pdf
- https://files.atlas-scientific.com/DO_EZO_Datasheet.pdf
- https://files.atlas-scientific.com/EC_EZO_Datasheet.pdf
- https://files.atlas-scientific.com/EZO_RTD_Datasheet.pdf