Frequency Counter - Revision history

Gvegidy: more translation

2011-11-06T20:36:30Z

more translation

Gvegidy: some translation

2011-11-06T20:15:13Z

some translation

Gvegidy: Created page with "{{i18n|Frequency Counter}} {{Module |NAME=Frequency Counter |MENUCONFIG={{Applications}}->Frequency Counter |STATUS={{stable}} |PINNING=yes |ECMD={{has_ecmd}} |DEPENDS=ECMD (…"

2011-11-06T19:57:48Z

Created page with "{{i18n|Frequency Counter}} {{Module |NAME=Frequency Counter |MENUCONFIG={{Applications}}->Frequency Counter |STATUS={{stable}} |PINNING=yes |ECMD={{has_ecmd}} |DEPENDS=ECMD (…"

New page

{{i18n|Frequency Counter}}
{{Module
|NAME=Frequency Counter
|MENUCONFIG={{Applications}}->Frequency Counter
|STATUS={{stable}}
|PINNING=yes
|ECMD={{has_ecmd}}
|DEPENDS=[[ECMD]] (optional)
|REQUIRES= -
|CODE=[https://github.com/ethersex/ethersex/tree/master/services/freqcount https://github.com/ethersex/ethersex/tree/master/services/freqcount]
}}

Measures the frequency and duty cycle of a signal

== Anschluss ==
* muss immer an das ICP1-Pin angeschlossen werden
* im Pinning muss der Pin zusätzlich noch definiert werden:
<code>pin(FREQCOUNT_PIN, PB0, INPUT)</code>
* es ist geplant noch ein Multiplexing mit einem zusätzlichen 74HC251 oder dem Ananlog-Multiplexer (unter Verlust des ADCs) einzubauen

== Frequenz ==
* CPU-Ticks von Rising-Edge zu Rising-Edge werden gemessen
* Minimal das kleinere von 1 Hz und CPU-Frequenz / 16777216, in der Praxis 2 Hz
* Maximal ca. 50 CPU-Takte, also ca. 400KHz bei 20 MHz
* Ist die Frequenz höher, wird dies nicht sicher erkannt, es werden einfach falsche Werte gemessen
* Steigt die Interrupt-Last der CPU (z.B. durch Netzwerkverkverkehr oder UART), sinkt die maximal sicher messbare Frequenz
* Die Frequenz wird intern als Anzahl der Ticks (32 Bit unsigned int) gespeichert

== Duty-Cycle ==
* Kann auch den Duty-Cycle eines PWM-Signals messen
* Duty-Cycle ist (Zeit von Rising Edge zu Falling Edge) / Gesamtdauer des letzten Zyklus von Rising zu Rising
* Frequenz und Duty-Cycle werden nacheinander gemessen
* Sollte sich die Frequenz signifikant ändern, ist die Duty-Cycle Messung falsch
* Der Duty Cycle wird intern als 8 Bit Wert gespeichert

== Durchschnittsbildung ==
* Durch Interrupt-Verzögerungen etc. kann es zu Fehlmessungen kommen
* Bei höheren Frequenzen sinkt die maximal mögliche Auflösung
* Um das zu kompensieren wird immer der Durchschnitt von n Messungen verwendet, n ist im Konfigurationsmenü einstellbar
* Zusätzlich wird immer der höchste und der niedrigste Wert einer dieser Durchschnittsreihen verworfen (es werden n+2 Samples genommen)

== ECMD-Befehle ==
{| border=1 cellspacing=0 padding=4 class=wikitable
! width="25%" | Kommando
! Funktion
|-
|fc freq ''Channel''|| Gibt die Frequenz in Hz zurück (Achtung: 32 Bit).
|-
|-
|fc ticks ''Channel''|| Gibt die Frequenz in CPU Ticks zurück (Achtung: 32 Bit).
|-
|-
|fc duty ''Channel''|| Gibt den Duty Cycle als 8 Bit Wert zurück (0-255 dezimal).
|-
|-
|fc %duty ''Channel''|| Gibt den Duty Cycle in Prozent zurück.
|-
|-
Hinweis: Channel ist momentan immer 0

@@ Line 18: / Line 18: @@
    pin(FREQCOUNT_PIN, PB0, INPUT)
-* if you want to measure the frequency of multiple signals, you can multiplex them with one or two 74HC251
+* if you want to measure the frequency of multiple signals, you can multiplex them with one or two 74HC251, up to 16 channels are supported
 * define the pinning for the control lines you need like this:
    pin(FREQCOUNT_CHANNEL_MULTIPLEX_BIT1, PB1, OUTPUT)
@@ Line 41: / Line 41: @@
 * duty cycle is stored as 8 bit value
-== Durchschnittsbildung ==
+== Basic Averaging ==
-* Durch Interrupt-Verzögerungen etc. kann es zu Fehlmessungen kommen
+* you will sometimes get a wrong result due to interrupt latencies etc.
-* Bei höheren Frequenzen sinkt die maximal mögliche Auflösung
+* the module always averages the result of ''n'' measurements. You can define ''n'' in the menuconfig.
-* Um das zu kompensieren wird immer der Durchschnitt von n Messungen verwendet, n ist im Konfigurationsmenü einstellbar
+* additionally the highest and lowest value of a averaging-block will be cut off, so ''n''+2 samples are taken
-* Zusätzlich wird immer der höchste und der niedrigste Wert einer dieser Durchschnittsreihen verworfen (es werden n+2 Samples genommen)
+* use a power of 2 for ''n'' to reduce code size and improve execution speed
-== ECMD-Befehle ==
+== Moving Average ==
 {| border=1 cellspacing=0 padding=4 class=wikitable
-  ! width="25%" | Kommando
+  ! width="25%" | Command
-  ! Funktion
+  ! Function
 |-
-|fc freq ''Channel''|| Gibt die Frequenz in Hz zurück (Achtung: 32 Bit).
+|fc duty ''Channel''|| Returns the duty cycle (0-255 decimal).
 |-
 |-
-|fc ticks ''Channel''|| Gibt die Frequenz in CPU Ticks zurück (Achtung: 32 Bit).
+|fc %duty ''Channel''|| Returns the duty cycle in percent.
 |-
 |-
-|fc duty ''Channel''|| Gibt den Duty Cycle als 8 Bit Wert zurück (0-255 dezimal).
+|fc on ''Channel''|| Switches on frequency counting on the given channel.
 |-
 |-
-|fc %duty ''Channel''|| Gibt den Duty Cycle in Prozent zurück.
+|fc off ''Channel''|| Switches off frequency counting on the given channel.
 |-
 |-
-Hinweis: Channel ist momentan immer 0
+''Channel'' is the number of the multiplexing channel (0-15), 0 if you do not use channel multiplexing.

@@ Line 13: / Line 13: @@
 Measures the frequency and duty cycle of a signal
-== Anschluss ==
+== Pinning ==
-* muss immer an das ICP1-Pin angeschlossen werden
+* the signal must always be fed to the ICP1-pin. Look up in the datasheet which physical pin this is on the used controller.
-* im Pinning muss der Pin zusätzlich noch definiert werden:
+* you need to define the pinning in ''pinning/hardware/<your board>.m4'':
-<code>pin(FREQCOUNT_PIN, PB0, INPUT)</code>
+  pin(FREQCOUNT_PIN, PB0, INPUT)
-== Frequenz ==
+* if you want to measure the frequency of multiple signals, you can multiplex them with one or two 74HC251
-* CPU-Ticks von Rising-Edge zu Rising-Edge werden gemessen
+* define the pinning for the control lines you need like this:
-* Minimal das kleinere von 1 Hz und CPU-Frequenz / 16777216, in der Praxis 2 Hz
+  pin(FREQCOUNT_CHANNEL_MULTIPLEX_BIT1, PB1, OUTPUT)
-* Maximal ca. 50 CPU-Takte, also ca. 400KHz bei 20 MHz
+  pin(FREQCOUNT_CHANNEL_MULTIPLEX_BIT2, PB2, OUTPUT)
-* Ist die Frequenz höher, wird dies nicht sicher erkannt, es werden einfach falsche Werte gemessen
+  pin(FREQCOUNT_CHANNEL_MULTIPLEX_BIT2, PB3, OUTPUT)
-* Steigt die Interrupt-Last der CPU (z.B. durch Netzwerkverkverkehr oder UART), sinkt die maximal sicher messbare Frequenz
+  pin(FREQCOUNT_CHANNEL_MULTIPLEX_CS_A, PB4, OUTPUT)
-* Die Frequenz wird intern als Anzahl der Ticks (32 Bit unsigned int) gespeichert
+  pin(FREQCOUNT_CHANNEL_MULTIPLEX_CS_B, PB5, OUTPUT)
-== Duty-Cycle ==
+== Frequency ==
-* Kann auch den Duty-Cycle eines PWM-Signals messen
+* CPU ticks from rising edge to rising edge are measured
-* Duty-Cycle ist (Zeit von Rising Edge zu Falling Edge) / Gesamtdauer des letzten Zyklus von Rising zu Rising
+* minimum frequency is the smaller value of 1 Hz and CPU frequency divided by 16777216, in practice 2 Hz
-* Frequenz und Duty-Cycle werden nacheinander gemessen
+* if the frequency is below the minimum, the output is 0
-* Sollte sich die Frequenz signifikant ändern, ist die Duty-Cycle Messung falsch
+* maximum frequency is about 50 cpu ticks, about 400 KHz at 20 MHz CPU
-* Der Duty Cycle wird intern als 8 Bit Wert gespeichert
+* if the frequency is above the maximum you get bogus results
 == Durchschnittsbildung ==