Linux PCIE 驱动常用API

Linux PCIE驱动常用API

设备操作类API

介绍PCIE驱动常用API的使用方法、作用以及产生的效果，方便后期对文件系统的查阅及使用。

alloc_chrdev_region

alloc_chrdev_region是用来向内核申请主设备号使用的，让内核分配一个尚未使用的主设备号给用户，而不需要用户自己指定主设备号。函数原型及四个入参意义如下：

int alloc_chrdev_region(dev_t *dev, unsigned baseminor, unsigned count, const char *name)

dev：从内核申请下来的主设备号（主设备号用来表示一个特定的驱动程序，次设备号用来表示使用该驱动的各个设备，即主设备表示一类设备，次设备表示各个设备）
baseminor：次设备号的起始
count：申请次设备号的数量
name：执行cat /proc/devices显示的名称

pci_register_driver

在bus总线对应的数据结构bus_type中，有两份重要的结构体，struct kset drivers和struct kset devices。在写驱动程序的时候，要想驱动程序能工作，首先就要把驱动程序对应的driver程序放进struct kset driver结构体中，然后把设备的信息放入struct kset device中。函数原型：

int pci_register_driver(*pci_driver);

pci_register_driver()就是把某个设备下的driver程序放入struct kset drivers结构体中，最终会通过判断device_id和vendor_id决定是否调用驱动中的probe函数完成设备的初始化。

cdev_init

将cdev与file_operation关联起来

cdev_add

将cdev和设备号关联起来

class_create

宏class_create()用于动态创建设备的逻辑类，并完成部分字段的初始化，然后将其添加进Linux的内核系统中。此函数的执行效果就是斜体样式在 /sys/class 目录下生成一个新的文件夹，此文件夹的名字为此函数的第二个输入参数。函数原型及入参说明如下：

#define class_create(owner,name) \
({
     
	static struct lock_class_key __key;\
	__class_create(owner,name,&__key); \
})

owner：一个struct module 结构体类型的指针，指向函数__class_create()即将创建的、“拥有”这个struct class的模块，一般赋值为THIS_MODULE。
name：char类型的指针，代表即将创建的struct class变量的名字，用于给struct class的name字段赋值。

1. class_create宏需要与函数class_destroy()配对使用，不能单独使用。当单独使用时，第一次不会出现错误，但是第二次插入模块时就会出现错误
2. class_create创建一个逻辑类后，还需要在这个类下面创建设备，不然这个类没什么用。

device_create

如果不使用device_create，则需要我们使用mknod手动进行设备文件创建。
调用device_create函数在/dev目录下创建相应的设备节点。在加载模块的时候，用户空间的udev会自动响应device_create函数，去 /sys/class 下寻找对应的类从而创建设备节点，然后在/dev下生成设备节点。函数原型及入参如下：

struct device *device_create(struct class *class, struct device *parent, dev_t devt, void *drvdata, const char *fmt, ...)

class：该设备依附的类
parant：父设备（）
devt：设备号（MKDEV）
drvdata：私有数据
fmt：设备名

BAR控制类API

DMA操作类API

我们对Markdown编辑器进行了一些功能拓展与语法支持，除了标准的Markdown编辑器功能，我们增加了如下几点新功能，帮助你用它写博客：

1. 全新的界面设计 ，将会带来全新的写作体验；
2. 在创作中心设置你喜爱的代码高亮样式，Markdown 将代码片显示选择的高亮样式 进行展示；
3. 增加了 图片拖拽 功能，你可以将本地的图片直接拖拽到编辑区域直接展示；
4. 全新的 KaTeX数学公式 语法；
5. 增加了支持甘特图的mermaid语法¹ 功能；
6. 增加了 多屏幕编辑 Markdown文章功能；
7. 增加了 焦点写作模式、预览模式、简洁写作模式、左右区域同步滚轮设置 等功能，功能按钮位于编辑区域与预览区域中间；
8. 增加了 检查列表 功能。

功能快捷键

撤销：Ctrl/Command + Z
重做：Ctrl/Command + Y
加粗：Ctrl/Command + B
斜体：Ctrl/Command + I
标题：Ctrl/Command + Shift + H
无序列表：Ctrl/Command + Shift + U
有序列表：Ctrl/Command + Shift + O
检查列表：Ctrl/Command + Shift + C
插入代码：Ctrl/Command + Shift + K
插入链接：Ctrl/Command + Shift + L
插入图片：Ctrl/Command + Shift + G
查找：Ctrl/Command + F
替换：Ctrl/Command + G

合理的创建标题，有助于目录的生成

直接输入1次#，并按下space后，将生成1级标题。
输入2次#，并按下space后，将生成2级标题。
以此类推，我们支持6级标题。有助于使用TOC语法后生成一个完美的目录。

如何改变文本的样式

强调文本 强调文本

加粗文本 加粗文本

标记文本

删除文本

引用文本

H₂O is是液体。

2¹⁰ 运算结果是 1024.

插入链接与图片

链接: link.

图片:

带尺寸的图片:

居中的图片:

居中并且带尺寸的图片:

当然，我们为了让用户更加便捷，我们增加了图片拖拽功能。

如何插入一段漂亮的代码片

去博客设置页面，选择一款你喜欢的代码片高亮样式，下面展示同样高亮的 代码片.

// An highlighted block
var foo = 'bar';

生成一个适合你的列表

• 项目
  • 项目
    • 项目

1. 项目1
2. 项目2
3. 项目3

• 计划任务
• 完成任务

创建一个表格

一个简单的表格是这么创建的：

项目	Value
电脑	$1600
手机	$12
导管	$1

设定内容居中、居左、居右

使用:---------:居中
使用:----------居左
使用----------:居右

第一列	第二列	第三列
第一列文本居中	第二列文本居右	第三列文本居左

SmartyPants

SmartyPants将ASCII标点字符转换为“智能”印刷标点HTML实体。例如：

TYPE	ASCII	HTML
Single backticks	'Isn't this fun?'	‘Isn’t this fun?’
Quotes	"Isn't this fun?"	“Isn’t this fun?”
Dashes	-- is en-dash, --- is em-dash	– is en-dash, — is em-dash

创建一个自定义列表

Markdown

Text-to- HTML conversion tool

Authors

John

Luke

如何创建一个注脚

一个具有注脚的文本。²

注释也是必不可少的

Markdown将文本转换为 HTML。

KaTeX数学公式

您可以使用渲染LaTeX数学表达式 KaTeX:

Gamma公式展示 $\Gamma (n)=(n-1)!\forall n$