Skip to main content
Associate II
October 21, 2025
Question

VSCode: RtosProxy error with big thread stack on ThreadX

  • October 21, 2025
  • 13 replies
  • 1157 views

During a debugging session, when `tx_thread_create` is called with a "big" stack size (1024*10 for example) and the "serverRtos" is enabled, the debugger is disconnected with an error: "Remote communication error. Target disconnected: No error."

 

Here the debug console logs (full log attached):

 

Spoiler
To client: {"seq":0,"type":"event","event":"output","body":{"category":"proxy","output":"RTOS proxy: Lost connection to GDB Server\r\n"}}
RTOS proxy: Lost connection to GDB Server
To client: {"seq":0,"type":"event","event":"output","body":{"category":"stdout","output":"{\"label\":\"\",\"value\":[{\"label\":\"Driver\",\"value\":\"ThreadX\"},{\"label\":\"Kernel state\",\"value\":\"Not started\"}]}\n"}}
{"label":"","value":[{"label":"Driver","value":"ThreadX"},{"label":"Kernel state","value":"Not started"}]}
GDB result: 36 done
To client: {"seq":0,"type":"response","request_seq":25,"command":"cdt-gdb-tests/executeCommand","success":true,"body":{"status":"Ok","result":{},"console":["monitor rtos -m state\n","{\"label\":\"\",\"value\":[{\"label\":\"Driver\",\"value\":\"ThreadX\"},{\"label\":\"Kernel state\",\"value\":\"Not started\"}]}\n"]}}
To client: {"seq":0,"type":"event","event":"output","body":{"category":"proxy","output":"RTOS proxy: Proxy stopped.\r\n"}}
RTOS proxy: Proxy stopped.
GDB notify async: thread-exited,id="1",group-id="i1"
GDB notify async: thread-group-exited,id="i1"
GDB result: 37 error,msg="Remote communication error. Target disconnected: No error."

And the very basic code used:

/* USER CODE BEGIN Header */
/**
 ******************************************************************************
 * @file app_threadx.c
 * @author MCD Application Team
 * @brief ThreadX applicative file
 ******************************************************************************
 * @attention
 *
 * Copyright (c) 2025 STMicroelectronics.
 * All rights reserved.
 *
 * This software is licensed under terms that can be found in the LICENSE file
 * in the root directory of this software component.
 * If no LICENSE file comes with this software, it is provided AS-IS.
 *
 ******************************************************************************
 */
/* USER CODE END Header */

/* Includes ------------------------------------------------------------------*/
#include "app_threadx.h"

/* Private includes ----------------------------------------------------------*/
/* USER CODE BEGIN Includes */

/* USER CODE END Includes */

/* Private typedef -----------------------------------------------------------*/
/* USER CODE BEGIN PTD */

/* USER CODE END PTD */

/* Private define ------------------------------------------------------------*/
/* USER CODE BEGIN PD */

/* USER CODE END PD */

/* Private macro -------------------------------------------------------------*/
/* USER CODE BEGIN PM */

/* USER CODE END PM */

/* Private variables ---------------------------------------------------------*/
TX_THREAD tx_app_thread;
/* USER CODE BEGIN PV */

/* USER CODE END PV */

/* Private function prototypes -----------------------------------------------*/
/* USER CODE BEGIN PFP */
VOID th_main(ULONG thread_input)
{
 while (1)
 {
 tx_thread_sleep(1);
 }
}
TX_THREAD p_thMain;
#define MAIN_THREAD_STACK_SIZE (1024*10)
CHAR thMain_stack[MAIN_THREAD_STACK_SIZE];
/* USER CODE END PFP */

/**
 * @brief Application ThreadX Initialization.
 * memory_ptr: memory pointer
 * @retval int
 */
UINT App_ThreadX_Init(VOID *memory_ptr)
{
 UINT ret = TX_SUCCESS;
 TX_BYTE_POOL *byte_pool = (TX_BYTE_POOL*)memory_ptr;

 /* USER CODE BEGIN App_ThreadX_MEM_POOL */
 /* USER CODE END App_ThreadX_MEM_POOL */
 CHAR *pointer;

 /* Allocate the stack for tx app thread */
 if (tx_byte_allocate(byte_pool, (VOID**) &pointer,
 TX_APP_STACK_SIZE, TX_NO_WAIT) != TX_SUCCESS)
 {
 return TX_POOL_ERROR;
 }
 /* Create tx app thread. */
 if (tx_thread_create(&tx_app_thread, "tx app thread", tx_app_thread_entry, 0, pointer,
 TX_APP_STACK_SIZE, TX_APP_THREAD_PRIO, TX_APP_THREAD_PREEMPTION_THRESHOLD,
 TX_APP_THREAD_TIME_SLICE, TX_APP_THREAD_AUTO_START) != TX_SUCCESS)
 {
 return TX_THREAD_ERROR;
 }

 /* USER CODE BEGIN App_ThreadX_Init */
 tx_thread_create(&p_thMain, "Main Thread", th_main, 0, thMain_stack,
 MAIN_THREAD_STACK_SIZE, TX_APP_THREAD_PRIO, TX_APP_THREAD_PREEMPTION_THRESHOLD,
 TX_APP_THREAD_TIME_SLICE, TX_APP_THREAD_AUTO_START);

 /* USER CODE END App_ThreadX_Init */

 return ret;
}
/**
 * @brief Function implementing the tx_app_thread_entry thread.
 * thread_input: Hardcoded to 0.
 * @retval None
 */
void tx_app_thread_entry(ULONG thread_input)
{
 /* USER CODE BEGIN tx_app_thread_entry */
 while (1)
 {
 tx_thread_sleep(100);
 }
 /* USER CODE END tx_app_thread_entry */
}

 /**
 * @brief Function that implements the kernel's initialization.
 * None
 * @retval None
 */
void MX_ThreadX_Init(void)
{
 /* USER CODE BEGIN Before_Kernel_Start */

 /* USER CODE END Before_Kernel_Start */

 tx_kernel_enter();

 /* USER CODE BEGIN Kernel_Start_Error */

 /* USER CODE END Kernel_Start_Error */
}

/**
 * @brief App_ThreadX_LowPower_Timer_Setup
 * count : TX timer count
 * @retval None
 */
void App_ThreadX_LowPower_Timer_Setup(ULONG count)
{
 /* USER CODE BEGIN App_ThreadX_LowPower_Timer_Setup */

 /* USER CODE END App_ThreadX_LowPower_Timer_Setup */
}

/**
 * @brief App_ThreadX_LowPower_Enter
 * None
 * @retval None
 */
void App_ThreadX_LowPower_Enter(void)
{
 /* USER CODE BEGIN App_ThreadX_LowPower_Enter */

 /* USER CODE END App_ThreadX_LowPower_Enter */
}

/**
 * @brief App_ThreadX_LowPower_Exit
 * None
 * @retval None
 */
void App_ThreadX_LowPower_Exit(void)
{
 /* USER CODE BEGIN App_ThreadX_LowPower_Exit */

 /* USER CODE END App_ThreadX_LowPower_Exit */
}

/**
 * @brief App_ThreadX_LowPower_Timer_Adjust
 * None
 * @retval Amount of time (in ticks)
 */
ULONG App_ThreadX_LowPower_Timer_Adjust(void)
{
 /* USER CODE BEGIN App_ThreadX_LowPower_Timer_Adjust */
 return 0;
 /* USER CODE END App_ThreadX_LowPower_Timer_Adjust */
}

/* USER CODE BEGIN 1 */

/* USER CODE END 1 */

 

13 replies

mbarg.1
Senior III
October 21, 2025

ThreadX takes control of your app and rtos diconnect ..

Seems ok

PierreBAuthor
Associate II
October 21, 2025

It works as expected with a smaller stack size

mbarg.1
Senior III
October 21, 2025

Did you check Build Analyzer - Memory details ? Can you share? with small and large stack?

PierreBAuthor
Associate II
October 21, 2025

With 10240 stack size

PierreB_0-1761051581292.png

With 1024 stack size

PierreB_1-1761051646707.png

 

The debugger "crash" at the line "previous_thread -> tx_thread_created_next = thread_ptr;" (line 258) in the "_tx_thread_create" function

 

/**************************************************************************/
/* */
/* Copyright (c) Microsoft Corporation. All rights reserved. */
/* */
/* This software is licensed under the Microsoft Software License */
/* Terms for Microsoft Azure RTOS. Full text of the license can be */
/* found in the LICENSE file at https://aka.ms/AzureRTOS_EULA */
/* and in the root directory of this software. */
/* */
/**************************************************************************/


/**************************************************************************/
/**************************************************************************/
/** */
/** ThreadX Component */
/** */
/** Thread */
/** */
/**************************************************************************/
/**************************************************************************/

#define TX_SOURCE_CODE


/* Include necessary system files. */

#include "tx_api.h"
#include "tx_trace.h"
#include "tx_thread.h"
#include "tx_initialize.h"


/**************************************************************************/
/* */
/* FUNCTION RELEASE */
/* */
/* _tx_thread_create PORTABLE C */
/* 6.3.0 */
/* AUTHOR */
/* */
/* William E. Lamie, Microsoft Corporation */
/* */
/* DESCRIPTION */
/* */
/* This function creates a thread and places it on the list of created */
/* threads. */
/* */
/* INPUT */
/* */
/* thread_ptr Thread control block pointer */
/* name Pointer to thread name string */
/* entry_function Entry function of the thread */
/* entry_input 32-bit input value to thread */
/* stack_start Pointer to start of stack */
/* stack_size Stack size in bytes */
/* priority Priority of thread */
/* (default 0-31) */
/* preempt_threshold Preemption threshold */
/* time_slice Thread time-slice value */
/* auto_start Automatic start selection */
/* */
/* OUTPUT */
/* */
/* return status Thread create return status */
/* */
/* CALLS */
/* */
/* _tx_thread_stack_build Build initial thread stack */
/* _tx_thread_system_resume Resume automatic start thread */
/* _tx_thread_system_ni_resume Noninterruptable resume thread*/
/* */
/* CALLED BY */
/* */
/* Application Code */
/* _tx_timer_initialize Create system timer thread */
/* */
/* RELEASE HISTORY */
/* */
/* DATE NAME DESCRIPTION */
/* */
/* 05-19-2020 William E. Lamie Initial Version 6.0 */
/* 09-30-2020 William E. Lamie Modified comment(s), and */
/* changed stack calculations */
/* to use ALIGN_TYPE integers, */
/* resulting in version 6.1 */
/* 06-02-2021 William E. Lamie Modified comment(s), and */
/* supported TX_MISRA_ENABLE, */
/* 08-02-2021 Scott Larson Removed unneeded cast, */
/* resulting in version 6.1.8 */
/* 10-31-2023 Xiuwen Cai Modified comment(s), */
/* added option for random */
/* number stack filling, */
/* resulting in version 6.3.0 */
/* */
/**************************************************************************/
UINT _tx_thread_create(TX_THREAD *thread_ptr, CHAR *name_ptr, VOID (*entry_function)(ULONG id), ULONG entry_input,
 VOID *stack_start, ULONG stack_size, UINT priority, UINT preempt_threshold,
 ULONG time_slice, UINT auto_start)
{

TX_INTERRUPT_SAVE_AREA

TX_THREAD *next_thread;
TX_THREAD *previous_thread;
TX_THREAD *saved_thread_ptr;
UINT saved_threshold = ((UINT) 0);
UCHAR *temp_ptr;

#ifdef TX_ENABLE_STACK_CHECKING
ALIGN_TYPE new_stack_start;
ALIGN_TYPE updated_stack_start;
#endif

#ifndef TX_DISABLE_STACK_FILLING
#if defined(TX_ENABLE_RANDOM_NUMBER_STACK_FILLING) && defined(TX_ENABLE_STACK_CHECKING)

 /* Initialize the stack fill value to a 8-bit random value. */
 thread_ptr -> tx_thread_stack_fill_value = ((ULONG) TX_RAND()) & 0xFFUL;

 /* Duplicate the random value in each of the 4 bytes of the stack fill value. */
 thread_ptr -> tx_thread_stack_fill_value = thread_ptr -> tx_thread_stack_fill_value |
 (thread_ptr -> tx_thread_stack_fill_value << 8) |
 (thread_ptr -> tx_thread_stack_fill_value << 16) |
 (thread_ptr -> tx_thread_stack_fill_value << 24);
#endif

 /* Set the thread stack to a pattern prior to creating the initial
 stack frame. This pattern is used by the stack checking routines
 to see how much has been used. */
 TX_MEMSET(stack_start, ((UCHAR) TX_STACK_FILL), stack_size);
#endif

#ifdef TX_ENABLE_STACK_CHECKING

 /* Ensure that there are two ULONG of 0xEF patterns at the top and
 bottom of the thread's stack. This will be used to check for stack
 overflow conditions during run-time. */
 stack_size = ((stack_size/(sizeof(ULONG))) * (sizeof(ULONG))) - (sizeof(ULONG));

 /* Ensure the starting stack address is evenly aligned. */
#ifdef TX_MISRA_ENABLE
 new_stack_start = TX_POINTER_TO_ULONG_CONVERT(stack_start);
#else
 new_stack_start = TX_POINTER_TO_ALIGN_TYPE_CONVERT(stack_start);
#endif /* TX_MISRA_ENABLE */
 updated_stack_start = (((new_stack_start) + ((sizeof(ULONG)) - ((ULONG) 1)) ) & (~((sizeof(ULONG)) - ((ULONG) 1))));

 /* Determine if the starting stack address is different. */
 if (new_stack_start != updated_stack_start)
 {

 /* Yes, subtract another ULONG from the size to avoid going past the stack area. */
 stack_size = stack_size - (sizeof(ULONG));
 }

 /* Update the starting stack pointer. */
#ifdef TX_MISRA_ENABLE
 stack_start = TX_ULONG_TO_POINTER_CONVERT(updated_stack_start);
#else
 stack_start = TX_ALIGN_TYPE_TO_POINTER_CONVERT(updated_stack_start);
#endif /* TX_MISRA_ENABLE */
#endif

 /* Prepare the thread control block prior to placing it on the created
 list. */

 /* Initialize thread control block to all zeros. */
 TX_MEMSET(thread_ptr, 0, (sizeof(TX_THREAD)));

 /* Place the supplied parameters into the thread's control block. */
 thread_ptr -> tx_thread_name = name_ptr;
 thread_ptr -> tx_thread_entry = entry_function;
 thread_ptr -> tx_thread_entry_parameter = entry_input;
 thread_ptr -> tx_thread_stack_start = stack_start;
 thread_ptr -> tx_thread_stack_size = stack_size;
 thread_ptr -> tx_thread_priority = priority;
 thread_ptr -> tx_thread_user_priority = priority;
 thread_ptr -> tx_thread_time_slice = time_slice;
 thread_ptr -> tx_thread_new_time_slice = time_slice;
 thread_ptr -> tx_thread_inherit_priority = ((UINT) TX_MAX_PRIORITIES);

 /* Calculate the end of the thread's stack area. */
 temp_ptr = TX_VOID_TO_UCHAR_POINTER_CONVERT(stack_start);
 temp_ptr = (TX_UCHAR_POINTER_ADD(temp_ptr, (stack_size - ((ULONG) 1))));
 thread_ptr -> tx_thread_stack_end = TX_UCHAR_TO_VOID_POINTER_CONVERT(temp_ptr);

#ifndef TX_DISABLE_PREEMPTION_THRESHOLD

 /* Preemption-threshold is enabled, setup accordingly. */
 thread_ptr -> tx_thread_preempt_threshold = preempt_threshold;
 thread_ptr -> tx_thread_user_preempt_threshold = preempt_threshold;
#else

 /* Preemption-threshold is disabled, determine if preemption-threshold was required. */
 if (priority != preempt_threshold)
 {

 /* Preemption-threshold specified. Since specific preemption-threshold is not supported,
 disable all preemption. */
 thread_ptr -> tx_thread_preempt_threshold = ((UINT) 0);
 thread_ptr -> tx_thread_user_preempt_threshold = ((UINT) 0);
 }
 else
 {

 /* Preemption-threshold is not specified, just setup with the priority. */
 thread_ptr -> tx_thread_preempt_threshold = priority;
 thread_ptr -> tx_thread_user_preempt_threshold = priority;
 }
#endif

 /* Now fill in the values that are required for thread initialization. */
 thread_ptr -> tx_thread_state = TX_SUSPENDED;

 /* Setup the necessary fields in the thread timer block. */
 TX_THREAD_CREATE_TIMEOUT_SETUP(thread_ptr)

 /* Perform any additional thread setup activities for tool or user purpose. */
 TX_THREAD_CREATE_INTERNAL_EXTENSION(thread_ptr)

 /* Call the target specific stack frame building routine to build the
 thread's initial stack and to setup the actual stack pointer in the
 control block. */
 _tx_thread_stack_build(thread_ptr, _tx_thread_shell_entry);

#ifdef TX_ENABLE_STACK_CHECKING

 /* Setup the highest usage stack pointer. */
 thread_ptr -> tx_thread_stack_highest_ptr = thread_ptr -> tx_thread_stack_ptr;
#endif

 /* Prepare to make this thread a member of the created thread list. */
 TX_DISABLE

 /* Load the thread ID field in the thread control block. */
 thread_ptr -> tx_thread_id = TX_THREAD_ID;

 /* Place the thread on the list of created threads. First,
 check for an empty list. */
 if (_tx_thread_created_count == TX_EMPTY)
 {

 /* The created thread list is empty. Add thread to empty list. */
 _tx_thread_created_ptr = thread_ptr;
 thread_ptr -> tx_thread_created_next = thread_ptr;
 thread_ptr -> tx_thread_created_previous = thread_ptr;
 }
 else
 {

 /* This list is not NULL, add to the end of the list. */
 next_thread = _tx_thread_created_ptr;
 previous_thread = next_thread -> tx_thread_created_previous;

 /* Place the new thread in the list. */
 next_thread -> tx_thread_created_previous = thread_ptr;
 previous_thread -> tx_thread_created_next = thread_ptr; // <---------------

 /* Setup this thread's created links. */
 thread_ptr -> tx_thread_created_previous = previous_thread;
 thread_ptr -> tx_thread_created_next = next_thread;
 }

 /* Increment the thread created count. */
 _tx_thread_created_count++;

 /* If trace is enabled, register this object. */
 TX_TRACE_OBJECT_REGISTER(TX_TRACE_OBJECT_TYPE_THREAD, thread_ptr, name_ptr, TX_POINTER_TO_ULONG_CONVERT(stack_start), stack_size)

 /* If trace is enabled, insert this event into the trace buffer. */
 TX_TRACE_IN_LINE_INSERT(TX_TRACE_THREAD_CREATE, thread_ptr, priority, TX_POINTER_TO_ULONG_CONVERT(stack_start), stack_size, TX_TRACE_THREAD_EVENTS)

 /* Register thread in the thread array structure. */
 TX_EL_THREAD_REGISTER(thread_ptr)

 /* Log this kernel call. */
 TX_EL_THREAD_CREATE_INSERT

#ifndef TX_NOT_INTERRUPTABLE

 /* Temporarily disable preemption. */
 _tx_thread_preempt_disable++;
#endif

 /* Determine if an automatic start was requested. If so, call the resume
 thread function and then check for a preemption condition. */
 if (auto_start == TX_AUTO_START)
 {

 /* Determine if the create call is being called from initialization. */
 if (TX_THREAD_GET_SYSTEM_STATE() >= TX_INITIALIZE_IN_PROGRESS)
 {

 /* Yes, this create call was made from initialization. */

 /* Pickup the current thread execute pointer, which corresponds to the
 highest priority thread ready to execute. Interrupt lockout is
 not required, since interrupts are assumed to be disabled during
 initialization. */
 saved_thread_ptr = _tx_thread_execute_ptr;

 /* Determine if there is thread ready for execution. */
 if (saved_thread_ptr != TX_NULL)
 {

 /* Yes, a thread is ready for execution when initialization completes. */

 /* Save the current preemption-threshold. */
 saved_threshold = saved_thread_ptr -> tx_thread_preempt_threshold;

 /* For initialization, temporarily set the preemption-threshold to the
 priority level to make sure the highest-priority thread runs once
 initialization is complete. */
 saved_thread_ptr -> tx_thread_preempt_threshold = saved_thread_ptr -> tx_thread_priority;
 }
 }
 else
 {

 /* Simply set the saved thread pointer to NULL. */
 saved_thread_ptr = TX_NULL;
 }

#ifdef TX_NOT_INTERRUPTABLE

 /* Perform any additional activities for tool or user purpose. */
 TX_THREAD_CREATE_EXTENSION(thread_ptr)

 /* Resume the thread! */
 _tx_thread_system_ni_resume(thread_ptr);

 /* Restore previous interrupt posture. */
 TX_RESTORE
#else

 /* Restore previous interrupt posture. */
 TX_RESTORE

 /* Perform any additional activities for tool or user purpose. */
 TX_THREAD_CREATE_EXTENSION(thread_ptr)

 /* Call the resume thread function to make this thread ready. */
 _tx_thread_system_resume(thread_ptr);
#endif

 /* Determine if the thread's preemption-threshold needs to be restored. */
 if (saved_thread_ptr != TX_NULL)
 {

 /* Yes, restore the previous highest-priority thread's preemption-threshold. This
 can only happen if this routine is called from initialization. */
 saved_thread_ptr -> tx_thread_preempt_threshold = saved_threshold;
 }
 }
 else
 {

#ifdef TX_NOT_INTERRUPTABLE

 /* Perform any additional activities for tool or user purpose. */
 TX_THREAD_CREATE_EXTENSION(thread_ptr)

 /* Restore interrupts. */
 TX_RESTORE
#else

 /* Restore interrupts. */
 TX_RESTORE

 /* Perform any additional activities for tool or user purpose. */
 TX_THREAD_CREATE_EXTENSION(thread_ptr)

 /* Disable interrupts. */
 TX_DISABLE

 /* Re-enable preemption. */
 _tx_thread_preempt_disable--;

 /* Restore interrupts. */
 TX_RESTORE

 /* Check for preemption. */
 _tx_thread_system_preempt_check();
#endif
 }

 /* Always return a success. */
 return(TX_SUCCESS);
}

 

PierreBAuthor
Associate II
October 21, 2025

Here the full project, it's just a very basic project with threadX.

Nawres GHARBI
Technical Moderator
October 22, 2025

Hi @PierreB 

as a first view seems your heap and stack are too low in the script.ld file, please try with 0x1000 for both 

PierreBAuthor
Associate II
October 22, 2025

Hi,

Same problem with 0x1000. Moreover, the debugger works well (without the thread awareness) when I turn off the "serverRtos" parameter in the launch.json file

LaurentL
ST Employee
October 23, 2025

Hi,

And if you increase heap and stack size in linker script file to 10240, is it working ok ?

10240 => 0x2800 for both

 

 

 

To give better visibility on the answered topics, please click on Accept as Solution on the reply which solved your issue or answered your question.
PierreBAuthor
Associate II
October 23, 2025

Hi,

 

Same, I tried with 0x10000 for both too.

PierreBAuthor
Associate II
October 28, 2025

Everything runs as expected in CLion and STMCubeIDE, but when I use the exact same code in VSCode, I have the issue.

Can you reproduce the bug with the project I shared with you?

Is there any additional information I can provide to help move forward?

Nawres GHARBI
Technical Moderator
October 28, 2025

is it possible to share your project ? 

Nawres GHARBI
Technical Moderator
October 28, 2025

The thread creation with min stack size "#define MAIN_THREAD_STACK_SIZE (1024*10)" is causing overlap between .bss and ._user_heap_stack

to fix that you can define the creation of the main thread task as following: 

instead of:

  tx_thread_create(&p_thMain, "Main Thread", th_main, 0, thMain_stack,
                       MAIN_THREAD_STACK_SIZE, TX_APP_THREAD_PRIO,   TX_APP_THREAD_PREEMPTION_THRESHOLD,
                       TX_APP_THREAD_TIME_SLICE, TX_APP_THREAD_AUTO_START);
 
use: 
  CHAR *thMain_stack;
  if (tx_byte_allocate(byte_pool, (VOID **)&thMain_stack, MAIN_THREAD_STACK_SIZE, TX_NO_WAIT) != TX_SUCCESS) {
    // Handle allocation error
}
  tx_thread_create(&p_thMain, "Main Thread", th_main, 0, thMain_stack,
                       MAIN_THREAD_STACK_SIZE, TX_APP_THREAD_PRIO, TX_APP_THREAD_PREEMPTION_THRESHOLD,
                       TX_APP_THREAD_TIME_SLICE, TX_APP_THREAD_AUTO_START);
 
 This allocates the stack from the ThreadX byte pool, reducing static .bss usage and preventing overlap. 
please pay attention also to heap and stack size that I modified
 
NawresGHARBI_0-1761659175740.pngNawresGHARBI_1-1761659196859.png