【玩转.Net MF – 03】远程文件查看器

虽说目前.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的系统库也可以放入文件系统，根据需要，我们可以非源码级别的裁剪系统的大小。