本节书摘来自异步社区《android深度探索（卷1）：hal与驱动开发》一书中的第6章，第6.4节使用多种方式测试linux驱动，作者李宁，更多章节内容可以访问云栖社区“异步社区”公众号查看
6.4 使用多种方式测试linux驱动
android深度探索（卷1）：hal与驱动开发
在上一节已经实现了一个简单的linux驱动程序，该驱动的功能是统计给定字符串中的单词数，并且在最后已经将该linux驱动的源代码成功编译成动态linux驱动模块word_count.ko。下一步就是测试该模块。测试的方法很多，最常用的就是直接在ubuntu linux中测试。当然，这对于本章实现的linux驱动是没问题的，但是对于需要直接访问硬件的驱动在ubuntu linux上测试就不太方便。在这种情况下就需要在相应的硬件上进行测试。
对于一个linux驱动程序，一开始可以在ubuntu linux上做前期开发和测试。对于访问硬件的部分也可以在ubuntu linux用软件进行模拟。当基本开发完成后，就需要在开发板或工程样机上使用真实的硬件进行测试。当然，最后还需要在最终销售的手机上进行测试。最终测试通过，linux驱动才能算真正开发完成。在开发linux驱动的过程中一个重要的步骤就是测试。本节将结合实际的开发流程介绍在不同平台上测试linux驱动程序。这些测试平台包括ubuntu linux、android模拟器和s3c6410开发板。
6.4.1 使用ubuntu linux测试linux驱动
本节将介绍如何在ubuntu linux下测试驱动程序。由于上一节编写的linux驱动程序通过4个字节从设备文件（/dev/wordcount）返回单词数，所以不能使用cat命令测试驱动程序（cat命令不会将这4个字节还原成int类型的值显示）。但可以使用如下命令从日志中查看单词数。
执行上面的命令后，如果输出如图6-13所示白框中的信息，说明驱动程序成功统计了单词数。
虽然使用echo和dmesg命令可以测试linux驱动程序，但这种方式并不是真正的测试。为了使测试效果更接近真实环境，一般需要编写专门用于测试的程序。本节将为word_count驱动编写一个专门的测试程序（test_word_count.c）。test_word_count.c通过直接操作/dev/wordcount设备文件与word_count驱动进行交互。测试程序的代码如下：
test_word_count程序可以跟1个命令行参数（多个命令行参数只会使用第1个命令行参数）。如果命令行参数值含有空格，需要使用单引号（'）或双引号（"）将参数值括起来。可以使用下面的一组命令测试word_count驱动程序。
执行上面的命令后，如果输出如图6-14所示的信息（假设word_count以前统计过一个含有4个单词的字符串），表示word_count驱动成功测试。
6.4.2 在android模拟器上通过原生（native）c程序测试linux驱动
虽说我们开发的是linux驱动，但本书主要介绍的是android版的linux内核，因此，linux驱动只在ubuntu linux上测试成功还不能保证在android设备上一定能正常工作，所以必须在android设备上进行测试。android设备有很多种类，如安装了android的开发板、运行android系统的手机或平板电脑等。但离我们最近的并不是这些硬件设备，而是android模拟器。android模拟器可以模拟绝大多数真实的环境，所以可以利用android模拟器测试linux内核。
在android模拟器上测试linux驱动首先应该想到的，也是最先应该做的就是将word_count.ko驱动模块安装在模拟器上。可能读者使用过adb shell命令。如果进入android模拟器的命令提示符为“#”，说明通过命令行方式进入android模拟器直接就是root权限（命令提示符为“$”，表示非root权限），因此从理论上可以使用insmod命令将word_count.ko驱动模块直接安装在android模拟器中。现在我们来测试一下，看看是否可以将word_count.ko安装在android模拟器上。现在执行build.sh脚本，并选择“android模拟器”，脚本会自动将word_count.ko文件上传到android模拟器的/data/local目录，并进行安装。如果读者选择的是s3c6410开发板，在安装word_count.ko时就会输出如下的错误信息，表示编译linux驱动的linux内核版本与当前android模拟器的版本不相同，无法安装。所以在编译linux驱动时，必须选择与当前运行的linux内核版本相同的linux内核进行编译，否则就无法安装linux驱动。
注意
建议上传文件到android模拟器或开发板时，将文件放到/data/local目录，系统很多其他的目录，如/system/bin，都是只读的，除非将word_count.ko文件打包进system.img，否则无法向这些目录写数据，即使有root权限也不行。
用于android模拟器的goldfish内核默认不允许动态装载linux驱动模块，因此需要在编译linux内核之前执行如下命令配置linux内核。
执行上面的命令后，会出现如图6-15所示的设置界面。按空格键将第二项“enable loadable module support”选中（前面是[*]），然后按回车键进入子菜单，选中前3项，如图6-16所示，否则linux驱动模块仍然无法安装和卸载。当退出设置菜单时保持设置。最后按节的方法重新编译linux内核，成功编译内核后，android模拟器可以使用新生成的zimage内核文件动态装载linux驱动模块。
现在执行build.sh脚本文件完成对word_count驱动的编译、上传和安装的工作，然后进入android模拟器的终端，使用echo和dmesg命令可以测试word_count驱动和查看测试结果，方法与上一节相同。
编译可在android模拟器上运行的linux驱动模块要使用goldfish内核，使用其他的内核编译word_count.c，安装时会出现如下错误。
insmod: error inserting 'word_count.ko': -1 invalid module format
在android模拟器上不仅可以使用linux命令测试驱动，也可以像ubuntu linux一样使用本地c/c++程序进行测试。可能有的读者要问，android不是只能运行由java编写的apk程序吗？顶多是在apk程序中嵌入ndk代码。还能直接运行普通的linux程序吗？答案是肯定的。不过要满足如下两个条件。
android模拟器、开发板或手机需要有root权限。
可执行文件需要使用交叉编译器进行编译，以便支持arm处理器。
现在使用交叉编译器来编译在上一节编写的test_word_count.c文件。为了使编译步骤尽可能简单，我们使用android.mk设置编译参数，并使用make命令进行编译。首先在/root/drivers/ch06/word_count目录中建立一个android.mk文件，并输入如下的内容。
android.mk文件中有如下两个地方需要说明一下。
表示当前工程（android.mk文件所在的目录）在什么模式下编译。如果设为optional，表示不考虑模式，也就是说，在任何模式下都会编译。该变量可以设置的值有user、userdebug、eng、optional。其中eng是默认值。
user：限制用户对android系统的访问，适合于发布产品。
userdebug：类似于user模式，但拥有root访问权限，并且可以从日志中获取大量的调试信息。
eng：一般在开发的过程中设置该模式。除了拥有userdebug的全部功能外，还会带有大量的调试工具。
local_module_tags的值与target_build_variant变量有关。target_build_variant变量用于设置当前的编译模式，可设置的值包括user、userdebug和eng。如果想改变编译模式，可以在编译android源代码之前执行如下命令。
其中full表示建立的目标，除了full目标（为所有的平台建立）外，还有专门为x86建立的full-x86。详细的建立目标执行lunch命令后就会列出。在图4-8已经显示了android4支持的建立目标的编译模式。读者可以到第4章查看该图。
build_executable表示建立可执行的文件。可执行文件路径是< android源代码目录 >/ out/target/product/generic/system/bin/test_word_count。如果想编译成动态库（.so）文件，可以使用include $(build_shared_library)。动态库的路径是< android源代码目录 >/ out/target/product/ generic/system/lib/test_word_count.so。如果想编译成静态库（.a）文件，可以使用include $(build_static_library)。静态库的路径是< android源代码目录 >/ out/target/product/generic/ obj/static_libraries/test_word_count_intermediates/test_word_count.
为了将test_word_count.c文件编译成可在android模拟器上运行的可执行程序，可以将word_count目录复制到< android源代码目录 >的某个子目录，也可以在< android源代码目录 >目录中为word_count目录建立一个符号链接。为了方便，我们采用如下命令为word_count目录在< android源代码目录 >/development目录建立一个符号链接（假设android源代码的目录是/sources/android/android4/development/word_count）。
成功编译后可以在< android源代码目录 >/out/target/product/generic/system/bin目录中找到test_word_count文件。在随书光盘和模拟环境中已经带了编译好的test_word_count程序（包括emulator版本和ubuntu linux版本），可执行程序一般不需要考虑linux内核的版本，用交叉编译器编译的支持arm处理器的程序既可以在android模拟器上运行，也可以在s3c6410开发板或其他有root权限的手机中运行。
现在执行下面的命令将test_word_count文件上传到android模拟器。
执行上面的命令后，如果输出的单词个数是5，表示程序测试成功。
6.4.3 使用android ndk测试linux驱动
在android系统中linux驱动主要的使用者是apk程序。因此，linux驱动做完后必须要用apk程序进行测试才能说明linux驱动可以正常使用。由于上一节在android虚拟机上使用c语言编写的可执行程序测试了linux驱动，因此很容易想到可以利用android ndk来测试linux驱动，
由于android ndk也使用c/c++来编写程序，因此可以利用上一节的c语言代码，当然，还得加上一些android ndk特有的代码。在使用android ndk测试linux驱动之前需要做如下两件事。
由于linux驱动模块不会随android系统启动而装载，因此必须执行build.sh脚本文件安装word_count驱动。
不能使用默认方式启动android模拟器，而要使用我们自己编译的linux内核启动android模拟器，启动模拟器的命令如下：
为了方便，读者也可以在随书光盘的ubuntu linux虚拟环境中直接执行如下的命令来启动android模拟器。其中emulator.sh文件在/root/drivers目录中。
word_count_ndk工程的代码部分由wordcountndktestmain.java和ndk_test_word_count.c文件组成。工程结构如图6-17所示。
ndk_test_word_count.c文件用于访问word_count驱动。该文件包含两个供java访问的函数，分别用来读取/dev/wordcount设备文件中的单词数和向/dev/wordcount设备文件写入字符串。下面先看看ndk_test_word_count.c文件的完整代码。
编写上面的代码有一个重点就是jstring_to_pchar函数。该函数可以将jstring类型的数据转换成char类型的数据。转换的基本思想就是调用java方法string.getbytes，获取字符串对应的字节数组（jbytearray）。由于write函数需要的是char 类型的数据，因此，还必须将jbytearray类型的数据转换成char 类型的数据。采用的方法是，先将jbytearray类型的数据转换成jbyte类型的数据，然后调用memcpy函数将jbyte类型的数据复制到使用malloc函数分配的char 指针空间中。在jstring_to_pchar函数中有如下的一行代码。
看到getmethodid方法最后一个参数的值是"(ljava/lang/string;)[b"，可能android ndk初学者会对此感到困惑，以为是写错了。实际上这是jni（android ndk程序实际上就是遵循jni规则的程序）对方法参数和返回类型的描述。在jni程序中为了方便描述java数据类型，将简单类型使用了一个大写英文字母表示，如表6-1所示。
在jni中调用java方法需要指定方法参数和返回值的数据类型。在jni中的格式如下：
"(参数类型)返回值类型"
getbytes方法的参数类型是string，根据表6-2的描述，string类型中jni的描述符是" ljava/lang/string; "。getbytes方法的返回值类型是byte[]。这里就涉及一个数组的表示法。在jni中数组使用左中括号（[）表示，后面是数组中元素的类型。每一维需要使用一个“[”。byte[]是一维字节数组，所以使用"[b"表示。如果是byte[][][]，应使用"[[[b"表示。如果java方法未返回任何值（返回值类型是void），则用v表示。如void mymethod(int value)的参数和返回值类型可表示为"(i)v"。
android ndk程序还需要一个android.mk文件，代码如下：
为了方便读者在eclipse中开发android应用程序，本节的例子采用了节的方法进行配置。详细的配置信息请读者查看随书光盘或虚拟环境中的例子。虚拟环境中的所有配置和目录位置与笔者写作本书时使用的ubuntu linux的环境完全相同，读者可直接运行程序。但在随书光盘中的例子需要将相关的路径修改成读者自己机器上的路径。当然，如果恰巧读者机器的环境与笔者完全相同，就不需要做任何修改了。
在编写java代码调用jni函数之前，先看一下本例的界面，如图6-18所示。
读者需要先在pc上运行build.sh脚本文件安装word_count驱动。然后单击“从/dev/wordcount读取单词数”按钮，会在按钮下方输出当前/dev/wordcount设备文件中统计出的单词数。读者也可以在输入框中输入一个由空格分隔的字符串，然后单击“向/dev/wordcount写入字符串”按钮，再单击“从/dev/wordcount读取单词数”按钮，就会统计出字符串中包含的单词数，效果如图6-19所示。
下面看一下本例中java部分（wordcountndktestmain.java）的完整代码。
wordcountndktestmain.java中的代码只是简单地调用了jni函数来操作/dev/wordcount文件。其他的代码都是常规的android应用级别的代码。如果读者对这部分不熟悉，可以参阅笔者所著的《android开发权威指南》。
6.4.4 使用java代码直接操作设备文件来测试linux驱动
如果android拥有root权限，完全可以直接使用java代码操作/dev/wordcount设备文件（没有root权限，linux驱动模块是无法安装的）。本节将介绍如何使用java代码来测试linux驱动（测试程序不使用一行c/c++代码）。本节示例的路径如下。
word_count_java工程中只有一个源代码文件wordcountjavatestmain.java。该文件的内容如下：
本例的运行效果和使用方法与上一节的例子类似。读者可以运行随书光盘或虚拟环境中的例子与上一节的例子进行比较。
6.4.5 使用s6410开发板测试linux驱动
前面几节使用了不同方法来测试word_count驱动，但归根结底都是在pc上进行测试。那么本节将换一种平台来测试word_count驱动。当然，如果读者有android手机的相应linux内核源代码，也可以使用本节的方法在手机上测试word_count驱动。
6.4.2节、6.4.3节和6.4.4节中的例子都可以在s3c6410开发板上运行（有的需要重新编译，有的可以直接运行）。下面就挨个介绍如何使其在s3c6410开发板上运行。
首先应打开s3c6410开发板的电源开关，然后使用usb数据线连接s3c6410开发板和pc。最后执行build.sh脚本文件将word_count驱动安装在s3c6410开发板上。
1．在s6410开发板上使用可执行程序测试linux驱动
由于在s3c6410开发板运行的是android 2.3.4，因此，需要在android 2.3.4下使用6.4.2节的方法重新编译test_word_count.c文件。然后将编译好的test_word_count程序上传到开发板。测试的方法与android模拟器相同。
本书的主题之一就是介绍如何将android移植到不同的硬件上。那么使用test_word_count在不同硬件平台上运行实际上也是一种移植，只不过这种移植并不是移植操作系统，而是移植应用程序，所有可称为应用程序移植。最简单的应用程序移植就是将应用程序源代码编译成可在不同目标平台运行的二进制文件。当然，如果恰巧这些平台中都包含应用程序所使用的api，那么直接在不同平台编译即可（有时需要使用交叉编译器）。但不幸的是，在很多时候，并不是所有的api在各个平台都有。有的api可能名字变化了，但有的api在某些平台根本就没实现。面对这样的情况，一般需要先移植这些api，然后再移植应用程序。应用程序移植在android系统中也会经常发生，如果某些特殊的android系统（基于arm芯片）需要一些用c语言实现的library或可执行程序，但android平台并没有这些功能，而其他平台（如ubuntu linux）有这样的程序，完全可以修改并重新编译成arm平台的目标文件放到android系统中。
2．在s6410开发板上使用android ndk测试linux驱动
在eclipse中重新编译节编写的android ndk程序就可以在s3c6410开发板上运行，测试方法与6.4.3节使用的方法相同，测试效果如图6-20所示。
▲图6-20 在s3c6410开发板上使用android ndk测试word_count驱动
3．在s6410开发板上使用java代码测试linux驱动
在6.4.4节编写的测试word_count驱动的android程序可以使用同样的方法在s3c6410开发板上运行。测试效果与图6-20类似。
6.4.6 将驱动编译进linux内核进行测试
前面几节都是将linux驱动编译成模块，然后动态装载进行测试。动态装载驱动模块不会随着android系统的启动而自动装载，因此android系统每次启动都必须使用insmod或modprobe命令装载linux驱动模块。
对于嵌入式系统（包括嵌入式android、嵌入式linux等）一般都采用将linux驱动编译进内核的方式。这样做虽然没有动态装载灵活，但linux驱动会随着android的启动而自动装载。一般在开发过程中为了测试和调试方便，会将linux驱动以模块形式装载到linux内核中。当linux驱动通过最终测试后，会将linux驱动编译进linux内核再进行测试。
本节将介绍如何将word_count驱动编译进linux内核，并分别在android模拟器和s3c6410开发板上测试word_count驱动。
linux内核源代码被设计成可装卸式结构。也就是说只需要修改配置文件，就可以使某个linux驱动编译成模块（.ko文件），或编译进linux内核，当然，也可以将该linux驱动从linux内核去除。核心的配置文件如下。
.config：该文件位于linux内核源代码的顶层目录，为隐藏文件。该文件用于配置linux内核中的模块。在.config文件中可以对linux驱动进行三方面的配置：编译成驱动模块（.ko文件）、编译进内核和从linux内核去除。可以手工修改.config文件，也可以使用make menuconfig命令用菜单方式来设置.config文件。
kconfig：每一个想要连接进linux内核的模块目录都有该文件。该文件主要用于定义make menuconfig命令显示的菜单（包括菜单项名称、帮助信息、选项类型、模块依赖等信息），除此之外，kconfig文件还可以导入位于其他目录的kconfig文件。make命令通过kconfig文件的递归引用，可以找到linux内核中的所有kconfig文件，从而建立一个完整的配置菜单。
makefile：一般与kconfig文件同时出现。每有一个kconfig文件，就必要有一个makefile文件。该文件用于指定如何编译makefile文件所在目录的源代码。
现在还使用word_count驱动的例子来详细说明如何将一个linux驱动加入linux内核源代码树中。由于word_count驱动属于字符驱动，所以可以使用如下的步骤将word_count驱动加入linux内核源代码树。
第1步：将word_count.c文件放入linux内核源代码
其中，config后面的字符串将作为shell变量名的后半部分，前半部分是config_。也就是说，每一个具体的模块都会对应一个shell变量来保存该模块的3个编译行为（生成.ko文件、编译进linux内核或从linux内核中去除）。word_count驱动模块的变量是config_word_count。该变量的值会保存在.config文件中。
bool表示word_count驱动只能进行两项设置（被编译进内核与从linux内核中去除），后面会介绍如何设置菜单项的三项设置。bool后面的字符串就是菜单项的文本。help用于设置菜单项的帮助信息。
第3步：修改makefile文件
打开/root/kernel/goldfish/drivers/char/makefile文件。该文件大多都是如图6-21所示的内容，随便找个位置插入如下内容。
通过第2步的设置产生了一个config_word_count变量，而在第3步中obj-后使用了该变量，而不是使用固定的值（y或m）。make命令在编译linux内核时会将该变量替换成相应的值。
第4步：设置.config文件
.config文件可以通过手工配置，也可以通过make menuconfig命令在菜单中配置。在这里我们采用菜单配置的方法。现在进入linux内核顶层目录（/root/kernel/goldfish）。然后执行make menuconfig命令显示配置菜单，并进入“device drivers”>“character devices”子菜单，找到“word_count_driver”菜单项，按空格键将“word_count_driver”菜单项前设置成星号（*），如图6-22所示。然后退出配置界面并保存所做的修改。
按“h”键可以显示word_count驱动的帮助信息，如图6-23所示。
在配置完.config文件后，读者可以打开.config文件，并找到config_word_count，会发现该变量的值已被设成“y”。
第5步：编译linux内核
如果读者以前编译过当前的linux内核，并不需要担心编译的时间过长，因为make足够智能，它只会编译最新修改的模块及其依赖的模块。
当成功编译linux内核后，读者可以到/root/kernel/goldfish/arch/arm/boot目录找到zimage文件，并使用android模拟器运行这个内核。读者会发现，在/dev目录中有一个wordcount设备文件，而我们并没有运行build.sh脚本文件安装word_count驱动。这是因为android模拟器在装载zimage内核文件时已自动装载了word_count驱动。不过在使用前面的例子测试word_count驱动时仍然需要执行下面的命令设置/dev/wordcount设备文件的访问权限。
如果读者不想将word_count.c复制到/root/kernel/goldfish/drivers/char目录，可以使用下面的命令在/root/kernel/goldfish/drivers/char目录建立一个符号链接。
将word_count目录加入linux内核源代码树的步骤如下（在进行下面的步骤之前需要将上面步骤所做的设置注释掉）。
第1步：建立新的kconfig文件
其中tristate表示三态类型（编译进内核、编译成模块，从linux内核移除）。如果使用tristate代替bool，菜单项前面就变成尖括号。按“y”键，尖括号中显示星号（*），表示编译进内核。按“m”键，尖括号中显示m，表示编译成模块。按“n”键，尖括号在符号消失，表示word_count驱动被忽略。如果不断按“空格”键，这3种状态会循环切换。
default用来设置默认值。如果使用tristate，default可以设置y、m和n三个值，分别对应编译进内核、编译成模块和从linux内核中移除。当模块第一次设置时会处于default设置的默认状态。
如果使用tristate，必须按照节的方法打开“enable loadable module support”选项，否则无法将驱动设为编译成模块状态（m状态），菜单项前面仍然是一对中括号。
第2步：修改makefile文件
修改makefile文件后，如果还想使用前面几节的脚本文件测试word_count驱动，需要将.config文件中config_word_count变量值设为m，如果.config文件中没有该变量，就添加一个config_word_count变量。当然，也可以使用make menuconfig命令设置。
为了可以单独编译word_count驱动，也可以和linux内核一同编译，我们可以采用如下形式重新编写makefile文件。当config_word_count变量未定义时，说明没有与linux内核一同编译。
接下来的工作就和前面介绍的五步中的第4步和第5步一样了。在进入如图6-24所示的设置界面时，可以按“m”键将word_count驱动模块编译成.ko文件。
当修改linux内核设置后重新编译内核，以前使用该linux内核编译的linux驱动模块可能由于格式错误无法安装，因此，在重新编译linux内核后，需要重新编译linux驱动模块。
如果想将word_count驱动模块编译进其他内核也可采用与上面类似的做法。