-----------------------------------------------------------------------------------------
  r00t's D-Star decoder - v0.2a
-----------------------------------------------------------------------------------------

History:

  v0.2a - first public release


Usage:

   dstar.exe [listen port] [soundcard nr]

 - Both parameters are optional, default listen port is 6116 and
   decoder will use default wavemapper soundcard (same as soundcard nr. -1).
 - To list soundcard numbers, use dstar.exe /?.

Notes:

 - The soundcard is always opened using 48000/16bit/mono mode.
 - The UDP server is limited to 16 users, listening on all interfaces,
   to connect DVTOOL for realtime voice, use "Connect to peer" connection.
 - D-Star data transmissions (full speed 4800Bd) are ignored and not decoded.
 - This program works without DV Dongle, however you will not get audio.
 - To decode D-Star signals correctly, the soundcard must be connected to
   FM discriminator output (or 9600Bd/PKT) of your receiver. The speaker
   output will NOT work. Some receivers have capacitors on their 'Packet' output
   which act as high-pass filters, making such output unusable (problems with
   Icom R1500 & R2500). Receivers already modified for decoding trunked system
   control channel or pager transmissions should work without any problems.
 - The decoder was not tested under w98/w95/wMe or Vista.

What this demodulator does:

 - Running the demodulator on its own will show you the contents of the D-Star 
   headers, and the callsign info sent in each D-Star frame. It will also show 
   what is being sent via the low-rate data channel, which is usually accessed by
   from the terminal window in the RS91 Icom software suite. The demodulator will
   also stream the voice data to a UDP port.
 - Running the demodulator in conjunction with a DV-Dongle and DV-Tool from 
   http://www.opendstar.org/tools/DVDongle-manual/ will allow you to do all of the 
   above, plus give you real-time demodulated D-Star audio. (Note: The demodulator
   cannot recover the audio completly in software due to the licensing costs of the 
   DVSI AMBE speech codec, hence the need to interface to the DV-Dongle and DV-Tool)

DV-Tool settings:
 - With the dstar.exe running on your PC, load the DV-Tool. Open the relevant DV-Dongle
   com port. In the 'action:' section, select 'Connect to Peer' and enter 127.0.0.1
   as the IP address and port 6116.
 - Press the 'Start' button.
 - When dstar.exe demodulates D-Star data, the voice data will be streamed to DV-Tool
   and audio will come out of the PC speaker.


Latest version will always be available
in the Files section of D-Star Software radio group:

 >>> http://groups.yahoo.com/group/dstarsoftware/


-----------------------------------------------------------------------------------------
                                                                    Jakub Hruska / r00t
-----------------------------------------------------------------------------------------