Registrador en Python

Crea meter_logger.py:

#!/usr/bin/env python3
import csv
import os
import signal
import sys
import time
from datetime import datetime, timezone

import RPi.GPIO as GPIO

GPIO_PIN = 17
CSV_PATH = os.path.expanduser("~/utility-meter-logger/meter_log.csv")
STATE_PATH = os.path.expanduser("~/utility-meter-logger/state.txt")

# Example: 1000 pulses per kWh for an electricity meter.
# Change this value to match your utility meter.
PULSES_PER_UNIT = 1000.0
UNIT_NAME = "kWh"

# Debounce time in milliseconds. Increase if your contact bounces.
BOUNCE_MS = 50

running = True
pulse_count = 0


def load_state(path: str) -> int:
    if not os.path.exists(path):
        return 0
    with open(path, "r", encoding="utf-8") as f:
        text = f.read().strip()
    if text == "":
        return 0
    return int(text)


def save_state(path: str, count: int) -> None:
    tmp_path = path + ".tmp"
    with open(tmp_path, "w", encoding="utf-8") as f:
        f.write(f"{count}\n")
    os.replace(tmp_path, path)


def ensure_csv_header(path: str) -> None:
    if os.path.exists(path) and os.path.getsize(path) > 0:
        return
    os.makedirs(os.path.dirname(path), exist_ok=True)
    with open(path, "a", newline="", encoding="utf-8") as f:
        writer = csv.writer(f)
        writer.writerow(
            ["timestamp_utc", "pulse_count_total", "delta_pulses", "consumption_total", "unit"]
        )


def append_csv(path: str, count: int, delta: int) -> None:
    consumption = count / PULSES_PER_UNIT
    timestamp = datetime.now(timezone.utc).isoformat()
    with open(path, "a", newline="", encoding="utf-8") as f:
        writer = csv.writer(f)
        writer.writerow([timestamp, count, delta, f"{consumption:.6f}", UNIT_NAME])


def handle_pulse(channel: int) -> None:
    global pulse_count
    pulse_count += 1
    save_state(STATE_PATH, pulse_count)
    append_csv(CSV_PATH, pulse_count, 1)
    print(
        f"{datetime.now(timezone.utc).isoformat()} pulse={pulse_count} "
        f"consumption={pulse_count / PULSES_PER_UNIT:.6f} {UNIT_NAME}",
        flush=True,
    )


def handle_signal(signum, frame) -> None:
    global running
    running = False


def main() -> int:
    global pulse_count

    pulse_count = load_state(STATE_PATH)
    ensure_csv_header(CSV_PATH)

    GPIO.setmode(GPIO.BCM)
    GPIO.setup(GPIO_PIN, GPIO.IN, pull_up_down=GPIO.PUD_UP)

    signal.signal(signal.SIGINT, handle_signal)
    signal.signal(signal.SIGTERM, handle_signal)

    GPIO.add_event_detect(
        GPIO_PIN,
        GPIO.FALLING,
        callback=handle_pulse,
        bouncetime=BOUNCE_MS,
    )

    print(
        f"Utility meter pulse logger started on GPIO{GPIO_PIN}. "
        f"Current total pulses: {pulse_count}",
        flush=True,
    )

    try:
        while running:
            time.sleep(1.0)
    finally:
        GPIO.cleanup()

    return 0


if __name__ == "__main__":
    sys.exit(main())

Hazlo ejecutable:

chmod +x ~/utility-meter-logger/meter_logger.py

Método de validación

Para validar que este registrador de pulsos de contador de suministros funciona correctamente, usa una fuente de pulsos conocida.

Método 1: Prueba manual de contacto seco

1. Detén el servicio si está en ejecución:

   sudo systemctl stop utility-meter-logger.service
   ```

2. Ejecuta el registrador en una terminal:

```bash
   cd ~/utility-meter-logger
   python3 meter_logger.py
   ```

3. Cortocircuita brevemente `GPIO17` con `GND` exactamente 10 veces usando un pulsador o un cable jumper.
4. Comprueba que se imprimen 10 líneas nuevas y que el conteo total de pulsos aumenta en 10.

Evidencia esperada:

- la salida de consola incrementa una vez por cada cortocircuito
- `tail -n 10 ~/utility-meter-logger/meter_log.csv` muestra 10 filas nuevas
- `cat ~/utility-meter-logger/state.txt` coincide con el conteo total esperado

### Método 2: Comprobación de la constante del contador

Si tu contador eléctrico está etiquetado como `1000 imp/kWh` o `1000 pulses/kWh`, entonces:

- 1000 pulsos registrados deben equivaler a `1.000000 kWh`
- 100 pulsos deben equivaler a `0.100000 kWh`

Evidencia esperada:

- el campo `consumption_total` en el CSV coincide con `pulse_count_total / 1000`

## Solución de problemas

### No se cuentan pulsos

Comprueba:

- que la salida del sensor realmente lleva la línea a GND
- que el número GPIO es correcto: `GPIO17`, no el número de pin físico `17`
- que la salida del contador es segura y de bajo voltaje
- que el tiempo antirrebote no es demasiado corto para un contacto reed

### Conteo doble

Si ves conteos extra desde un interruptor reed, aumenta:


```python
BOUNCE_MS = 100

Luego reinicia el script.

Unidades de consumo incorrectas

Configura correctamente estos valores para tu contador de suministros:

PULSES_PER_UNIT = 1000.0
UNIT_NAME = "kWh"

Ejemplos:

• contador de agua con 1 pulse/litre:
• PULSES_PER_UNIT = 1.0
• UNIT_NAME = "litre"
• contador eléctrico con 1000 pulses/kWh:
• PULSES_PER_UNIT = 1000.0
• UNIT_NAME = "kWh"