Difference between revisions of "Embedded-Linux-Device-Driver/C3/Registering-a-Character-Device-Number/English"

From Script | Spoken-Tutorial
Jump to: navigation, search
(Created page with " {| style="border-spacing:0;" | style="border:1pt solid #000000;padding-top:0cm;padding-bottom:0cm;padding-left:0.206cm;padding-right:0.191cm;"| '''Visual cue :''' | style="bo...")
 
Line 57: Line 57:
 
| style="border:1pt solid #000000;padding-top:0cm;padding-bottom:0cm;padding-left:0.206cm;padding-right:0.191cm;"| Open the''' '''terminal by pressing''' Alt+Ctrl+T''' keys simultaneously.
 
| style="border:1pt solid #000000;padding-top:0cm;padding-bottom:0cm;padding-left:0.206cm;padding-right:0.191cm;"| Open the''' '''terminal by pressing''' Alt+Ctrl+T''' keys simultaneously.
  
−
Press the '''Enter''' key after every command.
+
Press '''Enter''' key after every command.
  
 
|-
 
|-
Line 165: Line 165:
  
 
Highlight '''name'''
 
Highlight '''name'''
−
| style="border:1pt solid #000000;padding-top:0cm;padding-bottom:0cm;padding-left:0.206cm;padding-right:0.191cm;"| Let us see the parameters of this '''function'''.
+
| style="border:1pt solid #000000;padding-top:0cm;padding-bottom:0cm;padding-left:0.206cm;padding-right:0.191cm;"| Let us see the parameters of this function.
 
'''dev '''is the variable that holds the '''device '''number.
 
'''dev '''is the variable that holds the '''device '''number.
  
Line 180: Line 180:
 
| style="border:1pt solid #000000;padding-top:0cm;padding-bottom:0cm;padding-left:0.206cm;padding-right:0.191cm;"| In this program, we allocate a '''minor''' number starting from '''0'''.  
 
| style="border:1pt solid #000000;padding-top:0cm;padding-bottom:0cm;padding-left:0.206cm;padding-right:0.191cm;"| In this program, we allocate a '''minor''' number starting from '''0'''.  
  
−
This '''function''' will register one device with the name '''my_device.'''
+
This function will register one device with the name '''my_device.'''
  
 
|-
 
|-
 
| style="border:1pt solid #000000;padding-top:0cm;padding-bottom:0cm;padding-left:0.206cm;padding-right:0.191cm;"| Highlight''' printk messages'''
 
| style="border:1pt solid #000000;padding-top:0cm;padding-bottom:0cm;padding-left:0.206cm;padding-right:0.191cm;"| Highlight''' printk messages'''
  
−
| style="border:1pt solid #000000;padding-top:0cm;padding-bottom:0cm;padding-left:0.206cm;padding-right:0.191cm;"| '''printk function '''will be executed to indicate the success or failure of the''' function.'''
+
| style="border:1pt solid #000000;padding-top:0cm;padding-bottom:0cm;padding-left:0.206cm;padding-right:0.191cm;"| '''printk function '''will be executed to indicate the success or failure of the function.
  
 
|-
 
|-
Line 400: Line 400:
 
| style="border:1pt solid #000000;padding-top:0cm;padding-bottom:0cm;padding-left:0.206cm;padding-right:0.191cm;"| This tutorial has been contributed by FOSSEE and Spoken Tutorial Project, IIT Bombay.
 
| style="border:1pt solid #000000;padding-top:0cm;padding-bottom:0cm;padding-left:0.206cm;padding-right:0.191cm;"| This tutorial has been contributed by FOSSEE and Spoken Tutorial Project, IIT Bombay.
  
−
This is Mayuri Panchakshari from IIT Bombay signing off.
+
This is Usha from IIT Bombay signing off.
  
 
Thanks for watching.
 
Thanks for watching.
  
 
|}
 
|}

Revision as of 15:18, 22 October 2020

Visual cue : Narration :
Slide 1:

Welcome slide:

Welcome to the spoken tutorial on Registering a Character Device Number.
Slide 2:

Learning objectives:

In this tutorial, we will learn how to
  • Dynamically allocate the major and minor numbers to a device.
  • Register a new character device inside the kernel.
Slide 3:

System Requirements:

To record this tutorial, I am using,
  • VirtualBox version 5.2.
  • Ubuntu Linux 18.04 LTS operating system.
  • Linux kernel version 5.0.0-31 generic and
  • gedit text editor
Slide 4:

Prerequisites:

To follow this tutorial, you should be familiar with:
  • C programming language and
  • Basics of Linux kernel

If not, then go through the C/C++ and Linux spoken tutorials on this website.

Slide 5:

Device file in Linux.

* Each device is represented as a file in Linux.
  • The device files are located under the dev directory.
  • Each device file in Linux has a unique number associated with it.
Let us see some of the device files that are already present in the Linux system.
Open the terminal Open the terminal by pressing Alt+Ctrl+T keys simultaneously.

Press Enter key after every command.

Type >> ls -l /dev/tty* | head -5

Show the output

Let us see about the specific device files such as serial character device files.

Type the command as shown here.

Highlight numbers 4, 1

Highlight 4

Here, 4 and 1 indicate the major and minor numbers of tty1 device.

The major number indicates the driver associated with the device.

It indicates that the tty0 and tty1 serial ports are managed by the driver 4.

Highlight 0, 1 Inside the driver, each device is identified by the unique number.

The tty0 and tty1 have different minor numbers 0 and 1 as shown here.

The driver uses the minor number to distinguish individual physical or logical devices.

Using these minor numbers, the driver 4 is able to differentiate these devices.

Slide 6 :

Internal representation of device number

* The kernel uses the dev_t type variable to hold major and minor numbers.
  • The size of the dev_t is 32-bit.
  • 12 bits are used for major numbers and 20 bits are used for minor numbers.
Point to the folder and file in desktop

Point to the files.

Go to the DeviceDriver folder in the desktop which we have created earlier.

I have created a directory named RegisterDevice.

In this directory, I have saved simple_driver dot c and Makefile.

I will use these files for demonstration.

Slide :

Code files:

* The files used in this tutorial are available in the Code Files link on this tutorial page.
  • Please download and extract them
  • Make a copy and then use them while practising
Type >> cd Desktop/DeviceDriver/RegisterDevice Switch back to the terminal.

Go to the directory RegisterDevice as shown here.

Type >> gedit simple_driver.c Let us open the file simple_driver dot c.

Type gedit space simple_driver dot c.

Let us see the code.

Highlight header files

Highlight fs.h

We have to include these header files at the start of the program.

The purpose of each header file is mentioned here.

fs.h contains the required functions to register a character device number.

Highlight device_num device_num is a dev_t type variable.

It will hold the major and minor number of a device.

Let us see how to register a character device number dynamically.
Highlight alloc_chrdev_region() alloc_chrdev_region function will dynamically allocate the major number to the device.

The kernel will find the unused major number and assign it to a device.

This function returns a value less than zero on failure.

Highlight dev

Highlight firstminor

Highlight count

Highlight name

Let us see the parameters of this function.

dev is the variable that holds the device number.

firstminor specifies the starting minor number which is 0.

count specifies the number of supported devices.

name is a device name used to identify the device.

Highlight 0

Highlight alloc_chrdev_region()

my_device.

In this program, we allocate a minor number starting from 0.

This function will register one device with the name my_device.

Highlight printk messages printk function will be executed to indicate the success or failure of the function.
Highlight MAJOR(dev_t dev)

Highlight MINOR(dev_t dev)

Highlight macros

MAJOR macro is used to extract the major number from the dev_t variable.

Similarly, MINOR macro is used to extract the minor number from the dev_t variable.

It will print the major and minor numbers of my_device using these macros.

Highlight Unregister_chrdev_region() unregister_chrdev_region() function is used to remove a device number from kernel.

You should free the device numbers when they are no longer in use.

Highlight dev_t

Highlight count

dev_t specifies the beginning of device number range to be freed.

count represents the number of devices to unregister.

Highlight unregister_chrdev_region()

Highlight printk()

This function will unregister my_device from the kernel.

When the driver is unloaded, these messages will be printed in the kernel log level.

Save the file and close the window.

Show the terminal Switch back to the terminal
Type << gedit Makefile

Type >> clear

To compile the driver, we need to create a Makefile.

Type gedit space Makefile.

Type the code as shown or you can make use of the downloaded Makefile.

Save and close the file.

Open the terminal

Type >> sudo su

Let us compile the driver.

Type sudo space su to be a superuser and type the system password.

Type >> make all

Type >> clear

Type make space all

Clear the screen.

Type >> insmod space simple_driver.ko

Type >> clear

Let us load the simple_driver dot ko into the kernel.

Type insmod space simple_driver dot ko.

Clear the screen.

Let us see the loaded printk messages of the driver.
Type >> dmesg | grep simple_driver

Highlight major and minor number

Type dmesg space pipe space grep simple_driver.

We can see the major and minor number of my_device

It indicates that the my_device is registered inside the kernel successfully.

Type >> clear Clear the screen
Type >> cat /proc/devices | grep my_device

Highlight devices

Let us check whether our device appears in the proc file system or not.

Type the command as shown here.

This file displays the various devices currently configured in the kernel.

Highlight my_device with number Here, you can see the my_device with its major number.

It indicates that my_device is registered inside the kernel successfully.

Type >> clear Clear the screen.
Type >> rmmod simple_driver.ko Let us unload a module from the kernel.

Type rmmod space simple_driver dot ko

Type >> dmesg | grep simple_driver

Highlight printk

Type >> clear

Let us see the unloaded printk messages of the driver.

Type the command as shown here.

It indicates that the my_device is unregistered from the kernel successfully.

Clear the screen.

Type >> make clean

Type >> clear

Type make space clean.

It removes all objects files created after the compilation.

Clear the screen.

Type >> exit To be a regular user, type exit.
With this, we come to the end of this tutorial. Let us summarize.
Slide :

Summary

In this tutorial, we learned how to
  • Dynamically allocate the major and minor numbers to a device.
  • Register a new character device inside the kernel.
Slide :

Assignment :

As an assignment
  1. Open the simple_driver.c file.
  2. Allocate the device number using the kernel function.
  3. Change the name of the device.
  4. Compile and load the driver into the kernel.
  5. See the registered device in the procfs
  6. Unload the driver from the kernel.
Slide :

About Spoken Tutorial Project:

* The video at the following link summarizes the Spoken Tutorial project.
  • Please download and watch it.
Slide :

Spoken Tutorial workshops:

The Spoken Tutorial Project Team:
  • conducts workshops and gives certificates.
  • For more details, please write to us.
Slide :

Forum questions :

* Please post your timed queries in this forum
Slide :

Forum for specific questions :

* Do you have any general or technical questions on Embedded Linux Device Driver?
  • Please visit the FOSSEE forum and post your question.
Slide :

Acknowledgment:

The Spoken Tutorial project is funded by MHRD, Government of India.
Slide :

Thank you slide:

This tutorial has been contributed by FOSSEE and Spoken Tutorial Project, IIT Bombay.

This is Usha from IIT Bombay signing off.

Thanks for watching.

Contributors and Content Editors

Nancyvarkey, Nirmala Venkat

Retrieved from "https://script.spoken-tutorial.org/index.php?title=Embedded-Linux-Device-Driver/C3/Registering-a-Character-Device-Number/English&oldid=54109"