Skip to main content

Automation

The Meshcore Home Assistant integration provides rich automation capabilities through events, services, and sensors.

Message Automations​

Forward Messages to Push Notifications​

Forward all Meshcore messages to your mobile device:

alias: Meshcore Forward to Push
description: "Forwards all MeshCore messages to a push notification"
triggers:
  - trigger: event
    event_type: meshcore_message
actions:
  - action: notify.notify
    data:
      message: >-
        {% if trigger.event.data.channel is defined %}
          Channel {{ trigger.event.data.channel }}: {{ trigger.event.data.sender_name }}: {{ trigger.event.data.message }}
        {% else %}
          {{ trigger.event.data.sender_name }}: {{ trigger.event.data.message }}
        {% endif %}
mode: single

Channel-Specific Notifications​

Monitor only specific channels:

alias: Channel 0 Messages Only
trigger:
  - platform: event
    event_type: meshcore_message
    event_data:
      message_type: "channel"
      channel_idx: 0
action:
  - service: notify.notify
    data:
      message: "Ch0: {{ trigger.event.data.message }}"

Filter Messages by Sender​

Get notifications only from specific nodes:

alias: Messages from Specific Node
trigger:
  - platform: event
    event_type: meshcore_message
condition:
  - condition: template
    value_template: "{{ 'f293ac' in trigger.event.data.pubkey_prefix }}"
action:
  - service: notify.notify
    data:
      message: "{{ trigger.event.data.sender_name }}: {{ trigger.event.data.message }}"

Network Maintenance​

Scheduled Advertisement Broadcasting​

Keep your node discoverable by sending periodic advertisements:

alias: MeshCore Scheduled Advertisement
description: "Sends a MeshCore advertisement broadcast every 15 minutes"
trigger:
  - platform: time_pattern
    minutes: "/15"  # Every 15 minutes
action:
  - service: meshcore.execute_command
    data:
      command: "send_advert"
      kwargs: {}
mode: single

Sensor Monitoring​

Temperature Alerts​

Monitor environmental sensors from telemetry:

alias: High Temperature Alert
trigger:
  - platform: numeric_state
    entity_id: sensor.meshcore_def456_sensor1_ch1_temperature
    above: 30
action:
  - service: notify.notify
    data:
      message: "Temperature alert: {{ states(trigger.entity_id) }}°C"

Repeater Battery Monitoring​

Monitor repeater stations for low battery:

alias: Repeater Low Battery
trigger:
  - platform: numeric_state
    entity_id: sensor.meshcore_abc123_repeater1_battery_percentage
    below: 20
action:
  - service: notify.notify
    data:
      title: "Repeater Battery Low"
      message: "{{ state_attr(trigger.entity_id, 'friendly_name') }} at {{ states(trigger.entity_id) }}%"

Connection Monitoring​

Node Offline Detection​

Get notified when nodes stop responding:

alias: Node Went Offline
trigger:
  - platform: state
    entity_id: sensor.meshcore_abc123_repeater1_uptime
    to: 'unavailable'
    for:
      minutes: 10
action:
  - service: notify.notify
    data:
      title: "Node Offline"
      message: "{{ state_attr(trigger.entity_id, 'friendly_name') }} is not responding"

Connection Status Monitoring​

Track when your Meshcore device connects or disconnects:

alias: Connection Monitor
trigger:
  - platform: event
    event_type: meshcore_connected
  - platform: event
    event_type: meshcore_disconnected
action:
  - service: persistent_notification.create
    data:
      title: "Meshcore Status"
      message: "Device {{ 'connected' if trigger.event.event_type == 'meshcore_connected' else 'disconnected' }}"

Signal Quality​

Poor Signal Alert​

Monitor signal quality and alert on degradation using RX_LOG data:

alias: Poor Signal Alert
trigger:
  - platform: event
    event_type: meshcore_message
    event_data:
      message_type: "channel"
condition:
  - condition: template
    value_template: >
      {{ trigger.event.data.rx_log_data is defined and
         trigger.event.data.rx_log_data | selectattr('snr', 'lt', 5) | list | length > 0 }}
action:
  - service: notify.notify
    data:
      title: "Poor Signal Quality"
      message: >
        Message from {{ trigger.event.data.sender_name }} had poor signal:
        {% for rx in trigger.event.data.rx_log_data %}
        Path {{ rx.path_len }} hops: SNR {{ rx.snr }}dB, RSSI {{ rx.rssi }}
        {% endfor %}

Multi-Path Reception Monitoring​

Track when messages are received via multiple mesh routes:

alias: Multi-Path Message Detection
trigger:
  - platform: event
    event_type: meshcore_message
    event_data:
      message_type: "channel"
condition:
  - condition: template
    value_template: "{{ trigger.event.data.rx_log_data | length > 1 }}"
action:
  - service: logbook.log
    data:
      name: "Mesh Routing"
      message: >
        Message received via {{ trigger.event.data.rx_log_data | length }} paths:
        {% for rx in trigger.event.data.rx_log_data %}
        - {{ rx.path_len }} hops ({{ rx.path }}): SNR {{ rx.snr }}dB
        {% endfor %}

Direct Path Messages Only​

Get notifications only for messages received directly (no hops):

alias: Direct Path Messages
trigger:
  - platform: event
    event_type: meshcore_message
    event_data:
      message_type: "channel"
condition:
  - condition: template
    value_template: >
      {{ trigger.event.data.rx_log_data is defined and
         trigger.event.data.rx_log_data | selectattr('path_len', 'eq', 0) | list | length > 0 }}
action:
  - service: notify.notify
    data:
      message: "Direct: {{ trigger.event.data.sender_name }}: {{ trigger.event.data.message }}"

Raw Event Monitoring​

Battery Event Tracking​

Monitor battery updates from the raw event stream:

alias: Battery Monitor
trigger:
  - platform: event
    event_type: meshcore_raw_event
    event_data:
      event_type: "EventType.BATTERY"
action:
  - service: notify.notify
    data:
      message: "Battery: {{ (trigger.event.data.payload.level / 1000) | round(2) }}V"

Message Logging​

Log Sent Messages​

Keep track of all messages sent through the integration:

alias: Log Sent Messages
trigger:
  - platform: event
    event_type: meshcore_message_sent
action:
  - service: logbook.log
    data:
      name: "Sent"
      message: "{{ trigger.event.data.message_type }}: {{ trigger.event.data.message }}"

Tips for Automations​

  1. Use Event Filters: Filter events in the trigger to reduce processing
  2. Check Conditions: Use conditions to further refine when automations run
  3. Mode Selection: Use mode: single to prevent duplicate executions
  4. Template Sensors: Create template sensors for complex calculations
  5. Combine Triggers: Use multiple triggers for related events

Advanced Automation​

For complex contact management and automation workflows, see the community example: Meshcore Contact Management in Home Assistant

  • Events - Complete event reference
  • Services - Available services for automations
  • Sensors - Sensor entities for triggers
  • Messaging - Message handling details