It is about HCE, for DroidKaigi 2018

1. HostCardEmulation
@azukinohiroki

2. @azukinohiroki
•
•
• IC OS
•

3. • 2011
• We are hiring!

5. HCE

6. • Android4.4 2013
•
HCE …

7. (^o^)

9. agenda
• HCE
• NFC
• Android with HCE

10. …

11. HCE

12. https://developer.android.com/guide/topics/connectivity/nfc/hce.html

13. Host-based Card Emulation
• Android NFC
NFC
SIM
Android 4.4 Host-based Card Emulation
Android NFC

15. Host-based Card Emulation
• HCE
Android

16. Host-based Card Emulation
• HCE
Android

17. •
•
•
•

18. Host-based Card Emulation
• HCE
Android

19. NFC

20. https://developer.android.com/guide/topics/connectivity/nfc/index.html

21. NFC
• Near Field Communication
• NFC
4cm NFC
Android NFC Android

22. 3
• Card emulation mode
• Reader/writer mode
• P2P mode
NFC

23. NFC

24. …
• iOS iOS11 NFC
• NDEF

25. …
• iOS iOS11 NFC
• NDEF

27. • Service
• Manifest
•

28. 1. Service

29. 1. Service
class MyHostApduService : HostApduService() {
override fun processCommandApdu(commandApdu: ByteArray, extras: Bundle?): ByteArray {
if (Utils.isEqual(SELECT, commandApdu)) {
return "Hello, HCE!!".toByteArray()
}
return byteArrayOf(0x90.toByte(), 0x00)
}
override fun onDeactivated(reason: Int) {
}
……

30. 1. Service
class MyHostApduService : HostApduService() {
override fun processCommandApdu(commandApdu: ByteArray, extras: Bundle?): ByteArray {
if (Utils.isEqual(SELECT, commandApdu)) {
return "Hello, HCE!!".toByteArray()
}
return byteArrayOf(0x90.toByte(), 0x00)
}
override fun onDeactivated(reason: Int) {
}
……

31. 1. Service
class MyHostApduService : HostApduService() {
override fun processCommandApdu(commandApdu: ByteArray, extras: Bundle?): ByteArray {
if (Utils.isEqual(SELECT, commandApdu)) {
return "Hello, HCE!!".toByteArray()
}
return byteArrayOf(0x90.toByte(), 0x00)
}
override fun onDeactivated(reason: Int) {
}
……

32. 1. Service
class MyHostApduService : HostApduService() {
override fun processCommandApdu(commandApdu: ByteArray, extras: Bundle?): ByteArray {
if (Utils.isEqual(SELECT, commandApdu)) {
return "Hello, HCE!!".toByteArray()
}
return byteArrayOf(0x90.toByte(), 0x00)
}
override fun onDeactivated(reason: Int) {
}
……

33. 1. Service
class MyHostApduService : HostApduService() {
override fun processCommandApdu(commandApdu: ByteArray, extras: Bundle?): ByteArray {
if (Utils.isEqual(SELECT, commandApdu)) {
return "Hello, HCE!!".toByteArray()
}
return byteArrayOf(0x90.toByte(), 0x00)
}
override fun onDeactivated(reason: Int) {
}
……

34. 1. Service
class MyHostApduService : HostApduService() {
override fun processCommandApdu(commandApdu: ByteArray, extras: Bundle?): ByteArray {
if (Utils.isEqual(SELECT, commandApdu)) {
return "Hello, HCE!!".toByteArray()
}
doSomething()
return null
}
fun somethingHasDone() {
sendResponseApdu(byteArrayOf(0x90.toByte(), 0x00))
}
override fun onDeactivated(reason: Int) {
}
……

35. 1. Service
class MyHostApduService : HostApduService() {
override fun processCommandApdu(commandApdu: ByteArray, extras: Bundle?): ByteArray {
if (Utils.isEqual(SELECT, commandApdu)) {
return "Hello, HCE!!".toByteArray()
}
doSomething()
return null
}
fun somethingHasDone() {
sendResponseApdu(byteArrayOf(0x90.toByte(), 0x00))
}
override fun onDeactivated(reason: Int) {
}
……

36. 1. Service
class MyHostApduService : HostApduService() {
override fun processCommandApdu(commandApdu: ByteArray, extras: Bundle?): ByteArray {
if (Utils.isEqual(SELECT, commandApdu)) {
return "Hello, HCE!!".toByteArray()
}
return byteArrayOf(0x90.toByte(), 0x00)
}
override fun onDeactivated(reason: Int) {
}
……

37. 2. AndroidManifest.xml

38. permission
<uses-permission android:name=“android.permission.NFC"/>
<application … >
<service
android:name=“.MyHostApduService”
android:exported="true"
android:permission="android.permission.BIND_NFC_SERVICE">
<intent-filter>
<action android:name="android.nfc.cardemulation.action.HOST_APDU_SERVICE"/>
<category android:name="android.intent.category.DEFAULT"/>
</intent-filter>
<meta-data
android:name="android.nfc.cardemulation.host_apdu_service"
android:resource="@xml/apduservice"/>
</service>
</application>

39. service
<uses-permission android:name=“android.permission.NFC"/>
<application … >
<service
android:name=“.MyHostApduService”
android:exported="true"
android:permission="android.permission.BIND_NFC_SERVICE">
<intent-filter>
<action android:name="android.nfc.cardemulation.action.HOST_APDU_SERVICE"/>
<category android:name="android.intent.category.DEFAULT"/>
</intent-filter>
<meta-data
android:name="android.nfc.cardemulation.host_apdu_service"
android:resource="@xml/apduservice"/>
</service>
</application>

40. service
<uses-permission android:name=“android.permission.NFC"/>
<application … >
<service
android:name=“.MyHostApduService”
android:exported="true"
android:permission="android.permission.BIND_NFC_SERVICE">
<intent-filter>
<action android:name="android.nfc.cardemulation.action.HOST_APDU_SERVICE"/>
<category android:name="android.intent.category.DEFAULT"/>
</intent-filter>
<meta-data
android:name="android.nfc.cardemulation.host_apdu_service"
android:resource="@xml/apduservice"/>
</service>
</application>

41. intent-filter meta-data
<uses-permission android:name=“android.permission.NFC"/>
<application … >
<service
android:name=“.MyHostApduService”
android:exported="true"
android:permission="android.permission.BIND_NFC_SERVICE">
<intent-filter>
<action android:name="android.nfc.cardemulation.action.HOST_APDU_SERVICE"/>
<category android:name="android.intent.category.DEFAULT"/>
</intent-filter>
<meta-data
android:name="android.nfc.cardemulation.host_apdu_service"
android:resource="@xml/apduservice"/>
</service>
</application>

42. <uses-permission android:name=“android.permission.NFC"/>
<application … >
<service
android:name=“.MyHostApduService”
android:exported="true"
android:permission="android.permission.BIND_NFC_SERVICE">
<intent-filter>
<action android:name="android.nfc.cardemulation.action.HOST_APDU_SERVICE"/>
<category android:name="android.intent.category.DEFAULT"/>
</intent-filter>
<meta-data
android:name="android.nfc.cardemulation.host_apdu_service"
android:resource="@xml/apduservice"/>
</service>
</application>

43. intent-filter meta-data
<uses-permission android:name=“android.permission.NFC"/>
<application … >
<service
android:name=“.MyHostApduService”
android:exported="true"
android:permission="android.permission.BIND_NFC_SERVICE">
<intent-filter>
<action android:name="android.nfc.cardemulation.action.HOST_APDU_SERVICE"/>
<category android:name="android.intent.category.DEFAULT"/>
</intent-filter>
<meta-data
android:name="android.nfc.cardemulation.host_apdu_service"
android:resource="@xml/apduservice"/>
</service>
</application>

44. xml/apduservice.xml
<host-apdu-service xmlns:android="http://schemas.android.com/apk/res/android"
android:description="@string/servicedesc"
android:requireDeviceUnlock="false">
<aid-group
android:category="other"
android:description="@string/aiddescription">
<aid-filter android:name="F0010203040506"/>
<aid-filter android:name="F0394148148100"/>
</aid-group>
</host-apdu-service>

45. xml/apduservice.xml
<host-apdu-service xmlns:android="http://schemas.android.com/apk/res/android"
android:description="@string/servicedesc"
android:requireDeviceUnlock="false">
<aid-group
android:category="other"
android:description="@string/aiddescription">
<aid-filter android:name="F0010203040506"/>
<aid-filter android:name="F0394148148100"/>
</aid-group>
</host-apdu-service>

46. xml/apduservice.xml
<host-apdu-service xmlns:android="http://schemas.android.com/apk/res/android"
android:description="@string/servicedesc"
android:requireDeviceUnlock="false">
<aid-group
android:category="other"
android:description="@string/aiddescription">
<aid-filter android:name="F0010203040506"/>
<aid-filter android:name="F0394148148100"/>
</aid-group>
</host-apdu-service>

47. HCE

48. R/W

49. • NFC
• Tag Dispatch System
• Foreground Dispatch System
• NFC reader mode

50. • NFC
• Tag Dispatch System
• Foreground Dispatch System
• NFC reader mode

52. enableReaderMode
override fun onResume() {
super.onResume()
val adapter = NfcAdapter.getDefaultAdapter(context)
adapter.enableReaderMode(
context,
this,
NfcAdapter.FLAG_READER_NFC_A or NfcAdapter.FLAG_READER_SKIP_NDEF_CHECK,
null)
}
override fun onTagDiscovered(tag: Tag) {
val nfc = IsoDep.get(tag)
nfc.connect()
val res = nfc.transceive(SELECT)
Log.d(TAG, String(res, Charset.forName("UTF-8")))
}

53. enableReaderMode
override fun onResume() {
super.onResume()
val adapter = NfcAdapter.getDefaultAdapter(context)
adapter.enableReaderMode(
context,
this,
NfcAdapter.FLAG_READER_NFC_A or NfcAdapter.FLAG_READER_SKIP_NDEF_CHECK,
null)
}
override fun onTagDiscovered(tag: Tag) {
val nfc = IsoDep.get(tag)
nfc.connect()
val res = nfc.transceive(SELECT)
Log.d(TAG, String(res, Charset.forName("UTF-8")))
}

54. enableReaderMode
override fun onResume() {
super.onResume()
val adapter = NfcAdapter.getDefaultAdapter(context)
adapter.enableReaderMode(
context,
this,
NfcAdapter.FLAG_READER_NFC_A or NfcAdapter.FLAG_READER_SKIP_NDEF_CHECK,
null)
}
override fun onTagDiscovered(tag: Tag) {
val nfc = IsoDep.get(tag)
nfc.connect()
val res = nfc.transceive(SELECT)
Log.d(TAG, String(res, Charset.forName("UTF-8")))
}

55. enableReaderMode
override fun onResume() {
super.onResume()
val adapter = NfcAdapter.getDefaultAdapter(context)
adapter.enableReaderMode(
context,
this,
NfcAdapter.FLAG_READER_NFC_A or NfcAdapter.FLAG_READER_SKIP_NDEF_CHECK,
null)
}
override fun onTagDiscovered(tag: Tag) {
val nfc = IsoDep.get(tag)
nfc.connect()
val res = nfc.transceive(SELECT)
Log.d(TAG, String(res, Charset.forName("UTF-8")))
}

56. enableReaderMode
override fun onResume() {
super.onResume()
val adapter = NfcAdapter.getDefaultAdapter(context)
adapter.enableReaderMode(
context,
this,
NfcAdapter.FLAG_READER_NFC_A or NfcAdapter.FLAG_READER_SKIP_NDEF_CHECK,
null)
}
override fun onTagDiscovered(tag: Tag) {
val nfc = IsoDep.get(tag)
nfc.connect()
val res = nfc.transceive(SELECT)
Log.d(TAG, String(res, Charset.forName("UTF-8")))
}

57. enableReaderMode
override fun onResume() {
super.onResume()
val adapter = NfcAdapter.getDefaultAdapter(context)
adapter.enableReaderMode(
context,
this,
NfcAdapter.FLAG_READER_NFC_A or NfcAdapter.FLAG_READER_SKIP_NDEF_CHECK,
null)
}
override fun onTagDiscovered(tag: Tag) {
val nfc = IsoDep.get(tag)
nfc.connect()
val res = nfc.transceive(SELECT)
Log.d(TAG, String(res, Charset.forName("UTF-8")))
}

58. enableReaderMode
override fun onResume() {
super.onResume()
val adapter = NfcAdapter.getDefaultAdapter(context)
adapter.enableReaderMode(
context,
this,
NfcAdapter.FLAG_READER_NFC_A or NfcAdapter.FLAG_READER_SKIP_NDEF_CHECK,
null)
}
override fun onTagDiscovered(tag: Tag) {
val nfc = IsoDep.get(tag)
nfc.connect()
val res = nfc.transceive(SELECT)
Log.d(TAG, String(res, Charset.forName("UTF-8")))
}

59. SELECT
val SELECT = byteArrayOf(
0x00, 0xA4.toByte(), 0x04, 0x00,
0x07,
0xF0.toByte(), 0x39, 0x41, 0x48, 0x14, 0x81.toByte(), 0x00,
0x00
)

60. SELECT
val SELECT = byteArrayOf(
0x00, 0xA4.toByte(), 0x04, 0x00,
0x07,
0xF0.toByte(), 0x39, 0x41, 0x48, 0x14, 0x81.toByte(), 0x00,
0x00
)

61. SELECT
val SELECT = byteArrayOf(
0x00, 0xA4.toByte(), 0x04, 0x00,
0x07,
0xF0.toByte(), 0x39, 0x41, 0x48, 0x14, 0x81.toByte(), 0x00,
0x00
)

62. xml/apduservice.xml
<host-apdu-service xmlns:android="http://schemas.android.com/apk/res/android"
android:description="@string/servicedesc"
android:requireDeviceUnlock="false">
<aid-group
android:category="other"
android:description="@string/aiddescription">
<aid-filter android:name="F0010203040506"/>
<aid-filter android:name="F0394148148100"/>
</aid-group>
</host-apdu-service>

63. …
• NfcA TagLostException
•
• EXTRA_READER_PRESENCE_CHECK_DELAY

65. HCE-F
• Android7.0
• FeliCa
• SystemCode Idm
•
https://developer.android.com/reference/android/nfc/cardemulation/
NfcFCardEmulation.html#registerSystemCodeForService(android.content.ComponentName,%20java.lang.String)

67. HCE on Android
• SE
•
•