力維4接口開發(fā)包-4說明書

概 功能介 文件介 接口函數(shù)簡 函數(shù)的調(diào)用流 函數(shù)詳細(xì)描 公共返回 常見問 關(guān)于開 關(guān)于編 關(guān)于報 概3.5軟件所安裝的門鎖。五個*.dll文件：LevelLock.dll、lv4.dll、EMUSB.dll、RCUSB.dll、RFUSB.dll（都包 ；動態(tài)庫使用說明書，即此文檔；動態(tài)庫使用DEMO（文件夾名以“Source”結(jié)尾的是各種開發(fā)環(huán)境下使用本動態(tài)庫的源代碼，而編譯出來的*.exe文件都放在“ ； _Build”文件夾中，以房間名發(fā)賓客卡時會用到，詳見3.8LV4_ReadRoomStructure節(jié)；1-1Delphi2007為準(zhǔn)。函數(shù)的描述1-1函功LV4_SetAuthCode(Pointer,Smallint,Smallint,Smallint,Smallint,Smallint,Smallint,Smallint,Smallint,Smallint,Smallint,Smallint,Smallint,設(shè)置碼及各扇pareRegCode(Pointer,對比Pointer,Pointer,Pointer,Pointer, ardExtData(Pointer,Pointer,Pointer, ardByName(Pointer,Pointer,Pointer,Pointer,Pointer,Pointer,Pointer,Pointer,Pointer,48Byte更改讀寫讀48Byte的數(shù)據(jù)從數(shù)據(jù) 設(shè) 從數(shù)據(jù) 設(shè) V4adByNmeV4asuG輸入16 函數(shù)的調(diào)輸入16 是是否保 ）否是LV4_InitializeSystem】和【設(shè)置碼及各扇區(qū)LV4_SetAuthCode，如果在第二階段需要調(diào)用LV4_GardByName函數(shù)來以房間名制賓客卡或調(diào)用LV4_SetGardExtByName函數(shù)來以房間名設(shè)置賓客卡擴展房數(shù)LV4_ReadRoomStructure要以碼作為參數(shù)之一調(diào)用LV4_SetAuthCode函數(shù)因此建議把碼保存到數(shù)據(jù)庫中。需要調(diào)用LV4_SetAuthCode函數(shù)時，直接從數(shù)據(jù)庫中取出碼。到第三階段，這一階段的可以根據(jù)需要無限次地進(jìn)行而不需每讀一張卡或發(fā)一張卡LV4_FreeRoomStructure（在第一階段調(diào)用過Delphi20072-1函數(shù)詳細(xì)描04參數(shù)3-1卡片類456789ShowExtSector2,PubDoorSector,ExtendSector1,ExtendSector2,LiftExtNO1,LiftExtNO2,LiftExtNO3,LiftExtNO4,LiftExtNO5,LiftExtNO6,ParkSector:smallint):smallint;參數(shù)RegCode：一個長度固定為16個字符的字符串，著由用戶輸入的碼（四段4碼合并而成3-2。ShowSectorMain：是smallint類型，其值是一個明碼主扇區(qū)代號，不使用明碼主扇區(qū)時03-2。ShowExtSector1：與ShowSectorMain相類似，但必須先使用明碼主扇區(qū)，再使用明碼擴1。ShowExtSector2：與ShowExtSector11，再使用明碼2。PubDoorStor：是mallint0480個。各種類型的卡32。ExtendSector1smallint1代號，不使用賓客卡擴展區(qū)1014個房間（1個主房，3個擴展房。3-2。ExtendSector2：與ExtendSector11，再使用賓客卡227個房間（1個主房，6個擴展房。LiftExtNO1LiftExtNO2LiftExtNO3LiftExtNO4LiftExtNO5LiftExtNO6smallint0ParkSector：是smallint03-2卡片類可用扇可用公共沒使用公共門扇使用了公共門扇111注意21312；賓12。4、沒使用賓客卡擴展區(qū)，使用明碼扇區(qū)時最多只能使用一個（明碼主扇區(qū)212111區(qū)，若有特殊需要可聯(lián)系本公司。71111區(qū)曾經(jīng)作為公共門扇區(qū)發(fā)過賓客卡，則此卡片的4區(qū)將不再能作為其他“一卡通”使9310、提示：因為讀寫卡前都需要調(diào)用本函數(shù)，因此，把用戶輸入的碼保存到數(shù)據(jù)庫，以后進(jìn)入的時候都直接從數(shù)據(jù)庫，這樣就不需要每次都讓用戶輸入碼了。功能：卡片的。：LV4_ReadCardID(CardIDpointer):smallint;只是系統(tǒng)當(dāng)前時間的前后一個小時，即在13時發(fā)的總卡，只在當(dāng)天的12時到14時可開所有提示：碼及各扇區(qū)的設(shè)置與門鎖上的設(shè)置相符時，總卡只要在有效時間內(nèi)就可以開門。因此，總卡能否開門有助于檢查碼及各扇區(qū)的設(shè)置是否正確，這有助于找出賓客卡：LV4_IssueGard(RoomPara,Suite,PubDoor,OptionNO,StartTime,EndTime,OpPara,WeekArr:pointer;ExtRoomAmt:smallint):smallint;參數(shù)RoomPara：一個長度為0~3的byte數(shù)組指針，數(shù)組的0~3個元素依次著區(qū)域號、樓1~255。Suite0~7的byte0~71~8的套房號，值1（0）表示該套房能開；0則表示該套房不能開。PubDoor：一個動態(tài)smallint數(shù)組指針，數(shù)組著該卡能開的所有公共門的號。0表示OptionNO0~2的byte3個元素是賓客卡增強型格式中的，這張賓客能把門鎖打開。其中StartTime的前4位代表年，接下來的月，日，時，分各占，，這張賓客卡不能再把門鎖打開。字符串的格式與StartTime相似。，OpPara0~10的byte0~10功能（1：是；0：否、賓客卡在增強型格式時的操作范圍（1：區(qū)域、2：樓棟、3：樓4（1客房是否要反寫記錄（僅S70可用，1：是；0：否、公共門是否要反寫記錄（S70可用，1：是；0：否、是否需要限制卡片一周內(nèi)的使用日期（1：是；0：否。在增強型格式下(OpPara[7]:=1)，OpPara的操作范圍(OpPara[6])、RoomPara的各個號以及OptionNO選項號配合使用時，賓客卡可開多個房間。例如，當(dāng)OpPara的操作范圍是樓層客卡可開樓棟3的第2、4、6層的所有房間。另外，當(dāng)?shù)谝粋€的選項號為0時，賓客卡可開270、2、7（0、7、2）即可。WeekArr：一個長度為0~6的byte數(shù)組指針組的0~6個元素依次代表周日周一…1（0）表示該日可用；0則表示該日不可用。ExtRoomAmt：是smallint類型，其值是擴展房的數(shù)量。假設(shè)想發(fā)如下一張賓客卡：區(qū)域號為1、樓棟號為2，樓層號為3，房間號為4，能開套2、3、8、、、、、，入住時間為201392213：30~201392411：30，能開反鎖，使用空調(diào)，不使用保險箱，帶設(shè)置通道（常開）功能，頂替其他賓客卡，不帶設(shè)置功能，增強型格式，也能開樓棟2的4到8層的RoomPara:array[0..3]ofbyte;Suite:array[0..7]ofbyte;PubDoor:arrayofsmallint;OptionNO:array[0..2]ofbyte;StartTime,EndTime:array[0..11]ofchar;OpPara:array[0..7]ofbyte;fori:=0to7do8PubDoor[0]:=2;PubDoor[1]:=6;PubDoor[2]:=18;PubDoor[3]:=72;PubDoor[4]:=113;PubDoor[5]:=246;PubDoor[6]:=325;PubDoor[7]:=477; //0表示結(jié)束 //20139221330 //20139241130 // **使用空調(diào)不帶設(shè)置功 //需要限制卡片一周內(nèi)的使用日期 //能開4到8層的所有房間 // // // // // // //周六不可用LV4_IssueGard(@RoomPara,@Suite,@PubDoor[0],@OptionNO,@StartTime,@EndTime,@OpPara,@WeekArr,0);2013922133120139221330201392230分的賓客卡以前已經(jīng)開過這把鎖。因此，如果兩個客人同時入住同一房間，先后發(fā)的賓客卡必須保證設(shè)置的開始時間一致，這樣兩張賓客都能開門。2、在設(shè)置各開門參數(shù)的值時和著開始時間結(jié)束時間的字符串StartTimeEndTime20136131分，則StartTime的賦值必須是'201306010301'，月、日、時、分前面的’0’不能省略。EndTime同理。330305、PubDoor0，以此來表示結(jié)束。即使不需要開任何公共門也必須設(shè)置PubDoor[0]:=0。另外，Delphi程序員請注意，調(diào)用LV4_IssueGard6OpPara[6]OptionNOOpPara[7]設(shè)為增強型格式時7、擴展房數(shù)量ExtRoomAmt的值必須小于等于調(diào)用函數(shù)LV4_SetGardExtData ardExtByName的是S70卡，才能夠生效。房間，最多可設(shè)置3個擴展房或6個擴展房，具體由調(diào)用LV4_SetAuthCode函數(shù)時的設(shè)置來：LV4_SetGardExtData(RoomPara,Suite,StartTime,OpPara:Pointer;SequenceNO:smallint):smallint;參數(shù)RoomPara、Suite、StartTime均與3.6LV4_IssueGard相似OpPara：一個長度為0~5的byte數(shù)組指針，數(shù)組只有3.6LV4_IssueG ard的前6個元素，即反鎖、空調(diào)、保險箱、帶設(shè)置通道功能、頂替、帶設(shè)置功能。SequenceNOsmallint類型，其值是擴展房的序號。 ardExtByName函數(shù)若干次 ardByName函數(shù)調(diào)用LV4_SetAuthCode調(diào)用LV4_SetAuthCode時，是否是否 注意1，則設(shè)置擴展房數(shù)據(jù)時，SequenceNO3；如果還設(shè)置2SequenceNO6SequenceNO（392、在制賓客卡時，如果擴展房數(shù)量ExtRoomAmt設(shè)為n，則至少需要設(shè)置擴展房n次，把擴展房的序號SequenceNO1n的擴展房數(shù)據(jù)全部都設(shè)置了。否則在制賓客卡（123、其余注意事項與3.6 ard相類似功能：RoomStructure.lvr文件中的房間結(jié)構(gòu)（在本節(jié)的提示部分會詳細(xì)介紹該文件的使用。使用函數(shù)LV4_SetGardExtByName以房間名設(shè)置賓客卡擴展房數(shù)據(jù)或使用函數(shù)LV4_GardByName制賓客卡前，必須有成功調(diào)用過此函數(shù)一次。1、使用RoomStructure.lvr4=>以后點【ok】即可導(dǎo)出RoomStructure.lvr文件④、把剛才導(dǎo)出的RoomStructure.lvr文件放到與LevelLock.dll相同 這樣，LV4_ReadRoomStructure函數(shù)就可以從RoomStructure.lvr文件房間結(jié)構(gòu)了 _Build”文件夾中，有一個從力維4的軟件中導(dǎo)出來的注意1、RoomStructure.lvr文件必須放在與LevelLock.dll相同 下OpPara,WeekArr:Pointer;ExtRoomAmt:smallint):smallint;參數(shù)RoomName：一個固定長度為30個字符的字符串，調(diào)用前著房間名。其余參數(shù)與3.6LV4_IssueG ard相似，在此不再重復(fù)。注意除3.6LV4_IssueGard中提到的注意事項以外，還須注意2、因為在力維3軟件中房間名最長為30個字符因此RoomName字符串也過：LV4_SetGardExtByName(RoomName,Suite,StartTime,OpPara:Pointer;SequenceNO:smallint):smallint;各參數(shù)的介紹及函數(shù)調(diào)用時的注意事項可參照3.7LV4_SetGardExtData和3.9：LV4_ReadCardInfo(LanguageTypesmallintCardTypeCardInfopointer):smallint;CardType：一個長度為一個byte的指針。調(diào)用函數(shù)以后，該指針指向的變量將保存該卡3-3。CardInfo50003-3代卡片功能種英文名0卡Authorized1Clock2Install3Spare4Data5CheckOut6Stop7Lost8Meeting9EmergentMasterCard(ChiefGateAreaBuildingFloorGuestVisitPowerBlank示例CardInfo:array[0..4999ofchar;能種類的代號，CardInfo字符串將保存著以中文顯示的該卡片信息。注意1LV4_SetAuthCode函數(shù)對各扇區(qū)的設(shè)置必須與卡片發(fā)卡前調(diào)用（17，或讀出來的信LV4_SetAuthCode(@RegCode11,0,0,0,20,0,0,0,0,000)LV4_SetAuthCode(@RegCode11,0,0,040,0,0,0,0,0,0)功能：把放到卡機上卡片的數(shù)據(jù)出來。：LV4_ReadCard(CardTypepointerCardInfopointer):smallint;本函數(shù)的CardInfoLV4_ReadCardInfo中的CardInfo不同。LV4_ReadCardInfo的CardInfoCardInfo是全數(shù)字形式的卡信息。因為此函數(shù)只在讀卡時有特殊需要時才調(diào)用，而且使用起來比較繁瑣，所以不作詳細(xì)介紹有的程序員可參“d_rd_DEO_Soure文件夾中用lphi2007編寫的例子。功能48個byte或char組成的數(shù)組。此函數(shù)只能在扇區(qū)13-2。：LV4_WriteData(WData,WKey:pointer;SectorToWrite:參數(shù)WKey：一個長度為6個的byte數(shù)組指針，數(shù)組調(diào)用前著讀寫。此必須正確才能把WData中的數(shù)據(jù)寫入卡片中去。此由6個0~255中的數(shù)字組成。在沒有修改過的情況下，每張卡的都默認(rèn)為6個255。SectorToWrite：數(shù)據(jù)類型為smallint，其值是一個寫數(shù)據(jù)的扇區(qū)的代號。各種類型的卡所3-2。注意功能：用函數(shù)LV4_WriteData寫進(jìn)卡片的數(shù)據(jù)。此函數(shù)只能在扇區(qū)數(shù)大于1的卡片3-2。：LV4_ReadData(RData,RKey:pointer;SectorToRead:參數(shù)RData48RKey：一個長度為6個的byte數(shù)組指針，數(shù)組調(diào)用前著讀寫。此必須正確才能把卡片中的數(shù)據(jù)讀出。每張卡的都同樣默認(rèn)為6個255。SectorToRead：數(shù)據(jù)類型為smallint，其值是一個讀數(shù)據(jù)的扇區(qū)的代號。各種類型的卡所3-2。功能：更改指定扇區(qū)的讀寫參數(shù)OldKey：一個長度為6個的byte數(shù)組指針，數(shù)組調(diào)用前著舊讀寫。此正確才能改成新。默認(rèn)為6個255。NewKey：一個長度為6個的byte數(shù)組指針，數(shù)組調(diào)用前著新讀寫SectorToWrite：數(shù)據(jù)類型為smallint，其值是一個想更改讀寫的扇區(qū)的代號。各種類3-2。注意2、卡上扇區(qū)的讀寫若不是6個255，則此扇區(qū)將不能作為公共門扇區(qū)、明碼扇區(qū)、 功能：檢查是否連接，返回0則表示已經(jīng)連接。功能：對比新舊碼，看兩者的源碼是否一樣，返回0則表示一樣。 pareRegCode(OldRegCode,NewRegCode:Pointer):smallint;OldRegCode：一個長度固定為16個字符的字符串，著舊的碼NewRegCode：一個長度固定為16個字符的字符串，著新的碼 ardExtByNameLV4_ReadRoomStructure函數(shù)來333個電梯可到達(dá)：LV4_SetLift_FloorData(FloorData,DeviceNO:Pointer;OpPara:參數(shù)FloorData80個的byte4個byte20組電梯參數(shù)。每組的第一個byte是電梯號，第二到四個byte是樓層。當(dāng)每組的第二個byte0時，后面的兩個byte表示連續(xù)樓層的起始樓層和結(jié)束樓層。各組電梯參數(shù)的電梯號可重復(fù)。DeviceNO3個的bytebyte0時，后面的兩個byteOpParasmallint01，代表示例FloorData:array[0..79]of //DeviceNO:array[0..2]ofbyte; //設(shè)備號參數(shù)123表示后面兩個byte表示后面兩個byte注意：LV4_SetParkData(IssueTimeBgTimeEndTimeParkingListOpParaWeekArr:參數(shù)IssueTime：長度為12個字符的字符串，發(fā)卡時間，該參數(shù)暫無作用，這張賓客能使用停車場。其中StartTime的前4位代表年，接下來的月，日，時，分各占，，這張賓客卡不能再使用停車場。字符串的格式與StartTime相似。，ParkingList0~31的byte0~311~32的停1（0）表示該停車場能用；0則表示該停車場不能用。OpPara：一個長度為0~3的byte數(shù)組指針，數(shù)組的0~3個元素依次代表：能否使用全部WeekArr0~6的byte0~6…1（0）表示該日可用；0則表示該日不可用。注意公共返回報錯代報錯內(nèi)0制卡設(shè)備類報對請求失加密狗報錯（包括加密狗引入錯誤對不起加密狗權(quán)限不夠,校驗加密狗失加密狗沒有校驗次數(shù)(已對加密作失對加密狗失加密狗錯加密狗的校驗次數(shù)為其他報數(shù)據(jù)不存在唯一存在指定路徑中找不到()文當(dāng)前的碼很快就超出使用時間，請聯(lián)系經(jīng)銷加密或算法出制卡類公共報不能卡片制當(dāng)前的卡片種類與要求種類不該卡不是本系統(tǒng)的卡（主要是碼不對應(yīng)該卡的與本系統(tǒng)不對應(yīng)（主要是時間不對應(yīng)該卡是本系統(tǒng)的卡，不能制成其它你的軟件與你現(xiàn)在使用的軟件語言比匹系統(tǒng)中的格式錯參數(shù)錯誤,或參數(shù)格式錯hex新加密狗的報對比碼的報新碼格式錯這不是同一組碼的舊碼期格式錯新碼期格式錯新碼的可用時間比舊碼的可用時間還要新碼的可用時間已經(jīng)超新碼的可用時間不到一個星常見問1、碼或設(shè)置的扇區(qū)不正確2、也可能是在