Jump to content

SimTX API v24/Packets/ReceiverRetune

From SimTX Wiki
Revision as of 16:16, 24 October 2026 by Clanker (talk | contribs) (Archive the v24 protocol reference: use the v24 templates, links and categories)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
This page documents protocol v24, which current servers no longer accept. See SimTX API for v25.
v24 overviewQuick startAccount serviceHandshakeAll packetsData typesLimits and errorsCurrent reference (v25)
ReceiverRetune
Packet ID 13(0x0D)
Direction Client → server
Session Receiver
Body size 4 bytes
Permission None
Answered by
Answers

ReceiverRetune moves a running receiver to a new centre frequency without reconnecting. It is the only packet a client may send on a receiver connection after the ReceiverSessionRequest.

Layout[edit | edit source]

Field Type Description
packetId u8 Always 13.
centerFreqHz f32 New centre frequency in hertz. Finite and ≥ 0.

Behaviour[edit | edit source]

  • There is no acknowledgement and no new IqStreamDescriptor. Sample rate, block size and bandwidth stay the same.
  • The new frequency takes effect after a settling time of about 120 ms. Retunes received during that time are coalesced; only the latest is applied.
  • Expect a short gap or transient in the stream around the change.
  • A negative or non-finite frequency closes the connection. So does any packet other than ReceiverRetune.

Example[edit | edit source]

0D              packetId 13
4A 0C 61 80     centerFreqHz 2300000.0

See also[edit | edit source]

SimTX API v24 reference (protocol v24, archived)
Start OverviewQuick startData typesLimits and errorsPacket list
Account service OverviewDevice loginServer directoryGame ticketsPermissionsPublic endpoints
Game protocol Connection and handshakeReceiver sessionTransmitter sessionControl sessionCatalogModeration
Handshake HandshakeHandshakeResult
Receiver ReceiverSessionRequestReceiverRetuneForwardedClientAddressIqStreamDescriptorIqBlockTimedIqBlock
Transmitter TransmitterSessionRequestSampleBlockTxModeInfoTxUpdateTxQueueTxAcceptTxRejectTxKickTxTelemetryTxUpdateAck
Control ControlAckBannerListStationsStationListServerHealthRequestServerHealthReportCoverageMapRequestCoverageMapResponseWeatherMapRequestWeatherMapResponseStartMonitorStopMonitorMonitorBlockMonitorEnd
Catalog CatalogListRequestCatalogListCatalogFetchCatalogEntryCatalogUploadCatalogUploadResultCatalogDeleteCatalogDeleteResult
Moderation KickRequestKickResultIpModerationRequestIpModerationResultBroadcastBannerModerationErrorStationImpactList
Current Protocol v25 reference
Retrieved from "https://wiki.simtx.net/index.php?title=SimTX_API_v24/Packets/ReceiverRetune&oldid=2205"