Crimson 2 使用手册 CN
Crimson 2
使用手册
中文6.0 版
2005-6-28
红狮工控2003年出版
我司保留对此手册的所有权利.
手册内的所有信息是完整有效的，但我司会对其修订而事先不通知使用者。本手册不具有保证书，同时也不代表我司的承诺。手册中引用的公司名，人名和数据除特别说明均为虚构。除非具有红狮工控的书面许可，手册中的所有内容均不得以任何形式节录、转载。
所有的商标权益均为其持有者保留。
此手册由Mike Granby和Jesse Benefiel编写。
6.0版中文手册是根据6.0版英文手册翻译的。
内容索引
入门 (1)
系统要求 (1)
安装软件： (1)
版本更新 (1)
安装USB驱动程序： (2)
Crimson软件基础 (3)
主页面图标： (3)
通讯： (3)
数据变量： (3)
用户界面 (4)
编程 (4)
数据记录 (4)
网络服务器： (4)
杂项： (4)
使用即时帮助： (5)
运用数据库： (5)
下载文件至人机界面： (5)
设置连接： (6)
发送数据库文件： (6)
提取数据库文件 (7)
安装闪存卡： (7)
传送时间： (8)
通过CF卡更新数据库文件： (8)
GURU MEDITATION代码： (9)
设置通讯 (11)
串行口的使用： (11)
选择通讯协议： (12)
协议选项： (12)
连接外部设备： (13)
以太网口设置： (13)
IP 地址： (14)
物理层： (14)
协议选择： (14)
从站协议： (15)
选择协议： (15)
增加网关块： (16)
向数据块中添加项目： (16)
访问单独的位： (17)
协议转换： (17)
主站和从站： (17)
主站和主站： (18)
哪种方法是对的呢？ (18)
EDICT 用户须知： (19)
设置数据标签 (21)
关于数据标签： (21)
数据标签的种类： (21)
数据标签种类： (21)
数据标签的类型： (22)
为什么需要使用数据标签？ (22)
创建标签： (23)
编辑标签： (23)
编辑属性： (24)
表达式属性： (24)
可译字符串： (25)
编辑标志型标签： (25)
数据表（变量类） (26)
数据表（公式类） (27)
数据表（数组类） (27)
格式表： (28)
报警表： (28)
触发表： (30)
编辑整数型标签： (30)
数据表（变量类） (30)
数据表（公式类） (32)
数据表（数组型） (32)
格式表： (33)
报警表： (34)
触发属性： (35)
编辑多重状态变量： (36)
数据表（变量型） (36)
数据表（公式型） (36)
数据表（数组） (37)
格式表： (37)
报警表： (38)
触发表： (38)
编辑实数型标签： (39)
编辑字符串型标签： (39)
数据表（变量类） (39)
数据表（公式类） (40)
数据表（数组类）： (40)
格式表： (41)
超过两个报警： (42)
Edict用户须知 (42)
设置用户界面: (43)
显示控制: (43)
使用页面列表： (44)
显示编辑工具盒： (44)
绘图工具盒： (44)
填充格式工具盒： (44)
线型格式工具盒： (44)
文本格式工具盒： (44)
前景工具盒： (45)
背景工具盒： (45)
添加显示元件： (45)
自动对齐： (45)
键盘选项： (46)
锁定插入模式： (46)
选择元件： (46)
移动和缩放： (47)
重排元件： (47)
编辑元件： (48)
元件描述： (48)
直线元件： (48)
简单几何元件： (48)
油箱元件： (49)
基本液柱图形元件： (49)
固定文本元件： (50)
自动标签元件： (51)
标签文本元件： (51)
编辑底层的标签： (54)
日期/时间元件： (54)
多功能液柱元件： (56)
系统元件： (57)
定义页面属性: (58)
设定系统动作： (59)
设定按键功能： (59)
动作使能： (60)
动作描述： (60)
翻页动作： (60)
按钮动作： (61)
更改整数值动作： (61)
递增/减整数值动作： (62)
播放乐曲动作： (62)
用户自定义动作： (63)
屏蔽缺省动作： (63)
转换语言： (64)
高级设置： (64)
动作处理： (64)
Edict使用者须知 (65)
编写程序 (67)
使用程序列表： (67)
编辑程序： (67)
程序属性： (67)
加入注释： (69)
返回数据值： (69)
注意陷阱： (69)
编程技巧： (70)
多个动作： (70)
IF语句： (70)
Switch 语句： (71)
局部变量: (72)
循环结构： (72)
Edict用户须知 (74)
设置数据记录 (75)
创建数据记录: (75)
使用记录列表： (75)
数据记录属性： (76)
记录文件存储： (76)
数据记录过程： (77)
访问数据记录文件： (78)
使用WebSync： (78)
WebSync句法： (78)
Switch选项： (78)
用法示例： (79)
Edict用户须知 (79)
设置Web Server (81)
Web Server 属性： (81)
添加网页 (82)
使用自定义网页： (83)
创建网址： (83)
嵌入数据： (83)
展开网址： (83)
CF卡的访问： (83)
Web Server样板： (84)
书写表达式 (89)
数据值： (89)
常量： (89)
标签值： (90)
通讯映射： (91)
简单算数： (91)
操作数的优先级： (91)
比较数值： (92)
测试位： (92)
多重条件： (93)
挑选数值： (93)
位操作： (94)
与，或和异或： (94)
移位运算符： (94)
位非： (94)
数组的索引： (95)
字符串索引： (95)
字符串相加： (95)
调用程序： (95)
使用函数： (95)
优先级总结： (96)
Edict用户须知 (96)
编写动作 (97)
更换页面： (97)
更改数值： (97)
简单赋值： (97)
复合赋值： (97)
递增和递减： (97)
更改位值： (97)
运行程序： (98)
使用函数： (98)
运算符优先级： (98)
Edict用户须知 (98)
使用原始通讯口 (99)
设置串行通讯口： (99)
设置TCP/IP口： (99)
读字符： (100)
读取一帧： (100)
发送数据： (101)
Edict用户须知 (101)
系统变量引用： (103)
系统变量的用途： (103)
DispUpdates (104)
DispContrast (105)
DispBrightness (106)
PI (107)
函数索引 (109)
Edict用户须知： (109)
ABS(Value) (110)
ACOS(Value) (111)
ASIN(Value) (112)
ATAN2(A, B) (114)
BEEP(Freq, Period) (115)
ClearEvents() (116)
CloseFile(File) (117)
CompactFlashEject() (118)
CompactFlashStatus() (119)
ControlDevice(Device, Enable) (120)
Copy(Dest, Src, Count) (121)
COS(Theta) (122)
CreateDirectory(Name) (123)
CreateFile(Name) (124)
DataToText(Data, Limit) (125)
Date(Y, M, D) (126)
DecToText(Data, Signed, Before, After, Leading, Group) (127)
Deg2Rad(Theta) (128)
DeleteDirectory(Name) (129)
DeleteFile(File) (130)
DevCtrl(Device, Function, Data) (131)
DisableDevice(Device) (132)
DispOff() (133)
DispOn() (134)
DrvCtrl(Port, Function, Data or Value???) (135)
EnableDevice(Device) (136)
Exp(Value) (137)
Exp10(Value) (138)
Fill(Element, Data, Count) (139)
Find(String, Char, Skip) (140)
FindFileFirst(Dir) (141)
FindFileNext() (142)
FormatCompactFlash() (143)
GetDate(Time) and Family (144)
GetInterfaceStatus(Interface) (145)
GetMonthDays(Y, M) (146)
GetNetGate(Port) (147)
GetNetID(Port) (148)
GetNetIP(Port) (149)
GetNetMask(Port) (150)
GetNow() (151)
GetNowDate() (152)
GetNowTime() (153)
GetUpDownData(Data, Limit) (154)
GetUpDownStep(Data, Limit) (155)
GotoPage(Name) (156)
GotoPrevious() (157)
HidePopup() (158)
IntToText(Data, Radix, Count) (159)
IsDeviceOnline(Device) (160)
Len(String) (162)
Log(Value) (163)
Log10(Value) (164)
MakeFloat(Value) (165)
MakeInt(Value) (166)
Max(A, B) (167)
Mean(Element, Count) (168)
Mid(String, Pos, Count) (169)
Min(A, B) (170)
MulDiv(A, B, C) (171)
MuteSiren() (172)
Nop() (173)
OpenFile(Name, Mode) (174)
Pi() (175)
PlayRTTTL(Tune) (176)
PopDev(Element, Count) (177)
PortClose(Port) (178)
PortInput(Port, Start, End, Timeout, Length) (179)
PortPrint(Port, String) (180)
PortRead(Port, Period) (181)
PortWrite(Port, Data) (182)
Power(Value, Power) (183)
Rad2Deg(Theta) (184)
Random(Range) (185)
ReadData(Data, Count) (186)
ReadFileLine(File) (187)
Right(String, Count) (188)
Scale(Data, R1, R2, E1, E2) (189)
SendMail(Rcpt, Subject, Body) (190)
Set(Tag, Value) (191)
SetLanguage(Code) (192)
SetNetConfig(Port, Addr, Mask, Gate) (193)
SetNow(Time) (194)
Sgn(Value) (195)
ShowMenu(Name) (196)
ShowPopup(Name) (197)
Sin(Theta) (198)
SirenOn() (199)
Sleep(Period) (200)
Sqrt(Value) (201)
StdDev(Element, Count) (202)
StopSystem() (203)
Strip(Text, Target) (204)
Sum(Element, Count) (205)
Tan(Theta) (206)
TextToAddr(Addr) (207)
TextToFloat(String) (208)
Time(H, M, S) (210)
WaitData(Data, Count, Time) (211)
WriteFileLine(File, Text) (212)
Crimson 2
使用手册
入门
欢迎使用Crimson 2软件----这是由红狮工控提供的最新系列人机界面的编程软件，Crimson提供一个快速简单的方法来操作G3系列人机界面的各种功能，同时又可使资深用户运用高端性能，如：Crimson独特的语言编程平台。
系统要求
Crimson 2对PC机的硬件要求：
? 奔腾级处理器按操作系统的要求
? 内存和硬盘空间按系统要求
? 约10MB的硬盘空间供软件安装使用
? 显示器分辨率最低800 X 600，建议使用256色以上。
? 一个RS232口或USB口供下载程序至G3人机界面。
Crimson 2可运行在Windows 95以上版本的系统。如用户希望使用G3人机界面提供的USB口，则必须使用Windows 98以上版本。如用户希望使用USB口远程访问G3人机界面的CF卡，我们建议用户使用Windows 2000或Windows XP。虽然Windows 98系统具备访问CF卡的功能，但较新版本的系统会提供更全面的功能，例如：当用户选择锁定CF卡时，可防止G3对CF卡的写操作，缩短运行时间。
安装软件：
如果你从红狮网站下载了Crimson 2 安装软件，直接执行所下载的文件，按指令安装。如果你使用光碟版的Crimson 2软件，请将安装盘放置在CDROM驱动器中，按指令执行。如果指令没有出现，你可能没有选择自动运行功能，你可在开始菜单的运行选项键入 x:\setup，回车后按指令安装，这里x 指你计算机中的CDROM驱动器名。
版本更新
如果你已接入互联网，可运行HELP菜单中的check for update….，Crimson 2会访问红狮公司网站，如果有更新版本的软件，将会自动下载和安装。
安装USB驱动程序：
当你的电脑第一次使用USB口接入G3人机界面，Windows会提示你选择设备的驱动程序，缺省的驱动程序位置是c:\Program File\Red Lion Controls\Crimson 2.0\Device。当硬件安装精灵出现，选择浏览选项，将安装精灵指向缺省位置或其他在安装软件时你指定的位置。正确地选择这一步是非常重要的，否则你必须在设备管理器中手动删除驱动程序，再重新安装。
Crimson软件基础
启动Crimson软件，请从开始菜单\程序\红狮控制文件夹\选择Crimson图标，Crimson主页面出现了，如下出现的图标是用来设置人机界面的不同功能和特性….
主页面中的前三个图标是最常用的基本功能应用，其余的图标提供了G3的高级功能，如编程、数据记录和网络服务器功能。
主页面图标：
本节将依次浏览各图标的基本功能：
通讯：
这个图标是用来设定G3的串行通讯口和以太网口的通讯协议。当通讯
口使用主站协议时（如：G3使用此协议向远程设备传输数据并从设备获
取数据反馈），用户可使用此图标设置一个或多个可以被访问的设备。
当使用从站设备时（如：G3使用此协议接收远端设备或系统的数据命令
并反馈相应数据），用户可用此图标规定哪些内部数据可被读取访问。用户也可使用此图标完成远端设备间的数据交换，也就是协议转换功能。
数据变量：
这个图标是用来设定可被远程设备访问的数据，以及用于存储内部信息
的数据。每个数据都规定了相应的各种属性，最基本的属性就是数据格
式，它是用来设定数据变量中的数据是以怎样形式显示在人机界面或网
页上的。当完成数据变量的定义后，无论在任何地方显示，用户都不必重复去设置这些参数了。更高级的数据变量属性还包括：报警---在数据变量指定的一些状态出现时发出；触发---在指定的状态出现时，执行相应的可编程的动作。
用户界面
此图标用于创建和编辑显示的页面，并设定人机界面的各按键的功能。
页面编辑器可以使用户显示各种的图形，我们称之为元件。无论是简单
的图形，如线条和矩形，或者是复杂的图形，都可以与特别的变量和表
达式相联系。通常这些元件使用规定的信息，这些信息是在变量创建时定义的，但这些信息是可以按需要随时更改。
编程
这个图标用来创建和编辑程序。它是用Crimson 2特有的类C语言来编
写的。这些程序可以运用系统中的数据来进行复杂的判断和数据运算，
它可以充分地扩展Crimson的功能，以保证在最复杂的应用要求下，也
可以轻松地处理。
数据记录
这个图标用来创建和编辑数据记录。它可以向G3的CF卡存储任意数量
的数据，数据最快可以每秒记录一次。数据是以CSV格式存储的，它可
以轻松地输入到各种应用程序中，如：Microsoft Excel。卡中的数据可
以用多种方式读取，可直接取出CF卡，或使用G3的USB接口与PC相连来读取，或使用Crimson的web server功能，通过以太网口来读取。
网络服务器：
这个图标用来设置Crimson的网络服务器功能，及创建和编辑网页。网
络服务器功能可以提供用多种途径远程访问G3。首先用户可以使用
Crimson的一个自动生成网页，网页可以包含各种变量列表，每个变量
均按照已规定的变量属性定义。其次用户可以使用第三方软件，如
Microsoft Frontpage，来设计一个自定义的网页，并使用一些特殊字符来命令Crimson插入动态变量。同时，用户可以使用Crimson2独特地远程访问和控制功能，它可以使用网络浏览器来浏览G3的显示和控制它的按键。网络服务器还可以用来访问数据记录器中的CSV文件。
杂项：
这是个保留图标，将来用来扩展功能。
使用即时帮助：
Crimson提供一个非常实用的功能，称为即时气泡帮助：
这个功能可以使用户浏览各个项目的相关帮助文件，如主页面中的各个图标，对话框和对话窗的各个项目等。它是用工具栏最右边的图标来控制的，可以被设定为三种模式：不显示---气泡帮助功能不启用；鼠标指向时显示---当鼠标指向特定项目并停留时将显示相应帮助；选择时显示---当选择特定项目后显示相应帮助。
运用数据库：
Crimson将所有关于人机界面的设置，存储在被称作数据库的文件中。此文件是以CD2为扩展名，尽管Windows Explore可能隐藏其缺省扩展名。Crimson的数据库文件与以往红狮公司的人机界面的设置文件不同，它是文本型文件，所以在意外损坏时非常容易修复。数据库文件可以通过File菜单下的各种命令操作，除Save Image命令外，其他命令与Windows的标准命令完全相同，无需多加解释，Save Image命令会在以后介绍。
下载文件至人机界面：
Crimson的数据库文件是通过Link菜单中的命令来下载文件至人机界面。文件的下载通常只需数秒钟，但如果Crimson需要更新人机界面的固件配置或该数据库文件是第一次下载到人机界面时，则需要花费较多时间。当第一次下载完成后，Crimson将使用一种称为增量下载的方式来更新文件，以保证只传输文件的被改动部分。这样数据库文件的更新只需数秒钟即可完成，大大缩短了开发时间和调试过程。
设置连接：
PC与G3人机界面间的编程连接可以通过RS-232串行口和USB接口两种方式完成。在下载程序前，用户需使用Link菜单下的Option命令，来选择正确的串行通讯口或可用的USB接口。
在使用USB接口之前，用户应确认G3的USB驱动程序已正确安装，为确信这一点，将G3连接至PC的USB口，如驱动程序未安装，则根据手册开始时的说明操作，然后打开操作系统中的设备管理器，展开USB图标，显示G3的图标，确信G3的图标上没有任何告警记号。如果有告警，则需删除设备，断开和重新连接G3，重新安装并验证你已正确地安装完毕。下面的示图分别地展示了典型的设备管理器中闪存卡的卸载和安装。
发送数据库文件：
一旦连接设置完成，数据库文件就可以通过Link-Send或Link-Update指令来下载。Send指令将传送整个文件，无论文件中的项目是否有更改。Update指令将仅传送有更改的项目，它会花费较少的时间。当Update下载中遇到任何问题，Update下载方式会自动转向完整传送方式。工具栏中的闪电图标和F9键是Update指令的快捷方式。
提取数据库文件
Link-Support Upload指令是用来设定当Crimson下载数据库文件至G3屏时，是否支持上载功能。支持上载会减慢下载速度，但当你丢失了你的数据库文件，你可以从G3屏中提取整个数据库文件。如果你没有设置支持上载功能，并且丢失了数据库文件，你将不得不重新编程。使用Link-Extract命令，你可以提取数据库文件，这个指令将上载文件，并提示你输入需存储的文件名，然后将打开文件。
安装闪存卡：
如果你通过USB端口连接到G3屏，你可以命令Crimson安装G3中的COMPACTFLASH卡作为Windows Explorer中的一个驱动器。你可以使用这一功能向卡中存储文件或是读取卡中Data logger 存储的文件信息。驱动器的安装和卸载是通过Link菜单中的Mount Flash和Dismount Flash指令完成的。一旦指令发出，G3屏会被复位，Windows会刷新相应的窗口以显示或隐藏CompactFlash驱动器。
注意：当安装CompactFlash卡时，会遇到一些告警：
? 当卡安装完毕后，当卡中的数据被更改时G3会周期性的通知PC。这就意味着PC和G3在数据记录操作中都会花费更长的时间。
? 如果你从PC向卡中写数据，G3将不能访问CF卡，直到Windows解除了对CF卡内容的锁定。这将会花费一分钟，并限制其间的数据记录操作和对自
定义网页的访问。Crimson会使用G3的RAM来保证不会丢失数据，但频繁
的写操作会使CF卡被锁定更长的时间，将会导致数据丢失。特别注意
Windows98会在不必要的情况下锁定CF卡，而Windows 2000 或XP会是
比较好的选择。
? 请不要通过 Window Explorer或Command提示符来格式化CF卡，因为Windows不能正确的锁定CF卡，格式化会导致CF卡操作不可靠和数据丢
失。正确的方法是通过Crimson中的Format Flash指令或用独立的CF卡适
配器用FAT16文件执行格式化。
传送时间：
Link-Send Time指令用来将G3中的时钟与PC中的时钟对时。对时前应先确认你的时钟是正确的。
通过CF卡更新数据库文件：
如果人机屏已安装在用户现场，你需要更新其中的数据库文件，Crimson允许你将数据库文件拷贝至CF卡，将卡发送到用户手中，用户可通过卡来直接载入数据库文件。这个过程是通过File菜单中的Save Image指令来完成的。
Save Image指令将创建一个以CDI为扩展名的Crimson数据库文件的印象文件，它同时将当前G3的固件信息复制在一个以BIN为扩展名的文件中，印象文件必须是以DBASE.CDI为文件名，它和BIN文件都必须放置在CF卡的根目录下，当更新人机屏时，首先断电，插入CF卡（存有两个文件），重新上电，G3的加载引导器首先检查是否需要更新设备固件，当此过程完成后， Crimson的实时应用程序将加载存储于卡上的数据库文件，整个过程就完成后，CF卡就可以被卸除或按需要保留。