syx点菜器开发指南要点

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

2、标志，是用来给各种消息做分类的，比如说按键类为10,窗口放大缩小及关闭 为16,在我们系统中约定 WX与接口通信的消息固定为十进制的1280 (十六进制0 x500); 第三和第四个都是你可以指定的参数，不过在我们系统中第三个固定为0，我们只用第四个 参数来区分消息，我们管它也叫消息类型。 Delphi 中发送消息的函数：PostMessage(ToHandle,1280,0,Msg.LParam) VB 中发送消息的函数：PostMessage(ToHandle, 1280, 0, ByVal lParam message WM_USER; 其中的 WMA_InterPro 为常数=1280

3、 VB中比较复杂，请参考范例。 PB中是窗口的OTHER事件里进行消息判断。 点菜发送功能过程： 1 .在点菜机上按发送后，WX将接收到的数据写到 T1.TXT中，并发送一消息给接口。 2 .消息自动激活了接口中的消息处理过程，消息参数1=1280说明确实是来自 WX的消 息，参数2=1代表是来自基站1的，接口程序去读 T1.TXT文件,其中的请求类型码为 “DC”，则转点菜处理函数。 3. 处理完毕后，写处理结果或提示到R1.TXT文件，并发一消息给 WX。 4. WX自动去读R1.TXT，并把此文件内容显示到点菜机屏幕上。如果等待不到接口回 送的消息，WX等待时间可由用户在 dcpathf

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

5、pen),Wx.exe, Pchar(lnttostr(Handle) ),SW_SHOW); 红色标记为主程序 Ha ndle。 第二：消息处理过程 定义消息处理函数。如例 (以Delphi为例): procedure OnM essage(var Msg : TMessage);message WM_USER; begin if WX_Ha ndle = 0 then /表示两程序第一次进行通话 begin WX_Handle := Msg.LParam;/Wx 的窗口句柄 Handle 通过 LParam 参数传 递过来.并赋值给WX_Handle变量 end else begin /用

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

7、三：程序关闭 在程序关闭接口程序时给Wx.exe发送参数16的消息。如： postMessage(WX_Handle ,WM_USER, 16,16); 第四：初始化设置 基础数据：在与 WX同路径下要有一 TXT文件夹，文件夹里存储下载文件，数据交换文件 （T1.txt，R1.txt），以及协议文件 1下载文件：菜品表.txt、客户要求表.txt、退菜理由表.txt,菜品套餐表.txt、菜品套餐内容 表.txt、菜品类别表.txt 注意：、所有下载数据字段间无空格。但当字段不足指定长度时应该补空格，所有名称类 字段应该在尾部补空格，也就是说左对齐。所有金额类字段应该在头部补空格，也就是说右

8、对齐，并带两位小数点。所有编码类字段应该在头部补0，也就是说左对齐。 2. 数据交换文件：T1.txt、R1.txt 3. 协议文件：Rec.rtp、py.txt、SheProcess 下载文件格式 1. 菜品表.txt 格式：菜品编号（5位）、类别号（2位）、中文名称（20位）、单价（9位）、单位（4位）， 重量单位（4位）、需要确认重量否（1位）、制作要求（45位）、拼音编码（10位） 说明：除单价外所有数据均为左对齐 “编号”不足五位时前面写零 “单价”为两位小数 非称重类菜品“重量单位”同“单位” “需要确认重量否”在不需要确认重量时写0，否则写1 “制作要求”为三位，每个菜品最多可以

9、指定15个制作要求，如：001002005代表三个制作要求， 编号分别是001、002、005,此处制作要求为与菜品相关联的制作要求，可以按菜品指定，以便在录入菜 品时直接弹岀供选择。如果你的餐饮软件暂时不方便实现，此处可以填45个空格。 菜品编号和类别号均为数字，不支持字母； 拼音编码必须是大写字母； 2. 客户要求表.txt 格式：编号（3位）、客户要求名称（20位） 3. 退菜理由表.txt 格式：编号（2位）、原因名称（20位） 4. 菜品套餐表.txt 格式：套餐编号（2位）、套餐名称（20位） 5 .菜品套餐内容表.txt 格式：套餐编号（2位）、菜品编号（5位）、数量（9位）、单

10、价（9位）、单位（4位）、缺省选 中标志（1位）、套餐菜组号（2位） 说明：按套餐编号+套餐菜组号排序，并且同组菜品首先列岀缺省选中标记 =1的 点套餐的时候，缺省显示“缺省选中标志”为1的套餐明细 6. 菜品类别表.txt 格式：菜品类别（2位）、类别名称（20位） 下载文件示例请参照开发包下TXT文件夹 交换数据用 由WX专送到程序的数据文件为： T1.TXT 由程序传送到 WX的数据文件为：R1.TXT 请求文件和返回文件均为多行的文本文件，第一行固定为一个请求类型编码和一个点菜机编号；信息 提示类内容显示：一行 10个汉字，一屏7行；以美观为原则，其内容开发商可以自己随意更改。 以上文

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

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

13、台开台成功！ 3、并台 请求格式：类型码（4字节）、点菜机号（3字节） 原台号（7字节）、并到台台号（7字节） 示例：BT 100 001 002 返回内容：类型码（4字节）、点菜机号（3字节） 信息提示 示例：BT 100 001台并到002台成功！ 4、换台 请求格式：类型码（4字节）、点菜机号（3字节） 原台号（7字节）、换到台台号（7字节） 示例：HT 100 003004 返回内容：类型码（4字节）、点菜机号（3字节） 信息提示 示例：HT 100 003台换到004台成功！ 5、撤台 请求格式：类型码（4字节）、点菜机号（3字节） 被撤台号（7字节） 示例：CT 100 005 返

14、回内容：类型码（4字节）、点菜机号（3字节） 信息提示 示例：CT 100 005台撤台成功！ 6、点菜 请求格式：类型码（4字节）、点菜机号（3字节） 台号或账单号（7字节）、空格（10字节）、整单备注（12字节）、空格（4字节）、时间（8字节） 台号或账单号（7字节）、菜号（5字节）、数量（4字节）、制作方法（12字节）、套餐号（2字节）、等叫 标记（1字节）、时间（8字节）、只数（4字节）、客人数（4字节）、 示例：DC 100 006 001002003004 07:08:08 006 01001 1 001002 01 ! 07:08:08 1 3 006 01002 10 07:0

15、8:08 1 3 006 01003 1.5 07:08:08 1 3 注意：制作方法支持编码或汉字，不支持编码和汉字混编 套餐号和等叫标记不空格 时间为此单打包发射时间，此时间是唯一的，可以用来判断是否重单 点菜机收到返回信息为“点菜成功”时，点菜器会自动清除本单信息 返回内容：类型码（4字节）、点菜机号（3字节） 信息提示 示例：DC 100 点菜成功！ 006台 7、整桌催菜 请求格式：类型码（4字节）、点菜机号（3字节） 台号（7字节） 示例：ZZCC 100 005 返回内容：类型码（4字节）、点菜机号（3字节） 信息提示 示例：ZZCC00 005台催菜成功！ 8、按菜品催菜 请求

16、格式：类型码（4字节）、点菜机号（3字节） 台号（7字节）、菜号（5字节） 示例：CPCC100 00501001 返回内容：类型码（4字节）、点菜机号（3字节） 信息提示 示例：CPCC100 005台01001催菜成功！ 9、按菜类催菜 请求格式：类型码（4字节）、点菜机号（3字节） 台号（7字节）、菜类编号（8字节） 示例：CLCC100 00501 返回内容：类型码（4字节）、点菜机号（3字节） 信息提示 示例：CLCC100 005台01类菜催菜成功！ 10、退菜 请求格式：类型码（4字节）、点菜机号（3字节） 台号（7字节）、菜号（10字节）、数量（4字节）、单位（4字节）、退菜理

17、由（10字节） 示例：TC 100 00501001101 返回内容：类型码（4字节）、点菜机号（3字节） 信息提示 示例：TC 100 005退菜成功！ 11、空闲台总汇 请求格式：类型码（4字节）、点菜机号（3字节） 被撤台号（7字节） 示例：KXHZ100 返回内容：类型码（4字节）、点菜机号（3字节） 信息提示 示例：KXHZ100 一层8台、10台 二层9台、23台 三层芙蓉间 12、按台号查空闲 请求格式：类型码（4字节）、点菜机号（3字节） 台号（7字节） 示例：THKX100 005 返回内容：类型码（4字节）、点菜机号（3字节） 信息提示 示例：THKX100 005台被占用

18、！ 13、预定信息总汇 请求格式：类型码（4字节）、点菜机号（3字节） 示例：YDHZ100 返回内容：类型码（4字节）、点菜机号（3字节） 信息提示 示例：YDHZ100 010台已被预定！ 14、按台号查预定 请求格式：类型码（4字节）、点菜机号（3字节） 被撤台号（7字节） 示例：THYD100 005 返回内容：类型码（4字节）、点菜机号（3字节） 信息提示 示例：THYD100 005台已被预定！ 15、请求结账 请求格式：类型码（4字节）、点菜机号（3字节） 台号（7字节） 示例：DYYJ100 005 返回内容：类型码（4字节）、点菜机号（3字节） 信息提示 示例：DYYJ100

19、 005台请求结账成功！ 16、划菜 请求格式：类型码（4字节）、点菜机号（3字节） 台号（7字节）、菜号（5字节） 示例：GT 100 00501001 返回内容：类型码（4字节）、点菜机号（3字节） 信息提示 示例：GT 100 005台01001菜已上！ 17、重量确认 请求格式：类型码（4字节）、点菜机号（3字节） 台号（7字节）、菜号（5字节）、流水号（10字节）、重量（8字节） 示例：ZZQR100 005010012.5 返回内容：类型码（4字节）、点菜机号（3字节） 信息提示 示例：ZZQR100 005台01001菜重量2.5斤 18、查沽清 请求格式：类型码（4字节）、点菜

20、机号（3字节） 示例：GQ 100 返回内容：类型码（4字节）、点菜机号（3字节） 信息提示 示例：GQ 100 已沽清菜号： 01001、 01002、 01003 19、调账单 请求格式：类型码（4字节）、点菜机号（3字节） 台号（7字节） 示例：ZDCX100 005 返回内容：类型码（4字节）、点菜机号（3字节） 信息提示 示例：ZDCX100 005 台： 手撕带鱼已上 酸辣蜇头已退 尖椒跳水鸡已上 酸辣小木耳已上 基围虾川式刺身等叫 20、修改台头 请求格式：类型码（4字节）、点菜机号（3字节） 台号（7字节）、客人数（2字节）、服务员号（5字节） 示例：XGTT100 00501

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

22、BKX100 01 返回内容：类型码（4字节）、点菜机号（3字节） 信息提示 示例：LBKX100 一层散台空闲餐台： 001、006、 118 基站频道必须与手持 频道一致时方可通讯！基站设置方法见 wx设置;手持设置方 法:在手持主界面按 两次键，密码779进入手持频道设置； wx的设置 1、点击参数设置 1.1、路径设置中自动指向数据交换文件T1.txt、R1.txt位置; 1.2、 延时设置：wx在接收到手持数据后写 t1文件，发消息给 PC端接口软件，等待 PC端 接口软件处理（即等待 PC端接口软件发来的消息）；在设置的延时内， wx没有收到PC端 接口软件发来的消息，即给手持返回

23、固定信息“数据服务器未向应，请联系管理员。”； 1.3、选择测试可以不连接 PC点菜程序，进行基站和手持之间的通讯； 1.4、选择通讯模式；建议使用消息模式 1.5、 对基站以及基站下的手持进行设置；基站号由001开始设置，手持号范围000-191,同 一家店不许有相同的手持编号，手持编号输入后按保存按钮，在图框中显示后表示设置 手持后成功。 所有设置完成按保存按钮，然后退出 2、点击基站设置：设置基站的频道以及给基站对时 基站频道表 CH# 中心频率HMz CH# 中心频率HMz CH# 中心频率HMz CH# 中心频率HMz 1 414.570 17 422.557 33 430.544

24、49 438.532 2 414.995 18 423.049 34 430.875 50 439.058 3 415.562 19 423.502 35 431.494 51 439.537 4 416.078 20 424.070 36 432.010 52 440.006 5 416.413 21 424.523 37 432.577 53 440.516 6 417.028 22 425.015 38 433.002 54 440.989 7 417.466 23 425.426 39 433.505 55 441.480 8 417.993 24 425.998 40 434.026

25、 56 442.218 9 418.520 25 426.419 41 434.318 57 442.745 10 418.965 26 426.946 42 434.845 58 443.037 11 419.485 27 427.472 43 435.516 59 443.447 12 420.100 28 427.999 44 435.979 60 444.061 13 420.626 29 428.525 45 436.484 61 444.487 14 420.919 30 429.052 46 436.952 62 445.054 15 421.440 31 429.483 47

26、437.478 63 445.495 16 421.943 32 429.930 48 438.005 64 445.904 7线点莱机管理 设置成功WX显示图 用户菜单下哉数据中心I 基詰设置 1234 5 12 34s o o o o o Q o o o o o o o o o o o o o iBB0 i 001002003004 005 基站安装 1、基站安装使用 1.1、基站的功能：基站负责手持和PC之间的数据传递。手持的点餐数据通过无线方式 传送给基站，基站将手持数据以有线方式传送给PC,同样PC将需要告知手持的数 据通过基站传送给手持。基站的另一功能是手持数据更新，即手持下载。点

27、击“菜 单下载”按钮后，点击开始下载，基站进入下载状态，在手持提示全部更新完毕后， 点击“停止下载”按钮，基站进入正常通讯状态。 1.2、基站硬件说明以及示意图 指示灯说明： 、Power :电源指示灯。打开电源开关后，此灯常亮； 、TX无线信号发送指示灯。发送无线信号时，此灯亮； 、RX无线信号接收指示灯。接收无线信号时，此灯亮； 、Net: CPIX作状态指示灯。基站工作正常时，此灯在闪烁状态；发送或接收信号 时此灯的闪烁频率有变化属正常现象； 、CH1 CH2 CH3 CH4四灯组成频段指示灯。 随机附件：DB9串 口通讯电缆线 数量: 一件 直流电源 数量: 一件 无线天线 数量: 一

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

29、COM 连接注意事项： 、设备连接时为了防止 PC机和无线基站两设备接地不良，造成的压差过大埙坏 设备。请在关机状态下连接设备。 、为了提高无线接收效果，天线放置高度距地面不应低于1.5米。 、无线基站采用的是 DC9V电，请使用本机随机附件直流电源供电。禁止使用 其它电源，避免电压过高埙坏设备。 、天线有匹配问题，请使用随机天线。不要用其它天线代替。 基站硬件示意图 DB9串口线延长方法： .将DB9串口线从中间剪断；将剪断处两侧的外皮剥开； 将其中的黑色、蓝色、灰色、白色四线剪断不用；将棕色、红色、橙色、黄色、绿色 五线用网线将线色对应焊接，或用压线子连接即可。 注意：延长网线不应长于10米； .使用 RS-232/RS-485转换器；转换器兼容 RS-232、RS-485标准，能够将单端的 RS-232信号转换平衡差分的RS-485信号。具体连接方式如下： 将转换器和水晶头按照上图位置摆放 （注意水晶头弹片朝下，入线口朝下） ；将网线 中的橙色、蓝色、棕色按照图示连接；水晶头从左数第三脚连接橙色，第四脚连接蓝 色，第五脚连接棕色。用此种方式可以延长 100米。 延长线完成后，将转换器连接到PC的串口上，水晶头连接在基站的485接口上。 附：RS-232/RS-485转换器的三个接头从左到右为A B、GND分别对应水晶头（弹片 朝下，入线口朝下）从左到右