RT-Thread：U盘有时无法识别BUG修复

---

前言

最近使用RT-Thread中的USB HOST进行U盘的读写，发现有时候U盘拔插几次后无法识别，必须重启才可以再次识别，废话不多说，直接开干抓臭虫。

---

一、问题现象

1、在快速热拔插的过程中比较容易出现U盘无法识别现象
2、出现插入U盘无法识别现象后，在未重启系统情况下重新拔插U盘均无效
3、必须重启系统后才可以再次正常识别U盘

二、解决方案

先把解决方案公布出来，后面会讲我是如何抓这只臭虫的，感兴趣的朋友可以往后看。

---

1、当U盘插入并程序识别其插入后，当未对其进行挂在文件系统前出现拔出U盘情况时，程序会卡死在dev_usbh.c的drv_pipe_xfer函数中，rt_completion_wait函数正常来讲应该是要有超时后退出程序的相关代码才对，并且需要重置connect_status变量，不然的话重新拔插也无效，所以需要修复这个BUG

代码修改成：

二、运行测试

1、程序运行后我疯狂的胡乱拔插U盘他都死不了，都能重新识别上，几十次的非正常热拔插测试只有一次出现报故障后不会自动识别上，只需要拔掉U盘重新插一次就可以，不需要重启系统，这个也属于正常现象，哪怕是电脑都有这种情况，必须重新插入才可以正常识别现象，这个做的比电脑效果好多了，电脑这么疯狂拔插几次就出现问题需要重新拔插的现象。当然这个可以用程序识别到故障后重新尝试识别U盘，具体为什么出现那个故障后必须重新拔插U盘的原因我就暂时不纠结了，我没记录下那个故障，而且很难复现那个故障，只要重新拔插能解决就能满足我的要求，赶项目进度要紧。

三、抓臭虫！！

1、确定BUG类型，硬件BUG？软件BUG?

（1）为了确认硬件连接是否存在问题，我使用了探索者开发板，保证硬件连接没有问题。
（2）剩下就是确认STM32F407芯片是否有问题，我使用了正点原子官方的U盘测试例程，令人欣慰的是无论我如何疯狂的热拔插都没事，依然坚挺！！！如果芯片有问题只能说“哦豁，完蛋”，自动自觉换芯片方案，什么！？不行！？那就用某种方法掩盖这个BUG，什么！？还不行！？愣着干啥！提桶跑路啊！

2、找软件BUG

（1）从上面的步骤可以证明这个属于软件BUG，那说明还能抢救一下。找问题嘛，憋说了，先开启RTT自带的DEBUG_LOG打印出一些调试信息。

• RT_DEBUG_LOG函数可以打印出调试日志，我们随便打开一个USB相关文件都能看到很多地方都有RT_DEBUG_LOG(RT_DEBUG_USB, ("…"));的代码，而RT_DEBUG_USB就是调试日志类型，，使能RT_DEBUG_USB这个宏，打开后才能打印出有关USB的调试日志。编译下载运行后，插入U盘打印信息风格大变，一堆信息映入眼帘，我们只要看关键信息即可。
  
• 因为出现识别问题后程序再也不能用了，所以给我的感觉就是要么插入的时候出现了毛病，要么就是拔出的时候出现毛病。经过测试，信息是这样的
  正常情况插入U盘：
  
  
  正常情况下拔出U盘：
  
  非正常情况下插入U盘：
  
• 从调试日志可以看出非正常情况下日志只出现在start enumnation就没有了，重新拔插也没用，再也没有相关USB的调试日志出现了，难道是卡在某个地方？USB的任务出错了？
• 复制start enumnation这个调试信息在工程中全局搜索
  
• 可以确认的是这个函数在插入U盘后只执行一次，且打印信息之后的程序有问题，后面的程序有很多都是出现问题会提示故障的代码，可是我们一条都没看到，这个给我一种程序卡死在某个地方的感觉，如果利用传统的仿真打断点，拔插时间非常不好掌握，所以我利用RT_DEBUG_LOG来测试。
  
• 总共放了3个日志打印点，后面之所以不用放是因为后面的息在出现问题时没有被打印出来，所以程序肯定不会执行到这。
  
• 编译下载运行看看情况，事实证明，第一个测试日志都没打印出来，可以缩小问题范围了，确实是卡死在rt_usbh_get_descriptor函数中。
  
• 在函数中没有发现循环体且只有三个函数，并且从参数可以看出都具有超时退出的功能，然而事实证明却没有，所以找到一个BUG，可能不止这一个BUG。
  
• 梅开二度，再次利用RT_DEBUG_LOG放置调试日志，确认是哪个函数卡死。
  
• 结果显示第一个函数rt_usb_hcd_setup_xfer就卡死了，我原本想再进入函数里面看看的发现，完蛋！用的是指针跳转到某个函数的，具体哪个函数鬼知道（鬼说：我也不知道），这得读懂很多地方的程序才可以知道他跳到哪里去，这难度也太高了，我目前没这能力。这时候就可以利用仿真了直接在这个函数打断点。
  
• 还是仿真香…，单步运行直接跳到drv_pipe_xfer函数
  
• 令人激动的是这个函数中有一个while循环体，有了它就有可能在这卡死，不妨来测试一下，在里面放个调试日志
  
• 运行发现出现问题后这个“running-1”不断的被打印出现，说明卡死在了这while循环体内。之前说过这个函数是有timeouts这个参数的，卡死在这里说明这个参数没有起作用，我们接下来看看哪里用到这个参数。发只有一个地方用到，而且这个函数没有进行返回值判断，如果这个函数本身没有BUG，检测到了超时也不会进行任何处理，我感觉找到了臭虫本体…
  
• 打印一下他的返回值，确认这个函数是否能检测到超时，事实证明可以检测到超时。
  
• 我们让他超时退出这个函数再疯狂拔插试试，现实往我脸打了一巴掌，确实不会卡死，可是问题依然存在，而且没有任何变化。
  
• 观察这个循环体内其他函数退出操作方式没什么不同，难道退出需要做什么操作才可以吗？经过一番折腾观察了正常插拔U盘的时候有一个"usb disconnnect"信息吸引了我，我决定去找找他附近的代码观察一下。
  
• 发现在里面有对connect_status变量的操作，而且这个变量超级熟悉，在卡死的函数里面也出现了，这个变量顾名思义就是连接状态，可以猜想有可能是状态没有清导致系统还以为我插着U盘，p话不多说，直接学他。
• 
  学他修改后的代码：
  
• 编译下载运行，哟西！！！问题解决！！！妈妈再也不用担心我的U盘无法识别啦~！
• 在这个循环体内其他return -1;的前面我都加了connect_status = RT_FALSE;

总结

经过一个下午奋斗，终于可以收拾桌上散落的毛发，下班回家安心躺尸...