BLE_TYQ_BJQ_CH32V303/packages/rt_kprintf_threadsafe/readme.md

49 lines
2.0 KiB
Markdown
Raw Permalink Normal View History

2024-12-01 13:49:43 +08:00
# 线程安全版本的`rt_kprintf()`
原版RT-Thread `kserver.c `文件中的`rt_kprintf()`函数是线程不安全的这是因为按照ISO C标准`printf`本身就是线程不安全的。此外,`rt_kprintf` 希望减少过多的依赖,做到简单,以保证在任何环境下都可以正常使用。
因此,如果同时有两个线程同时使用`rt_kprintf()`打印数据可能会导致数据被冲刷掉或者一方的信息根本没有打印出来等一系列奇奇怪怪的问题。比如https://club.rt-thread.org/ask/question/429525.html
关于newlib下使用自带printf函数的问题可以参考这边帖子的评论区https://club.rt-thread.org/ask/article/2b0a1d202135b205.html
本安全版本`rt_kprintf()`函数会自动判断当前所处环境:
1. 若RT-Thread尚未启动调度器则采用没有任何保护的方式
2. 若在中断中调用`rt_kprintf()`,则采用没有任何保护的方式;
3. 若在线程中调用`rt_kprintf()`,方可采用线程安全保护措施。
1) 若RT-Thread启用互斥量则使用互斥量保护
2) 若RT-Thread没有启用互斥量则退而求其次使用信号量保护
3) 若RT-Thread连信号量(或互斥量)都没有启用,则采用关调度器的方式进行保护。
总之,线程安全版本`rt_kprintf()`函数会和原版函数一样可以在任何环境下调用,不会受到影响,使用时和原版`rt_kprintf`无任何区别,用户无感。
## 适用版本
- 4.0.4版本以上**无需屏蔽** `kservice.c` 内的 `rt_kprintf`,因为其弱函数,本软件包会自动覆盖原版`rt_kprintf`。
- 4.0.4以下版本需要手动注释掉 `kservice.c` 内的 `rt_kprintf`函数。
## 如何添加该软件包
```
RT-Thread online packages
system packages --->
enhanced kernel services --->
[*] rt_kprintf_threadsafe: thread-safe version of rt_kprintf --->
Version (latest) --->
```
## 维护
Meco Man
jiantingman@foxmail.com