深圳市左客信息科技有限公司

1目录一,安装及卸载.
21.
1XP,Win7及Win8环境下安装.
21.
2卸载.
3二,新建一个项目.
32.
1新建一个C#Winform窗体项目.
32.
1.
1新建一个项目.
32.
1.
2"设备宿主控件"42.
1.
3设备编辑框.
52.
1.
4变量编辑框.
62.
1.
5常用控件.
72.
1.
6运行.
82.
2新建一个VB窗体项目8三,组态控件.
103.
1"设备宿主控件(IO_Servers)"控件103.
2"变量显示(Text_Label)"控件103.
3"位监视图(Bit_Picture)"控件113.
4"多功能按钮(Bit_Button)"控件113.
5"变量输入(Text_Input)"控件113.
6"报警控件(Alarm_Label)"控件113.
7"画面切换按钮(Switch_Form)"控件123.
8"选择框(Bit_CheckBox)"控件133.
9"多功能组合框(Number_ComboBox)"控件133.
10"弹出窗体(Pop_Form)"控件133.
11"进度条(Number_ProgressBar)"控件133.
12"实时曲线图表(RealTime_Chart)"控件143.
13"饼图(Pie_Chart)"控件143.
14"步序显示(Show_Info)"控件143.
15"多图片显示(Show_Picture)"控件143.
16"多文本显示(Show_Text)"控件153.
17"高级设备单元操作(Variable_Base)"控件153.
18"高级设备数据存储(EventPackageCtl)"控件163.
19"关闭按钮(Close_Button)"控件163.
20"UDP/IP远程接口(Remote_Interface)"控件16四,静态函数及功能.
16五,调试,运行.
16六,发布.
16七,更新.
17深圳市左客信息科技有限公司2一,安装及卸载嘟咔组态软件是一组嵌入在微软的软件开发平台VisualStudio里(简称VS),并以控件的形式显示在工具箱内的控件.
故在安装本嘟咔组态软件之前,请务必先安装好微软开发平台VisualStudio.
目前VisualStudio2010以后的版本都支持.
1.
1XP,Win7及Win8环境下安装先安装好VisualStudio(如果之前已安装后,则无需再安装),然后安装嘟咔软件.
如果安装过几个版本的VS,则安装过程需要选择正确的版本即可.
(如图1.
1a).
安装过程中,如何自动注册控件不成功,则需要手动添加控件,方法如下:打开VS---新建一个C#或VB窗体项目---在窗体设计模式下打开工具箱---在工具箱中添加一个名称为"DookaControls"选项卡---把嘟咔安装目录下(默认路径为:C:\ProgramFiles\Dooka)的"DookaControls.
dll"文件拖到"DookaControls"选项卡中.
如下图图3.
1a深圳市左客信息科技有限公司31.
2卸载通过"开始"->"程序"->"Dooka"->"Uninstall.
exe"即可卸载.
如图二,新建一个项目安装完成后,准备好需要连接的设备(比如三菱PLC)及所需通讯线.
然后启动VisualStudio(如果安装了多个版本的VS,请启动在安装过程中选择的那个版本,比如VS2010),然后建立一个窗口程序.
嘟咔组态目前只支持C#Winform和VB类型的项目.
2.
1新建一个C#Winform窗体项目2.
1.
1新建一个项目启动VisualStudio(比如VS2010),通过"文件"->"新建项目"建立新项目.
在弹出的窗口中新建C#Winform窗体项目.
如下图所示:新建完项目后,先保存项目.
如下图.
因为嘟咔组件需要在Microsoft.
NETFramework2,或Microsoft.
NETFramework3,或Microsoft.
NETFramework4框架中才能运行.
而VS2010新建的项目默认框架为Microsoft.
NETFramework4ClientProfile.
所以需要更改新建立的项目框架.
(VS2008和VS2012没有这个问题)深圳市左客信息科技有限公司4在"解决方案资源管理器"中通过右键单击项目,在弹出的菜单栏中选择"属性".
如下图:把目标框架改成".
NETFramework4"并保存.
2.
1.
2"设备宿主控件"双击项目中的主窗体"Form1.
cs",然后在工具箱的"DookaControls"选项卡中选择"设备宿主控件"并添加.
(提示:如果工具箱没有显示,可用组合快捷键"Ctlr+Alt+X"打开)深圳市左客信息科技有限公司52.
1.
3设备编辑框添加"设备宿主控件"后,主窗体的正下方将显示刚添加的宿主控件"iO_Servers1".
如上图所示.
右键单击刚添加的"iO_Servers1"控件,在弹出的菜单中选择"属性",在"属性"工具栏中单击"设备编辑"项最右边的按钮弹出"设备编辑"框.
如下图:深圳市左客信息科技有限公司6"设备编辑"框分为4个栏目,分别为左上的"IO设备栏",左下的"端口栏",右上的"设备栏"和右下的"注解栏".
"IO设备栏":通过树形控件显示目前所支持连接的设备协议.
"设备栏":显示和设置已添加的设备.
"端口栏":显示和设置已添加的端口.
"注解栏":显示如何设置设备及端口的主要参数.
在"IO设备栏"中依次展开,找到将要连接设备所用的协议.
比如,通过电脑串口连接三菱FX系列PLC的FX-232-BD.
我们选择"MC协议(格式1)".
双击"MC协议(格式1)"节点,新建一个设备.
设备新建完成后,需要为设备指定一个通讯端口.
如果没有合适的通讯端口.
则可通过"端口栏"新建一个连接端口并指定.
如上图所示.
2.
1.
4变量编辑框设备添加完成后,接下来编辑要访问的设备变量,即设备中的输入输出信号或存储单元.
在"iO_Servers1"控件的属性中单击"变量编辑"项最右边的按钮弹出"变量编辑"框(参见添加"设备宿主控件"一节).
如下图:"变量编辑"框分为2个栏目,分别为左边"目录栏"和右边"变量栏".
"目录栏"为树形控件,其各个根节点为不同设备节点.
当变量很多时,为了便于管理,每个节点均可建新的节点.
即右键单击节点新建文件夹节点.
选中每个节点时,"变量栏"将显示该节点下所定义的所有变量.
"变量栏"显示和编辑变量.
可通过上面的工具栏"保存","插入行","删除行"和"选择行"操作变量.
当项目所需的变量编程完成后,可保存退出.
或"选择行"并退出.
IO设备栏端口栏设备栏注解栏深圳市左客信息科技有限公司72.
1.
5常用控件设备及端口设置好后,在工具箱的"DookaControls"选项卡中选择"变量显示"控件并添加到主窗体里(如下图).
在新加的控件属性栏中"嘟咔属性"选项卡中的"设备变量"中选择一个已编辑的设备变量.
如果没有,可以新编辑一个合适的变量.
目录栏变量栏深圳市左客信息科技有限公司82.
1.
6运行通过上面的工作,我们已完成了一个非常简单的项目.
现在,我们可以试运行一下看结果.

运行结果如右图所示:监控的设备变量值为"0";2.
2新建一个VB窗体项目VB窗体项目的使用跟上面C#Winform项目差不多.
所不同的有以下几点:新建项目类型不同:上面的例子是新建一个C#Winform窗体项目.
而本例是新建一个VB窗体项目.
如下图:如果是在VS2010平台下,则需要更改目标框架(如下图).
其余的如添加"设备宿主控件","设备编辑","变量编辑",添加监控控件,运行等参照上面的例子.
深圳市左客信息科技有限公司9深圳市左客信息科技有限公司10三,组态控件本章依次介绍各个嘟咔控件的属性及使用说明.
每个嘟咔控件除了既有VS基本属性外,还具备嘟咔关于设备的特有属性.
(选中每一个属性,最下边都会有关于该属性的简要说明哦!
)3.
1"设备宿主控件(IO_Servers)"控件在连接一个或多个设备之前,首先需要设置好设备的属性及连接所用端口.
为了做这些必备工作,需要在项目的主窗体里添加该控件,即在"工具箱"里展开"DookaControls"选项卡,添加"设备宿主控件"到窗口中(一个项目不管连接多少个设备,只需添加一个即可).
在添加的控件属性窗口中(如图3.
1a),有以下几个设置:设备编辑:编辑将要连接的设备属性及所用连接端口(参见2.
1.
3节).
变量编辑:编辑将要访问的设备变量,即设备的输入输出状态及存储器(参见2.
1.
4节).
触摸屏:指示项目是否用在带触摸屏功能的显示屏上.
如果为"True",则带输入的控件将自动开启键盘.
语言:选择用户的使用语言.
刷新:确保当前项目中的文件为最新的嘟咔组件.
账号管理:创建和编辑用户相关账号和权限.
3.
2"变量显示(Text_Label)"控件可以访问并显示设备的输入输出状态及存储器值.
跟设备有关的属性:设备变量:指定访问的设备变量.
索引号:当要访问的设备变量数量为多个时,指定是哪一个.
0为第一个.
转换因子:控件显示的值为设备变量*转换因子.
比如设备变量的值为100,转换因子为0.
1,则控件显示为10.
跟设备有关的事件:Error:当访问设备变量出错时,将引发该事件.
ValueChanged:当访问的设备变量值发生改变时,将引发该事件.
ValueUpdated:当访问的设备变量更新时,将引发该事件.
跟设备有关的代码:控件名称.
Variable为设备变量的对象.
如右图,text_Label1.
Variable为设备变量的对象.
通过该对象可以访问设备变量的常用参数和成员函数.
比如设备变量值,索引号,写操作等.
图3.
1a深圳市左客信息科技有限公司113.
3"位监视图(Bit_Picture)"控件指示灯控件,显示位状态.
跟设备有关的属性:设备变量:指定访问的设备变量.
复位图片:当指定的设备变量值为0或false时显示的图片.
置位图片:当指定的设备变量值为1或true时显示的图片.
位索引:当指定的设备变量类型不是位类型时,指明哪一个位.
3.
4"多功能按钮(Bit_Button)"控件监控位类型的设备变量的按钮控件.
跟设备有关的属性:设备操作变量:指定操作的设备变量(位类型).
设备监视变量:指定访问的设备变量.
操作模式:置位:单击按钮,操作变量置位.
复位:单击按钮,操作变量复位.
点动:当鼠标按下时,操作变量置位.
当鼠标释放时,操作变量复位.
反转:单击按钮,操作变量取反,即复位时置位,置位时复位.
弹出确认窗口:指定在操作时是否弹出确认窗口.
复位文本:指定当监视变量为0或false时要显示的文本.
置位文本:指定当监视变量为1或true时要显示的文本.
复位图片:指定当监视变量为0或false时要显示的图片.
置位图片:指定当监视变量为1或true时要显示的图片.
位索引:当指定的监视变量类型不是位类型时,指明哪一个位.
3.
5"变量输入(Text_Input)"控件监控设备的输入输出状态及存储器值.
跟设备有关的属性:操作变量:指定操作的设备变量.
监视变量:指定访问的设备变量.
弹出确认窗口:指定在操作时是否弹出确认窗口.
高低字节互换:当监控的设备变量类型为ASC码时有效.
转换因子:控件显示的值为设备变量*转换因子.
3.
6"报警控件(Alarm_Label)"控件报警提示控件.
通常用作全局报警提醒.
因此,最好把该控件放置在主窗体里.
当没有报警时,该控件是隐藏的.
深圳市左客信息科技有限公司12跟设备有关的属性:报警记录:当报警发生或清除时,记录保存成文件.
使用:是否保存.
文件夹路径:保存文件的路径.
这是一个相对路径设置.
文件名前缀:文件名称前面添加的内容.
文件时长:即多久生成一个新文件保存记录.
比如,"日"为每天生成一个文件保存记录.
"无限"为所有记录都保存到同一文件中.
导出文件:把故障信息集合里的内容导出为.
CSV文件.
导入文件:把.
CSV文件内容导入到故障信息集合里.
建议导入文件前,先导出文件,熟悉文件的格式后再按规则改写其他内容,然后再导入.
交替间隔:当多个故障信息发生时,指定多少秒轮流显示其他故障信息.
当为0时,将不轮流显示其他故障信息.
闪烁显示:是否闪烁地显示故障信息.
故障信息集合:编辑故障条目.
如下图:通过"添加按钮"可以添加若干个故障条目.

设备变量:指定要访问的设备变量.
报警显示内容:当条件满足时显示的内容.
触发条件:设置报警发生的条件.
跟设备有关的事件:Alarm:当故障发生时引发的事件.
Clear:所有报警清除时引发的事件.
ElementStatusSwitch:任何一个报警条目状态发生改变时引发的事件.
3.
7"画面切换按钮(Switch_Form)"控件方便在多个画面中来回切换显示.
跟设备有关的属性:新窗体名称:指定要打开的窗体名称.
打开模式:指定以何种方式打开新窗体.
切换模式:以子窗体的方式打开指定窗体.
弹出模式:以对话框的方式打开指定窗体.
权限值:打开新窗体所需要的权限.
权限值越高,权限越大,高权限值的用户可以打开底权限设置.
0为无需任何权限.
容器名称:打开模式为"切换模式"有效.
打开的新窗体放置在指定的Panel容器中.
如果没有指定容器名称,则以所在窗体的母窗体为母窗体,新开的窗体为子窗体.

自动弹出:指定当画面切换按钮加载后是否自动打开指定窗体.
深圳市左客信息科技有限公司133.
8"选择框(Bit_CheckBox)"控件以选择框的方式监控位设备变量跟设备有关的属性:设备操作变量:指定操作的设备变量(位类型).
设备监视变量:指定访问的设备变量(位类型).
弹出确认窗口:指定操作时是否弹出确认窗口.
3.
9"多功能组合框(Number_ComboBox)"控件以组合框的方式监控设备变量.
跟设备有关的属性:操作变量:指定操作的设备变量.
监视变量:指定访问的设备变量.
弹出确认窗口:指定操作时是否弹出确认窗口.
配对方式:组合框与设备变量值的配对方式.
True为组合框索引值跟设备值配对,false为组合框内容与设置值配对.
3.
10"弹出窗体(Pop_Form)"控件当满足某一条件时,自动弹出对话框.
建议把该控件放置在主窗体中.
当程序运行后,控件将自动隐藏.
如果把控件放置在没有打开的窗体上,则无效.
跟设备有关的属性:设备变量:指定访问的设备变量.
弹出窗口集合:设置条件及打开窗体名称条目.
如下图:窗体名称:指定打开的窗体名称.
如果为空,则不动作.
当设备变量值为对应的索引号时,该索引号对应的条目将其作用.
3.
11"进度条(Number_ProgressBar)"控件以进度条的方式显示设备变量值.
跟设备有关的属性:设备变量:指定访问的设备变量.
深圳市左客信息科技有限公司143.
12"实时曲线图表(RealTime_Chart)"控件以图表的方式显示多个设备变量值.
每一个变量值对应一条曲线.
跟设备有关的属性:刷新时间:指定曲线的刷新时间.
设备变量集合:定义多条曲线.
如下图:每一个条目对应一条曲线.
3.
13"饼图(Pie_Chart)"控件以分割饼的方式显示多个设备变量值相对应的比例.
3.
14"步序显示(Show_Info)"控件把设备变量值对应一组文本显示在控件上.
运行时,双击该控件,将弹出所有发送过的状态信息.

跟设备有关的属性:步序编辑文件名:编辑可执行文件目录下的"步序编辑.
txt"文件可进行信息单元编辑,避免重新修改程序的麻烦!
设置变量:指定访问的设备变量.
停留信息数:控件上面最多显示的信息数量.
最小为1.
状态保存:保存发生的状态.
使用:是否使用该功能.
文件夹路径:保存文件的路径.
这是一个相对路径设置.
文件名前缀:文件名称前面添加的内容.
文件时长:即多久生成一个新文件保存记录.
比如,"日"为每天生成一个文件保存记录.
"无限"为所有记录都保存到同一文件中.
最新置顶:当设置多个停留信息时,指定信息的排列秩序.
True为最近发生的信息显示在最前面.
信息单元编辑:当设备变量为对应的值时,控件将显示相对应的内容.
3.
15"多图片显示(Show_Picture)"控件继承Picture控件,把设备变量值对应一组图片显示在控件上.
跟设备有关的属性:外观属性展示类:把设备变量值跟一个控件的外观属性对应起来的类.
深圳市左客信息科技有限公司15设备变量:指定访问的设备变量.
数字对应属性集合:如下图:当条件满足时,控件的外观将展示相对应的设置.
背景颜色:指定控件的背景颜色.
触发条件:指定触发条件.
图片:指定要显示的图片.
文本显示:指定要显示的文本内容.
3.
16"多文本显示(Show_Text)"控件继承Label控件,把设备变量值对应一组文本显示在控件上.
3.
17"高级设备单元操作(Variable_Base)"控件通过代码的方式异步监控设备变量.
运行时控件自动隐藏.
异步访问设备变量:不管读取成功与否,都将自动运行pro回调函数.
如果回调函数的参数为空,则读取不成功.
否则为读取的值.
pro回调函数也可为空.
//////异步读取设备变量的值//////指定设备变量名称,比如:"Device\d5"///回调函数,回调函数原型voidpro(stringvalue)///publicvoidAsynReadVariable(stringVariableName,CallBackpro=null)异步操作设备变量:跟上面的用法类似.
//////异步操作设备变量的值//////指定设备变量名称,比如:"Device\d5"///指定写入的值///回调函数,回调函数原型voidpro(stringvalue)///publicvoidAsynWriteVariable(stringVariableName,stringValue,CallBackpro)深圳市左客信息科技有限公司163.
18"高级设备数据存储(EventPackageCtl)"控件配合PLC程序,通过事件包的方式自动存储相关数据,是一种可靠,有效地数据存储方式.

3.
19"关闭按钮(Close_Button)"控件关闭程序按钮控件.
3.
20"UDP/IP远程接口(Remote_Interface)"控件提供UDP/IP远程监控设备接口.
读写指令格式如下:读指令:设备名称写指令:设备名称,值读写指令的回应:设备名称,值,错误代码读写成功的话,错误代码为0.
否则为非零跟设备有关的属性:端口号:UDP/IP服务器的端口号.
跟设备有关的事件:ReceivedCommand:收到一个远程命令时引发的事件.
可用该事件把远程命令转换成标准命令.

SendingRespond:回应一个远程命令时引发的事件.
可用该事件把标准响应数据转换成用户格式.