Pull Request 481 - Replace direwolf icon

This commit is contained in:
wb2osz 2025-04-29 15:00:30 -04:00
parent c1e669bbb0
commit 873b171e48
3 changed files with 149 additions and 192 deletions

View File

@ -1,20 +1,20 @@
# Revision History
# Revision History #
## Version 1.8 -- Development Version ## Version 1.8 -- Development Version
### New Features: ### ### New Features:
- Support for CM108 PTT on Mac.
- New NCHANNEL feature to map a channel number to an external network TCP KISS TNC. See xxx for example of a bridge to LoRa APRS. See [APRS-LoRa-VHF-APRS-Bridge.pdf](https://github.com/wb2osz/direwolf-doc/blob/main/APRS-LoRa-VHF-APRS-Bridge.pdf) for explanation. - New NCHANNEL feature to map a channel number to an external network TCP KISS TNC. See xxx for example of a bridge to LoRa APRS. See [APRS-LoRa-VHF-APRS-Bridge.pdf](https://github.com/wb2osz/direwolf-doc/blob/main/APRS-LoRa-VHF-APRS-Bridge.pdf) for explanation.
- [http://www.aprs.org/aprs11/tocalls.txt](http://www.aprs.org/aprs11/tocalls.txt) has been abandoned since the end of 2021. [https://github.com/aprsorg/aprs-deviceid](https://github.com/aprsorg/aprs-deviceid) is now considered to be the authoritative source of truth for the vendor/model encoding. - [http://www.aprs.org/aprs11/tocalls.txt](http://www.aprs.org/aprs11/tocalls.txt) has been abandoned since the end of 2021. [https://github.com/aprsorg/aprs-deviceid](https://github.com/aprsorg/aprs-deviceid) is now considered to be the authoritative source of truth for the vendor/model encoding.
## Version 1.7 -- October 2023 ## - New direwolf icon.
## Version 1.7 -- October 2023
### New Documentation: ### ### New Documentation:
Additional documentation location to slow down growth of main repository. [https://github.com/wb2osz/direwolf-doc](https://github.com/wb2osz/direwolf-doc) . These are more oriented toward achieving a goal and understanding, as opposed to the User Guide which describes the functionality. Additional documentation location to slow down growth of main repository. [https://github.com/wb2osz/direwolf-doc](https://github.com/wb2osz/direwolf-doc) . These are more oriented toward achieving a goal and understanding, as opposed to the User Guide which describes the functionality.
@ -28,10 +28,7 @@ Additional documentation location to slow down growth of main repository. [http
- ***Understanding APRS Packets*** - ***Understanding APRS Packets***
### New Features:
### New Features: ###
- New ICHANNEL configuration option to map a KISS client application channel to APRS-IS. Packets from APRS-IS will be presented to client applications as the specified channel. Packets sent, by client applications, to that channel will go to APRS-IS rather than a radio channel. Details in ***Internal-Packet-Routing.pdf***. - New ICHANNEL configuration option to map a KISS client application channel to APRS-IS. Packets from APRS-IS will be presented to client applications as the specified channel. Packets sent, by client applications, to that channel will go to APRS-IS rather than a radio channel. Details in ***Internal-Packet-Routing.pdf***.
@ -57,9 +54,7 @@ Additional documentation location to slow down growth of main repository. [http
> >
> Add: "FX25TX 1" (or 16 or 32 or 64) > Add: "FX25TX 1" (or 16 or 32 or 64)
### Bugs Fixed:
### Bugs Fixed: ###
- The t/m packet filter incorrectly included bulletins. It now allows only "messages" to specific stations. Use of t/m is discouraged. i/180 is the preferred filter for messages to users recently heard locally. - The t/m packet filter incorrectly included bulletins. It now allows only "messages" to specific stations. Use of t/m is discouraged. i/180 is the preferred filter for messages to users recently heard locally.
@ -67,24 +62,21 @@ Additional documentation location to slow down growth of main repository. [http
- Fixed build for Alpine Linux. - Fixed build for Alpine Linux.
### Notes: ### ### Notes:
The Windows binary distribution now uses gcc (MinGW) version 11.3.0. The Windows binary distribution now uses gcc (MinGW) version 11.3.0.
The Windows version is built for both 32 and 64 bit operating systems. The Windows version is built for both 32 and 64 bit operating systems.
Use the 64 bit version if possible; it runs considerably faster. Use the 64 bit version if possible; it runs considerably faster.
## Version 1.6 -- October 2020 ## ## Version 1.6 -- October 2020
### New Build Procedure: ###
### 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. This was contributed by Davide Gerhard. - Rather than trying to keep a bunch of different platform specific Makefiles in sync, "cmake" is now used for greater portability and easier maintenance. This was contributed by Davide Gerhard.
- README.md has a quick summary of the process. More details in the ***User Guide***. - README.md has a quick summary of the process. More details in the ***User Guide***.
### New Features:
### New Features: ###
- "-X" option enables FX.25 transmission. FX.25 reception is always enabled so you don't need to do anything special. "What is FX.25?" you might ask. It is forward error correction (FEC) added in a way that is completely compatible with an ordinary AX.25 frame. See new document ***AX25\_plus\_FEC\_equals\_FX25.pdf*** for details. - "-X" option enables FX.25 transmission. FX.25 reception is always enabled so you don't need to do anything special. "What is FX.25?" you might ask. It is forward error correction (FEC) added in a way that is completely compatible with an ordinary AX.25 frame. See new document ***AX25\_plus\_FEC\_equals\_FX25.pdf*** for details.
@ -94,7 +86,6 @@ Use the 64 bit version if possible; it runs considerably faster.
- "-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. - "-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.
- "-g" option to force G3RUH mode for lower speeds where a different modem type may be the default. - "-g" option to force G3RUH mode for lower speeds where a different modem type may be the default.
- 2400 bps compatibility with MFJ-2400. See ***2400-4800-PSK-for-APRS-Packet-Radio.pdf*** for details - 2400 bps compatibility with MFJ-2400. See ***2400-4800-PSK-for-APRS-Packet-Radio.pdf*** for details
@ -103,15 +94,11 @@ Use the 64 bit version if possible; it runs considerably faster.
- Add support for Multi-GNSS NMEA sentences. - Add support for Multi-GNSS NMEA sentences.
### Bugs Fixed:
### Bugs Fixed: ###
- Proper counting of frames in transmit queue for AGW protocol 'Y' command. - Proper counting of frames in transmit queue for AGW protocol 'Y' command.
### New Documentation:
### New Documentation: ###
- ***AX.25 + FEC = FX.25*** - ***AX.25 + FEC = FX.25***
@ -125,18 +112,15 @@ Use the 64 bit version if possible; it runs considerably faster.
- [***Dire Wolf PowerPoint Slide Show***](https://github.com/wb2osz/direwolf-presentation) - [***Dire Wolf PowerPoint Slide Show***](https://github.com/wb2osz/direwolf-presentation)
### Notes: ### ### Notes:
The Windows binary distribution now uses gcc (MinGW) version 7.4.0. The Windows binary distribution now uses gcc (MinGW) version 7.4.0.
The Windows version is built for both 32 and 64 bit operating systems. The Windows version is built for both 32 and 64 bit operating systems.
Use the 64 bit version if possible; it runs considerably faster. Use the 64 bit version if possible; it runs considerably faster.
## Version 1.5 -- September 2018
### New Features:
## Version 1.5 -- September 2018 ##
### New Features: ###
- PTT using GPIO pin of CM108/CM119 (e.g. DMK URI, RB-USB RIM), Linux only. - PTT using GPIO pin of CM108/CM119 (e.g. DMK URI, RB-USB RIM), Linux only.
@ -162,9 +146,7 @@ Use the 64 bit version if possible; it runs considerably faster.
- Allow single log file with fixed name rather than starting a new one each day. - Allow single log file with fixed name rather than starting a new one each day.
### Bugs Fixed:
### Bugs Fixed: ###
- Possible crash when CDIGIPEAT did not include the optional alias. - Possible crash when CDIGIPEAT did not include the optional alias.
@ -174,27 +156,23 @@ Use the 64 bit version if possible; it runs considerably faster.
- Under certain conditions, outgoing connected mode data would get stuck in a queue and not be transmitted. This could happen if client application sends a burst of data larger than the "window" size (MAXFRAME or EMAXFRAME option). - Under certain conditions, outgoing connected mode data would get stuck in a queue and not be transmitted. This could happen if client application sends a burst of data larger than the "window" size (MAXFRAME or EMAXFRAME option).
- Little typographical / spelling errors in messages. - Little typographical / spelling errors in messages.
### Documentation:
### Documentation: ###
- New document ***Bluetooth-KISS-TNC.pdf*** explaining how to use KISS over Bluetooth. - New document ***Bluetooth-KISS-TNC.pdf*** explaining how to use KISS over Bluetooth.
- Updates describing cheap SDR frequency inaccuracy and how to compensate for it. - Updates describing cheap SDR frequency inaccuracy and how to compensate for it.
### Notes: ### ### Notes:
Windows binary distribution now uses gcc (MinGW) version 6.3.0. Windows binary distribution now uses gcc (MinGW) version 6.3.0.
---------- ----------
## Version 1.4 -- April 2017 ## ## Version 1.4 -- April 2017
### New Features:
### New Features: ###
- AX.25 v2.2 connected mode. See chapter 10 of User Guide for details. - AX.25 v2.2 connected mode. See chapter 10 of User Guide for details.
@ -205,6 +183,7 @@ Windows binary distribution now uses gcc (MinGW) version 6.3.0.
- Expanded debug options so you can understand what is going on with packet filtering. - Expanded debug options so you can understand what is going on with packet filtering.
- Added new document ***Successful-APRS-IGate-Operation.pdf*** with IGate background, configuration, and troubleshooting tips. - Added new document ***Successful-APRS-IGate-Operation.pdf*** with IGate background, configuration, and troubleshooting tips.
- 2400 & 4800 bps PSK modems. See ***2400-4800-PSK-for-APRS-Packet-Radio.pdf*** in the doc directory for discussion. - 2400 & 4800 bps PSK modems. See ***2400-4800-PSK-for-APRS-Packet-Radio.pdf*** in the doc directory for discussion.
- The top speed of 9600 bps has been increased to 38400. You will need a sound card capable of 96k or 192k samples per second for the higher rates. Radios must also have adequate bandwidth. See ***Going-beyond-9600-baud.pdf*** in the doc directory for more details. - The top speed of 9600 bps has been increased to 38400. You will need a sound card capable of 96k or 192k samples per second for the higher rates. Radios must also have adequate bandwidth. See ***Going-beyond-9600-baud.pdf*** in the doc directory for more details.
@ -212,12 +191,12 @@ Windows binary distribution now uses gcc (MinGW) version 6.3.0.
- Better decoder performance for 9600 and higher especially for low audio sample rate to baud ratios. - Better decoder performance for 9600 and higher especially for low audio sample rate to baud ratios.
- Generate waypoint sentences for use by AvMap G5 / G6 or other mapping devices or applications. Formats include - Generate waypoint sentences for use by AvMap G5 / G6 or other mapping devices or applications. Formats include
- $GPWPL - NMEA generic with only location and name. - $GPWPL - NMEA generic with only location and name.
- $PGRMW - Garmin, adds altitude, symbol, and comment to previously named waypoint. - $PGRMW - Garmin, adds altitude, symbol, and comment to previously named waypoint.
- $PMGNWPL - Magellan, more complete for stationary objects. - $PMGNWPL - Magellan, more complete for stationary objects.
- $PKWDWPL - Kenwood with APRS style symbol but missing comment. - $PKWDWPL - Kenwood with APRS style symbol but missing comment.
- DTMF tones can be sent by putting "DTMF" in the destination address, similar to the way that Morse Code is sent. - DTMF tones can be sent by putting "DTMF" in the destination address, similar to the way that Morse Code is sent.
- Take advantage of new 'gpio' group and new /sys/class/gpio ownership in Raspbian Jessie. - Take advantage of new 'gpio' group and new /sys/class/gpio ownership in Raspbian Jessie.
@ -226,9 +205,7 @@ Windows binary distribution now uses gcc (MinGW) version 6.3.0.
- More flexible dw-start.sh start up script for both GUI and CLI environments. - More flexible dw-start.sh start up script for both GUI and CLI environments.
### Bugs Fixed:
### Bugs Fixed: ###
- The transmitter (PTT control) was being turned off too soon when sending Morse Code. - The transmitter (PTT control) was being turned off too soon when sending Morse Code.
@ -242,7 +219,6 @@ Windows binary distribution now uses gcc (MinGW) version 6.3.0.
Are you sure you have enabled MKISS support in the kernel Are you sure you have enabled MKISS support in the kernel
or, if you made it a module, that the module is loaded?* or, if you made it a module, that the module is loaded?*
- Sometimes writes to a pseudo terminal would block causing the received - Sometimes writes to a pseudo terminal would block causing the received
frame processing thread to hang. The first thing you will notice is that frame processing thread to hang. The first thing you will notice is that
received frames are not being printed. After a while this message will appear: received frames are not being printed. After a while this message will appear:
@ -253,20 +229,17 @@ received frames are not being printed. After a while this message will appear:
- -p command line option caused segmentation fault with glibc >= 2.24. - -p command line option caused segmentation fault with glibc >= 2.24.
- The Windows version 1.3 would crash when starting to transmit on Windows XP. There have also been some other reports of erratic behavior on Windows. The crashing problem was fixed in in the 1.3.1 patch release. Linux version was not affected. - The Windows version 1.3 would crash when starting to transmit on Windows XP. There have also been some other reports of erratic behavior on Windows. The crashing problem was fixed in in the 1.3.1 patch release. Linux version was not affected.
- IGate did not retain nul characters in the information part of a packet. This should never happen with a valid APRS packet but there are a couple cases where it has. If we encounter these malformed packets, pass them along as-is, rather than truncating. - IGate did not retain nul characters in the information part of a packet. This should never happen with a valid APRS packet but there are a couple cases where it has. If we encounter these malformed packets, pass them along as-is, rather than truncating.
- Don't digipeat packets when the source is my call. - Don't digipeat packets when the source is my call.
---------- ----------
## Version 1.3 -- May 2016 ## ## Version 1.3 -- May 2016
### New Features: ### ### New Features:
- Support for Mac OS X. - Support for Mac OS X.
@ -285,15 +258,12 @@ arrives later and gets dropped if there are duplicates.
- Implemented AGW network protocol 'M' message for sending UNPROTO information without digipeater path. - Implemented AGW network protocol 'M' message for sending UNPROTO information without digipeater path.
- A list of all symbols available can be obtained with the -S - A list of all symbols available can be obtained with the -S
command line option. command line option.
- Command line option "-a n" to print audio device statistics each n seconds. Previously this was always each 100 seconds on Linux and not available on Windows. - Command line option "-a n" to print audio device statistics each n seconds. Previously this was always each 100 seconds on Linux and not available on Windows.
### Bugs Fixed: ### ### Bugs Fixed:
- Fixed several cases where crashes were caused by unexpected packet contents: - Fixed several cases where crashes were caused by unexpected packet contents:
@ -316,9 +286,9 @@ such as PowerPC or MIPS.
---------- ----------
## Version 1.2 -- June 2015 ## ## Version 1.2 -- June 2015
### New Features ### ### New Features
- Improved decoder performance. - Improved decoder performance.
Over 1000 error-free frames decoded from WA8LMF TNC Test CD. Over 1000 error-free frames decoded from WA8LMF TNC Test CD.
@ -359,17 +329,14 @@ like PTT) to activate a carrier detect light.
- APRStt gateway enhancements: MGRS/USNG coordinates, new APRStt3 - APRStt gateway enhancements: MGRS/USNG coordinates, new APRStt3
format call, satellite grid squares. format call, satellite grid squares.
### Bugs fixed
### Bugs fixed ###
- Fixed "gen_packets" so it now handles user-specified messages correctly. - Fixed "gen_packets" so it now handles user-specified messages correctly.
- Under some circumstances PTT would be held on long after the transmit - Under some circumstances PTT would be held on long after the transmit
audio was finished. audio was finished.
### Known problems
### Known problems ###
- Sometimes writes to a pseudo terminal will block causing the received - Sometimes writes to a pseudo terminal will block causing the received
frame processing thread to hang. The first thing you will notice is that frame processing thread to hang. The first thing you will notice is that
@ -381,9 +348,9 @@ received frames are not being printed. After a while this message will appear:
----------- -----------
## Version 1.1 -- December 2014 ## ## Version 1.1 -- December 2014
### New Features ### ### New Features
- Logging of received packets and utility to convert log file - Logging of received packets and utility to convert log file
into GPX format. into GPX format.
@ -417,9 +384,7 @@ or UTM coordinates.
- It is still highly recommended, but no longer mandatory, that - It is still highly recommended, but no longer mandatory, that
beaconing be enabled for digipeating to work. beaconing be enabled for digipeating to work.
* Bugs fixed: * Bugs fixed:
- For Windows version, maximum serial port was COM9. - For Windows version, maximum serial port was COM9.
It is now possible to use COM10 and higher. It is now possible to use COM10 and higher.
@ -435,24 +400,24 @@ application crash.
- OSS (audio interface for non-Linux versions of Unix) should - OSS (audio interface for non-Linux versions of Unix) should
be better now. be better now.
### Known problems ### ### Known problems
- Sometimes kissattach fails to connect with "direwolf -p". - Sometimes kissattach fails to connect with "direwolf -p".
The User Guide and Raspberry Pi APRS document have a couple work-arounds. The User Guide and Raspberry Pi APRS document have a couple work-arounds.
----------- -----------
## Version 1.0a -- May 2014 ## ## Version 1.0a -- May 2014
### Bug fixed ### ### Bug fixed
- Beacons sent directly to IGate server had incorrect source address. - Beacons sent directly to IGate server had incorrect source address.
----------- -----------
## Version 1.0 -- May 2014 ## ## Version 1.0 -- May 2014
### New Features ### ### New Features
- Received audio can be obtained with a UDP socket or stdin. - Received audio can be obtained with a UDP socket or stdin.
This can be used to take audio from software defined radios This can be used to take audio from software defined radios
@ -477,12 +442,11 @@ resulted in too many false positives from some other types of digital
transmissions heard on HF. Starting in version 1.0, the DTMF decoder transmissions heard on HF. Starting in version 1.0, the DTMF decoder
is enabled only when the APRStt gateway is configured. is enabled only when the APRStt gateway is configured.
----------- -----------
## Version 0.9 --November 2013 ## ## Version 0.9 --November 2013
### New Features ### ### New Features
- Selection of non-default audio device for Linux ALSA. - Selection of non-default audio device for Linux ALSA.
@ -499,23 +463,21 @@ is enabled only when the APRStt gateway is configured.
- APRStt macros which allow short numeric only touch tone - APRStt macros which allow short numeric only touch tone
sequences to be processed as much longer predefined sequences. sequences to be processed as much longer predefined sequences.
### Bugs Fixed
### Bugs Fixed ###
- Now works on 64 bit target. - Now works on 64 bit target.
### New Restriction for Windows version ### ### New Restriction for Windows version
- Minimum processor is now Pentium 3 or equivalent or later. - Minimum processor is now Pentium 3 or equivalent or later.
It's possible to run on something older but you will need It's possible to run on something older but you will need
to rebuild it from source. to rebuild it from source.
----------- -----------
## Version 0.8 -- August 2013 ## ## Version 0.8 -- August 2013
### New Features ### ### New Features
- Internet Gateway (IGate) including IPv6 support. - Internet Gateway (IGate) including IPv6 support.
@ -526,21 +488,19 @@ to rebuild it from source.
- KISS TNC should now work with connected AX.25 protocols - KISS TNC should now work with connected AX.25 protocols
(e.g. AX25 for Linux), not just APRS. (e.g. AX25 for Linux), not just APRS.
---------- ----------
## Version 0.7 -- March 2013 ## ## Version 0.7 -- March 2013
### New Features: ### ### New Features:
- Added APRStt gateway capability. For details, see ***APRStt-Implementation-Notes.pdf*** - Added APRStt gateway capability. For details, see ***APRStt-Implementation-Notes.pdf***
----------- -----------
## Version 0.6 -- February 2013 ## ## Version 0.6 -- February 2013
### New Features ### ### New Features
- Improved performance of AFSK demodulator. - Improved performance of AFSK demodulator.
Now decodes 965 frames from Track 2 of WA8LMF's TNC Test CD. Now decodes 965 frames from Track 2 of WA8LMF's TNC Test CD.
@ -558,15 +518,13 @@ probability of occasional corrupted data getting thru.
- Added AGW "monitor" format messages. - Added AGW "monitor" format messages.
Now compatible with APRS-TW for telemetry. Now compatible with APRS-TW for telemetry.
### Known Problem
### Known Problem ###
- The Linux (but not Cygwin) version eventually hangs if nothing is - The Linux (but not Cygwin) version eventually hangs if nothing is
reading from the KISS pseudo terminal. Some operating system reading from the KISS pseudo terminal. Some operating system
queue fills up, the application write blocks, and decoding stops. queue fills up, the application write blocks, and decoding stops.
### Workaround
### Workaround ###
- If another application is not using the serial KISS interface, - If another application is not using the serial KISS interface,
run this in another window: run this in another window:
@ -575,13 +533,12 @@ run this in another window:
----------- -----------
## Version 0.5 -- March 2012 ## ## Version 0.5 -- March 2012
- More error checking and messages for invalid APRS data. - More error checking and messages for invalid APRS data.
----------- -----------
## Version 0.4 -- September 2011 ## ## Version 0.4 -- September 2011
- First general availability. - First general availability.

Binary file not shown.

Before

Width:  |  Height:  |  Size: 361 KiB

After

Width:  |  Height:  |  Size: 44 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 24 KiB

After

Width:  |  Height:  |  Size: 47 KiB