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

简介: 做过WinCE或Windows Mobile开发的人都知道,VS2008开发工具提供了些远程工具,诸如远程文件查看器、远程注册表编辑器、远程堆查看器和远程放大等等。受此启发,所以才有了MF的远程文件查看器。

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

相关文章
|
Windows
.Net Micro Framework研究—模拟器直接运行MF程序
既然VS2005能启动运行,我想我们也可以,唯一不同的是模拟器加载的参数不同而已
723 0
.Net Micro Framework研究—用MF编写俄罗斯方块
现在对MF充满了激情,所以从零做起(没有参考任何现成代码,只不过还是依照我早期的思路编写而成),花费我大半天的时间才编写完毕(在编写过程中,还发现MF对二维数组支持不大好,我后面会提到)
390 0
.Net Micro Framework研究—让MF支持鼠标
MF的标准模块仅支持按键,并不支持鼠标功能。但是对一些常见应用来说,如果没有鼠标(或触摸屏)用起来就太不习惯了
487 0
|
机器人
.Net Micro Framework研究—用MF控制机器人
机器人研究一直是我很早以前的梦想,没有想到在深入研究.Net Micro Framework同时能和机器人搭上了联系。
562 0
.Net Micro Framework研究—让MF支持英文输入法
目前字符串不仅无法转换为数字,并且没有字符插入功能,所以这个函数也必须自己来实现,此外输入焦点光标也需要自己绘制,好了,先不说难处了,先看看最终成果。
710 0
.Net Micro Framework研究—MF驱动继电器
年前张欣有一个比较好的想法,想用Digi的MF板驱动一个小型继电器,这样就可以用MF直接控制家中的小功率220V的电器了
588 0
|
安全
.Net MF V4.0开源前的代码整理
已经有好长一段时间没有更新博客了,一是去美国总部和台湾出差用了不少时间,二是做.Net MF代码整理又花了近一个月的时间。不过令人欣慰的是,目前.Net MF V4.0的相关代码整理已经告一段落,就等着下一步的开源了
670 0
|
Linux C++ C#
【.Net Micro Framework PortingKit – 15】移植总结兼MF未来发展
我坚信.Net Micro Framework在未来嵌入式发展中,一定会占有一席之地(更何况现在已经开源了,并且采用更为彻底的Apache 2.0 license)。希望更多的人参与其中,把.Net Micro Framework移植到更多嵌入式平台上去,使它成为真正名副其实的“框架”。
914 0
|
内存技术
【玩转.Net MF – 01】Flash远程读写
目前在PC远程访问设备Flash,也就是部署TinyCLR和下载应用程序
557 0
|
内存技术
【玩转.Net MF – 02】让PC成为MF的鼠标键盘
通过扩展我以前为.Net MF开发的WinForm库(参见我以前的文章《开源System.Windows.Forms库,让.Net Micro Framework界面开发和上位机一样简单》),增加一个输入代理层,就可以实现虚拟鼠标和键盘输入。
613 0

热门文章

最新文章

下一篇
无影云桌面