/* * Position module configuration description * ========================================= * * This module activates the position transmission of the tracker. If one of the position modules activated, it will activate the tracking manager which * samples GPS position and atmospheric data. If you want to save position data to the flash memory, you have to enable at lease one position module. You can * transmit positions either using 2FSK (RTTY) with the UKHAS standard, CW (Morse) or APRS (AFSK or 2GFSK). * * power int(0-127) Defines the radio power level. It ranges from 0 (low) to 127 (high). This value is sent into the Si4464 register. The * (required) real output power is operation voltage dependent. The operation voltage can be set by RUN_3V in config.h. If USB is * activated the operation voltage is 3V regardsless to which value RUN_3V is set. Running the PCB at 3V following table * applies: * 20 dBm => 127 * 15 dBm => 40 * 10 dBm => 20 * 5 dBm => 12 * 0 dBm => 8 * * protocol prot_t Possible Options: * (required) - PROT_APRS_AFSK FM AFSK 1200baud transmission using the APRS protocol * this option requires aprs_conf to be set * - PROT_APRS_2GFSK 2GFSK transmission using the APRS protocol * this option requires aprs_conf and gfsk_conf to be set * - PROT_UKHAS_2FSK Comma separated 2FSK transmission (RTTY) using the UKHAS standard * this option requires ukhas_conf and fsk_conf to be set * - PROT_MORSE Morse transmission * this option requires morse_conf and ook_conf to be set * * frequency.type freq_type_t Defines the frequency type. This option will be FREQ_STATIC if not set. * (default FREQ_STATIC) Possible Options: * - FREQ_STATIC Static frequency taken from frequency.hz * - FREQ_APRS_REGION Using the APRS region frequency. The tracker will change its frequency specificly to the region * where it is located. e.g. 144.8MHz in Europe or 144.39MHz in the US. If the tracker doesnt know its * position it takes its frequency from frequency.hz as default. Note that the tracker knows its * position from its position log too. So it might use the last frequency which has been used before * resetting it. * * frequency.hz int Frequency that this Module will transmit on (in Hz). The tracker can transmit in the 2m band. This value will be used * (required) as default when frequency.type == FREQ_APRS_REGION and it doesnt know its position * * init_delay int Initial delay (in ms) before the module starts. This might be useful if you dont want to transmit so many APRS packets * (default 0ms) at the same time on the APRS network. This option is optional. It will be 0ms if not set. * * trigger.type trigger_type_t Event at which this module is triggered to transmit. This option will be TRIG_ONCE if not set. * (default TRIG_ONCE) Possible options: * - TRIG_ONCE Trigger once and never again (e.g. transmit specific position packet only at startup) * - TRIG_NEW_POINT Triggered when new track point available * - TRIG_TIMEOUT Triggered by timeout (e.g. trasmit position every 120sec) * this option requires trigger.timeout to be set * - TRIG_CONTINUOUSLY Continue continuously (e.g. send new image once old image sent completely) * * trigger.timeout int Amount of seconds of module cycle (in seconds). This option is only neccessary if trigger.type == TRIG_TIMEOUT. * (default 0s) * * ============================== The following options are needed if protocol == PROT_APRS_AFSK or protocol == PROT_APRS_2GFSK =============================== * * aprs_conf.callsign string Your amateur radio callsign (this requires an amateur radio license). This callsign will be used in the APRS protocol. * (required) You can transmit on the 70cm band without a license but the transmitter would need a 70cm LPF therefore. * * aprs_conf.ssid int(0-15) APRS SSID (no SSID = 0) * (default 0) * * aprs_conf.symbol int APRS Symbol (according to this table http://www.aprs.org/symbols.html) * (required) Possible Options: SYM_BALLOON, SYM_SMALLAIRCRAFT, SYM_SATELLITE * * aprs_conf.path string APRS digipeating path (default: no digipeating) * (optional) * * aprs_conf.preamble int AFSK or 2GFSK preamble length (in ms). This value is required while its default is 0ms (and this would simply not work ;-) ) * (required) * * aprs_conf.tel[0-4] telemetry_t There are numerous telemetry values which can be sent in the APRS position packet. One packet can contain 5 values. * (required) There are possible options: * - TEL_SATS GPS Satellites * - TEL_TTFF Time to first fix (amount of seconds which it needed to aquire a GPS fix) * - TEL_VBAT Battery voltage (in mV) * - TEL_VSOL Solar voltage (in mV) * - TEL_PBAT Battery power (positive charge, negative discharge) * - TEL_RBAT Battery impedance (in mOhm) * - TEL_PRESS Air pressure (in Pa) * - TEL_TEMP Air temperature (in degC*100) * - TEL_HUM Air humidity (in %*10) * * aprs_conf.tel_enc bool The telemetry in the position packets do only contain the raw values. Receivers (like aprs.fi) dont know what these * (default false) values stands for. So we must tell them (e.g. that value 1 is air pressure measured in Pascal). If set to true, the * tracker will transmit additional packets containing these informations. This option requires aprs_conf.tel_enc_cycle. * * aprs_conf.tel_enc_cycle int This values defines how often telemetry configuration packets are sent. Transmitting those packets every two * (default 0sec) hours (7200sec) is a good value. This value is set in seconds. * * aprs_conf.tel_comment string There can be set a short comment which is sent with the APRS configuration packets. It has no affect if * (optional) aprs_conf.tel_enc is set false. Its default is empty. * * ============================================= The following options are needed if protocol == PROT_APRS_2GFSK ============================================== * * gfsk_conf.speed int 2GFSK speed. Following values have been tested successfully: 9600, 19200. * (required) * * ============================================= The following options are needed if protocol == PROT_UKHAS_2FSK ============================================== * * fsk_conf.bits int(7-8) Bits * (required) * * fsk_conf.stopbits int(1-2) Stopbits * (required) * * fsk_conf.predelay int Predelay (in ms). The receiver needs to settle on the frequency for a while. Therefore is switched on some seconds * (default 0ms) before. By default its 0ms but that wouldnt work. * * fsk_conf.baud int Baudrate. Following values have been tested successfully: 50, 300, 600. * (required) * * fsk_conf.shift int Frequency shift of 2FSK * (required) * * ukhas_conf.callsign string Your amateur radio callsign (this requires an amateur radio license). This callsign will be used in the UKHAS protocol. * (required) You can transmit on the 70cm band without a license but the transmitter would need a 70cm LPF therefore. * * ukhas_conf.format string UKHAS format. This is the string which will be sent. This string contains variables (e.g. ) which will be * (required) replaced by the actual values. * For example: ",,