mirror of https://github.com/wb2osz/direwolf.git
141 lines
7.3 KiB
Markdown
141 lines
7.3 KiB
Markdown
# Documentation for Dire Wolf #
|
||
|
||
Click on the document name to view in your web browser or the link following to download the PDF file.
|
||
|
||
|
||
## Slide Show ##
|
||
|
||
Brief summary of packet radio / APRS history and the capbilities of Dire Wolf.
|
||
|
||
[Power Point presentation](https://github.com/wb2osz/direwolf-presentation) -- Why not give a talk at a local club meeting?
|
||
|
||
## Essential Reading ##
|
||
|
||
- [**User Guide**](User-Guide.pdf) [ [*download*](../../../raw/dev/doc/User-Guide.pdf) ]
|
||
|
||
This is your primary source of information about installation, operation, and configuration.
|
||
|
||
- [**Raspberry Pi APRS**](Raspberry-Pi-APRS.pdf) [ [*download*](../../../raw/dev/doc/Raspberry-Pi-APRS.pdf) ]
|
||
|
||
The Raspberry Pi has some special considerations that
|
||
make it different from other generic Linux systems.
|
||
Start here if using the Raspberry Pi, Beaglebone Black, cubieboard2, or similar single board computers.
|
||
|
||
|
||
## Application Notes ##
|
||
|
||
These dive into more detail for specialized topics or typical usage scenarios.
|
||
|
||
|
||
- [**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.
|
||
|
||
In this document, we look at why a large increase in data bit rate can produce a much smaller increase in throughput. We will explore techniques that can be used to make large improvements and drastically speed up large data transfer.
|
||
|
||
|
||
|
||
|
||
- [**Successful APRS IGate Operation**](Successful-APRS-IGate-Operation.pdf) [ [*download*](../../../raw/dev/doc/Successful-APRS-IGate-Operation.pdf) ]
|
||
|
||
Dire Wolf can serve as a gateway between the APRS radio network and APRS-IS servers on the Internet.
|
||
|
||
This explains how it all works, proper configuration, and troubleshooting.
|
||
|
||
- [**Bluetooth KISS TNC**](Bluetooth-KISS-TNC.pdf) [ [*download*](../../../raw/dev/doc/Bluetooth-KISS-TNC.pdf) ]
|
||
|
||
Eliminate the cable between your TNC and application. Use Bluetooth instead.
|
||
|
||
- [**APRStt Implementation Notes**](APRStt-Implementation-Notes.pdf) [ [*download*](../../../raw/dev/doc/APRStt-Implementation-Notes.pdf) ]
|
||
|
||
Very few hams have portable equipment for APRS but nearly everyone has a handheld radio that can send DTMF tones. APRStt allows a user, equipped with only DTMF (commonly known as Touch Tone) generation capability, to enter information into the global APRS data network.
|
||
This document explains how the APRStt concept was implemented in the Dire Wolf application.
|
||
- [**APRStt Interface for SARTrack**](APRStt-interface-for-SARTrack.pdf) [ [*download*](../../../raw/dev/doc/APRStt-interface-for-SARTrack.pdf) ]
|
||
|
||
This example illustrates how APRStt can be integrated with other applications such as SARTrack, APRSISCE/32, YAAC, or Xastir.
|
||
|
||
- [**APRStt Listening Example**](APRStt-Listening-Example.pdf) [ [*download*](../../../raw/dev/doc/APRStt-Listening-Example.pdf) ]
|
||
|
||
|
||
WB4APR described a useful application for the [QIKCOM-2 Satallite Transponder](http://www.tapr.org/pipermail/aprssig/2015-November/045035.html).
|
||
|
||
Don’t have your own QIKCOM-2 Satellite Transponder? No Problem. You can do the same thing with an ordinary computer and the APRStt gateway built into Dire Wolf. Here’s how.
|
||
|
||
- [**Raspberry Pi APRS Tracker**](Raspberry-Pi-APRS-Tracker.pdf) [ [*download*](../../../raw/dev/doc/Raspberry-Pi-APRS-Tracker.pdf) ]
|
||
|
||
Build a tracking device which transmits position from a GPS receiver.
|
||
|
||
- [**Raspberry Pi SDR IGate**](Raspberry-Pi-SDR-IGate.pdf) [ [*download*](../../../raw/dev/doc/Raspberry-Pi-SDR-IGate.pdf) ]
|
||
|
||
It's easy to build a receive-only APRS Internet Gateway (IGate) with only a Raspberry Pi and a software defined radio (RTL-SDR) dongle. Here’s how.
|
||
|
||
- [**APRS Telemetry Toolkit**](APRS-Telemetry-Toolkit.pdf) [ [*download*](../../../raw/dev/doc/APRS-Telemetry-Toolkit.pdf) ]
|
||
|
||
Describes scripts and methods to generate telemetry.
|
||
Includes a complete example of attaching an analog to
|
||
digital converter to a Raspberry Pi and transmitting
|
||
a measured voltage.
|
||
|
||
|
||
|
||
- [**2400 & 4800 bps PSK for APRS / Packet Radio**](2400-4800-PSK-for-APRS-Packet-Radio.pdf) [ [*download*](../../../raw/dev/doc/2400-4800-PSK-for-APRS-Packet-Radio.pdf) ]
|
||
|
||
|
||
Double or quadruple your data rate by sending multiple bits at the same time.
|
||
|
||
- [**Going beyond 9600 baud**](Going-beyond-9600-baud.pdf) [ [*download*](../../../raw/dev/doc/Going-beyond-9600-baud.pdf) ]
|
||
|
||
|
||
Why stop at 9600 baud? Go faster if your soundcard and radio can handle it.
|
||
|
||
|
||
## Miscellaneous ##
|
||
|
||
|
||
- [**A Better APRS Packet Demodulator, part 1, 1200 baud**](A-Better-APRS-Packet-Demodulator-Part-1-1200-baud.pdf) [ [*download*](../../../raw/dev/doc/A-Better-APRS-Packet-Demodulator-Part-1-1200-baud.pdf) ]
|
||
|
||
Sometimes it's a little mystifying why an
|
||
APRS / AX.25 Packet TNC will decode some signals
|
||
and not others. A weak signal, buried in static,
|
||
might be fine while a nice strong clean sounding
|
||
signal is not decoded. Here we will take a brief
|
||
look at what could cause this perplexing situation
|
||
and a couple things that can be done about it.
|
||
|
||
|
||
|
||
- [**A Better APRS Packet Demodulator, part 2, 9600 baud**](A-Better-APRS-Packet-Demodulator-Part-2-9600-baud.pdf) [ [*download*](../../../raw/dev/doc/A-Better-APRS-Packet-Demodulator-Part-2-9600-baud.pdf) ]
|
||
|
||
In the first part of this series we discussed 1200 baud audio frequency shift keying (AFSK). The mismatch
|
||
between FM transmitter pre-emphasis and the
|
||
receiver de-emphasis will
|
||
cause the amplitudes of the two tones to be different.
|
||
This makes it more difficult to demodulate them accurately.
|
||
9600 baud operation is an entirely different animal. ...
|
||
|
||
- [**WA8LMF TNC Test CD Results a.k.a. Battle of the TNCs**](WA8LMF-TNC-Test-CD-Results.pdf) [ [*download*](../../../raw/dev/doc/WA8LMF-TNC-Test-CD-Results.pdf) ]
|
||
|
||
How can we compare how well the TNCs perform under real world conditions?
|
||
The de facto standard of measurement is the number of packets decoded from [WA8LMF’s TNC Test CD](http://wa8lmf.net/TNCtest/index.htm).
|
||
Many have published the number of packets they have been able to decode from this test. Here they are, all gathered in one place, for your reading pleasure.
|
||
|
||
- [**A Closer Look at the WA8LMF TNC Test CD**](A-Closer-Look-at-the-WA8LMF-TNC-Test-CD.pdf) [ [*download*](../../../raw/dev/doc/A-Closer-Look-at-the-WA8LMF-TNC-Test-CD.pdf) ]
|
||
|
||
Here, we take a closer look at some of the frames on the TNC Test CD in hopes of gaining some insights into why some are easily decoded and others are more difficult.
|
||
There are a lot of ugly signals out there. Many can be improved by decreasing the transmit volume. Others are just plain weird and you have to wonder how they are being generated.
|
||
|
||
## Questions? Experiences to share? ##
|
||
|
||
Here are some good places to ask questions and share your experiences:
|
||
|
||
- [Dire Wolf Software TNC](https://groups.io/g/direwolf)
|
||
|
||
- [Raspberry Pi 4 Ham Radio](https://groups.io/g/RaspberryPi-4-HamRadio)
|
||
|
||
- [linuxham](https://groups.io/g/linuxham)
|
||
|
||
- [TAPR aprssig](http://www.tapr.org/pipermail/aprssig/)
|
||
|
||
|
||
The github "issues" section is for reporting software defects and enhancement requests. It is NOT a place to ask questions or have general discussions. Please use one of the locations above.
|