sBitx v3 Commands Reference

Reference : sBitx v3 Commands

 This is an experimental feature and it is only meant for the developers for the present.

In addition to the visual controls, the sBitx also supports text commands that allow the same functionality as the graphical controls.

These commands can be entered in the native UI by preceding the text with a backslash (\) or pressing the CMD key of the on-screen keyboard.

In the web UI, press the CMD button in the bottom of the page to open the Commands console. The commands can be entered directly into the web UI’s command console without the backslash..

 These are text commands that can be entered from the keyboard

Basic Radio Commands

MYCALLSIGN [text]
Sets the operator (your) callsign. This is used just once when you are setting up your radio with your callsign. If a friend is using the radio, they should set it to their callsign for the macros, FT8 and the logger to work properly.

MYGRID [6 letters]

 This is a 6 letter code to indicate the approximate location of your station on Earth.
Sets the operator (your) Maidenhead grid location. It is used just once when you are setting up your radio with your callsign. If the radio’s location is changed, you should update the grid location. 

FREQ frequency
Sets the operating frequency of the radio. The frequency can be specified in Hz or KHz. You can also use the short form of just f. Both of the following examples set the frequency to 7035 KHz:
FREQ 7035
f 7035000

AUDIO 0-100
Set the audio volume of the radio’s reception.

MODE  [USB/LSB/CW/CWR/FT8/DIGITAL/2TONE/etc..]
Chooses from the modes available in the mode selection control. You can use ‘m’ instead of ‘mode’
mode USB (chooses USB mode)

Set this to DIGITAL when using the radio with third party software like FlDigi or WSJT-X. The 2TONE is a test mode that transmits 2-Tone signal to check the transmitter IMD. 

AGC OFF/SLOW/MED/FAST
Sets Automatic Gain Control’s  hold time. SSB is best with AGC set to SLOW. CW will require FAST setting for high speed CW and MED for low speed CW. For digital modes like FT8, it is best to switch off the AGC 

DRIVE 1-100
Sets the transmit output power level. To set the exact power, monitor the Power indicator on screen while changing this value.

STEP 10K/1K/100H/10H
Sets the frequency jump with each step of the tuning knob. Use the 10K jump to quickly get to another frequency that far from the current frequency.
As most SSB operation is now on an exact kilohertz boundary, you can use 1KHz steps while tuning for SSB signals.
The lower step rates are useful for narrow band modes like CW. The CW decoder requires that the signal should be centered inside the audio bandwidth, this needs the signal to be nudged within 100 Hz, using either the 100Hz or the 10Hz steps.

SPAN 25K/10K/6K/2.5K
Sets the spectrum and waterfall width. For non-voice modes, 10 KHz span is preferable as it enables you to see individual narrow band signals clearly.

RIT ON/OFF
Turns Receiver Incremental Tuning ON or OFF. Use this to receive stations that are slightly away from your own transmitting frequency. This is frequently the case with DXing and contesting. 

VFO A/B
Toggles between two VFOs for quickly jumping between two frequencies. The two VFOs are also used to work SPLIT, where VFO A frequency is used to receive signals and VFO B is used to transmit signals.

BW 50-5000 (Hz)
Sets the audio bandwidth of the receiver. 

In voice modes, the lower edge of the bandwidth is always set to 300 Hz and the higher edge adjusted to the BW setting. For instance, in USB mode if the BW is set to 1800, then the actual bandpass is from 300 Hz to 2100 Hz.

In non-voice modes, the audio bandwidth is centerd around the PITCH frequency. For instance, in CW mode if the BW is set to 300 and the PITCH is set to 600 Hz, Then the filter is set from 450 Hz to 750 Hz.

VFOA frequency (Hz)
Directly sets the VFO A frequency.
VFOA 7015000

VFOB frequency (Hz)
Directly sets the VFO B frequency.
VFOB 7015000

RIT_DELTA -25000 to 25000 (Hz)
Sets the Receiver Incremental tuning offset. For instance, if the radio is set to 14040KHz, the RIT is ON and the RIT_DELTA is set to 5000, then the receiver will be tuned to 14045 KHz and on transmit it will go back to 14040 KHz. If the RIT is OFF, then this setting has no effect.

ESC
Aborts the current transmission of any macro/text.

TX
Switches the radio to transmit 

RX
Switches the radio to receive

10M Switches to 10 meter band, if the current frequency is already within 10M band, then it switches to the next frequency of 10M in the band stack.

12M Switches to 12 meter band, if the current frequency is already within 12M band, then it switches to the next frequency of 12M in the band stack.

15M Switches to 15 meter band, if the current frequency is already within 15M band, then it switches to the next frequency of 15M in the band stack.

17M Switches to 17 meter band, if the current frequency is already within 17M band, then it switches to the next frequency of 17M in the band stack.

20M Switches to 20 meter band, if the current frequency is already within 20M band, then it switches to the next frequency of 20M in the band stack.

30M Switches to 30 meter band, if the current frequency is already within 30M band, then it switches to the next frequency of 30M in the band stack.

40M Switches to 40 meter band, if the current frequency is already within 40M band, then it switches to the next frequency of 40M in the band stack.

80M Switches to 80 meter band, if the current frequency is already within 80M band, then it switches to the next frequency of 80M in the band stack.

REC ON/OFF
Toggles the recording of transmitted and received audio into a WAV file. These files are named with the date and time of recording and they are stored in /home/pi/sbitx/audio

WEB Launches the web UI on the chromium browser at 127.0.0.1:8088

Logger Controls

ESC
Aborts the current transmission of any macro/text.

MACRO [filename]
Loads the macro file from the filename specified. The file is expected to be present in /home/pi/sbitx/web directory. The filnemae should NOT contain the .mc extension.
MACRO CW1 

The macro files are text files written in the N1MM format. See the CW1.mc as an example.

CALL [text]
Sets the contact’s callsign. This will be used in macros as well as to make logbook entry.

SENT [text]
Sets the signal report of the contact as received at our end. The signal report can be free form as it is reported in dB by FT8, as a two digit value in voice modes, 3 digit value in CW, etc.

RECV [text]
Sets the report of our signals given by the contact. 

EXCH [text]
An optional field for the logbook, this is often the additional information sent by our contact along with the signal report. During contests, this might be a serial number. On FT8, this is the 4 letter grid location. 

NR [text]
An optional field for the logbook, this is often the additional information sent by us to our contact along with the signal report. During contests, this might be a serial number. On FT8, this is the 4 letter grid location. 

LOG
Saves the QSO into the Logbook. This command does not automatically clear the logger fields as they may still be required if the call is to continue using the macros. 

WIPE
Clears all the logger fields. 

QRZ [callsign]
Queries qrz.com with the callsign set in CALL field. This will launch the browser if it is not already opened.

SENT_EXCHANGE (text)
Sets the text to be sent in exchange by the macros. 

CONTEST_SERIAL 0-100000
Sets the initial value of the contact numbers given during a contest. This is picked up by the logger and incremented after every contact is logged.

LOW 100-4000 (Hz)
Sets the lower edge of audio bandwidth, This is an internal setting that is calculated and set by the BW control.

HIGH 100-4000 (Hz)
Sets the higher edge of audio bandwidth, This is an internal setting that is calculated and set by the BW control.

PASSKEY [passkey]
This sets the passkey that is required to login to the sBitx from device or computer.
PASSKEY 123

SSB Controls 

MIC 0-100
Sets microphone gain for voice modes. For SSB on sBitx v3, the supplied microphone works well with MIC set to 25. Example:
MIC 25

CW Controls

WPM 1-50
Sets the CW sending speed

PITCH 100-3000 (Hz)
Sets the CW sidetone and decoding audio frequency in Hz. The CW decoder looks for signals within 100 Hz of this frequency. The BW control centers the audio filter on the PITCH frequency.

CW_INPUT IAMBIC/IAMBICB/STRAIGHT
Sets the sending method of CW. In all these modes, you can intersperse sending through keyboard or macros.

CW_DELAY [100-2000]
How many milliseconds the radio remains in transmit after the last letter is sent. For example, to set the CW delay to 200 milliseconds:
CW_DELAY 200 

SIDETONE 0-100
Sets the volume of the sidetone when sending the CW.
SIDETONE 80

FT8 Controls

TX_PITCH 300-3000 (Hz)
Sets the transmitting frequency within the audio passband. For instance, if you are on 7074KHz and the TX_PITCH is set to 1800, then your actual transmitting frequency is 7075800 Hz. 

You should choose a TX_PITCH frequency that is relatively clear of other signals  from the waterfall.

FT8_AUTO ON/OFF
When this control is switched on, it automatically responds to any reply to your CQ transmission and completes the QSO. Often, other stations could call you as soon as one QSO is finished, and this setting will enable the radio to automatically answer the next QSO and so on.

FT8_TX1ST ON/OFF
On FT8, the minute is divided into four 15 second slots. Stations transmit and receive on alternating slots. With TX_1ST set to ON, your CQ calls will be transmitted in the first and third slot while you listen for responses on the second and fourth slot of the minute.
This control only affects the timing of the CQ messages that you transmit. When you choose another station’s CQ message, the sbitx will automatically transmit on slots that that station is listening on.

FT8_REPEAT 1-10
The maximum number of times any message (like CQ) is transmitted until a response is obtained.

Telnet

TELNETURL [server:port]
Stores the URL of the telnet server.
TELNETURL dxc.g3lrs.org.ul:7300

topen server:port
Opens a telnet session with an RBN or a DX cluster telnet server. It works with ip address as well as domain names.
topen dxc.g3lrs.org.ul:7300

tclose
Closes the existing telnet session

w [telnet command string]
Writes the remaining text (skipping the space after ‘\w’) to the currently opened telnet server