Skip to content

sa818

NAME

sa818 - Configure SA818 device from command line

SYNOPSIS

Usage: 

/usr/bin/sa818 [-h] [--debug] [--port PORT] [--speed SPEED] <radio|volume|filters|filter|version>

Positional arguments (one of):

radio: Program the radio (frequency/tone/squelch)

volume: Set the volume level

filters (filter): Enable/disable filters

version: Show the firmware version of the SA818

Optional arguments:

-h: show help

--debug: change logging to debug level

--port PORT: serial port to communicate with SA818 module. Default will try /dev/serial0 and /dev/ttyUSB0

--speed SPEED: serial port speed to communicate with SA818 module. Default is 9600. Valid baud rates are 300,1200,2400,4800,9600,19200,38400,57600,115200

DESCRIPTION

sa818 - Configure an SA818 device from the command line

One of the following commands, and its related option(s) must be sent: radio|volume|filters|filter|version. The filter and filters options are synonymous, either can be used. Use the -h suffix with any of the commands to find more details about the available options and defaults.

The SA818 module cannot have its settings "read", only programmed. This utility therefore, only "writes" configuration updates to the radio module.

radio Options

radio [-h] [--bw 0|1] [--frequency FREQUENCY] [--offset OFFSET] [--squelch 0-8] [--ctcss CTCSS[,CTCSS]] [--dcs DCS<I|N>[,DCS<I|N>]] [--tail open|close]

-h: Show radio options help

--bw 0|1: Bandwidth 0=NARROW (12.5KHz), 1=WIDE (25KHz). Default is 1 (WIDE)

--frequency FREQUENCY: Receive frequency (required), in MHz. Must be between 144.0000-148.0000MHz or 420.0000-450.0000MHz

--offset OFFSET: Offset for transmit frequency, in MHz, ie -0.6 or 0.6. Default is 0.0 (transmit and receive the same)

--squelch 0-8: Receiver squelch level, 0-8. Default is 4

--ctcss CTCSS[,CTCSS]: Specify CTCSS (PL) tone. If one tone is specified, TX/RX tones will be the same. Two tones, separated by a comma will specify different tones for TX,RX. Default is 0.0 (no tone). CTCSS is mutually exclusive from DCS. See list below for valid tones

CTCSS codes (PL Tones):

67.0, 71.9, 74.4, 77.0, 79.7, 82.5, 85.4, 88.5, 91.5, 94.8, 97.4, 100.0, 103.5, 107.2, 110.9, 114.8, 118.8, 123.0, 127.3, 131.8, 136.5, 141.3, 146.2, 151.4, 156.7, 162.2, 167.9, 173.8, 179.9, 186.2, 192.8, 203.5, 210.7, 218.1, 225.7, 233.6, 241.8, 250.3

--dcs DCS<I|N>[,DCS<I|N>]: Specify DCS code and whether it is Inverted or Normal. If one code is specified, TX/RX codes will be the same. Two codes, separated by a comma will specify different codes for TX,RX. Default is none (no code). DCS is mutually exclusive from CTCSS. See list below for valid codes

DCS Codes (must be followed by N or I for Normal or Inverse):

023, 025, 026, 031, 032, 036, 043, 047, 051, 053, 054, 065, 071, 072, 073, 074, 114, 115, 116, 125, 131, 132, 134, 143, 152, 155, 156, 162, 165, 172, 174, 205, 223, 226, 243, 244, 245, 251, 261, 263, 265, 271, 306, 311, 315, 331, 343, 346, 351, 364, 365, 371, 411, 412, 413, 423, 431, 432, 445, 464, 465, 466, 503, 506, 516, 532, 546, 565, 606, 612, 624, 627, 631, 632, 654, 662, 664, 703, 712, 723, 731, 732, 734, 743, 754

--tail open|close: Specify if CTCSS revere burst is enabled (close) or disabled (open). Default is none (open)

volume Options

volume [-h] --level 1-8

-h: Show volume options help

--level 1-8: Set volume level between 1-8. Default is 4

filters|filter Options

filters|filter [-h] [--emphasis enable|disable] [--highpass enable|disable] [--lowpass enable|disable]

-h: Show filter options help

--emphasis enable|disable: Enable or disable pre-/de-emphasis

--highpass enable|disable: Enable or disable the high pass audio filter

--lowpass enable|disable: Enable or disable the low pass audio filter

version Options

version [-h]

-h: Show version options help

<none>: with no other arguments, print the firmware version of the SA818 module

BUGS

Report bugs to https://github.com/AllStarLink/ASL3/issues

Copyright (c) 2022-2023 Fred W6BSD under the terms of the BSD 2-Clause License.