ENTR Project Jan, 01, 2017 ENTR Dongle Communication protocol document Revision: 6.1 Date 11-01-17 Proprietary Notice The information contained in this document is proprietary to Mul-T-Lock. Use or transfer of this document or the information contained herein without the express written consent of Mul-T-Lock is prohibited.
ENTR Project Jan, 01, 2017 Rev Description Name Date 1.0 Initial release David Termin 06-04-15 2.0 Parag. 3.2- More detailed added. David Termin 15-04-15 Signature Parag. 4- Unified tables Add Parag.2.3 Add Parag. 6-Key generation procedure 3.0 Add 'get status' command 07-05-15 4.0 Rearrange step by step procedure on parag. 3 03-06-15 5.0 Delete ,correct status register mapping 6.0 Change parag. 4.2 and 3.3.8 6.1 Add FW update capability on parag. 3.3.
ENTR Project Jan, 01, 2017 Contents 1 2 3 4 5 6 7 1. Introduction .......................................................................................................................................................4 1.1 Scope............................................................................................................................................................ 4 1.2 Purpose............................................................................................................
ENTR Project Jan, 01, 2017 1. Introduction 1.1 Scope This document describes the spec for the BLE USB dongle communication protocols. The module will serve the SW engineers and integrators. An integrator is a person that owns the knowhow of the home automation API protocol and commands and how to integrate it to our BLE API. Along with that it will attach the SPI master and UART/USB source codes. 1.2 Purpose The protocol addresses the following needs: Request of a general system status.
ENTR Project Jan, 01, 2017 2 USB Dongle ICD No ICD needed, insert to any standard USB host port. 2.1 Real Estate external [mm] 1 PCB [mm] enclosure Length Width Height Length Width Height P-220705 57.15 12.7 1.57 19.05 52.08 14.74 Figure 2- Real Estate, dimensions: (L)57.15 x (W)19.05mm inc.
ENTR Project Jan, 01, 2017 2.1 Temperature -10~+60C. 2.2 Voltage +5V+5%, Low power (<100ma) USB 2.0 standard 2.3 Current Consumption Max. 30ma@5V. 3 USB (UART COM port) Overall Description 3.1 Open a virtual command window Install the windows driver (32/64 bit) into the PC. Insert the BLE dongle into the Server/PC USB host port. Check that the driver recognized the dongle. Open a terminal (etc. putty/TeraTerm) and select the appropriate virtual COM port. Enable echo on.
ENTR Project Jan, 01, 2017 All data is sent as hex data printed as two 0-F textual digits. Strings can for example be converted using https://www.branah.com/ascii-converter, by putting the textual string in the ASCII field, selecting “Remove 0x” checkbox, and copying the values in “Hex” window. No delimiters between values. For example: Send a byte of 0xAB 0xF0, need to send the string "ABF0". 3.3 Examples of step by step command structure 3.3.
ENTR Project Jan, 01, 2017 7401313233343536 Dongle/UART Figure 3-Getkey Transaction Message structure Getkey 1 123456 7401313233343536(ASCII) After sending the GetKey command you will receive an FE(acknowledge) or FF(Non acknowledge) response. 3.3.5 Unlock 0x7B(see table on paragraph 6) 7B506176656c6f636b00 Dongle/UART Figure 4-Unlock Transaction Message structure Unlock 7B506176656c6f636b00(ASCII) The 506176656c6f636b00 is the lock name that you receive from the 0x72 message.
ENTR Project Jan, 01, 2017 7A506176656c6f636b00 Dongle/UART Figure 5-Lock Transaction Message structure Lock 7A506176656c6f636b00(ASCII) The 506176656c6f636b00 is the lock name that you receive from the 0x72 message. After sending the lock command you will receive an FE(acknowledge) or FF(Non acknowledge) response. 3.3.8 In response you receive a 0x70 Status (see paragraph 4.
ENTR Project Jan, 01, 2017 3.3.10 ShowKeysLock 0x73(see table on paragraph 4.2) 7300 Dongle/UART Figure 7-ShowsKeysLock Transaction Message structure ShowKeyLock 0 7300(ASCII) 4 Remote Unit Commands The tables below are Commands, statuses and errors and are defines as the message part. 4.
ENTR Project Jan, 01, 2017 Remote Lock Status 0x7A 0x70 LockName+’\0’ StatusBitmap+ BatteryPercent Get Status Search Keys 0x7C 0x71 LockName+’\0’ None KeysFound 0x72 Count/ID(1 byte) + LockName+’\0’ ShowKeyLock GetKey 0x73 0x74 ID (1 byte) ID (1 byte)+ PIN (6 bytes) ACK NACK Factory reset 0xFE 0xFF 0x06 None Error code 0x80 compared). NACK will be sent on errors with following error codes 0x10-0x12.
ENTR Project Jan, 01, 2017 An ASSA ABLOY Group Brand Page 12
ENTR Project Jan, 01, 2017 6 Pending key generation process through the smartphone App Assuming the ENTR DU is already paired to the smartphone.
ENTR Project Jan, 01, 2017 Tap on “Add User” An ASSA ABLOY Group Brand Page 14
ENTR Project Jan, 01, 2017 Enter the user name, generate the key code, and share or remember the code for the process of getting the key through the integration unit.
ENTR Project Jan, 01, 2017 On Success you will see the following screen: From this moment, for the predefined expiration time, the key will be waiting in the lock until it will be pulled from the lock using the code. The key pulling can be done by the integration unit or any other phone user possessing the code.
ENTR Project Jan, 01, 2017 7 For radio enclosure Federal Communications Commission requirement for (FCC) Statement Labelling small device statement (FCC15.19(3)) This device complies with part 15 of the FCC Rules. Operation is subject to the following two conditions: (1) This device may not cause harmful interference, and (2) this device must accept any interference received, including interference that may cause undesired operation. 7.1 Radio Frequency Interference (RFI) (FCC 15.
ENTR Project Jan, 01, 2017 Product FCC ID: 2AHH881132 7.3 Modifications (FCC 15.21) Changes or modifications to this equipment not expressly approved by Mul-T-Lock® may void the user’s authority to operate this equipment. 7.4 RF warning for Portable device The device has been evaluated to meet general RF exposure requirement. The device can be used in portable exposure condition without restriction.