Card Issuance Integration Guide
This document explains the hotel card issuance integration process.
Orbit Interface Integration Steps


Step 1: Interface Authorization
1.1. Open the Orbita Door Lock System

1.2. Click the "Authorization" button;

1.3  After successful authorization, close the card - issuing middleware


Step 2: Call Functions(Subject to the actual situation.

2.1、Connect encoder

__int16 __stdcall dv_connect(__int16 beep);

Parameters

beep:[in]    Value is 1, Encoder buzzer beep .

Return

Succeed then return 0.

2.2、Switch off encoder

__int16 __stdcall dv_disconnect();

Return

Succeed then return 0.

2.3、Read data

__int16 __stdcall dv_read_card(unsigned char* cardno,unsigned har* building,unsigned char* room, unsigned char* commdoors, 

unsigned char* arrival, unsigned char* departure,unsigned char* cardID);

Parameters

cardno:[out] Card number returned, 6 characters.

building:[out] Building number,2 characters.

room:[out] Room number returned,4 characters.

commdoors:[out] Common doors return, Range is 00-FF.control 8 areas.(8 bit binary.)

arrival:[out]Return  check-in time,Format:yyyy-MM-dd hh:mm:ss.19 characters.

departure:[out] Return check-out time,Same format with "arrival".

cardID:[out] Return UUID, 8 characters.

Return

Succeed then return 0.

2.4、Write data

__int16 __stdcall dv_write_card( unsigned char* building, unsigned char* room, unsigned char* commdoors, unsigned char* arrival, 

unsigned char* departure, unsigned char* suspendnum, __int16 mode,  unsigned char* cardID);

Parameters

building:[in] Building number,2 characters.

room:[in] Room number, 4 characters.

commdoors[in] ] Common doors, Range is 00-FF. Control 8 areas.(8 bit binary.)

arrival:[in] heck-in time, Format:yyyy-MM-dd hh:mm:ss.19 characters.

departure:[in] heck-out time, Same format with “arrival”.

suspendnum:[in]suspend,6  characters.

mode: [in] Type, 1 to report the loss; 0 to not report the loss. 

cardID:[out] Returns UUID, 8 characters.

Return

Succeed then return 0.

2.5、Delete data

__int16 __stdcall dv_delete_card(unsigned char* room);

Parameters

room:[out] type is the guest card, then return room number.

Return

Succeed then return 0.


Error coders list

Value      Description

-1     Interface error

-2     Connect encoder failed

-3     Register encoder failed

 -4     Buzzer mute

-5     Not supported card type

-6     Wrong card password

-7     Wrong supplier password

-8     Wrong card type

-9     Wrong authorization code

-10     Find card request failed

-11     Find card failed

-12     Load card password failed

-13     Read device information failed

-14     Read card failed

-15     Write card failed

-16     Reauthorization required






Interface demo(test)

1. Open the obt.exe  

2. Click the "Connect" button

3.Write card demo

a.Input  the  corresponding  content   


b.Put  the  guest  card  on  the  encoder,click “Write  data”


 4.Read card demo
 Put the card on encoder,click “Read data”   

 

5.Delete card demo  
PS:When write data,the card content will be coveredPut the card on encoder,click “Delete data”