上篇讲了Linuxclock驱动，今天说说Linux的reset驱动。

时钟和复位是两个不同的驱动，但通常都是由负责clock驱动的人，把reset驱动完成。同样，reset驱动也是由芯片厂商去完成的。

【资料图】

Linux reset子系统

reset子系统非常简单，与clock子系统非常类似，但在驱动实现上，reset驱动更简单。

因为clock驱动主要是时钟的实现，涉及到固定时钟、分频、门控等一些时钟的分级关系，需要弄清楚时钟树里每个时钟的关系。

而reset驱动有点相当于clock驱动的门控，它只有复位和解复位两个功能。

类似于clock子系统，reset子系统也分为了consumer和provider，结构体关系如下：

consumer：

reset API接口的使用者，内核提供了统一的reset接口：

devm_reset_control_get(struct device *dev, const char *id)//获取reset句柄< font >< /font >reset_control_deassert(struct reset_control *rstc)//解复位< font >< /font >reset_control_assert(struct reset_control *rstc)//复位< font >< /font >reset_control_reset(struct reset_control *rstc)//先复位，延迟一会，然后解复位< font >< /font >

struct reset_control结构体表示一个reset句柄，驱动中使用reset API，需要先获取reset句柄

provider：

reset提供者，即reset驱动。struct reset_controller_dev结构体代表一个reset控制器，内部包含了reset操作函数集合struct reset_control_ops，注册reset驱动时，需要分配一个struct reset_controller_dev结构体，然后填充成员，最后将该结构体注册。

struct reset_controller_dev{< font >< /font >    const struct reset_control_ops *ops;//复位控制操作函数< font >< /font >    struct list_headlist;//全局链表，复位控制器注册后挂载到全局链表< font >< /font >    struct list_head reset_control_head;//各个模块复位的链表头< font >< /font >    struct device *dev；< font >< /font >    int of_reset_n_cells;//dts中引用时，需要几个参数< font >< /font >        < font >< /font >    //通过dts引用的参数，解析复位控制器中相应的参数< font >< /font >    int (*of_xlate)(struct reset_controller_dev *rcdev, const struct of_phandle_args *reset_spec)；< font >< /font >    unsigned int nr_resets;//复位设备个数< font >< /font >}< font >< /font >< font >< /font >struct reset_control_ops{< font >< /font >    int (*reset)(struct reset_controller_dev *rcdev, unsigned long id);//复位+解复位< font >< /font >    int (*assert)(struct reset_controller_dev *rcdev, unsigned long id);//复位< font >< /font >    int (*deassert)(struct reset_controller_dev *rcdev, unsigned long id);//解复位< font >< /font >    int (*status)(struct reset_controller_dev *rcdev, unsigned long id);//复位状态查询< font >< /font >}< font >< /font >

reset复位API说明

devm_reset_control_get

struct reset_control *devm_reset_control_get(struct device *dev, const char *id)

作用：获取相应的reset句柄参数：dev：指向申请reset资源的设备句柄id：指向要申请的reset资源名（字符串），可以为NULL返回：成功：返回reset句柄失败：返回NULL

reset_control_deassert

int reset_control_deassert(struct reset_control *rstc)

作用：对传入的reset资源进行解复位操作参数：rstc：指向申请reset资源的设备句柄返回：成功：返回0失败：返回错误码

reset_control_assert

int reset_control_assert(struct reset_control *rstc)

作用：对传入的reset资源进行复位操作。

参数和返回值与reset_control_deassert相同

reset_control_reset

int reset_control_reset(struct reset_control *rstc)

作用：对传入的reset资源先进行复位操作，然后等待5us，再进行解复位操作。相当于执行了一遍reset_control_assert后，然后delay一会，再调用reset_control_deassert

reset API使用示例

基本步骤：

1、调用devm_reset_control_get()获取reset句柄

2、调用reset_control_assert()进行复位操作

3、调用reset_control_deassert()进行解复位操作

static int xx_probe(struct platform_device *pdev)< font >< /font >{< font >< /font >< font >< /font > struct device_node* np = pdev- >dev.of_node;< font >< /font > ......< font >< /font >< font >< /font >    /* 1、获取reset句柄 */< font >< /font > host- >rstc = devm_reset_control_get(&pdev- >dev, np- >name);< font >< /font > if (IS_ERR(host- >rstc)) {< font >< /font >  dev_err(&pdev- >dev, "No reset controller specified\\n");< font >< /font >  return PTR_ERR(host- >rstc);< font >< /font > }< font >< /font >< font >< /font > if (host- >rstc) {< font >< /font >        /* 2、复位 */< font >< /font >  ret = reset_control_assert(host- >rstc);< font >< /font >  if (ret) {< font >< /font >   dev_err(&pdev- >dev, "unable to reset_control_assert\\n");< font >< /font >   return ret;< font >< /font >  }< font >< /font >  udelay(1);< font >< /font > < font >< /font >        /* 3、解复位 */< font >< /font >  ret = reset_control_deassert(host- >rstc);< font >< /font >  if (ret) {< font >< /font >   dev_err(&pdev- >dev, "unable to reset_control_deassert\\n");< font >< /font >   return ret;< font >< /font >  }< font >< /font > }< font >< /font > ......< font >< /font >}< font >< /font >

reset驱动实例

类似于clock驱动，reset驱动也是编进内核的，在Linux启动时，完成reset驱动的加载。

设备树

reset:reset-controller{< font >< /font > compatible = "xx,xx-reset";< font >< /font > reg = < 0x0 0xc0000000 0x0 0x1000 >;< font >< /font > #reset-cells = < 1 >;< font >< /font >};< font >< /font >

上述是一个reset控制器的节点，0xc0000000是寄存器基址，0x1000是映射大小。 #reset-cells代表引用该reset时需要的cells个数。

例如，#reset-cells = <1>;则正确引用为：

mmc:mmc@0x12345678{< font >< /font >    ......< font >< /font >    resets = < &reset  0 >;//0代表reset设备id，id是自定义的，但是不能超过reset驱动中指定的设备个数< font >< /font >    ......< font >< /font >};< font >< /font >

驱动编写

reset驱动编写的基本步骤：

1、实现struct reset_control_ops结构体中的.reset、.assert、.deassert、.status函数

2、分配struct reset_controller_dev结构体，填充ops、owner、nr_resets等成员内容

3、调用reset_controller_register函数注册reset设备

以下是从实际项目中分离出来的reset驱动代码：

#include < linux/of.h >< font >< /font >#include < linux/module.h >< font >< /font >#include < linux/of_device.h >< font >< /font >#include < linux/reset-controller.h >< font >< /font >#include < linux/io.h >< font >< /font >#include < linux/delay.h >< font >< /font >< font >< /font >// 自定义芯片厂的结构体，保存寄存器基址等信息< font >< /font >struct xx_reset{< font >< /font > struct reset_controller_dev rcdev;< font >< /font > void __iomem *base;< font >< /font >    //......< font >< /font >};< font >< /font >< font >< /font >< font >< /font >static int xx_reset(struct reset_controller_dev *rcdev, unsigned long id)< font >< /font >{< font >< /font > //操作寄存器：先复位，延迟一会，然后解复位< font >< /font > return 0;< font >< /font >}< font >< /font >< font >< /font >static int xx_reset_assert(struct reset_controller_dev *rcdev, unsigned long id)< font >< /font >{< font >< /font > //操作寄存器：复位< font >< /font > return 0;< font >< /font >}< font >< /font >< font >< /font >static int xx_reset_deassert(struct reset_controller_dev *rcdev, unsigned long id)< font >< /font >{< font >< /font > //操作寄存器：解复位< font >< /font > return  0;< font >< /font >}< font >< /font >< font >< /font >static int xx_reset_status(struct reset_controller_dev *rcdev, unsigned long id)< font >< /font >{< font >< /font > //操作寄存器：获取复位状态< font >< /font > return 0; < font >< /font >}< font >< /font >< font >< /font >static struct reset_control_ops xx_reset_ops = {< font >< /font > .rest = xx_rest,< font >< /font > .assert = xx_reset_asser,< font >< /font > .deassert = xx_reset_deassert,< font >< /font > .status = xx_rest_status,< font >< /font >};< font >< /font >< font >< /font >static int xx_reset_probe(struct platform_device *pdev)< font >< /font >{< font >< /font > struct xx_reset *xx_reset;< font >< /font > struct resource *res;< font >< /font > < font >< /font > xx_reset = devm_kzalloc(&pdev- >dev, sizeof(*xx_reset), GFP_KERNEL);< font >< /font > if (!xx_reset)< font >< /font >  return -ENOMEM;< font >< /font >< font >< /font > platform_set_drvdata(pdev, xx_reset);< font >< /font >< font >< /font > res = platform_get_resource(pdev, IORESOURCE_MEM, 0);< font >< /font > xx_reset- >base = devm_ioremap_resource(&pdev- >dev, res);//映射寄存器基址< font >< /font > if (IS_ERR(xx_reset- >base))< font >< /font >  return PTR_ERR(xx_reset- >base);< font >< /font >< font >< /font > xx_reset- >rcdev.ops = &xx_reset_ops;//reset_ops操作函数集合< font >< /font > xx_reset- >rcdev.owner = THIS_MODULE;< font >< /font > xx_reset- >rcdev.of_node = pdev- >dev.of_node;< font >< /font > xx_reset- >rcdev.of_reset_n_cells = 1;  < font >< /font > xx_reset- >rcdev.nr_resets = BITS_PER_LONG;//reset设备个数< font >< /font >< font >< /font > return reset_controller_register(&xx_reset- >rcdev);//注册reset controller< font >< /font > < font >< /font >}< font >< /font >< font >< /font >< font >< /font >static int xx_reset_remove(struct platform_device *pdev)< font >< /font >{< font >< /font > struct xx_reste *xx_reset = platform_get_drvdata(pdev);< font >< /font > < font >< /font > reset_controller_unregister(&xx_reset- >rcdev);< font >< /font > return 0;< font >< /font >}< font >< /font >< font >< /font >static const struct of_device_id ak_reset_of_match[]={< font >< /font > {.compatible = "xx,xx-reset"},< font >< /font > {},< font >< /font >};< font >< /font >< font >< /font >MODULE_DEVICE_TABLE(of, xx_reset_of_match);< font >< /font >< font >< /font >static struct platform_driver xx_reset_driver = {< font >< /font > .probe = xx_reset_probe,< font >< /font > .remove = xx_reset_remove,< font >< /font > .driver = {< font >< /font >  .name = "xx-reset",< font >< /font >  .of_match_table = ak_reset_of_match,< font >< /font > },< font >< /font >};< font >< /font >< font >< /font >< font >< /font >module_platorm_driver(xx_reset_driver);< font >< /font >< font >< /font >MODULE_LICENSE("GPL");< font >< /font >MODULE_DESCPRIPTION("xx reset controller driver");< font >< /font >MODULE_AUTHOR("xx Microelectronic");< font >< /font >MODULE_VERSION("v1.0.00");< font >< /font >