Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Next revision
Previous revision
en:support_wireless_door_lock_via_osdp_integration [2024/02/29 10:13]
jake created
en:support_wireless_door_lock_via_osdp_integration [2024/03/21 17:13] (current)
jake
Line 11: Line 11:
 <callout type="​primary"​ icon="​true"> ​ <callout type="​primary"​ icon="​true"> ​
 What you need to know before starting "​Wireless Door Lock Integration"​ of CoreStation:​ \\ What you need to know before starting "​Wireless Door Lock Integration"​ of CoreStation:​ \\
-  - Only CSN Cards that types of MIFARE or DESFire can be supported for this function. +  - Only **CSN Cards** that types of **MIFARE** or **DESFire** can be supported for this function. 
-  - This feature operates on the basis of related license activation. +  - This feature operates on the basis of related ​**license activation.** 
-  - The supported OSDP version is v2.2 for now.+  - The supported OSDP version is **v2.2** for now.
 </​callout>​ </​callout>​
  
Line 24: Line 24:
   * Configuration \\ {{:​en:​p2.jpg?​600|}}   * Configuration \\ {{:​en:​p2.jpg?​600|}}
  
-  * Data Processing Order  \\ 1) Scan the enrolled card on the Wireless Door Lock \\ 2) Send the card data to the OSDP antenna via wireless communication(BLE) \\ 3) Send the card data to the CoreStation via OSDP \\ 4) CoreStation compares the received card data and stored card data in it and sends the results to the OSDP antenna via OSDP \\ 5) OSDP antenna sends the result to the Wireless Door Lock via wireless communication(BLE) \\ 6) Wireless door lock displays the results of either Green LED or Red LED depending on the results from CoreStation \\+  * Data Processing Order  \\ 1) Scan the enrolled card on the Wireless Door Lock \\ 2) Send the card data to the OSDP antenna via **wireless communication(BLE)** \\ 3) Send the card data to the CoreStation via **OSDP** \\ 4) CoreStation compares the received card data and stored card data in it and sends the results to the OSDP antenna via OSDP \\ 5) OSDP antenna sends the result to the Wireless Door Lock via **wireless communication(BLE)** \\ 6) Wireless door lock displays the results of either ​**Green LED** or **Red LED** depending on the results from CoreStation \\ 
 + 
 +<callout type="​primary"​ icon="​true">​  
 +When adding the **OSDP antenna** and **Wireless Door Lock** in BioStar 2, you can see the icon on each product as below. 
 +</​callout>​ 
 + 
 +  * **OSDP Antenna** \\ {{:​en:​p3.png?​100|}} 
 +  * **Wireless Door Lock** \\ 1) **Knob type** \\ {{:​en:​p4.png?​100|}} \\ 2) **Handle type** \\ {{:​en:​p5.png?​100|}} \\ 
 + 
 +===== Basic Concepts ===== 
 +Please find the below major features on **"​Wireless Door Lock"​** ​
  
 ==== <Feature 1> ==== ==== <Feature 1> ====
-The users can use and activate the only one between either CSN Mobile or **Template on Mobile.** \\ +You can add up to **TWO OSDP antennas** ​and **TWELVE Wireless Door Locks** per ONE CoreStation. 
-In short, it means that the Mobile Access Card of "Template on Mobile" ​IS DISTINGUISHED from the existing Mobile Access Card of "CSN Mobile"​. ​\\ {{:en:1.png?400|}}+ 
 +<callout type="primary" ​icon="true">  
 +  * **ONLY ONE** OSDP antenna module can be connected per **ONE** RS-485 port of CoreStation via OSDP. 
 +  * Up to **SIX** Wireless Door Locks can be added per **ONE** OSDP antenna module. 
 +</​callout>​
  
 ==== <Feature 2> ==== ==== <Feature 2> ====
-Two types of cards are supported for ToM as ToM_AoC (Access on Mobile) and ToM_SCC (Secure Credential Mobile) and those inherit properties of Suprema'​s smart card "AoC and SCC"​. ​For more details about AoC and SCCplease refer to the following article\\ +It needs to have a **specific license** to use this new function ​"Wireless Door Lock"​. ​**So you SHOULD purchase the specific license for this function FIRST** ​and activate the license file you receive after purchase in BioStar 2. Only after thatyou can add the OSDP antenna on CoreStation in BioStar 2.
-https://​support.supremainc.com/​en/​support/​solutions/​articles/​24000015986--biostar-2-difference-between-secure-credential-and-access-on-card-smart-card-+
  
 <callout type="​primary"​ icon="​true"> ​ <callout type="​primary"​ icon="​true"> ​
-For deleting ​the issued either ToM_AoC and ToM_SCCyou must BLOCK the card firstly\\ {{:​en:​pic_1.png?​400|}}+For more details about how to activate ​the license file in BioStar 2please refer to the begging part of Execution Procedure in this article.
 </​callout>​ </​callout>​
  
 ==== <Feature 3> ==== ==== <Feature 3> ====
-ToM supports both **Regular** and **Dynamic type** of Mobile Access CardFor more details about Regular and Dynamic cards, please refer to the "3. New Features"​ of the following link.\\ +You should purchase and use separately the **TWO types of products** (**OSDP Antenna and Wireless Door Lock**) manufactured by U&Z to use this new featureTo check which models are available in each product, please refer to the below. \\ 
-https://​mocasystemen.crunch.help/​en/​admin/​site-type+  - OSDP Antenna**Only one** model can be supported\\ **CX8936 BLE** \\ 
 +  ​Wireless Door Lock: **Two types** of model can be supported (**Knob ​type or Handle type**) \\ **Knob type : CX212x** \\ {{:​en:​p6.jpg?​400|}} \\ **Handle type : CX217x** \\ {{:​en:​p7.jpg?​400|}}
  
 ==== <Feature 4> ==== ==== <Feature 4> ====
-There is **NO specific license** to use ToM but it requires applying ​the "​credit policy" ​in the existing license rule depending on either Dynamic or Regular Site.\\ +When using this new feature, you can use the below functions by setting ​in BioStar 2. \\ 
-For more details of the "​credit policy"​please refer to the following link. \\ +  - Use the Wireless Door Lock as Entry device or Exit device when configuring the door \\ **Note that** \\ 1) If you select ​the Wireless Door Lock as Entry deviceyou SHOULD select ​the Wireless Door Lock as Exit device. \\ 2) If you select the Wireless Door Lock as Entry device or Exit device, there is NO POPUP for relay settings \\ {{:en:​p7.jpg?​300|}} 
-https://​mocasystemen.crunch.help/​en/admin/site-license+  ​Set and use Trigger & Action (How to configure Trigger and Action on Setting) 
 +  - Set and use APB function in Zone (How to configure an Anti-Passback) 
 +  - Can be used for Access Control \\ **Note that** \\ 1) **Only CSN Cards that types of MIFARE or DESFire can be supported for this function** \\ 2) You CAN set the schedule about the set Access Group \\
  
 ==== <Feature 5> ==== ==== <Feature 5> ====
-When enrolling ​the Visual Face to the Suprema device or trying to authenticate using ToM, the template of Visual Face IS NOT saved in the device but only sent to the user's Mobile Access Card+When using the Wireless Door Lock, the user's card data is encrypted by **SCB key** and then, the encrypted data is sent to the OSDP antenna. The key is generated automatically when adding the CoreStation in BioStar 2. \\ 
 + 
 +<callout type="​primary"​ icon="​true">​  
 +If adding the OSDP antenna on CoreStation normally, the popup for setting SCB KEY in CoreStation is inactivated. 
 +</​callout>​ \\ {{:​en:​p8.jpg?​300|}}
  
 ==== <Feature 6> ==== ==== <Feature 6> ====
-When trying to authenticate using ToMSuprema device deletes all information of the Mobile Access Card including ​the template after matching ​the template in the card and the face scanned by the device.+When trying to authenticate ​at the Wireless Door Lock using the **CSN card**you can get the below results. \\ 
 +  * If the authentication **SUCCEEDS**, ​the **Green LED** is turned on the Wireless Door Lock  
 +  * If the authentication **FAILS**, ​the **Red LED** is turned on the Wireless Door Lock 
  
 ===== Precautions ===== ===== Precautions =====
-  - You can add the "Visual Face" ​and do authentication using ToM in "Slave Device" ​If both Master and Slave devices support the ToM. +1. You should select ​the Baud Rate of CoreStation as **115200** about the connected port with the OSDP antenna, if the product set including OSDP antenna and wireless door lock is **purchased through Suprema.** \\ 
-  - For nowBioStation 3 using the specific firmware version (v.1.2.0 or higher version) will support this function only. HoweverFaceStation F2 will also support this function in the future.+<callout type="primary" ​icon="true" 
 +Howeverif the above product set has been purchased through other roots but not Supremayou should set the Baud Rate of CoreStation as 9600 about the connected port with the OSDP antenna. 
 +</​callout>​
  
-===== Execution Procedure =====+2. You can set the OSDP ID **from 0 to 119** per ONE OSDP antenna module. \\ 
 +<callout type="​primary"​ icon="​true">​  
 +You CAN NOT change the OSDP ID on the OSDP antenna after you add the OSDP antenna to the CoreStation normally. 
 +</​callout>​
  
-==== Step 1Create a site in Airfob Portal ==== +3You **CAN NOT directly enroll** the card to be used by reading the card on the Wireless Door LockSo you need to enroll the card to be used on the other added device in BioStar 2 in advance ​and then, synchronize the enrolled card to the CoreStation. \\
-=== Step 1-1. === +
-Go to Airfob portal (https://​portal.airfob.com/​signin) ​and login to the web-siteThen, create a site by clicking **"​Create Site"​.** ​\\ +
-{{:​en:​pic_.png?​200|}}+
  
 +4. You can check the **BATTERY Status** of the Wireless Door Lock in the **Wireless Door Lock Status** of **MONITORING** in BioStar 2. \\ {{:​en:​p9.jpg?​300|}} \\
 <callout type="​primary"​ icon="​true"> ​ <callout type="​primary"​ icon="​true"> ​
-When creating a site, you need to select a proper ​**Mobile Access Card** type between either ​**Regular** or **Dynamic** depending on your needsFor more details, please refer to the following link \\  +You can get the changed battery status of Wireless Door Lock whenever the battery status has been changed by selecting options among the 3 types of battery status**(Low battery level, Critical battery level and Empty battery)** and setting the alert with it at **Alert** in **Settings** of BioStar 2. \\ {{:en:p10.jpg?300|}} 
-https://​mocasystemen.crunch.help/​en/​admin/​site-type ​\\ {{:en:pic_2.png?300|}} +</​callout> ​\\
-</​callout>​+
  
-=== Step 1-2=== +5. **The license purchase unit is based on ONE Wireless Door Lock.** \\ 
-Check the **Site ID** for the created site. You can find it at **Settings > Site > Site ID.** \\ +
-{{:​en:​pic_3.png?​300|}}+
  
-==== Step 2. Configuration of Mobile Access in BioStar 2 ==== +===== Execution Procedures ​===== 
-=== Step 2-1. ==+<callout type="​primary"​ icon="​true"> ​ 
-Login to BioStar 2 and then, go to **Settings ​MOBILE ACCESS** ​\\ {{:​en:​pic_4.png?​200|}}+You **SHOULD** purchase the **license** first before following these procedures. So please contact our sales representative in your region first and then, purchase the license file depending on the NUMBER of Wireless Door Lock you want to use. 
 +</​callout> \\
  
-=== Step 2-2. === +==== Step 1. Set the CoreStation and enroll the card ==== 
-Put the proper information on the page of **MOBILE ACCESS** referring to the following rules. After the completion, click Connect. \\ +=== Step 1-1. === 
-{{:en:pic_5.png?600|}} \\ +Once you have purchased ​the license, log in to BioStar 2 and go to **LICENSE** in **Settings**. \\ {{:en:p11.png?200|}} \\ 
-  Mobile Access Setting : Enable the option by selecting the Use +Then, go to **Deivce License** and click **Browse** \\ {{:en:​p12.png?​400|}} \\ 
-  ​Site ID : Put the Site ID in Step1-2 +After that, select and open your license file. Then, you can find the information on the license. At this time, click **Activate** if there is no problem. \\ {{:en:​p13.png?​500|}} ​ \\
-  ​Password ​Put the password for login to the Airfob portal +
-  ​Email Put the Email for login to the Airfob portal+
  
-=== Step 2-3. === +=== Step 1-2. === 
-To register the device ​in which the mobile card will be used, Click Add and select the device you want to useAnd then click Close \\  +Add your **CoreStation** ​in **DEVICE** \\ {{:​en:​p14.png?​400|}} \\ 
-{{:en:pic_6.png?600|}}+And update ​the f/w to **v.1.7.1 or above** ​\\ {{:en:p15.png?400|}} \\
  
-==== Step 3. Enroll ​a ToM as a Mobile Access Card in BioStar 2 ====+=== Step 1-3. === 
 +Enroll ​the card to be used via other Suprema devices first and then, synchronize the user's data to the CoreStation. For the synchronization,​ there are automatic method and manual methods ​as the below. 
 +<callout type="​primary"​ icon="​true">​  
 +Only CSN Cards that types of **MIFARE** or **DESFire** can be supported for this function. 
 +</​callout>​ 
 +  * **Automatic method**: Go to Server in Settings ​in BioStar 2 and go to User/Device Management. And then, select the proper option in Automatic User Synchronization. For more details, please refer to the following article. How to synchronize devices with the server \\ {{:​en:​p16.png?​400|}} 
 +  * **Manual method**: \\ **Option 1.** \\ Go to **USERS** and select the user in which the card has been enrolled. Then, click **Transfer to Device** and select your **CoreStation**. And then, click **Transfer**. \\ {{:​en:​p17.png?​400|}} \\ **Option 2.** \\ **Right-Click** on the added CoreStation in BioStar 2. And them, click **"​Sync Device"​** or **"​Delete data & Sync Device"​** \\ {{:​en:​p18.png?​400|}} \\
  
 +==== Step 2. Connect the OSDP antenna and CoreStation via RS-485 ====
 +=== Step 2-1. ===
 +Connect each RS-485 port of both the OSDP antenna and CoreStation using a cable. \\ {{:​en:​p19.png?​400|}} \\
 <callout type="​primary"​ icon="​true"> ​ <callout type="​primary"​ icon="​true"> ​
-Before following ​to Step3, ​the Email address should be filled in to get the link for the generated Mobile Access Card \\ +Please refer to the cabling for the OSDP antenna.  
-{{:en:pic_7.png?200|}}+  * **RS485A1 and RS485B1** : for RS485 communication 
 +  * **Vin and GND** : for supplying ​the power \\ {{:en:p20.png?400|}}
 </​callout>​ </​callout>​
  
-=== Step 3-1. === +=== Step 2-2. === 
-Select a user who will use ToM and then click Mobile Icon in BioStar 2. \\ +After that, go to DEVICE ​in BioStar 2 and then, **right-click** on the added CoreStation 40Then, selelct **"Add OSDP Device"​** and click **OK** ​\\ 
-{{:en:pic_8.png?300|}}+{{:en:p21.png?400|}} \\
  
-=== Step 3-2. === +=== Step 2-3. === 
-On the below pop-up, select Template on Mobile in Card Type and then, select the one between either ​**Access On Card** or **Secure Credential Card** in Smart Card Type. After that, click Enroll. ​\\ {{:en:pic_9.jpg?300|}} +Then, you can find the RS485 port available now. At this time, select the **Port** of CoreStation which is **connected to the OSDP antenna** \\ 
- +{{:en:p22.png?400|}} \\
-=== Step 3-3. === +
-After that, click Apply on the user's page. Then, you can find the below pop-ups in order.+
  
-  * <First pop-up> \\ {{:​en:​pic_10.jpg?300|}} +=== Step 2-4=== 
-  <Second pop-up> ​\\ {{:en:pic_11.jpg?300|}}+Then, you can find the information for the **connected OSDP antenna** into the selected port. If the information is correct, then click **Apply** \\ 
 +{{:en:p23.png?400|}}
  
-==== Step 4. How to enroll your Visual Face in ToM and activate the Mobile Access Card ==== +After that, you can find the added **OSDP Antenna** ​on your CoreStation. \\  
-=== Step 4-1. === +{{:en:p24.png?400|}} \\
-Enable ​the option for Template ​on Mobile and configure the setting value you want to apply in the device registered in step2-3. \\ +
-{{:en:pic_12.jpg?300|}}+
  
 +==== Step 3. Add the Wireless Door Lock on added OSDP Antenna ====
 <callout type="​primary"​ icon="​true"> ​ <callout type="​primary"​ icon="​true"> ​
-If you want to enroll ​the Visual Face in ToM via this devicecheck the box for Visual Face in ToM Enrollment.+It is possible to automatically add a Wireless Door Lock to the OSDP antenna only when the Wireless Door Lock is in the state of **service mode** first.  
 +To make the Wireless Door Lock the service mode, the **"​SERVICEKEY"​ card** is scanned on the Wireless Door Lock. \\ {{:en:p25.png?200|}}
 </​callout>​ </​callout>​
  
-=== Step 4-2. === +=== Step 3-1. === 
-After accessing ​the user's mail, activate ​the Mobile Access Card by clicking the activation mail for using Mobile Access Card. \\ +Scan the **SERVICEKEY card** on the Wireless Door Lock to be used. Then, If the **SERVICEKEY card** is recognized normally, the LED of the Wireless Door Lock will turn **BLUE**. \\
- +
-=== Step 4-3. === +
-After activating the Mobile Access Card, then tab the Mobile Access Card to the Suprema device. Then, you can find the below pop-up on the device. At this timeplease turn off the screen ​of your mobile and then click Continue.\\ +
-{{:​en:​pic_13.jpg?​300|}} +
 <callout type="​primary"​ icon="​true"> ​ <callout type="​primary"​ icon="​true"> ​
-At this timeplease check if BLE or NFC has already turned on in your mobile depending on the configuration in the above step 4-1+Since LED automatically turns off after a few secondsyou should proceed with the next step before that \\ {{:​en:​p26.png?​200|}}
 </​callout>​ </​callout>​
  
-=== Step 4-4. === +=== Step 3-2. === 
-After thatyou can find the screen of the device on which you can enroll your Visual FaceIf soplease enroll your Visual Face. \\+Before the **BLUE LED** on the Wireless Door Lock goes offRight-click ​the added OSDP Antenna and select **"​Auto Add Wireless Door Lock"​** \\ {{:​en:​p27.png?​400|}} \\ 
 + 
 +=== Step 3-3. === 
 +Then, the OSDP antenna will search for the **Wireless Door Lock in the service mode** and then, add the Wireless Door Lock automatically if there exists the **Wireless Door Lock in the service mode** within the Bluetooth communication radius. If added automatically, ​you can find the below pop-up in BioStar 2\\ {{:​en:​p28.png?​400|}} \\ 
 + 
 +=== Step 3-4. === 
 +Thento complete the adding the Wireless Door Lock, you need to right-click on the added Wireless Door Lock and select **"​Activate Wireless Door Lock"​** \\ {{:en:p29.png?​400|}} ​\\
  
-=== Step 4-5. === +=== Step 3-5. === 
-Finallyall steps are completed so please try to authenticate by using Mobile Access Card as the below. \\+Thenfinally, you can find that the Wireless Door Lock is added normally ​as the below. ​\\ {{:​en:​p30.png?​400|}} ​\\
  
-  * Firsttab the Mobile Access Card to the Suprema device +=== Step 3-6. === 
-  * Secondscan your Visual Face on the Suprema device when the device requests you to scan your face+To verify this functionscan the enrolled card on the Wireless Door Lock. 
 +  * If the authentication **SUCCEEDS**the **Green LED** is turned ​on the Wireless Door Lock  
 +  * If the authentication **FAILS**, the **Red LED** is turned on the Wireless Door Lock 
  
 +**Example) Authentication success** \\ {{:​en:​p31.png?​400|}} \\
 +You can find the authentication results as well in the **Event Log** of **MONITORING** in BioStar 2 \\ {{:​en:​p32.png?​400|}} \\
  
 +===== Demo =====
 +{{youtube>​47xiEgLcg_Q?​700x395}}