Minimal example from the docs doesn't compile

[DrTron]

All,
I'm already using the TFT_eSPI library successfully with a display and am now trying to add a menu, so I found this project.
I have some programming experience but for new stuff have to rely on working examples.
I tried to run the minimal example in the documentation but get "error: no matching function for call to 'OpenMenuOS::begin()'" on the menu.begin();.

I'm not sure what to expect, but a minimal example without even flashing to a microcontroller should at least compile, right?
I'm using OpenmenuOS 3.1.0 on Arduino-IDE 2.3.10.

This is the code from the example:

#include "OpenMenuOS.h"

OpenMenuOS menu;

void setup() {
  menu.begin();
  menu.setupButtons(19, -1, 2, INPUT_PULLUP, LOW);
  menu.setEncoderPin(5, 4);  // CLK, DT pins
  
  menu.setMainMenuItems({"LED Control", "Settings", "About"});
  menu.createMainMenu();
}

void loop() {
  menu.loop();
}

[loic-daigle]

Hi! Can you try downgrading the OpenMenuOS version so we can see if this is related to a newer version? I ever got this error to what i remember.

[DrTron]

Of course. I installed version 3.0.1, same error.

[loic-daigle]

Hi!

The issue is that begin() expects a main menu pointer, like that: menu.begin(&mainMenu). Also, in your minimal code, you didn't define any screen for the library to display. You need to define a screen with MenuScreen , and then you can add different items in the screen's menu using addItem.

Here is your fixed minimal code:

#include "OpenMenuOS.h"

OpenMenuOS menu;
MenuScreen mainMenu("Main Menu");

void setup() {
  Serial.begin(115200);

  menu.setButtonsMode("low");
  menu.setEncoderPin(5, 4); // CLK, DT
  menu.setSelectPin(19);    // Select button pin

  mainMenu.addItem("LED Control");
  mainMenu.addItem("Settings");
  mainMenu.addItem("About");

  menu.begin(&mainMenu); // <-- required in current version
}

void loop() {
  menu.loop();
}

[DrTron]

Thanks, that works (with v3.1.0 at least).
But I don't think I'm getting the concept of the menu system. Here's my test sketch.
With the menu stuff disabled (and invoking the tft_espi library, which apparently OpenmenuOS does for me), I can initialize the display and see my test text.
With the menu enabled, the screen stays blank. Pushing the button defined in menu.setSelectPin should invoke the menu, correct?

I have to admit that there is a lot of code in the full example I don't understand, so I'm trying to go minimalistic here.
Thanks!

#include "OpenMenuOS.h"
#include <Arduino.h>
#include <SPI.h>
#define USER_SETUP_LOADED 
#include "User_Setup.h"
#include <TFT_eSPI.h>

#define WHITE 0xFFFF
//TFT_eSPI tft = TFT_eSPI(); 
OpenMenuOS menu;

MenuScreen mainMenu("Main Menu");

void setup() {
  Serial.begin(115200);

ledcAttach(16, 5000, 8);
ledcWrite(16, 255);  

tft.init();
   // Set screen orientation (0 to 3)
tft.setRotation(3); 
 
tft.fillScreen(TFT_BLACK);
tft.setTextSize(2);
tft.setCursor(50,50);
tft.setTextColor(WHITE);
tft.print("Test");
Serial.println("Test");

  menu.setButtonsMode("low");
  menu.setEncoderPin(12, 13); // CLK, DT
  menu.setSelectPin(14);    // Select button pin

  mainMenu.addItem("LED Control");
  mainMenu.addItem("Settings");
  mainMenu.addItem("About");

  menu.begin(&mainMenu); // <-- required in current version
}

void loop() {
  menu.loop();
}

[DrTron]

So I tried about every example I could find, either with buttons or a rotary encoder, still nothing.
The screen works, as mentioned above, just Openmenuos doesn't. All I get is a black screen after the initial white screen on boot, but nothing to be displayed there.
When I push the encoder button I get "Error: Invalid setting index!" in the serial console in one of my sketches, so it's apparently doing something, but not on the display...

[loic-daigle]

Hi!

I think the issue is because you init the display with tft.init(), which OpenMenuOS already do. To draw custom things, you need to use canvas. instead of tft., because we draw everything on a canvas, which is then pushed completely to the screen. This eliminate flickering. Just change all tft. to use canvas. instead.

For example ;

    canvas.fillScreen(TFT_BLACK);
    canvas.setTextColor(TFT_WHITE);
    canvas.setFreeFont(&FreeMono9pt7b);
    
    canvas.drawString("Smart Device v1.0", 10, 30);
    canvas.drawString("OpenMenuOS v" + String(menu.getLibraryVersion()), 10, 50);
    canvas.drawString("ESP32-based IoT Device", 10, 70);
    
    canvas.setTextColor(TFT_CYAN);
    canvas.drawString("Press SELECT to return", 10, 100);

Also, to set the rotation, you can refer to this: menu.setDisplayRotation(int rotation) // Set display rotation (0-3)

Hope that fixes the problem!

[DrTron]

Hmm, I used your example from here, which uses the canvas instead of tft.
The only thing I added was #include "User_Setup.h" to include the pin definitions for the TFT.
Still, blank display. The sketch runs, though, I see Menu system started. in the serial console.

[loic-daigle]

Hi! That's strange. You shouldn't even need to include the user setup file. To what I remember, you should only need to set the config you wanna use in the TFT espi folder, in your Arduino library folder. I think the problem may be with TFT espi, in the way you define the config, but I'm not sure.

[DrTron]

Hi!
I'm admittedly a bit at a loss here.
The user config for TFT.eSPI is in the file User_Setup.h, which resides in the same directory as the sketch.
And like I said, if I remove all the menu entries from my demo sketch, it compiles, runs and the display works fine, so it's definitively not a mis-wiring issue or such.

[loic-daigle]

That's strange. Did the sample code I gave you at first work flawlessly?

[DrTron]

I'll try again tonight but I think it compiled but gave me a blank display again.

I just remembered that I currently only have MOSI connected to the display but not MISO. Could that be the cause? Is there anything communicating back from the display?

[loic-daigle]

No, you shouldn't need to connect MISO. However, if it gave you a blank display, then the issue is definitely with the way the connections are defined in TFT_eSPI. I think the issue is that you don't correctly define which "connections" files you want to use. You can do this by going into your Arduino library folder on your PC, and there should be a file where you can define which connection file to use. You can check the TFT_eSPI docs to see how that work, but I think that's what would fix your problem because it would make the connection config be global, so that OpenMenuOS can "see" them.

[DrTron]

Hmm, so you're saying that TFT_espi might use a different config file when openmenuos calls it in contrast to when the sketch calls it directly? Is there a way to use the local config in the sketch directory?
The reason is that I have more than one esp32 that use this library, with different gpio's being used, mostly for backlight, CS, DC and RST.

[loic-daigle]

Yes, I think that's what happens. But there is no way, yet, to make OpenMenuIs use a local config file for now. I understand that's not ideal tho.

[DrTron]

Thanks, I'll update the user config in the TFT_espi library directory tonight and see what that does.
Those I haven't touched so they are likely incorrect, which would explain what I see.
Thanks!