# Initial setup
make && source .venv/bin/activate

# Create and upload new codeplugs
./scripts/generate_rdt.sh     # create generic codeplugs for anybody
./scripts/personalize_rdt.sh  # create specific codeplugs for my radios
dmrRadio writeCodeplug tmp/foo.rdt          # upload a single codeplug

# Fetch and upload new contacts
./scripts/fetch_db.sh         # download a bunch of fresh contacts
dmrRadio writeMD2017Users tmp/filtered.csv  # if radio is Retevis RT90
dmrRadio writeUV380Users tmp/filtered.csv   # if radio is Retevis RT3S

# Produce data in a format useful for analog radios
./scripts/generate_csv.sh  # create programming data for analog radios

sudo pacman --no-confirm --sync gcc git go libusb pkgconf
git clone https://github.com/dalefarnsworth-dmr/dmrRadio && cd dmrRadio
go build

# Don't use the go provided by the OS as it is super old
# Fetch an appropriate tarball from https://go.dev/dl
# Install the contents of the tarball somewhere convenient
sudo tar -C /usr/local -xvfz "${GO_TARBALL}"
export "PATH=/usr/local/go/bin;${PATH}"

sudo apt-get --yes install git libusb-1.0-0-dev
git clone https://github.com/dalefarnsworth-dmr/dmrRadio && cd dmrRadio
go build

brew install git go libusb
git clone https://github.com/dalefarnsworth-dmr/dmrRadio && cd dmrRadio
go build

# Export the binary codeplug as JSON and fix some values
dmrRadio codeplugToJSON codeplug.rdt before.json
gojq --from-file Retevis_RT3S.jq before.json > after.json

# ========
# WARNING:  Don't put spaces in the intro screen lines
# ========

# Create a data file containing your specific values
cat << EOF > VA3DGN.json
{
  "GeneralSettings": {
    "IntroScreenLine1": "VA3DGN",
    "IntroScreenLine2": "3023396",
    "RadioID": "3023396",
    "RadioID1": "3021794",
    "RadioID2": "3023706",
    "RadioID3": "3021795",
    "RadioName": "VA3DGN"
  }
}
EOF

# Create a brand new, empty codeplug
dmrRadio newCodeplug -model RT3S -freq '400-480_136-174' new.rdt

# Make it even emptier still
dmrRadio codeplugToJSON new.rdt new.json
cat new.json \
    | gojq 'del(.Contacts[])' \
    | gojq 'del(.Channels[])' \
    | gojq 'del(.GroupLists[])' \
    | gojq 'del(.ScanLists[])' \
    | gojq 'del(.Zones[])' > empty.json

Send a SMS message to the APRS destination (310999 in North America) with the following body...

SMSGTE @<phone number> <message content>

After a few moments you will receive an ACK message and the recipient will get a text message.

To have someone reply to you, send a text message to the number that sent you the text with the body...

@<callsign> <message content>

After a few moments you should receive a message on your radio!

General format
--------------

BBBB12345
           BBBB = bandwidth (letters "H", "K", "M", "G" take the place of the decimal)
           1 = type of modulation used for the main carrier, not including sub-carriers
           2 = type of modulating signal of the main carrier
           3 = type of information transmitted
           4 = (OPTIONAL) practical details of the transmitted information
           5 = (OPTIONAL) method of multiplexing

Decoded meanings
----------------

4K00.....  4.0 kHz bandwidth
6K00.....  6.0 kHz bandwidth
7K34.....  7.34 kHz bandwidth
7K60.....  7.6 kHz bandwidth
8K00.....  8.0 kHz bandwidth
8K10.....  8.1 kHz bandwidth
8K30.....  8.3 kHz bandwidth
8K40.....  8.4 kHz bandwidth
9K00.....  9.0 kHz bandwidth
9K36.....  9.36 kHz bandwidth
10K1.....  10.1 kHz bandwidth
11K2.....  11.2 kHz bandwidth
11K3.....  11.3 kHz bandwidth
12K5.....  12.5 kHz bandwidth
13K6.....  13.6 kHz bandwidth
14K0.....  14.0 kHz bandwidth
16K0.....  16.0 kHz bandwidth
20K0.....  20.0 kHz bandwidth
..H......  some number of Hz bandwidth
.H.......  some number of Hz bandwidth
..K......  some number of kHz bandwidth
.K.......  some number of kHz bandwidth
..M......  some number of MHz bandwidth
.M.......  some number of MHz bandwidth
..G......  some number of GHz bandwidth
.G.......  some number of GHz bandwidth
....A....  Double-sideband amplitude modulation (e.g. AM broadcast radio)
....D....  Combination of AM and FM or PM
....F....  Frequency modulation (e.g. FM broadcast radio)
....G....  Phase modulation
....H....  Single-sideband modulation with full carrier (e.g. as used by CHU)
....J....  Single-sideband with suppressed carrier (e.g. Shortwave utility and amateur stations)
....W....  Combination of any of the above (for "Type of modulation")
....X....  None of the above (for "Type of modulation")
.....1...  One channel containing digital information, no subcarrier
.....2...  One channel containing digital information, using a subcarrier
.....3...  One channel containing analog information
.....7...  More than one channel containing digital information
.....X...  None of the above (for "Type of modulating signal")
......A..  Aural telegraphy, intended to be decoded by ear, such as Morse code
......D..  Data transmission, telemetry or telecommand (remote control)
......E..  Telephony (voice or music intended to be listened to by a human)
......W..  Combination of any of the above (for "Type of transmitted information")
......X..  None of the above (for "Type of transmitted information")
.......D.  Four-condition code, one condition per signal element
.......J.  Commercial-quality sound (non-broadcast)
.......X.  None of the above (for "Details of information")
........N  None used / Not multiplexed
........T  Time-division
........X  None of the above (for "Multiplexing")

Actual examples
---------------

6K00A3E    AM voice
8K00F3E    FM voice           +-2.5 ppm stability;  fits in 12.5 kHz
10K1F3E    FM voice           +-2.5 kHz deviation;  fits in 12.5 kHz
11K2F3E    FM voice           +-2.5 kHz deviation;  fits in 12.5 kHz
13K6F3E    FM voice           +-3.8 kHz deviation;  fits in 20 kHz
16K0F3A    FM CW ID           +-4.0 kHz deviation;  fits in 20 kHz
16K0F3E    FM voice           +-4.0 kHz deviation;  fits in 20 kHz
20K0F3D    FM voice           +-5.0 kHz deviation;  fits in 25 kHz
11K3F1D    POCSAG
20K0F1D    POCSAG
7K34FXDJN  DMR Tier2
7K60FXD    DMR Tier2
7K60FXDJN  DMR Tier2
7K60FXE    DMR Tier2
7K60FXW    DMR Tier2
7K60F7W    DMR Tier3
7K60F7WDT  DMR Tier3
6K00F7W    DSTAR
6K00F2A    DSTAR CW ID
9K00F..    M17                4FSK;  9600 bps;  fits in 12.5 kHz
4K00F1D    NXDN
4K00F1E    NXDN
4K00F1W    NXDN
4K00F2D    NXDN
4K00F7W    NXDN
8K30F1D    NXDN
8K30F1E    NXDN
8K30F7W    NXDN
8K00F1D    P25 Phase1 C4FM
8K10F1D    P25 Phase1 C4FM
8K10F1E    P25 Phase1 C4FM
8K30F1W    P25 Phase1 C4FM
8K40F1D    P25 Phase1 C4FM
8K40F1E    P25 Phase1 C4FM
9K80F1D    P25 Phase2 TDMA
9K80F1E    P25 Phase2 TDMA
9K36F1E    YSF C4FM
9K36F7W    YSF C4FM
11K2F7W    YSF C4FM
12K5F7W    YSF C4FM
16K0F1D    YSF C4FM
16K0F2D    YSF C4FM
20K0F7W    YSF C4FM