RT-Thread Studio FAQ

1. Fail to receive phone verification number when sign-up?

Phone verification and Email verification is optional, but email verification is more recommended. Users failed to receive the phone verification number, please try with email verification.

2. How to add files to the project?

There are various ways to add a file or a set of files to the project, like:

• Copy the file and paste it at the RT-Thread Studio IDE.
• Copy the directory and paste it at the RT-Thread Studio IDE, add all the files in the directory at a time.
• Right-click and select the New wizard, create a new directory, a C file or a header.

If it is declared that some headers are missing, please add their directories into the search paths in the configuration of the project.

3. How to show the line numbers of source code?

Right-click on the left bar of the source edit window, select Show Line Numbers as below:

4. Find the entry to import project?

Right-click at the Project Explorer window, open the Import wizard and select the RT-Thread Studio Projects into Workspace item, as shown below:

Click Next, then the Browse ... button in the Import Projects window, the import wizard lists all the projects in the specified path. Select the one to import and click the Finish button, the selected project is imported, illustrated as below:

5. How to generate the HEX file?

Right-click on the left bar of the source edit window, select Show Line Numbers as below:

If both BIN and HEX files are needed, add the command to generate the HEX file to Post-build steps->Command, illustrated as below:

The generated HEX file is located in the Debug directory, shown as below:

6. Characters are lost via the serial port?

Make sure it’s not a program bug. It’s usually caused by broken wires or the baud-rate is set too high. Use another set of wires or lower the baud-rate.

7. Not able to remove a project?

Some files might be accessed by git when the user tries to remove a project, which causes a failure and RT-Thread Studio prompts that the file is used by other programs. Close the project or restart the IDE before remove it. The Restart and the Close Project options are located in the File menu and the right-click menu on the project item in the Project Explorer window.

8. Can users modify the files or configurations in the rt-thread and packages directories?

It’s not permitted. Files in the rt-thread and packages directories are managed and configured under RT-Thread Settings. When needed in the compilation, they should be turned on in RT-Thread Settings.

For instance, if users want the rt-thread/components/dfs to be compiled, as below:

Users should not modify the properties of the dfs directory. Instead, they should turn on the DFS in RT-Thread Settings and save the configuration, which causes the dfs directory to be added to the compilation process, illustrated as below:

9. What is the meaning of text, data, bss, dec and hex in the outputs of compilation?

The compilation outputs in Studio are shown below:

• text: code segment, used to store code and read-only constants.
• data: data segment, used to store initialized global variables and static variables.
• bss: bss segment, used to store uninitialized global variables, set to 0 when programs startup.
• dec: the abbreviation for decimal, which is the total size of text, data and bss. In our example, the sum of 51344, 372 and 2808 is 54524.
• hex: the abbreviation for hexadecimal. in our example, the number 54524 in decimal equals d4fc in hexadecimal.
• filename: the name of the target file, which is rtthread.elf.

About how to calculate the memory usage of the target file:

the used flash size = the size of text

the used RAM size = the size of data + the size of bss

10. The ST-LINK port is already used?

When the error dialog “TCP Port 61234 not available” pops up, modify the GDBServer Port Number of ST-LINK in The configuration of Project, as below:

11. Could not see the icons of components in RT-Thread settings?

There are no components in RT-Thread Nano, which is a lite version. Choose the standard version of RT-Thread when creating a new project.

12. Fail to update RT-Thread Studio?

If the statement “No Repository found” or the error in the picture below appears, probe the updates manually. Cancel the selection “Group items by category” and “Contact all update sites during install to find required software” in the update window, select “Eclipse Platform Launcher Executables” and then install the Studio updates. If it fails, close the window and try again.

13. How to enable the dark theme and set up the colors used by the editor?

In “DevStyle Theme” in Preference->DevStyle, select Use enhanced DevStyle Themes. To make the selected theme take effect, restart the IDE.

14. How to view and change the key bindings?

Click Show Active Keybindings ... in the Help menu, where users could view and change the key bindings.

15. How to restore the perspectives?

Click the item Window->Perspectives->Reset Perspectives ... to restore the perspectives to the default settings.

16. How to open the closed projects?

Right-click on the project item in Project Explorer, select Open Project on the menu.

17. Error on loading Python DLL when creating a project?

When creating a project, an error window pops up and the message “Error loading Python DLL xxx/xxxx/python36.dll” shows up in the console window.

Please re-install the Visual C++ Redistributable.