Davis WeatherLink

La integración con Davis WeatherLink permite que Cloud Studio IoT lea las estaciones meteorológicas de Davis Instruments desde la nube de WeatherLink, con su API v2. Las estaciones siguen reportando a WeatherLink como hasta ahora. Las claves las crea el dueño de la estación en su cuenta y las puede revocar cuando quiera.

Requisitos

• Una cuenta en weatherlink.com con las estaciones.
• El station ID de cada estación (abajo se explica cómo obtenerlo).
• Acceso a Gear Manager con permisos sobre el cliente.
• Un modelo de dispositivo para las estaciones Davis, con código AWS-WEATHERLINK, cuyo script de parseo asigne los campos de la API a endpoints.

Funciona con cualquier equipo que reporte a la nube de WeatherLink, como una WeatherLink Live, una Vantage Pro2 o Vantage Vue con data logger, o un nodo EnviroMonitor.

1. Generar la clave v2 en weatherlink.com

Entra en weatherlink.com, abre la página Account y pulsa Generate v2 Key. Obtienes una API Key y un API Secret. El secreto no se comparte: la plataforma lo envía en la cabecera X-Api-Secret y nunca en la URL, para que no quede escrito en ningún registro. Davis lo explica en su guía de la API v2.

2. Obtener el station ID

Cada estación tiene un station ID numérico. La API lo devuelve en la llamada GET https://api.weatherlink.com/v2/stations?api-key=<tu API Key>, con el API Secret en la cabecera X-Api-Secret. Anota el station_id de cada estación que quieras conectar.

3. Configurar la integración en Gear Manager

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

• API v2 Key: la clave que generaste.
• API v2 Secret: el secreto de esa clave.
• Intervalo de consulta (minutos): cada cuánto se leen las estaciones. Por defecto, 5.

4. Dar de alta las estaciones

Crea un dispositivo por estación con:

• Modelo: el modelo de dispositivo de las estaciones Davis (código AWS-WEATHERLINK).
• Dirección: el station ID de la estación.

El script de parseo del modelo recibe el JSON de condiciones actuales. La respuesta llega en bloques de sensores, cada uno identificado por su sensor_type, y su forma cambia según el equipo que haya detrás de la cuenta. El script asigna cada valor a su endpoint y convierte las unidades, porque la API v2 responde siempre en unidades estadounidenses: °F a °C, inHg a hPa, pulgadas a mm y mph a m/s.

Límites de la API

Davis limita el uso a dos llamadas por segundo y 300 por hora por clave. La plataforma consulta las estaciones de una en una, con una pausa entre ellas, y hace una llamada por estación en cada pasada. Con el intervalo de 5 minutos son 12 llamadas por hora por estación, así que una misma clave alcanza para unas 25 estaciones. Si tienes más, sube el intervalo.

Histórico

Esta integración lee las condiciones actuales. No importa el histórico: WeatherLink solo lo sirve a estaciones con plan Pro, de 24 horas por llamada.

Comprobar que funciona

Pasado el intervalo de consulta, el dispositivo muestra su última lectura.