Skip to content

Commit

Permalink
Update readme.md
Browse files Browse the repository at this point in the history
update to 0.11.14
  • Loading branch information
aa2mz authored Sep 7, 2020
1 parent 5c3ddbd commit ab88985
Showing 1 changed file with 25 additions and 11 deletions.
36 changes: 25 additions & 11 deletions software/examples/tiny RF tool/readme.md
Original file line number Diff line number Diff line change
@@ -1,13 +1,22 @@
The very tiny RF tool uses nothing more than an Arduino Nano and an si5351 breakout board.
The tool is controlled by your PC radio applicion.
Basically, the VFO-A appears on the clk0 output and the VFO-B frequency appears on the clk1 output.

This application might help you align you radio circuits, test you filters or measure SWR of your antenna.
Addional circuitry may be required.

The application generates two or three RF clock signals on the si5351.
- clk0 is either the dial frequency of the radion in DC mode or the first mixer frequency.
- clk1 is either turned off in DC mode or the IF frequency plus the IF shift.
- clk2 is the dial frequency plus the clk2 shift.
Changing the clk2 shift allows you to discover the bandwith of your filters.
- ptt pin will toggle based on the PTT mode of the application.

Tested on fldigi, flrig, WSJT-X and Ham Radio Deluxe.
Also supported by the text protocal from an ascii terminal emulator (such as "Serial Tool" in the Arduino IDE.)

If attached, the RF tool will also display the two frequencies on the OLED display.
(OLED display software is being tidied up, RSN.)
If attached, the RF tool will also display the clock frequencies on the display.

In this very tiny project, a header is installed on the TOP of the Nano for a small (.096" or 1.1") OLED display.
In the simplest (hardware) version project, a header is installed on the TOP of the Nano for a small (.096" or 1.1") OLED display.
I use extended headers; the only consideration is that the SCL and SDA pins extend down for the si5351 breakout board.
The header is not a necessity and wires can also be used extend above and below.
The OLED is powered by jumpering +5V and GND to the appropriate A6 and A7 pins.
Expand All @@ -24,18 +33,23 @@ The si5351 breakout board is soldered on an we're finished!
![built](0903200921a.jpg)

The software is controlled by and tested with fldigi, flrig, WSJT-X and Ham Radio Deluxe
by either selecting a Xiegu 5150 (for fldigi, get the latest version) or a Icom IC-754 or an IC-7000.
by either selecting a Xiegu 5105 (for flrig, get the latest version) or a Icom IC-754 or an IC-7000.
Default baud is 38400.

You will likely have to configure the rf clocks via the text interface. qiv.
You will likely have to configure the IF filters, if any, via the text interface. qiv.
If the IFs are defined a 0 for high and low,
the RF tool will work place the frequencies of VFO-A on the ckl0 output and VCO-B on the clk1 output.
Direct conversion mode.
the RF tool will place the frequencies of VFO-A on the ckl0 output and VCO-A + IF Shift on the clk2 output;
that's Direct conversion mode.
Otherwise the software will read the IF frequency and, depending on the mode,
place the calculated clocks on CLK0 and CLK1.
Superheterodyne mode.
place the calculated clocks on CLK0 and CLK1 and and VCO-A + IF Shift on the clk2 output;
that's Superheterodyne mode.

![testing](0903201140.jpg)

Look for support of the graphics display in the next veriosn.
There are both compile time and run time configurations.
- #define TINYRFTOOL is used to change the radiopins.h file to power the display and clock
board to be powered from the Arduino Nano board.
Do not define, or undef this, if you provide power to those boards through more tradional means.
- #define RFTOOLDISPLAY if you have a small OLED attached.
It will show the frequencies of the si5351 clocks on the display.

0 comments on commit ab88985

Please sign in to comment.