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 oscillator has been covered with a non-conductive foam cover. Please see the modifications page for more details.
A four lines and 20characters 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.
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. Termite Terminal (Windows), CuteCom (Linux) or Terminal (Mac OS)). Please connect the RFzero via a USB B cable to your compute 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.
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
to see the configuration that will be used after exiting the configuration mode.
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.0123
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.
wr offset HOURS MINUTES
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.