signalk-mareas-ihm 1.3.1 → 2.0.1

package/README.md

@@ -6,46 +6,65 @@
 
 ## Español
 
-Plugin de Signal K para **predicción de mareas en España** usando datos oficiales del **IHM (Instituto Hidrográfico de la Marina)**, con **Visor de Fondeo** integrado, alarmas inteligentes y soporte para domótica.
+Plugin de Signal K que convierte tu OpenPlotter / Raspberry Pi en un **visor completo de fondeo**: mareas oficiales del **IHM (Instituto Hidrográfico de la Marina)**, previsión de abrigo, medición de olas a bordo, alarmas inteligentes y soporte para domótica.
 
 ### Características principales
 
 #### Mareas
-- **Predicción de mareas** automática por GPS o selección manual de estación
-- **Curvas de marea interactivas** con HAT/LAT anuales, cursor interactivo y etiquetas de pleamar/bajamar
-- **Coeficientes oficiales IHM** con descarga automática
-- **Consejo táctico** para las Rías Baixas (experimental)
-- **Caché offline** de al menos 2 meses de predicciones
-
-#### Visor de Fondeo
-- **Mapa Leaflet** con posición GPS en tiempo real y capas múltiples (ESRI, Bing, Google, IHM S-52, SonarChart, MBTiles offline)
-- **Anchor Watch** con alarma de garreo visual y sonora
-- **Cadena largada** con slider bidireccional y cálculo automático
-- **Radio de borneo y alarma** con etiquetas en la carta
-- **Sincronización multi-dispositivo** en tiempo real (SSE)
-
-#### AIS Inteligente
-- **Detección de colisión** con targets AIS en zona de borneo
-- **ACK por target individual** — silencia alarma de un barco sin desactivar la alarma general
-- **Detección de garreo ajeno** — si un target ACKed se acerca >2m/min, la alarma se reactiva
-- **Estimación de ancla** de otros barcos mediante análisis de track (centroide + radio máximo)
-- **Anillos de colisión persistentes** en la carta
-
-#### Alarmas Inteligentes
-- **Alarma de varada** solo cuando el barco está parado (SOG < 0.5kn)
-- **Detección de sonda** congelada, inestable, fuera de rango
-- **Alarmas independientes** de garreo, AIS y sonda con control individual
-- **Previsión meteorológica** integrada (Open-Meteo) con múltiples modelos
+- **Predicción de mareas** automática por GPS o selección manual entre 70 estaciones del IHM.
+- **Curvas de marea interactivas** con HAT/LAT anuales, cursor y etiquetas de pleamar/bajamar.
+- **Coeficientes oficiales IHM** con descarga automática.
+- **Caché offline** de al menos 2 meses de predicciones.
+- **Tendencia y coeficiente** visibles en la barra superior del visor.
+
+#### Previsión de abrigo
+- **Rosa de 16 sectores** con detección automática del abrigo según la costa (OpenStreetMap).
+- **Grado A-F y porcentaje de protección** combinando viento y olas previstos.
+- **Strip de exposición** próximas 12 h con previsión hora a hora.
+- **Resumen "AHORA / PREDICCIÓN"** con datos en tiempo real de sensores y previsión.
+- **Edición manual** de sectores cuando el detector automático no convence.
+
+#### Medición de olas en fondeo
+- **Dirección, período y altura** de ola calculados a bordo desde sensores de actitud y aceleración (pypilot IMU u otros compatibles).
+- **Historial de las últimas 24 h** en barras de 15 minutos.
+- **El grado de abrigo se ajusta automáticamente** cuando la ola medida supera la prevista.
+
+#### Visor de fondeo
+- **Mapa Leaflet** con posición GPS en tiempo real y capas múltiples (ESRI, Bing, Google, IHM S-52, SonarChart, MBTiles offline).
+- **Anchor Watch** con alarma de garreo visual y sonora.
+- **Cadena largada** con slider bidireccional y cálculo automático (métodos tradicional y Vicente).
+- **Radio de borneo y alarma** con etiquetas en la carta y predicción según marea.
+- **Sincronización multi-dispositivo** en tiempo real (SSE).
+- **Cartas náuticas locales** vía servidor MBTiles integrado.
+
+#### Sensores en tiempo real
+- Lectura directa de **viento (veleta)**, **temperatura aire/agua** y **presión atmosférica** de Signal K.
+- Etiquetas **"Veleta"** y **"Sensor"** distinguen datos reales de previsión.
+- **Fallback automático a Open-Meteo** cuando un sensor falla.
+- **Sonda inteligente**: detecta congelación / spikes / valores absurdos y deja de mostrar lecturas inventadas.
+
+#### AIS inteligente
+- **Detección de colisión** con targets AIS en zona de borneo.
+- **ACK por target individual** — silencia alarma de un barco sin desactivar la alarma general.
+- **Detección de garreo ajeno** — si un target ACKed se acerca >2 m/min, la alarma se reactiva.
+- **Estimación de ancla** de otros barcos mediante análisis de track (centroide + radio máximo).
+
+#### Alarmas y audio
+- **Alarmas independientes**: garreo, varada, AIS y sonda con control individual.
+- **Voces pregrabadas (OGG)** por idioma — más naturales que el sintetizador.
+- **Detección automática** de la salida de audio del Raspberry Pi (USB → analog → HDMI).
+- **Soporte móvil** fiable (audio funciona incluso con la pestaña en segundo plano).
+- **Patrones distintos** por evento ("tuc tuc tuc" para AIS, sirena para garreo, etc.).
 
 #### Domótica / KIP
-- **Botones KIP** para fondear/levar y activar/desactivar alarmas
-- **Endpoints REST** para Alexa, Google Home, Node-RED, MQTT
-- **Endpoint toggle** para mandos a distancia con un solo botón
+- **Botones KIP** para fondear/levar y activar/desactivar alarmas.
+- **Endpoints REST** para Alexa, Google Home, Node-RED, MQTT.
+- **Endpoint toggle** para mandos a distancia con un solo botón.
 
 #### Bilingüe completo
-- Interfaz en **español e inglés** en todas las vistas
-- Idioma sincronizado entre Landing, Mareas y Visor de Fondeo
-- Banderas de idioma en la barra inferior del visor
+- Interfaz en **español e inglés** en todas las vistas.
+- Compass cardinal en español correcto (N/NE/E/SE/S/SO/O/NO).
+- Banderas de idioma en la barra inferior del visor.
 
 ### URLs
 
@@ -81,13 +100,13 @@ curl http://openplotter.local:3000/signalk-mareas-ihm/api/anchor-watch/simple
 
 ### Instalación
 
+Desde el **Signal K Appstore**: buscar `signalk-mareas-ihm` e instalar.
+
+O por línea de comandos:
+
 ```bash
-cd /home/pi
-unzip -o signalk-mareas-ihm_v1.3.1_RevXX.zip
-cd signalk-mareas-ihm
-npm install && npm run build && npm pack
 cd ~/.signalk
-npm install /home/pi/signalk-mareas-ihm/signalk-mareas-ihm-1.3.1.tgz --save
+npm install signalk-mareas-ihm@latest --save
 sudo systemctl restart signalk
 ```
 
@@ -95,46 +114,65 @@ sudo systemctl restart signalk
 
 ## English
 
-Signal K plugin for **Spanish tide predictions** using official data from **IHM (Instituto Hidrográfico de la Marina)**, with integrated **Anchor Watch Viewer**, smart alarms and home automation support.
+Signal K plugin that turns your OpenPlotter / Raspberry Pi into a **complete anchor watch viewer**: official Spanish tides from **IHM (Instituto Hidrográfico de la Marina)**, shelter forecast, on-board wave measurement, smart alarms and home automation support.
 
 ### Main Features
 
 #### Tides
-- **Automatic tide prediction** by GPS or manual station selection
-- **Interactive tide curves** with annual HAT/LAT, interactive cursor and high/low tide labels
-- **Official IHM coefficients** with automatic download
-- **Tactical advice** for the Rías Baixas (experimental)
-- **Offline cache** of at least 2 months of predictions
-
-#### Anchor Watch Viewer
-- **Leaflet map** with real-time GPS position and multiple layers (ESRI, Bing, Google, IHM S-52, SonarChart, offline MBTiles)
-- **Anchor Watch** with visual and audible drag alarm
-- **Chain deployed** with bidirectional slider and automatic calculation
-- **Swing and alarm radius** with chart labels
-- **Multi-device real-time sync** (SSE)
+- **Automatic tide prediction** by GPS or manual selection among 70 IHM stations.
+- **Interactive tide curves** with annual HAT/LAT, cursor and high/low tide labels.
+- **Official IHM coefficients** with automatic download.
+- **Offline cache** of at least 2 months of predictions.
+- **Tendency and coefficient** visible in the viewer's top bar.
+
+#### Shelter forecast
+- **16-sector rose** with automatic shelter detection from coastline (OpenStreetMap).
+- **Grade A-F and protection percentage** combining forecast wind and waves.
+- **12 h exposure strip** with hourly forecast.
+- **"NOW / FORECAST" summary** with real-time sensor and forecast data.
+- **Manual sector override** when the automatic detector is wrong.
+
+#### On-board wave measurement
+- **Direction, period and height** of waves computed on board from attitude and acceleration sensors (pypilot IMU or compatible).
+- **24 h history** in 15-minute bars.
+- **Shelter grade auto-adjusts** when measured wave exceeds forecast.
+
+#### Anchor watch viewer
+- **Leaflet map** with real-time GPS position and multiple layers (ESRI, Bing, Google, IHM S-52, SonarChart, offline MBTiles).
+- **Anchor Watch** with visual and audible drag alarm.
+- **Chain deployed** with bidirectional slider and automatic calculation (traditional and Vicente methods).
+- **Swing and alarm radius** with chart labels and tide-aware prediction.
+- **Multi-device real-time sync** (SSE).
+- **Local nautical charts** via integrated MBTiles server.
+
+#### Real-time sensors
+- Direct reading of **wind (anemometer)**, **air/water temperature** and **atmospheric pressure** from Signal K.
+- **"Veleta"** and **"Sensor"** badges distinguish real data from forecast.
+- **Automatic Open-Meteo fallback** when a sensor drops.
+- **Smart depth sounder**: detects frozen / spike / absurd values and stops showing made-up readings.
 
 #### Smart AIS
-- **Collision detection** with AIS targets in swing zone
-- **Per-target ACK** — silence alarm for one boat without disabling the general alarm
-- **External dragging detection** — if an ACKed target approaches >2m/min, alarm reactivates
-- **Anchor estimation** for other boats via track analysis (centroid + max radius)
-- **Persistent collision rings** on chart
-
-#### Smart Alarms
-- **Grounding alarm** only when boat is stopped (SOG < 0.5kn)
-- **Sounder detection** for frozen, unstable, out-of-range readings
-- **Independent alarms** for drag, AIS and depth with individual control
-- **Weather forecast** integrated (Open-Meteo) with multiple models
+- **Collision detection** with AIS targets in swing zone.
+- **Per-target ACK** — silence alarm for one boat without disabling the general alarm.
+- **External dragging detection** — if an ACKed target approaches >2 m/min, alarm reactivates.
+- **Anchor estimation** for other boats via track analysis (centroid + max radius).
+
+#### Alarms and audio
+- **Independent alarms**: drag, grounding, AIS and depth with individual control.
+- **Pre-recorded voices (OGG)** per language — more natural than synthesizer.
+- **Automatic detection** of Raspberry Pi audio output (USB → analog → HDMI).
+- **Reliable mobile support** (audio works even when the tab is in background).
+- **Distinct patterns** per event (rapid beep for AIS, siren for drag, etc.).
 
 #### Home Automation / KIP
-- **KIP buttons** for drop/lift and alarm enable/disable
-- **REST endpoints** for Alexa, Google Home, Node-RED, MQTT
-- **Toggle endpoint** for single-button remote controls
+- **KIP buttons** for drop/lift and alarm enable/disable.
+- **REST endpoints** for Alexa, Google Home, Node-RED, MQTT.
+- **Toggle endpoint** for single-button remote controls.
 
 #### Full Bilingual
-- Interface in **Spanish and English** across all views
-- Language synced between Landing, Tides and Anchor Watch Viewer
-- Language flags in the viewer's bottom bar
+- Interface in **Spanish and English** across all views.
+- Correct Spanish cardinal compass (N/NE/E/SE/S/SO/O/NO).
+- Language flags in the viewer's bottom bar.
 
 ### URLs
 
@@ -162,16 +200,16 @@ curl http://openplotter.local:3000/signalk-mareas-ihm/api/anchor-watch/simple
 
 ### Installation
 
+From the **Signal K Appstore**: search `signalk-mareas-ihm` and install.
+
+Or via command line:
+
 ```bash
-cd /home/pi
-unzip -o signalk-mareas-ihm_v1.3.1_RevXX.zip
-cd signalk-mareas-ihm
-npm install && npm run build && npm pack
 cd ~/.signalk
-npm install /home/pi/signalk-mareas-ihm/signalk-mareas-ihm-1.3.1.tgz --save
+npm install signalk-mareas-ihm@latest --save
 sudo systemctl restart signalk
 ```
 
 ---
 
-© IHM — Datos oficiales del Instituto Hidrográfico de la Marina de España
+© IHM — Official data from Spain's Instituto Hidrográfico de la Marina

package/dist/build-info.json

@@ -0,0 +1,7 @@
+{
+  "version": "2.0.1",
+  "timestamp": "20260522-2344",
+  "gitHash": null,
+  "gitDirty": true,
+  "builtAt": "2026-05-22T21:44:05.250Z"
+}