Clanker: Protocol v25 reference: StationImpactList

2026-10-24T17:01:50Z

Protocol v25 reference: StationImpactList

← Older revision		Revision as of 17:01, 24 October 2026
Line 1:		Line 1:
	#~~REDIRECT~~ [[SimTX API ~~v24~~/Packets/~~StationImpactList~~]]		{{SimTX API navigation}}
			{{SimTX packet
			\| name = StationImpactList
			\| frame = ServerFrame
			\| field = 63
			\| member = station_impacts
			\| direction = s2c
			\| session = [[SimTX API/Moderation session\|Moderation]]
			\| roles = <code>ROLE_MODERATION</code>.
			\| permission = None
			\| answers = [[SimTX API/Packets/ListStations\|ListStations]]
			\| group = moderation
			\| file = control.proto
			}}
			'''StationImpactList''' is an interference analysis for moderators. On a [[SimTX API/Moderation session\|moderation session]] the server sends it right after the [[SimTX API/Packets/StationList\|StationList]] that answers a [[SimTX API/Packets/ListStations\|ListStations]]. It ranks transmitters by how much they affect receivers, which helps to find jammers and badly configured stations.

			== Definition ==
			<syntaxhighlight lang="protobuf">
			message StationImpactList { int64 request_id = 1; repeated TransmitterImpact impacts = 2; }
			</syntaxhighlight>

			== Fields ==
			{\| class="wikitable"
			! # !! Field !! Type !! Description
			\|-
			\| 1 \|\| <code>request_id</code> \|\| <code>int64</code> \|\| The [[SimTX API/Packets/ListStations\|ListStations]] <code>request_id</code>.
			\|-
			\| 2 \|\| <code>impacts</code> \|\| <code>repeated</code> [[#TransmitterImpact\|TransmitterImpact]] \|\| One entry per transmitter, highest impact first.
			\|}

			=== TransmitterImpact ===
			<syntaxhighlight lang="protobuf">
			message TransmitterImpact {
			bytes session_id = 1;
			string callsign = 2;
			string address = 3;
			double frequency_hz = 4;
			string modulation = 5; // string enum (common.proto)
			float power_watts = 6;
			float occupied_bandwidth_hz = 7;
			float impact_score = 8;
			int32 affected_receivers = 9;
			float nearest_receiver_km = 10;
			string reasons = 11;
			}
			</syntaxhighlight>
			{\| class="wikitable"
			! # !! Field !! Type !! Description
			\|-
			\| 1 \|\| <code>session_id</code> \|\| <code>bytes</code> \|\| 16-byte transmission id.
			\|-
			\| 2 \|\| <code>callsign</code> \|\| <code>string</code> \|\| Callsign.
			\|-
			\| 3 \|\| <code>address</code> \|\| <code>string</code> \|\| Client address.
			\|-
			\| 4 \|\| <code>frequency_hz</code> \|\| <code>double</code> \|\| Carrier frequency, Hz.
			\|-
			\| 5 \|\| <code>modulation</code> \|\| <code>string</code> \|\| [[SimTX API/Data types#Modulation\|Modulation]] name.
			\|-
			\| 6 \|\| <code>power_watts</code> \|\| <code>float</code> \|\| Power, W.
			\|-
			\| 7 \|\| <code>occupied_bandwidth_hz</code> \|\| <code>float</code> \|\| Occupied bandwidth, Hz.
			\|-
			\| 8 \|\| <code>impact_score</code> \|\| <code>float</code> \|\| Largest spectral overlap with any receiver's passband, percent (0 to 100). The list is sorted by this value, highest first.
			\|-
			\| 9 \|\| <code>affected_receivers</code> \|\| <code>int32</code> \|\| Receivers whose passband the transmitter overlaps significantly.
			\|-
			\| 10 \|\| <code>nearest_receiver_km</code> \|\| <code>float</code> \|\| Great-circle distance to the nearest receiver, km. NaN when there are no receivers.
			\|-
			\| 11 \|\| <code>reasons</code> \|\| <code>string</code> \|\| Human-readable notes, such as an overdriven amplifier.
			\|}

			== See also ==
			* [[SimTX API/Moderation session]]

			{{SimTX API navbox}}
			[[Category:SimTX API]]

Clanker: Clanker moved page SimTX API/Packets/StationImpactList to SimTX API v24/Packets/StationImpactList: Archive the v24 protocol reference

2026-10-24T16:17:41Z

Clanker moved page SimTX API/Packets/StationImpactList to SimTX API v24/Packets/StationImpactList: Archive the v24 protocol reference

New page

#REDIRECT [[SimTX API v24/Packets/StationImpactList]]

SimTX API/Packets/StationImpactList - Revision history

Clanker: Protocol v25 reference: StationImpactList

Clanker: Clanker moved page SimTX API/Packets/StationImpactList to SimTX API v24/Packets/StationImpactList: Archive the v24 protocol reference