Skip to content

logbook: expose hop_count and snr on incoming channel messages#245

Open
jagoda wants to merge 1 commit into
meshcore-dev:mainfrom
jagoda:meshcore-ha-port-215-pattern-to-channel-handler-20260520-000343375
Open

logbook: expose hop_count and snr on incoming channel messages#245
jagoda wants to merge 1 commit into
meshcore-dev:mainfrom
jagoda:meshcore-ha-port-215-pattern-to-channel-handler-20260520-000343375

Conversation

@jagoda
Copy link
Copy Markdown

@jagoda jagoda commented May 20, 2026

Ports the direct-message hop_count/snr exposure pattern from PR #215 (handle_contact_message) to handle_channel_message. The SDK reader emits the same path_len semantics on both CONTACT_MSG_RECV and CHANNEL_MSG_RECV frames (0xFF sentinel for direct reception, otherwise literal hop count), and V3 CHANNEL_MSG_RECV frames carry SNR directly. V2 channel frames only surface SNR via the log_channels lookup, so snr is emitted only when the SDK actually populated it — matching the contact handler's behavior.

docs/events.md: document hop_count (always) and snr (conditional) on the channel-message branch of meshcore_message.

No firmware changes; downstream listeners already consuming hop_count/snr on direct messages can now use the same fields on channel messages.

Ports the direct-message hop_count/snr exposure pattern from PR meshcore-dev#215
(handle_contact_message) to handle_channel_message. The SDK reader emits
the same path_len semantics on both CONTACT_MSG_RECV and CHANNEL_MSG_RECV
frames (0xFF sentinel for direct reception, otherwise literal hop count),
and V3 CHANNEL_MSG_RECV frames carry SNR directly. V2 channel frames only
surface SNR via the log_channels lookup, so snr is emitted only when the
SDK actually populated it — matching the contact handler's behavior.

docs/events.md: document hop_count (always) and snr (conditional) on the
channel-message branch of meshcore_message.

No firmware changes; downstream listeners already consuming hop_count/snr
on direct messages can now use the same fields on channel messages.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant