LCD Menu v2.0

Monday, Mar 18, 2013| Tags: lib

Improved and more advanced menu for small embedded systems.

Features

  • Simple implementation on character or graphic displays
  • Multilanguage support
  • Checkbox items
  • Items with displayed parameters: integer, string
  • Automatic transparent update of menu and parameters on the screen in time
  • Callbacks for every item
  • Scrolling with cursor and selected item in the middle on the screen, so you won’t accidentaly skip item that you’re looking for

Download

https://github.com/hubmartin/menu_library_v2

Demo

Simple example

#include "m2lib/m2.h"

// Simple menu
MenuItem menuItem0 = {{"First"}};
MenuItem menuItem1 = {{"Second"}};
Menu simpleMenu = {{"Simple Menu"}, .items = {&menuItem0, &menuItem1, 0}};

void m2Test()
{
    unsigned char ret;

    // Simple menu
    // return value is index of the selected item
    ret = menu2(&simpleMenu);
}

Advanced menu example

//
// Advanced menu definitions
//

// Items
MenuItem item0 = {{"Tick"}, callback, MENU_PARAMETER_IS_NUMBER | MENU_CALLBACK_IS_FUNCTION, (int)&msTick};
MenuItem item1 = {{"Lang SubMnu"}, (void*)&subMenu,  MENU_CALLBACK_IS_SUBMENU, 0};
MenuItem itemTime = {{"Time"}, callback, MENU_PARAMETER_IS_STRING | MENU_CALLBACK_IS_FUNCTION, (int)"12:05"};
MenuItem item2 = {{"Count"}, callback, MENU_ITEM_IS_CHECKBOX | MENU_ITEM_IS_CHECKED | MENU_CALLBACK_IS_FUNCTION};
MenuItem item3 = {{"Lights"}, callback, MENU_ITEM_IS_CHECKBOX  };
MenuItem item4 = {{"Sound"}, callback, MENU_ITEM_IS_CHECKBOX | MENU_ITEM_IS_CHECKED };
MenuItem item5 = {{"Fan"}, callback, MENU_ITEM_IS_CHECKBOX };
MenuItem item6 = {{"Buzzer"}, callback, MENU_ITEM_IS_CHECKBOX | MENU_ITEM_IS_CHECKED };
MenuItem item7 = {{"Last check"}, callback, MENU_ITEM_IS_CHECKBOX };

// Menu
// Notice that some items are duplicated, the same menuItem can be used in multiple menus or in thee same menu
Menu menu = {
    {"Menu ver2"},
    .items = {&item0, &item1, &itemTime, &item2, &item3, &item2, &item5, &item6, &item7, &item3, &item4, 0},
    .refresh = 200
};

void m2Test()
{
    // Advanced menu
    menu2(&menu);
}

// Callback
void callback(void *m)
{
    Menu* menu = ((Menu*)m);
    MenuItem *selectedItem = menu->items[menu->selectedIndex];

    // Increment value in second menu item
    if(selectedItem == &item2)
    {
        selectedItem->flags |= MENU_PARAMETER_IS_NUMBER;
        selectedItem->parameter = (int)&testVal;
        testVal++;
        return;
    }

    displayClear();
    displayString("Item callback", 0, ROW(0));
    displayString("Index:", 0, ROW(1));
    displayNumber(menu->selectedIndex, COL(8), ROW(1));
    displayString("Item name:", 0, ROW(2));
    displayString(selectedItem->text[menuLanguage], 0, ROW(3));
    displayDraw();

    while(evtGet() == 0);
}

Multilanguage menu example

//
// Submenu definitions, multilanguage menu
//

// Items
MenuItem aa = {{"Prvni", "First"}, 0, MENU_PARAMETER_IS_NUMBER, (int)&msTick};
MenuItem bb = {{"Druha", "Second"}, 0, MENU_PARAMETER_IS_NUMBER, (int)&testVal};
MenuItem cc = {{"Zmen jazyk", "Change lang"}, switchLanguage, MENU_CALLBACK_IS_FUNCTION};
// Menu
Menu subMenu = {{"Czech Menu", "English Menu"}, .items = {&aa, &bb, &cc, 0}, .refresh = 1000};

// Simple switching between two languages
void switchLanguage(void *m)
{
    menuLanguage = menuLanguage == LANGUAGE_CZECH ? LANGUAGE_ENGLISH : LANGUAGE_CZECH;
}