Ecowitt

La integración con Ecowitt permite que Cloud Studio IoT lea las estaciones meteorológicas Ecowitt desde la nube de Ecowitt, con su API v3. Las estaciones siguen publicando en ecowitt.net como hasta ahora: no hay que reconfigurar el gateway ni instalar nada en campo. La plataforma importa además el histórico que ya guarda la nube de Ecowitt.

Requisitos

• Una cuenta en ecowitt.net en la que publiquen las estaciones.
• La dirección MAC de cada estación, que aparece en la lista de dispositivos de ecowitt.net.
• Acceso a Gear Manager con permisos sobre el cliente.
• Un modelo de dispositivo para las estaciones Ecowitt, con código AWS-ECOWITT, cuyo script de parseo asigne los campos de la API a endpoints.

1. Crear las claves en ecowitt.net

Entra en ecowitt.net con la cuenta de las estaciones, abre tu perfil de usuario desde el icono de cuenta (arriba a la derecha) y crea una Application Key y una API Key. Ecowitt lo explica en How do I find my app & api keys?.

2. Configurar la integración en Gear Manager

Abre el cliente en Gear Manager y entra en la pestaña Integraciones. En Estaciones meteorológicas Ecowitt completa:

• Application Key: la clave de aplicación que creaste en ecowitt.net.
• API Key: la clave de API de tu cuenta.
• Intervalo de consulta (minutos): cada cuánto se leen las estaciones. Por defecto, 5.
• Inicio del histórico (AAAA-MM-DD): desde qué fecha importar los datos que ya guarda Ecowitt. Si lo dejas vacío, se importan los últimos 12 meses.

Guarda los cambios. Las claves son del cliente: si las revocas en ecowitt.net, la plataforma deja de leer sus estaciones.

3. Dar de alta las estaciones

Crea un dispositivo por estación con:

• Modelo: el modelo de dispositivo de las estaciones Ecowitt (código AWS-ECOWITT).
• Dirección: la MAC de la estación, tal como la muestra ecowitt.net.

El script de parseo del modelo recibe el JSON que devuelve la API y asigna cada campo al endpoint que corresponde: temperatura, humedad, presión, viento, lluvia, radiación solar, canales de humedad de suelo y los que tenga la estación. La plataforma pide los valores en unidades métricas: °C, hPa, m/s, mm y W/m². El déficit de presión de vapor (VPD) es la excepción: la API lo devuelve siempre en inHg.

Las estaciones no tienen por qué reportar los mismos sensores, y un mismo canal (soil_ch1, temp_and_humidity_ch3) puede medir cosas distintas en cada una. Por eso el mapeo vive en el script del modelo y se ajusta sin una nueva versión de la plataforma.

4. Histórico

Cuando una estación queda dada de alta, la plataforma importa el histórico que guarda la nube de Ecowitt desde la fecha de inicio configurada (o los últimos 12 meses), cada lectura con su marca de tiempo original. También funciona con estaciones que se dan de alta más tarde: el importador vuelve a mirar cada 6 horas. Ecowitt conserva el detalle de 5 minutos solo para los datos recientes; los rangos más antiguos llegan cada 30 minutos. La importación avanza poco a poco para no competir con el tráfico en vivo, y si se interrumpe sigue donde quedó sin duplicar datos.

Comprobar que funciona

Pasado el intervalo de consulta, el dispositivo muestra su última lectura. Una estación que no publica en ecowitt.net no recibe datos nuevos, pero no frena la lectura de las demás. Si la API responde sin datos para una estación, la plataforma lo toma como "sin datos" y no como un error.