跳至主要内容

【转】第一个简单的内核编程实验：hello.c

文章说明：calmarrow（lqm）原创

文章引自：http://piaoxiang.cublog.cn

 
《Linux设备驱动程序》
 
    内核编程入门，就以最为简单的hello.c为例。
    环境：Redhat 9.0，内核版本2.4.20-8。
 
    虽然现在2.6.x的内核很早就就发布了，但是毕竟很多公司还在使用2.4.x的内核。作为新手，从2.4.x的内核入手是可行的。原因有如下几条：
    （1）2.4.x比较成熟。可能你遇到的绝大多数问题，网上都有解决方案。在这个过程中，你可以节省大量的时间，同时还可以对比网上的解决方案，加深认识，总结解决问题的方法，调整自己的学习方法和思路。
    （2）事物的发展总不可能是一蹴而就的。了解发展的历程，对深入理解问题有很大的好处。所以在2.4.x的内核的基础上学习2.6.x的内核，就能够体会到2.6.x的内核在哪些方面要出色，或者为什么要采取这种改进技术。相信理论清晰了，即时2.6.x的内核也会容易上手。
 
    下面总结了第一个内核程序hello.c的学习过程。
 
（一）第一阶段：尽量简单
 

/*
 * hello.c
 */

#define MODULE
#include <linux/module.h>

int init_module(void)
{
        printk("Hello World!\n");
        return 0;
}

void cleanup_module(void)
{
        printk("Goodbye!\n");
}

执行，出现错误一：

[root@lqm drivers]# gcc -c hello.c
[root@lqm drivers]# insmod hello.o
hello.o: kernel-module version mismatch
        hello.o was compiled for kernel version 2.4.20
        while this kernel is version 2.4.20-8.

    这是因为内核源代码版本和编译器版本不一致造成的。

(1)编译器版本/usr/include/linux/version.h

#define UTS_RELEASE "2.4.20"
#define LINUX_VERSION_CODE 132116
#define KERNEL_VERSION(a,b,c) (((a) << 16) + ((b) << 8) + (c))

(2)内核源代码版本/usr/src/linux-2.4.20-8/include/linux/version.h

/usr/src/linux-2.4.20-8/include/linux
[root@lqm linux]# cat version.h
#include <linux/rhconfig.h>
#if defined(__module__smp)
#define UTS_RELEASE "2.4.20-8smp"
#elif defined(__module__BOOT)
#define UTS_RELEASE "2.4.20-8BOOT"
#elif defined(__module__bigmem)
#define UTS_RELEASE "2.4.20-8bigmem"
#else
#define UTS_RELEASE "2.4.20-8"
#endif
#define LINUX_VERSION_CODE 132116
#define KERNEL_VERSION(a,b,c) (((a) << 16) + ((b) << 8) + (c))

   可以采取修改编译器版本号与内核源代码版本号一致的办法来解决这个问题，即修改/usr/include/linux/version.h中

#define UTS_RELEASE "2.4.20"

为

#define UTS_RELEASE "2.4.20-8"

执行，出现错误二：

[root@lqm drivers]# gcc -c hello.c
[root@lqm drivers]# insmod hello.o
Warning: loading hello.o will taint the kernel: no license
  See http://www.tux.org/lkml/#export-tainted for information about tainted modules
Module hello loaded, with warnings
[root@lqm drivers]# tail -n 1 /var/log/messages
Jan 30 12:02:08 lqm kernel: Hello

     也就是说出现了no license的警告。GNU的软件需要有GPL，所以修改源代码如下：

/*
 * hello.c
 */

#define MODULE
#include <linux/module.h>

MODULE_LICENSE("GPL");

int init_module(void)
{
        printk("Hello World!\n");
        return 0;
}

void cleanup_module(void)
{
        printk("Goodbye!\n");
}

    这时没有错误了。写了一个脚本，测试流程自动化：

#!/bin/bash

gcc -c hello.c
sleep 1

insmod hello.o && echo -e "Instal module - hello.o\n"
sleep 1
tail -n 1 /var/log/messages
lsmod | grep "hello" && echo -e "Module hello has instaled\n"

rmmod hello && echo -e "Remove module - hello\n"
sleep 1
tail -n 1 /var/log/messages
lsmod | grep "hello" || echo "Module hello has removed"

执行结果如下：

[root@lqm hello]# ./run

Instal module - hello.o

Jan 30 13:31:29 lqm kernel: Hello World!

hello 748 0 (unused)

Module hello has instaled

Remove module - hello

Jan 30 13:31:30 lqm kernel: Goodbye!

Module hello has removed

（二）第二阶段：完善，深入一点

/*
 * hello.c
 */

#ifndef __KERNEL__
        #define __KERNEL__
#endif
#ifndef MODULE
        #define MODULE
#endif

#include <linux/kernel.h> /*printk*/
#include <linux/module.h>

MODULE_LICENSE("GPL");

static int init_module(void)
{
        printk("Hello, world!\n");

        return 0;
}

static void cleanup_module(void)
{
        printk("Goodbye!\n");
}

写Makefile文件如下：

# Kernel Programming
# Shandong University, Linqingmin

# The path of kernel source code
INCLUDEDIR = /usr/src/linux-2.4.20-8/include/

# Compiler
CC = gcc

# Options
CFLAGS = -D__KERNEL__ -DMODULE -O -Wall -I$(INCLUDEDIR)

# Target
OBJS = hello.o

all: $(OBJS)

$(OBJS): hello.c /usr/include/linux/version.h
        $(CC) $(CFLAGS) -c $<

install:
        insmod $(OBJS)

uninstall:
        rmmod hello

.PHONY: clean
clean:
        rm -f *.o

    写Makefile时应该注意，不要用空格来代替<TAB>。否则会出现错误：missing separator. Stop.

修改执行脚本run：

#!/bin/bash

# The first step
make && make install && echo -e "Instal module - hello.o\n"
sleep 1
tail -n 1 /var/log/messages
lsmod | grep "hello" && echo -e "Module hello has instaled\n"

# The second step
make uninstall && echo -e "Remove module - hello\n"
sleep 1
tail -n 1 /var/log/messages
lsmod | grep "hello" || echo "Module hello has removed"

# The last step
make clean

执行结果如下：

[root@lqm hello]# ./run
gcc -D__KERNEL__ -DMODULE -O -Wall -I/usr/src/linux-2.4.20-8/include/ -c hello.c
hello.c:18: warning: `init_module' defined but not used
hello.c:25: warning: `cleanup_module' defined but not used
insmod hello.o
Instal module - hello.o

Jan 31 13:40:23 lqm kernel: Hello,
hello 728 0 (unused)
Module hello has instaled

rmmod hello
Remove module - hello

Jan 31 13:40:24 lqm kernel:
Module hello has removed
rm -f *.o

（三）第三阶段：总结

1、一个内核模块至少应该包括两个函数：

（1）init_module：模块插入内核时调用

（2）cleanup_module:模块移除时调用

    这个简单的程序就是只实现了这两个函数，而且只做了打印信息的工作，没有使用价值。典型情况下，init_module为内核中的某些东西注册一个句柄，相当于模块初始化的工作。cleanup_module则是撤销模块前期的处理工作，使模块得以安全卸载。

2、insmod实现动态加载模块。在当前OS上，动态加载模块以测试硬件等，避免了繁琐的工作。但是，在这种情况下，会出现版本不匹配的情况。另外，要分清楚内核源代码路径和编译器路径的不同，知道在编译时该指定那个路径。第二阶段开始出现过几个错误都是因为默认的路径是编译器路径，而不是内核源代码路径。体会内核模块化带来的好处！

3、应用Make工具来管理项目。即使小，也要训练。在2.4内核和2.6内核下，Makefile的编写会有所不同。只是语法形式的不同，先深入掌握一种，另一种注意一下应该可以避免犯错误。

    继续努力！

2007/02/01补记

/*
 * Kernel Programming: hello.c
 */

/*define __KERNEL__ MODULE*/
#ifndef __KERNEL__
        #define __KERNEL__
#endif
#ifndef MODULE
        #define MODULE
#endif

#include <linux/kernel.h> /*printk*/
#include <linux/module.h>
#include <linux/init.h> /*module_init module_exit*/

MODULE_LICENSE("GPL"); /*declaration license*/

static int __init hello_init(void)
{
        printk("<1>Hello, world!\n");

        return 0;
}

static void __exit hello_exit(void)
{
        printk("<1>Goodbye!\n");
}

module_init(hello_init);
module_exit(hello_exit);

 

# Kernel Programming
# Shandong University, Linqingmin

# The path of kernel source code
KERNELDIR = /usr/src/linux-2.4.20-8

# Compiler
CC = gcc

# Options
CFLAGS = -D__KERNEL__ -DMODULE -I$(KERNELDIR)/include -O -Wall

ifdef CONFIG_SMP
        CFLAGS += -D__SMP__ -DSMP
endif

# OBJS
OBJS = hello.c

# Target
TARGET = hello.o

$(TARGET): hello.c
        $(CC) $(CFLAGS) -c $<

install:
        insmod $(TARGET)

uninstall:
        rmmod hello

.PHONY: clean
clean:
        rm -f *.o

 

#!/bin/bash

# The first step
make && make install && echo -e "Instal module - hello.o\n"
sleep 1
lsmod | grep "hello" && echo -e "Module hello has instaled\n"

# The second step
make uninstall && echo -e "Remove module - hello\n"
sleep 1
lsmod | grep "hello" || echo "Module hello has removed"

# The last step
make clean

执行结果：

gcc -D__KERNEL__ -DMODULE -I/usr/src/linux-2.4.20-8/include -O -Wall -c hello.c
insmod hello.o
Hello,World!
Instal module - hello.o

hello 776 0 (unused)
Module hello has instaled

rmmod hello
Goodbye！
Remove module - hello

Module hello has removed
rm -f *.o

说明：

    这个版本采取了显式的初始化和清除函数，显然无论是调试的便利还是编程风格，都比前几个版本要好。这种机制具体描述如下：如果你将模块初始化函数命名为my_init（而不是init_module），将清除函数命名为my_exit，则可以使用下面两行来进行标记（通常在源文件的末尾）

module_init(my_init);

module_exit(my_exit);

注意必须包含头文件<linux/init.h>。

评论

发表评论

此博客中的热门博文

【转】AMBA、AHB、APB总线简介

AMBA 简介 随着深亚微米工艺技术日益成熟，集成电路芯片的规模越来越大。数字IC从基于时序驱动的设计方法，发展到基于IP复用的设计方法，并在SOC设计中得到了广泛应用。在基于IP复用的SoC设计中，片上总线设计是最关键的问题。为此，业界出现了很多片上总线标准。其中，由ARM公司推出的AMBA片上总线受到了广大IP开发商和SoC系统集成者的青睐，已成为一种流行的工业标准片上结构。AMBA规范主要包括了AHB(Advanced High performance Bus)系统总线和APB(Advanced Peripheral Bus)外围总线。   AMBA 片上总线        AMBA 2.0 规范包括四个部分：AHB、ASB、APB和Test Methodology。AHB的相互连接采用了传统的带有主模块和从模块的共享总线，接口与互连功能分离，这对芯片上模块之间的互连具有重要意义。AMBA已不仅是一种总线，更是一种带有接口模块的互连体系。下面将简要介绍比较重要的AHB和APB总线。 基于 AMBA 的片上系统        一个典型的基于AMBA总线的系统框图如图３所示。        大多数挂在总线上的模块(包括处理器)只是单一属性的功能模块：主模块或者从模块。主模块是向从模块发出读写操作的模块，如CPU，DSP等；从模块是接受命令并做出反应的模块，如片上的RAM，AHB／APB 桥等。另外，还有一些模块同时具有两种属性，例如直接存储器存取(DMA)在被编程时是从模块，但在系统读传输数据时必须是主模块。如果总线上存在多个主模块，就需要仲裁器来决定如何控制各种主模块对总线的访问。虽然仲裁规范是AMBA总线规范中的一部分，但具体使用的算法由RTL设计工程师决定，其中两个最常用的算法是固定优先级算法和循环制算法。AHB总线上最多可以有16个主模块和任意多个从模块，如果主模块数目大于16，则需再加一层结构(具体参阅ARM公司推出的Multi-layer AHB规范)。APB 桥既是APB总线上唯一的主模块，也是AHB系统总线上的从模块。其主要功能是锁存来自AHB系统总...
发表评论
阅读全文

【转】GPIO编程模拟I2C入门

ARM编程:ARM普通GPIO口线模拟I2C  请教个问题： 因为需要很多EEPROM进行点对点控制，所以我现在要用ARM的GPIO模拟I2C，管脚方向我设 置的是向外的。我用网上的RW24C08的万能程序修改了一下，先进行两根线的模拟，SDA6， SCL6，但是读出来的数不对。我做了一个简单的实验，模拟SDA6，SCL6输出方波，在示波 器上看到正确方波，也就是说，我的输出控制是没问题的。 哪位大哥能指点一下，是否在接收时管脚方向要设为向内？（不过IOPIN不管什么方向都可 以读出当前状态值的阿） 附修改的RW24C08()程序： #define  SomeNOP() delay(300); /**/ /* *********************************  RW24C08   **************************************** */ /**/ /* ----------------------------------------------------------------------------- ---  调用方式：void I2CInit(void)   函数说明：私有函数，I2C专用 ------------------------------------------------------------------------------- -- */ void  I2CInit( void ) ... {  IO0CLR  =  SCL6;      // 初始状态关闭总线  SomeNOP();  // 延时   I2CStop();  // 确保初始化，此时数据线是高电平 }   /**/ /* ---------------------------------------------------------------------------- ----  调用方式：void I2CSta...
发表评论
阅读全文

【转】cs8900网卡的移植至基于linux2.6内核的s3c2410平台

cs8900网卡的移植至基于linux2.6内核的s3c2410平台（转） 2008-03-11 20:58 硬件环境：SBC-2410X开发板（CPU：S3C2410X） 内核版本：2.6.11.1 运行环境：Debian2.6.8 交叉编译环境：gcc-3.3.4-glibc-2.3.3 第一部分 网卡CS8900A驱动程序的移植 一、从网上将Linux内核源代码下载到本机上，并将其解压： #tar jxf linux-2.6.11.1.tar.bz2 二、打开内核顶层目录中的Makefile文件，这个文件中需要修改的内容包括以下两个方面。 （1）指定目标平台。 移植前：         ARCH?= $(SUBARCH) 移植后： ARCH            :=arm （2）指定交叉编译器。 移植前： CROSS_COMPILE ?= 移植后： CROSS_COMPILE   :=/opt/crosstool/arm-s3c2410-linux-gnu/gcc-3.3.4-glibc-2.3.3/bin/arm-s3c2410-linux-gnu- 注：这里假设编译器就放在本机的那个目录下。 三、添加驱动程序源代码，这涉及到以下几个方面。（1）、从网上下载了cs8900.c和cs8900.h两个针对2.6.7的内核的驱动程序源代码，将其放在drivers/net/arm/目录下面。 #cp cs8900.c ./drivers/net/arm/ #cp cs8900.h ./drivers/net/arm/ 并在cs8900_probe()函数中，memset (&priv,0,sizeof (cs8900_t));函数之后添加如下两条语句： __raw_writel(0x2211d110,S3C2410_BWSCON); __raw_writel(0x1f7c,S3C2410_BANKCON3); 注：其原因在"第二部分"解释。 （2）、修改drivers/net/arm/目录下的Kconfig文件，在最后添加如...
发表评论
阅读全文