2.6. Problems, errors, issues

uFR Zero Online – Unified Firmware Package System

µFR Zero Online – Unified Firmware Package System Introduction With the release of ESP32 firmware version 3.0.82, µFR Zero Online devices have adopted a unified firmware package system. This change simplifies firmware management by allowing developers to update both the ESP32 main controller and the NFC reader-writer in a single process. Instead of handling separate firmware updates, you now select from precompiled firmware packages that ensure both components always run mutually compatible versions. This article explains how the new system works, what package types are available, and how to resolve common issues when working with firmware packages. How Firmware Packages Work When you click “Check for Updates” in the device frontend: Individual firmware versions are no longer listed. Instead, you will see packages named in the format: Zero_Online_YYYYMMDD The date indicates when the package was created. A newer date corresponds to a newer firmware version. Once selected, the package automatically installs the correct versions of: The ESP32 main unit firmware The NFC reader firmware This ensures both parts of the device run on compatible builds. Package Variants Three types of firmware packages are available: Zero_Online_YYYYMMDD – the standard package for most devices. Zero_Online_Lite_YYYYMMDD – for Lite variants of µFR Zero...

A corrupted µFR Nano Online firmware recovery – desktop app

A corrupted µFR Nano Online firmware recovery – desktop app If you are experiencing a problem with a corrupted firmware of your µFR Nano Online device, and it cannot be connected to your network, or for some other reason you cannot access its web backend configuration in your browser, you need to recover the device using the desktop tools. Windows desktop tools – µFR Nano Online firmware recovery Plug the device into your Windows machine USB port and make sure your FTDI drivers are running properly. As you are probably already aware, the µFR Nano Online device consists of the two joined hardware, uFR Nano and ESP32, both having individual firmware. Therefore, one firmware flashing tool may not recover the entire device. It is most likely that the device’s ESP32 firmware failed. The console flasher can flash the uFR Nano reader of the device, but you first need to fix the ESP32 with the following  ufr_online-flasher-oneclick  tool (explained at https://www.d-logic.com/nfc-rfid-reader-sdk/software/ufr-online-flasher/). In case you have trouble detecting the device on the Windows machine, make sure you meet the following conditions: – FTDI drivers present – The device is plugged directly into the host machine USB port (not into the external power...

How to recover the communication-lost µFR Nano Online

µFR Nano Online reader is “lost” after its firmware flashing or configuration setup – Recovery Manual – First, try to reset the reader to factory settings in order to eliminate any conflicts that may be caused by incorrect configuration. Application of desktop tools: µFR Online Configurator Instructions for use are available at https://www.d-logic.com/nfc-rfid-reader-sdk/software/%c2%b5fr-online-configurator/ By clicking on Connect uFR Online, this software automatically searches for ports and connects the Nano Online reader. If this does not happen, check if any other FTDI device is connected to the PC, which needs to be disconnected during work with this software. It is also possible that other processes in your system may affect the port search, so I recommend that you try to run the software several times in a row and connect the reader. If this is successful, apply step 6. uFR Online Configurator – Reset configuration to the factory default described on the above page. This function will reset the reader’s working mode, all custom settings, and Wi-Fi credentials (the device will not be connected to the network). Therefore, all software functions will be returned to factory settings, but this will not affect the two firmware that the device uses. Next, it...

A corrupted µFR Nano Online firmware diagnostic and recovery – web backend

A corrupted µFR Nano Online firmware diagnostic and recovery – web backend   – µFR Reader Firmware Issue – This device has two pairs of LEDs. The top LEDs are connected to the ESP32 board and show the network connection status, while the bottom pair of LEDs are connected to the NFC reader. The bottom LEDs should flash green (slowly when there is no card near, and fast when you read the card). If you see any red light at the bottom or no light at all, then the µFR reader firmware is missing or corrupted.  If you still can access your device’s web backend, please log in and check the device info as shown below: The red-marked fields contain the NFC reader firmware details. If you have no firmware data listed here, or if both, the reader serial and the firmware version are missing, the firmware of your device is corrupted.  In this case, you can try resting the device on the factory settings. Then connect the device to your network again and flash both firmware again. Whatever firmware version your device has, it is recommended to upgrade to the latest release. This should recover all the device functionality....

How to flash-update µFR Nano Online Firmware

µFR Nano Online Firmware flashing – upgrade & downgrade If you need to upgrade or downgrade your µFR Nano Online device, for the device connected to the desktop host (USB-connected) you may use the software tools provided for the µFR Online devices, or you can use the firmware update options of the device web configuration panel.  For the desktop, you should download the following firmware flashing software – ufr_online-flasher-oneclick. This software tool implementation is further explained at https://www.d-logic.com/nfc-rfid-reader-sdk/software/ufr-online-flasher/.  However, this device is designed to be used primarily as a network device so that it can be entirely configured and both its firmware (uFR and ESP32) can be updated using its online fronted options. To access its front-end panel, you need to connect the reader to your network. Then open its assigned IP address in your browser. Further, follow the steps of the demonstration video. 🔗 https://www.youtube.com/watch?v=5khSfhTnxV0&ab_channel=D-LogicNFC_SDK  Please remember that the default login credentials for the device online configuration panel are: user: ufr password: ufr Both of the mentioned solution, desktop, and network, includes the Factory Reset option. However, be aware that the factory reset turns all the devices’ configuration options to their default values, but does not affect the firmware...

How to use the EMV Credit Card Reading SDK with the µFR Nano Online

How to use the EMV Credit Card Reading SDK with the µFR Nano Online Although the device delivers the raw read data to the remote server, it does not support EMV encryption on its own. This means that without deploying any intermediary software solution that applies such encryption, the device cannot transfer the encrypted credit card data to the web-based system. In order to test the device’s credit card reading, you can use some of the desktop SDK projects from the list of SDKs below: Credit card reading software SDK C++ Credit card reading software SDK C# Credit card reading software SDK C  Credit card reading software SDK Java Credit card reading software SDK WPF USB-connected device requirements This device can be used with the desktop software in the same way as any other µFR Series reader without network support if you plug it into the PC’s USB port. You only need to have the FTDI drivers installed on your machine in order to use the software. Please check the FTDI drivers installation instructions at https://www.d-logic.com/knowledge_base-tag/ftdi-drivers/. Network-connected device requirements You should assure that your host computer (PC) is connected to the same network as your µFR Nano Online device in...

BLE Mode – Pairing & Connecting the uFR Nano Online Reader

How to enable BLE mode on the uFR Nano Online Reader? Log in to the uFR Online WEB frontend settings page; Select Other Settings from the menu; If the reader is in Master Mode, change it to Slave Mode; Go to the BLE section (image below);  To enable BLE mode, click the section button; The BLE security section will be displayed (image below); Navigate down for more information regarding BLE security modes;  Click the Save and Restart button;  After restarting the reader, the light blue light will blink. Notes: Blinking light blue LEDs indicate that the reader is waiting for a smartphone or other BLE-capable device to establish a connection. The device can be seen as a WiFi access point as well. A constant light blue LED shows that the reader is already paired. On BLE scanning, connected devices are not detected. The device is not visible acting as a WiFi access point. BLE security modes There are three BLE security modes. Details about all three are shown in table 1. Disabled security means that there is no open security channel and MITM protection.   * Security disabled Security enabled and the PIN is set to 0 Security enabled and...

µFR Reader Writer on macOS – FTDI drivers and communication permissions tips

µFR Reader Writer on macOS FTDI drivers and communication permissions tips *NOTICE: Applicable only to old macOS versions and legacy µFR devices. Do not use for the µFR Zero series and recent macOS releases! macOS has a bit different structure than Linux so communication with the reader cannot be enabled with a simple script available for Linux users. Enabling the communication between the software and the USB-connected reader varies depending on the macOS version. The OS versions from Mavericks (version 10.9) and above already have the AppleUSBFTDI driver. The interface is matched to the FTDI kext, which in turn creates a BSD serial port for use at the application layer. The application opens the serial port to communicate with the hardware. On the other hand, the USB-connected µFR devices implement user client drivers to communicate directly with the device from the user space (FTDI D2XX Driver). Therefore, the presence of the AppleUSBFTDI kext might affect communication with the software. Software applications may fail to open a connection with the hardware because IOKit already has matched the AppleUSBFTDI driver to the device. The solution in this instance is to unload the AppleUSBFTDI drivers before installing the FTDI D2XX. You may find...

USB-connected µFR Nano Online NFC RFID Reader Writer on the Raspberry Pi

USB-connected µFR Nano Online NFC RFID Reader Writer on the Raspberry Pi To connect and run the µFR Nano Online reader plugged into the Raspberry Pi USB port, follow the instructions below: 1) USB-CONNECTED µFR NANO ONLINE NFC READER INSTALLATION All µFR series devices require FTDI drivers for USB communication. This also applies to the µFR Nano Online NFC reader if it is used as a standard USB device. If you have no FTDI drivers installed on your installed Raspberry Pi, please follow the manual for the FTDI drivers installed on the Linux-based platforms. This article is also available in our Knowledge Base. Important notice: Before you proceed with the µFR Nano Online implementation, make sure you grant the USB PORT access permission to the local user (the script is available in our GitLab projects repository). Once you have the FTDI drivers installed with your USB-connected NFC reader, you will be able to open the port and establish communication with the device by the ReaderOpen function provided by the ufr library. Important notice: The recommended library for the Raspberry Pi is the 64-bit aarch64. However, there are some known problems with aarch64 on a Raspberry Pi 4 with 8 GB...

µFR Nano Online 2.4GHz pairing problem – Android

Problem Nano online is working when pairing is made. But When I turf off Nano Online and then turn it On I have to make pairing again. Other devices after first pairing, connect automatically to the phone without pairing again. Solution This is resolved in the higher firmware versions. Please update your Nano Online to version 2.5.2W, or higher if available. One way to do this is to use the firmware update option at the bottom of the device frontend configuration panel. You can also use the desktop firmware flashing tool available at https://code.d-logic.com/nfc-rfid-reader-sdk/ufr_online-flasher-oneclick. Video tutorials: Frontend firmware upgrade – https://www.youtube.com/watch?v=5khSfhTnxV0&t=1s Firmware flashing tool – https://www.youtube.com/watch?v=PFLGOdq1igA&t=1s  

How to access the µFR Nano Online configuration panel after setting the 2.4GHz BLE HID mode?

How to access the µFR Nano Online configuration panel after setting the 2.4GHz Low Energy HID mode? When µFR Nano Online works in a 2.4GHz Low Energy HID mode and is paired with the host device (PC, phone), its Wi-Fi access point is turned off to save power. To access the device frontend configuration panel, you need to disable (unpair) the 2.4GHz Low Energy connection on the host device first. After that, the access point with the Wi-Fi SSID named the serial number of the device (i.e. ON1XXXXX) will be turned on. Finally, connect to this Wi-Fi access point and access the configuration panel by typing the IP address 192.168.4.1 into your browser. Alternatively, you can reset the device to Wi-Fi Slave mode by resetting the device to factory settings using the uFR Online Flasher tool.

iOS support for µFR Series hardware

For iOS, we provide the µFR Series hardware library for iOS, the APIs, and other documentation related to hardware, as well as all the necessary technical support for your project development.   As for the development tools and executable software solutions, the current iOS compliant SDK is available at our GitLab repository and the two apps at App Store.  The SDK is compliant with all the µFR Series devices, while one of two available iOS apps is developed for the µFR Nano Online reader exclusively.

Card/tag reading error on NT4H C Console software with device firmware version 5.0.52

The (currently latest) firmware version 5.0.52 may cause some SDK functions error, or the console freezing (issue detected in ufr-examples-c-nt4h software). If you are experiencing such a problem, the solution Is to install another firmware version on your device. If there is on new firmware version available in our firmware update list, we advise the firmware downgrade. The upgrade or downgrade of the firmware to the 5.0.51 version solves this issue. To install the new firmware, you can use the µFR Nano Online web settings (device IP), search for available firmware versions, and select the latest available firmware version, or the 5.0.51 version from the list.     Alternatively, for this purpose, you can also use desktop software https://code.d-logic.com/nfc-rfid-reader-sdk/ufr_online-flasher-oneclick.

Reader opening error on macOS – Code (0x54)

Reader opening error on macOS - Code (0x54)

Running Python SDK/software on macOS

For Python software examples, we suggest you use any Python 3.x.x version. If you don’t have the right Python version installed, use the following command line to install a new version: brew install python Now simply run our source code software example with the command: python3 file_name.py Please have in mind that our Python SDK structure has only one executable .py file (main file) and that one imports all other files as modules. For example, the NDEF Python SDK console uses ndef_example.py as the main file, so the software is executed with the following command: python3 ndef_example.py To make sure which file is the main executable file, you can simply check the source code of the *.py files and look for the one that has a ReaderOpen/ReaderOpenEx function calls.   NOTE: This test was performed with Python 3.7.2 so and included the following SDK:     https://code.d-logic.com/nfc-rfid-reader-sdk/ufr-ndef-examples-python-console     https://code.d-logic.com/nfc-rfid-reader-sdk/ufr-mf-examples-c

How to communicate with µFR device on Windows without FTDI drivers implementation

How to use the µFR device on Windows without the FTDI drivers implementation: You can avoid using FTDI drivers (D2XX) by communicating with the reader via

µFR Device RF settings – reset to default

µFR Series devices installation on Linux distributions

Configure Raspbian for Raspberry Pi 3 to use Digital Logic shield with uFReader RS232

µFR Nano Online OEM Lock/Unlock

µFR Nano Online Reader Tools

µFR Nano Online Reader Protocols Structure

µFR Nano Online Reader Implementation Basics

µFR Nano Online REST Services

µFR Nano Online Default Settings

µFR Nano Online Reader settings

µFR Nano Online Installation Manual

Is there any NFC RFID tool that can register RFID cards on a computer and its data on a server?

How do you change the Wi-Fi network if the µFR Nano Online device is already connected?

To change the Wi-Fi network if the µFR Nano Online device is already WiFi-connected, you can disconnect and reset the device as follows:

Is it programmatically possible to switch the buzzer off (via online command) on µFR Nano Online, and send the beeps commands via USER_INTERFACE_SIGNAL?

µFR Nano Online LEDs Status Legend