【叶帆工作室】2009-2-15
1、简介
WireProtocol协议是上位机MFDeploy或VS2008程序在诊断、部署、调试.Net Micro Framework设备及相关应用程序时的通信协议。该协议与具体的硬件链路无关,目前支持的物理连接有串口、网口、USB等。
该协议为点对点协议,协议中没有设备地址的概念,在同一时间同一物理通道仅能调试一台设备。协议格式分两部分,帧头和负荷(Payload)(一帧命令可以不包含Payload)。
了解该协议和获知通信时的数据,可以非常有效的解决上位机和下位机.Net Micro Framework设备通信问题。
2、通信协议
2.1 帧格式
帧头(Header)32 byte | 负荷 | |||||||
签名 | 头校验 | 负荷校验 | 命令 | Seq | SeqReply | 标志 | 负荷大小 | |
8 byte | 4 byte | 4byte | 4byte | 2byte | 2byte | 4byte | 4byte | N byte |
MS…V1 | Crc32 | Crc32 | Cmd | Seq | reply | flag | size | Payload |
注:负荷大小可以为0
2.2 通信过程
总超时时间6秒,如果下位机无数据响应,则1秒钟重试一次,共6次。如果下位机有命令反馈,但是帧数据不是期望数据,则重试1次,共2次。
2.3 通信命令
通信命令一共71个,其中1个已经过时、6个已经被注销。这里仅介绍一下和Ping过程相关的几个命令。
序号 | 名称 | 值 | 说明 |
1 | c_Monitor_Ping | 0x00000000 | The payload is empty, this command is used to let the other side know we are here... |
2 | c_Debugging_Execution_Unlock | 0x00020003 | Unlock the low-level command, for mfg. test programs |
3 | c_Debugging_Execution_QueryCLRCapabilities | 0x00020008 | Queries capabilities of the CLR. |
2.3.1、Monitor_ Ping
命令:0x00000000帧长:32+8 byte (Ping指令可以没有Payload数据)
帧头 | 源 | 标志 |
32 byte | 4 byte | 4 byte |
源(source):
序号 | 名称 | 值 | 说明 |
1 | c_Ping_Source_TinyCLR | 0x00000000 | |
2 | c_Ping_Source_TinyBooter | 0x00000001 | |
3 | c_Ping_Source_Host | 0x00000002 |
标志(dbg_flags):
序号 | 名称 | 值 | 说明 |
1 | c_Ping_DbgFlag_Stop | 0x00000001 |
2.3.2、Debugging_ Execution_Unlock
命令:0x00020003帧长:32+256 byte
帧头 | 命令 | 哈希值 |
32 byte | 128 byte | 128 byte |
命令和哈希值如下:
private readonly byte[] m_data =
{
67, 111, 112, 121, 114, 105, 103, 104, 116, 32, 50, 48, 48, 51, 13, 10,
77, 105, 99, 114, 111, 115, 111, 102, 116, 32, 67, 111, 114, 112, 13, 10,
49, 32, 77, 105, 99, 114, 111, 115, 111, 102, 116, 32, 87, 97, 121, 13,
10, 82, 101, 100, 109, 111, 110, 100, 44, 32, 87, 65, 13, 10, 57, 56,
48, 53, 50, 45, 54, 51, 57, 57, 13, 10, 85, 46, 83, 46, 65, 46,
13, 10, 65, 108, 108, 32, 114, 105, 103, 104, 116, 115, 32, 114, 101, 115,
101, 114, 118, 101, 100, 46, 13, 10, 77, 73, 67, 82, 79, 83, 79, 70,
84, 32, 67, 79, 78, 70, 73, 68, 69, 78, 84, 73, 65, 76, 13, 10,
55, 231, 64, 0, 118, 157, 50, 129, 173, 196, 117, 75, 87, 255, 238, 223,
181, 114, 130, 29, 130, 170, 89, 70, 194, 108, 71, 230, 192, 61, 9, 29,
216, 23, 196, 204, 21, 89, 242, 196, 143, 255, 49, 65, 179, 224, 237, 213,
15, 250, 92, 181, 77, 10, 200, 21, 219, 202, 181, 127, 64, 172, 101, 87,
166, 35, 162, 28, 70, 172, 138, 40, 35, 215, 207, 160, 195, 119, 187, 95,
239, 213, 127, 201, 46, 15, 60, 225, 19, 252, 227, 17, 211, 80, 209, 52,
74, 122, 115, 2, 144, 20, 153, 241, 244, 57, 139, 10, 57, 65, 248, 204,
149, 252, 17, 159, 244, 11, 186, 176, 59, 187, 167, 107, 83, 163, 62, 122
};
命令对应的ASCII为:
Copyright 2003
Microsoft Corp
1 Microsoft Way
Redmond, WA
98052-6399
U.S.A.
All rights reserved.
MICROSOFT CONFIDENTIAL
7?@
2.3.3、Debugging_ Execution_QueryCLRCapabilities
命令:0x00020008帧长:32+n byte
帧头 | 标志(4 byte) | 数据 | |||||
32 byte | 0x00000001 | capsFlags :4byte | |||||
0x00000002 | Width:4byte | Height:4byte | bpp:4byte | ||||
0x00000003 | buildDate:20byte | compilerVersion:4byte | |||||
0x00000004 | minutesRemaining:4byte | ||||||
0x00000005 | MfReleaseInfo:64 | OEM_MODEL_SKU | OEM_SERIAL_NUMBERS | ||||
0x00000006 | MfReleaseInfo:64 | Version:8 | |||||
0x00000007 | MfReleaseInfo:64 | ||||||
MfReleaseInfo:
MfReleaseInfo | ||||
Version | 保留 | |||
主版本 | 次版本 | 编译 | 修订 | |
2 byte | 2byte | 2byte | 2byte | 56byte |
OEM_MODEL_SKU:
OEM_MODEL_SKU | ||
OEM | Model | SKU |
1 byte | 1byte | 2 byte |
OEM_SERIAL_NUMBERS:
OEM_SERIAL_NUMBERS | |
module_serial_number | system_serial_number |
32 byte | 16 byte |
标志:
序号 | 名称 | 值 | 说明 |
1 | c_CapabilityFlags | 0x00000001 | 标志 |
2 | c_CapabilityLCD | 0x00000002 | LCD的参数 |
3 | c_CapabilityVersion | 0x00000003 | 软件版本 |
4 | c_CapabilityEvaluationVersion | 0x00000004 | 剩余可运行分钟数 |
5 | c_HalSystemInfo | 0x00000005 | 硬件系统信息 |
6 | c_ClrInfo | 0x00000006 | CLR信息 |
7 | c_SolutionReleaseInfo | 0x00000007 | 平台发布信息 |
c_CapabilityFlags的含义:
序号 | 名称 | 值 | 说明 |
1 | c_CapabilityFlags_FloatingPoint | 0x00000001 | |
2 | c_CapabilityFlags_SourceLevelDebugging | 0x00000002 | |
3 | c_CapabilityFlags_AppDomains | 0x00000004 | |
4 | c_CapabilityFlags_ExceptionFilters | 0x00000008 | |
5 | c_CapabilityFlags_IncrementalDeployment | 0x00000010 | |
6 | c_CapabilityFlags_SoftReboot | 0x00000020 | |
7 | c_CapabilityFlags_Profiling | 0x00000040 | |
8 | c_CapabilityFlags_Profiling_Allocations | 0x00000080 | |
9 | c_CapabilityFlags_Profiling_Calls | 0x00000100 | |
10 | c_CapabilityFlags_EvaluationVersion | 0x00000200 | |
11 | c_CapabilityFlags_ThreadCreateEx | 0x00000400 |
3、MFDeploy Ping过程分析
3.1、流程图
Ping 命令流程图
3.2、流程分析
MFDeploy Ping过程不仅仅包括Ping命令,它完整的流程包含了四个命令过程,下面一一说一下。
3.2.1、第一个Ping
上位机发送帧:源=c_Ping_Source_Host(0x00000002),标志=0;
下位机返回帧:源= c_Ping_Source_TinyCLR(0x00000000)或c_Ping_Source_TinyBooter(0x00000001),标志= c_ACK | c_NonCritical | c_Reply(0x8003);
3.2.2、QueryCLRCapabilities
该指令共执行7次,分别获取CLR七种特性(标志依次从1到7),详情请参见【2.3.3】。
3.2.3、Unlock
上位机发送帧:命令和哈希值请参见【2.3.2】;
下位机返回帧:Payload为空,标志= c_NACK | c_NonCritical | c_Reply;
3.2.4、最后一个Ping
上位机发送帧:Payload为空
下位机返回帧:源= c_Ping_Source_TinyCLR(0x00000000)或c_Ping_Source_TinyBooter(0x00000001),标志= c_ACK | c_NonCritical | c_Reply(0x8003);
4、如何获取通信数据
4.1 采用通用监控工具获取
不同的物理链路需采用不同的监控工具,其推荐的监控工具如下:
串口:portmon程序(微软官方提供的工具,可惜目前并不支持vista系统)。
网口:Wireshark程序
USB:Bus Hound程序
由于这部分内容,非本文重点,所以这里就不展开介绍了,不过以上工具除Wireshark外,在我以前的文章中已经有所提及,感兴趣的朋友可以查阅我以前的相关文章。
4.2 改造MFDeploy和VS2008相关程序
这种办法虽然最有效,但是如果没有相关源码是很难做到的。
上图是改造前的Porting Kit所带的MFDeploy工具,下图是我改造后的该程序,相关通信操作完毕后,单击“Info”按钮即可显示相关通信数据。
此外尤为重要的是,单击“Normal”按钮,使其变为“Debug”模式,此时不仅在操作MFDeploy工具时自动弹出监控信息窗口,并且在用VS2008调试.Net Micro Framework程序时也能弹出监控信息窗口。
5、小结
俗话说麻雀虽小,五脏俱全。很显然.Net Micro Framework就是这样一只麻雀,各种技术虽然简单,但是都有所涉及(ARM开发技术、CLR技术、VS2008开发、调试技术、各种串口、网口、USB通信技术等等),随着研究的深入,越来越被.Net Micro Framework自身魅力所吸引,相信下一个支持实时系统的版本更值得期待。