RT-Thread is an Internet of Things(IoT) operating system that applies Apache License v2, and it is been over a decade since the first release of RT-Thread in 2006. RT-Thread is developed collaboratively on Github during the whole development process and released many versions since 2006.
This document will make an explicit explanation of how to choose the right RT-Thread version.
RT-Thread’s version/branch has the following available options:
Development branch (master branch), long-term support branch (lts-v3.1.x branch), release version (release), you are more recommended to use the released version.
The RT-Thread existed branches:
When there are large version changes, such as 3.0.x updates to 3.1.x, or master version changes, a new branch will be created on the master branch to maintain the old version.
Version-Release: RT-Thread has released a number of versions, such as 3.1.1, 3.1.2, 4.0.0, etc. The new version is released on the basis of the master branch or on the branch that is under-maintained.
For example, the latest release of the long-term support branch lts-v3.1.x is 3.1.2, and there will be 3.1.3, 3.1.4 、… and so on, but the 3.2.x version will not be released on that branch.
A second example, the version of the current master branch is 4.0.1, the latest release is 4.0.0, and there will be 4.0.1, 4.0.2 、… and so on. When there are large version changes, such as when 4.1.0 is released, a 4.0.x branch will be created to maintain 4.0.x.
RT-Thread all releases are stored on Github. The releases are highly stable and the latest releases are more recommended. There are two latest releases: version 3.1.2 and version 4.0.0, both of which can be selected for your needs.
The development branch is a branch of code that the RT-Thread team committed during development, it is stored on the Github master branch. The branch will iterate and update continually and frequently.
The long-term support branch is stored on Github, the long-term support branch is the maintenance branch of the 3.1.x version, primarily to fix bugs and update BSPs. Since more features have been added from 4.0.0, such as SMP, lwp, and more. There is a big change for 3.1.x, so 3.1.x will be maintained over the long term.