SYNOPSIS
loadrt siggen[num_chan=num | names=name1[,name2…]]
BESCHREIBUNG
siggen is a signal generator that can be used for testing and other applications that need simple waveforms. It produces sine, cosine, triangle, sawtooth, and square waves of variable frequency, amplitude, and offset, which can be used as inputs to other HAL components.
siggen supports a maximum of sixteen channels. The number of channels actually loaded is set by the num_chan argument when the module is loaded. Alternatively, specify names= and unique names separated by commas.
Die Angaben num_chan= und names= schließen sich gegenseitig aus. Wenn weder num_chan= noch names= angegeben sind, ist der Standardwert eins.
NAMING
Die Namen für Pins, Parameter und Funktionen prefixed (mit vorangestellter Zeichenkette versehen) als:
siggen.N. for N = 0, 1, …, num-1 when using num_chan=num
nameN. for nameN = name1, name2, … when using names=name1,name2,…
Das Format siggen.N. wird in den folgenden Beschreibungen dargestellt.
FUNKTIONEN
- siggen.N.update (nutzt Gleitkomma-Zahlen)
-
Aktualisiert die Ausgangspins für den Signalgenerator N. Jedes Mal, wenn er aufgerufen wird, berechnet er ein neues Sample. Er sollte um ein Vielfaches schneller aufgerufen werden als die gewünschte Signalfrequenz, um Verzerrungen und Aliasing zu vermeiden.
PINS
- siggen.N.frequency float in
-
Die Ausgangsfrequenz für den Signalgenerator N, in Hertz. Der Standardwert ist 1,0 Hertz.
- siggen.N.amplitude float in
-
Die Ausgangsamplitude für den Signalgenerator N. Wenn Offset Null ist, schwingen die Ausgänge von -Amplitude bis +Amplitude. Der Standardwert ist 1,00.
- siggen.N.offset float in
-
Der Ausgangsoffset für den Signalgenerator N. Dieser Wert wird direkt zum Ausgangssignal addiert. Der Standardwert ist Null.
- siggen.N.reset bit in
-
Setzt die Ausgangspins auf den vordefinierten Zustand zurück:
sine (Sinus) 0
sawtooth (Sägezahn) 0
square (Quadrat) -1 * Amplitude
cosine (Kosinus) -1 * Amplitude
triangle (Dreieck) -1 * Amplitude - siggen.N.clock bit out
-
Der Taktausgang. Bittyp-Taktsignalausgabe mit der befohlenen Frequenz.
- siggen.N.square float out
-
Die Rechteckwellenausgabe. Positiv, während triangle (Dreieck) und cosine (Kosinus) aufwärts laufen, und während sine (Sinus) negativ ist.
- siggen.N.sine float out
-
Der Sinus-Ausgang. Folgt cosine (dem Cosinus) um 90 Grad.
- siggen.N.cosine float out
-
Der Kosinus-Ausgang. Ist dem Sinus (engl. sine) um 90 Grad voraus.
- siggen.N.triangle float out
-
Der Ausgang der Dreieckswelle. Steigt an, wenn square (engl. für Quadrat, gemeint ist die Rechtecksspannung) positiv ist, und fällt ab, wenn square negativ ist. Erreicht seine positiven und negativen Spitzenwerte zur gleichen Zeit wie cosine (Kosinus).
- siggen.N.sawtooth float out
-
Der Sägezahnausgang. Er steigt bis zu seiner positiven Spitze an, fällt dann sofort auf seine negative Spitze ab und beginnt erneut zu steigen. Der Abfall tritt auf, wenn triangle (Dreieck) und cosine (Kosinus) ihre positiven Spitzenwerte erreichen, und fällt mit der abfallenden Flanke von square (Rechteckspannung) zusammen.
PARAMETER
Keine