.. 10_debug:

.. _模拟器窗口说明:

模拟器窗口
---------------------

通过主界面菜单编译=》调试，打开模拟器窗口

.. image:: image/form_menu_debug.png

.. image:: image/form_debug_main.png
  :width: 986px

**调试模式**

调试模式分为模拟器和真机，模拟器即当上位机显示的窗口，真机即硬件屏。

**1.模拟器**

指令输入区->模拟器：指令输入区直接发送数据给模拟器。如下图：

.. image:: image/指令输入区.png

虚拟串口->模拟器：支持创建虚拟串口，用串口助手向模拟器发送串口指令。此时，模拟器可以理解为一个硬件屏，串口助手为单片机。
如下图：

**注：此功能需要安装虚拟串口驱动virtual-serial-port-control.msi**  
（ `点击下载 <http://www.openedv.com/ATK-Prod/ATK-HMI/file_download/tools/virtual-serial-port-control.zip>`_）

.. image:: image/form_debug_vcom.png
  :width: 1685px

MCU串口->模拟器：也可以使用单片机向模拟器发送数据，配置如下图：

.. image:: image/form_debug_mcu.png


**2.真机**

指令发送区->真机: 当调试模式选为真机时，模拟器窗口相当于串口助手，只不过带了指令发送区、指令接收区，发送时自带帧尾，
接收区会解析返回的数据，显示指令的含义。如下图：

.. image:: image/form_debug_dev.png

**指令编码**
真机调试时需要设置指令编码，因为发送区不知道硬件屏的编码，需要用户手动设置。

.. image:: image/form_debug_encoding.png

**模拟器显示区域**
鼠标可以模拟触摸。鼠标左键点击触发按下事件，松开左键触发弹起事件，按下鼠标左键移动模拟拖动效果

.. image:: image/form_debug_devshow.png

**指令输入区域**

.. image:: image/form_debug_send.png

在区域里输入指令，通过执行所有指令按钮，指令成功执行，模拟器显示区域（或串口设备）将会执行相应的操作。

**指令格式**
勾选HEX，字符串指令按照十六进制发送,否则按照字符串形式发送指令

**指令存储**
点击1,2,3,4按钮指令输入区将出现保存在里面指令代码

**回车发送**
勾选回车发送在输入框里面按回车按键自动发送

**返回数据**

.. image:: image/form_debug_recv.png

当模拟界面工程串口发送数据出去的时候，串口发送的数据就会显示在这个区域。

指令执行失败，将会在模拟器返回数据窗口返回失败原因（可通过bkcmd指令开启或关闭）。

.. image:: image/form_debug_opera.png


**操作**

* 校准RTC时钟：发送RTC时钟校准指令到模拟器或者设备。
* 重启：发送重启指令到模拟器/设备。