Fldigi Users Manual
4.2.00
|
These commands are NON-STANDARD extension(s) to the KISS interface specifications and designed to control/configure aspects of FLDIGI not normally found in Hardware TNC's. Undefined kiss frame types 6 and 7 are used to identify these custom frames.
Definition | Kiss frame ID |
---|---|
HARDWARE | 6 |
RAW | 7 |
External program which conform to the official KISS I/O specifications are expected to operate normally.
UDP/IP Connectionless communications are used to transfer information between FLDIGI and the host program. See Configure ARQ/KISS I/O and Command Line Switches for specific address and port number assignments.
Command <parameters(s)> | Use |
---|---|
BCHN:<ON|OFF> | Busy Channel On/Off |
BCHNS:<0-999> | Busy Channel Wait Duration (seconds) |
CSMA:<ON|OFF> | Enable/Disable CSMA. Used on a shared frequency |
IBCHN:<N> | Set Inhibit busy channel duration to N seconds |
IBCHN:0 | Resets temporary duration to default setting. |
IBCHN:S | Inhibit busy channel temporarily. 'S' (character) (default 5 seconds) |
KISSRAW:<ON|OFF|ONLY> | Pass non HDLC encoded data to the transmitter. |
ON = HDLC and Unaltered data. OFF = HDLC data only. ONLY = Unaltered data only.
Command | Use |
---|---|
KISSCRCM:<NONE|SMACK|CCITT|XOR|FCS> | Enable KISS frame checksum type |
KPSATT:<value> | Set the fractional ratio gain value (1/value) |
KPSQL:<ON|OFF> | OFF=Histogram Mode, ON=User set level |
KPSQLS:<0-100> | Set squelch level (percent) |
MODEM:<modem_id_string> | Set modem type. Example MODEM:PSK63RC32 |
RSIDBCAST:<ON|OFF> | Enable/disable RSID broadcast state change (default: OFF) |
RSIDRX:<ON|OFF> | Enable/disable RX RSID |
RSIDTX:<ON|OFF> | Enable/disable TX RSID |
SQL:<ON|OFF> | SQL On/Off |
SQLS:<0-100> | Set SQL Level (percent) |
TRXSBCAST:<ON|OFF> | Enable/disable TX/RX state change broadcast (default: OFF) |
TXBEBCAST:<ON|OFF> | Enable/disable TX buffer empty broadcast (default: OFF) |
TXLOCK:<ON|OFF> | Enable/disable TX waterfall position lock. |
WFF:<integer value> | Move TXRX cursor to frequency on waterfall. |
NONE = No CRC used SMACK = Enable CRC use for Host <-> TNC ASYNC links CCITT = Enable CCITT CRC FCS = Enable FCS CRC XOR = Enable BPQ's XOR CRC
Command <parameters(s)> | Use |
---|---|
RSIDM:<BANDPASS|MODEM>,<ACTIVE|NOTIFY> | Set the RSID mode to,... |
BANDPASS = Search entire bandpass for RSID signals MODEM = Search Modem bandpass (+/- 200HZ) for RSID signals ACTIVE = When RSID received, move frequency transmit/receive cursor to location. NOTIFY = Report RSID when detected (Notify only).
Command / Return Status | Use |
---|---|
BCHN: FLDIGI returns BCHN:<ON|OFF> | Busy Channel State On/Off Query |
BCHNS: FLDIGI returns BCHNS:<0-999> | Busy Channel Wait Duration Query (seconds) |
BUSY: FLDIGI returns BUSY:<Y|N> | Return the state of the squelch, if there is a signal present |
CSMA: FLDIGI returns CSMA:<ON|OFF> | CSMA State ON/OFF |
FLSTAT: FLDIGI returns FLSTAT:<INIT|OK>,<HH:MM:SS> | Start up State and runtime. Returns OK and after initial Query |
IBCHN: FLDIGI returns IBCHN:<SECONDS> | Inhibit busy channel durations in seconds. |
KISSCRCM: FLDIGI returns CRCMODE:<NONE|SMACK>,<CCITT|XOR|FCS> | Host <-> TNC KISS CRC Types |
KPSATT: FLDIGI returns KPSATT:<value> | Fractional value of KPSQL ratio gain figure (1/value) |
KPSQL: FLDIGI returns KPSQL:<ON|OFF> | OFF=Histogram Mode, ON=User set level |
KPSQLP: FLDIGI returns KPSQLP <0-100> | Current Power Level |
KPSQLS: FLDIGI returns KPSQLS:<0-100> | Squelch set level Query (percent) |
MODEM: FLDIGI returns MODEM:<Modem ID String> | Current Modem |
MODEMBW: FLDIGI returns MODEMBW:<Bandwidth in Hz> | Current Modem Bandwidth |
MODEML: FLDIGI returns MODEML:Modem1,Modem2,... | A List of comma delimited modem ID strings. |
RSIDM: FLDIGI returns RSIDM:<BANDPASS|MODEM>,<ACTIVE|NOTIFY> | Return current RSID Mode |
RSIDRX: FLDIGI returns RSIDRX:<ON|OFF> | RX RSID ON? |
RSIDTX: FLDIGI returns RSIDTX:<ON|OFF> | TX RSID ON? |
SQL: FLDIGI returns SQL:<ON|OFF> | SQL On/Off |
SQLP: FLDIGI returns SQLP:<0-100> | Current Symbol Quality Level (Currently Not returning valid data) |
SQLS: FLDIGI returns SQLS:<0-100> | Set SQL Level Query (percent) |
TNC: FLDIGI returns TNC:FLDIGI <Version Number> | Returns the version number of FLDIGI |
TRXS: FLDIGI returns TRXS:<RX|TX> | Return the current RX/TX state of FLDIGI |
TXBUF: FLDIGI returns TXBUF:<count> | Return the number of byte in the transmit queue |
TXLOCK: FLDIGI returns TXLOCK:<ON|OFF> | Return TX waterfall position lock state. |
WFBW: FLDIGI returns WFBW:<LOWER HZ>,<UPPER HZ> | Return the active waterfall bandwidth |
WFF: FLDIGI returns WFF:<integer value> | Current modem position on waterfall (center) |
Command | Use |
---|---|
HOST: | Host returns HOST:<program_name> <version> |
Status <parameters(s)> | Use |
---|---|
RSIDN:NEW_WF_OFFSET,NEW_MODEM,OLD_WF_OFFSET,OLD_MODEM,<ACTIVE|NOTIFY|USER> | RSID NOTICE |
TRXS:<RX|TX> | Transmitted during a state change between RX/TX or TX/RX. |
TXBE: | Broadcast on emptied transmit buffer. |
NEW_WF_OFFSET = 0-4000 NEW_MODEM = Modem ID string of newly switched modem. OLD_WF_OFFSET = 0-4000 OLD_MODEM = Modem ID string of modem prior to switching. ACTIVE = Indicating TXRX cursor changed. NOTIFY = Notice only. USER = Report User or commanded via KISS interface modem change.
FLDIGI will only except KISS frames with a PORT ID of '0' (zero). The hardware frame is a kiss frame type 6.
MODEM:PSK125RC16 FEND,PORT(0)|HRDW(6),'M','O',D','E','M',':','P','S','K','1',2','5','R','C','1','6',FEND KISS HARDWARE FRAME="MODEM:PSK63RC32" KISS HARDWARE FRAME="RSIDTX:ON" KISS HARDWARE FRAME="RSIDRX:OFF"
To enable RAW use, issue hardware command KISSRAW:<ON|OFF|ONLY>. The encode of the raw data is the same as the encoding of normal kiss data. The host program is responsible for the proper protocol data syntax.
Format:
Dn=8 bit data (byte)
KISS RAW FRAME=D1,D2,D3,... FEND,PORT(0)|RAW(7),D1,D2,D3,...,FEND
Notes: