FreeRTOS pdPASS constant not available

[Tuupertunut]

ESP-IDF documentation tells that the FreeRTOS function xTaskCreatePinnedToCore returns pdPASS if it succeeds.

The pdPASS constant is defined here in ESP-IDF headers.

However I can't access this constant from Rust through esp-idf-sys. It is not listed in the docs. Some other constants from the same header file can be found in esp-idf-sys, such as pdFREERTOS_ERRNO_ENOENT.

This is especially important because the value of pdPASS seems to be 1. The C wisdom of "0 means success" doesn't hold here.

[N3xed]

This is because of the way those macros are defined. We're using bindgen to generate the esp-idf bindings and it doesn't support generating constants for macros with casts and generally for function-like macros (see rust-lang/rust-bindgen#316).

We need to either define them ourselves or add special logic using bindgen::callbacks::ParseCallbacks::func_macro to generate them ourselves.

[ivmarkov]

Closing, because for now the philosophy if the project is to just generate raw bindings to whatever is available in the ESP IDF C headers, with very few - if any - customizations. In fact, the one and only exception is the EspError struct and its macros.