diff --git a/development-tools/rtthread-studio/um/studio-user-begin.md b/development-tools/rtthread-studio/um/studio-user-begin.md index 74f01c54a45edb06f1e8f2cc0eb76720c5017b04..cc75b22635b3588d3ea95c7171f7f9dcdf676c7c 100644 --- a/development-tools/rtthread-studio/um/studio-user-begin.md +++ b/development-tools/rtthread-studio/um/studio-user-begin.md @@ -1,12 +1,10 @@ -## 快速开始 +## 安装 RT-Thread Studio -### 安装 RT-Thread Studio - -#### 下载 RT-Thread Studio 安装包 +### 下载 RT-Thread Studio 安装包 访问官网 [RT-Thread Studio 下载地址](https://www.rt-thread.org/page/studio.html)，在官网下载最新的 RT-Thread Studio 软件安装包。 -#### 安装 RT-Thread Studio +### 安装 RT-Thread Studio 双击安装包的 `.exe` 文件进行安装，安装界面如下图所示： @@ -40,7 +38,7 @@ ![sign-in](figures/sign-in.png) -### 新建项目 +## 新建项目 在`项目资源管理器`窗口内点击右键，选择`新建`子菜单`项目`，如下图所示： @@ -62,7 +60,7 @@ ![test-pro](figures/test-pro.png) -### 配置项目 +## 配置项目 双击`RT-Thread Settings`文件，打开 RT-Thread 项目配置界面，配置界面默认显示软件包以及组件和服务层的架构配置图界面，如下图所示： @@ -76,7 +74,7 @@ ![set-ok](figures/set-ok.png) -### 构建项目 +## 构建项目 点击工具栏上的`构建`按钮对项目进行构建。如下图所示： @@ -86,7 +84,7 @@ ![build-info](figures/build-info.png) -### 下载程序 +## 下载程序 当项目构建成功后，点击工具栏`下载程序`按钮旁的三角下拉框选择相应的烧写器，以`J-Link`烧写器为例，如下图所示： @@ -96,7 +94,7 @@ ![download-info](figures/download-info.png) -### 启动调试 +## 启动调试 选中`test`工程,然后点击工具栏`调试`按钮，如下图所示： @@ -106,6 +104,6 @@ ![debug-see](figures/debug-see.png) -### 视频教程 +## 视频教程 访问官网 [RT-Thread Studio 视频教程](https://www.rt-thread.org/page/video.html)，在官网观看视频教程。 \ No newline at end of file diff --git a/index.html b/index.html index 6c7b8c8f91b1d8aa8b440ba76b8fa9919d327e22..731bf5810fd11d6ee7aa0731aae47fb21e504bce 100644 --- a/index.html +++ b/index.html @@ -82,7 +82,7 @@ editHtml + html + '\n\n----\n' + - '>Powered by [RT-Thread](https://www.rt-thread.org/)' + '>我有疑问： [RT-Thread 官方论坛](https://club.rt-thread.org/)' }) } ] diff --git a/rt-thread-version/rt-thread-nano/_sidebar.md b/rt-thread-version/rt-thread-nano/_sidebar.md index a8a1ec56aa6e1321e32a0085f00e863fabcf7062..a5d10d4097e4cf4c54655bcf8bab74c0f29829c7 100644 --- a/rt-thread-version/rt-thread-nano/_sidebar.md +++ b/rt-thread-version/rt-thread-nano/_sidebar.md @@ -1,12 +1,12 @@ - RT-Thread Nano版本 - - [Nano 简介](/rt-thread-version/rt-thread-nano/an0038-nano-introduction.md) + - [Nano 简介与下载](/rt-thread-version/rt-thread-nano/an0038-nano-introduction.md) + - [Nano 移植原理](/rt-thread-version/rt-thread-nano/nano-port-principle/an0044-nano-port-principle.md) - [使用 RT-Thread Studio 移植](/rt-thread-version/rt-thread-nano/nano-port-studio/an0047-nano-port-studio.md) - [使用 MDK 移植](/rt-thread-version/rt-thread-nano/nano-port-keil/an0039-nano-port-keil.md) - [使用 IAR 移植](/rt-thread-version/rt-thread-nano/nano-port-iar/an0040-nano-port-iar.md) - [使用 CubeMX 移植](/rt-thread-version/rt-thread-nano/nano-port-cube/an0041-nano-port-cube.md) - [移植 Nano 到 RISC-V](/rt-thread-version/rt-thread-nano/nano-port-gcc-riscv/an0042-nano-port-gcc-riscv.md) - [Nano 配置](/rt-thread-version/rt-thread-nano/nano-config/an0043-nano-config.md) - - [Nano 移植原理](/rt-thread-version/rt-thread-nano/nano-port-principle/an0044-nano-port-principle.md) - [移植控制台/FinSH](/rt-thread-version/rt-thread-nano/finsh-port/an0045-finsh-port.md) diff --git a/rt-thread-version/rt-thread-smart/_sidebar.md b/rt-thread-version/rt-thread-smart/_sidebar.md index f9c2ca61896b536c04f174a4c7728bb4f0f23ff3..64bb27cb48d3698572fedd3349c7975a703332ad 100644 --- a/rt-thread-version/rt-thread-smart/_sidebar.md +++ b/rt-thread-version/rt-thread-smart/_sidebar.md @@ -4,3 +4,4 @@ - [入门指南](/rt-thread-version/rt-thread-smart/rt-smart-quickstart/rt-smart-quickstart.md) - [架构说明](/rt-thread-version/rt-thread-smart/architecture/architecture.md) + - [进程概述](/rt-thread-version/rt-thread-smart/rt-smart-lwp/rt-smart-lwp.md) diff --git a/rt-thread-version/rt-thread-smart/rt-smart-lwp/figures/.DS_Store b/rt-thread-version/rt-thread-smart/rt-smart-lwp/figures/.DS_Store new file mode 100644 index 0000000000000000000000000000000000000000..5008ddfcf53c02e82d7eee2e57c38e5672ef89f6 Binary files /dev/null and b/rt-thread-version/rt-thread-smart/rt-smart-lwp/figures/.DS_Store differ diff --git a/rt-thread-version/rt-thread-smart/rt-smart-lwp/figures/lwp_intro-Kernel_Address_Space.jpg b/rt-thread-version/rt-thread-smart/rt-smart-lwp/figures/lwp_intro-Kernel_Address_Space.jpg new file mode 100644 index 0000000000000000000000000000000000000000..130ee9259f8e2a648d93b2f979c83dc1342ff65f Binary files /dev/null and b/rt-thread-version/rt-thread-smart/rt-smart-lwp/figures/lwp_intro-Kernel_Address_Space.jpg differ diff --git a/rt-thread-version/rt-thread-smart/rt-smart-lwp/figures/lwp_intro-Memory_Map.jpg b/rt-thread-version/rt-thread-smart/rt-smart-lwp/figures/lwp_intro-Memory_Map.jpg new file mode 100644 index 0000000000000000000000000000000000000000..9b34d52f1ed435c7a6789eac63436a12a314ccfa Binary files /dev/null and b/rt-thread-version/rt-thread-smart/rt-smart-lwp/figures/lwp_intro-Memory_Map.jpg differ diff --git a/rt-thread-version/rt-thread-smart/rt-smart-lwp/figures/lwp_intro-PageBuddy.jpg b/rt-thread-version/rt-thread-smart/rt-smart-lwp/figures/lwp_intro-PageBuddy.jpg new file mode 100644 index 0000000000000000000000000000000000000000..e747fd17dcaeb61df8dff3f3222dab9486c30bb2 Binary files /dev/null and b/rt-thread-version/rt-thread-smart/rt-smart-lwp/figures/lwp_intro-PageBuddy.jpg differ diff --git a/rt-thread-version/rt-thread-smart/rt-smart-lwp/figures/lwp_intro-Process_Organization.jpg b/rt-thread-version/rt-thread-smart/rt-smart-lwp/figures/lwp_intro-Process_Organization.jpg new file mode 100644 index 0000000000000000000000000000000000000000..519faeb812687a3b20014a92d53edb42c851041a Binary files /dev/null and b/rt-thread-version/rt-thread-smart/rt-smart-lwp/figures/lwp_intro-Process_Organization.jpg differ diff --git a/rt-thread-version/rt-thread-smart/rt-smart-lwp/figures/lwp_intro-Process_Resources.jpg b/rt-thread-version/rt-thread-smart/rt-smart-lwp/figures/lwp_intro-Process_Resources.jpg new file mode 100644 index 0000000000000000000000000000000000000000..f777f443038cb110c4eb50be54d0444a0aed9c11 Binary files /dev/null and b/rt-thread-version/rt-thread-smart/rt-smart-lwp/figures/lwp_intro-Process_Resources.jpg differ diff --git a/rt-thread-version/rt-thread-smart/rt-smart-lwp/figures/lwp_intro-RT_Object.jpg b/rt-thread-version/rt-thread-smart/rt-smart-lwp/figures/lwp_intro-RT_Object.jpg new file mode 100644 index 0000000000000000000000000000000000000000..641c1bec561f84bb37665c31f4309158b3784bee Binary files /dev/null and b/rt-thread-version/rt-thread-smart/rt-smart-lwp/figures/lwp_intro-RT_Object.jpg differ diff --git a/rt-thread-version/rt-thread-smart/rt-smart-lwp/figures/lwp_intro-Threads-FDT.jpg b/rt-thread-version/rt-thread-smart/rt-smart-lwp/figures/lwp_intro-Threads-FDT.jpg new file mode 100644 index 0000000000000000000000000000000000000000..3ea3f920fce3ca59edde04bb6302aa1525307934 Binary files /dev/null and b/rt-thread-version/rt-thread-smart/rt-smart-lwp/figures/lwp_intro-Threads-FDT.jpg differ diff --git a/rt-thread-version/rt-thread-smart/rt-smart-lwp/figures/lwp_intro-Threads.jpg b/rt-thread-version/rt-thread-smart/rt-smart-lwp/figures/lwp_intro-Threads.jpg new file mode 100644 index 0000000000000000000000000000000000000000..cbddf91d9aa51ea74389dd05e7d37ed49e482f19 Binary files /dev/null and b/rt-thread-version/rt-thread-smart/rt-smart-lwp/figures/lwp_intro-Threads.jpg differ diff --git a/rt-thread-version/rt-thread-smart/rt-smart-lwp/figures/lwp_intro-Total_Address_Space.jpg b/rt-thread-version/rt-thread-smart/rt-smart-lwp/figures/lwp_intro-Total_Address_Space.jpg new file mode 100644 index 0000000000000000000000000000000000000000..b7b51148431599097bae7f8f047b7a266dea99d3 Binary files /dev/null and b/rt-thread-version/rt-thread-smart/rt-smart-lwp/figures/lwp_intro-Total_Address_Space.jpg differ diff --git a/rt-thread-version/rt-thread-smart/rt-smart-lwp/figures/lwp_intro.drawio b/rt-thread-version/rt-thread-smart/rt-smart-lwp/figures/lwp_intro.drawio new file mode 100644 index 0000000000000000000000000000000000000000..0308e799fd7f03e5f0a4970c244f530743f335cf --- /dev/null +++ b/rt-thread-version/rt-thread-smart/rt-smart-lwp/figures/lwp_intro.drawio @@ -0,0 +1 @@ +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 \ No newline at end of file diff --git a/rt-thread-version/rt-thread-smart/rt-smart-lwp/rt-smart-lwp.md b/rt-thread-version/rt-thread-smart/rt-smart-lwp/rt-smart-lwp.md new file mode 100644 index 0000000000000000000000000000000000000000..3002d2b14de3403d630d3f33188cc1b87ac458e7 --- /dev/null +++ b/rt-thread-version/rt-thread-smart/rt-smart-lwp/rt-smart-lwp.md @@ -0,0 +1,185 @@ +# RT-Thread Smart 进程概述 + +## 综述 + +在操作系统概念中，进程是资源分配的实体，而线程是执行的实体。同一个进程的所有线程共享相同的资源，而每个进程至少需要拥有一个线程，线程在进程的地址空间运行，完成内核或用户规定的任务。 + +RT-Thread Smart 的线程可以分为两类： + +- 内核线程：运行于内核地址空间，没有对应的用户态进程，因此不能访问用户地址空间。它们用来完成特定于内核的任务，或者兼容所有原 RT-Thread 的应用代码。 +- 用户线程：所有的用户线程都属于某一个用户进程，它们共享进程拥有的资源，比如进程的用户态和内核态地址空间。不同进程间的线程不能直接相互访问。 + +内核线程和用户线程如下图所示： + +![](figures/lwp_intro-Threads.jpg) + +所有的进程都只能在用户态创建，通过系统调用访问内核的资源，下文如无特别说明，所述进程都是指用户态进程。而内核线程只运行在内核地址空间，一般不会访问用户地址空间的数据。 + +## 进程管理 + +进程管理涉及到进程的创建、运行和退出过程，以及对系统资源的分配和使用。 + +除内存和地址空间外，进程需要使用的系统资源主要包括为： + +- 进程的内存和映射到的用户地址空间 +- 进程的打开文件描述符表 +- 进程运行过程中申请的内核对象 + +进程在创建和运行过程中申请并使用上述资源，在进程退出时系统回收这些资源以分配给其它进程使用。进程使用的资源情况如下图所示： + +![](figures/lwp_intro-Process_Resources.jpg) + +下面对进程生命周期中的资源使用情况进行介绍，内存和地址映射之后单独说明。 + +### 进程的创建 + +进程的创建过程是由 ELF 装载器来完成的，它主要完成两个步骤： + +1. 读取并分析 ELF 文件的代码段和数据段，根据它们的分布信息分配内存并建立相应的用户空间地址映射。 +2. 设置进程的三个标准文件描述符 0、1、 2 ，分别表示标准输入、标准输出和标准错误。其它描述符在打开文件时创建。 + +进程运行时，内核和用户资源分配如下图所示，其中每个进程的文件描述符表是相互独立的： + +![](figures/lwp_intro-Threads-FDT.jpg) + +每个文件描述符是一个整数，对应于一个打开的文件，以该值为索引，可在进程的文件描述符表中得到对应的结构体 `struct dfs_fd` 的指针。除了进程的三个标准文件描述符（标准输入、标准输出和标准错误），其它文件描述符在文件打开和关闭时动态创建和回收。在目前的版本中，对这三个文件描述符的访问都会重定向到系统的 console 设备。 + +### 进程资源管理 + +进程运行过程中会执行创建线程、访问设备、申请信号量等操作，这些操作的对象在内核中都对应一个内核数据，通过 `rt_object` 机制按照数据类型分别进行管理。同时，为了在进程退出时对这些资源进行释放，这些内核数据又按照所属的进程串联起来。 + +系统运行时，内核对象的管理如下图所示： + +![](figures/lwp_intro-RT_Object.jpg) + +每种类型的内核对象通过成员变量 `rt_object` 串联在一起，链表头为类型的成员变量 `object_list` ；同时，每个进程所使用的内核对象通过成员变量 `lwp_obj_list` 串联在一起，链表头为进程的成员变量 `object_list` 。 + +### 进程的退出 + +进程的退出是指进程内的所有线程全部结束运行之后，对进程所占用资源的释放过程，按顺序依次为： + +- 释放进程中所有尚未释放的内核对象资源。 +- 关闭进程所有尚未关闭的文件，之后释放文件描述符表本身。 +- 遍历 `map_area` 树的节点信息，对于进程用户态所有映射中使用的自动映射类型的物理内存进行释放（归还到页管理器）。 +- 如果退出的进程在前台运行，则将其父进程设置前台进程；如果父进程不存在，则将前台控制权交给内核 msh 线程。（参见后续的控制台输入问题) +- 回收 MMU 管理相关的数据结构，以及进程管理结构体，更新进程树结构。如果父进程调用了 `waitpid()` 接口，会在父进程取走状态信息后由父进程释放。 + +### 进程组织结构 + +当进程启动了另外一个进程，后者就成为其子进程，而父进程可通过 `waitpid()` 接口等待子进程结束，获取其退出状态。在 RT-Thread Smart 中，父子进程的组织如下图所示： + +![](figures/lwp_intro-Process_Organization.jpg) + +其中： + +- 父进程的成员变量 `first_child` 指向其第一个子进程 +- 子进程的成员变量 `sibling` 指向兄弟进程 +- 子进程的成员变量 `parent` 指向自己的父进程 + +## 内存管理 + +作为系统中最常用的资源，内存的使用效率直接关系到系统性能的高低。内核对内存的管理主要分为物理内存的分配和虚拟地址空间的分配。 + +### 物理内存分配 + +除了原来宏内核提供的小内存块分配算法外，为支持 LWP 所需要的物理页面映射，物理内存分配器添加了对整页面申请和释放的支持。该分配器采用伙伴分配算法，将系统中所有可用的物理内存页面按照每 1 个页面、2 个页面、4 个页面等等划分为不同的单元，每相邻的两个单元互为 “伙伴”。 + +当释放一个单元时，如果它的伙伴处于空闲状态，那么它们就可以合并成一个更大的单元。相反地，当分配一个单元时，如果物理内存分配器中没有刚好满足大小的空闲单元，那么逐级向上查找更大的空闲单元，找到后对半分割，一半留在伙伴分配器中标记为空闲状态，另一半再次分割，直到分割到满足需求的单元大小。 + +伙伴分配算法管理页面的方式如下图所示： + +![](figures/lwp_intro-PageBuddy.jpg) + +### 内核地址空间映射 + +整个系统的地址空间划分为两大部分：内核空间和用户空间。在 RT-Thread Smart 中，系统地址空间布局如下： + +- 用户态地址为 0x0000_0000 - 0xBFFF_FFFF +- 内核态地址从 0xC000_0000 - 0xFFFF_FFFF + +系统中所有进程共享相同的内核空间，通过系统调用进行访问；而每个进程拥有自己独立的用户地址空间，相互之间隔离，即相同的虚拟地址在不同的进程中对应于不同的物理页面。而另一方面，属于同一个进程的不同线程共享相同的地址空间。系统地址空间划分如下图所示： + +![](figures/lwp_intro-Total_Address_Space.jpg) + +其中，内核地址空间空间映射内核的代码和数据，它们被内核线程直接访问，或者用户线程通过系统调用访问。内核地址空间分布如下图所示： + +![](figures/lwp_intro-Kernel_Address_Space.jpg) + +除动态映射区，内核地址空间的映射一经建立便不再改变，且对所有的进程保持一致，即在所有进程的地址空间中，相同的内核线性地址映射到相同的物理地址。 + +内核空间的可动态映射区域管理的地址范围为 0xF000_0000 - 0xFFFF_FFFF, 主要用来映射设备 IO 寄存器和用户线程的 TLS 数据。此外，由于这些地址可由用户态进程直接访问，它还被用来映射可由用户态访问的平台相关系统信息和特定于进程的数据。 + +内核态的可映射区域一旦映射不会自动解除，对这部分的映射和解映射过程由内核代码完成，用户进程可通过系统调用完成相关操作。 + +### 进程地址空间管理和共享内存 + +每个进程拥有自己独立的地址空间，同时它们共享相同的内核地址空间。为了实现该特性，每个进程维护一张自己的地址映射表，它们映射到内核地址空间的部分相同，而映射到用户地址空间的部分特定于进程，各不相同。 + +每个进程通过结构体 `rt_mem_info` 管理自己的地址空间。在进程创建时，ELF 加载器读取可执行文件的地址分布，建立线性地址区域 0x0010_0000 - 0xBFFF_FFFF 之间的映射，而内核地址空间的部分则从全局内存映射表的内核态部分复制，以保证所有进程的内核态部分映射都是相同的。系统调度器在切换线程时，会根据所属目标进程的内存映射表切换 MMU 配置数据，以符合当前线程的地址空间设置。如果线程不属于任何进程，说明目标是一个内核态线程，此时使用全局的 MMU 设置。 + +地址空间的隔离使得 ELF 的链接和加载更加简单，无需考虑其它进程的影响，进程本身运行也更加安全可靠。但是它也带来了另一个问题，进程间不能像线程那样随意共享数据，因为相同的虚拟地址会被映射到不同的物理地址。为了实现进程之间以及进程和内核间的大量数据共享，RT-Thread Smart 引入了共享页面机制，即将同一个页面可以映射到不同进程的地址空间。在支持共享页面的系统中，页面映射如下图所示： + +![](figures/lwp_intro-Memory_Map.jpg) + +上图中三个进程共享相同的内核地址空间映射，但是拥有各自不同的用户地址空间映射。同时，进程 2 和进程 3 还映射到了相同的物理页面，可通过该页面进行数据交换。 + +注意，出于安全性的考虑，内核地址空间不允许用户进程直接访问，因此不能通过内核地址空间来实现进程间的数据共享。另外，与内核地址空间映射不同，同一个共享页面在不同进程地址空间的映射地址可能也不同，不同进程需要先将共享页面 “附着” 到自己的地址空间，然后通过得到的地址进行访问。 + +## 附注 + +### console 设备说明 + +如果同时多个任务都在等待 console 输入，为了防止多个任务同时从 console 读取数据，系统引入前后台的概念，只有前台进程才能对 console 进行访问。另一方面，作为逻辑设备，console 需要有一个关联的物理设备来实际完成输入输出，进程和 console 的交互过程有如下特性： + +- 前台进程可以从与 console 关联的硬件设备中获取输入数据。当前台进程执行阻塞式读操作且设备中尚无数据时，进程阻塞等待，直到新数据到达。 +- 后台进程的读访问 console 时, 非阻塞式读操作会立即返回，提示无数据输入；而阻塞式读操作阻塞等待，直到被其它条件终止或者转换为前台进程。 +- 进程具有前后台的自动和主动切换功能。 +- 无论前后台进程，对输出都无须做特殊处理，直接输出到关联的物理设备。 + +前后台进程的划分存在如下规则： + +- 前台进程启动的新进程默认是前台进程。 +- 前台进程在可以通过 `msh_exec()` 接口启动新进程，如果启动新进程的命令以字符 "&" 结尾，新的进程以后台进程状态运行。 +- 无论是否使用字符 "&" 启动新进程，后台进程启动的进程都是后台进程。 +- 当前台进程结束时，会自动把父进程设置为前台进程；若父进程不存在，设置为内核的 msh 线程。 + +在某些情况下，比如在 msh 中启动了一个新进程而没有使用 "&" ，而新进程又不接受命令输入；或是一个前台进程结束后，转到前台的父进程不接受命令输入。这种情况下会造成 console 失去响应，此时可以按 `ctrl-d` 来强制把输入切回内核 msh 线程。 + +### RT-Thread 用户态版本 API 和原系统 API 的差异 + +宏内核版本的 RT-Thread API 有些与内核功能直接相关，有些为用户提供应用接口。对于前者，RT-Thread Smart 在内核中保留了同样的接口实现，而在用户态并没有对应的接口；而在用户态中，函数声明与后者保持一致，以保持向下兼容性，但某些参数的意义会略有差异。 + +下面举例说明这些参数意义略有差异的函数： + +* `rt_thread_create()` + +```c +rt_thread_t rt_thread_create(const char *name, + void (*entry)(void *parameter), + void *parameter, + rt_uint32_t stack_size, + rt_uint8_t priority, + rt_uint32_t tick); +``` + +对于 `rt_thread_create()` 函数，在内核版本中参数 `stack_size` 是指线程内核栈大小；而在 RT-Thead Smart 的对应用户态接口中，此参数为线程用户态栈大小，线程的内核态部分由系统指定，用户接口无法设置。 + +* `rt_mb_init()` 和 `rt_mq_init()` + +```c +rt_err_t rt_mb_init(rt_mailbox_t mb, + const char *name, + void *msgpool, + rt_size_t size, + rt_uint8_t flag); + +rt_err_t rt_mq_init(rt_mq_t mq, + const char *name, + void *msgpool, + rt_size_t msg_size, + rt_size_t pool_size, + rt_uint8_t flag); +``` + +以上两个函数，在内核版本中是把参数 `msgpool` 指向的内存来作为消息存储区使用的；但在用户态版本中，由于内核中直接使用用户态地址会引发各种问题，所以用户态版本的参数 `msgpool` 会被忽略，而由系统使用创建 `mb` 和 `mq` 的方式申请存储区，这意味着用户态代码不能通过直接访问 `msgpool` 而得到消息数据，这一点是要特别注意的。 + diff --git a/rt-thread-version/rt-thread-standard/_sidebar.md b/rt-thread-version/rt-thread-standard/_sidebar.md index 6294927cc0ba3538242af973dee08f32fe0f7281..b17e49435657ef4d36e53e0d7238eb653f950dee 100644 --- a/rt-thread-version/rt-thread-standard/_sidebar.md +++ b/rt-thread-version/rt-thread-standard/_sidebar.md @@ -1,8 +1,9 @@ - - - **RT-Thread 标准版本** + +- 简介 + - [RT-Thread 简介](README.md) - 快速上手 - [Keil模拟器STM32F103](/rt-thread-version/rt-thread-standard/tutorial/quick-start/stm32f103-simulator/stm32f103-simulator.md) - [RT-Thread潘多拉STM32L475](/rt-thread-version/rt-thread-standard/tutorial/quick-start/iot_board/quick-start.md) @@ -69,12 +70,13 @@ - [MicroPython 固件开发指南](/rt-thread-version/rt-thread-standard/packages-manual/micropython-docs/firmware-develop.md) - [MicroPython C 模块扩展](/rt-thread-version/rt-thread-standard/packages-manual/micropython-docs/external_c_modules.md) - [更多软件包...](/rt-thread-version/rt-thread-standard/packages-manual/more.md) -- 开发环境搭建 - - [在windows平台使用QEMU运行RT-Thread](/rt-thread-version/rt-thread-standard/application-note/setup/qemu/windows/an0006-qemu-windows.md) - - [在Ubuntu平台开发RT-Thread](/rt-thread-version/rt-thread-standard/application-note/setup/qemu/ubuntu/an0005-qemu-ubuntu.md) - - [使用Eclipse开发RT-Thread](/rt-thread-version/rt-thread-standard/application-note/setup/qemu/eclipse/an0020-qemu-eclipse.md) - - [使用VS Code开发RT-Thread](/rt-thread-version/rt-thread-standard/application-note/setup/qemu/vscode/an0021-qemu-vscode.md) - - [使用Env创建RT-Thread项目工程](/rt-thread-version/rt-thread-standard/application-note/setup/standard-project/an0017-standard-project.md) +- 应用开发 + - 开发环境搭建 + - [在windows平台使用QEMU运行RT-Thread](/rt-thread-version/rt-thread-standard/application-note/setup/qemu/windows/an0006-qemu-windows.md) + - [在Ubuntu平台开发RT-Thread](/rt-thread-version/rt-thread-standard/application-note/setup/qemu/ubuntu/an0005-qemu-ubuntu.md) + - [使用Eclipse开发RT-Thread](/rt-thread-version/rt-thread-standard/application-note/setup/qemu/eclipse/an0020-qemu-eclipse.md) + - [使用VS Code开发RT-Thread](/rt-thread-version/rt-thread-standard/application-note/setup/qemu/vscode/an0021-qemu-vscode.md) + - [使用Env创建RT-Thread项目工程](/rt-thread-version/rt-thread-standard/application-note/setup/standard-project/an0017-standard-project.md) - [固件尺寸优化](/rt-thread-version/rt-thread-standard/application-note/system/optimization/Optimize-code-size/an0049-optimize-code-size.md) - [在RT-Thread潘多拉开发板上实现电源管理](/rt-thread-version/rt-thread-standard/application-note/system/pm/an0025-pm.md) - [网络协议栈驱动移植](/rt-thread-version/rt-thread-standard/application-note/components/network/an0010-lwip-driver-porting.md) @@ -124,13 +126,13 @@ - [音乐数据的编码与解码](/rt-thread-version/rt-thread-standard/tutorial/beep-player/decode.md) - [播放器实现](/rt-thread-version/rt-thread-standard/tutorial/beep-player/player.md) - [按键控制](/rt-thread-version/rt-thread-standard/tutorial/beep-player/key.md) - - 分布式温度监控系统: + - 分布式温度监控系统 - [简介](/rt-thread-version/rt-thread-standard/tutorial/temperature-system/README.md) - [Sensor框架对接实战](/rt-thread-version/rt-thread-standard/tutorial/temperature-system/sensor.md) - [邮箱与消息队列实战](/rt-thread-version/rt-thread-standard/tutorial/temperature-system/ipc.md) - [文件系统实战](/rt-thread-version/rt-thread-standard/tutorial/temperature-system/dfs.md) - [OneNet连云实战](/rt-thread-version/rt-thread-standard/tutorial/temperature-system/onenet.md) - - 智能车: + - 智能车 - [简介](/rt-thread-version/rt-thread-standard/tutorial/smart-car/README.md) - [RT-Thread卷积神经网络手写体识别](/rt-thread-version/rt-thread-standard/tutorial/smart-car/cnn-mnist/cnn-mnist.md) - [Darknet训练目标检测模型](/rt-thread-version/rt-thread-standard/tutorial/smart-car/darknet-yolov2/darknet-yolov2.md) @@ -139,9 +141,8 @@ - [RT-Thread连接RPLidar激光雷达](/rt-thread-version/rt-thread-standard/tutorial/smart-car/rplidar-connect/rplidar-connect.md) - [RT-Thread搭配ROS实现目标检测小车](/rt-thread-version/rt-thread-standard/tutorial/smart-car/object-detection/object-detection.md) - 代码贡献 - - [驱动开发](/rt-thread-version/rt-thread-standard/development-guide/package/package.md) - [传感器驱动开发指南](/rt-thread-version/rt-thread-standard/development-guide/sensor/sensor_driver_development.md) - - [软件包开发](/rt-thread-version/rt-thread-standard/development-guide/package/package.md) + - [软件包开发指南](/rt-thread-version/rt-thread-standard/development-guide/package/package.md) - [向RT-Thread贡献代码](/rt-thread-version/rt-thread-standard/development-guide/github/github.md) - [RT-Thread 标准版的版本选择](/rt-thread-version/rt-thread-standard/application-note/setup/rt-thread-version/an0030-rtthread-version.md) - [API参考手册](https://www.rt-thread.org/document/api/)