Dsdplus Commands

dsdplus commands

DSD+ 1.074 User Guide
———————

Installation
————

This application can create many audio files and log files,
so consider using a dedicated folder to run it from.
dsdplus commands check here dsdplus commands

The folder can be on your desktop (desktopDSDPlus) or
off the root folder (C:DSDPlus), for example.

After copying the zip file contents to the installation folder,
you should probably create a shortcut on your desktop.
The shortcut should run cmd.exe in the installation folder

Shortcut properties:

dsdplus commands click here dsdplus commands
Target: %windir%system32cmd.exe

Start in:

Layout / Window size: Width should be about 100 (120 if displaying timestamps)

Usage/Options Summary
———————
dsdplus commands click here dsdplus commands

Usage:
DSDPlus [options] Decode from audio stream
DSDPlus [options] ? file Decode from .wav file
DSDPlus -h Show help

Options ( […] = default value):

Display/Logging options:
— Show command line options in window title
dsdplus commands get more info dsdplus commands
>file Create log file
>>file Append to log file
-t Time stamp log file entries
-T Time stamp log file entries and on screen data
-v Frame information verbosity (0-4) [-v2]

-wsl. Source audio waveform window location [10.10]
-wss. Source audio waveform window size (min 50.200; 0 blocks) [200.300]
-wsp Source audio waveform window update period (10-1000) [100]

dsdplus commands read more dsdplus commands
-wel. Event log window location [50.50]
-wes. Event log window size (min ?) [400.500]
-weh Event log window font height [15]

-wcl. Channel window location [90.90]
-wch Channel window font height [15]

Input/Output options:
-i Input audio device (1-255) and channel (M/L/R) [-i1M]

dsdplus commands more info dsdplus commands
-g Output audio gain (0.001-999; 0=auto) [-g0]

-o Output audio device (1-255; 0=none) and channel (M/L/R) [-o1]
in/out channels are optional; default=in:mono, out:mode based

-Och Output audio file channel count and name/type [-O DSDPlus.wav]
ch: M=mono,S=stereo,blank=auto; file: .wav or .mp3 (NUL=none)

-I Create new wav/mp3 file every minutes (1440=daily) [-I0]

dsdplus commands here dsdplus commands
-M MP3 ABR kbps per channel (8-32) [-M15]

Decoder options:
-p Invert signal polarity (may be required for X2-TDMA and dPMR)
-mp optimize for PSK modulation (will not decode non-PSK)

-fa Auto-detect all protocols / frame types except dPMR [-fa]
-fd Decode D-STAR (no audio)
-fn Decode NXDN4800 (Kenwood NEXEDGE and Icom IDAS)
-fN Decode NXDN9600 (Kenwood NEXEDGE)
dsdplus commands read more dsdplus commands
-fr Decode DMR/MotoTRBO (TDMA inputs + both output slots)
-f1 Decode P25 Phase 1
-fx Decode X2-TDMA
-fp Decode ProVoice
-fm Enable dPMR decoding (no audio)

-1 Synthesize audio for first DMR timeslot
-2 Synthesize audio for second DMR timeslot

-u Unvoiced speech quality (1-64) [-u3]
dsdplus commands read more dsdplus commands
-e Auto-mute encrypted voice

Advanced decoder options:
-dr Rolloff filter (1-11; 0=auto) [-dr0]
-dh Hotspot size (1-8; 0=auto) [-dh0]
-ds Scaling factor (55-75; not used with D-Star or ProVoice) [-ds64]
-dd Damping level (1-100; not used with D-Star or ProVoice) [-dd10]
-dv Viewport size (1-30; not used with D-Star or ProVoice) [-dv20]

Active keys:
dsdplus commands check here dsdplus commands
? Display active keys list in event log window
1 Synthesize audio for first DMR timeslot
2 Synthesize audio for second DMR timeslot
3 Synthesize audio for both DMR timeslots
– Toggle command line options display
| Toggle symbol phase display
B Show/hide background events in event log window
E Toggle auto-muting of encrypted voice
F Forget current system information
N Reset/redisplay neighbor list
dsdplus commands here dsdplus commands
P Toggle signal polarity
R Start/stop recording of raw source audio to wav file
S Close/reopen source audio waveform display
W Display window locations
Esc End program

Source Audio:
Right click Pause/unpause source audio waveform display

dsdplus commands check here dsdplus commands

Run Modes
———

The program can decode live discriminator audio or recorded .wav files.
Recorded audio files must be 48 or 96 kHz 16 bit mono PCM .wav files.

Logging
dsdplus commands here dsdplus commands
——-

-v
-v0 generates minimal output.
Use -v3 or -v4 for maximum data logging.
Program output can be sent to a log file ( DSDPlus >logfile )

Input/Output
dsdplus commands get more info dsdplus commands
————

-i -o
WaveIn/Out devices are listed at program startup.
Select your devices if you don’t want to use the defaults.
Use -o0 to disable output audio.

-O
By default, all synthesized audio is written/appended to DSDPlus.wav
Use -O name.ext to write synthesized audio to another .wav or .mp3 file.
dsdplus commands check here dsdplus commands
Use -O NUL to disable recording of synthesized audio.

-I
Use -I# to start a new synthesized audio recording file every # minutes.

Decoder Options
—————

dsdplus commands read more dsdplus commands
-fa
Using -fa (or nothing) will (usually) auto-decode all supported protocols.
Polarity of signals is auto-detected.
Note: -fa does not enable dPMR detection; -fm must be used to enable dPMR

-fd -fn -fN -fr -f1 -fx -fp -fm
When monitoring a single type of traffic, locking the protocol can provide
slightly better decoding results.
Note: more than one protocol can be enabled via the command line.

dsdplus commands website dsdplus commands
-u
Lower values (slightly) reduce CPU load.

-e
Use to enable auto-muting of encrypted voice traffic

Advanced Decoder Options
————————
dsdplus commands click here dsdplus commands

Fine tuning the advanced decoder options can greatly increase decoding rates.

Different systems, protocols, receivers and PC sound devices require unique
fine tuning values.

A 15 to 60 second recording of voice traffic on a target system should be made
and used as the input for tuning runs. Use the ‘R’ key to make recordings.
Recordings of control channels or rest channels are also useable.

dsdplus commands website dsdplus commands
To speed up the tuning process, audio synthesis should be disabled
and the protocol should be locked correctly:

DSDPlus ? rawAudio.wav -o0 -O NUL -f1

A decoding score will be displayed.

Pressing the up arrow will redisplay the previous command line,
which you can then edit and re-run.

dsdplus commands more info dsdplus commands
Adjust a single parameter to determine which value produces the highest score:

DSDPlus ? rawAudio.wav -o0 -O NUL -f1 -dr1
DSDPlus ? rawAudio.wav -o0 -O NUL -f1 -dr2
DSDPlus ? rawAudio.wav -o0 -O NUL -f1 -dr3
DSDPlus ? rawAudio.wav -o0 -O NUL -f1 -dr4

When the optimal value for a tuning parameter is determined,
use that value (#) and add another parameter and repeat the tuning steps:

dsdplus commands more info dsdplus commands
DSDPlus ? rawAudio.wav -o0 -O NUL -f1 -dr# -dh1
DSDPlus ? rawAudio.wav -o0 -O NUL -f1 -dr# -dh2
DSDPlus ? rawAudio.wav -o0 -O NUL -f1 -dr# -dh3

Repeat until all advanced decoding options have been fine tuned.

The recommended order for adjusting tuning parameters is:

dsdplus commands read more dsdplus commands
1: Rolloff filtering (-dr)
2: Hotspot size (-dh)
3: Scaling factor (-ds)
4: Damping level (-dd)

Viewport tuning is rarely worth bothering with.

Damping settings do not affect D-Star or ProVoice,
so don’t bother tweaking them for those protocols.

dsdplus commands click here dsdplus commands

You do NOT have to try every value for a tuning parameter:

Rolloff: start at 1 and go up by 1 until the score starts trending down

Hotspot: most signals prefer an even hotspot size (usually 2, sometimes 4);
a few signals prefer an odd hotspot size; testing 2, 3 and 4 will
settle the odd/even question; continue until the score trends down

Scaling: test only 55, 60, 65, 70, 75; best is usually in the 60-65 range
dsdplus commands click here dsdplus commands

Damping: start testing at 5; increment by 5 or 10; watch the trend…

Check your tuning by re-enabling voice synthesis:

DSDPlus ? rawAudio.wav -f1 -dr# -dh# -ds# -dd# -dv#

-or-
dsdplus commands click here dsdplus commands

Just use the third party program – dsdtune.

When the optimal values for a system + receiver + sound input is determined,
consider creating a batch file to store the settings:

Local-PD.bat:

DSDPlus -f1 -dr1 -dh3 -ds66 -dd40 -dv20 -O PD.mp3
dsdplus commands get more info dsdplus commands

DMR.bat:

DSDPlus -fd -d21 -dh2 -ds58 -dd5 -dv20 -O DMR.mp3

Then to monitor a specific system, run its batch file.

If you prefer, instead of batch files, you can create desktop shortcuts.

dsdplus commands more info dsdplus commands
If you scan multiple systems and protocols with a single receiver,
you can run multiple copies of DSDPlus in parallel with each one
protocol-locked and fine tuned as required. Each copy of the program
should write synthesized audio to separate files.

Active Keys
———–

dsdplus commands read more dsdplus commands
?

‘?’ generates a list of keyboard commands in the event log window.

1
2
3

When monitoring conventional DMR systems, you may want to block voice
synthesis for one timeslot. Press 1 or 2 to enable only one timeslot.
dsdplus commands click here dsdplus commands
Press 3 to enable both timeslots.


Display of the command line parameters in the console window title
is enabled/disabled by pressing the ‘-‘ key.

|
The symbol phase display in the console window title
is enabled/disabled by pressing the ‘|’ key.

dsdplus commands read more dsdplus commands
B
The display of background events (like LRRP updates) in the event log window
is enabled/disabled by pressing the ‘B’ key.

E
Use to enable or disable auto-muting of encrypted voice traffic.

F
Use when switching from monitoring a trunking system to a conventional system,
for example from DMR Con+ to DMR conventional.
dsdplus commands read more dsdplus commands

N
Press ‘N’ to force DSD+ to regather and display the current trunking site’s
neighbor list in the event log window. Useful for when the neighbor list has
scrolled off the window.

P
Press ‘P’ to toggle the raw signal polarity. You may need to do this when
decoding X2-TDMA or dPMR signals.

dsdplus commands get more info dsdplus commands
R
‘R’ starts/stops recording of discriminator audio. Use ‘R’ to make 60
second source recordings of tuning data. Rename the files to identify
what they are.

S
If the source audio window has been closed, this key will reopen it.

W
When the source audio, event log and channel activity windows have been
dsdplus commands read more dsdplus commands
placed onscreen where you want them, this key will display their current
locations in the event log window. You can copy these locations to
a batch file or shortcut.

Esc
To terminate real time decoding or .wav file processing, press Esc.

Window Title
dsdplus commands more info dsdplus commands
————

The window title area shows the command line parameters used (unless — specified),
symbol tracking/centering, auto-scaling factor, output audio gain,
symbol rate (2400/4800/9600), and protocol.

During raw audio recording, “” is displayed.

dsdplus commands check here dsdplus commands
Data files
———-

DSDPlus.networks

You can populate the DSDPlus.networks file with the network IDs and
network names for NEXEDGE, Connect Plus and Tier III trunking systems.
DSD+ will display the network names when those networks are monitored.
You can add or edit network entries in this file while DSD+ is running.

dsdplus commands website dsdplus commands
DSDPlus.sites

The names for each site on a network can be stored in this file.
Some non-networked DMR systems also broadcast system IDs,
so entries for them can also be added to this file.
DSD+ will use the contents of this file to display the name of the
currently monitored site as well as the names of sites in neighbor lists.
You can add or edit site entries in this file while DSD+ is running.

DSDPlus.groups
dsdplus commands website dsdplus commands

DSD+ will auto-populate this file with every group ID that is seen.
You can edit this file while DSD+ is running and add names/aliases to
group records.

DSDPlus.radios

DSD+ will auto-populate this file with every radio ID that is seen.
You can edit this file while DSD+ is running and add names/aliases to
radio records. This file replaces the DSDPlus.aliases file; if you
dsdplus commands more info dsdplus commands
already have a large aliases file, you can use a text editor’s
search/replace functionality to convert the contents of your aliases file
to match the format used in the radios file.

DSDPlus.frequencies

DSD+ uses this file to display frequency information when DSD+ is monitoring
a rest channel or control channel. The frequency records will also be
used to control channel steering for trunked voice following.

dsdplus commands read more dsdplus commands
Note:

DSD+ uses two channel numbers for each DMR RF channel:

Channel #1 = first RF channel, timeslot 1
Channel #2 = first RF channel, timeslot 2
Channel #3 = second RF channel, timeslot 1
Channel #4 = second RF channel, timeslot 2
Channel #5 = third RF channel, timeslot 1
Channel #6 = third RF channel, timeslot 2
dsdplus commands more info dsdplus commands

For all DMR systems (DMR, Cap+, Con+, TIII), only one channel record has
to be added to the DSDPlus.frequencies file for each RF channel.
You can use the channel number that corresponds to timeslot 1 or 2 and
DSD+ will use the same frequency information for the other timeslot.

All of the records in these data files have a protocol field;
DSD+ recognizes the following protocol name strings:
dsdplus commands here dsdplus commands

D-Star
IDAS
NEXEDGE48
NEXEDGE96
dPMR
DMR
Cap+
Con+
TIII
dsdplus commands more info dsdplus commands
P25
ProVoice

DMR TIII handling
—————–

Tier III control channels broadcast a 14 bit identifier that indicates
the network model (tiny/small/large/huge), network ID, service area
dsdplus commands get more info dsdplus commands
and site number for the current site and for neighboring sites.

Many TIII DMR systems are set up using these programming defaults:

large network (uses a 4 bit NID field)

NID = 13

Service area field length: 5 bits

dsdplus commands more info dsdplus commands
Site number field length: 3 bits

Physical sites are typically assigned unique area numbers (1, 2, 3, …)
while their site numbers are all set to 1. So odds are good that any network
you find will have sites with area.site values of 1.1, 2.1, 3.1, etc.

When -v3 or higher is used, DSD+ will display a site’s 14 bit “SysCode” in binary.

Example:

dsdplus commands more info dsdplus commands
CSBK Aloha SysCode=10.1100.00010000

The first two bits encode the network model value. Here, 10 = large model.

The next set of digits encodes the network ID. A zero value is used for NID 1,
so here, 1100 = 12 = NID 13.

The last set of digits encodes the area number and the site number.
Since these two fields do not have a fixed length, DSD+ cannot automatically
decode them. The dividing line between the two fields is selected when the
dsdplus commands click here dsdplus commands
network is created. This is similar to the variability found in Motorola Type I
fleetmaps.

To determine the correct field sizes, gather as many SysCodes as possible
by monitoring system sites and examining their neighbor lists.

Example:

CSBK Bcast SysCode=10.1100.00010000 Neighbor SysCode=10.1100.00000000, CC=600
CSBK Bcast SysCode=10.1100.00010000 Neighbor SysCode=10.1100.00001000, CC=622
dsdplus commands check here dsdplus commands

From this small sample we have these SysCodes:

10.1100.00000000
10.1100.00001000
10.1100.00010000

It becomes clear that the SysCodes should be decoded as:

10.1100.00000 000 Model=large NID=13 Area=1 Site=1
dsdplus commands check here dsdplus commands
10.1100.00001 000 Model=large NID=13 Area=2 Site=1
10.1100.00010 000 Model=large NID=13 Area=3 Site=1

So here, the area length is 5 and the site length is 3.

In the DSDPlus.networks file, an area length value can be appended to TIII
network records, so if the following line is added

TIII, 13, “network name goes here”, 5

dsdplus commands here dsdplus commands
DSD+ will use the supplied area length value to properly decode this system’s
SysCode fields.

These TIII sites can be added to the DSDPlus.sites file as:

TIII, 13, 1.1, “site name goes here”
TIII, 13, 2.1, “site name goes here”
TIII, 13, 3.1, “site name goes here”

The records in the DSDPlus.frequencies file also reference site numbers;
dsdplus commands get more info dsdplus commands
for TIII sites, use the same area.site format:

TIII, 13, 1.1, 600, 462.0, 0.0, 0
TIII, 13, 2.1, 622, 462.3, 0.0, 0

DSD+ Fast Lane
————–

dsdplus commands get more info dsdplus commands
Early access to features is being offered through the DSD+ Fast Lane program.

Fast Lane updates are expected to be released every 7 to 30 days.

Some Fast Lane updates WILL have issues/bugs. That is the nature of alpha software.

These are a few of the features that are being worked on:

better tablet support

dsdplus commands website dsdplus commands
IDAS/NEXEDGE/Cap+/Con+/TIII trunk voice following

per-call audio recordings

other needed DSD+ upgrades

FMP upgrades

squelch

dsdplus commands click here dsdplus commands
drift tracking

selectable sampling rates

adjustable windows sizes

TCP client/server mode (eliminates VAC / VB-C)

multiple VFOs

dsdplus commands check here dsdplus commands
Airspy support

Fully tested public releases will continue, but less frequently,
probably every 4 to 6 months.

In light of the extra workload the Fast Lane program will create,
the DSD+ team is asking Fast Laners for:

US$10 for one year of Fast Lane updates
dsdplus commands more info dsdplus commands

US$25 for unlimited Fast Lane updates

Donations above these amounts are welcomed, but it’s up to you.
We’re not looking to get rich here. Funds will be used for things like
needed hardware upgrades.

Funds can be sent our Paypal account ([email protected])

Please include a comment that specifies the email address that
dsdplus commands check here dsdplus commands
your Fast Lane updates should be sent to.


dsdplus commands

Tags: dsdplus commands, www bcfakes com

Leave a Comment