feature-discovery/org.meshtastic.feature.discovery/DiscoveryScanEngine

DiscoveryScanEngine

class DiscoveryScanEngine(radioController: RadioController, serviceRepository: ServiceRepository, nodeRepository: NodeRepository, radioConfigRepository: RadioConfigRepository, collectorRegistry: DiscoveryPacketCollectorRegistry, discoveryDao: DiscoveryDao, aiProvider: DiscoverySummaryAiProvider, applicationScope: ApplicationCoroutineScope, dispatchers: CoroutineDispatchers, meshPrefs: MeshPrefs) : DiscoveryPacketCollector(source)

Core scan engine for Local Mesh Discovery.

Cycles through a queue of LoRa presets, dwells on each for a configured duration while collecting packets, then persists aggregated results via DiscoveryDao.

Constructors

DiscoveryScanEngine

constructor(radioController: RadioController, serviceRepository: ServiceRepository, nodeRepository: NodeRepository, radioConfigRepository: RadioConfigRepository, collectorRegistry: DiscoveryPacketCollectorRegistry, discoveryDao: DiscoveryDao, aiProvider: DiscoverySummaryAiProvider, applicationScope: ApplicationCoroutineScope, dispatchers: CoroutineDispatchers, meshPrefs: MeshPrefs)

Types

Companion

object Companion

Properties

currentSession

val currentSession: StateFlow<DiscoverySessionEntity?>

isActive

open override val isActive: Boolean

scanState

val scanState: StateFlow<DiscoveryScanState>

Functions

onPacketReceived

open suspend override fun onPacketReceived(meshPacket: MeshPacket, dataPacket: DataPacket)

reset

fun reset()

Resets engine state after the UI has acknowledged completion.

restoreInterruptedSessionsOnReconnect

suspend fun restoreInterruptedSessionsOnReconnect(onRestored: suspend (homePreset: String) -> Unit = {})

Watches reconnects for persisted discovery sessions left without a confirmed home-radio restore. Recovery is device-bound and skipped while this engine owns an active scan.

startScan

suspend fun startScan(presets: List<ChannelOption>, dwellDurationSeconds: Long)

Convenience overload: scan a list of public presets (each becomes a preset ScanTarget labelled by name).

startScanTargets

suspend fun startScanTargets(targets: List<ScanTarget>, dwellDurationSeconds: Long)

Starts a discovery scan across the given targets — public presets and/or beacon-advertised custom channels. (Distinct name from the ChannelOption overload: both would erase to the same JVM signature otherwise.)

stopScan

suspend fun stopScan()

Stops the active scan and restores the home preset.