Videos
HowTo-Videos
Terminierungen über die Projektkonfiguration vornehmen
In diesem Video zeigen wir Ihnen, wie Sie die Terminierungen aus einem Projekt vornehmen können.
Über den Befehl u08 rbs_api_system_control_terminating_resistor(u08 Channel, u08 enable); können die Terminierungen aktiviert/deaktiviert werden.
Das Aktivieren und Deaktivieren von Terminierungen, gesteuert durch ein Projekt bietet sich immer dann an, wenn es bspw. einen Aufbau mehrfach gibt, und man sich den Aufwand des manuellen Konfigurierens jeder Hardware ersparen möchte. Auch wenn ein FlexDevice in mehreren Aufbauten abwechselnd verwendet wird, kann es von Vorteil sein, wenn die notwendigen Anpassungen der Hardware nach jedem Flashen automatisch vorgenommen werden.
Die Konfiguration des Aufruf u08 rbs_api_system_control_terminating_resistor(u08 Channel, u08 enable); innerhalb des UserFunction-Editors startet bei [3:37].
Die Umsetzung der Funktionalität sollte in der InitUserFunction im UserFunction-Editor vorgenommen werden. Bei der Initialisierung des FlexDevice (direkt nach dem Starten) wird sichergestellt, dass die erwartete Hardwarekonfiguration vorgenommen wird.
Details:
Der Funktionsaufruf u08 rbs_api_system_control_terminating_resistor(u08 Channel, u08 enable); ist folgendermaßen aufgebaut:
/**
* Control communication channels terminating resistors.
*
* Some channel transceiver paths supports
* controllable terminating resistors.
* These resistors can be enabled or
* disabled via this function.
*
* @since 1.3.0.0
*
* @param channel_number Number of hardware channel (1 - ...)
* @param enable Flag if terminating resistor should be enabled
* 1 = Enable terminating resistor
* 0 = Disable terminating resistor
*
* @return Returns the state of the terminating resistors after this function was called.
* 0 = Terminating resistor is disabled
* 1 = Terminating resistor is enabled
* other values = Terminating resistors are not supported by this channel
Hinweis:
Werden die Settings manuell während der Laufzeit geändert, führt ein Neustart des FlexDevice dazu, dass die manuellen Anpassungen automatisch wieder überschrieben werden.
Beispiel Aufruf:
- u08 rbs_api_system_control_terminating_resistor(2, 1);
Voraussetzungen:
- FlexConfig RBS in der Version 5.2.2.3698 oder höher
- Hardware: FlexDevice S/L/L², FlexCard PCIe3/PXIe3
*******************************
Wünschen Sie ein HowTo-Video zu einem speziellen Anwendungsfall oder zu einem speziellen Thema? Zögern Sie nicht uns per E-Mail Ihr Anliegen mitzuteilen!
Kennen Sie Personen die ebenfalls mit FlexConfig RBS vertraut sind und von der HowTo-Video Serie profitieren können? Leiten Sie dieses Video gerne weiter oder verweisen Sie diese auf die Möglichkeit sich für unseren Newsletter zu registrieren!
Erzeugen von Logausgaben auf der diagnosis page
In diesem Video wird demonstriert, wie sich in FlexConfig RBS über die Befehle rbs_api_log_write (""); und rbs_api_log_write_printf(""); Logausgaben auf der diagnosis page (192.168.1.15/log) eines FlexDevice erzeugen lassen.
Eine Logausgabe bietet sich als Hilfsmittel an, um an den zugänglichen Stellen eines Programmcodes eine Möglichkeit zum Debuggen zu schaffen.
Ebenfalls kann die Logausgabe dazu verwendet werden, um wichtige Informationen auf die diagnosis page zu schreiben, um bspw. zur Laufzeit auf Informationen Zugriff zu haben.
Die Konfiguration der Aufrufe rbs_api_log_write (""); und rbs_api_log_write_printf (""); innerhalb der UserFunction startet bei [1:40]
Details:
Die Funktionsaufrufe rbs_api_log_write (""); und rbs_api_log_write_printf(""); sind folgendermaßen aufgebaut:
/**
* Write static message into log.
* Start message with tag using "[YourTag]" syntax
* to group messages.
*
* @since 1.1.0.0
*
* @param text Text to write into log
*
* @return void - No return value
*/
void rbs_api_log_write(char* message);
/**
'* Write formatted text into log.
* Start message with tag using "[YourTag]" syntax
* to group messages.
*
* @since 1.1.0.0
*
* @param template Format template like printf
* @param values Values for given template
*
* @return void - No return value
*/
void rbs_api_log_write_printf(char* template, ...);
Hinweis:
HTML Formatierungen können innerhalb der Funktion genutzt werden. Nutzen Sie am Beginn des Textes die eckigen Klammern „[…]“, um Ihrer Ausgabe eine visuelle Kategorie zuzuweisen.
Beispiel Aufrufe:
• rbs_api_log_write("Hallo World");
• rbs_api_log_write ("[Text] Hallo World");
• u08 myvar = 1;
• rbs_api_log_write_printf("myvar value: %d", myvar);
• rbs_api_log_write ("[Debug] I <span style=\"color:white;background-color:red;font-weight:bold;\">love</span> FlexConfig RBS.");
Achtung:
Die API Funktionen sind dem UserFunction-Editor „unbekannt“, weshalb es zu den Warnungen „implicit declaration“ kommt. Diese Warnungen können ignoriert werden.
Der Aufruf der diagnosis page zur Laufzeit kann Einfluss auf das Laufzeitverhalten haben und sollte deshalb mit Bedacht eingesetzt werden. Vor allem ein sehr häufiges Aufrufen der printf Funktion hat Einfluss auf die Performance und somit auf das Laufzeitverhalten des Projekts. Es empfiehlt sich daher die printf Ausgaben im Produktiveinsatz zu entfernen oder auf ein Minimum zu reduzieren. Über eigene UserDefines (Edit -> UserDefines) können die printf Ausgaben sehr einfach gesammelt deaktiviert werden.
Userfunction:
#ifdef MyDebug
rbs_api_log_write("write only when User Define MyDebug is activated");
#endif
Voraussetzungen:
- FlexConfig RBS 5.2.2.3684
- Hardware: FlexDevice S/L/L², FlexCard PCIe3/PXIe3
*******************************
Wünschen Sie ein HowTo-Video zu einem speziellen Anwendungsfall oder zu einem speziellen Thema? Zögern Sie nicht uns per E-Mail Ihr Anliegen mitzuteilen!
Kennen Sie Personen die ebenfalls mit FlexConfig RBS vertraut sind und von der HowTo-Video Serie profitieren können? Leiten Sie dieses Video gerne weiter oder verweisen Sie diese auf die Möglichkeit sich für unseren Newsletter zu registrieren!
