Services

The Meshcore Home Assistant integration provides several services to interact with your mesh network, from sending messages to executing advanced commands.

Available Services

Send Message

Send a direct message to a specific node in the mesh network.

Service: meshcore.send_message

Fields:

Field	Type	Required	Description
node_id	string	One required*	The name of the node to send to
pubkey_prefix	string	One required*	Public key prefix (min 6 chars)
message	string	Yes	The message text to send
entry_id	string	No	Config entry ID for multiple devices

*Either node_id or pubkey_prefix is required, not both.

Examples:

Using node name:

service: meshcore.send_message
data:
  node_id: "Weather Station"
  message: "Request status update"

Using public key prefix:

service: meshcore.send_message
data:
  pubkey_prefix: "f293ac"
  message: "Hello from Home Assistant!"

Send Channel Message

Broadcast a message to all nodes on a specific channel.

Service: meshcore.send_channel_message

Fields:

Field	Type	Required	Description
channel_idx	integer	Yes	Channel index (0-255, typically 0-3)
message	string	Yes	The message text to broadcast
entry_id	string	No	Config entry ID for multiple devices

Example:

service: meshcore.send_channel_message
data:
  channel_idx: 0
  message: "General announcement to all nodes"

Execute Command

Execute Meshcore SDK commands directly for advanced control.

Service: meshcore.execute_command

Fields:

Field	Type	Required	Description
command	string	Yes	Command with parameters
entry_id	string	No	Config entry ID for multiple devices

Common Commands:

• get_bat - Get battery level
• set_name "NewName" - Set node name
• set_tx_power 20 - Set transmit power (dBm)
• send_msg "NodeName" "Message" - Send direct message
• send_chan_msg 0 "Message" - Send channel message
• reboot - Reboot the node

For a complete list of available commands and their parameters, see the Meshcore Python SDK documentation.

Examples:

Set transmit power:

service: meshcore.execute_command
data:
  command: "set_tx_power 15"

Send message with command:

service: meshcore.execute_command
data:
  command: 'send_msg "Repeater1" "Status check"'

Send UI Message

Send messages using the UI helper entities. This service reads values from the Meshcore UI helpers.

Service: meshcore.send_ui_message

Fields:

Field	Type	Required	Description
entry_id	string	No	Config entry ID for multiple devices

This service automatically reads from:

• select.meshcore_recipient_type - Channel or Contact
• select.meshcore_channel - Selected channel
• select.meshcore_contact - Selected contact
• text.meshcore_message - Message text

Example:

service: meshcore.send_ui_message
data: {}

Execute Command UI

Execute commands from the UI text input helper.

Service: meshcore.execute_command_ui

Fields:

Field	Type	Required	Description
entry_id	string	No	Config entry ID for multiple devices

This service reads from text.meshcore_command and clears it after execution.

Example:

service: meshcore.execute_command_ui
data: {}

Usage in Automations

Battery Check Automation

alias: Daily Battery Check
trigger:
  - platform: time
    at: "09:00:00"
action:
  - service: meshcore.execute_command
    data:
      command: "get_bat"
  - delay:
      seconds: 5
  - service: meshcore.send_channel_message
    data:
      channel_idx: 0
      message: "Daily battery check completed"

Emergency Broadcast

alias: Emergency Alert
trigger:
  - platform: state
    entity_id: input_boolean.emergency_mode
    to: "on"
action:
  - service: meshcore.send_channel_message
    data:
      channel_idx: 0
      message: "EMERGENCY ALERT ACTIVATED"
  - service: meshcore.execute_command
    data:
      command: "set_tx_power 20"

Periodic Status Request

alias: Hourly Status Check
trigger:
  - platform: time_pattern
    hours: "*"
    minutes: "0"
action:
  - service: meshcore.send_message
    data:
      node_id: "Remote Sensor"
      message: "STATUS?"

Service Events

The meshcore_message_sent event is fired when a message is successfully sent, which can be monitored in automations:

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

Troubleshooting

Message Not Sent

• Verify the node name or public key exists in contacts
• Check that the Meshcore device is connected
• Ensure the target node is within range

Command Failed

• Verify command syntax and parameters
• Check that the command is supported by your device
• Review Home Assistant logs for detailed error messages

UI Services Not Working

• Ensure helper entities are created and have values
• Check that the Meshcore integration is properly configured
• Verify the device is connected and responding