UKHAS Wiki

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== dl-fldigi ======


Dl Fldigi is an adapted version of the excellent free [[http://www.w1hkj.com/Fldigi.html|FLdigi]] soundcard decoding software. It takes the audio from your radio, decodes the balloon's signal, and then sends the [[communication:protocol|telemetry]] it's found over the internet to a server running habitat, which plots the payloads position on to the SpaceNear map.

Version specific usage notes are available here, but you also may want to read [[guides:tracking_guide]].

** Please use version 3 from now on **

===== Version 3.1 =====

  * Source: [[http://github.com/jamescoxon/dl-fldigi|dl-fldigi on Github]]. The git commit of the latest stable release is 2abd6a7 (tag DL3.1).
  * Binaries: 
    * Mac OS X: [[https://github.com/ukhas/dl-fldigi/releases/download/DL3.1/dl-fldigi-DL3.1-macosx-2abd6a7-d955180.zip|dl-fldigi-DL3.1-macosx-2abd6a7-d955180.zip]]
    * Mac OS X (**10.5.8 ONLY**): [[https://github.com/ukhas/dl-fldigi/releases/download/DL3.1/dl-fldigi-DL3.1-macosx-10.5.8-2abd6a7.dmg|dl-fldigi-DL3.1-macosx-10.5.8-2abd6a7.dmg]] 
    * Windows: [[https://github.com/ukhas/dl-fldigi/releases/download/DL3.1/dl-fldigi-DL3.1-windows-2abd6a7.exe|dl-fldigi-DL3.1-windows-2abd6a7.exe]]
    * Ubuntu Linux debs: [[https://launchpad.net/~simrunbasuita/+archive/dl-fldigi]]
    * Raspbian: [[https://ukhas.org.uk/projects:dl-fldigi:install-raspbian]]
  * Source:
    * Zip: [[https://github.com/jamescoxon/dl-fldigi/archive/DL3.1.zip|dl-fldigi-DL3.1.zip]]
    * Compile on Ubuntu: [[projects:dl-fldigi:build-ubuntu]]
    * Compile on Raspbian (Raspberry Pi): [[projects:dl-fldigi:build-raspbian]]
    * Compile on openSUSE: [[projects:dl-fldigi:build-openSUSE]]
    * Compile on Mac OS X 10.8.2: [[projects:dl-fldigi:build-osx]]

  * If you start dl-fldigi in "Slim HAB UI" mode, then it will, by default, be "online". If not, then you need to bring it online via the option in its configuration tab, or the DL Client menu. While "offline", the application will neither upload sentences nor download data (we did not want the application to "phone home" every time it is started!).
  * When "online" is enabled, it downloads information about payloads. If you are using the HAB UI, the payload select button will be obvious on the left of the HAB bar. Otherwise, open the DL Client->Payload configure tab. Select the payload, and then click the autoconfigure button. Fldigi will be set up with the correct RTTY options and telemetry string patterns.
  * This version of dl-fldigi has a built in update checking feature (which is only active if "online", and can be disabled in the settings). It will prompt you if there is a new release.

===== Version 2.0 =====

  * Source: [[http://github.com/jamescoxon/dl-fldigi|dl-fldigi on Github]]
  * Binaries:
    * Mac OS X: [[https://github.com/downloads/jamescoxon/dl-fldigi/dl-fldigi-3.20.29.r115.1.dmg|dl-fldigi-3.20.29-r115.1.dmg]]
    * Windows: [[https://github.com/downloads/jamescoxon/dl-fldigi/dl-fldigi-3.20.29.r115.1.exe|dl-fldigi-3.20.29.r115.1.exe]]
    * Ubuntu Linux deb: [[https://launchpad.net/~simrunbasuita/+archive/dl-fldigi]]
  * Source:
    * Zip: [[https://github.com/jamescoxon/dl-fldigi/zipball/v3.20.29.r115|dl-fldigi-3.20.29.r115.zip]]
    * Compile on Ubuntu: [[projects:dl-fldigi:build-ubuntu]]
    * Compile on openSUSE: [[projects:dl-fldigi:build-openSUSE]]
  * This is the collaborative efforts of many members of UKHAS. It is a rewrite of Version 1.0.
  * If you start dl-fldigi in "Slim HAB UI" mode, then it will, by default, be "online". If not, then you need to bring it online via the option in its configuration tab, or the DL Client menu. While "offline", the application will neither upload sentences nor download data (we did not want the application to "phone home" every time it is started!).
  * You can either set up the strings that trigger the uploader manually on the Dl Client configure tab, or you can use the Autoconfigure button. When "online" is enabled, it downloads information about payloads. If you are using the HAB UI, the payload select button will be obvious on the left of the HAB bar. Otherwise, open the DL Client->Payload configure tab. Select the payload, and then click the autoconfigure button. Fldigi will be set up with the correct RTTY options and telemetry string patterns.

  * More questions, or want advice? Go to the [[https://web.libera.chat/#highaltitude|#highaltitude]] IRC channel on Libera.Chat.

===== Version 1.0 =====

  * The latest 'stable' release (soon to be deprecated!) is any of the binaries that are more then r80 (there is very little difference between the r8x series): there is no need to run a separate python client, will upload status and also received telemetry to the server.
  * Source can be found on [[http://code.google.com/p/dl-fldigi/|dl-fldigi at Google Code]]. (The release revision is r85, however, if you anything to do with the source we suggest that you use Version 2.0, below, available on github. This a totally rewritten dl-fldigi and is very stable (we will be releasing it very very soon).
  * Windows XP & Vista, Mac OSX binaries are avialable at [[http://code.google.com/p/dl-fldigi/downloads/list|dl-fldigi downloads at Google Code]].
  * Ubuntu and Debian packages are available in [[https://launchpad.net/~simrunbasuita/+archive/dl-fldigi|Simrun Basuita's PPA]]
  * In order to put this version into "semi-offline" mode, where no sentences are uploaded (for testing purposes,
    * Configure > Operator > Misc > Text Capture and deselect the "Enable detection & extraction".
    * In this mode, dl-fldigi will still post that you are listening to [[http://www.robertharrison.org/listen/loggers.php|loggers page]]
    * Don't forget to undo changes when you want to contribute to the distributed listener network again!

===== Version 0.5 =====

  * This was based on a python script that would collect the dumped output from fldigi and upload extracted telemetry strings. It is largely obsolete.
  * It can be found on the [[http://spacenear.us/wiki/doku.php?id=dlistening:client|Atlantic Halo Wiki]]

===== Troubleshooting =====

==== Crashes during operation or fails to start on Windows ====

dl-fldigi stores the settings and log files in a folder called 'dlfldigi.files' in your User Directory ( eg. C:\Users\Phil ) This can get corrupted causing crashes and instability. We are going to delete this so that dl-fldigi creates a new, uncorrupted version.

  * **Note:** This will delete all saved SSDV Pics and Telemetry Logs, please backup these before continuing. You may also want to take a note of the Latitude/Longitude of your location to set them up again at the end.

  * Make sure dl-fldigi is not running.
  * Delete the folder 'dlfldigi.files' in your User Directory ( eg. C:\Users\Phil )
  * Start dl-fldigi, the settings have been deleted so you will have to enter at least your Callsign and Latitude/Longitude/Altitude of your location again. Happy hab-tracking!