Reader software naming Standard reader versions: 1...99 Special keyboard/testing versions: 20x ... 255 HITAG reader versions: 10x ... 199 ---------------------------------------------------------------------------------- ************************************************************************************************************************** Version 62, BLE version 124 (18.05.2026) SVN Revision: 18823 CHG: Improved card reader stability and recovery in case of long NFC/card operations. CHG: Improved watchdog handling to reduce false resets during longer card communication. CHG: Improved PN5190 NFC driver IRQ handling. CHG: Improved diagnostics for card timeout, SPI timeout and Modbus card timeout events. CHG: Optimized DESFire formatting by writing data in smaller chunks. UPD: Build project cleanup: removed old Eclipse project files, CMake/Ninja is now used. FIX: Possible blocking in the NXP HAL when no card is present. FIX: Possible watchdog triggers during longer DESFire authentication and UID read operations. FIX: Card-process buzzer behavior and default buzzer setting. FIX: MIFARE Classic 1K write handling for invalid sectors. FIX: Possible hard-fault/stack corruption in DESFire card processing. ************************************************************************************************************************** Version 61 BLE 120 (21.01.2026) SVN Revision: 18065 FIX: keystore_write_key to return the correct status. ************************************************************************************************************************** Version 60 BLE 120 (21.01.2026) SVN Revision: 18035 UPD: Add stack overflow handler. UPD: In debug builds, print stack usage using StackHighWaterMark. UPD: Optimize stack size for each task. UPD: Remove HCE and add OSS. ************************************************************************************************************************** Version 53, BLE 119 (10.9.2025) URL: https://svn.primasystems.si/trunk/Nordic/Nexus_ble/tags/v119/ svn revision: 17745 ADD: HCE new security. ADD: Support for HardFault info. FIX: Fixing stability issues: added event pool and small fix in phhalHw_Pn5190_InstMngr.c and phpalI14443p3a_Sw.c. DEL: Removed read of PAN number. ************************************************************************************************************************** Version 53, BLE 117 (24.4.2025) URL: https://svn.primasystems.si/trunk/Reader/tags/v53 svn revision: 16858 ADD: block select types of card ************************************************************************************************************************** Version 52_RC (31.3.2025) URL: https://svn.primasystems.si/trunk/Reader/tags/v52 svn revision: 16627 ADD: read FW and BL version ADD: read all reader status (ignore encryption) ADD: add support for custom DESFire card commands ADD: Because the NFC on the Android watch doesn't work, I added a 0.5 ms delay between reading and writing data over I2C in the phbalReg_Nexus_i2c_Exchange function FIX: Remove some compiler warnings DEL: Remove modbus read last card's SAK & ATS DEL: keyborad release key sound ************************************************************************************************************************** Version 41.0_RC (6.09.2023) FIX: Read Urbana card. (Bug #5483) svn revision: 14107 ************************************************************************************************************************** Version 40.0 (11.07.2023) FIX: Change Application master key not working. (Bug #5394) ************************************************************************************************************************** Version 36.0 (22.12.2022) FIX: Correct DESFire keys validation ************************************************************************************************************************** Version 35.0 (21.11.2022) ADD: Support for create file without size limited on DESFire card ADD: Support read/write DESFire card file with offset ************************************************************************************************************************** Version 34.0 (29.8.2022) FIX: HCE; Phone lock screen when communication with reader is in progres will not crash reader. ************************************************************************************************************************** Version 33.0 () Never released, problems with HCE ************************************************************************************************************************** Tar pack version 31 (1.6.2022) WARNING! The tar file is only accepted by Nova version 3.2.26 and up. Contains: - Hardware 1, 2 reader fw 31 - Old bootloader reader fw 29 - Hardware 3 reader fw 33 ************************************************************************************************************************** Version 32.0 (6.1.2022) WARNING! Due to the firmware size limit, readers with serial number < 5000 will not be able to update to this version. If you still need to update the reader, please use version 29 instead. ADD: Handling of multiple desfire apps ADD: Handling of multiple desfire apps FIX: Creating app with custom AppID FIX: Reset pin for RF IC on hardware Nexus MW and MKW on HW V3.0 ************************************************************************************************************************** Version 31 (13.9.2021) WARNING! Due to the firmware size limit, readers with serial number < 5000 will not be able to update to this version. If you still need to update the reader, please use version 29 instead. ADD: Support for keypad on W readers. (no need for special software for MKW and PKW readers) ADD: Support for Nexus MW and MKW hardware V3 ************************************************************************************************************************** Version 30 (26.1.2021) WARNING! Due to the firmware size limit, readers with serial number < 5000 will not be able to update to this version. If you still need to update the reader, please use version 29 instead. ADD: Support for HCE card pre-read (uses same sectors as DESFire card). ADD: Support for Mifare Ultralight cards. ADD: Pass trough for unrecognized cards. ADD: Support for setting Project ID on reader and sending project ID to android app when card is detected. CHG: This version works with DoorApp version 1.3.0 and up. CHG: Treat CTC cards as Mifare Classic cards. FIX: Optimized read/write speeds for all phones and cards. ***************************************************************************************************************************** Version 29 (14.2.2020) ADD: Added exception to beep on mifare operation for HCE device Whenever card/device presence is reported to central, reader initiates internal reader beeping (if set in settings). Beeping is then terminated on card/device command. This version adds an exception for HCE devices and beeping is not terminated on commands directed to HCE device. It is up to central to issue success/error sound which will terminate beeping. ***************************************************************************************************************************** Version 27 (5.9.2019) FIX: RF deadlock; reset cahnged from hard reset to soft reset ***************************************************************************************************************************** Version 26 (30.7.2019) ADD: HCE implementation ***************************************************************************************************************************** Version 223 (18.3.2019) (kpd_fix_20190318) CHG: Mutex lock fix - if after 10 seconds the keyboard driver doesn't get mutex access, system resets CHG: On every keyboard initialization, all parameters are re-set ***************************************************************************************************************************** Version 222 (13.11.2018) CHG: second card read timeout extended to 600ms after last card operation CHG: decrease MIFARE FR transmit power ***************************************************************************************************************************** Version 21 (9.9.2018) Not for commercial use !!! FIX: sector 0 authentication ****************************************************************************************************************************** Version 20 (15.4.2018) Not for commercial use !!! CHG: DESFire master key ****************************************************************************************************************************** Version 19 (13.2.2018) Not for commercial use !!! ADD: DESFire master key ******************************************************************************************************************************* Version 218 (8.8.2018) !!! FIRMWARE NOT COMPATIBLE WITH NexusP-EXTA readers !!! Production firmware for NExus MKW, PKW readers Test firmware for Nexus KSW readers ADD: support for external 3x4 keypad ADD: Modbus request for QC internal relay output ******************************************************************************************************************************* Version 218 (8.8.2018) !!! FIRMWARE NOT COMPATIBLE WITH NexusP-EXTA readers !!! Production firmware for NExus MKW, PKW readers Test firmware for Nexus KSW readers ADD: support for external 3x4 keypad ADD: Modbus request for QC internal relay output ******************************************************************************************************************************* Version 17 (26th April 2017) ADD: Support for unpersonalized DESFire card ADD: Exceptions for ReportSlaveID, reset AES128 keys and LED manipulation registers when using encrypted connection ******************************************************************************************************************************* Version 16 (3rd May 2016) CHG: Modbus address change optimization ADD: Support for card data pre-read ADD: Support for writing only changed data blocks on card ******************************************************************************************************************************* Version 15 (22nd March 2016) ADD: NXPReaderLibrary version 1.4.0 FIX: Reduced retry count from 6 to 3 to decrease timeouts CHG: Retries for authentication error added FIX: Process pending request when DESFire card is in gray zone ADD: 50 ms response delay to ReportSlaveID Modbus function call ADD: Dynamic request delay management with settings in register 1020 ******************************************************************************************************************************* Version 14 (6. January 2016) CHG: Changed keypad handling for more sensitive keys FIX: 125kHz field was not properly turned off and on ADD: Improved handling of RFID errors reported from PN512 driver firmware for more robust card operations FIX: Automatic RFID interface restart started working 17 days after reader power on CHG: Improved card read/write speed by ca. 25-30%. ******************************************************************************************************************************* Version 13 was internal version with keypad improvements and was not publicly released. Please use version 14 instead. ******************************************************************************************************************************* Version 12 (24.06.2015) DO NOT USE WITH NEXUS MW. ADD: NXP Reader Library ADD: DESFire support CHG: Keypad handling ******************************************************************************************************************************* Version 11 (09.12.2014) FIX: Fixed card writing failures because of buzzer signalization between card operations ******************************************************************************************************************************* Version 10.0 (18.09.2014) CHG: Changed behavior of BM flag in register 1020: Now when this bit is set, reader starts beeping immediately after card is read (after new card beep if set) and beeps 22x (ca. 5.5 sec). Central should end this beeping with OK/NOK sound. In case of card r/w access beeping is not interrupted. With this approach user gets fluent user experience which is not interrupted with silence between access granting. ADD: Added support for AES128 Modbus encryption (if encryption is set then reader at startup shortly flashes with GREEN LED before RED LED is lit). CHG: From version 10 RF IC are automatically reseted every 90 seconds. Option can't be turned off. ADD: Added entry point for setting aes128 keys on Modbus address 1022 CHG: HITAG version of firmware from version 10 EXCLUDES support for MIFARE readers. Use HITAG firmware ONLY ON PROX READERS!!!! ******************************************************************************************************************************* Version 9.0* (10.2.2014) *CHANGES WERE ONLY MADE IN HITAG READER FIRMWARE THEREFORE SAME FIRMWARE NUMBER ADD: Added checking for 0xFFFFFFFF card number which can happen on HITAG cards when HTRC IC looses internal sync ADD: HTRC reset for HITAG readers regardless of FR bit in register 1020 ******************************************************************************************************************************* Version 9.0 (2.1.2014) FIX: Fixed continuous signaling of new card while reading serial number of MIFARE DESFire cards CHG: New card flag timeout of 4.5 seconds now starts from beginning of last MIFARE operation, if applicable ******************************************************************************************************************************* Version 8.0 (23.10.2013) !!!! IMPORTANT: Firmware version 7 contains a bug where all PROX cards are reported as unlicensed cards. Version 8 fixes this problem. CHG: Keyboard key history registers are now cleared after keyboard timeout CHG: Keyboard key history registers do not contain CANCEL and ENTER keys ADD: Keyboard key history registers are cleared after CARD registers were read (to avoid unwanted key presses when registering card on reader) FIX: Fixed bug from firmware 7 where ALL PROX cards were reported as unlicensed ADD: Added option to clear keyboard history registers via Modbus interface on address 1100 ******************************************************************************************************************************* Version 7.0 (30.9.2013) ADD: Functions to control keypad LEDs through console API CHG: Removed beeping from vModbusTask.c and move it to vMifareRWTask.c where at performing MIFARE operations task now turns off keypad LEDs for operation duration; beeping is done (if set in registry) after operation on cards to save power -> more power consumption during MIFARE operations more MIFARE errors! ADD: Test if NEW CARD flag is cleared before performing operation on MIFARE card ADD: New MIFARE error (31) to inform card mismatch (see line above) ADD: HITAG reader type (0x02) is now reported on Modbus address 1000 ADD: Delay of 25 ms in Modbus function ReportSlaveID so central can receive answer CHG: Fixed bug for card authentication - it worked with Prima cards but problem could arise with HITAG cards ADD: HITAG functionality - with recompilation and HITAG macro defined PROX reader can read HITAG cards; firmware versions for HITAG readers are 100 greater than regular firmware: 7 becomes 107 when reader reads HITAG cards ******************************************************************************************************************************* Version 6.0 (10.6.2013) FIX: Writing to first sector on MIFARE cards now works (write skips 0-th block, which is not writable) ADD: htrc110 ic driver now enables managing RF field CHG: RFID task now manipulates RF field, timings for last card rewritten with time measurement CHG: MIFARE task last card timeout rewritten CHG: MIFARE task optimized, also detects if card is removed from field (basically card read is performed more often) ADD: New Modbus function on address 1407 which returns signal levels on keypad CGH: Keypad now re-calibrates every 3 minutes; parameters are sent to ic only on registry value updates (trough address 1404) CHG: Console task now ignores all events which are less than 70 ms apart; filter for ghost detections CHG: Cross module optimization enabled on Kiel compiler; result is little smaller code ******************************************************************************************************************************* Version 5.0 (25.1.2013) Option for controlling keypad LED intensity Option for enabling/disabling beeping when performing MIFARE operations Optimized PN512 retires Optimized Keypad handling routines ******************************************************************************************************************************* Version 4.0 (21.8.2012) Option for enabling/disabling beep|blink when new card present Option for enabling/disabling pn512 reinitialize on minute basis when problems with RFID field are present Retries when executing MIFARE card operations