虽说目前.Net Micro Framework已经支持文件系统（FAT16/FAT32），但在远程还无法直接访问，从某种意义上讲，无法和PC交互的存储介质显得有些鸡肋。我做SideShow相关开发的时候，为了向该文件系统拷贝文件，实现了UsbMassStorage功能，把设备当优盘来用，但这样做，等于独占了USB口，并且设备和PC的连接也必须为USB，对仅拥有串口或网口的设备是无效的。做过WinCE或Windows Mobile开发的人都知道，VS2008开发工具提供了些远程工具，诸如远程文件查看器、远程注册表编辑器、远程堆查看器和远程放大等等。受此启发，所以才有了MF的远程文件查看器。
该远程文件查看器，仍然作为MFDeploy的插件存在（如何做插件？请参见《玩转.Net MF–01》），最终的操作主界面如下：
该功能的实现要比《让PC成为MF的鼠标键盘》还要复杂，需要修改和添加的代码较多，下面我们一一进行讲解。
实现思路：考虑到MFDeploy已经实现了读写Flash的功能，所以最初的思路是想在PC端实现FAT文件系统（我曾实现过基于硬盘的FAT16系统），但是要支持FAT16/FAT32两种模式，还是非常复杂的，并且效率也很难保证；FTP是一种远程访问文件系统的常用办法，但这是基于TCP/IP上的协议，对USB和串口并不适合，所以考虑在PC端实现一个中间层，做一个类似串口/USB转TCP的模块，这样实现的好处是FTP客户端是现成的，不用再专门开发相关操作界面，但是FTP是基于两个TCP连接，实现起来有些难度；最终还是结合FTP的特点，实现了FTP的相关指令，如PWD、CD、CDUP、MKD和DELE指令等等，美中不足的是操作界面要自己开发。
一、 信道建立
在《让PC成为MF的鼠标键盘》中，鼠标和按键信息的传递，我们是借用了MFDeploy设备访问内存的通道，虽然简单，但极不正规，有点山寨的味道。所以彻底一点，我们自己另外新建一个访问通道。
MFDeploy和设备交互（包括VS2008部署和调试设备），都是基于WireProtocol协议，该协议是上位机MFDeploy或VS2008程序在诊断、部署、调试.Net Micro Framework设备及相关应用程序时的通信协议。该协议与具体的硬件链路无关，目前支持的物理连接有串口、网口、USB等。
该协议为点对点协议，协议中没有设备地址的概念，在同一时间同一物理通道仅能调试一台设备。协议格式分两部分，帧头和负荷（Payload）（一帧命令可以不包含Payload）。详细介绍请参见我写的文章《Micro Framework WireProtocol协议介绍》。
（1）、Native Code代码
i、在TinyCLR_Debugging.h头文件CLR_DBG_Commands结构体中添加如下代码（57行），定义一个信道（我们的名称为Custom，意思是以后新扩充的基于通信交互的功能，就可以使用该信道，不仅仅是给远程文件查看器使用）：
- static const UINT32 c_Monitor_Custom = 0x0000000F;
ii、依然在TinyCLR_Debugging.h头文件CLR_DBG_Commands结构体中添加如下代码（194行），定义我们的数据帧的通信结构（对WireProtocol协议来说就是Payload部分的数据结构）：
- struct Monitor_Custom
- {
- UINT32 m_command;
- UINT32 m_length;
- UINT8 m_data[ 1 ];
- };
- iii、在TinyCLR_Debugging.h的CLR_DBG_Debugger结构体中添加如下项（980行），声明相关信息到来时，将执行的函数：
- static bool Monitor_Custom ( WP_Message* msg, void* owner );
- iv、为在Debugger_full.cpp文件中c_Debugger_Lookup_Request数组新添一个条目（83行），声明我们的命令：
- DEFINE_CMD2(Custom)
- v、在Debugger.cpp中添加Monitor_Custom函数的具体实现：
- extern bool Monitor_Custom_Process(UINT8* data,int length,UINT8* retData,int *retLength);
- bool CLR_DBG_Debugger::Monitor_Custom( WP_Message* msg, void* owner )
- {
- NATIVE_PROFILE_CLR_DEBUGGER();
- bool fRet;
- CLR_DBG_Debugger * dbg = (CLR_DBG_Debugger*)owner;
- CLR_DBG_Commands::Monitor_Custom* cmd = (CLR_DBG_Commands::Monitor_Custom*)msg->m_payload;
- UINT8 retData[1024];
- int retLength=0;
- fRet = Monitor_Custom_Process(cmd->m_data,cmd->m_length,retData,&retLength);
- //lcd_printf("R:%d L:%d\r\n",fRet,retLength);
- if(retLength==0)
- {
- dbg->m_messaging->ReplyToCommand( msg, fRet, false);
- }
- else
- {
- dbg->m_messaging->ReplyToCommand( msg, fRet, false,retData,retLength);
- }
- return fRet;
- }
具体的功能实现在函数Monitor_Custom_Process中实现，它如果为空，则什么事也不做（当你不需要该功能时，为了节省程序空间，你就可以这么做）。
（2） 、修改Microsoft.SPOT.Debugger.dll
i、在WireProtocol.cs文件的Commands类中添加如下代码（119行），和NativeCode的代码保持一致：
- public const uint c_Monitor_Custom = 0x0000000F;
ii、仍在WireProtocol.cs文件的Commands类添加Monitor_Custom类的声明（385行）：
- public class Monitor_Custom
- {
- public uint m_command = 0;
- public uint m_length = 0;
- public byte[] m_data = null;
- public void PrepareForSend(uint command, byte[] data, int offset, int length)
- {
- m_command = command;
- m_length = (uint)length;
- m_data = new byte[length];
- Array.Copy(data, offset, m_data, 0, length);
- }
- public class Reply : IConverter
- {
- public byte[] m_data = null;
- public void PrepareForDeserialize(int size, byte[] data, Converter converter)
- {
- m_data = new byte[size];
- }
- }
- }
iii、在WireProtocol.cs文件的ResolveCommandToPayload的函数中添加如下项，声明返回数据的结构（1470行）。
- case c_Monitor_Custom: return new Monitor_Custom.Reply();
iv、仍是在WireProtocol.cs文件的ResolveCommandToPayload的函数中添加如下项，声明执行类（1537行）。
case c_Monitor_Custom: return new Monitor_Custom();
v、最关键的一步，消息发送接口的实现，在Engine.cs文件的Engine类中添加如下代码（2323行）：
- public WireProtocol.IncomingMessage CustomCommand(uint command, byte[] buf, int offset, int length)
- {
- WireProtocol.Commands.Monitor_Custom cmd = new WireProtocol.Commands.Monitor_Custom();
- cmd.PrepareForSend(command, buf, offset, length);
- return SyncMessage(WireProtocol.Commands.c_Monitor_Custom, 0, cmd);
以上代码仅仅扩展了一个信道，实际上什么事也没干（路修好了，还没有车在跑）。
二、功能实现
（1） 、Native Code代码
在\DviceCode\Pal新建CustomProcess目录，我们将完成类FTP服务端的实现。
新建CustomProcess.cpp文件，文件起始先做如下声明：
- #define Custom_Command_MouseKey 0x00
- #define Custom_Command_FileSystem 0x01
- #define FileSystem_Start 0x00
- #define FileSystem_End 0x01
- #define FileSystem_FORMAT 0x02
- #define FileSystem_PWD 0x03
- #define FileSystem_DIR_FindOpen 0x04
- #define FileSystem_DIR_FindNext 0x05
- #define FileSystem_DIR_FindClose 0x06
- #define FileSystem_CD 0x07
- #define FileSystem_CDUP 0x08
- #define FileSystem_MKD 0x09
- #define FileSystem_DELE 0x0A
- #define FileSystem_UPLOAD 0x0B
- #define FileSystem_DOWNLOAD 0x0C
Monitor_Custom_Process函数的实现如下：
- bool Monitor_Custom_Process(UINT8* inData,int inLength,UINT8* outData,int *outLength)
- {
- *outLength=0;
- if(inLength==0) return true;
- bool ret=true;
- switch(inData[0])
- {
- case Custom_Command_MouseKey:
- if(inLength == 9)
- {
- UINT32 data1=(inData[1]<<24) | (inData[2]<<16) | (inData[3] <<8) | inData[4];
- UINT32 data2=(inData[5]<<24) | (inData[6]<<16) | (inData[7] <<8) | inData[8];
- VI_GenerateEvent(data1,data2);
- }
- break;
- case Custom_Command_FileSystem:
- ret = FileSystem_Process(inData[1],&inData[2],inLength-2,outData,outLength);
- break;
- }
- return ret;
- }
你看，我们顺便也把鼠标和键盘的信道也合并到这里来了。
FileSystem_Process就是具体实现类FTP服务端功能的函数。
- bool FileSystem_Process(UINT8 command,UINT8* inData,int inLength,UINT8* outData,int *outLength)
- {
- static WCHAR current_dir[256]; //当前工作目录
- static WCHAR current_file[256]; //当前操作文件
- static UINT32 findHandle=NULL;
- static FileSystemVolume* volume = NULL;
- static STREAM_DRIVER_INTERFACE* streamDriver=NULL;
- //debug_printf("[%x:%d]\r\n",command,inLength);
- if( volume == NULL && command != FileSystem_Start) return false;
- HRESULT ret=S_OK;
- *outLength=0;
- switch(command)
- {
- case FileSystem_Start:
- volume = FileSystemVolumeList::GetFirstVolume();
- streamDriver = volume->m_streamDriver;
- memcpy(current_dir, L"\\", 2);
- current_dir[1]=0;
- break;
- case FileSystem_End:
- volume->FlushAll();
- volume = NULL;
- streamDriver = NULL;
- break;
- case FileSystem_FORMAT:
- volume->Format(0);
- volume->FlushAll();
- break;
- case FileSystem_PWD:
- *outLength = MF_wcslen(current_dir)*2;
- memcpy(outData,current_dir, *outLength);
- break;
- case FileSystem_DIR_FindOpen:
- case FileSystem_DIR_FindNext:
- case FileSystem_DIR_FindClose:
- case FileSystem_CDUP:
- case FileSystem_MKD:
- case FileSystem_DELE:
- case FileSystem_UPLOAD:
- case FileSystem_DOWNLOAD:
- //略
- break;
- }
- return true;
- }
在TinyCLR.proj文件中添加如下项，以启用我们新实现的功能。
- <ItemGroup>
- <RequiredProjects Include="$(SPOCLIENT)\DeviceCode\PAL\CustomProcess\dotNetMF.proj" />
- <DriverLibs Include="CustomProcess.$(LIB_EXT)" />
- ItemGroup>
编译下载，这时候，我们的设备已经可支持文件系统远程访问了。下一步我们将实现上位机的相关代码。
（2）、远程文件查看器插件
新建FileViewerHandle插件类。
public class FileViewerHandle : MFPlugInMenuItem
{
public override string Name { get { return "File Viewer"; } }
public override void OnAction(IMFDeployForm form, MFDevice device)
{
if (form == null || device == null) return;
(new frmFileViewer(form, device)).ShowDialog();
}
}
核心函数Send的代码如下，该函数与设备进行通信：
private bool Send(byte command, byte[] bytInput, out byte[] bytOutput)
{
byte[] bytTemp;
bytOutput = null;
if (bytInput != null)
{
bytTemp = new byte[bytInput.Length + 2];
Array.Copy(bytInput, 0, bytTemp, 2, bytInput.Length);
}
else
{
bytTemp = new byte[2];
}
bytTemp[0] = Custom_Command_FileSystem;
bytTemp[1] = command;
_WP.IncomingMessage reply = engine.CustomCommand(_WP.Commands.c_Monitor_Custom, bytTemp, 0, bytTemp.Length);
if (!_WP.IncomingMessage.IsPositiveAcknowledge(reply)) return false;
_WP.Commands.Monitor_Custom.Reply CustomReply = reply.Payload as _WP.Commands.Monitor_Custom.Reply;
if (CustomReply != null) bytOutput = CustomReply.m_data;
return true;
}
限于篇幅，下面仅截取几个命令操作的片段
private void tsbUP_Click(object sender, EventArgs e)
{
ShowInfo("ready.");
byte[] outData;
if (Send(FileSystem_CDUP, out outData))
{
txtDir.Text = System.Text.Encoding.Unicode.GetString(outData);
}
else
{
ShowInfo("up failed!", InfoType.Error);
}
list();
}
private void tsbNew_Click(object sender, EventArgs e)
{
ShowInfo("ready.");
frmInputBox fb = new frmInputBox("Input directory", "");
if (fb.ShowDialog() == DialogResult.OK)
{
string strInfo = fb.Info;
byte[] inData = System.Text.Encoding.Unicode.GetBytes(BuildPath(strInfo));
if (!Send(FileSystem_MKD, inData)) ShowInfo("mkd failed!", InfoType.Error);
list();
}
}
private void tsbDelete_Click(object sender, EventArgs e)
{
ShowInfo("ready.");
if (lvFile.SelectedItems.Count == 0) return;
if (MessageBox.Show("Really implement operation for Delete?", this.Text, MessageBoxButtons.OKCancel,MessageBoxIcon.Question) == DialogResult.OK)
{
byte[] inData = System.Text.Encoding.Unicode.GetBytes(BuildPath(lvFile.SelectedItems[0].Text));
if (!Send(FileSystem_DELE, inData)) ShowInfo("dele failed!", InfoType.Error);
lstFile.Remove(lvFile.SelectedItems[0].Text);
list();
}
}
实现.Net MF的远程文件查看器意义深远，我们不仅可以向文件系统拷贝我们的图片、字体等资源，更有意义的事，我们可以把.Net MF应用的程序，作为可执行文件拷贝到文件系统，然后让TinyCLR去加载执行。甚而.Net MF的系统库也可以放入文件系统，根据需要，我们可以非源码级别的裁剪系统的大小。