mirror of
git://projects.qi-hardware.com/ben-wpan.git
synced 2024-11-25 15:45:56 +02:00
c7303e4ac1
- cntr/README: description of the counter board and its application - cntr/fw/common/crc32.c: variant of CRC32-IEEE802.3 shared by firmware and measurement application - cntr/fw/cntr/ep0.c (my_setup), cntr/tools/cntr/cntr.c (get_sample): protect the counter value with a CRC and an one's complement copy - cntr/fw/include/cntr/ep0.h: oops, wasn't checked into repository - cntr/tools/cntr/cntr.c: added section titles - cntr/tools/cntr/cntr.c (measure): show communication statistics at the end - cntr/tools/cntr/cntr.c (measure, usage, main): new option -d to enable reporting of communication errors - cntr/tools/cntr/cntr.c (set_stop, measure): let user stop measurement with SIGINT - cntr/tools/cntr/cntr.c (measure): get multiple "first samples" and keep the one with the shortest round-trip time - cntr/tools/cntr/cntr.c (measure): changed unit "ppk" (1/1000) to percent (1/100) - cntr/tools/cntr/cntr.c (usage, main): command-line argument is now the accuracy goal, while the system clock deviation is set with the new option -c - TODO: some more things to do
67 lines
2.4 KiB
Plaintext
67 lines
2.4 KiB
Plaintext
Arbitrary-precision counter
|
|
===========================
|
|
|
|
Theory of operation
|
|
-------------------
|
|
|
|
The arbitrary-precision counter counts clock cycles of a frequency
|
|
source that is assumed to be free from drift. It compares the count
|
|
with the host's system clock. If the system clock is synchronized with
|
|
an accurate NTP reference, measurements with arbitrarily high accuracy
|
|
can be obtained.
|
|
|
|
In practice, this is limited by the the frequency source's drift and
|
|
the time one is willing to wait. If NTP maintains the system time
|
|
with an accuracy of +/- 100 ms, obtaining measurements with an
|
|
accuracy of +/- 1 ppm would take about 28 hours.
|
|
|
|
Additional error sources, such as the round-trip time when requesting
|
|
a sample from the microcontroller, are also considered in the accuracy
|
|
calculation.
|
|
|
|
The counter consists of a board based on a C8051F320 microcontroller
|
|
and the control software on the host. The microcontroller counts
|
|
events in a free-running 16 bit counter that is regularly read and
|
|
extended to 32 bits. The 32 bit counter is periodically queried by
|
|
the host.
|
|
|
|
The microcontroller's counter can count at a frequency of up to 3 MHz.
|
|
(SYSCLK/4)
|
|
|
|
In order to protect against transmission errors not detected by USB's
|
|
CRC, which are occur relatively often, each packet is protected by a
|
|
CRC-32 and an inverted copy of the payload. Corrupted packets are
|
|
rejected by the host.
|
|
|
|
The 32 bit counter wraps around at most once very 21.8 ms. The 32 bit
|
|
counter wraps around at most every 1431 s. The host extends the 32 bit
|
|
counter to 64 bits, and calculates frequency and accuracy from the
|
|
count and the run time of the measurement application.
|
|
|
|
|
|
Performing a measurement
|
|
------------------------
|
|
|
|
To perform a measurement, connect the CNTR board's probe input to the
|
|
clock source and then run the "cntr" application on the host. An
|
|
accuracy goal (in ppm) can be specified on the command line (see
|
|
below).
|
|
|
|
The host polls the microcontroller every 100 ms and displays the run
|
|
time (in seconds), the measured frequency, and the accuracy achieved
|
|
so far.
|
|
|
|
Measurements can be stopped by pressing ^C or by specifying an
|
|
accuracy goal. At the end, the total number of events counted and
|
|
communication statistics are displayed.
|
|
|
|
|
|
Updating the firmware
|
|
---------------------
|
|
|
|
The protocol revision and the build date of the firmware of the CNTR
|
|
board can be queried with "cntr -i".
|
|
|
|
To update the firmware, run
|
|
cntr -r && sleep 1 && dfu-util -d 0x20b7:0xcb72 -D cntr.bin
|