Question about TouchSensing

[j_filipe]

Greetings, 
I have a question about the touchsensing module. I am using a stm32u585rit6 mcu in a custom-made board and making a project using azure rtos. I needed to add touchsensing. I watched the app_azure_rtos_config.h and noticed that there is static memory allocation via threadX memory pools (#define TOUCHSENSING_APP_MEM_POOL_SIZE   5000). Then, at the app_azure_rtos.c file there is the following: 

__ALIGN_BEGIN static UCHAR  tsc_byte_pool_buffer[TOUCHSENSING_APP_MEM_POOL_SIZE] __ALIGN_END;
static TX_BYTE_POOL tsc_app_byte_pool;

if (tx_byte_pool_create(&tsc_app_byte_pool, "TOUCHSENSING App memory pool", tsc_byte_pool_buffer, TOUCHSENSING_APP_MEM_POOL_SIZE) != TX_SUCCESS)
  {
    /* USER CODE BEGIN TOUCHSENSING_Byte_Pool_Error */

    /* USER CODE END TOUCHSENSING_Byte_Pool_Error */
  }
  else
  {
    /* USER CODE BEGIN TOUCHSENSING_Byte_Pool_Success */

    /* USER CODE END TOUCHSENSING_Byte_Pool_Success */

    memory_ptr = (VOID *)&tsc_app_byte_pool;
    status = MX_TOUCHSENSING_Init(memory_ptr);
    if (status != TSL_STATUS_OK)
    {
      /* USER CODE BEGIN  MX_TOUCHSENSING_Init_Error */
      while(1)
      {
      }
      /* USER CODE END  MX_TOUCHSENSING_Init_Error */
    }
    /* USER CODE BEGIN  MX_TOUCHSENSING_Init */

    /* USER CODE END  MX_TOUCHSENSING_Init */
  }

What is the purpose of this memory pool? Is there any thread related to touchsensing running?
Thank you! 

[Imen.D · Accepted solution]

Hello @j_filipe ,

The memory pool in the TouchSensing module is used to reserve a specific memory space for the middleware (MW) functions of the TouchSensing module.
TOUCHSENSING_APP_MEM_POOL_SIZE is generated "hardcoded" by CubeMX. When you have ThreadX + TouchSensing MW, it will add this define, with the default value 5000 in the app_azure_rtos_config.h file, and you can change it manually in the code if needed.
The define itself is used to create the tsc_byte_pool_buffer, used for the memory context of the TouchSensing MW functions.
This "buffer" is a memory space reserved for the MW, so it is not really "used" by the MW directly.
I'll suggest having a look at the official documentation regarding that point:
https://github.com/eclipse-threadx/rtos-docs/blob/main/rtos-docs/threadx/chapter3.md#memory-block-pools

The TouchSensing MW entry point is managed by function "MX_TOUCHSENSING_Init()", and is working in this memory pool.

Hope my answer helps you!

[j_filipe]

Thank you for the input!