AzureRTOS(ThreadX) TX_ENABLE_IAR_LIBRARY_SUPPORT compile option

Question

AzureRTOS(ThreadX) TX_ENABLE_IAR_LIBRARY_SUPPORT compile option

GR_yoji 46

It seems that ThreadX of Azure RTOS has a compile option called "TX_ENABLE_IAR_LIBRARY_SUPPORT".
Let me ask you a few questions about that.

What is the effect of enabling this?
Also, are there any conditions or restrictions when using it?
For example, the CPU that can be used and the target environment are limited.
Do I need to enable it when developing in an IAR environment?
Also, is there any inconvenience when not enabled?

AshokPeddakotla-MSFT 35,971 Reputation points Moderator

2021-07-27T15:29:50.25+00:00

@GR_yoji Community Members, SME's on this topic or our team will review your scenario and circle back at the possible earliest time.
Meanwhile, please look into this post from Renesas : https://en-support.renesas.com/knowledgeBase/16977607 and see if it helps.

TX_ENABLE_IAR_LIBRARY_SUPPORT is defined when the IAR compiler and libraries are used, it is specific to the port and valid only in that context. When IAR is used it is defined, otherwise not.
GR_yoji 46 Reputation points

2021-07-27T23:35:58.697+00:00

AshokPeddakotla-MSFT, Thank you for your quick response.

I checked the information on the web page you introduced, but there was no detailed explanation
about the function when "TX_ENABLE_IAR_LIBRARY_SUPPORT" was defined,
so I hope you will get a more detailed answer.

Accepted answer

0 additional answers

Your answer

AshokPeddakotla-MSFT 35,971 Reputation points Moderator

2021-07-27T15:29:50.25+00:00

@GR_yoji Community Members, SME's on this topic or our team will review your scenario and circle back at the possible earliest time.
Meanwhile, please look into this post from Renesas : https://en-support.renesas.com/knowledgeBase/16977607 and see if it helps.

TX_ENABLE_IAR_LIBRARY_SUPPORT is defined when the IAR compiler and libraries are used, it is specific to the port and valid only in that context. When IAR is used it is defined, otherwise not.
GR_yoji 46 Reputation points

2021-07-27T23:35:58.697+00:00

AshokPeddakotla-MSFT, Thank you for your quick response.

I checked the information on the web page you introduced, but there was no detailed explanation
about the function when "TX_ENABLE_IAR_LIBRARY_SUPPORT" was defined,
so I hope you will get a more detailed answer.

Answer 1

The IAR C run-time library offers thread local storage and reentrancy support. In order to use those capabilities with ThreadX this symbol needs to be defined during compilation. For more information about the IAR C run-time library please refer to their documentation.

This capability is port specific and hence documented on the port readme file (for Cortex M7, that file is here https://github.com/azure-rtos/threadx/blob/master/ports/cortex_m7/iar/readme_threadx.txt)

Here is the relevant chapter from that readme file:

IAR Thread-safe Library Support

Thread-safe support for the IAR tools is easily enabled by building the ThreadX library
and the application with TX_ENABLE_IAR_LIBRARY_SUPPORT. Also, the linker control file
should have the following line added (if not already in place):

initialize by copy with packing = none { section __DLIB_PERTHREAD }; // Required in a multi-threaded application

The project options "General Options -> Library Configuration" should also have the
"Enable thread support in library" box selected.

GR_yoji 46 Reputation points

2021-08-03T23:10:26.123+00:00

Andres Mlinar,
Thank you for your answer.
The information you provided was very useful and helpful to us.

In addition, although it is the "readme_threadx.txt" file on GitHUB that you notified,
it was not included in the zip file of the sample project
(for example, Azure_RTOS_6.1_Renesas_RZA1_RSK_IAR_Samples_2021_04_28.zip),
so I did not know its existence.
If possible, I would appreciate it if you could include such readme.txt in those sample projects as well.

Share via

AzureRTOS(ThreadX) TX_ENABLE_IAR_LIBRARY_SUPPORT compile option

0 additional answers

Your answer