SHARE
TWEET

README

a guest Dec 24th, 2013 9,139 Never
Not a member of Pastebin yet? Sign Up, it unlocks many cool features!
  1.  
  2.  
  3. DSDPlus User Guide
  4. -------------------
  5.  
  6.  
  7. Installation
  8.  
  9. This application can create many audio files and log files,
  10. so consider using a dedicated folder to run it from.
  11.  
  12. The folder can be on your desktop (desktop\DSDPlus) or
  13. off the root folder (C:\DSDPlus), for example.
  14.  
  15. After copying the zip file contents to the installation folder,
  16. you should probably create a shortcut on your desktop.
  17. The shortcut should run cmd.exe in the installation folder
  18.  
  19. Shortcut properties:
  20.  
  21. Target: %windir%\system32\cmd.exe
  22.  
  23. Start in: <your DSDPlus folder>
  24.  
  25. Layout / Window size:  Width should be about 100
  26.  
  27.  
  28.  
  29.  
  30. Usage/Options Summary
  31.  
  32. Usage:
  33.  
  34.   DSDPlus [options]            Live scanner mode
  35.   DSDPlus [options] <file      Decode from .wav file
  36.   DSDPlus -h                   Show help
  37.  
  38. Options ( [...] = default value):
  39.  
  40. Display/Logging options:
  41.   --          Don't show command line options in window title
  42.   -v<num>     Frame information verbosity (0-4) [-v2]
  43.  
  44. Input/Output options:
  45.   -i<spec>    Input audio device (1-255) and channel (M/L/R) [-i1M]
  46.  
  47.   -g<num>     Output audio gain (0.001-999; 0=auto) [-g0]
  48.  
  49.   -o<spec>    Output audio device (1-255; 0=none) and channel (M/L/R) [-o1]
  50.                 in/out channels are optional; default=in:mono, out:mode based
  51.  
  52.   -Och <file> Output audio file channel count and name/type [-O DSDPlus.wav]
  53.                 ch: M=mono,S=stereo,blank=auto; file: .wav or .mp3 (NUL=none)
  54.  
  55.   -I<num>     Create new .wav/.mp3 file every <num> minutes (1440=daily) [-I0]
  56.  
  57. Decoder options:
  58.   -mp         optimize for PSK modulation
  59.  
  60.   -fa         Auto-detect all protocols / frame types [-fa]
  61.   -fd         Decode only D-STAR (no audio)
  62.   -fn         Decode only NXDN4800 (Kenwood NEXEDGE and Icom IDAS)
  63.   -fN         Decode only NXDN9600 (Kenwood NEXEDGE)
  64.   -fr         Decode only DMR/MotoTRBO
  65.   -f1         Decode only P25 Phase 1
  66.   -fx         Decode only X2-TDMA
  67.   -fp         Decode only ProVoice
  68.  
  69.   -xx         Expect inverted X2-TDMA signal
  70.   -u<num>     Unvoiced speech quality (1-64) [-u3]
  71.  
  72. Advanced decoder options:
  73.   -dr<num>    Rolloff filter (1-5; 0=auto) [-dr0]
  74.   -dh<num>    Hotspot size (1-8; 0=auto) [-dh0]
  75.   -ds<num>    Scaling factor (50-80; not used with D-Star or ProVoice) [-ds64]
  76.   -dd<num>    Damping level (1-100; not used with D-Star or ProVoice) [-dd10]
  77.   -dv<num>    Viewport size (1-30; not used with D-Star or ProVoice) [-dv20]
  78.  
  79. Active keys:
  80.   -           Toggle command line options display
  81.   I           Toggle input audio level display
  82.   R           Start/stop recording of raw input audio to .wav file
  83.   S           Display group/user stats
  84.   Esc         Terminate real time decoding
  85.   Ctrl-C      Terminate .wav file decoding
  86.  
  87.  
  88.  
  89. Run Modes
  90.  
  91. The program can decode live discriminator audio or recorded .wav files.
  92. Recorded audio files must be 48 or 96 kHz 16 bit mono PCM .wav files.
  93.  
  94.  
  95.  
  96. Logging
  97.  
  98. -v
  99. -v0 generates minimal output.
  100. Use -v3 for maximum data logging.
  101. Program output can be sent to a log file ( DSDPlus >logfile )
  102.  
  103.  
  104.  
  105. Input/Output
  106.  
  107. -i -o
  108. WaveIn/Out devices are listed at program startup.
  109. Select your devices if you don't want to use the defaults.
  110. Use -o0 to disable output audio.
  111.  
  112. -O
  113. By default, all synthesized audio is written/appended to DSDPlus.wav
  114. Use -O name.ext to write synthesized audio to another .wav or .mp3 file.
  115. Use -O NUL to disable recording of synthesized audio.
  116.  
  117. -I
  118. Use -I# to start a new synthesized audio recording file every # minutes.
  119.  
  120.  
  121.  
  122. Decoder Options
  123.  
  124. -fa
  125. Using -fa (or nothing) will auto-decode all supported protocols.
  126. Polarity of signals is auto-detected.
  127.  
  128. -fd -fn -fN -fr -f1 -fx -fp
  129. When monitoring a single type of traffic,
  130. locking the protocol can provide slightly better decoding results.
  131.  
  132. -D1 -D2
  133. Use -D# to control which DMR voice slot is decoded and synthesized.
  134.  
  135. -xr -xR
  136. Use these to force the polarity used for DMR decoding.
  137. If these are not used, the program will attempt to auto-detect DMR polarity.
  138.  
  139. -xx
  140. X2-TDMA signals are assumed to be inverted unless this option is used.
  141.  
  142. -u
  143. Lower values (slightly) reduce CPU load.
  144.  
  145.  
  146.  
  147. Advanced Decoder Options
  148.  
  149. Fine tuning the advanced decoder options can greatly increase decoding rates.
  150.  
  151. Different systems, protocols, receivers and PC sound devices require unique
  152. fine tuning values.
  153.  
  154. A 60 second recording of voice traffic on a target system should be made
  155. and used as the input for tuning runs.  Use the 'R' key to make recordings.
  156.  
  157. To speed up the tuning process, audio synthesis should be disabled
  158. and the protocol should be locked correctly:
  159.  
  160. DSDPlus <rawAudio.wav -o0 -O NUL -f1
  161.  
  162. A decoding score will be displayed.
  163.  
  164. Pressing the up arrow will redisplay the previous command line,
  165. which you can then edit and re-run.
  166.  
  167. Adjust a single parameter to determine which value produces the highest score:
  168.  
  169. DSDPlus <rawAudio.wav -o0 -O NUL -f1 -dr1
  170. DSDPlus <rawAudio.wav -o0 -O NUL -f1 -dr2
  171. DSDPlus <rawAudio.wav -o0 -O NUL -f1 -dr3
  172. DSDPlus <rawAudio.wav -o0 -O NUL -f1 -dr4
  173.  
  174. When the optimal value for a tuning parameter is determined,
  175. use that value (#) and add another parameter and repeat the tuning steps:
  176.  
  177. DSDPlus <rawAudio.wav -o0 -O NUL -f1 -dr# -dh1
  178. DSDPlus <rawAudio.wav -o0 -O NUL -f1 -dr# -dh2
  179. DSDPlus <rawAudio.wav -o0 -O NUL -f1 -dr# -dh3
  180. ...
  181.  
  182.  
  183. Repeat until all advanced decoding options have been fine tuned.
  184.  
  185. Check your tuning by re-enabling voice synthesis:
  186.  
  187. DSDPlus <rawAudio.wav -f1 -dr# -dh# -ds# -dd# -dv#
  188.  
  189.  
  190. The recommended tuning order is Rolloff, Hotspot, Damping, Viewport.
  191.  
  192. Damping and Viewport settings do not affect D-Star or ProVoice,
  193. so don't bother tweaking them for those protocols.
  194.  
  195. The Scaling factor value is an initial value only.
  196. It auto-optimizes during frame decoding.
  197.  
  198. The default Viewport setting of 20 is usually optimal.
  199.  
  200.  
  201. When the optimal values for a system + receiver + sound input is determined,
  202. consider creating a batch file to store the settings:
  203.  
  204. Local-PD.bat:
  205.  
  206. DSDPlus -f1 -dr1 -dh3 -ds66 -dd40 -dv20 -O PD.mp3
  207.  
  208. DMR.bat:
  209.  
  210. DSDPlus -fd -d21 -dh2 -ds58 -dd5 -dv20 -O DMR.mp3
  211.  
  212. Then to monitor a specific system, run its batch file.
  213.  
  214. If you scan multiple systems and protocols with a single receiver,
  215. you can run multiple copies of DSDPlus in parallel with each one
  216. protocol-locked and fine tuned as required.  Each copy of the program
  217. should write synthesized audio to separate files.
  218.  
  219.  
  220.  
  221. Active Keys
  222.  
  223. R
  224. 'R' starts/stops recording of discriminator audio.  Use 'R' to make 60
  225. second source recordings of tuning data.  Rename the files to identify
  226. what they are.
  227.  
  228. Esc
  229. To terminate real time decoding, press Esc.
  230.  
  231. Ctrl-C
  232. To terminate .wav file decoding, press Ctrl-C.
  233.  
  234.  
  235.  
  236. Window Title
  237.  
  238. The window title area shows the command line parameters used (unless -- specified),
  239. symbol tracking/centering, auto-scaling factor, output audio gain,
  240. symbol rate (2400/4800/9600), and protocol.
  241.  
  242. During raw audio recording, "<REC>" is displayed.
  243.  
  244. ---
RAW Paste Data
We use cookies for various purposes including analytics. By continuing to use Pastebin, you agree to our use of cookies as described in the Cookies Policy. OK, I Understand
 
Top