The GPSDO example program is a GPS Disciplined Oscillator program that turns your RFzero into a reference oscillator. This way you can lock your   instruments and radio equipment to a common frequency typically 10 MHz.

The RFzero is capable of generating reference signals up to 200 MHz and beyond. Real life tests show that a 108 MHz signal generated by the RFzero GPSDO and that has  been multiplied 96 times to reach 10 GHz has a short term variation of 5 Hz if the Si5351A reference clock has been covered with a non-conductive foam cover. Please see the modifications page for more details.

A four lines and 20 characters LCD can be connected showing the UTC, local time and GPS status. This way you will have a nice and accurate lab or shack clock too.

The configuration is done via the USB port. It is possible to wait for the RFzero to warm up for up to 255 s before outputting the signal. It is also possible to wait for the GPS to be valid before outputting the signal.

When the RFzero generates a signal the TX LED is lit.

When GPS signals are received the PPS LED flashes ones per second and when the status of the GPS signal is valid the Valid LED is lit.


Joel, N6ALT, is using his GPSDO together with a 20 characters x 4 lines LCD.

The GPSDO and LCD. Picture courtesy Joel, N6ALT.


The display is a LCD (20×4) that shows the GPS status, the UTC and the local time where D is for daylight saving time and N is for normal time.

If you want to change what is shown on the display please edit the functions in the display.cpp file.


The configuration of the program is done via the USB port, 9600 Baud, 8 bits, no parity and one stop bit, using a terminal program (e.g. Arduino IDE Serial Monitor, Termite Terminal (Windows), CuteCom (Linux) or Terminal (Mac OS)). Please connect the RFzero via a USB B cable to your computer and connect the terminal program to the right COM port in the terminal program. The RFzero identifies itself as an Arduino Zero (Windows Device Manager).

If you don’t see the RFzero> or RFzero config> prompts please press the enter key. When you want to execute a command you don’t have to enter the prompt but only the command and parameters after the >.

All input to the RFzero must be in lowercase.

To enter the configuration mode please enter   config   at the RFzero> prompt, i.e.

RFzero> config

To see the available commands please enter   ?   at the RFzero config> prompt, i.e.

RFzero config> ?

To leave the configuration mode please enter   exit   at the RFzero config> prompt, i.e.

RFzero config> exit

When in configuration mode, i.e. when you see the RFzero config> prompt, the most frequent commands are

rd cfg

to see the configuration that will be used after exiting the configuration mode.

wr defaults

to set most of parameters to their default values. Please see the actual example program for the specific default values.

wr freq FREQ

where FREQ is the GPSDO frequency in Hz from 100 kHz and up. The frequency may include decimals if needed, e.g.

wr freq 123456789.012

wr warmup SECONDS

where SECONDS is the number of seconds to wait for the RFzero to warm up.

wr wait ONOFF

to turn on or off waiting for the GPS to be valid before transmitting where ONOFF is either 0: for off/don’t wait for the GPS to be valid, or 1: for on/wait for the GPS to be valid.


where HOURS is the number of hours the local time is offset relative to UTC and where west is negative and where MINUTES is the number of minutes relative to UTC, e.g.

wr offset 8 15

wr dst ONOFF

to turn on/off daylight saving time where ONOFF is 0: normal, 1: daylight saving time (DST).

More commands are available so please enter a question mark (?) at the RFzero config> prompt to see them.