Telecomando Wireless Aqara Mini Switch (WXKG11LM): Battery reporting stuck at 100% e spegnimento improvviso

1. A cosa serve

La guida risolve il problema del report della batteria bloccato fisso al 100% sul pulsante wireless Aqara Mini Switch (WXKG11LM) che causa lo spegnimento improvviso ed inaspettato del telecomando senza preavviso.

2. Specifiche e compatibilità

Hardware: Aqara Wireless Mini Switch (WXKG11LM / WXKG12LM). Batteria: 1x CR2032 al litio 3V. Protocollo: Zigbee.

3. Materiali e prerequisiti necessari

Prerequisiti: 1. Batteria CR2032 nuova con tensione verificata > 3.0V. 2. Voltmeter o tester digitale (opzionale).

Fase 1: Preparazione

La curva di scarica delle batterie a bottone al litio CR2032 è quasi completamente piatta a 3.0V e crolla verticalmente a 2.5V in poche ore. Di conseguenza, l'algoritmo di conversione percentuale di default su ZHA o Z2M interpreta erroneamente la tensione piatta come 100%.

[SCHEMA GRAFICO: Curva di Scarica CR2032: Tensione 3.3V (100%) ---> Piattaforma 3.0V (Segnalata Erroneamente 100%) ---> Crollo < 2.7V (Spegnimento Improvviso)]

Crea un sensore Template che legga direttamente la tensione reale in Volt (sensor.aqara_switch_voltage) anziché la percentuale (%): sostituisci la batteria quando la tensione scende sotto i 2.75V!

Smaltisci le batterie a bottone esauste negli appositi contenitori di riciclo per evitare inquinamento da litio.

Fase 2: Configurazione

• Apri lo zoccolo posteriore del telecomando Aqara e sostituisci la batteria con una CR2032 nuova. 2. In Home Assistant, abilita l'entità nascosta della tensione in Volt (voltage). 3. Imposta una notifica di avviso basata sul valore della tensione in Volt.

Entità voltaggio: sensor.aqara_mini_switch_voltage (Soglia critica < 2.75V).

Fase 3: Automazione / Uso pratico

Sensore Template YAML per convertire la tensione Volt della batteria in un valore percentuale preciso:

template:
  - sensor:
      - name: "Batteria Aqara Switch Reale"
        unit_of_measurement: "%"
        device_class: battery
        state: >
          {% set v = states('sensor.aqara_mini_switch_voltage') | float(0) %}
          {% if v >= 3.00 %} 100
          {% elif v <= 2.50 %} 0
          {% else %} {{ ((v - 2.50) / 0.50 * 100) | round(0) }}
          {% endif %}

Automazione YAML per avviso di sostituzione batteria basato sui Volt:

alias: "Batteria - Sostituzione Tensione Aqara Switch"
trigger:
  - platform: numeric_state
    entity_id: sensor.aqara_mini_switch_voltage
    below: 2.75
action:
  - service: notify.mobile_app_smartphone
    data:
      title: "🪫 Batteria Aqara Scarica"
      message: "La tensione della batteria del pulsante Aqara è scesa a {{ states('sensor.aqara_mini_switch_voltage') }}V."

Verifica e test operativo

Premi il pulsante dell'Aqara Mini Switch: l'automazione associata deve scattare ed il sensore di tensione deve riportare un valore compreso tra 2.90V e 3.05V.

Il piccolo LED blu sul frontale del pulsante lampeggia una sola volta ad indicare l'invio del comando Zigbee.

Cosa fare se qualcosa non funziona

• Tensione non presente tra le entità: Abilitare le entità nascoste di ZHA da Impostazioni > Entità. 2. Pulsante non risponde: Pulire i contatti in metallo dell'alloggiamento batteria con un matchino asciutto. 3. Batteria si scarica in un mese: Il pulsante è rimasto in pairing continuo, eseguire un reset totale.

9. Sicurezza e privacy

Monitoraggio locale dello stato di alimentazione dei dispositivi di comando.

10. Requisiti e Risorse Ufficiali

Questa guida risolve una problematica tecnica di configurazione o sistema domotico. Di seguito i riferimenti alle documentazioni ufficiali:

* 🌐 Documentazione Ufficiale Home Assistant: [home-assistant.io/help](https://www.home-assistant.io/help/)

* 📦 Repository GitHub Troubleshooting: [github.com/home-assistant/core/issues](https://github.com/home-assistant/core/issues)

* 🛠️ Prerequisiti di sistema: Server Home Assistant OS aggiornato, connessione di rete LAN locale ed accesso Amministratore.