Documented but forbidden RTOS functions?

[kirillandy]

Hello all!
Apologies if this question has been asked before, the forum search would stubbornly not work on my end, so I ended up making this post...

I was wondering about the extent to which I may tinker with IDF and RTOS include files.
I'm using the ESP32 Arduino API in Visual Micro to program a ESP32-S3 board, and I would like to use the Free RTOS "task tag" functions (e.g. vTaskSetApplicationTaskTag) to assign unique data to tasks. However, upon attempting this, I discovered that these functions in particular are hidden behind #ifdefs for a constant that is set to 0 (configUSE_APPLICATION_TASK_TAG is the define in question).

It's a bit odd how these functions are fully documented in the FREE RTOS (IDF) section of the docs, yet they are not available. Would it be possible to "unlock" them by simply setting configUSE_APPLICATION_TASK_TAG to 1 in the .h file, or is it more complicated than that and are these functions simply not supported for my board or in FREE RTOS IDF in general?

TY!

[MicroController]

This feature of FreeRTOS, like some others, can be enabled via Kconfig/"menuconfig" for IDF applications.
To use them in the Arduino environment, you may have to enable it and then (re-)build the Arduino libraries.

[kirillandy]

I see. I've seen kconfig mentioned here and there but haven't yet figured out how to use it properly. Will read up on this, thank you!

[MicroController]

With the IDF, you'd use idf.py menuconfig. Dunno about Arduino though.