托利多电子称DLL库文件的API调用接口说明

通用DLL说明手册V1.1梅特勒-托利多(常州)称重系统有限公司1/26MT商用衡通用DLL说明手册版本V1.0梅特勒-托利多(常州)称重系统有限公司FinalPDFcreatedwithpdfFactoryProtrialversion梅特勒-托利多(常州)称重系统有限公司2/26目录1：简介2：显示界面3：DLL入口函数4：DLL输出5：相关文件说明6：秤文件7：段数据8：操作数据9：数据类型10：数据内容明细10.1PLU数据10.2附加文本(ExtraText)10.3广告文本(Advertisement)10.4预制键(PresetKey)10.5日期文本(DateText)10.6皮重(Tare)10.7缺省标签(DefaultLabel)10.8组信息(Group)10.9扣率(Discount)10.10店名(StoreName)10.11条码(Barcode)10.12欢迎词(RunMessage)10.13操作员(Vendor)10.14税率(TaxRate)10.15键盘配置(KeyboardConfigure)10.16标头和注脚(HeaderAndBottom)10.17特价(SpecialOfferPrice)10.18BRAM10.19追溯码信息FinalPDFcreatedwithpdfFactoryProtrialversion梅特勒-托利多(常州)称重系统有限公司3/2610.20追溯码格式11：报表上载11.1PLU报表11.2非PLU报表11.3操作员报表11.4时段报表11.5部门报表11.6部门时段报表11.7销售报表11.8结帐报表11.9取消退货报表11.10促销报表11.11周报表11.12月报表11.13年报表11.11秤报表11.12改价报表1:简介MTDLL用于将特定格式的文本数据传输到MT的电子称重秤中，同时也支持将电子秤中的相关数据上载到文本文件中，该传输过程不需用户参与控制，用户只需提供需要操作的文本文件即可。对秤的传输结果也以文本的格式输出到文件中，用户可以通过检测文件的内容来区分最终的传输结果。同一文本文件能够同时支持多个秤类型(命令格式说明中会特别指出可支持的秤类型)。上、下载文件采用同样的文本格式。MTDLL中主要包括五个文件：TransferEth.dll,RL00_DLL.dll,bPro_DLL.dll,ScaleType.dll,DLLTable.bin。如果缺少部分文件，DLL不能正确处理通讯过程。2：显示界面调用DLL的入口函数后，将弹出一个显示对话框，用于显示当前各秤的传输情况0该界面以表格的方式显示各秤的传输情况，对话框的主要显示内容及说明如下：表格名称描述1状态当前秤的传输状态2秤号传输秤的编号3秤名传输秤的名称FinalPDFcreatedwithpdfFactoryProtrialversion梅特勒-托利多(常州)称重系统有限公司4/264秤信息传输秤的通讯方式5进度当前传输的数据的个数对话框的显示界面如下：3：入口函数：MTDLL对外提供两个入口函数Transfer_Ethernet_Ex和Transfer_Ethernet，它们提供同样的上、下载功能，这两个函数保持和以前的DLL相同的接口。MTDLL主要支持MT的新文本格式，同时也支持14段的PLU文本文件格式。以前DLL支持的二进制格式和ASCII格式将不再支持。Transfer_Ethernet_EX的声明externC__declspec(dllexport)UINT__stdcallTransfer_Ethernet_EX(char*cTransScale,intnKey)功能：将传输配置文件中要求传输的秤的文件传输到对应秤内参数说明：cTransScale:传输配置文件的文件名nKey:暂时无意义Transfer_Ethernet_EX的声明externC__declspec(dllexport)UINT__stdcallTransfer_Ethernet(char*cTransScale)功能：将传输配置文件中要求的秤的文件传输到对应的秤内参数说明：cTransScale：传输配置文件的文件名4：DLL输出：FinalPDFcreatedwithpdfFactoryProtrialversion梅特勒-托利多(常州)称重系统有限公司5/26通过调用Transfer_Ethernet_EX函数后，将会产生两个数据文件resultlog.ini和log.txt。log.txti用于保存当前传输的总的耗时数等信息，resultlog.ini用于保存对应秤的传输成功与否等情况。5：相关文件说明：MTDLL需要相关的文件配合使用，传输信息通过保存在文件中的内容来控制。相关文件的描述如下：传输配置文件：该文件用于配置秤号和要求传输的文件之间的对应关系地址配置文件：用于保存秤的秤号、地址、端口等通讯信息秤文件：保存要求对秤操作的相关信息，如数据内容，数据的类型等信息。地址配置文件：该文件的文件名称为ScaleAddress.ini，保存在当前运行目录下。它用于保存秤的通讯参数。文件内容及解释如下：[CONFIG]-------配置节点标识THREADNUM=10-------DLL允许同时传输的秤的个数MEDIA=1-------当前以Ethernet方式传输数据[1]--------秤号NAME=Fish--------秤名称IP=172.30.7.246--------秤的IP地址PORT=3001-------秤的通讯端口[2]--------秤号…示例文件请参考文件包中的”ScaleAddress.ini”文件。传输配置文件：该文件用于保存秤号和要求传输的文件名称之间的对应关系，文件和秤号的对应关系有两种：一对一和一对多。两种关系对应的传输配置文件的内容不一样。一对一关系：传输配置文件中保存的内容的格式如下：1:c:\aaaa\1.txt2:c:\aaaa\send2.txt数据行的格式为：秤号:秤文件名称一对多关系：文件格式如下：aaaa.txt12数据行的格式说明：先写入要求传输的秤文件，然后写入要求FinalPDFcreatedwithpdfFactoryProtrialversion梅特勒-托利多(常州)称重系统有限公司6/26传输的秤的秤号。注意：一对多关系时，秤文件名不允许有目录信息，传输文件要保存在当前运行目录中。有关数据参考文件包中的TransScale.ini文件。6：秤文件：秤文件中保存要求传输的数据，同一个秤文件支持多个不同的数据类型(见9：类型列表部分)和读写方式(见8：操作命令部分)。允许用户将对同一个秤的不同操作方式或数据类型集合到同一文件中，从而简化用户的控制过程。文件通过段的方式解析，每一段支持同一类型的数据和操作方式。示例数据如下：[MT_STAND_FIRE,PLU,WRITE,0,0,0,0,C:\aaa.txt]0003,0013,1,2.5,0,0,0,3,0,0,0,0,0,aaa,1651,1651,1,35.6,0,0,0,0,0,0,0,0,0,bbb,[MT_STAND_FIRE,PLU,ReadGE,1,100,0,0,C:\Application\test\bin\RL00\Adver.bin][MT_STAND_FIRE,Presetkey,WRITE,0,0,0,0,C:\Application\test\bin\RL00\PresetKey.bin]1,12,23,3[MT_STAND_FIRE,DateText,WRITE,0,0,0,0,C:\Application\test\bin\RL00\DateText_Write.bin]1,PackonDate2,SellByDate3,BestBeforeDate上述示例文本中包含四段数据文本，支持三种数据类型，两种操作.三种数据类型分别是：PLU数据，预制键数据和日期文本数据。两种操作类型分别是：写命令和读等于命令，用于将数据下载到秤内和从秤中读数据并以文本的方式保存到指定的文件中。有关段数据的解释见7：段数据部分。说明：文本数据：[MT_STAND_FIRE,PLU,WRITE,0,0,0,0,C:\aaa.txt]0003,0013,1,2.5,0,0,0,3,0,0,0,0,0,aaa,1651,1651,1,35.6,0,0,0,0,0,0,0,0,0,bbb,上段数据表示将PLU号为0003,1651的两条PLU数据下载到秤内，同时将生成文本文件C:\aaa.txt。文本数据：[MT_STAND_FIRE,PLU,ReadGE,1,100,0,0,C:\Application\test\bin\RL00\Adver.bin]上段数据表示从秤内上载PLU号为[1,100]区间的PLU数据，并将结果以文本的方式保存到C:\Application\test\bin\RL00\Adver.bin文件中7：段数据FinalPDFcreatedwithpdfFactoryProtrialversion梅特勒-托利多(常州)称重系统有限公司7/26秤文件以段的方式来分隔不同类型的秤数据和不同的操作命令，同一段的数据只支持一种类型的秤数据和一种操作命令。同时段数据以特定的字符串开头和结尾，段表示的数据类型和操作命令以文本的方式给出，同时它们被保存在短的起始头位置。段头的解析如下：============================段头开始标识|========================数据类型||==================操作命令|||================开始序号||||===============结束序号|||||=============报表特性||||||============保留2|||||||===结果保存文件名(秤内数据)||||||||===段头结束标识|||||||||+---------------------++--++------++++++---------++[MT_STAND_FIRE,PLU,WRITE,0,0,0,0,C:\aaa.txt]-----〉段标识0003,0013,1,2.5,0,0,0,3,0,0,0,0,0,aaa,-----〉段内数据内容1651,1651,1,35.6,0,0,0,0,0,0,0,0,0,bbb,段标识中的数据之间用逗号分隔，段头有明显的标识，各数据的说明如下数据类描述1开始标识用于表示该行以下的数据将是同一类型数据，支持同一种操作命令2数据类型表示段中的数据是何种数据类型，如PLU、ExtraText等，详细见3操作命令表示当前对秤的操作类型，以文本方式给出，DLL支持的操作命令见操作命令条目4开始序号区间命令的开始号码，用于操作命令中带区间的操作，如读单项、读等于、删除单项、区间删除等5结束序号区间命令的结束号码，用于操作命令中带区间的操作，如读单项、读等于、删除单项、区间删除等6报表特性该字段用于上载报表中设置报表特性，见报表上载说明。7保留2大部分命令不用，部分命令用到该条目，请参考各命令的提示8保存文件读命令时用于保存读取得数据的文件名称；写命令时，该项允许为空9结束标识段标识的结束码段内数据内容和数据类型相对应，读命令和删除命令可以没有段内数据部分。8：操作命令FinalPDFcreatedwithpdfFactoryProtrialversion