BST應(yīng)用軟件開(kāi)發(fā)平臺(tái)技術(shù)手冊(cè)

1、 BST3.0應(yīng)用軟件開(kāi)發(fā)平臺(tái)用戶技術(shù)手冊(cè)云南南天電子信息產(chǎn)業(yè)股份有限公司FED軟件中心目 錄概述第一部分BST3.0應(yīng)用軟件開(kāi)發(fā)平臺(tái)基本功能 第一章 BST3.0軟件開(kāi)發(fā)平臺(tái)的結(jié)構(gòu)和流程控制第二章 系統(tǒng)命令第三章 變量操作命令第四章 字符串操作命令第五章 文件操作命令第六章 屏幕(SCREEN)表配置和命令第七章 存折打印機(jī)(PR2) 配置和命令第八章 刷卡器(BP) 配置和命令第九章 FIT表配置和命令第十章 流水打印機(jī)配置和命令第十一章 讀卡機(jī)命令第十二章 IC卡命令和配置表第十三章 輔助模塊命令和配置第十四章 通信命令第十五章 添加設(shè)備的命令接口第二部分BST3.0應(yīng)用軟件二次開(kāi)發(fā)第一

2、章用戶自定義命令的開(kāi)發(fā)第二章通信動(dòng)態(tài)庫(kù)的開(kāi)發(fā)第三章 調(diào)試第三部分BST3.0 SCRIPT使用手冊(cè)概述BST3.0應(yīng)用軟件開(kāi)發(fā)平臺(tái)是在BST2.0應(yīng)用軟件開(kāi)發(fā)平臺(tái)的基礎(chǔ)上，根據(jù)BST應(yīng)用需求，增加了屏幕部分對(duì)WEB和FLASH的支持，增加了內(nèi)嵌的解釋器，支持SCRIPT 編程模式，以及單步和屏幕重試功能。BST3.0應(yīng)用軟件開(kāi)發(fā)平臺(tái)更穩(wěn)定，具有更好的擴(kuò)展性，更容易完成BST 應(yīng)用系統(tǒng)的開(kāi)發(fā)。為熟練使用BST3.0應(yīng)用系統(tǒng)軟件開(kāi)發(fā)平臺(tái)進(jìn)行二次開(kāi)發(fā)，對(duì)此平臺(tái)結(jié)構(gòu)及功能模塊應(yīng)有充分了解，為縮短二次開(kāi)發(fā)周期，請(qǐng)有關(guān)人員仔細(xì)閱讀本手冊(cè)。因時(shí)間倉(cāng)促，有不足之處，請(qǐng)使用者諒解，并將需要改善的意見(jiàn)反饋給FED

3、軟件中心，幫助BST3.0應(yīng)用系統(tǒng)軟件開(kāi)發(fā)平臺(tái)的完善。第一部分 BST3.0應(yīng)用軟件開(kāi)發(fā)平臺(tái)基本功能第一章 BST3.0開(kāi)發(fā)平臺(tái)的結(jié)構(gòu)和基本功能1.1 BST3.0軟件開(kāi)發(fā)平臺(tái)的組成部分BST3.0軟件開(kāi)發(fā)平臺(tái)功能完善、定制靈活、便于二次開(kāi)發(fā)及其測(cè)試維護(hù)，它是由接口清晰且相互獨(dú)立的子功能模塊有機(jī)地結(jié)合在一起而行成的。BST3.0軟件開(kāi)發(fā)平臺(tái)由以下幾個(gè)大的部分組成：1 系統(tǒng)主控模塊協(xié)調(diào)平臺(tái)內(nèi)部各功能模塊的工作。2 設(shè)備控制模塊由一系列與具體設(shè)備相應(yīng)的設(shè)備控制模塊組成，每一個(gè)設(shè)備控制模塊對(duì)應(yīng)于一個(gè)相應(yīng)的硬件設(shè)備模塊，在BST應(yīng)用系統(tǒng)中，設(shè)備是一個(gè)廣義上的設(shè)備，除傳統(tǒng)上的外部設(shè)備如打印機(jī)、BP、讀卡

4、機(jī)等設(shè)備外，還有一些特殊的設(shè)備，如屏幕設(shè)備，在系統(tǒng)中稱之為“screen”，它實(shí)際上包括了顯示器、鍵盤和鼠標(biāo)的輸入輸出，這三個(gè)設(shè)備是在“screen”設(shè)備中統(tǒng)一處理的。另外，還有通信設(shè)備（實(shí)際上是通信子系統(tǒng)，它被當(dāng)作一個(gè)設(shè)備操作）和時(shí)間設(shè)備（“time”，用于檢測(cè)退出時(shí)間是否到達(dá)）等。3 設(shè)備接口模塊負(fù)責(zé)屏蔽BST應(yīng)用系統(tǒng)中設(shè)備的硬件特性，使用統(tǒng)一的方式（統(tǒng)一的接口）對(duì)設(shè)備進(jìn)行操作。應(yīng)用系統(tǒng)使用設(shè)備時(shí)通過(guò)設(shè)備接口模塊操作設(shè)備，可保證以同樣方式操作所有設(shè)備。4 流程控制模塊負(fù)責(zé)應(yīng)用系統(tǒng)的流程控制，完成特定交易控制，接受主機(jī)命令，保存程序運(yùn)行狀態(tài)的文件等。5 通信處理子系統(tǒng)以操作設(shè)備的方式完成BS

5、T應(yīng)用系統(tǒng)與主機(jī)間的通信。 信息處理子系統(tǒng) 系統(tǒng)主控模塊HOST 通信子系統(tǒng) 存折打印流水打印收條打印日志打印屏幕顯示磁條輸入語(yǔ)音輸出鍵盤輸入磁條寫入觸摸屏輸入出鈔模塊 輸入子系統(tǒng) 輸出子系統(tǒng)本地服務(wù)系統(tǒng)維護(hù)交易處理 圖一系統(tǒng)總體結(jié)構(gòu)圖1.2 BST3.0應(yīng)用系統(tǒng)的流程控制BST3.0應(yīng)用系統(tǒng)是一個(gè)平臺(tái)化的產(chǎn)品，可根據(jù)客戶不同的需求加以定制，該平臺(tái)可適應(yīng)不同的聯(lián)機(jī)環(huán)境，具有定制簡(jiǎn)單，易于擴(kuò)展、安裝和維護(hù)等優(yōu)點(diǎn)，BST3.0應(yīng)用系統(tǒng)是通過(guò)“表控制結(jié)構(gòu)”完成的（SCRIPT腳本作為輔助方式）。系統(tǒng)根據(jù)交易流程表(step.cfg）的定義來(lái)具體實(shí)現(xiàn)每一個(gè)相關(guān)的操作，如設(shè)備的初始化及交易的處理等。整個(gè)

6、控制過(guò)程是通過(guò)多個(gè)配置表相互協(xié)調(diào)來(lái)完成功能的。“配置表”是BST3.0應(yīng)用系統(tǒng)正常運(yùn)轉(zhuǎn)的控制中心，是完成交易控制的“主動(dòng)脈”:1 設(shè)備表，定義應(yīng)用系統(tǒng)中的設(shè)備特性；2 變量表，定義在STEP表中可用的全局變量；3 STEP表(STEP.CFG)，也稱主控表，類似一種腳本語(yǔ)言，負(fù)責(zé)交易流程的控制；4 屏幕表，負(fù)責(zé)屏幕顯示方式的控制；5 通信控制表，定義通信方式和數(shù)據(jù)解釋方式；6 PR2打印機(jī)控制表，定義PR2工作方式；7 BP控制表，定義BP工作方式；8 流水打印機(jī)控制表，控制流水打印機(jī)打印；9 FIT表，負(fù)責(zé)磁條數(shù)據(jù)的解釋和組包；10 讀卡機(jī)控制表；11 CD出鈔模塊控制表；12 命令控制表（

7、COMMAND.CFG），需要新增設(shè)備以及相應(yīng)的命令時(shí)的接口控制表；13 SCRIPT腳本文件，是數(shù)據(jù)處理和流程控制的輔助方式。設(shè)備控制表(簡(jiǎn)稱設(shè)備表)和變量定義表(簡(jiǎn)稱變量表)都是定義在注冊(cè)表中的“我的電腦HKEY_LOCAL_MACHINESOFTWARE南天BST2”下。設(shè)備表定義了各個(gè)設(shè)備的基本特性。其格式如下：設(shè)備名 通道(端口) 輸入緩沖區(qū)大小 輸出緩沖區(qū)大小 出口索引號(hào)(n)設(shè)備名： 必須是唯一的，如PR2、BP、SCREEN等，且確定后不能更改。通道(端口):標(biāo)識(shí)設(shè)備所使用端口,如COM1”、“COM2”等。如果不使用計(jì)算機(jī)串口，也必須用一個(gè)字符串作為標(biāo)識(shí)，如使用TCPIP，則

8、用“TCPIP” 標(biāo)識(shí)。輸入緩沖區(qū)大?。阂宰止?jié)計(jì)的緩沖區(qū)大小，用于保存輸入數(shù)據(jù)。輸出緩沖區(qū)大?。阂宰止?jié)計(jì)的緩沖區(qū)大小，用于保存輸出數(shù)據(jù)。出口索引號(hào)n: 與SynDevice 命令配合使用，在設(shè)備同步狀態(tài)下，設(shè)備輸入時(shí)所指向的出口索引號(hào)（第n個(gè)出口）。注意:出口索引號(hào)可以用8之外的索引號(hào)，索引號(hào)8由系統(tǒng)保留使用，需要與SynDevice命令配合使用的設(shè)備,詳見(jiàn)命令SynDevice的描述變量表包括預(yù)定義變量表(PredefineVariable)和用戶定義變量表(UserdefineVariable)。變量表用于定義全局變量，這些變量在STEP表的整個(gè)流程中均可用。預(yù)定義變量表：該表定義的變量供

9、系統(tǒng)使用，而且變量名不能改變。用戶定義的變量表：二次開(kāi)發(fā)所用的變量可此表中定義，該表定義的變量是可以改變的。注意:定義變量時(shí)，以“；”號(hào)開(kāi)始的部分為注釋部分，原則上在定義變量時(shí)都應(yīng)該注釋其含義。STEP配置表是BST應(yīng)用系統(tǒng)的流程控制表，是完成交易的核心。它通過(guò)控制設(shè)備操作流程來(lái)完成指定的交易。它實(shí)現(xiàn)的原理是：所有交易都是由一系列設(shè)備操作的組合實(shí)現(xiàn)的。STEP 配置表（step.cfg）中的內(nèi)容分為兩類：初始化表和工作表。一初始化表的配置初始化表名是“init”，包括如下內(nèi)容：1 用戶擴(kuò)展接口庫(kù)路徑(關(guān)鍵字userdll_path)。userdll_path = c:bst_newbst2bs

10、tuserdebugbstuser.dll缺省為運(yùn)行程序BST2.EXE當(dāng)前目錄下的bstuser.dll。該配置用于定義用戶擴(kuò)展接口庫(kù)的路徑。2 調(diào)試級(jí)別(關(guān)鍵字debug_level)。debug_level = 0該配置用于定義不同的調(diào)試級(jí)別，對(duì)不同的調(diào)試級(jí)別，系統(tǒng)會(huì)提供不同范圍下的TRACE文件，該文件可供調(diào)試使用。缺省為1。= 0：無(wú)調(diào)試信息，無(wú)任何trace文件，配置文件在內(nèi)存中讀寫，不等于0時(shí)，PR2控制部分和屏幕部分根據(jù)配置可以定義各自的trace文件（請(qǐng)參見(jiàn)PR2模塊和屏幕模塊的相關(guān)部分）。= 1：有step的trace文件 step.txt，放在trace目錄下，記錄所執(zhí)行

11、過(guò)的命令，配置文件在內(nèi)存中讀寫；= 2：有step的trace文件 step.txt，放在trace目錄下，記錄所執(zhí)行過(guò)的命令和每一個(gè)命令的執(zhí)行時(shí)間，配置文件在磁盤文件中讀寫；注意：各個(gè)配置文件不能超過(guò)64K，否則在寫文件時(shí)可能會(huì)丟失文件中超過(guò)64K部分的內(nèi)容，此時(shí)必須備份文件。= 3：有step的trace文件 step.txt，放在trace目錄下，記錄所執(zhí)行過(guò)的命令和每一個(gè)命令的執(zhí)行時(shí)間，同時(shí)記錄每一步中的所有變量的值，配置文件在磁盤文件中讀寫；= 4: 設(shè)置調(diào)試熱鍵，使用熱鍵X進(jìn)入單步step，Y退出；熱鍵A進(jìn)入屏幕單步，B退出。= 5: 單步執(zhí)行step，“DONE”按鈕執(zhí)行一步，“

12、GOTO”按鈕條轉(zhuǎn)道指定STEP。= 6: 單步執(zhí)行屏幕，“RETRY”按鈕重新畫屏幕，“NEXT”按鈕從指定出口執(zhí)行下一步。3 退出時(shí)間定義（關(guān)鍵字logout_time）可最多定義三個(gè)時(shí)間檢測(cè)，出口相同：logout_time = 22:30 logout_time2 = 22:50 -第二個(gè)時(shí)間 logout_time3 = 22:50 -第三個(gè)時(shí)間該配置用于定義系統(tǒng)自動(dòng)關(guān)機(jī)的時(shí)間，若要啟動(dòng)該功能，需要執(zhí)行CheckTime 命令(詳見(jiàn)CheckTime命令)。二工作表的配置。工作表的表名是“STEP_TABLE”,在STEP表中，所有STEP以以下格式出現(xiàn)：step_xxxx = Co

13、mmand Screen Var1Var2 exit1 exit2 exit3 exit4 exit50step_xxxx: STEP號(hào)，作為關(guān)鍵字。STEP表從step.cfg文件中的step_0001開(kāi)始。xxxx是STEP索引號(hào)，可以由數(shù)字組成，也可以是字符串，但必須小于40個(gè)字節(jié)，如果超過(guò)，會(huì)導(dǎo)致不能正確搜尋。Command: 命令。向設(shè)備發(fā)出確定的命令指示設(shè)備工作，如PR2ReadStrap是讓打印機(jī)讀磁條。Screen：屏幕。通知屏幕按屏幕配置文件中的某個(gè)表畫屏幕。Var1Var2:變量名。在一些Command中，需要用到變量，Var1，Var2是變量名。exit1exit50：出口號(hào)。在命