Menufunktionen anlegen / Callback FunktionenAlle Funktionen die nicht "FUNC" heißen werden vom Menü als Callback Funktionen aufgerufen. Diese Funktionen müssen angelegt werden. In dem Vorgegebenen Beispiel befinden sich ein paar dieser Funktionen im dritten Tab "LCDML_function". Jede Funktion muss mit dem gleichen Gerüst, welches unten anhand einer Dummy Funktion beschrieben wird, aufgebaut werden.
void FUNC_dummy(void)
{
/* --------- INIT ---------
* Initialisierung dieser Funktion
* wird nur einmal beim Start dieser Funktion ausgefuert
* danach nur erneut, wenn die Menu Funktion verlassen wurde
* wenn keine Variablen initialisiert werden müssen, kann diese
* Funktion anstatt mit if(!LCDML.FuncInit()) .... mit
* LCDML.FuncInit(); aufgerufen werden
*/
if(!LCDML.FuncInit())
{
/* Init Function */
}
/* --------- LOOP ----------
* Hier sollte der Code stehen der ständig neu geladen wird
* z.B. eine Uhrzeit oder änliches.
*/
/* --------- STOP ---------
* LCDML.FuncEnd(direct, enter, up, down, left, right)
* Falls in dieser Funktion keine Variablen zurückgesetzt werden
* müssen, kann diese Funktion auch vereinfacht mit LCDML.FuncEnd(0, 1, 1, 1, 1, 1);
* aufgerufen werden. Die Endbedingungen können durch 1 aktiviert oder 0 deaktiviert
* werden
* Wenn alles 0 ist, hängt das gesammte Programm in dieser Funktion fest
*/
if(LCDML.FuncEnd(0, 1, 1, 1, 1, 1))
{
/* Bei allen Parameter gilt bei '0': nichts machen.
* Parameter 'direct':
* Die Funktion wird direkt beendet ohne auf weitere Ereignisse zu warten
* Parameter 'enter', 'up', 'down', 'left', 'right':
* Wenn z.B. 'enter' = 1 ist, muss einmal die Enter Taste gedrückt werden,
* damit die Funktion beendet wird.
* Wenn z.B. 'enter' = 2 ist, muss zweimal die Enter Taste gedrückt werden,
* damit die Funktion beendet wird.
* Dieses gilt bei den anderen Buttons 'up', 'down', ... genauso.
*/
/* Falls noch Variablen zurückgesetzt werden müssen, bevor diese Funktion
* verlassen wird, kann dies in dieser If Schleife geschehen
*/
}
}
angelegt werden.
Der Funktionsaufruf erfolgt automatisch, sobald der Menüpunkt mit "Enter" aufgerufen wird. Im Beispiel sind drei Funktionen hinterlegt, die Beispielcode beinhalten.
zu 8. Unterstützende Funktionen:Delays würden den Programmablauf stören und zu unerwarteten Problemen führen. Aus diesem Grund wurden eine Hilf Funktionen hinzugefügt, die dies vermeiden soll.
// Delay without Delays
// Variable global anlegen unter "Globale Variables"
unsigned long g_timer_xxBezeichnung = 0;
// In der Menufunktion
if(LCDML.Timer(g_timer_xxBezeichnung, 500)) {
//quellcode wird nur alle 500 ms einmal ausgeführt
}
Wenn man mehrere Timer in verschiedenen Menu Funktionen benötigt, sollte man nicht für jede Funktion eine eigene unsigned long Variable anlegen, sondern die Timer z.B. g_timer_func_1, g_timer_func_2 nennen und in mehreren Funktionen verwenden. Dies spart pro Variable 4Byte Ram.
Abfragen ob ein Button betätigt wurde:
if(LCDML.checkButtons()) {
//irgend ein Button wurde betätigt
}
Das jetzige Beispiel sieht die Steuerung über die Serielle Schnittstelle mit den Tasten 'a'=links, 's'=down, 'w'=up, 'd'=right, 'e'=enter und 'q' für quit/back/exit vor (Button mode = 0). Alternative kann das Menü über eine Tastatur die über eine geschickte Widerstandswahl an einen analogen Eingang angeschlossen ist bedient werden. Hier können auch beliebige andere Steuerungsmöglichkeiten vorgesehen werden. Folgende Möglichkeiten wurden schon im Forum gesehen:
- über eine IR Fernbedienung
- mit einem KeyPadShild
- über Netzwerk
Für die Entwicklung einer eigenen Steuerung gibt es die folgenden Funktionen:
LCDML.Button_enter();
LCDML.Button_up_down_left_right(_LCDMenuLib_button_up);
LCDML.Button_up_down_left_right(_LCDMenuLib_button_down);
LCDML.Button_up_down_left_right(_LCDMenuLib_button_left);
LCDML.Button_up_down_left_right(_LCDMenuLib_button_right);
LCDML.Button_quit();
Im Beispiel befindet sich der Code ganz unten im ersten Tab. z.B. bei ButtonMode_analog()
Die Ansteuerung mit LCDMenu_ButtonAnalog beinhaltet folgenden Code:
/* analog menu control */
void LCDMenuLib_control_analog()
{
uint16_t value = analogRead(0); // analogpin for keypad
#define _BUTTON_analog_enter_min 850 // Button Enter
#define _BUTTON_analog_enter_max 920
#define _BUTTON_analog_up_min 520 // Button Up
#define _BUTTON_analog_up_max 590
#define _BUTTON_analog_down_min 700 // Button Down
#define _BUTTON_analog_down_max 770
//optional if menu element "back" exists, look at FUNC_back in functions tab
#define _BUTTON_analog_enable_quit 1
#define _BUTTON_analog_back_min 950 // Button Back
#define _BUTTON_analog_back_max 1020
//optional if needed
#define _BUTTON_analog_enable_lr 1
#define _BUTTON_analog_left_min 430 // Button Left
#define _BUTTON_analog_left_max 500
#define _BUTTON_analog_right_min 610 // Button Right
#define _BUTTON_analog_right_max 680
if(LCDML.Timer(g_LCDMenuLib_press_time, _LCDMenuLib_cfg_press_time)) {
if(value >= _BUTTON_analog_enter_min && value <= _BUTTON_analog_enter_max) { // control enter
LCDML.Button_enter();
}
else if(value >= _BUTTON_analog_up_min && value <= _BUTTON_analog_up_max) { // control up
LCDML.Button_up_down_left_right(_LCDMenuLib_button_up);
}
else if(value >= _BUTTON_analog_down_min && value <= _BUTTON_analog_down_max) { // control down
LCDML.Button_up_down_left_right(_LCDMenuLib_button_down);
}
else if(value >= _BUTTON_analog_left_min && value <= _BUTTON_analog_left_max && _BUTTON_analog_enable_lr == 1) { // control left
LCDML.Button_up_down_left_right(_LCDMenuLib_button_left);
}
else if(value >= _BUTTON_analog_right_min && value <= _BUTTON_analog_right_max && _BUTTON_analog_enable_lr == 1) { // control right
LCDML.Button_up_down_left_right(_LCDMenuLib_button_right);
}
if(value >= _BUTTON_analog_back_min && value <= _BUTTON_analog_back_max && _BUTTON_analog_enable_quit == 1) { // control quit
LCDML.Button_quit();
}
}
}
Wenn ihr z.B. nur mit vier Tastern (hoch, runter, links, rechts) euer Menü steuern wollt, dann passt die Funktion an und bindet die Änderung unter einem neuen Funktionsnamen in der Loop Schleife oberhalb der LCDMenuLib_loop() ein. Rechts kann auch = Enter sein und Links = Quit. Die Standard Variante mit 6 Buttons wird von einem Makro in der Lib erzeugt. Eigene Anpassungen sollten kein Problem darstellen.
zu 10. Weitere Funktionen um gewisse Dinge Abzufragen:
LCDMenuLib_IS_reStartTime(); // restart initscreen wait time
LCDMenuLib_IS_startDirect(); // start initscreen direct
LCDMenuLib_getActiveFuncId() // get active function/menu element id
LCDML.getLayer() // get the layer where the menu is now
LCDML.getInitScreenActive() //
Ich hoffe dieses Tutorial hilft euch weiter.
Download:
LCDMenuLib
