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.
- 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.
Open the project in Android Studio, or use the Gradle wrapper from this directory:
.\gradlew.bat :app:assembleDebugInstall 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.
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.
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.