Kimaldi FingerVein Online Assembly instructions

Kimaldi Electronics, S.L.
Ctra. Rubí, 292-B Pol.Ind. Can Guitard
08228 Terrassa (Barcelona) CIF B61802302
www.kimaldi.com
Tel: [phone] Fax: [phone]
E-mail: [e-mail]
Installation and
Programming Manual
FingerVein Online
v. 1.00

Table of Content s
Date 12/16/09 Page 2 of 69
Table of Contents
1. About this Manual . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
2. Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
2.1. FingerVein Online electronics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
3. Operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
3.1. FingerVein sensor operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
3.2. Connection to a configurable RS-232 reader . . . . . . . . . . . . . . . . . . . . 7
3.3. Others . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
3.3.1. Information on exceptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
4. Technical Specifications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
4.1. FingerVein Online card . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
4.2. Routing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
4.3. Optical barrier . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
5. Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
5.1. Connector signals . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
5.2. Connection details . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
6. Host communications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
6.1. IP Communications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
6.1.1. Kimaldi Localisation Service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
6.1.2. Bio-OCX protocol via TCP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
6.1.3. Bio-OCX protocol via UDP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
6.1.4. KSP protocol via UDP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
6.2. Routing and Localisation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
6.2.1. Routing hardware . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
6.2.2. KSP Address . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
6.2.3. MAC Address . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
6.2.4. IP Address . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
7. Communication with RS-232 devices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
7.1. RS-232 Reader . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
7.1.1. “Read-only” readers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
7.1.2. Autonomous readers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
7.1.3. Online readers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
8. FingerVein Online electronics configuration . . . . . . . . . . . . . . . . . . . . . . . . 19
8.1. Parameter array . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
8.1.1. Serial port configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
8.1.2. Event configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
8.1.3. Optical barrier configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
8.1.4. Card reading port configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
8.1.5. Digital output timing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
8.1.6. Others . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
8.2. IP configuration - TCP and UDP sockets . . . . . . . . . . . . . . . . . . . . . . 29
8.2.1. ePHY configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30

Tabl e o f C o n tent s
Date 12/16/09 Page 3 of 69
9. Communications Protocol . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
9.1. Bio-OCX RS-232 or TCP/IP frame format . . . . . . . . . . . . . . . . . . . . 32
9.2. Bio-OCX UDP frame format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
9.3. KSP UDP frame format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
9.4. Common Instructions for Online Management . . . . . . . . . . . . . . . . . 35
9.4.1. Communications Test . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
9.4.2. Reset . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
9.4.3. Firmware Version . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
9.4.4. GetCrashInfo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
9.4.5. ClearCrashInfo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
9.5. Specific FingerVein Online electronics instructions . . . . . . . . . . . . . 38
9.5.1. ReadCFG_Byte . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
9.5.2. WriteCFG_Byte . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
9.5.3. ReadCFG_IP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
9.5.4. WriteCFG_IP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
9.5.5. FactoryCFG . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
9.5.6. ApplyCFG . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
9.5.7. Activate Led/Beeper Time . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
9.5.8. Switch Led/Beeper . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
9.5.9. Close Relay . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
9.5.10. Switch Relay . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
9.5.11. Clear Display . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
9.5.12. Write Display . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
9.5.13. Backlit Time . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
9.5.14. Switch Backlit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
9.5.15. Write Display, Backlit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
9.5.16. Digital input status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
9.5.17. Multiread filter status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
9.5.18. Card Reading . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
9.5.19. Key Pressing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
9.5.20. Send to UART . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
9.5.21. Reception from UART . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
9.5.22. Optical Barrier Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
9.5.23. Enable optical barrier . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
9.5.24. Disable optical barrier . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
9.5.25. Encapsulate GCR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
9.6. Error Codes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
10. Biometric identification . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
10.1. Basic instructions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
10.1.1. Recover sensor version . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
10.1.2. Recover last sensor error . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
10.1.3. Sensor reset . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
10.2. Capture of biometric information . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
10.2.1. Capture of biometric information . . . . . . . . . . . . . . . . . . . . . . . . . . 56

Tabl e o f C o n tent s
Date 12/16/09 Page 4 of 69
10.3. Sensor memory management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
10.3.1. Add user . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
10.3.2. Request number of users . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
10.3.3. Delete user . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
10.3.4. Delete all users . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
10.4. User identification . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
10.4.1. Instant Matching . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
10.4.2. Identification . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
Appendix A. Application notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
A.1. FingerVein Online + Mag + Mifare electronics . . . . . . . . . . . . . . . . 61
A.1.1. Hardware Connection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
A.1.2. Terminal configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
A.1.3. KRD13Mv2 reader configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
A.1.4. 1:N Identification . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
A.1.5. 1:1 Identification: . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
A.2. Communication with the Host via RS-232 . . . . . . . . . . . . . . . . . . . . 65
Appendix B. Troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
List of Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
Revision Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
Notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69

FingerVein Online
Installation and Programming Manual
www.kimaldi.com Page 5 of 69
1. About this Manual
This manual applies to FingerVein Online access and presence control electronics,
firmware version 0x65.30.
2. Description
FingerVein Online electronics is designed as an access and/or presence control terminal
based on FingerVein subcutaneous vein pattern reading technology. Default connectivity
is based on both TCP/IP and UDP. Alternatively, communication may be carried out via
RS232. KiWi2 electronics can also be connected for WiFi communications.
FingerVein Online electronics is recommended for all access control applications on
electric locks, displays, leds, buzzers and ticker printers, etc. requiring online operation.
In particular, biometrical identification will be performed on a search engine integrated
into the FingerVein module itself.
FingerVein Online electronics may be controlled with serial commands or with the help
of the Active-X, Kimaldi Bio-OCX controller, the latter method being recommended.
2.1. FingerVein Online electronics
Internally, FingerVein Online electronics is organised in two subelectronics capable of
segregating, in the following way:
1. DB module: includes database, relays and connectivity to Host. It is designed to be
housed in a safe area, a false ceiling for example.
2. User-Interface module (“Main UI”): includes all the User Interface part (card
readers, biometrics, display, keycard, buzzer). It is designed to be exposed to
interaction with the user, generally assembled in a plastic box or panel.
3. If an auxiliary reader is needed, this will constitute a second UI module (“Auxiliary
UI”), for which we can select a degree of operation that is equal to (display and
keycard) or lower than (LEDs) the Main UI.
FingerVein Online electronics has the following hardware resources:
• RJ45 Ethernet connection (10/100-BaseT)
• UART1-DB: First port RS-232 (by default, for Host connection).
• UART1-UI: Second port RS-232 (for FingerVein sensor connection).
• UART2-UI: Third port RS-232 (for card reader connection).
• One Clock&Data port
• Four relays
• One current-limited 5 VDC outlet
• One connector to a 4x4 keypad

FingerVein Online
Installation and Programming Manual
www.kimaldi.com Page 6 of 69
• One 2x20 alphanumeric character, backlit display connector
• One card-mounted buzzer
• Up to six digital inputs
• One KiWi2 Converter connection card

FingerVein Online
Installation and Programming Manual
www.kimaldi.com Page 7 of 69
3. Operation
Thanks to its IP connectivity, FingerVein Online electronics makes it possible to install a
network of biometric sensors or different types of card readers, accompanied by the
corresponding actuators or user interfaces. All the peripherals are Host-managed, except
for the biometric search engine, which is housed inside the FingerVein sensor itself.
Normal operations consist of sending the events that occur to the Host. Normally, these
will be linked to a user ID. The user can simply put his or her finger on the biometric
sensor or start the identification by presenting the card or pressing any key. From hereon,
the Host will launch the identification and save its result. Once the identity of the person
is known, it will be possible to act on an access relay, display a personalised message on
screen or even ask for a code using the keycard.
An aspect that deserves special attention is the possibility to carry out 1:1 identification
with the help of a Clock&Data or RS-232 reader, as indicated in chapter 7.
3.1. FingerVein sensor operation
FingerVein Online electronics allows for several types of use:
• 1:N Identification: the user places his or her finger on top of the biometric sensor.
An optical barrier activation event occurs, after which the Host orders the capture
of the user's fingerprint. The sensor compares it with all the fingerprints in the
database of up to 1,000 users.
• 1:1 Identification: the user is identified using the card or by entering a code. The
Host receives the identification code and retrieves the corresponding
identification code from its database. This fingerprint is sent to the biometric
sensor, after which the sensor itself scans the user's finger to check its identify
with a 1 to 1 comparison (“Instant Matching”).
The FingerVein sensor is controlled through elemental instructions integrated in the
Active-X Kimaldi Bio-OCX.
3.2. Connection to a configurable RS-232 reader
Kimaldi Electronics offers a series of readers (for example, KRD13M and SC42) that
have automatic operating modes and that also allow for two-way communications
between the Host and the reader (normally for configuration tasks).
FingerVein Online electronics is capable of capturing the events generated by these
readers and applying them with the same treatment as if they came from a Clock&Data
reader: automatic buzzer activation and LEDs and multiread filtering, etc.. These
readings are notified from the Card Reading event.
At the same time, two-way communications are permitted between the Host and the
reader from the combination of the Send to UART command and the Reception from
UART event.

FingerVein Online
Installation and Programming Manual
www.kimaldi.com Page 8 of 69
3.3. Others
Another basic aspect of FingerVein Online electronics is the configuration of its interface
with the Host. It has several communication channels, as described in chapter 6.: “Host
communications”
All the aspects related to the operating and connectivity of FingerVein Online electronics
can be configured as explained in chapter 8.: “FingerVein Online electronics
configuration” .
It also incorporates a function for diagnosing faults in the hardware and for remote
firmware updating.
3.3.1. Information on exceptions
If an exception occurs in the operation of the microcontroller, the information on it is
stored in the non-volatile memory of the FingerVein Online electronics. The second time
an exception occurs, the machine restarts automatically.
The most normal thing will be enabling the ApplyCFG event via the CFG_ECHO
parameter (see Subsection 8.1.2.) and notifying Kimaldi Electronics Technical Service if
this event responds to a non-null void frame. The same information can be retrieved at
any time using the GetCrashInfo instruction and can then be deleted with ClearCrashInfo.

FingerVein Online
Installation and Programming Manual
www.kimaldi.com Page 9 of 69
4. Technical Specifications
4.1. FingerVein Online card
Dimensions: OEM cards: 134 mm x 131 mm x 25 mm
Stainless steel terminal box: 142 mm x 209 mm x 82 mm;
Weight 1.5 kg.
Terminal in plastic box 1: 160 mm x 220 mm x 65 mm ;
Weight 750 g.
Power Supply: Voltage: 12 VDC ± 10%
Current: 1A typical
Relay contacts: 4 2relay contacts, normally open, 24V / 1A
Display: LCD Display, 20x2 characters
Keypad: Matricial keypad with 4 rows x 4 columns
Digital inputs: 5 3relay-type digital inputs. In open circuit (contact open)
their logic value will be 0. In contact with earth (contact
closed), logic value 1.
Buzzer: 1 Internal buzzer (operates together with the main reader and
keypad)
Clock & Data input: In the UI module, it allows for a device to be connected that
transmits in Clock&Data with ABA encoding, Track 2.
RS232 Interface: Up to 3 configurable serial ports: communication with the
Host or with card readers. Baud Rate: 9600, 19200 or 38400.
Other parameters: n,8,1.
Outlet for external reader power supply: 5Vdc for the auxiliary reader power supply with
a current capacity of 200 mA.
Ethernet Connection: Protocols: TCP/IP, UDP, ARP, DHCP, ICMP (ping)
Speed: 10/100 BaseT
Connector: RJ-45
Microcontroller: Dual (DB + UI), 32 bit RISC architecture
Clock frequency: 60 MHz in DB electronics, 48 MHz in UI
Memory: EEPROM, Flash, non-volatile SRAM (with lithium battery,
CR2032)
1. Currently unavailable
2. Four serial relays, two more optional
3. There is a sixth input in the UI module for the Anti-Tamper sensor

FingerVein Online
Installation and Programming Manual
www.kimaldi.com Page 10 of 69
4.2. Routing
FingerVein Online electronics has two jumpers (JMP1 and JMP2) to encode the ID
Application in the KSP protocol.
See chapter 6.: “Host communications” for further details.
4.3. Optical barrier
FingerVein Online electronics allows for an optical barrier to detect the presence of the
finger on the biometric sensor to be controlled. In addition to normal operating
conditions, the optical barrier has two possible error situations:
1.- Permanent obstruction of the beam. In its standby state, the optical barrier detects
the beam of light from the LED transmitter. If it does not detect the beam for some
time, this may be due to a mechanical or electronic fault. Under normal conditions, 2
or 3 consecutive identification attempts can be made without removing your finger
from the biometric sensor before this error is triggered. This parameter can be
configured, as explained in Subsection 8.1.3.
2.- Interference by external light sources . If the FingerVein Online electronic terminal
is exposed to extreme light conditions, this can saturate the receiver element, thus
preventing it from detecting the presence of a finger.
Both permanently blocking the beam and saturating the receiver trigger an error
situation, in the event of which the Host will receive notification (Optical Barrier Status
event, code 0xED ). In this situation, a key must be pressed (e.g. the green “Enter” key)
to start the biometric identification.
It will automatically return to normal when the beam of light is no longer obstructed or
the external interference is removed (Optical Barrier Status event, code 0x0D).

FingerVein Online
Installation and Programming Manual
www.kimaldi.com Page 11 of 69
5. Installation
5.1. Connector signals
WA R N I N G !
Take the necessary antistatic precautions when handling this product
to avoid damaging the sensitive electronic devices.
J3
RELAY 1-A RELAY 1-B RELAY 2-A RELAY 2-B RELAY 3-A RELAY 3-B RELAY 4-A RELAY 4-B
J2
5V out GND Tx-232 UI-2 Rx-232 UI-2 DIN_1 DIN_2 DIN_3 DIN_4
1 2 3 4 5 6 7 8
1 2 3 4 5 6 7 8
J14: TTL-0
1
J16: Keypad
J17: Display
J12: FingerVein
J15: DIN_1-UI
J7: Ethernet
Back-up Battery
J11
RELAY UI-2-B RELAY UI-2-A RELAY UI-1-B RELAY UI-1-A
J10
GND DATA TTL-0 CLOCK TTL-0 CLS TTL-0 5V out GND TX-232-Read RX-232-Read
8 7 6 5 4 3 2 1 4 3 2 1
Anti-Tamper
1
1
J5: KiWi
Jumpers: App_ID
UART1-DB
UART2-UI
UART1-UI
UART0-DB
UART0-UI
UART2-DB

FingerVein Online
Installation and Programming Manual
www.kimaldi.com Page 12 of 69
5.2. Connection details
J2 - Main Connector
Pin 1 - Do not connect
Pin 2 - Negative power supply pole (GND) (Pin no. 5 SubD connector)
Pin 3 - Signal Tx 232 to host (Pin no. 2 SubD female connector) or to the
Auxiliary User Interface (UI)
Pin 4 - Signal Rx 232 to host (Pin no. 3 SubD female connector) or to the
Auxiliary User Interface
Pin 5 - Digital input 1
Pin 6 - Digital input 2
Pin 7 - Digital input 3
Pin 8 - Digital input 4
J3 - Relay Connector
Pin 1 - Pole A of Relay 1
Pin 2 - Pole B of Relay 1
Pin 3 - Pole A of Relay 2
Pin 4 - Pole B of Relay 2
Pin 5 - Pole A of Relay 3
Pin 6 - Pole A of Relay 3
Pin 7 - Pole A of Relay 4
Pin 8 - Pole B of Relay 4
J5: Connection to KiWi module.
J7: Ethernet Connector (RJ45 connection)
J10 - Connector to card Readers / Printer
Pin 1 - Signal Rx 232 to the device (Pin no. 2 connector SubD male)
Pin 2 - Signal Tx 232 to the device (Pin no. 3 connector SubD male)
Pin 3 - Power supply negative pole (GND) (Pin no. 5 connector SubD male)
Pin 4 - Output +5 VDC
Pin 5 - CLS signal (TTL_0)
Pin 6 - Clock signal (TTL_0)
Pin 7 - Data signal (TTL_0)
Pin 8 - Power supply negative pole (GND)
J11 - Connector to Signalling Relays (optional)
J12: Connection to FingerVein biometric identification module.
Pin 1 - Do not connect

FingerVein Online
Installation and Programming Manual
www.kimaldi.com Page 13 of 69
Pin 2 - UART1-UI - Tx 232 signal to reader
Pin 3 - UART1-UI - Rx 232 signal to reader
Pin 4 - Power supply negative pole (GND)
J14 - TTL_0 Connector to card Reader:
Pin 1 - Data signal (TTL_0)
Pin 2 - Clock signal (TTL_0)
Pin 3 - CLS signal (TTL_0)
Pin 4 - Output +5 VDC
Pin 5 - Negative power supply pole (GND)
J15: DIN_1-UI digital input. Input enabled when connected to GND, disabled if not
connected.
Jumpers:
Application_ID - Encoded with two jumpers. The default value is 3.
Back-up Battery: this is a 3V lithium battery, size CR2032. If a low battery level is
detected, we recommend replacement of the battery while the equipment is on. This
avoids configuration and device database losses.
In addition, Keypad and Display connections are available for the OEM version of the
equipment:
J16: 4x4 Keypad connector
Pin 1 - Column 3 (OUT) Pin 5 - Row 0 (IN)
Pin 2 - Column 2 (OUT) Pin 6 - Row 1 (IN)
Pin 3 - Column 1 (OUT) Pin 7 - Row 2 (IN)
Pin 4 - Column 0 (OUT) Pin 8 - Row 3 (IN)
J17: Connector to Display 20x2, with incorporated Backlit

FingerVein Online
Installation and Programming Manual
www.kimaldi.com Page 14 of 69
6. Host communications
FingerVein Online electronics allows for several communication channels with the Host.
Establishing this communication is the first step towards correctly configuring the
electronics. FingerVein Online electronics is permanently listening to these channels and
will return a response via the channel from which the command was received.
We shall deal only with IP communications. For information on communications via RS-
232, please see Appendix A.2.
6.1. IP Communications
To access the IP communication services, the network parameters must be configured
correctly. Configuration can be carried out using the Bio-OCX protocol, via RS-232. In
this case, we shall deal with the parameters described in Subsection 8.2.. Alternatively,
the Kimaldi Localisation Service detailed below can be used. Once the equipment is
configured, there will be one TCP/IP Socket and two different protocols via UDP
Sockets.
6.1.1. Kimaldi Localisation Service
It is possible to detect the FingerVein Online electronics connected to your local area
network using the Kimaldi Localisation Service:
• IP configuration: once the unit is located from its MAC Address, it is possible to
configure its IP parameters and restart the unit.
• The localisation request from the Host to the FingerVein Online electronics is made
via port 2000.
• The frame reception in the Host from the FingerVein Online electronics is made
using port 2001.
There is a DLL that allows this Service to be integrated into any software application.
For further information on the low-level protocol, please see the SLK Programming
Manual.
6.1.2. Bio-OCX protocol via TCP
The Bio-OCX protocol is also available via a TCP Socket, which makes it fully
compatible with the KiWi2 convertor module:
• FingerVein Online electronics is in server mode. Therefore, frames from any Host
can be accepted (please see SLK-Safety in chapter 8.2) The connection socket
will be started by the Host. FingerVein Online electronics will only generate TCP
events while this socket is enabled.
• Commands from the Host to the FingerVein Online electronics are transmitted
through an arbitrary Host port (Local Port of the Host).
• The frames are received at the FingerVein Online electronics via port 1001 (Remote
Port from the Host).

FingerVein Online
Installation and Programming Manual
www.kimaldi.com Page 15 of 69
The serial frames will consist of ASCII-Hex values according to the frame format
generated by the Bio-OCX controller (see chapter 9).
The CFG-DB_EventsChannel parameter is not applicable in this case, as TCP events
cannot be generated spontaneously (i.e. events will not be generated until the Host has
started the socket).
In contrast, it is possible to have an open TCP against a different computer to the one
declared as the Remote Host. Great care must be taken in this case, as there could be two
Hosts acting simultaneously on the FingerVein Online electronics.
6.1.3. Bio-OCX protocol via UDP
Finally, the Bio-OCX protocol is also available via a UDP Socket:
• Commands from the Host to the FingerVein Online electronics are transmitted via
the port chosen from the Host (Local Port of the Host). From a FingerVein
Online electronics viewpoint, this is the Remote Host Port that can be configured
(see Subsection 8.2., parameter 7) and that is 0 by default (automatic
assignment).
• The frames are received at the FingerVein Online electronics via port 5500 (Remote
Port from the Host).
The frame format will be binary and will not have the <STX>, <ETX> delimiters.
The CFG-DB_EventsChannel parameter should take the $07 value for the FingerVein
Online Electronics to spontaneously transmit Online frames through this channel.
6.1.4. KSP protocol via UDP
Finally, FingerVein Online electronics allows for work with the new Kimaldi Stackable
Protocol (KSP). KSP operates via another UDP Socket:
• Commands from the Host to the FingerVein Online electronics are always
transmitted via Host port 6001 and using Broadcast IP frames. This means that a
special frame format will be used that will allow us to specify the node at KSP
level.
• The frames are received at the FingerVein Online electronics via port 6000 (Remote
Port from the Host).
• One significant advantage in relation to the Bio-OCX protocol is that the Host may
receive all Online Event frames generated from any KSP mode via just one
Socket on port 6001. These frames also carry the address of the node to have
generated them.
There is an ActiveX control to interact with the FingerVein Online electronics via KSP.
Please see the corresponding manual for further details.
The CFG-DB_EventsChannel parameter should take the $08 value for the FingerVein
Online Electronics to spontaneously transmit Online frames through this channel.

FingerVein Online
Installation and Programming Manual
www.kimaldi.com Page 16 of 69
6.2. Routing and Localisation
FingerVein Online electronics can form part of a local IP network, supporting several
communication protocols. There are several routing modes for this reason. The different
FingerVein Online electronics addresses can be consulted in the configuration
instructions (also see chapter 8.2 ) or Kimaldi Localisation Service (see SLK -
Programming Manual).
6.2.1. Routing hardware
In terms of Hardware, the FingerVein Online electronics has two jumpers (JP2 and JP1;
see chapter 5.1.: “Connector signals” ) to encode the high part (Application_ID) of the
bus address. Its low part is encoded through a byte in the configuration.
The extended address of the node shall be binary encoded for the 10 bits: Jumpers (2,1),
CFG_KSP_AddrLo. With JP2 being the heaviest bit, followed by JP1 and then the
configuration byte. The jumpers take logic value 1 when the bridge is on and 0 if not.
The FingerVein Online electronics reads the configuration of the jumpers on receiving
the power supply. Therefore, if the address is to be changed, the power supply should be
switched off for a moment or and an ApplyCFG instruction sent for the changes to take
effect.
6.2.2. KSP Address
If we communicate with the FingerVein Online electronics via KSP (Subsection 6.1.4.),
the address corresponding to it is determined in the following way:
- KSP Application: this has a value between 11 and 14 ($0B and $0E), obtained by
adding 11 to the JP1, JP2 value.
- KSP ID: this is an 8 bit value ranging from 1 to 254 ($01 and $FE) that is
expressed by the configuration byte CFG_KSP_AddrLo.
6.2.3. MAC Address
The MAC Address of each FingerVein Online electronics is unique and assigned by the
manufacturer. It is labelled above the electronics in hexadecimal format.
6.2.4. IP Address
The IP address of each FingerVein Online electronics will be user-assigned based on the
characteristics of the local area to which it is connected. This is generally a configuration
field, which can be user-modified through the Kimaldi Localisation Service or any service
for connection to the Host (see all configuration fields in chapter 8.2).

FingerVein Online
Installation and Programming Manual
www.kimaldi.com Page 17 of 69
7. Communication with RS-232 devices
FingerVein Online electronics has two RS-232 ports that can be used for different
purposes.
As explained in Appendix A.2, the UART1-DB maintains the possibility of connection to
the Host so that total compatibility between BioMax, FingerVein Online electronics and
FingerVein Online is ensured.
Therefore, the UART2-UI port is normally used to connect additional RS-232 devices.
To date, these devices will be of the following types:
7.1. RS-232 Reader
7.1.1. “Read-only” readers
A reader that transmits the user identification code through the serial port can normally
be connected to the UART2-UI. This would be, for example, a proximity reader,
magnetic band or bar code, etc. In these cases, the data received will be processed the
same as if it were to arrive via Clock&Data ports. This means that the green and red
LEDs can be used to provide information on the success or error of the reading process,
that multiread filtering can be applied and that in any case a Card Reading event will be
generated. Subsection 8.1.4. shows that the data is processed in the same way, whether it
is from a Clock&Data port or from a suitably configured UART (CFG-UI_AuxSerial-
Port parameters to value $40 or $41, see Table 3).
7.1.2. Autonomous readers
Nevertheless, more sophisticated readers do exist. These are those that can generate an
event with the identification code but that, at the same time, allow for two-way
communications with the Host to be programmed.
Within this type are the Kimaldi readers KRD13M and S42, which have programmable
automatic modes capable of extracting a data sequence from a Mifare or SLE4442 card,
respectively. In this case, the host may issue instructions to manage reader configuration:
• The data frames are sent via the Send to UART instruction.
• The responses are received via the Reception from UART event.
• The events are received via Card Reading.
• The data format is binary, doing without <STX>, <ETX>.
• Connection via UART2-UI is established after configuring the CFG-UI_AuxSerial-
Port parameter to the value $40 or $41, according to the baud rate. The
maximum length of the frame is 48 bytes.

FingerVein Online
Installation and Programming Manual
www.kimaldi.com Page 18 of 69
7.1.3. Online readers
Finally, readers can be connected totally Online. In this case, FingerVein-OnLine
electronics is totally transparent and generated events cannot be assimilated to an
identification code.
Kimaldi readers can be connected KRD13M (Online mode) and SC6000 (mode T=0),
capable of handling (reading and writing) data on a Mifare card or ISO-7816 chip,
respectively:
• The data frames are sent via the Send to UART instruction.
• The responses and events are received via Reception from UART.
• The exact data format required by the reader, including the delimiter characters
<STX>, <ETX>.
• The connection via UART2-UI is established after configuring the CFG-
UI_AuxSerial-Port parameter to the value $88 or $89, according to the baud
rate. The maximum length of the frame is 912 bytes.

FingerVein Online
Installation and Programming Manual
www.kimaldi.com Page 19 of 69
8. FingerVein Online electronics configuration
FingerVein Online electronics configuration consists of two parts:
• Parameter array: these are an array of bytes that allow certain machine
characteristics to be defined in terms of function (timings, parameter enabling/
disabling, etc.). They are distributed between the two parts of the electronics (DB
module and UI module). The values that we will normally change are in the UI
module. Consult Kimaldi for the DB parameters.
• IP configuration: data required for machine operations in a local area network
(Ethernet).
FingerVein Online electronics is stored in EEPROM memory, which provides it with
around 10,000 read/write cycles. This should be taken into account when managing the
configuration parameters.
8.1. Parameter array
All the machine's parameters are listed below:
Table 1: FingerVein Online parameter list
No. Description Further informa-
tion
$01 Defines the events reported to the Host (in DB
module)
Refer to Subsection
8.1.2.
$02 Guard time, in tenths of a second, between finger
detection events.
Refer to Subsection
8.1.3.
$03 Watchdog, in tenths of a second, for the detection
of the permanent blocking of the optical barrier.
Refer to Subsection
8.1.3.
$04 Time-out, in tenths of a second, of reception
of data by the UART. Applicable to all UART.
Refer to Subsection
8.1.2.
$05 The optical barrier will generate a Key Pressing
event corresponding to a configurable key value.
Refer to Subsection
8.1.3.
$06 Duration, in hundredths of a second, of the buzz-
ing of the internal beeper to indicate the pressing
of a key.
Refer to Subsection
8.1.5.
$07 Duration, in hundredths of a second, of the buzz-
ing of the internal beeper to indicate an error.
Refer to Subsection
8.1.5.
$08 Enables RS-232 Reader (UART2-UI) and
Clock&Data (TTL_0) ports.
Refer to Subsection
8.1.4.

FingerVein Online
Installation and Programming Manual
www.kimaldi.com Page 20 of 69
$09 Configuration byte of the automatic beeper ena-
bling after a correct Clock&Data reading.
Refer to Subsection
8.1.4.
$0A Configuration byte of the automatic beeper ena-
bling after an incorrect Clock&Data reading.
Refer to Subsection
8.1.4.
$0B Configuration of the multiread filtering. Refer to Subsection
8.1.4.
$0C Time-out in tenths of a second of the multiread fil-
tering, to detect that a card has left the reading
field.
Refer to Subsection
8.1.4.
$0D Configures the communications channel through
which the event frames are sent. (In DB module)
Refer to Subsection
8.1.2.
$0E Time-out, before starting the biometric sensor. Refer to Subsection
8.1.2.
$0F
to
$13
Reserved
$14 Time-out of the communication with the display Refer to Subsection
8.1.6.
$15
to
$19
Reserved
$1A Determines the protocol and Baud Rate assigned
to the UART0-UI. Do not change.
Refer to Subsection
8.1.1.
$1B Determines the protocol and Baud Rate assigned
to the UART1-UI. Do not change.
Refer to Subsection
8.1.1.
$1C Determines the protocol and Baud Rate assigned
to the UART2-UI. Refer to Tab l e 3.
Refer to Subsection
8.1.1.
$1D Do not change
$1E Reserved for future uses.
$1F Time, in tenths of a second, to indicate correct
reading with the green LED.
Refer to Subsection
8.1.5.