From 2b5c5497ed4a9df4b45df1702fba6d4abe32728c Mon Sep 17 00:00:00 2001 From: Rob Riggs Date: Sat, 25 Dec 2021 16:10:53 -0600 Subject: [PATCH] Small update to docs. --- m17/images/test/m17-cxx-demod | 1 - m17/m17-configuration.ipynb | 23 +++++++++++++---------- 2 files changed, 13 insertions(+), 11 deletions(-) delete mode 160000 m17/images/test/m17-cxx-demod diff --git a/m17/images/test/m17-cxx-demod b/m17/images/test/m17-cxx-demod deleted file mode 160000 index 0bf152e..0000000 --- a/m17/images/test/m17-cxx-demod +++ /dev/null @@ -1 +0,0 @@ -Subproject commit 0bf152e99098e2c2b70c1cc9dc5bfaccad2a2ead diff --git a/m17/m17-configuration.ipynb b/m17/m17-configuration.ipynb index fa60001..c723489 100644 --- a/m17/m17-configuration.ipynb +++ b/m17/m17-configuration.ipynb @@ -269,9 +269,10 @@ "Stop transmitting. If the results look good after changing the polarity, go\n", "back to the main menu and press *Save Settings*.\n", "\n", - "If the results are still bad, stop check all of the frequency settings. Verify\n", - "the PPM settings on the RTL-SDR. Ensure that your radio's VCO is properly\n", - "calibrated and that it is transmitting and receiving at the proper frequency.\n", + "If the results are still bad, check the frequency settings used on the radio and\n", + "on the command-line for `rtl_fm`. Verify the PPM settings on the RTL-SDR. Ensure\n", + "that your radio's VCO is properly calibrated and that it is transmitting and\n", + "receiving at the proper frequency.\n", "\n", "You can also reach out to #public-chat on the M17 Discord for help.\n", "\n", @@ -317,10 +318,11 @@ "This is the same command used for BER testing and setting up the TX polarity,\n", "except we are now piping the output to the computer's audio output.\n", "\n", - "Press the transmit button on the M17 HT app. A short press locks the transmit\n", + "Press the transmit button on the M17 HT app. The Transmit button can act\n", + "like a toggle button or a push button. A short press locks the transmit\n", "button. Another short press disengages the transmit button. If instead you\n", - "hold the button for longer than 1/2 second, it will stop transmitting as soon\n", - "as you release the button.\n", + "hold the button for longer than 1/2 second, it acts as a push button and will\n", + "stop transmitting as soon as you release the button.\n", "\n", "Press the transmit button, speak, then release the transmit button. It is\n", "likely that you will hear a long delay before the received audio plays. This\n", @@ -335,7 +337,7 @@ " \n", "\n", "\n", - "Notice that the callsign was decoded.\n", + "Notice that the callsign you entered into the M17 HT app was decoded.\n", "\n", "The long audio delay can be reduced somewhat by using `stdbuf`. This makes the\n", "command-line a bit unwieldy.\n", @@ -350,11 +352,11 @@ "verify that the output polarity is correct first by attempting to\n", "receive it using the method outline in [Configure TX Polarity](#Configure-TX-Polarity).\n", "\n", - "Set up your Pluto SDR or other transmit-capable SDR. Install any required\n", + "Set up your ADALM Pluto or other transmit-capable SDR. Install any required\n", "filters and transmit antenna. If you can, connect the SDR to the radio\n", - "under test through a 30dB or 40dB attenuator. Be very careful if you do\n", + "under test through a 30dB or 40dB attenuator. *Be very careful if you do\n", "connect the SDR to the radio because it is very easy to damage the SDR\n", - "if the radio transmits.\n", + "if the radio transmits.*\n", "\n", "Open *GNU Radio Companion* (GRC) and within that, open the `m17-bert.grc` file.\n", "Adjust the output sink paramters (including the frequency) for the test. You\n", @@ -385,6 +387,7 @@ " the Android device. Open the Mobilinkd Config app. Connect to the TNC.\n", " Select *Modem Settings*, then enable `RX Reverse Polarity`. Press *Close*\n", " and then *Save Settings*. Repeat the experiment.\n", + " 1. Try reducing the attenuation in the *PlutoSDR Sink* block.\n", "\n", "### Voice Reception\n", "\n",