Editing SimTX API/Transmitter session (section)

== Placing the transmitter ==
A transmitter normally runs on one of the account's own [[SimTX API/Stations|persistent stations]]:
# Choose a station, an antenna and optionally a rig from <code>GET /api/v1/stations</code>. See [[SimTX API/Station endpoints]].
# Mint a <code>tx-audio</code> or <code>tx-generated</code> [[SimTX API/Game tickets|game ticket]] with the same <code>stationId</code>, <code>antennaId</code> and <code>rigId</code>.
# Send the hello with the ticket, then a [[SimTX API/Packets/TransmitterStart|TransmitterStart]] whose <code>site.station</code> is a [[SimTX API/Data types#StationBinding|StationBinding]] with the same ids. Empty antenna and rig ids select the station's first antenna and rig, or those the ticket was minted for.

The station dictates the callsign, placement, antenna and pointing defaults; the bound rig dictates the PA cap and most imperfection knobs. The session chooses the modulation, frequency, power up to the cap, source, sample rate, gain, bandwidth, low cut, tone and duty cycle, plus drive, compression, frequency offset and AM index. See [[SimTX API/Stations#What the station dictates|What the station dictates]]. Only the owner may transmit through a station.

On a satellite, the transmitter is a downlink transmitter at the satellite's position, and moves with it.

=== Ad-hoc transmitters ===
A start whose <code>site</code> is an [[SimTX API/Data types#AdhocStation|AdhocStation]] is accepted only for principals that hold <code>tx.adhoc</code> (service integrations) or when the server's ad-hoc policy allows it. By default servers refuse it with <code>ERROR_CODE_STATION_REQUIRED</code>. Third-party clients should always bind a station.