MeshCore

MeshCore Setup

• Connection Type

Also asked when changing the connection.

Configure USB Connection

• USB Device Path
• Connection Speed
• Enable Self Telemetry
• Self Telemetry Interval (seconds)
• Enable Self DiagnosticsCreates 14 diagnostic sensors for the companion: uptime, TX queue length, noise floor, last RSSI and SNR, TX and RX airtime, and packet counters. Off by default. These are local queries to the companion and send nothing on the mesh. The interval sets how often the sensors update (60 to 3600 seconds).
• Self Diagnostics Interval (seconds)
• Contact Discovery ModeEntity per contact: every discovered contact gets its own entity (best for small meshes). Data only: discovered contacts are tracked as data only with no per-contact entity -- inspect them via the dropdown or the Get Discovered Contact service. Disabled: contact discovery is turned off entirely and any existing discovered contacts are cleared.

Configure Bluetooth Connection

• Bluetooth Device
• Enable Self Telemetry
• Self Telemetry Interval (seconds)
• Enable Self DiagnosticsCreates 14 diagnostic sensors for the companion: uptime, TX queue length, noise floor, last RSSI and SNR, TX and RX airtime, and packet counters. Off by default. These are local queries to the companion and send nothing on the mesh. The interval sets how often the sensors update (60 to 3600 seconds).
• Self Diagnostics Interval (seconds)
• Contact Discovery ModeEntity per contact: every discovered contact gets its own entity (best for small meshes). Data only: discovered contacts are tracked as data only with no per-contact entity -- inspect them via the dropdown or the Get Discovered Contact service. Disabled: contact discovery is turned off entirely and any existing discovered contacts are cleared.

Configure Network Connection

• Host Address
• Port
• Enable Self Telemetry
• Self Telemetry Interval (seconds)
• Enable Self DiagnosticsCreates 14 diagnostic sensors for the companion: uptime, TX queue length, noise floor, last RSSI and SNR, TX and RX airtime, and packet counters. Off by default. These are local queries to the companion and send nothing on the mesh. The interval sets how often the sensors update (60 to 3600 seconds).
• Self Diagnostics Interval (seconds)
• Contact Discovery ModeEntity per contact: every discovered contact gets its own entity (best for small meshes). Data only: discovered contacts are tracked as data only with no per-contact entity -- inspect them via the dropdown or the Get Discovered Contact service. Disabled: contact discovery is turned off entirely and any existing discovered contacts are cleared.

Reconfigure USB Connection

• USB Device Path
• Connection Speed

Reconfigure Bluetooth Connection

• Bluetooth Device

Reconfigure Network Connection

• Host Address
• Port

After setup

• Choose an action
• Available Repeaters
• Repeater Password
• Enable Telemetry Polling
• Enable Neighbor Entities (creates SNR and activity sensors for each neighbor seen by the repeater)Asks this repeater for its neighbour list after each successful status poll. Each neighbour gets an SNR sensor and a seen sensor. The list is paged: each page is one request, so the cost grows with the number of neighbours. Requires MeshCore firmware 1.14.0 or later.
• Telemetry Refresh Rate (seconds)
• Disable Path Reset
• PasswordSent once to log in to the repeater. Leave blank for a repeater that grants access by ACL without a password.
• Available Clients
• Update Frequency (seconds)
• Disable Path Reset
• Select Device
• Action
• Update Password (leave blank to keep current)
• Enable Telemetry Polling
• Enable Neighbor Entities (creates SNR and activity sensors for each neighbor seen by the repeater)Asks this repeater for its neighbour list after each successful status poll. Each neighbour gets an SNR sensor and a seen sensor. The list is paged: each page is one request, so the cost grows with the number of neighbours. Requires MeshCore firmware 1.14.0 or later.
• Telemetry Refresh Rate (seconds)
• Disable Path Reset
• Disable Device
• Update Password (leave blank to keep current)Stored passwords are never shown. Leave this blank to keep the saved password; type a new one to replace it.
• Update Frequency (seconds)
• Disable Path Reset
• Disable Device
• Contact Discovery ModeEntity per contact: every discovered contact gets its own entity (best for small meshes). Data only: discovered contacts are tracked as data only with no per-contact entity -- inspect them via the dropdown or the Get Discovered Contact service. Disabled: contact discovery is turned off entirely and any existing discovered contacts are cleared.
• Limit Discovered Contacts
• Maximum Discovered Contacts
• Enable Self Telemetry
• Self Telemetry Interval (seconds)
• Enable Self DiagnosticsCreates 14 diagnostic sensors for the companion: uptime, TX queue length, noise floor, last RSSI and SNR, TX and RX airtime, and packet counters. Off by default. These are local queries to the companion and send nothing on the mesh. The interval sets how often the sensors update (60 to 3600 seconds).
• Self Diagnostics Interval (seconds)
• Enable CLI ConsoleAdds a CLI Console sensor. It records each command that you run with execute_command or execute_command_ui when record_to_console is on, and the response. It shows only command and response pairs, not the device log. Off by default. Use it with the text.meshcore_command helper and a Markdown card. The documentation has an example dashboard.
• Enable Map Auto Uploader (map.meshcore.io)Uploads the adverts that you receive from repeaters, room servers and sensor nodes to map.meshcore.io. Those nodes then show on the MeshCore community map. The firmware must allow private key export (ENABLE_PRIVATE_KEY_EXPORT=1). Without it, the integration cannot sign the uploads.
• Auto-Cleanup Stale Discovered Contacts (runs daily)When enabled, discovered contacts whose last update is older than the configured threshold are automatically removed once per day. Contacts saved to the node are always preserved.
• Stale Contact Threshold (days)
• Auto-Remove Stale NeighborsAutomatically remove neighbor entries and their sensor entities when they haven't been heard from in the configured number of days.
• Stale Neighbor Threshold (days)Number of days without hearing a neighbor before it is automatically removed (1–365).
• Retrieve queued incoming messagesEnabled by default. Turn off when another client, such as a phone over BLE, should retrieve queued channel and direct messages. Home Assistant keeps polling repeater status and telemetry and can still send commands. Messages delivered by the device may still appear in Home Assistant; this setting controls queue retrieval, not message visibility. Text replies to commands may also remain queued for the other client.
• Adaptive Channel Message DeliveryWhen enabled, incoming channel messages fire as soon as RX_LOG data arrives (typically ~50ms) instead of always waiting the full 500ms. Late-arriving repeater data is delivered progressively. Disable if bots or automations depend on having all paths in the initial event.
• Broker
• Action