Android 指纹调试流程（高通、MTK均适用）

最新推荐文章于 2024-08-20 09:52:20 发布
最新推荐文章于 2024-08-20 09:52:20 发布
阅读量4.2k 收藏 42
点赞数 5
分类专栏： linux设备驱动
原文链接：https://blog.csdn.net/weixin_41486477/article/details/108592205
版权

前言：指纹调试我们只需要关注kernel、hal、ta就可以将其点亮，高通使用自己的tee环境，MTK则需要使用第三方tee OS，三方tee的集成调试一般会有厂家配合，主要是调试spi ta，在此就不做阐述了，下面重点介绍指纹bring up。

一、驱动调试

驱动调试分为两个方面，dts中配置上电、reset、irq、pinctrl和移植driver代码调试驱动节点。

1.dts配置

一般高通和MTK平台代码中都会有默认集成的一家指纹，只需要copy过来改下gpio，如果有用到pinctrl，也要把pinctrl name改成与驱动中的name 统一。

kernel/msm-4.9/arch/arm64/boot/dts/qcom/（对应自己项目的dts）

 

  1. fpc1020 {

  2. compatible = "fpc,fpc1020";

  3. interrupt-parent = <&tlmm>;

  4. interrupts = <48 0>;

  5. fpc,gpio_rst = <&tlmm 124 0x0>;

  6. fpc,gpio_irq = <&tlmm 48 0>;

  7. vcc_spi-supply = <&pm8953_l5>;

  8. vdd_io-supply = <&pm8953_l5>;

  9. vdd_ana-supply = <&pm8953_l5>;

  10. pinctrl-names = "fpc1020_reset_reset",

  11. "fpc1020_reset_active",

  12. "fpc1020_irq_active";

  13. pinctrl-0 = <&fpc_reset_low>;

  14. pinctrl-1 = <&fpc_reset_high>;

  15. pinctrl-2 = <&fpc_int_low>;

  16. };

以上dts段，我们移植到新项目需要修改：

（1）compatible：驱动代码里的device_id与此处的compatible匹配后，才会走probe函数。

 

  1. static const struct of_device_id fpc1020_of_match[] = {

  2. { .compatible = "fpc,fpc1020", },

  3. {}

  4. };

（2）GPIO：将reset、irq、中断号等改成自己项目的。

（3）上电：由于指纹即使灭屏休眠状态下也要能够解锁亮屏，所以指纹一般要设置为长供电，例所示为LDO供电，根据原理图，确认好自己用哪路LDO，如果该路供电非长供电，可以在rpm那边修改。

（4）pinctrl：如果厂家驱动driver不使用pinctrl操作gpio则不需要配置，如果厂家驱动driver中要求使用pinctrl，找到对应项目的pinctrl.dtsi，如下图所示.

 

  1. fpc_reset_int {

  2. fpc_reset_low: reset_low {

  3. mux {

  4. pins = "gpio124";

  5. function = "fpc_reset_gpio_low";

  6. };

  7.  

  8. config {

  9. pins = "gpio124";

  10. drive-strength = <2>;

  11. bias-disable;

  12. output-low;

  13. };

  14. };

  15.  

  16. fpc_reset_high: reset_high {

  17. mux {

  18. pins = "gpio124";

  19. function = "fpc_reset_gpio_high";

  20. };

  21.  

  22. config {

  23. pins = "gpio124";

  24. drive-strength = <2>;

  25. bias-disable;

  26. output-high;

  27. };

  28. };

  29.  

  30. fpc_int_low: int_low {

  31. mux {

  32. pins = "gpio48";

  33. };

  34. config {

  35. pins = "gpio48";

  36. drive-strength = <2>;

  37. bias-pull-down;

  38. input-enable;

  39. };

  40. };

  41. };

（a）要检查gpio是否是自己项目的，下属的label例如fpc_reset_low与dtsi中pinctrl-0 = <&fpc_reset_low>是否匹配。

  (b)检查项目dts中，pinctrl-names = "fpc1020_reset_reset",
                "fpc1020_reset_active",
                "fpc1020_irq_active";

 与驱动driver probe函数解析dts时，name是否统一，如不统一很有可能会死机，需要抓串口分析。

 

  1. rc = select_pin_ctl(fpc1020, "fpc1020_reset_reset");

  2. rc = select_pin_ctl(fpc1020, "fpc1020_irq_active");

2.驱动driver移植

（1）在kernel/driver/input下，新建fingerprint/fpc文件夹，将厂商提供的驱动代码放到kernel/driver/input/fingerprint/fpc，同时编写Kconfig和Makefile文件。

 

  1. Kconfig:

  2.  

  3. menu "FingerprintCard fingerprint driver"

  4. config FINGERPRINT_FPC

  5. default n

  6. tristate "FPC_BTP fingerprint sensor support"

  7. depends on SPI_MASTER

  8.  

  9. endmenu

 

  1. Makefile:

  2.  

  3. obj-$(FINGERPRINT_FPC) += fpc1020.o

（2）Kconfig和Makefile在kernel中是从顶层开始递归调用的，所以还要将新添加的纳入上一层目录的Kconfig和Makefile中，这里就不赘述了，做过驱动的都知道。

（3）在kernel/arch/arm64/configs/ 目录下找到自己项目对应的deconfig和perf-deconfig，加入

CONFIG_FINGERPRINT_FPC=y

   注：这里FINGERPRINT_FPC要与（1）中Kconfig和Makefile中保持一致

 

以上完成后，单编boot和dtbo，单独刷机验证，确认能否开机，以及设备节点是否生成。（此处多数厂家指纹无法通过串口log打印确认dts是否正确被解析，因为这些厂家指纹的dts解析，是由厂家ca发命令解析的，要等ca集成后再看。）

二、hal层移植

1.so库

一般厂家是释放so库的，极少数厂家释放半开源代码给你，这就需要自己调试编译。so一般有fingerprint.default.so和厂家的例如汇顶的gf_hal、gf_ca、工模相关so等。

以so库释放：将so放置在对应目录下，在项目的mk文件里将so纳入版本编译，例如：

PRODUCT_COPY_FILES+= vendor/fingerprint/goodix/fingerprint.default.so:vendor/lib64/hw/fingerprint.default.so

非so库释放：编写Android.mk即可

so只要编译出来是可以单独push的。

2.hal 服务

（1）需要检查下out目录里是否编译出android.hardware.biometrics.fingerprint@2.1-service相关的so和bin文件，一般默认是没有的。没有的话要将这块纳入编译，也可以单独编译push。

（2）需要确认下在hardware/interfaces/biometrics/fingerprint/2.1/default/BiometricsFingerprint.cpp   openhal函数中打开的so库，是否与自己调试的这家name匹配，FINGERPRINT_HARDWARE_MODULE_ID默认是fingerpritn.default.so，如果不一致将FINGERPRINT_HARDWARE_MODULE_ID定义为自己的就行了。

（3）将android.hardware.biometrics.fingerprint@2.1-service.rc 纳入编译，配置该服务开机自启动

（4）hidl修改

Android P以及之后需要修改三处：

device/$product/manifest.xml

hardware/interfaces/compatibility_matrices/...

device/qcom/common/vendor_framework_compatibility_matrix.xml

 

  1. <hal format="hidl" optional="true">

  2. <name>android.hardware.biometrics.fingerprint</name>

  3. <version>2.1</version>

  4. <interface>

  5. <name>IBiometricsFingerprint</name>

  6. <instance>default</instance>

  7. </interface>

  8. </hal>

注：语法不一样，device/$product/manifest.xml中添加时是需要去除上述图中optional="true"的。

三、TA移植

这个移植过程按照厂商给的文档一步步移植就可以了，这个在此就不赘述了，最后编译出来的ta在调试阶段也可以单独push 验证。

四、其他配置

（1）在init rc中修改节点权限

 

  1. chown system system dev/goodix_fp

  2. chmod 0664 /dev/goodix_fp

（2）打开setting中指纹选项

PRODUCT_COPY_FILES := frameworks/native/data/etc/android.hardware.fingerprint.xml:vendor/etc/permissions/android.hardware.fingerprint.xml

（3）确认spi号，kernel侧检查dts中端口的配置是否正确，在tz侧修改成指纹要用的spi号。

五、模组兼容

一般手机外设器件为了降低风险，模组会有多供料，一般是不同IC的。如果是同一IC，不同模组的，这个不需要我们自己做什么工作了，IC厂家otp中会烧录自己会识别，我们下面重点介绍不同IC的兼容。

方法一：硬件ID兼容

一般硬件会预留ID pin，一个ID pin高低可以兼容两家，两个ID pin可以兼容四家。

1.在lk阶段读取fp_id pin脚value

gpio_get_value（unsigned gpio）//这个是返回寄存器的值 ，需要换算成二进制，再结合数据手册看下gpio哪一位是表示高低电平的

2.利用cmdline，将value值从lk传递至kernel

3.kernel读取saved_command_line值，创建节点并写入值

4.hal中通过读取节点值来加载不同厂商的so

方法二：轮询加载兼容

1.驱动只创建设备结点，不申请配置GPIO和中断

2.在BiometricsFingerprint.cpp的openhal函数中轮询加载各家fingerprint.default.so

3.在ca中去配置GPIO，由供应商在so中完成ID检测，在没有检测到自家指纹模组的时候返回

六、selinux权限

上述是在userdebug版本上关闭selinux权限调试的，需要调试selinux权限保证打开selinux时，指纹仍可用。

调试方法：

adb shell getenforce //查看selinux权限状态，enforcing打开、permissive关闭

adb shell setenforce  0 //关闭selinux权限

adb shell setenforce  1 //打开selniux权限

adb shell stop //上述关闭重启后就会再次打开，可以在关闭selinux权限后执行stop start，这样设备重启后,selinux也不会再次被打开，方便调试

adb shell start

关于selinux权限如何配置，网上资料很多，在此就不赘述了。

七、常见问题

1.死机

常见原因：

（1）dts配置有问题：一般就是前面介绍的name不匹配造成的，抓取串口log，probr=e函数解析dts的代码逐行添加log，确认是哪里出错的，修改即可。

（2）tz内存：移植ta后需要扩大tz内存，不然很有可能会造成死机，每个平台修改的方式不太一样，这个可以问平台方要文档，比对文档修改即可。

Android P高通平台的可以参照：https://blog.csdn.net/dshine_/article/details/85101887

（3）指针异常：找到异常地址处，使用add2line解析出是哪个文件哪一行的代码再分析。

2.无法读取到sensor ID

常见原因：
（1）上电：电压表测量下供电是否符合厂商datasheet要求

（2）spi不通：检查下tz侧的端口号配置是否正确，该spi端口号是否是tz侧用的。（如果是AP侧则需要修改）

3.ta load 不起来

99%是tz内存有问题，如果你坚持认为你按照平台文档已经修改了，那么请你检查你的修改是否生效了

4.setting里没有指纹选项

检查manifest.xml和android.hardware.fingerprint.xml 是否在手机里，要两者都配置了才会出来指纹选项。

八、总结

指纹调试过程中，驱动、so、ta、rc这些都是可以单独刷机或者push的，但是内存和manifest.xml（有的平台能够单独push，在vendor/etc/vintf目录下，但是有的平台push是会死机的，所以不建议单独push）这个是需要全编译生效的，所以在三大件点亮正式开始调试之前一定要先编个已经配置好这些并且能正常开机的版本。

另，指纹其他的如果单独push很可能会乱掉，忘记push 哪一个再回来抓log查看，会非常费时费力，所以建议调试前编译第一个版本的时候，就先把so 、ta、2.1相关、rc等等先全部预置进去，后期哪里有问题，再单独push替换即可。

lilifang_2011
关注
专栏目录
Android 指纹移植调试流程（高通、MTK均适用）
weixin_41486477的博客
09-15 4284
前言：指纹调试我们只需要关注kernel、hal、ta就可以将其点亮，高通使用自己的tee环境，MTK则需要使用第三方tee OS，三方tee的集成调试一般会有厂家配合，主要是调试spi ta，在此就不做阐述了，下面重点介绍指纹bring up。 一、驱动调试 驱动调试分为两个方面，dts中配置上电、reset、irq、pinctrl和移植driver代码调试驱动节点。 1.dts配置 一般高通和MTK平台代码中都会有默认集成的一家指纹，只需要copy过来改下gpio，如果有用到pinctrl，也要
Android 指纹解锁源码流程分析
05-17
在分析指纹解锁之前我们需要分析SystemUI如何实现指纹监听的, 本文档从源码角度分析指纹解锁的流程.对指纹解锁进行一定程度的分析
Android MTK 屏下指纹的调试过程记录
美丽心情
04-11 1223
1， 自从Android 12 以后， SystemUI 里是自带了屏下指纹方案的. 具体代码是在 frameworks\base\packages\SystemUI\src\com\android\systemui\biometrics ，所有以 Udfps 开头的类均是跟屏下指纹相关。一些品牌手机都有了屏下指纹的功能，还算是个比较新颖的功能，最近有项目需要使用屏下指纹， 使用的是汇顶（Goodix）的指纹方案，经过坚难尝试，终于实现了屏下指纹录入与解锁，下面记录一些知识要点，同时分享给遇到相同问题的。
Goodix-FP-Dump 开源项目教程
最新发布
gitblog_00122的博客
08-20 311
Goodix-FP-Dump 开源项目教程 goodix-fp-dumpAll our work to make Goodix fingerprint sensors work on Linux. Thanks to @markusressel and @PJungkamp for sponsoring.项目地址:https://gitcode.com/gh_mirrors/go/goodix-...
MT6580 Android8.1调试移植费恩格尔指纹驱动
xiezhi123456的博客
08-09 1499
  1、首先用万用表确定好vcc 2.8v和1.8v的供电正常，有的平台2.8v是软件控制打开，有的平台是直接硬件长供的。 2、根据原理图确定好gpio的配置主要包括spi_cs,spi_sck，spi_miso，spi_mosi，还有复位脚rst和中断脚int:，使用的是哪一组SPI通讯等。 3、dts添加cdfinger 的节点，gpio的配置等，注意查看所使用的gpio是否有其他地方有...
Android8.0指纹调试
xiezhi123456的博客
08-24 1372
https://blog.csdn.net/g241893312/article/details/78668740
瑞芯微RK3588S Android12 REE 指纹代码移植（1）--Kernel移植
happyball115的博客
10-23 643
RK3588S Android12 SDK源码中kernel 版本为kernel-5.10，使用的是gf3626指纹模组。使用ree 进行spi 通讯。指纹模组供电电压3.3V， SPI通讯电压1.8V， 最高通讯速率24M。以此记录移植过程。
Android 指纹识别详解及实现方法
01-20
在Android平台上，指纹识别功能自Android 6.0（API级别23）开始引入，它为用户提供了一种安全的身份验证方式。在实现指纹识别前，首先需要检查用户的设备是否支持此功能，这可以通过`FingerprintManager`类的`...
高通平台指纹常见问题调试
03-03
高通平台指纹常见问题调试 在 Android 设备中，指纹识别技术已经成为一种非常流行的身份验证方式，高通平台作为 Android 设备的重要组件，指纹识别技术在高通平台中的实现变得非常重要。在本文中，我们将对高通平台...
android实现指纹识别功能
08-25
Android 实现指纹识别功能 Android 实现指纹识别功能是 Android 开发中的一项重要功能，通过指纹识别可以提供更加安全和便捷的身份验证方式。本文将详细介绍 Android 实现指纹识别功能的实现步骤和相关知识点。 一...
指纹调试关键点
NET_zzz的博客
10-18 597
指纹
指纹仪调试软件
12-09
指纹仪调试软件 支持光学、电容指纹仪的调试测试。
指纹传感器FPC1080在android下的驱动
09-28
指纹传感器FPC1080,在android下的驱动，详细的源代码。
简单实现Android 6.0指纹识别Demo
03-15
详细而简单的Android 6.0 指纹Demo
android指纹移植bug,MT6580 Android8.1调试移植费恩格尔指纹驱动
weixin_31049801的博客
05-28 693
1、首先用万用表确定好vcc 2.8v和1.8v的供电正常，有的平台2.8v是软件控制打开，有的平台是直接硬件长供的。2、根据原理图确定好gpio的配置主要包括spi_cs,spi_sck，spi_miso，spi_mosi，还有复位脚rst和中断脚int:，使用的是哪一组SPI通讯等。3、dts添加cdfinger 的节点，gpio的配置等，注意查看所使用的gpio是否有其他地方有复用:vim...
指纹调试 mtk android8.1
每一个不曾起舞的日子，都是对生命的辜负
05-10 2087
一 指纹调试思路,总纲 二 硬件原理图 三 如何确认是否移植好finger驱动？ a)probe函数调试的初始化是否成功，打印信息确认 b)查看设备节点是否生成 /dev/sunwave_fp c)SPI通信是否成功， 1）确认pin脚初始化是否正确，是否被占用，cs,clk,rst,miso,mosi,...
展锐7731E Android8.0 REE 32位指纹代码移植
happyball115的博客
05-24 603
展锐7731E Android8.0 REE 32位平台无法兼容多家指纹 一，移植REE 时，在kernel prboe SPI 通讯读取chip ID 时会概率性读取失败。导致的问题就是不能在kernel 里面读取id 来继续加载驱动或者卸载驱动并释放资源，从而达到兼容其他家的指纹目的。 二，展锐7731E REE 时在dts 兼容时不能向其他平台一样，分别定义各自dts文件， 需要写在同一个大括号内。如下使用spi1，compatible 以及 GPIO设定需要放在一起，否者无法： &spi1
MTK指纹驱动移植与调试指南
"指纹移植调试指导文档.pdf" 是一份针对MTK(Mediatek)平台指纹驱动开发的详细文档，旨在简化指纹驱动的移植和开发流程。文档涵盖了REE(Regular Execution Environment)和TEE(Trusted Execution Environment)环境的...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值