NFC Architecture in Android System

NFC在安卓系统中的架构如下，从上到下每一层都有涉及到，但是和移植Sensor等其他外围设备有所不同，他从上到下都是独立于整个系统框架之外的。就好似附在 Android 这颗参天大树上的一束藤蔓。下面是我们将其移植到 Android 系统需要在各个层级所添加的内容。 

Porting Guide

现在 NFC 市场份额最大的就是 NXP 的料，比如 PN547、PN548、PN65T。 
我们以 NXP 的 NFC 为例。 

所谓 NFC ，实际上是包括 NFCC（NFC Controller）和 eSE（安全芯片），eSE 可以是独立的，也可以是和 Sim 卡集成的。 
加上加密模块就可以完成卡模拟（Card Simulation）功能，如果没有加密模块便只能实现 P2P 和 Reader 功能。 
PN547 PN548 不支持独立的 eSE，只能和加密的 Sim 卡协同工作。 
PN65T 支持独立的 eSE，所以除了移植 NFCC （I2C设备）以外，我们还需要移植 eSE（SPI）。

代码结构

从代码上而言，驱动部分 PN547 和 PN548 采用的都是 PN544 的驱动文件。 但是会由于 Android 平台的版本有所少许差异。比如在 Android4.4 中有的平台还未引入 DTS 机制，驱动中会有一些板级配置的信息。在 Android5.1 后，引入了 DTS 机制，驱动中删除了对应的 platform 的信息，增加了 of 表。 
Android 上层的差异因 Android 系统的版本差异产生的区别更大。 
在本文中我们主要分析 Android 5.1下 PN548 的 NFC 移植问题。采用的 NXP 的代码包为：FC_NCIHALx_ARF.3.3.0_L_FW08.01.26_FW10.01.14 。 
其代码结构如下： 
 
external 目录下是 NCI based NFC stack implementation，注意 halimpl 这个三级目录中的 pn54x 下是 HAL 层的接口。 
frameworks 目录下是 NFC 接口和公用的 API。 
packages 是 NFC JNI and Java implementation of NCI stack frameworks/base/core/Java/android/nfc 及frameworks/base/core/java/com/nxp/nfc 将会生成 /system/framework/ 下 framework.jar 的一部分。 
packages/apps/Nfc/nci 将会在 /system/lib 下生成 libnfc_nci_jni.so ,将在 /system/app/NfcNci 生成 NfcNci.apk 
external/libnfc-nci 将会在 /system/lib 下生成 libnfc_nci.so，将在 /system/lib/hw 下生成 nfc_nci_pn54x.default.so

Kernel 移植

驱动方面，NFCC 是一个 I2C 设备，NFCC 与 DH（Device Host）使用 I2C 接口进行通信。 
1. 添加驱动文件。创建目录 pn544 并添加驱动文件 drivers/pn544/pn548.c 与 include/Linux/pn548.h 
在该驱动文件中实现了 对 PN548 的 NFCC 的 Reading 与 Writing、Power Setting、GPIOs 控制。并且在同目录下添加 Makefile 编译规则 与 Kconfig 配置文件。 
2. 配置板级信息。在 Android4.4 的平台中，还未引入 DTS 系统，需要在板级文件中修改相应设置，展讯平台是 arch/arm/mach-sc/board-sp7731gea.c。在板级文件中设置 NFC VEN、FirmwareGPIO、IRQ，并且注册 I2C Address。还需要修改 arch/arm/configs 下的 deconfig 文件。 
在 Android5.1 平台中，引入了 DTS 机制，不需要修改板级文件，需要修改 DTS 文件。同时 Driver 中也要注释掉对应 platform 相应的代码，添加 of 表。 
3. 添加平台配置属性。 如展讯平台是在 IDH/device/sprd/scx35/init.scx8830.rc 中的 on boot 后，添加 #for nfc setprop ro.nfc.port "I2C" chmod 0660 /dev/pn544 chown nfc nfc /dev/pn544

• 1
• 2
• 3
• 4

• 1
• 2
• 3
• 4

在 on post-fs-data 后添加 on post-fs-data copy /system/etc/bluetooth/bt_stack.conf /data/misc/bluedroid/bt_stack.conf chown bluetooth system /data/misc/bluedroid/bt_stack.conf chmod 0640 /data/misc/bluedroid/bt_stack.conf mkdir /data/local/media 0777 media system mkdir /data/local/tmp/slog 0777 mkdir /data/anr 0771 system system mkdir /data/tombstones 0771 system system mkdir /data/corefile chmod 777 /data/corefile ++ mkdir /data/nfc 0770 nfc nfc ++ mkdir /etc/param ++ # Set indication (checked by vold) that we have finished this action ++ setprop vold.post_fs_data_done 1 # to force to start sdcard class_start late_start

• 1
• 2
• 3
• 4
• 5
• 6
• 7
• 8
• 9
• 10
• 11
• 12
• 13
• 14
• 15
• 16
• 17

• 1
• 2
• 3
• 4
• 5
• 6
• 7
• 8
• 9
• 10
• 11
• 12
• 13
• 14
• 15
• 16
• 17

编译完成后可以在 /dev/下检测 pn544 节点是否正常生成。这里只是调整节点权限，使上层可以正常的读写节点。 
4. Hardware目录下，hardware/libhardware/include/hardware/nfc.h 中 添加 #define NFC_NCI_NXP_PN54X_HARDWARE_MODULE_ID "nfc_nci.pn54x"

• 1

• 1

5.I2C 测试。利用 pn54x_i2c_test 工具测试 I2C 是否能够进行通信。 完成了 Kernel 部分的移植后可以开始上层代码的移植了。

上层代码的移植

1. external/libnfc-nci 删除后用 NXP 提供的代码替换。
2. packages/apps/Nfc 删除后用 NXP 提供的代码替换。
3. frameworks/base/core/java/android/nfc 删除后用 NXP 提供的代码替换。
4. frameworks/base/core/java/com/nxp 删除后用 NXP 提供的代码替换。
5. frameworks/base/core/java/com/vzw 删除后用 NXP 提供的代码替换。
6. 对比修改 frameworks/base/Android.mk 文件。主要是添加 NFC 相关的语句。
7. device/下的平台文件进行对比添加。 
   的 
   device-common.mk 为平台的 mk，这个里面需要添加的内容较多。

# nxp nfc PRODUCT_PACKAGES += libnfc-nci libnfc_nci_jni nfc_nci_pn548.default NfcNci Tag com.android.nfc_extras PRODUCT_COPY_FILE += frameworks/native/data/etc/com.nxp.mifare.xml:system/etc/permissions/com.nxp.mifare.xml frameworks/native/data/etc/com.android.nfc_extras.xml:system/etc/permissions/com.android.nfc_extras.xml frameworks/native/data/etc/android.hardware.nfc.xml:system/etc/permissions/android.hardware.nfc.xml frameworks/native/data/etc/android.hardware.nfc.hce.xml:system/etc/permissions/android.hardware.nfc.hce.xml ``` 8. 在平台文件夹下对应添加文件 libnfc-brcm.conf libnfc-nxp.conf libpn548ad_fw.so 并在 device.mk 中添加对应的语句：

• 1
• 2
• 3
• 4
• 5
• 6
• 7
• 8
• 9
• 10
• 11
• 12
• 13
• 14
• 15
• 16
• 17
• 18
• 19

• 1
• 2
• 3
• 4
• 5
• 6
• 7
• 8
• 9
• 10
• 11
• 12
• 13
• 14
• 15
• 16
• 17
• 18
• 19

NFC_FW_PATCH := device/板级路径/libpn547_fw.so PRODUCT_COPY_FILES += $(NFC_FW_PATCH):system/vendor/firmware/libpn547ad_fw.so NFC_CONFIG_PATCH := device/板级路径/libnfc-brcm.conf PRODUCT_COPY_FILES += $(NFC_CONFIG_PATCH):system/etc/libnfc-brcm.conf NFC_CONFIG_NXP_PATCH := device/板级路径/libnfc-nxp.conf PRODUCT_COPY_FILES += $(NFC_CONFIG_NXP_PATCH):system/etc/libnfc-nxp.conf “` 
正常情况下编译后会在 dev下生成 pn544 的节点。 
在 system/etc 下生成 libnfc-nxp.conf 
在 system/etc 下生成 libnfc-nxp.conf 
在 system/lib 下生成 libpn548ad_fw.so 
在 system./lib/hw 下生成 nfc_nci_pn54x.default.so 
开机后会在设置中的“更多”选项中看到 NFC 的菜单，并且能够正常开关。

编译选项

libnfc-nxp.conf