搞嵌入式开发的老人,尤其是当年在Windows CE平台上讨生活的,对retailmsg这个词肯定不陌生。它全称RETAILMSG,是Platform Builder里自带的一个调试宏,作用一句话就能说清:在正式发布版本的系统里,也能往调试串口打印日志。听着不稀奇?等你搞明白WinCE的调试机制,就知道这个口子留得有多讲究。
得从WinCE的两种版本说起。开发阶段用debug版,什么信息都往外吐,DEBUGMSG这个宏随便用;但产品出货时装的是retail版,为了性能和体积,调试代码基本全被裁掉了,DEBUGMSG编译进去就是个空操作。那麻烦来了:设备卖到客户手里出了毛病,总不能靠猜吧?RETAILMSG就是给这种情况准备的——正式版里照样能编进去、照样能打印。
用法跟DEBUGMSG几乎一个模子:RETAILMSG(条件, (TEXT("要打印的内容\r\n")));。第一个参数是个表达式,为真才输出。所以很多老工程师的习惯是在代码里留一堆RETAILMSG(0, ...)的语句——平时一句不出声,哪天设备出了怪毛病,把0改成1重新编一版固件,日志立马就出来了。等于在正式固件里埋了个随时能打开的暗门。
它的输出走的是系统调试串口,底层调的是NKDbgPrintfW这一类函数,拿根串口线接上终端就能看。在USB、以太网调试还没普及的年代,一根串口线加一个超级终端,就是嵌入式工程师的全部家伙事儿。有些平台还会把这个输出重定向到别的地方,具体得看OAL那一层怎么实现的。
不过这宏有讲究,不能撒开了用。一是占地方,每条RETAILMSG连同里面的字符串都会编进正式固件,用多了体积蹭蹭涨;二是拖速度,串口打印本身就慢,要是在高频中断里塞一条,性能立马掉一截。所以行里的老规矩是:正式产品只在关键路径留几条,条件参数默认给0让它闭嘴。微软自己的文档也是这么建议的。
还有个容易踩的坑:RETAILMSG只在WinCE这套体系里存在,你要把它搬到Linux或者裸机项目里,编译器根本不认识这玩意。Linux下对应的角色是printk加日志级别,裸机开发就直接往UART寄存器里写了。工具跟着平台走,这是嵌入式的常态,只是当年WinCE如日中天的时候,没人觉得这有什么问题。
现在回头看,retailmsg算是被时代翻篇的一个小东西。WinCE本身都停止主流支持好些年了,新项目很少有人碰。但在当年,POS机、车载导航、工控面板里跑的几乎都是它,靠着串口上滚出来的一行行字,多少疑难杂症才有了头绪。手里还压着WinCE老项目的朋友,翻代码看到RETAILMSG(0, ...)的时候,先别急着删——那可能是前人专门留给你的排障通道。
上一篇:富士康当年为啥非要买夏普?3888亿日元砸下去,图的不只是一块屏
下一篇:没有了