FX.25

Author: wb2osz

CHANGES.md

@@ -5,15 +5,19 @@
 ## Version 1.6  --  Under Development ##
 
 
-### Bugs Fixed: ###
+### New Build Procedure: ###
+
+
+- Rather than trying to keep a bunch of different platform specific Makefiles in sync, "cmake" is now used for greater portability and easier maintenance.
 
-- Proper counting of frames in transmit queue for AGW protocol 'Y' command.
 
 
 
 ### New Features: ###
 
 
+- "-X" option enables FX.25 transmission.  FX.25 reception is always enabled so you don't need to do anything special.
+
 - "-t" option now accepts more values to accommodate inconsistent handling of text color control codes by different terminal emulators.  The default, 1, should work with most modern terminal types.  If the colors are not right, try "-t 9" to see the result of the different choices and pick the best one.  If none of them look right, file a bug report and specify: operating system version (e.g. Raspbian Buster), terminal emulator type and version (e.g.  LXTerminal 0.3.2).   Include a screen capture.
 
 
@@ -27,10 +31,20 @@
 
 
 
+### Bugs Fixed: ###
+
+- Proper counting of frames in transmit queue for AGW protocol 'Y' command.
+
+
+
 ### New Documentation: ###
 
+- ***AX.25 + FEC = FX.25***
+
 - ***AX.25 Throughput: Why is 9600 bps Packet Radio only twice as fast as 1200?***
 
+- [***Ham Radio of Things - IoT over Ham Radio***](https://github.com/wb2osz/hrot)
+
 - Power Point slide show in separate repository.  [https://github.com/wb2osz/direwolf-presentation ](https://github.com/wb2osz/direwolf-presentation)
 
 

README.md

@@ -9,7 +9,10 @@ Why settle for mediocre receive performance from a 1980's technology  TNC using
 
 ![](tnc-test-cd-results.png)
 
- 
+Dire Wolf now includes [FX.25](https://en.wikipedia.org/wiki/FX.25_Forward_Error_Correction/) which adds Forward Error Correction (FEC) in a way that is completely compatible with existing systems.  If both ends are capable of FX.25, your information will continue to get through under conditions where regular AX.25 is completely useless.
+
+![](fx25.png)
+
 Dire Wolf is a modern software replacement for the old 1980's style TNC built with special hardware.
 
 Without any additional software, it can perform as:
@@ -20,7 +23,7 @@ Without any additional software, it can perform as:
 - [APRStt](http://www.aprs.org/aprstt.html) gateway
 
 
-It can also be used as a virtual TNC for other applications such as [APRSIS32](http://aprsisce.wikidot.com/), [UI-View32](http://www.ui-view.net/), [Xastir](http://xastir.org/index.php/Main_Page), [APRS-TW](http://aprstw.blandranch.net/), [YAAC](http://www.ka2ddo.org/ka2ddo/YAAC.html), [UISS](http://users.belgacom.net/hamradio/uiss.htm), [Linux AX25](http://www.linux-ax25.org/wiki/Main_Page), [SARTrack](http://www.sartrack.co.nz/index.html), [Winlink Express (formerly known as RMS Express, formerly known as Winlink 2000 or WL2K)](http://www.winlink.org/RMSExpress), [BPQ32](http://www.cantab.net/users/john.wiseman/Documents/BPQ32.html), [Outpost PM](http://www.outpostpm.org/), and many others.
+It can also be used as a virtual TNC for other applications such as [APRSIS32](http://aprsisce.wikidot.com/), [UI-View32](http://www.ui-view.net/), [Xastir](http://xastir.org/index.php/Main_Page), [APRS-TW](http://aprstw.blandranch.net/), [YAAC](http://www.ka2ddo.org/ka2ddo/YAAC.html), [UISS](http://users.belgacom.net/hamradio/uiss.htm), [Linux AX25](http://www.linux-ax25.org/wiki/Main_Page), [SARTrack](http://www.sartrack.co.nz/index.html), [Winlink Express (formerly known as RMS Express, formerly known as Winlink 2000 or WL2K)](http://www.winlink.org/RMSExpress), [BPQ32](http://www.cantab.net/users/john.wiseman/Documents/BPQ32.html), [Outpost PM](http://www.outpostpm.org/), [Ham Radio of Things](https://github.com/wb2osz/hrot), and many others.
 
 
 ## Features & Benefits ##
@@ -48,6 +51,11 @@ It can also be used as a virtual TNC for other applications such as [APRSIS32](h
 
     IGate stations allow communication between disjoint radio networks by allowing some content to flow between them over the Internet.
 
+- **Ham Radio of Things.**
+
+    There have been occasional mentions of merging Ham Radio with the Internet of Things but only ad hoc incompatible narrowly focused applications. Here is a proposal for a standardized more flexible method so different systems can communicate with each other.
+
+    [Ham Radio of Things - IoT over Ham Radio](https://github.com/wb2osz/hrot)
 
 - **AX.25 v2.2 Link Layer.**
 
@@ -63,7 +71,7 @@ It can also be used as a virtual TNC for other applications such as [APRSIS32](h
 
     Lower cost and better performance than specialized hardware. 
 
-    Compatible interfaces include [UDRC](https://nw-digital-radio.groups.io/g/udrc/wiki/UDRC%E2%84%A2-and-Direwolf-Packet-Modem), [SignaLink USB](http://www.tigertronics.com/slusbmain.htm), [DMK URI](http://www.dmkeng.com/URI_Order_Page.htm), [RB-USB RIM](http://www.repeater-builder.com/products/usb-rim-lite.html), [RA-35](http://www.masterscommunications.com/products/radio-adapter/ra35.html), and many others.
+    Compatible interfaces include [DRAWS](http://nwdigitalradio.com/draws/), [UDRC](https://nw-digital-radio.groups.io/g/udrc/wiki/UDRC%E2%84%A2-and-Direwolf-Packet-Modem), [SignaLink USB](http://www.tigertronics.com/slusbmain.htm), [DMK URI](http://www.dmkeng.com/URI_Order_Page.htm), [RB-USB RIM](http://www.repeater-builder.com/products/usb-rim-lite.html), [RA-35](http://www.masterscommunications.com/products/radio-adapter/ra35.html), [DINAH](https://hamprojects.info/dinah/), [SHARI](https://hamprojects.info/shari/), and many others.
 
 
 

doc/AX25_plus_FEC_equals_FX25.pdf

@@ -8,6 +8,7 @@ install(FILES "${CUSTOM_DOC_DIR}/APRS-Telemetry-Toolkit.pdf" DESTINATION ${INSTA
 install(FILES "${CUSTOM_DOC_DIR}/APRStt-Implementation-Notes.pdf" DESTINATION ${INSTALL_DOC_DIR})
 install(FILES "${CUSTOM_DOC_DIR}/APRStt-interface-for-SARTrack.pdf" DESTINATION ${INSTALL_DOC_DIR})
 install(FILES "${CUSTOM_DOC_DIR}/APRStt-Listening-Example.pdf" DESTINATION ${INSTALL_DOC_DIR})
+install(FILES "${CUSTOM_DOC_DIR}/AX25_plus_FEC_equals_FX25.pdf" DESTINATION ${INSTALL_DOC_DIR})
 install(FILES "${CUSTOM_DOC_DIR}/Bluetooth-KISS-TNC.pdf" DESTINATION ${INSTALL_DOC_DIR})
 install(FILES "${CUSTOM_DOC_DIR}/Going-beyond-9600-baud.pdf" DESTINATION ${INSTALL_DOC_DIR})
 install(FILES "${CUSTOM_DOC_DIR}/Raspberry-Pi-APRS.pdf" DESTINATION ${INSTALL_DOC_DIR})
@@ -16,3 +17,4 @@ install(FILES "${CUSTOM_DOC_DIR}/Raspberry-Pi-SDR-IGate.pdf" DESTINATION ${INSTA
 install(FILES "${CUSTOM_DOC_DIR}/Successful-APRS-IGate-Operation.pdf" DESTINATION ${INSTALL_DOC_DIR})
 install(FILES "${CUSTOM_DOC_DIR}/User-Guide.pdf" DESTINATION ${INSTALL_DOC_DIR})
 install(FILES "${CUSTOM_DOC_DIR}/WA8LMF-TNC-Test-CD-Results.pdf" DESTINATION ${INSTALL_DOC_DIR})
+install(FILES "${CUSTOM_DOC_DIR}/Why-is-9600-only-twice-as-fast-as-1200.pdf" DESTINATION ${INSTALL_DOC_DIR})

doc/CMakeLists.txt

@@ -27,6 +27,14 @@ Brief summary of packet radio / APRS history and the capbilities of Dire Wolf.
 These dive into more detail for specialized topics or typical usage scenarios.
 
 
+
+- [**AX.25 + FEC = FX.25**](AX25_plus_FEC_equals_FX25.pdf)  [ [*download*](../../../raw/dev/doc/AX25_plus_FEC_equals_FX25.pdf) ]
+
+	What can you do if your radio signal isn’t quite strong enough to get through reliably?  Move to higher ground?  Get a better antenna?  More power?  Use very narrow bandwidth and very slow data?
+
+    Sometimes those are not options.  Another way to improve communication reliability is to add redundant information so the message will still get through even if small parts are missing.  FX.25 adds forward error correction (FEC) which maintaining complete compatibility with older equipment.
+
+
 - [**AX.25 Throughput: Why is 9600 bps Packet Radio only twice as fast as 1200?**](Why-is-9600-only-twice-as-fast-as-1200.pdf)  [ [*download*](../../../raw/dev/doc/Why-is-9600-only-twice-as-fast-as-1200.pdf) ]
 
 	Simply switching to a higher data rate will probably result in great disappointment.  You might expect it to be 8 times faster but it can turn out to be only twice as fast.

doc/README.md

@@ -44,6 +44,11 @@ list(APPEND direwolf_SOURCES
   encode_aprs.c
   fcs_calc.c
   fcs_calc.c
+  fx25_encode.c
+  fx25_extract.c
+  fx25_init.c
+  fx25_rec.c
+  fx25_send.c
   gen_tone.c
   hdlc_rec.c
   hdlc_rec2.c
@@ -257,6 +262,9 @@ target_link_libraries(log2gpx
 list(APPEND gen_packets_SOURCES
   gen_packets.c
   ax25_pad.c
+  fx25_encode.c
+  fx25_init.c
+  fx25_send.c
   hdlc_send.c
   fcs_calc.c
   gen_tone.c
@@ -284,6 +292,9 @@ list(APPEND atest_SOURCES
   demod_psk.c
   demod_9600.c
   dsp.c
+  fx25_extract.c
+  fx25_init.c
+  fx25_rec.c
   hdlc_rec.c
   hdlc_rec2.c
   multi_modem.c
@@ -426,6 +437,33 @@ if(WIN32 OR CYGWIN)
   target_link_libraries(ttcalc ws2_32)
 endif()
 
+
+# Sample for packet radio server application.
+# appserver
+list(APPEND appserver_SOURCES
+  appserver.c
+  agwlib.c
+  dwsock.c
+  dtime_now.c
+  ax25_pad.c
+  fcs_calc.c
+  textcolor.c
+  )
+
+add_executable(appserver
+  ${appserver_SOURCES}
+  )
+
+target_link_libraries(appserver
+  ${MISC_LIBRARIES}
+  Threads::Threads
+  )
+
+if(WIN32 OR CYGWIN)
+  target_link_libraries(appserver ws2_32)
+endif()
+
+
 install(TARGETS direwolf DESTINATION ${INSTALL_BIN_DIR})
 install(TARGETS decode_aprs DESTINATION ${INSTALL_BIN_DIR})
 install(TARGETS text2tt DESTINATION ${INSTALL_BIN_DIR})
@@ -438,6 +476,7 @@ install(TARGETS gen_packets DESTINATION ${INSTALL_BIN_DIR})
 install(TARGETS atest DESTINATION ${INSTALL_BIN_DIR})
 install(TARGETS ttcalc DESTINATION ${INSTALL_BIN_DIR})
 install(TARGETS kissutil DESTINATION ${INSTALL_BIN_DIR})
+install(TARGETS appserver DESTINATION ${INSTALL_BIN_DIR})
 if(UDEV_FOUND)
   install(TARGETS cm108 DESTINATION ${INSTALL_BIN_DIR})
 endif()