testing/org.meshtastic.sdk.testing/FakeRadioTransport

FakeRadioTransport

class FakeRadioTransport(val identity: TransportIdentity, frames: List<Frame> = emptyList(), val autoHandshake: Boolean = false, val nodeNum: Int = DEFAULT_FAKE_NODE_NUM) : RadioTransport(source)

In-memory, script-driven RadioTransport for testing.

Allows tests to replay captured frames and control connection state deterministically.

When autoHandshake is true, the transport automatically responds to the two-stage Meshtastic handshake (want_config_id 69420 / 69421) and the get_owner_request admin message, enabling RadioClient.connect to complete without a real radio. The synthesized MyNodeInfo.my_node_num defaults to 1; pass nodeNum to simulate a different identity (e.g. for identity-rebind tests).

Constructors

FakeRadioTransport

constructor(identity: TransportIdentity, frames: List<Frame> = emptyList(), autoHandshake: Boolean = false, nodeNum: Int = DEFAULT_FAKE_NODE_NUM)

Properties

autoHandshake

val autoHandshake: Boolean

When true, automatically responds to handshake ToRadio messages so RadioClient.connect can complete without a real radio.

identity

open override val identity: TransportIdentity

nodeNum

val nodeNum: Int

MyNodeInfo.my_node_num to report during the auto-handshake.

state

open override val state: StateFlow<TransportState>

Functions

connect

open suspend override fun connect()

disconnect

open suspend override fun disconnect()

frames

open override fun frames(): Flow<Frame>

injectAdminResponse

fun injectAdminResponse(requestId: Int, response: AdminMessage, fromNode: Int = nodeNum)

Inject an admin response packet correlated to requestId. The packet is constructed with decoded.request_id = requestId so the engine's CommandDispatcher / processRoutingAck can match it against an outstanding request.

injectFrame

fun injectFrame(frame: Frame)

Inject an arbitrary frame as if received from the radio.

injectNeighborInfoResponse

fun injectNeighborInfoResponse(requestId: Int, info: NeighborInfo, fromNode: Int = nodeNum)

Inject a NeighborInfo response correlated to requestId.

injectRouteReply

fun injectRouteReply(requestId: Int, reply: RouteDiscovery, fromNode: Int = nodeNum)

Inject a Routing.route_reply correlated to requestId.

injectRoutingAck

fun injectRoutingAck(requestId: Int, fromNode: Int = nodeNum)

Inject a Routing.Ack correlated to requestId (setter ack-style tests).

injectRoutingError

fun injectRoutingError(requestId: Int, error: Routing.Error, fromNode: Int = nodeNum)

Inject a Routing error correlated to requestId (failure-mapping tests).

injectTelemetryResponse

fun injectTelemetryResponse(requestId: Int, telemetry: Telemetry, fromNode: Int = nodeNum)

Inject a Telemetry response packet correlated to requestId.

outboundFrames

fun outboundFrames(): List<Frame>

Frames that were sent via send.

outboundPackets

fun outboundPackets(): List<MeshPacket>

Decoded view of every outbound MeshPacket sent by the engine since connect. Strips the 4-byte stream-framing header and re-decodes each Frame into a ToRadio envelope, then surfaces packets that targeted ADMIN_APP / TELEMETRY_APP / ROUTING_APP / NEIGHBORINFO_APP.

send

open suspend override fun send(frame: Frame)

simulateError

fun simulateError(cause: Throwable, recoverable: Boolean = true)

Transition to an error state.