1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
|
========================================================================
UHD - Synchronization Application Notes
========================================================================
.. contents:: Table of Contents
The following application notes explain how to synchronize multiple USRPs
with the goal of transmitting or receiving time-aligned samples.
**Note:** The following synchronization notes do not apply to USRP1
which does not support the advanced features available in newer products.
------------------------------------------------------------------------
Common reference signals
------------------------------------------------------------------------
USRPs take two reference signals in order to synchronize clocks and time.
* A 10MHz reference to synchronize the clocks across devices.
* A pulse-per-second to synchronize the time across devices.
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Provide reference signals
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Most USRPs have front panel SMA connectors to source these signals externally.
Alternatively, some USRP models support an optional internal GPSDO.
Typically, these signals are provided from a GPSDO.
For user's generating their own signals,
the pulse-per-second should be clocked off of the 10MHz reference.
See the application notes for your device for specific signal requirements.
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Set the clock configuration
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
The user should set the "external" clock configuration when configuring the USRP device object.
::
usrp->set_clock_config(uhd::clock_config_t::external());
------------------------------------------------------------------------
Synchronizing the device time
------------------------------------------------------------------------
The purpose of the PPS signal is to synchronously latch a time into the device.
The device time may be absolute (GPS, UTC) or relative.
The user should decide what is most useful to the application.
To synchronously set the device time,
the user should determine the PPS edge,
and then make the API call set_time_next_pps(...).
The user can determine the PPS edge in a variety of ways...
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Method 1 - poll the USRP time registers
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
One way to catch the PPS edge is to poll the "last PPS" time from the USRP device.
When the last PPS time increments, the user can determine that a PPS has occurred.
::
const uhd::time_spec_t last_pps_time = usrp->get_time_last_pps();
while (last_pps_time != usrp->get_time_last_pps()){
//sleep 100 milliseconds (give or take)
}
usrp->set_time_next_pps(uhd::time_spec_t(0.0));
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Method 2 - query the GPSDO for seconds
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Most GPSDO can be configured to output a NMEA string over the serial port once every PPS.
The user can wait for this string to determine the PPS edge,
and the user can also parse this string to determine GPS time.
::
//call user's function to wait for NMEA message...
usrp->set_time_next_pps(uhd::time_spec_t(0.0));
-- OR --
//call user's function to wait for NMEA message...
//call user's function to parse the NMEA message...
usrp->set_time_next_pps(uhd::time_spec_t(gps_time+1));
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Method 3 - query the gps_time sensor
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
This is a variant of method 2 for USRPs with internal GPSDOs.
The user can query the gps_time sensor to wait for the NMEA string.
::
//wait for NMEA string from internal GPSDO
usrp->get_mboard_sensor("gps_time");
usrp->set_time_next_pps(uhd::time_spec_t(0.0));
-- OR --
//wait for the NMEA string and set GPS time
const time_t gps_time = usrp->get_mboard_sensor("gps_time").to_int();
usrp->set_time_next_pps(uhd::time_spec_t(gps_time+1));
------------------------------------------------------------------------
Synchronizing multiple channels
------------------------------------------------------------------------
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Synchronizing the cordics
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
The frequency translation between baseband and IF can introduce a phase ambiguity between channels.
This is due to the property that the cordic in the DSP chain can have a random phase offset.
Fortunately, the cordic is reset on each start-of-burst.
Therefore, the method to phase-align the cordics is to coordinate streaming at a particular time.
For receive, a burst is started when the user issues a stream command. This stream command should have a time spec set.
For transmit, a burst is started when the user calls send. The metadata should have a time spec and start of burst set.
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Synchronizing the RF LOs
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
