硬件信息添加方法

wenhaounique

因为在帖子上看不到图片，无法完全达到本文档所要解释的效果，所以请大家下载原文件（附图片），在附件处，免费哦

驱动技术报告
（2015届）
题    目        硬件信息添加方法
部   门        研发一部
分   部        软件一部
组  别        驱动组
作者姓名        周文豪
小组主管        曾阳
完成日期        2015-07-23~2015-07-24


摘  要
随着PAD主机的工厂模式版本对需要兼容的硬件类型越来越多，底层驱动所需要加载的相应的硬件驱动配置文件越来越多，对于非底层开发者来说查阅硬件信息越来越困难。这就需要驱动工作者通过在驱动代码里添加简单的硬件信息显示的功能函数，使驱动工作以已配置的硬件驱动信息显示在PAD的“HARDWAREINFR”界面中，使其令他人查阅起来一目了然。
在此，为了让大家看到这些信息，笔者不得不再一次同时也希望会是最后一次通过工程目录的配置文件信息，地毯式搜索所有的驱动文件，然后在各个文件中加入硬件显示的相关代码，从而使笔者所搜寻到的硬件的信息都能显示在“HARDWAREINFR”界面中。

关键词：PAD；  HARDWAREINFR； 硬件信息；  配置文件











ABSTRACT
  With the pad of the host plant model version on the need for compatible hardware type is more and more, the underlying driver needed to load the corresponding hardware driver configuration file more and more, for the underlying non developers access to hardware information is becoming more and more difficult. This requires workers through the driver code to add simple hardware information display function in the drive, the drive to configure the hardware driver information display in the pad "HARDWAREINFR interface the make others look up at a glance.
Here, in order to let everyone see this information, I have once again at the same time also hope will last through the profile information of the project directory, carpet search all the driver file, and add display hardware related code in each file, so that the pen the search to the hardware information can be displayed in the "HARDWAREINFR" interface.

Keywords:  PAD； HARDWAREINFR,；hardware information,；configuration file



目  录

1．引言        1
2．硬件信息函数        2
2.1 hw_module_info.c 文件        2
2.2 hw_module_info.h文件        3
3．驱动文件编辑        5
3.1 ProjectConfig.mk文件        5
3.2  hv2a_711_debug_defconfig 文件        6
4．结论        7

1．引言
"HARDWAREINFR"的界面就一直都有的，然而里面的信息并没有跟上驱动开发的脚步，里面的所显示的硬件信息很少，虽然可以直接从代码文件上查询，但这对于非驱动开发人员来说对该信息的查阅会比较繁琐，因此，笔者在这里就是扮演信息的搬运工的角色，将所需要查阅的硬件信息整理到"HARDWAREINFR"界面中。
    在该文档里，笔者以MT8735平台、HV2A_711的工程为例，以一个比较典型的某类硬件为例，完整的描述信息的添加过程。其他类型硬件信息添加方法如与上例相同则不再重复，若仅某几个步骤类似则跳过这几个步骤。





2．硬件信息函数
在进入硬件驱动文件之前，读者需要认识下跟硬件信息添加有关的功能函数所在的文件。

2.1 hw_module_info.c 文件
该文件描述了硬件信息函数的具体执行原理，和相关函数的调用方法，在笔者的HV2A_711的例子中，该文件的路径为：
ALPS.L1.MP3.V2.3_TYD8735_6TB_CMP_L1/kernel-3.10/drivers/hw_module_info/ hw_module_info.c 。
在该文件中读者最好可以关注下以下两个函数的描述，如图：

图2.1.1-a

    图2.1.1-a 的函数为具体的信息显示函数，读者如需要改变显示格式和信息类型则需要在此函数中修改，若稍微仔细看，读者不难看出，为了适应显示平台硬件信息的需求，笔者在这函数里添加了新的显示的格式。


                                图2.1.1.-c
对于什么情况下用什么显示格式的问题，笔者通过硬件类型来判断。如图2.1.1-c所示，为所有笔者所要显示的硬件类型，如果读者所要显示的硬件类型在该文件没有，则读者可自己命名类型并手动添加到如改图所示的位置，笔者在此处添加了USB和PLTAFORM类型。


图2.1.1-b

图2.1.1-b： 如函数名字所描述，为硬件信息添加函数，这个函数是将硬件信息以参数的形式添加到显示界面中，可直接调用到各个读者需要显示的硬件驱动文件中。

2.2 hw_module_info.h文件
  该文件为hw_module_info.c的参数定义和函数声明，本例子的路径为：
/ALPS.L1.MP3.V2.3_TYD8735_6TB_CMP_L1/kernel-3.10/include/linux/hw_module_info.h
   故，如果在以上图2.1.1-c中修改了参数则需要在hw_module_info.h的如下图2.1.2-a所示位置进行相应的修改。

图2.1.2-a
   若读者还想添加其他信息参数类型，可以再如下图2.1.2-b所示位置添加：

图2.1.2-b















3．驱动文件编辑
这里共有两个配置文件，都需要查看相关的硬件配置信息，两者的配置信息各不相同，笔者在此根据两文件信息各举一列。此处，笔者的两配置文件路径为：ALPS.L1.MP3.V2.3_TYD8735_6TB_CMP_L1/tyd/hv2a/hv2a_711
3.1 ProjectConfig.mk文件
根据图2.1.1-c的硬件类型，此处，笔者在该文件中搜索lens关键字，由此得到配置文件的文件名有如图：

得到主光圈文件为”fm50af”,打开该文件夹，(读者不知文件路径可根据文件名直接使用终端搜索)，然后打开.c文件，此例路径为：
ALPS.L1.MP3.V2.3_TYD8735_6TB_CMP_L1/kernel-3.10/drivers/misc/mediatek/lens/mt6735/fm50af

图3.1-a
如图，先在此文件中添加读者希望显示的硬件信息参数，然后在该驱动文件能编到的函数中调用hw_module_info_add函数，如下图3.1-b所示：笔者一般通用的都是加入到初始化函数中。

图3.1-b
3.2  hv2a_711_debug_defconfig 文件
根据图2.1.1-c的硬件类型，此处，笔者在该文件中搜索imgsensor关键字，由此得到配置文件的文件名有如图：

图3.2-a
然后其他步骤与3.1相同



4．结论
从文本论述的内容可不难总结出，对于驱动工作者，对于任何驱动文件的编辑，都需要先看下工程的配置文件信息，根据配置信息到相应的目录中进行修改，而不是盲目地修改。对于添加的新硬件驱动，则不能忘记在配置文件中添加该硬件信息。同时不能仅仅止步于函数的调用，面对特殊情况，驱动工作者需要根据某些特别的定制对某些功能函数进行一定的修改。
高质量的代码编程需要读者始终不忘提高自己编程素养，不仅自己能看得懂自己编的代码，还要让别人看得懂，不仅要提高代码的准确性，还要提高代码健壮性。

注：读者不要忘记在相应的驱动文件开头添加#include <linux/hw_module_info.h>，否者硬件信息函数无法调用。

wenhaounique

希望大家在此给点意见和建议

xixihahayqw

学无止境，顶起来。