BST3.0應用軟件開發(fā)平臺技術(shù)手冊

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

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

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

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

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

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

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

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

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

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

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

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

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