Zipato RFID

[HomeSystem.sk 69]

Can someone test it and post the experience. This is exciting.

[m.roszak 509]

RFID Reader (Zipato/BeNext/Wintop) is represented as 2 icons:

1. DoorLock - represents the state of RFID reader

2. BinarySwitch - allows to queue a turnOn action for Notification Sound (build-in beeper)

 

There are 2 possible ways for using RFID Reader.

You can either change device's state by TAG, or by built-in keypad.

 

QUICK GUIDE

 

Available actions for the device:

 

getUserCode(int userId)  // action will check userIdStatus for requested userId

setUserCode(int userId, string userIdStatus, string pinCode, string userName = "")  // action will set User Code for specific userId 

setUserCodeDec(int userId, string userIdStatus, string pinCode, string userName = "")  // action will register TAG Code to specific user 

getMaxUsers // action checks max supported users by the device, automaticcaly triggered during inclusion of the device 

 

Useful properties:

secured(int) // 0 - status HOME; 255 - status AWAY
value(bool) // false - status HOME; true - status AWAY (mapped from property secured)
userCodes(array) // stores information about available users 

 

First steps:

 

1. Include the device to Home Center 2

2. Select Controlled Device for BinarySwitch as "Other Device" using pop-up //OPTIONAL

 

Using TAGs

 

In order to use a TAG to change device state pairing it with the Reader is necessary.

Instruction in located below. 

 

Step-by-step procedure:

 

1. Open Devices TAB

2. Click HOME or AWAY button in the device and place the TAG at the front of build-in keypad

3. In Log Window at the top of the interface, an information will appear about usage of an Unregistered Code with RFID Reader - save the code for next steps, it should look like this "[143,40,31,11,1,32,2,128,0,0]"

4. Using Lua or REST API queue check for userIdStatus for first or more users 

 

example:

 

Please login or register to see this code.

5. WakeUp the device manually by:

- changing state of tamper on the back of the unit

or by

- a Tag read (clicking AWAY/HOME and placing the TAG at the front of the keypad)

or by

- a code enter using a keypad (clicking AWAY/HOME and entering using the keypad) // any 4 to 10 digits confirmed by Enter button

 

6. Check property "userCodes" in API for RFID Reader or use a scene to do it.

 

example:

 

Please login or register to see this code.

 

After running this scene in debug window there will log like below:

 

[DEBUG] 12:07:01: [{"name":"","id":0,"status":"Available"},{"name":"","id":1,"status":"Available"},{"name":"","id":2,"status":"Available" ........ 

 

Supported userIdStatuses:

 

Available  //this userId could be used 

Occupied //this userId is already occupied

ReservedByAdministrator // reserved

StatusNotAvailable // not available 

 

7. Use setUserCodeDec action to register TAG in the device to desired user, userId with status "Available" must be used. Also userId=0 cannot be used. As a PinCode use Code Returned by the device as Unregistered when TAG was used before (step 3 of this guide).

UserIdStatus "Occupied" must be used in action to set a new PinCode for user!

 

example:

 

Please login or register to see this code.

8. WakeUp the device manually by:

- changing state of tamper on the back of the unit

or by

- a Tag read (clicking AWAY/HOME and placing the TAG at the front of the keypad)

or by

- a code enter using a keypad (clicking AWAY/HOME and entering using the keypad) // any 4 to 10 digits confirmed by Enter button 

 

From now on every time the TAG will be used with the RFID Reader to change status (HOME -> AWAY or AWAY -> HOME) device in interface will change state and in the Log Window a information about using the device by specific user will be visible.

 

 

Using build-in keypad

 

In order to use a Keypad to change device state setting a pinCode for specific user is necessary.

Below are instructions how to do it. 

 

Step-by-step procedure:

 

1. Using Lua or REST API queue check for userIdStatus for first or more users 

 

example:

Please login or register to see this code.

 

2. WakeUp the device manually by:

- changing state of tamper on the back of the unit

or by

- a Tag read (clicking AWAY/HOME and placing the TAG at the front of the keypad)

or by

- a code enter using a keypad (clicking AWAY/HOME and entering using the keypad) // any 4 to 10 digits confirmed by Enter button

 

3. Check property "userCodes" in API for RFID Reader or use a scene to do it.

 

example:

 

Please login or register to see this code.

 

After running this scene in debug window there will be something like this:

 

[DEBUG] 12:07:01: [{"name":"","id":0,"status":"Available"},{"name":"","id":1,"status":"Occupied"},{"name":"","id":2,"status":"Available" ........ 

 

Supported userIdStatuses:

 

Available  //this userId could be used 

Occupied //this userId is already occupied

ReservedByAdministrator // reserved

StatusNotAvailable // not availaable

 

 

4. Use setUserCode action to set a PinCode to desired user, userId with status "Available" must be used. As a PinCode use 4-10 random digits.

To set a new PinCode to user as userIdStatus "Occupied" must be used in action!

 

example:

 

Please login or register to see this code.

 

// userId=2 was used there because userId=1 is Occupied by TAG

 

5. WakeUp the device manually by:

- changing state of tamper on the back of the unit

or by

- a Tag read (clicking AWAY/HOME and placing the TAG at the front of the keypad)

or by

- a code enter using a keypad (clicking AWAY/HOME and entering using the keypad) // any 4 to 10 digits confirmed by Enter button 

 

From now on every time this code will be used with RFID Reader (Home -> Away or Away -> Home) device in interface will change state and in the Log Window a information about using the device by specific user will be visible.

 

 

Clearing specific user pinCode 

 

To clear assigned PinCode for specific userId use action setUserCode with userIdStatus=Available and random pinCode (4-10 digits).

 

example:

 

Please login or register to see this code.

 

 

KNOWN ISSUES:

- zero/zeros cannot be the first sign/signs in PinCode string (for example PinCode 0014823 will be interpeted as 14823!)

[m.roszak 509]

There should be a use guide available before stable release, as far as I know Support team is working on it. 
 

[fi-bar-oh 47]

There should be a use guide available before stable release, as far as I know Support team is working on it. 

 

 

lol i am sorry but that is hilarious!... heard of the carrot and the donkey?

Please login or register to see this image.

/emoticons/default_icon_wink.gif" alt=";-)" />

 

can you not just give users an idea on how to use it? pretty sure it would take a user who knows how 'bugzilla' less than 2 mins to populate SOMETHING?

Edited August 30, 2016 by Supernode

[boomx 43]

lol i am sorry but that is hilarious!... heard of the carrot and the donkey?

Please login or register to see this image.

/emoticons/default_icon_wink.gif" alt=";-)" />

 

can you not just give users an idea on how to use it? pretty sure it would take a user who knows how 'bugzilla' less than 2 mins to populate SOMETHING?

 

Yes... We need some infos about this. ^^

[fi-bar-oh 47]

i tried to work it out... using bugzilla comments as a guide but no joy! sorry but someone else can take over as it will be months before you get docs!

[boomx 43]

the same for me

Please login or register to see this image.

/emoticons/default_sad.png" alt=":(" srcset="https://forum.fibaro.com/uploads/emoticons/[email protected] 2x" width="20" height="20" />

[m.roszak 509]

I will add here simple "quick guide" probably today, official guide will be released before stable release as I mentioned before

Please login or register to see this image.

/emoticons/default_smile.png" alt=":)" srcset="https://forum.fibaro.com/uploads/emoticons/[email protected] 2x" width="20" height="20" /> 

[boomx 43]

Nice

Please login or register to see this image.

/emoticons/default_smile.png" alt=":)" srcset="https://forum.fibaro.com/uploads/emoticons/[email protected] 2x" width="20" height="20" /> Thank you. Seems to be a good update ^^

[clausdk 27]

It works. Nice work guys (Fibaro)! 

Please login or register to see this image.

/emoticons/default_icon_wink.gif" alt=";-)" />

Edited August 31, 2016 by clausdk

[fi-bar-oh 47]

much appreciated these little things are what make the difference! forget impressing us with glamorous devices just butter us up with little nuggets!

Please login or register to see this image.

/emoticons/default_smile.png" alt=":)" srcset="https://forum.fibaro.com/uploads/emoticons/[email protected] 2x" width="20" height="20" />

[fi-bar-oh 47]

what exactly is this? i see nothing in api etc... or even the status updates in gui!

 

"name_arg_is_optional"

[m.roszak 509]

This is a value stored in Z-Wave internal database only, not used in the system right now. 

[fi-bar-oh 47]

This is a value stored in Z-Wave internal database only, not used in the system right now.

Will this change so status in GUI shows the allocated name?

Edited September 1, 2016 by Supernode

[m.roszak 509]

This feature will eventually come - for now we prepared as much support for those devices as it was possible at the time - without other major changes/rework in system. 

PS
Instruction in this topic (the part about "Using build-in keypad") will also work with Doorlocks which supports User Codes. 

[fi-bar-oh 47]

Cool

Please login or register to see this image.

/emoticons/default_smile.png" alt=":)" srcset="https://forum.fibaro.com/uploads/emoticons/[email protected] 2x" width="20" height="20" />

[fi-bar-oh 47]

any quick tip on lua

 

if usercode 1 unlocked then <foo>

 

this would be great if you have any idea?

[BusterB1959 7]

I have created a Predefined Variable in the Variables Panel "HomeMode" with 4 values of "Home", "Away", "Night" & "Vacation"

 

I have used the following code to set the HomeMode Variable

 

114 is my keypad ID

 

--[[

114 value

%% properties

%% events

%% globals

--]]

 

-- Script to check status of Lock / Unlock of Keypad by Brent Brown

 

 

if tonumber(fibaro:getValue(114, "value")) == 1 then

  fibaro:setGlobal("HomeMode", "Away")

  else

  fibaro:setGlobal("HomeMode", "Home")

  

end 

[rls46 19]

This feature will eventually come - for now we prepared as much support for those devices as it was possible at the time - without other major changes/rework in system. 

PS

Instruction in this topic (the part about "Using build-in keypad") will also work with Doorlocks which supports User Codes. 

 

confirmed, it works with YALE YDM3168

well done!

[fi-bar-oh 47]

Specific user is the aim... Me armed alarm or wife armed etc...

[boomx 43]

Specific user is the aim... Me armed alarm or wife armed etc...

There are no infos about in the api. So I think it doesn't work at the moment

Please login or register to see this image.

/emoticons/default_sad.png" alt=":(" srcset="https://forum.fibaro.com/uploads/emoticons/[email protected] 2x" width="20" height="20" /> But it would be a nice feature...