How kormax/android-universal-reader works
Android Universal Reader is a demonstration NFC app for reading Apple VAS and Google Smart Tap passes. The main workflow is: load a reader configuration, detect a nearby NFC device, exchange ISO 7816 commands, then display pass data and read statuses alongside optional logs and command/response output. The protocol implementations and configuration models are documented, but most of their source was not excerpted; links involving those internals are therefore documented or left unverified rather than inferred from imports. The custom NDEF and BER-TLV codecs and shared byte-packing interfaces form the internal encoding layer.
Main entry points: MainActivity.kt Reader UI · IsoDepIso7816Target.kt Android IsoDep adapter · NdefMessage.kt NDEF codec · BerTlvMessage.kt BER-TLV message
Components 22
App and configuration
- Reader UI
app/src/main/java/com/kormax/universalreader/MainActivity.kt - Reader config models
app/src/main/java/com/kormax/universalreader/model/ReaderConfigurationModel.kt - Protocol configuration
app/src/main/java/com/kormax/universalreader/UniversalReaderConfiguration.kt - Read results
app/src/main/java/com/kormax/universalreader/UniversalReaderResult.kt
NFC transport
- Android IsoDep adapter
app/src/main/java/com/kormax/universalreader/android/IsoDepIso7816Target.kt - ISO 7816 target
app/src/main/java/com/kormax/universalreader/iso7816/Iso7816Target.kt - ISO 7816 commands
app/src/main/java/com/kormax/universalreader/iso7816/Iso7816Command.kt - ISO 7816 responses
app/src/main/java/com/kormax/universalreader/iso7816/Iso7816Response.kt
Pass protocols
- Apple VAS reader
app/src/main/java/com/kormax/universalreader/apple/vas/VasReaderConfiguration.kt - VAS decryption
app/src/main/java/com/kormax/universalreader/apple/vas/VasRegularCryptoProvider.kt - VAS payload
app/src/main/java/com/kormax/universalreader/apple/vas/VasPayload.kt - Smart Tap reader
app/src/main/java/com/kormax/universalreader/google/smarttap/SmartTapReaderConfiguration.kt - Smart Tap decryption
app/src/main/java/com/kormax/universalreader/google/smarttap/SmartTapRegularCryptoProvider.kt - Smart Tap pass data
app/src/main/java/com/kormax/universalreader/google/smarttap/SmartTapObjectPass.kt
Encoding layer
- NDEF codec
app/src/main/java/com/kormax/universalreader/ndef/NdefMessage.kt - NDEF records
app/src/main/java/com/kormax/universalreader/ndef/NdefRecord.kt - BER-TLV message
app/src/main/java/com/kormax/universalreader/tlv/ber/BerTlvMessage.kt - BER-TLV codec
app/src/main/java/com/kormax/universalreader/tlv/ber/BerTlv.kt - Byte packing
app/src/main/java/com/kormax/universalreader/structable/Packable.kt - Byte unpacking
app/src/main/java/com/kormax/universalreader/structable/Unpackable.kt
Other components
- Reader user
- Pass device
Connections 22
- Reader user → Reader UI: uses
README.md - Reader user → Reader UI: loads config
README.md - Reader UI → Reader config models: deserializes
app/src/main/java/com/kormax/universalreader/MainActivity.kt - Reader UI → Protocol configuration: invokes read
app/src/main/java/com/kormax/universalreader/MainActivity.kt - Pass device → Reader UI: presents pass
README.md - Reader UI → Android IsoDep adapter: creates target
app/src/main/java/com/kormax/universalreader/MainActivity.kt - Android IsoDep adapter → ISO 7816 target: implements
app/src/main/java/com/kormax/universalreader/android/IsoDepIso7816Target.kt - Android IsoDep adapter → ISO 7816 commands: transmits
app/src/main/java/com/kormax/universalreader/android/IsoDepIso7816Target.kt - Android IsoDep adapter → ISO 7816 responses: parses response
app/src/main/java/com/kormax/universalreader/android/IsoDepIso7816Target.kt - Protocol configuration → Apple VAS reader: dispatches to
app/src/main/java/com/kormax/universalreader/UniversalReaderConfiguration.kt - Protocol configuration → Smart Tap reader: dispatches to
app/src/main/java/com/kormax/universalreader/UniversalReaderConfiguration.kt - Apple VAS reader → VAS decryption: decrypts with
- VAS decryption → VAS payload: produces
app/src/main/java/com/kormax/universalreader/apple/vas/VasRegularCryptoProvider.kt - Smart Tap reader → Smart Tap decryption: decrypts with
- Smart Tap decryption → Smart Tap pass data: decodes pass
- Reader UI → Read results: displays results
app/src/main/java/com/kormax/universalreader/MainActivity.kt - NDEF codec → NDEF records: parses records
app/src/main/java/com/kormax/universalreader/ndef/NdefMessage.kt - BER-TLV message → BER-TLV codec: parses tags
app/src/main/java/com/kormax/universalreader/tlv/ber/BerTlvMessage.kt - NDEF codec → Byte packing: serializes with
app/src/main/java/com/kormax/universalreader/ndef/NdefMessage.kt - NDEF codec → Byte unpacking: parses with
app/src/main/java/com/kormax/universalreader/ndef/NdefMessage.kt - BER-TLV message → Byte packing: serializes with
app/src/main/java/com/kormax/universalreader/tlv/ber/BerTlvMessage.kt - BER-TLV message → Byte unpacking: parses with
app/src/main/java/com/kormax/universalreader/tlv/ber/BerTlvMessage.kt