ekey fsx App

[agris]

The new "ekey fsx" App is available for download at the Appstore:

This application can be used 
- to integrate ekey FSX scanners into the LogicMachine environment as KNX sensors (to monitor fingerprints / RFID cards / binary inputs) or as KNX actuators (to control scanner's on-board relay and scanner's LED lights)
- to act as functional alternative to traditional biometric ekey access control solution 'ekey net' or 'ekey home' with multiple extra functions:
       - attached ekey scanners can be configured, operated and monitored online using this app
       - can be registered max. 200 fingerprints
       - can connect up to 8  ekey fingerprint scanners to a single LogicMachine RS485 port or to a ekey USB converter;
       - can hold internal user credentials (fingerprints and RFID cards) in a database;
       - can use LogicMachine lua scripts for functions not included into web application user interface.

The last actual v. 20210228 App user manual can be downloaded :
http://www.ekey.lv/logicmachine/ekey-app...manual.pdf

The ekey FSX fingerprint scanners should be registered with a Access code to enable full functionality of the App.
* Please note, the "Access code" price is extra 40 Eur for each ekey FSX scanner! 
My company also sell the ekey FSX scanners for the same price value as an equivalent ekey home type scanner from ekey-shop.com. 
In this case the Access code price is included in the ordered scanner price.
The registered forum.logicmachine.net users can order scanners with discount (see attached price list).

BR,
Agris

11.11.2020
ekey FSX App v.2020108 is released

The new installation package is now available in the LogicMachine App store and
can be downloaded: - http://www.ekey.lv/logicmachine/ekey-app...201108.ipk

Changes from previous v.20200711:
- The user can now register up to 3 RFID cards.
- Fields for RFID cards in the User records are hidden if there are no active scanners with an RFID option
- Enrollment function is extended with an interactive modal window and the feedback with a positive or negative enrollment result.
   + the fingerprint enroll, delete  functions are temporally blocked until the concurent enrollment process is finished (because of credentials synchronization limitations between scanners) 
- New function to delete the selected log records.
- New function to Save (or export) the selected log records information into csv  (* or xls) file
   + to save the records to the xls file there is available external procedure to install / remove the luaxlswriter and its related packages (not available for LM2,LM3, LM4)
- New external function to update the scanner firmware to v. 06180115

20.07.2020:
The new "ekey FSX" app version available for download:
http://www.ekey.lv/logicmachine/ekey-app/ekey-app-20200711.ipk

The new separate "ekey TA" app with a simple “Time attendance” functionality
http://www.ekey.lv/logicmachine/ekey-app...200711.ipk

The user manual for both apps :
http://www.ekey.lv/logicmachine/ekey-app...manual.pdf


20.04.2020:
New release candidate ekey FSX app version available for dowload:
http://ekey.lv/logicmachine/ekey-app/ekey-app-20200416-rc.ipk

21.01.2020: 
The new ekey FSX app version 20200120 is available for download.
http://www.ekey.lv/logicmachine/ekey-app...200120.ipk

Changes from previous v.20191202:
- new entry point for admin user (In the tab "Scanners": extra <Start>, <Stop> daemon commands)
http://192.168.0.10/apps/data/ekey/index_admin.lp
- serial communication stability improvements
- resolved: after new app installation automatically not found the active RS485 serial port
- resolved: the uncorrect "access error: Possible manipulation of access ...  "  event
- new service commands for scanner fingerprints managment:
      1) Clean the scanner fingerprint/RFID memory:
      2) Copy the fingerprints from the internal database to selected scanner
      3) Copy the fingerprints from the selected scanner to internal database

23.12.2019:
Known errors v.20191202:
1.  After new ekey fsx app installation not automatically found the serial port to which scanners are connected.
The correct RS485 port alternatively can be assigned manually with LM Lua script, using this pattern:
              storage.set("app:ekey:port", '/dev/RS485-2')

02.12.2019: The ekey FSX app version 20191202 is available for download.
User manual: http://www.avu.lv/logicmachine/ekey-app/...manual.pdf

[Joep]

This is a really nice app for the Ekey finger scanners that Agris made.
We used it for a couple of projects already and have to say that it is working very well.
So we can recommend this app in combination with the FSX scanners of Ekey.

[agris]

20.04.2020:
New release candidate ekey FSX app version available for dowload:
http://ekey.lv/logicmachine/ekey-app/eke...416-rc.ipk
New functionality:
1. In the app is added a new tab "Attendance"
2. For User and Scanner records ir added new checkbox "is Time attendance" (TA)
3. the logic to register new TA event:
- The Scanner and the User must be enabled for TA event (User . TA = ' enabled' and Scanner.TA = ' enabled' )
- Time attendance event for every User has 2 directions: registration 'IN' or 'OUT'
registration event 'IN' happens when last attendance record is registered as OUT or not exist, and registration 'OUT' happens when last attendance record is registered as 'IN' .
The scanner after successful registration will show the attendance event direction with short LED lights
- for IN event, the scanner left LED will shortly will show the green colour 0.5s impuls
- for OUT event, the scanner right LED will shortly will show the red colour 0.5s impuls
There is implemented one automatic OUT event Time correction = to its corresponding ' IN ' Event Time , if after the OUT event in time period for the same User in period 1 min is recorder next IN Event. In this case the OUT record has specific "clock" icon in the field "Event time" .

[agris]

20.07.2020:
The new "ekey FSX" app version available for download:
http://www.ekey.lv/logicmachine/ekey-app...200711.ipk

The new separate "ekey TA" app with a simple “Time attendance” functionality
http://www.ekey.lv/logicmachine/ekey-app...200711.ipk

The user manual for both apps :
http://www.ekey.lv/logicmachine/ekey-app/ekey-app-20200711-manual.pdf

New functionality:
1. New filter field "Period" is added to tab "Logs"
2. the tab "Attendance" is transfred to the new "ekey TA" app

[agris]

11.11.2020:
ekey FSX App v.2020108 is released

The installation package is now available in the LogicMachine App store and
can be downloaded: - http://www.ekey.lv/logicmachine/ekey-app...201108.ipk
User manual: http://www.ekey.lv/logicmachine/ekey-app...manual.pdf

Changes from previous v.20200711:
- The user can now register up to 3 RFID cards.
- Fields for RFID cards in the User records are hidden if there are no active scanners with an RFID option
- Enrollment function is extended with an interactive modal window and the feedback with a positive or negative enrollment result.
+ the fingerprint enroll, delete functions are temporally blocked until the concurent enrollment process is finished (because of credentials synchronization limitations between scanners)
- New function to delete the selected log records.
- New function to Save (or export) the selected log records information into csv (* or xls) file
+ to save the records to the xls file there is available external procedure to install / remove the luaxlswriter and its related packages (not available for LM2,LM3, LM4)
- New external function to update the scanner firmware to v. 06180115

[agris]

Thanks to Stefan Künstler from ekey biometric systems for this video:
https://www.youtube.com/watch?v=ty_2nP_mHHk

[agris]

Information about the last actual ekey FSX scanner firmware v.06190506:
The main extra feature of this version is the future to enroll a wide scope of the RFID Mifare cards for scanners with the RFID function:
Now as RFID cards can be used bank cards, public transport cards, and for example the swedish ID06 person identity card for employees https://id06.se/english/

Steps to perform the scanner firmware update:
1) The ekey FSX app v.20201108 must be installed
2) you need to download the firmware file using lua script:
list = io.readproc ('wget -O /home/apps/store/user/ekey/update06190506.eku www.ekey.lv/logicmachine/firmware/update06190506.eku')
log(list)
3) and after execute the update separate for each scanner with the cmd :
http://192.168.0.10/apps/data/ekey/api.l...re=6190506
The result of FW update command you can see in the ekey fsx app log list.
4) After the FW update please restart the LM device!

[agris]

New "ekey FSX app" v.20210228 is available for download:
http://www.ekey.lv/logicmachine/ekey-app...210228.ipk
User manual:
http://www.ekey.lv/logicmachine/ekey-app...manual.pdf

Changes from previous v.20201108:

+ Now Is possible to do the more scenarios with ekey FSX app software, like
Scanner #1 activates door A and door C,  'unknown finger' activate object D
Scanner #2 activates door B and door C ,  user with 'no rights' activate the object E, binary-input of the scanner activate the door B from inside

Each scanner can respond on multiple event types , like positive access events ('enter') , negative access events ('no-rights'), wrong user identification ('bad-finger') and
the 'binary-input'  (available on scanners with the built-in relays).  For positive access events the are available 9 different Keys.
To realize this function each scanner has new configuration records to assign those event types  to  specific predefined Tasks

"Tasks" also are the new terms implemented in the app.  Tasks are defined as the combination of Objects (KNX data groups)  and predefined Actions (none, on/off short, ... , toggle)
The app has the new tab "Tasks"  and this new tab replace the  tab "Action" from the older app version
For example, Tasks are:  'Door 1 - open 3 sec';  'Door 2 - toggle on/off',  'Alarm - On', etc.

the User credentials (fingerprints & rfid cards) is attracted to Keys  numbered from 1 .. 9 (visually in same way as previous with Actions).
By assigning multiple Keys to different User credentials now it is possible for each scanner positive access event execute different Tasks based on Keys assigned to User fingerprints.

* This is similar method in the "ekey multi" system where user finger keys make logic to switch different relays from the one scanner.

When you update the "ekey FSX app" from v.20201108 to v.20210221 then
all required Tasks are created automatically according to previous configuration
all Actions previous assigned to User credentials (fingerprints and RFID cards) now are the Keys
all Tasks are assigned to Keys for each scanner
so you don't need to make additional changes to your existing configuration

+ scanner:  switch OFF the scanner status LED light (to make it invisible at night)
+ scanner:  locate scanner function (start/stop flashing function LED lights)
+ scanner:  existing service commands available to execute from the app:
Restart - restart the scanner
Clean -  delete all credential (fingerprint and RFID card) information from the scanner
SyncToDB - copy all credentials from scanner to internal database
SyncFromDB - copy all credentials from internal database to scanner

+ you can create a new resident script to control the ekey daemon status using internal function:
- check if ekey daemon is already running using predefined 1 bit KNX data object for this purpose, like  '8/2/6' in this example:
-----------------------------------------------------------
require('custom.ekey.lib')
ekeylib.check_ekey_daemon ( '8/2/6' )
-----------------------------------------------------------

+ if you are using in parallel the old scada-version then this version is not fully compatible with this app:
User fingerprints there are as previous assigned to Actions. But actually they are used as Keys.
The scanner field Object is not more functional due to new method of assigning multiple Tasks to scanner

*  Don't forget after the update to restart the LM device and clear the browser cache (Ctrl+F5)!