ZKLibrary is PHP Library for ZK Time & Attendance Devices. This library is design to reading and writing data to attendance device (fingerprint, face recognition or RFID) using UDP protocol. This library is useful to comunicate between web server and attendance device directly without any addition program. This library is implemented in the form of class. So that you can create an object and use it functions.
Web server must be connected to the attendance device via Local Area Network (LAN). The UDP port that is used in this communication is 4370. You can not change this port without changing firmware of the attendance device. So, you just use it.
The format of the data are: binary, string, and number. The length of the parameter and return value must be vary.
<?php
require 'zklibrary.php';
$zk = new ZKLibrary('192.168.1.102', 4370);
$zk->connect();
$zk->disableDevice();
// $zk->setTime(date('Y-m-d H:i:s'));
$zk->testVoice();
$zk->enableDevice();
$zk->disconnect();
?>Class ZKLibrary {
String ip;
Unsigned Short port;
Unsigned Long socket;
Unigned Long session_id;
String received_data;
String user_data[][];
String attendance_data[][];
Unsigned Long timeout_sec;
Unsigned Long timeout_usec;
}__construct([$ip[, $port]])Object constructor.
$ip
IP address of device.
$port
UDP port of device.
__destruct()Object destructor.
connect([$ip[, $port]])Function to make a connection to the device. If IP address and port is not defined yet, this function must take it. Else, this function return FALSE and does not make any connection.
$ip
IP address of the device.
$port
UDP port of the device.
disconnect()Function to disconnect from the device. If ip address and port is not defined yet, this function must take it. Else, this function return FALSE and does not make any changes.
setTimeout([$sec[, $usec]])Set timeout for socket connection.
$sec
Timeout in second.
$usec
Timeout in micro second.
reverseHex($input)Reverse hexadecimal digits.
encodeTime($time)Encode time to binary data.
$time
String time in format YYYY-MM-DD HH:II:SS
Encoded time in binary format.
decodeTime($data)Decode binary data to time.
$data
Binary data from device.
Dedoded time in string format.
checkSum($p)This function calculates the chksum of the packet to be sent to the time clock.
$p
Packet to be checked.
createHeader($command, $chksum, $session_id, $reply_id, $command_string)Create data header to be sent to the device.
$command
Command to the device in integer.
Data header in binary format.
$checksumChecksum of packet.
$session_id
Session ID of the connection.
$command_string
Data to be sent to the device.
Sum of data to be checked.
checkValid($reply)Check wether reply is valid or not.
$reply
Reply data to be checked.
execCommand($command, $command_string = '', $offset_data = 8)Send command and data packet to the device and receive some data if any.
$command
Command to the device in integer.
$command_string
Data to be sent to the device.
$offset_data
Offset data to be returned. The default offset is 8.
getSizeUser()Get number of user.
Number of registered user in the device.
getSizeAttendance()Get number of attendance log.
Number of attendance recorded in the device.
restartDevice()Restart the device.
shutdownDevice()Shutdown the device.
sleepDevice()Sleep the device.
resumeDevice()Resume the device.
changeSpeed($speed = 0)Change transfer speed of the device. 0 = slower. 1 = faster.
$speed
Transfer speed of packet when the device comunicate to other device, i.e server.
Note: some device may be not supported fast speed.
writeLCD($rank, $text)Write text on LCD. This order transmit character to demonstrate on LCD, the data part 1, 2 bytes of the packet transmit the rank value which start to demonstrate, the 3rd byte setting is 0 , follows close the filling character which want to be transmit. May work in CMD_CLEAR_LCD when use this function.
$rank
Line number.
$text
Text to be demonstrated to LCD of the device.
clearLCD()Clear text from LCD.
testVoice()Test voice of the device.
getVersion()Get device version.
Version of the device in string format.
getOSVersion($net = true)Get OS version.
$net
If net set to true, function will return netto data without parameter name.
setOSVersion($osVersion)Set OS version
$osVersion
Version of operating version.
getPlatform($net = true)Get OS version.
$net If net set to true, function will return netto data without parameter name.
setPlatform($patform)Set platform.
$platform
Platform name.
getFirmwareVersion($net = true)Get firmware version.
$net
If net set to true, function will return netto data without parameter name.
setFirmwareVersion ($firmwareVersion)Set firmware version.
$firmwareVersion
The version of firmware.
getWorkCode($net = true)Get work code.
$net If net set to true, function will return netto data without parameter name.
setWorkCode($workCode)Set work code.
$workCode
Work code.
getSSR($net = true)Get SSR
$net
If net set to true, function will return netto data without parameter name.
setSSR($ssr)Set SSR.
$ssr
SSR.
getPinWidth($net = true)Get pin width.
$net
If net set to true, function will return netto data without parameter name.
setPinWidth($pinWidth)Set pin width.
$pinWidth
Pin width
getFaceFunctionOn($net = true)Check wether face detection function is available or not.
$net
If net set to true, function will return netto data without parameter name.
setFaceFunctionOn ($faceFunction)Set wether face detection function is available or not.
$faceFunction
Face function. 1 = available; 2 = not available.
getSerialNumber($net = true)get serial number of the device.
$net
If net set to true, function will return netto data without parameter name.
setSerialNumber($serialNumber)Set serial number of the device.
$serialNumber
Serial number of the device.
getDeviceName($net = true)Get device name.
$net
If net set to true, function will return netto data without parameter name.
setDeviceName($deviceName)Set device name.
$deviceName
The device name.
getTime()Get time of device from real time clock (RTC). The time resolution is one minute.
getTime return time as string with format YYYY-MM-DD HH:II:SS.
setTime($t)Set time of the device.
Time to be set with format YYYY-MM-DD HH:II:SS.
enableDevice()Ensure the machine to be at in the normal work condition, generally when data communication shields the machine auxiliary equipment (keyboard, LCD, sensor), this order restores the auxiliary equipment to be at the normal work condition.
disableDevice()Shield machine periphery keyboard, LCD, sensor, if perform successfully, there are showing “working” on LCD.
enableClock()Set the LCD dot (to glitter ‘:’) the packet data part transmit 0 to stop glittering, 1 start to glitter. After this order carries out successfully, the firmware will refresh LCD.
getUser()Retrive the user list from the device.
getUser return array 2 dimension. The key of array is serial number of user. The value of array is array containing:
- serial number of the user
- user name
- user role
- user password
setUser($uid, $userid, $name, $password, $role)Write user to the device.
$uid
Serial number of the user. This is the unsigned short number (2 bytes).
$userid
User ID of the application. The maximum length of $userid is 8 characters containing numeric whithout zero on the beginning.
$name
User name. The maximum length of $name is 28 characters containing alpha numeic and some (not all) punctuation.
$role
The role of user. The length of $role is 1 byte. Possible value of $role are:
0 = LEVEL_USER
2 = LEVEL_ENROLLER
12 = LEVEL_MANAGER
14 = LEVEL_SUPERMANAGER
setUserTemplate($template)Upload finger print template to the device. The precondition to successfully upload the fingerprint template which is, the user must exist, the user, whose the fingerprint will be uploaded, must be empty.
$template
$template is binary data which the structure is shown bellow:
typedef struct _Template_{
U16 Size; // the length of fingerprint template
U16 PIN; // corresponds with the user data structure PIN
char FingerID; // fingerprint
char Valid; // fingerprint is valid or invalid
char *Template; // fingerprint template
} TTemplate, *PTemplate; getUserTemplate($uid, $finger)Get finger print data from the device.
$uid
Serial number of the user (2 bytes)
$finger
The finger on which the template will be taken (0-9).
getUserTemplate will return an array contains:
- length of template (2 bytes)
- serial number of the user (2 bytes)
- finger (1 byte, 0 to 9)
- valid (1 byte)
- template
Template is binary data which the structure is shown bellow:
typedef struct _Template_{
U16 Size; // the length of fingerprint template
U16 PIN; // corresponds with the user data structure PIN
char FingerID; // fingerprint
char Valid; // fingerprint is valid or invalid
char *Template; // fingerprint template
} TTemplate, *PTemplate; clearData()Clear some kind of data, if do not assign the data type, then deletes all data, otherwise depending on the assigned type to delete data.
clearUser()Same with clearData.
deleteUser($uid)Delete some user from the device.
$uid
Serial number of the user (2 bytes).
deleteUserTemp($uid, $finger)Delete finger template of the user from the device.
$uid
Serial number of the user (2 bytes).
$finger
The number of finger (0-9).
clearAdmin()Delete all admin from the device.
getAttendance()Retrieve the attendance log.
getAttendance return array 2 dimension. The value of array is array containing.
- serial number of the user
- user id of the application
- state
- time of attendance in format YYYY-MM-DD HH:II:SS
clearAttendance()Delete all attendance log from the device.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent