Skip to content

About

Offline Android UHF RFID scanner for rugged handhelds

Topics

Resources

Stars

4 stars

Watchers

0 watching

Forks

Latest commit

 

History

1 Commit

Folders and files

Repository files navigation

RFID Scanner

An offline Android app for UHF RFID inventory on compatible rugged handhelds. It starts scanning on launch, shows unique tags and repeat reads in real time, and provides a diagnostics report when the reader cannot start.

The app is written in Java. It has no account, server, or network permission; the scan list is held in memory for the current session.

Features

  • Live EPC and TID capture with RSSI, first/last seen times, and repeat counts.
  • Tag identity based on TID when available, with EPC fallback for tags without a usable TID.
  • Bounded, coalesced updates so repeated reads do not overwhelm the screen.
  • Start/stop control, hardware trigger support, transmit-power adjustment, and copyable results.
  • On-device diagnostics covering SDK startup, radio state, power range, device details, and recent errors.

Build locally

Open the project in Android Studio, or use the Gradle wrapper from this directory:

.\gradlew.bat :app:assembleDebug

Install the Android SDK and set its path in a local local.properties file, for example sdk.dir=C:/Android/Sdk. Use forward slashes on Windows. The project targets Android API 34, compiles with API 36, and requires API 26 or newer on the device.

The device manufacturer's SDK is required for compilation and runtime. These third-party binaries are intentionally excluded from this public repository. Obtain them from the SDK provider and place them at:

Artifact Local path
pdasdk_v3.45_20250317.jar app/libs/
DeviceAPI_ver20240904.aar app/libs/
BarcodeAPI_ver20250208_Mtk.aar app/libs/
Native .so files supplied with the SDK app/src/main/jniLibs/arm64-v8a/ and app/src/main/jniLibs/armeabi-v7a/

Only ARM builds are configured because the supplied SDK has no x86 native libraries. :app:assembleRelease produces an unsigned release APK; sign it with a private key outside this repository before distribution. The debug build uses the Android tooling's local debug key.

Design notes

UhfReaderService owns all SDK calls. Inventory runs on a dedicated thread because the vendor read call blocks until stopped. Control operations use a separate executor so the stop command cannot queue behind an active read. TagFeed consolidates callbacks before updating the UI, while MainActivity handles the screen and hardware keys.

The Java sources are in app/src/main/java/com/handheld/rfidscanner/. Layout and theme resources are in app/src/main/res/. The app requests only wake-lock and vibration permissions; camera permission inherited from a bundled SDK component is removed by the manifest.

Validation and limits

The Android build can be checked locally with the vendor binaries present. Radio operation must be validated on a supported physical handheld; ARM-only native libraries prevent meaningful UHF testing in a standard x86 emulator. Scan results are session-only and are not synchronised or exported to a server.

Changing the application ID to com.handheld.rfidscanner gives this generic build a separate Android identity. It will not install as an update over an earlier differently named package.

About

Offline Android UHF RFID scanner for rugged handhelds

Topics

Resources

Stars

4 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages