syx点菜器开发指南

1、北京食苑星技术有限公司点菜器开发指南文件包开发包所包括文件 Wx.exe 驱动程序，以下简称为wx TXT 文件夹 放置供下载及交换用文本的目录，目录名称固定为TXT开发指南 .DOC 文本文件 Delphi6 范例目录 VB6 范例目录接口程序开发原理：我们说接口程序的开发原理是基于文本+消息机制的。文本是说要用到文本文件的读和写，消息是说要用到Windows 窗口消息的发与收。Windows系统允许不同的窗口或进程间使用消息交换数据，消息发送时可以带四个参数，第一个参数叫接收窗口句柄，也就是说是Windows 给接受者分配的一个编号；第二个参数是类型标志，是用来给各种消息做分类的，比如说按

2、键类为10，窗口放大缩小及关闭为 16，在我们系统中约定WX 与接口通信的消息固定为十进制的1280（十六进制0x500 ）；第三和第四个都是你可以指定的参数，不过在我们系统中第三个固定为0，我们只用第四个参数来区分消息，我们管它也叫消息类型。Delphi 中发送消息的函数：PostMessage(ToHandle,1280,0,Msg.LParam)VB 中发送消息的函数：PostMessage(ToHandle, 1280, 0, ByVal lParam&)PB 中发送消息的函数send(ToHandle,1280,0,1)在 Delphi 中关闭 WX ： PostMessage(To

3、Handle,16,0,0)接口程序接收消息类似中断或事件的概念，也就是说消息事件发生了，就会自动执行消息的处理过程，这一点不同的语言区别比较大。Delphi 中是声明一个消息处理过程：Procedure OnMessage (var Msg :TMessage); message WM_USER; 其中的 WMA_InterPro 为常数 =1280VB 中比较复杂，请参考范例。PB 中是窗口的OTHER 事件里进行消息判断。点菜发送功能过程：1 在点菜机上按发送后，WX 将接收到的数据写到T1.TXT 中，并发送一消息给接口。2 消息自动激活了接口中的消息处理过程，消息参数1=1280 说

4、明确实是来自WX 的消息，参数 2=1 代表是来自基站1 的，接口程序去读T1.TXT 文件 ,其中的请求类型码为“ DC ”，则转点菜处理函数。3 处理完毕后，写处理结果或提示到R1.TXT 文件，并发一消息给WX 。4 WX自动去读R1.TXT ，并把此文件内容显示到点菜机屏幕上。如果等待不到接口回A D ：北京市海淀区北三环中路36 号 12 楼 2 层TEL ：01082086497Email:LiLi_FAX ：17北京食苑星技术有限公司送的消息， WX 等待时间可

5、由用户在 dcpathfile.ini 文件中进行设置， 如超过设置时间，会放弃此次操作，继续处理下一条信息。建立消息连接：从上面的描述就可以看出来，建立消息连接联结首先是要得到的窗口句柄，包括自己的和对方的。建立消息连接就是程序和软件互相要得到对方的窗口句柄。程序的窗口句柄通过运行接口软件时作为参数告知软件，而软件在收到后马上把自己的一个窗口句柄作为消息(程序与软件发送的所有消息编号：$0500, )的 LParam 发送给程序。（ 如：WM_USER= $0500; ）实现方法如下：第一：程序调用在程序启动是用API 函数调用wx.exe 程序。如例：ShellExecute(Handle

6、,Pchar(Open),Wx.exe, Pchar(Inttostr(Handle) ),SW_SHOW);红色标记为主程序Handle。第二：消息处理过程定义消息处理函数。如例(以 Delphi为例 )：procedure OnMessage(var Msg : TMessage);message WM_USER; beginif WX_Handle = 0 then / 表示两程序第一次进行通话beginWX_Handle := Msg.LParam;/Wx 的窗口句柄 Handle 通过 LParam 参数传递过来 .并赋值给 WX_Handle 变量end elsebegin/ 用户

7、可以处理T1.txt文件。并根据数据协议，进行相关处理。/ 处理完成后，通过下面的函数通知WXpostMessage(WX_Handle,WM_USER,Handle,Handle);end;end;说明 ： WX_Handle 为全局变量，初始值为 0，当 WX_Handle=0 时，表示程序和 Wx 第一次通话。 并把 Msg.LParam 值赋给 WX_Handle.( Msg.LParam 为 Wx 程序的 Handle).否则进行数据处理。处理完成后调用 postMessage(WX_Handle ,WM_USER,Handle,Handle); 函数通知 Wx.exe.第三：程序关

8、闭在程序关闭接口程序时给Wx.exe 发送参数16 的消息。如：postMessage(WX_Handle ,WM_USER, 16,16);A D ：北京市海淀区北三环中路36 号 12 楼 2 层TEL ：01082086497Email:LiLi_FAX ：17北京食苑星技术有限公司第四：初始化设置基础数据：在与wx 同路径下要有一TXT 文件夹，文件夹里存储下载文件，数据交换文件（ T1.txt ， R1.txt ），以及协议文件1下载文件： 菜品表 .txt 、客户

9、要求表 .txt 、退菜理由表 .txt，菜品套餐表 .txt 、菜品套餐内容表 .txt、菜品类别表 .txt注意： 、 所有下载数据字段间无空格。但当字段不足指定长度时应该补空格，所有名称类字段应该在尾部补空格， 也就是说左对齐。 所有金额类字段应该在头部补空格， 也就是说右对齐，并带两位小数点。 所有编码类字段应该在头部补 0，也就是说左对齐。2数据交换文件：T1.txt 、 R1.txt3协议文件：Rec.rtp、 py.txt 、 SheProcess下载文件格式1 菜品表 .txt格式：菜品编号 （ 5 位）、类别号（ 2 位）、中文名称 （ 20 位）、单价（ 9 位）、单位（

10、4 位），重量单位（ 4 位）、需要确认重量否（1 位）、制作要求（ 45 位）、拼音编码（ 10 位）说明：除单价外所有数据均为左对齐“编号”不足五位时前面写零“单价”为两位小数非称重类菜品“重量单位”同“单位”“需要确认重量否”在不需要确认重量时写0，否则写1“制作要求”为三位，每个菜品最多可以指定15 个制作要求，如：001002005 代表三个制作要求，编号分别是001、 002、 005，此处制作要求为与菜品相关联的制作要求，可以按菜品指定，以便在录入菜品时直接弹出供选择。如果你的餐饮软件暂时不方便实现，此处可以填45 个空格。菜品编号和类别号均为数字，不支持字母；拼音编码必须是大写

11、字母;2 客户要求表 .txt格式：编号（3 位）、客户要求名称（20 位）3 退菜理由表 .txt格式：编号（2 位）、原因名称（20 位）菜品套餐表.txt格式：套餐编号（位）、套餐名称（20 位）菜品套餐内容表.txt格式：套餐编号 (2 位 )、菜品编号 (5 位 )、数量 (9 位 )、单价 (9 位 ) 、单位 (4 位)、缺省选中标志 (1 位)、套餐菜组号 (2 位 )说明：按套餐编号+套餐菜组号排序,并且同组菜品首先列出缺省选中标记=1 的点套餐的时候，缺省显示“缺省选中标志”为1 的套餐明细菜品类别表.txt格式：菜品类别（位）、类别名称（20 位）A D ：北京市海淀区北

12、三环中路36 号 12 楼 2 层TEL ：01082086497Email:LiLi_FAX ：17北京食苑星技术有限公司下载文件示例请参照开发包下TXT 文件夹交换数据用由 WX传送到程序的数据文件为：T1.TXT由程序传送到WX的数据文件为：R1.TXT请求文件和返回文件均为多行的文本文件，第一行固定为一个请求类型编码和一个点菜机编号；信息提示类内容显示：一行10 个汉字，一屏7 行; 以美观为原则，其内容开发商可以自己随意更改。以上文件的字段间没有空格。以上文件每次只

13、可能存在一条记录，每次使用前都会删除原来的内容。多点菜机同时发出请求时由WX进行排队处理，接口程序不需考虑请求同时到来的问题。请求类型码：登录 (DL) 、开台 (KT) 、换台 (HT) 、并台 (BT) 、撤台 (CT) 、点菜 (DC) 、重量确认（ ZLQR ）、临时菜（ JC）、沽清（ GQ ）请求结账 (DYYJ) 、 退菜 (TC) 、勾挑 (GT) 、整桌催菜 (ZZCC) 、按菜品催菜 (CPCC) 、按菜类催菜（ CLCC ）、帐单查询 (ZDCX) 、空闲餐台汇总 (KXHZ)按台号查空闲(THKX) 、预订信息汇总(YDHZ) 、按台号查预订(THYD)按类别查空闲餐台

14、( LBKX ) 、修改台头（ XGTT）1、 登录请求格式：类型码（4 字节）、点菜机号（ 3 字节）机器设备号（ 10 字节）、工号（ 4 字节）、密码（ 8 字节）示例： DL100SYX0000010 001001注意：机器设备号是手持出厂设置，工号密码，不足位数补空格返回内容：类型码（4 字节）、点菜机号（ 3 字节）是否成功标记（0 不成功， 1 成功）示例： DL1001 张三2、开台请求格式：类型码（4 字节）、点菜机号（ 3 字节）台号（ 4 字节）、客人数量（ 2 字节）、服务员数（ 5 字节）示例： KT1000011001返回内容：类型码（4 字节）、点菜机号（ 3 字

15、节）信息提示示例： KT1001 台开台成功！3、 并台请求格式：类型码（原台号（4 字节）、点菜机号（ 3 字节）7 字节）、并到台台号（7 字节）示例： BT100001002A D ：北京市海淀区北三环中路36 号 12 楼 2 层TEL ：01082086497FAX ：17Email:LiLi_北京食苑星技术有限公司返回内容：类型码（4 字节）、点菜机号（ 3 字节）信息提示示例： BT100001 台并到 002 台成功！4、 换台请求格式：类型码（4 字节）、点菜机号（ 3 字节）原台号（ 7 字节）、

16、换到台台号（7 字节）示例： HT100003004返回内容：类型码（4 字节）、点菜机号（ 3 字节）信息提示示例： HT100003 台换到 004 台成功！5、 撤台请求格式：类型码（4 字节）、点菜机号（ 3 字节）被撤台号（ 7 字节）示例： CT100005返回内容：类型码（4 字节）、点菜机号（ 3 字节）信息提示示例： CT1005 台撤台成功！6、 点菜请求格式：类型码（4 字节）、点菜机号（ 3 字节）台号或账单号（7 字节）、空格（ 10 字节）、整单备注（ 12 字节）、空格（ 4 字节）、时间（ 8 字节）台号或账单号（7 字节）、菜号（ 5 字节）、数量（ 4 字节

17、）、制作方法（ 12 字节）、套餐号（ 2 字节）、等叫标记（ 1 字节）、时间（ 8 字节）、只数（ 4 字节）、客人数（ 4 字节）、示例： DC10000600100200300407:08:0800601001 100100201 ! 07:08:08 1300601002 1007:08:08 1300601003 1.507:08:08 13注意： 制作方法支持编码或汉字，不支持编码和汉字混编套餐号和等叫标记不空格时间为此单打包发射时间，此时间是唯一的，可以用来判断是否重单点菜机收到返回信息为“点菜成功”时，点菜器会自动清除本单信息返回内容：类型码（4 字节）、点菜机号（ 3 字节

18、）信息提示示例： DC100A D ：北京市海淀区北三环中路36 号 12 楼 2 层TEL ：01082086497FAX ：17Email:LiLi_北京食苑星技术有限公司点菜成功！ 006 台7、 整桌催菜请求格式：类型码（4 字节）、点菜机号（ 3 字节）台号（ 7 字节）示例： ZZCC 100005返回内容：类型码（4 字节）、点菜机号（ 3 字节）信息提示示例： ZZCC005 台催菜成功！8、 按菜品催菜请求格式：类型码（4 字节）、点菜机号（ 3 字节）台号（ 7 字节）、菜号（ 5 字节）示例：

19、CPCC10000501001返回内容：类型码（4 字节）、点菜机号（ 3 字节）信息提示示例： CPCC100005 台 01001 催菜成功！9、 按菜类催菜请求格式：类型码（4 字节）、点菜机号（ 3 字节）台号（ 7 字节）、菜类编号（ 8 字节）示例： CLCC10000501返回内容：类型码（4 字节）、点菜机号（ 3 字节）信息提示示例： CLCC100005 台 01 类菜催菜成功！10、退菜请求格式：类型码（4 字节）、点菜机号（ 3 字节）台号（ 7 字节）、菜号（ 10 字节）、数量（4 字节）、单位（4 字节）、退菜理由（10 字节）示例： TC100005010011

20、01返回内容：类型码（4 字节）、点菜机号（3 字节）信息提示示例： TC1005 退菜成功！A D ：北京市海淀区北三环中路36 号 12 楼 2 层TEL ：01082086497FAX ：17Email:LiLi_北京食苑星技术有限公司11、空闲台总汇请求格式：类型码（4 字节）、点菜机号（ 3 字节）被撤台号（ 7 字节）示例： KXHZ100返回内容：类型码（4 字节）、点菜机号（ 3 字节）信息提示示例： KXHZ100一层 8 台、 10 台二层 9 台、 23 台三层芙蓉间12、按台号查空闲请求格式：

21、类型码（4 字节）、点菜机号（ 3 字节）台号（ 7 字节）示例： THKX100005返回内容：类型码（4 字节）、点菜机号（ 3 字节）信息提示示例： THKX1005 台被占用！13、预定信息总汇请求格式：类型码（4 字节）、点菜机号（ 3 字节）示例： YDHZ100返回内容：类型码（4 字节）、点菜机号（ 3 字节）信息提示示例： YDHZ10010 台已被预定！14、按台号查预定请求格式：类型码（4 字节）、点菜机号（ 3 字节）被撤台号（ 7 字节）示例： THYD100005返回内容：类型码（4 字节）、点菜机号（ 3 字节）信息提示示例： THYD100005 台已被预定！1

22、5、请求结账请求格式：类型码（4 字节）、点菜机号（3 字节）台号（ 7 字节）A D ：北京市海淀区北三环中路36 号 12 楼 2 层TEL ：01082086497FAX ：17Email:LiLi_北京食苑星技术有限公司示例： DYYJ100005返回内容：类型码（4 字节）、点菜机号（ 3 字节）信息提示示例： DYYJ1005 台请求结账成功！16、划菜请求格式：类型码（4 字节）、点菜机号（ 3 字节）台号（ 7 字节）、菜号（ 5 字节）示例： GT10000501001返回内容：类型码（4 字节）、

23、点菜机号（ 3 字节）信息提示示例： GT100005 台 01001 菜已上！17、重量确认请求格式：类型码（4 字节）、点菜机号（ 3 字节）台号（ 7 字节）、菜号（ 5 字节）、流水号（ 10 字节）、重量（ 8 字节）示例： ZZQR100005010012.5返回内容：类型码（4 字节）、点菜机号（ 3 字节）信息提示示例： ZZQR100005 台 01001 菜重量 2.5 斤18、查沽清请求格式：类型码（4 字节）、点菜机号（ 3 字节）示例： GQ100返回内容：类型码（4 字节）、点菜机号（ 3 字节）信息提示示例： GQ100已沽清菜号：01001、01002、 010

24、0319、调账单请求格式：类型码（4 字节）、点菜机号（3 字节）台号（ 7 字节）示例： ZDCX100005返回内容：类型码（4 字节）、点菜机号（3 字节）信息提示A D ：北京市海淀区北三环中路36 号 12 楼 2 层TEL ：01082086497FAX ：17Email:LiLi_北京食苑星技术有限公司示例： ZDCX100005 台：手撕带鱼酸辣蜇头尖椒跳水鸡酸辣小木耳基围虾川式刺身已上已退已上已上等叫20、修改台头请求格式：类型码（4 字节）、点菜机号（ 3 字节）台号（ 7 字节）、客人数（ 2

25、字节）、服务员号（ 5 字节）示例： XGTT1000050100135返回内容：类型码（4 字节）、点菜机号（ 3 字节）信息提示示例： XGTT1005 台修改台头成功！21、临时菜请求格式：类型码（4 字节）、点菜机号（ 3 字节）台号（ 7 字节）、菜号（ 5 字节）、菜品单位（ 4 字节）、菜品名称（ 14 字节）、数量（ 4 字节）、价格（ 4 字节）、等叫标记（ 1 字节）、制作方法（ 12 字节）示例： JC10000501999 盘西芹百合120!返回内容：类型码（4 字节）、点菜机号（ 3 字节）信息提示示例： JC100点菜成功！5 台临时菜西芹百合22、按类别查空闲请求

26、格式：类型码（4 字节）、点菜机号（ 3 字节）餐台类别号（ 2 字节）示例： LBKX10001返回内容：类型码（4 字节）、点菜机号（ 3 字节）信息提示示例： LBKX100一层散台空闲餐台：001、006、 118A D ：北京市海淀区北三环中路36 号 12 楼 2 层TEL ：01082086497FAX ：17Email:LiLi_北京食苑星技术有限公司基站频道必须与手持 频道一致 时方可通讯 !基站设置方法见wx 设置 ;手持设置方法 :在手持主界面按 两次 #键 ,密码 779 进入手持频道设置 ;

27、 wx 的设置1、 点击参数设置1.1、路径设置中自动指向数据交换文件T1.txt 、 R1.txt 位置；A D ：北京市海淀区北三环中路36 号 12 楼 2 层TEL ：01082086497Email:LiLi_FAX ：17北京食苑星技术有限公司1.2、延时设置：wx 在接收到手持数据后写t1 文件，发消息给PC 端接口软件，等待接口软件处理（即等待PC 端接口软件发来的消息）；在设置的延时内，wx 没有收到接口软件发来的消息，即给手持返回固定信息“数据服务器未向应

28、，请联系管理员。PC 端PC 端。”；1.3、选择测试可以不连接PC 点菜程序，进行基站和手持之间的通讯；1.4、选择通讯模式；建议使用消息模式1.5、对基站以及基站下的手持进行设置；基站号由 001 开始设置，手持号范围 000-191，同一家店不许有相同的手持编号， 手持编号输入后按保存按钮， 在图框中显示后表示设置手持后成功。所有设置完成按保存按钮，然后退出2、点击基站设置：设置基站的频道以及给基站对时基站频道表CH#中心频率 HMzCH#中心频率 HMzCH#中心频率 HMzCH#中心频率 HMz1414.57017422.55733430.54449438.5322414.99518

29、423.04934430.87550439.0583415.56219423.50235431.49451439.5374416.07820424.07036432.01052440.0065416.41321424.52337432.57753440.5166417.02822425.01538433.00254440.9897417.46623425.42639433.50555441.4808417.99324425.99840434.02656442.2189418.52025426.41941434.31857442.74510418.96526426.94642434.845584

30、43.03711419.48527427.47243435.51659443.44712420.10028427.99944435.97960444.06113420.62629428.52545436.48461444.48714420.91930429.05246436.95262445.05415421.44031429.48347437.47863445.495A D ：北京市海淀区北三环中路36 号 12 楼 2 层TEL ：01082086497FAX ：17Email:LiLi_北京食苑星技术有限公司1

31、6421.94332429.93048438.00564445.904设置成功wx 显示图基站安装、基站安装使用1.1、基站的功能：基站负责手持和PC 之间的数据传递。手持的点餐数据通过无线方式传送给基站，基站将手持数据以有线方式传送给PC，同样 PC 将需要告知手持的数据通过基站传送给手持。基站的另一功能是手持数据更新，即手持下载。点击“菜单下载”按钮后，点击开始下载，基站进入下载状态，在手持提示全部更新完毕后，点击“停止下载”按钮，基站进入正常通讯状态。1.2 、基站硬件说明以及示意图指示灯说明：、 Power：电源指示灯。打开电源开关后，此灯常亮；、 TX：无线信号发送指示灯。发送无线信

32、号时，此灯亮；、 RX：无线信号接收指示灯。接收无线信号时，此灯亮；、 Net ：CPU工作状态指示灯。基站工作正常时，此灯在闪烁状态；发送或接收信号时此灯的闪烁频率有变化属正常现象；、 CH1、 CH2、CH3、 CH4：四灯组成频段指示灯。随机附件： DB9串口通讯电缆线数量 :一件直流电源数量：一件无线天线数量 :一件A D ：北京市海淀区北三环中路36 号 12 楼 2 层TEL ：01082086497Email:LiLi_FAX ：17北京食苑星技术有限公司1.3

33、 、硬件的安装以及连接注意事项：硬件的安装：无线基站采用的是标准的PC机串口连接方式。随机带附件DB9串口通讯电缆线， 一头是孔插 PC机串口， 另一头是针插无线基站。接通随机附件直流电源和无线天线后，打开 PC机和无线基站。注意：无线基站与PC连接的串口要与配置串口一致！基站的两个RJ45口为 485接口。 485接口的优点是传输距离远。可以多台设备并联 ,基站与基站之间使用标准网线连接即可。使用此接口还需另加一台485接口转接设备。在 PC和基站距离比较远，DB9串口线的长度不够时，可以将串口线延长，延长线的制作请参照DB9串口线延长方法 PC没有串口时可以使用 USB-COM连接注意事项

34、：、 设备连接时为了防止 PC机和无线基站两设备接地不良， 造成的压差过大埙坏设备。请在关机状态下连接设备。、为了提高无线接收效果，天线放置高度距地面不应低于 1.5 米。、无线基站采用的是 DC9V供电，请使用本机随机附件直流电源供电。禁止使用其它电源，避免电压过高埙坏设备。、天线有匹配问题，请使用随机天线。不要用其它天线代替。基站硬件示意图DB9串口线延长方法：将 DB9 串口线从中间剪断；将剪断处两侧的外皮剥开；将其中的黑色、蓝色、灰色、白色四线剪断不用；将棕色、红色、橙色、黄色、绿色五线用网线将线色对应焊接，或用压线子连接即可。A D ：北京市海淀区北三环中路36 号 12 楼 2 层

35、TEL ：01082086497Email:LiLi_FAX ：17北京食苑星技术有限公司注意：延长网线不应长于10 米；使用RS-232/RS-485 转换器；转换器兼容RS-232、 RS-485 标准，能够将单端的RS-232 信号转换平衡差分的RS-485 信号。具体连接方式如下：将转换器和水晶头按照上图位置摆放（注意水晶头弹片朝下，入线口朝下）；将网线中的橙色、 蓝色、棕色按照图示连接；水晶头从左数第三脚连接橙色，第四脚连接蓝色，第五脚连接棕色。 用此种方式可以延长 100米。延长线完成后，将转换器连接到PC 的串口上，水晶头连接在基站的485 接口上 。附： RS-232/RS-485 转换器的三个接头从左到右为A、B、GND,分别对