makelinux/ldt

Linux Driver Template

LDT - Linux Driver Template

LDT project is useful for Linux driver development beginners and as starting point for a new drivers. The driver uses following Linux facilities: module, platform driver, file operations (read/write, mmap, ioctl, blocking and nonblocking mode, polling), kfifo, completion, interrupt, tasklet, work, kthread, timer, simple misc device, multiple char devices, Device Model, configfs, UART 0x3f8, HW loopback, SW loopback, ftracer.

Usage:

Just run

git clone --recurse-submodules git://github.com/makelinux/ldt.git && cd ldt && make && ./ldt-test && sudo ./misc_loop_drv_test

and explore sources.

Files:

Main source file of LDT: ldt.c

Test script, run it: ldt-test

Generic testing utility for Device I/O: dio.c

Simple misc driver with read, write, fifo, tasklet and IRQ: misc_loop_drv.c

Browse the rest of source: https://github.com/makelinux/ldt/

ldt's Issues

failed to complile due to apic undeclared

1. CentOS 7.9

[root@centos ldt]# make
make -C /lib/modules/3.10.0-1160.el7.x86_64/build M=$PWD modules
make[1]: Entering directory `/usr/src/kernels/3.10.0-1160.el7.x86_64'
  CC [M]  /root/ldt/misc_loop_drv.o
/root/ldt/misc_loop_drv.c: In function ‘misc_loop_drv_tasklet_func’:
/root/ldt/misc_loop_drv.c:124:3: error: implicit declaration of function ‘ISA_IRQ_VECTOR’ [-Werror=implicit-function-declaration]
   apic->send_IPI_all(ISA_IRQ_VECTOR(irq));
   ^
cc1: some warnings being treated as errors
make[2]: *** [/root/ldt/misc_loop_drv.o] Error 1
make[1]: *** [_module_/root/ldt] Error 2
make[1]: Leaving directory `/usr/src/kernels/3.10.0-1160.el7.x86_64'
make: *** [modules] Error 2
[root@centos ldt]#

2. Fedora 35

[huzhifeng@fedora35 ldt]$ make
make -C /lib/modules/5.15.7-200.fc35.x86_64/build M=$PWD modules
make[1]: Entering directory '/usr/src/kernels/5.15.7-200.fc35.x86_64'
  CC [M]  /home/huzhifeng/Downloads/ldt/misc_loop_drv.o
/home/huzhifeng/Downloads/ldt/misc_loop_drv.c: In function ‘misc_loop_drv_tasklet_func’:
/home/huzhifeng/Downloads/ldt/misc_loop_drv.c:124:17: error: ‘apic’ undeclared (first use in this function)
  124 |                 apic->send_IPI_all(ISA_IRQ_VECTOR(irq));
      |                 ^~~~
/home/huzhifeng/Downloads/ldt/misc_loop_drv.c:124:17: note: each undeclared identifier is reported only once for each function it appears in
make[2]: *** [scripts/Makefile.build:277: /home/huzhifeng/Downloads/ldt/misc_loop_drv.o] Error 1
make[1]: *** [Makefile:1872: /home/huzhifeng/Downloads/ldt] Error 2
make[1]: Leaving directory '/usr/src/kernels/5.15.7-200.fc35.x86_64'
make: *** [Makefile:26: modules] Error 2
[huzhifeng@fedora35 ldt]$

Are there any related documents / books for this template?

Do we have anything other than the "https://github.com/makelinux/ldt/blob/master/README.md"?