In the getting started section, what does "next to" refer to?

Get started
1

Hi, new to the forum and appreciate any guidance. Really dumb question, but in the Getting Started section the instructions say:

  • Copy lvgl/lv_conf_template.h as lv_conf.h next to the lvgl folder, change the first #if 0 to 1 to enable the file’s content and set the LV_COLOR_DEPTH defines.
    …I’m unclear what “next to” is…does that just mean 'in the lvgl folder", does it mean “in the same folder as the lvgl directory”? I’ve never used the phrase ‘next to’ in the digital space.
    I appreciate any guidance.
2

What matters is that the lvgl source files find lv_conf.h.

This is the relevant code in the files that need it:

#if !defined(LV_CONF_SKIP) || defined(LV_CONF_PATH)
    #ifdef LV_CONF_PATH                           /*If there is a path defined for lv_conf.h use it*/
        #define __LV_TO_STR_AUX(x) #x
        #define __LV_TO_STR(x) __LV_TO_STR_AUX(x)
        #include __LV_TO_STR(LV_CONF_PATH)
        #undef __LV_TO_STR_AUX
        #undef __LV_TO_STR
    #elif defined(LV_CONF_INCLUDE_SIMPLE)         /*Or simply include lv_conf.h is enabled*/
        #include "lv_conf.h"
    #else
        #include "../../lv_conf.h"                /*Else assume lv_conf.h is next to the lvgl folder*/
    #endif
    #if !defined(LV_CONF_H) && !defined(LV_CONF_SUPPRESS_DEFINE_CHECK)
        /* #include will sometimes silently fail when __has_include is used */
        /* https://gcc.gnu.org/bugzilla/show_bug.cgi?id=80753 */
        #pragma message("Possible failure to include lv_conf.h, please read the comment in this file if you get errors")
    #endif
#endif

The default path to look for lv_conf here is ../../lv_conf.h and since this file is in lvgl/src, that would mean “inside the parent folder of the lvgl folder”, which is what they mean by “next to the lvgl folder”.

In my case that didn’t work though, I added the lvgl folder (as instructed?), not the src folder, so there was no path in the include path list such that ../../lv_conf.h would be defined.

So, I defined the LV_CONF_INCLUDE_SIMPLE symbol and added the folder containing lv_conf.h to include paths, and things worked. But including lvgl/src in the include paths would probably also have solved it.

3

Thank you!!! I appreciate the guidance!!!