zoukankan      html  css  js  c++  java
  • DEVICE_ATTR

    使用DEVICE_ATTR,可以在sys fs中添加“文件”,通过修改该文件内容,可以实现在运行过程中动态控制device的目的。

    类似的还有DRIVER_ATTR,BUS_ATTR,CLASS_ATTR。
    这几个东东的区别就是,DEVICE_ATTR对应的文件在/sys/devices/目录中对应的device下面。
    而其他几个分别在driver,bus,class中对应的目录下。
    这次主要介绍DEVICE_ATTR,其他几个类似。
    在documentation/driver-model/Device.txt中有对DEVICE_ATTR的详细介绍,这儿主要说明使用方法。

    先看看DEVICE_ATTR的原型:
    DEVICE_ATTR(_name, _mode, _show, _store)
    _name:名称,也就是将在sys fs中生成的文件名称。
    _mode:上述文件的访问权限,与普通文件相同,UGO的格式。
    _show:显示函数,cat该文件时,此函数被调用。
    _store:写函数,echo内容到该文件时,此函数被调用。

    看看我们怎么填充这些要素:
    名称可以随便起一个,便于记忆,并能体现其功能即可。
    模式可以为只读0444,只写0222,或者读写都行的0666。当然也可以对UserGroupOther进行区别。
    显示和写入函数就需要实现了。

    显示函数的一般实现:
    static ssize_t xxx_show(struct device *dev,
     struct device_attribute *attr, char *buf)
    {
     return scnprintf(buf, PAGE_SIZE, "%d ", dma_dump_flag);
    }
    实现相对简单,调用了个很阳春的scnprintf,把数据放到buf中,就算大功告成了。
    至于buf中的内容怎么显示出来,这个先略过。

    写入函数的一般实现:
    static ssize_t xxx_store(struct device *dev,
     struct device_attribute *attr, const char *buf, size_t count)
    {
     unsigned long num;
     if (strict_strtoul(buf, 0, &num))
      return -EINVAL;
     if (num < 0)
      return -EINVAL;
     mutex_lock(&xxx_lock);
     dma_dump_flag = num;
     mutex_unlock(&xxx_lock);
     return count;
    }
    也挺直白,就不细说了。
    其中加了个lock进行互斥。

    函数名中的后缀_show和_store当然不是必须的。
    只是便于标识。

    DEVICE_ATTR的定义例子:
    static DEVICE_ATTR(xxx, 0666, xxx_show, xxx_store);
    该代码可以防止文件的任何位置,只要别引起编译错误!

    是不是这样就搞定了?
    当然没有,还需要调用函数device_create_file来传教sys fs中的文件。
    调用方法:
    device_create_file(&pdev->dev, &dev_attr_xxx);
    文件不是创建在某个device目录下么,pdev->dev就是该device。
    dev_attr_xxx就是在xxx前加上dev_attr_,好像是废话,不过现实就是这样。
    开始还找了半天,dev_attr_xxx在哪儿定义?
    最终发现这儿就是它唯一出现的地方。

    device_create_file的调用例子:
      ret = device_create_file(&pdev->dev, &dev_attr_xxx);
      if (ret != 0) {
       dev_err(&pdev->dev,
        "Failed to create xxx sysfs files: %d ", ret);
       return ret;
      }

    这个代码最好放在device的probe函数中。
    原因么,在documentation/driver-model/Device.txt中有说明。

    下面看看DEVICE_ATTR的定义:
    #define DEVICE_ATTR(_name, _mode, _show, _store)
    struct device_attribute dev_attr_##_name = __ATTR(_name, _mode, _show, _store)
    dev_attr_##_name!!!!!
    终于找到dev_attr_xxx定义的地方了!

    #define __ATTR(_name,_mode,_show,_store) {
     .attr = {.name = __stringify(_name), .mode = _mode }, 
     .show = _show,     
     .store = _store,     
    }

    device_attribute定义:
    struct device_attribute {
     struct attribute attr;
     ssize_t (*show)(struct device *dev, struct device_attribute *attr,
       char *buf);
     ssize_t (*store)(struct device *dev, struct device_attribute *attr,
        const char *buf, size_t count);
    };

    DEVICE_ATTR的功能就是定义一个device_attribute结构体对象。
    device_create_file利用该对象在device下创建文件。

    /**
     * device_create_file - create sysfs attribute file for device.
     * @dev: device.
     * @attr: device attribute descriptor.
     */
    int device_create_file(struct device *dev,
             const struct device_attribute *attr)
    {
     int error = 0;
     if (dev)
      error = sysfs_create_file(&dev->kobj, &attr->attr);
     return error;
    }

    /**
     * sysfs_create_file - create an attribute file for an object.
     * @kobj: object we're creating for. 
     * @attr: attribute descriptor.
     */

    int sysfs_create_file(struct kobject * kobj, const struct attribute * attr)
    {
     BUG_ON(!kobj || !kobj->sd || !attr);

     return sysfs_add_file(kobj->sd, attr, SYSFS_KOBJ_ATTR);
    }

    sd的类型为struct sysfs_dirent。
    /*
     * sysfs_dirent - the building block of sysfs hierarchy.  Each and
     * every sysfs node is represented by single sysfs_dirent.
     *
     * As long as s_count reference is held, the sysfs_dirent itself is
     * accessible.  Dereferencing s_elem or any other outer entity
     * requires s_active reference.
     */
    struct sysfs_dirent {
     atomic_t  s_count;
     atomic_t  s_active;
    #ifdef CONFIG_DEBUG_LOCK_ALLOC
     struct lockdep_map dep_map;
    #endif
     struct sysfs_dirent *s_parent;
     struct sysfs_dirent *s_sibling;
     const char  *s_name;

     const void  *s_ns; /* namespace tag */
     union {
      struct sysfs_elem_dir  s_dir;
      struct sysfs_elem_symlink s_symlink;
      struct sysfs_elem_attr  s_attr;
      struct sysfs_elem_bin_attr s_bin_attr;
     };

     unsigned int  s_flags;
     unsigned short  s_mode;
     ino_t   s_ino;
     struct sysfs_inode_attrs *s_iattr;
    };

    int sysfs_add_file(struct sysfs_dirent *dir_sd, const struct attribute *attr,
         int type)
    {
     return sysfs_add_file_mode(dir_sd, attr, type, attr->mode);
    }

    int sysfs_add_file_mode(struct sysfs_dirent *dir_sd,
       const struct attribute *attr, int type, mode_t amode)
    {
     umode_t mode = (amode & S_IALLUGO) | S_IFREG;
     struct sysfs_addrm_cxt acxt;
     struct sysfs_dirent *sd;
     int rc;

     // 分配空间,并初始化部分成员。
     sd = sysfs_new_dirent(attr->name, mode, type);
     if (!sd)
      return -ENOMEM;
     sd->s_attr.attr = (void *)attr;
    /*
     * Initialize a lock instance's lock-class mapping info:
     */
     sysfs_dirent_init_lockdep(sd);

    /**
     * sysfs_addrm_start - prepare for sysfs_dirent add/remove
     * @acxt: pointer to sysfs_addrm_cxt to be used
     * @parent_sd: parent sysfs_dirent
     *
     * This function is called when the caller is about to add or
     * remove sysfs_dirent under @parent_sd.  This function acquires
     * sysfs_mutex.  @acxt is used to keep and pass context to
     * other addrm functions.
     *
     * LOCKING:
     * Kernel thread context (may sleep).  sysfs_mutex is locked on
     * return.
     */
     sysfs_addrm_start(&acxt, dir_sd);
     
    /**
     * sysfs_add_one - add sysfs_dirent to parent
     * @acxt: addrm context to use
     * @sd: sysfs_dirent to be added
     *
     * Get @acxt->parent_sd and set sd->s_parent to it and increment
     * nlink of parent inode if @sd is a directory and link into the
     * children list of the parent.
     *
     * This function should be called between calls to
     * sysfs_addrm_start() and sysfs_addrm_finish() and should be
     * passed the same @acxt as passed to sysfs_addrm_start().
     *
     * LOCKING:
     * Determined by sysfs_addrm_start().
     *
     * RETURNS:
     * 0 on success, -EEXIST if entry with the given name already
     * exists.
     */
     rc = sysfs_add_one(&acxt, sd);
     
    /**
     * sysfs_addrm_finish - finish up sysfs_dirent add/remove
     * @acxt: addrm context to finish up
     *
     * Finish up sysfs_dirent add/remove.  Resources acquired by
     * sysfs_addrm_start() are released and removed sysfs_dirents are
     * cleaned up.
     *
     * LOCKING:
     * sysfs_mutex is released.
     */
     sysfs_addrm_finish(&acxt);

     if (rc)
      sysfs_put(sd);

     return rc;
    }

    基本上知道是怎么回事了。
    暂时先到这,就不再深入了。

  • 相关阅读:
    吴裕雄--天生自然轻量级JAVA EE企业应用开发Struts2Sping4Hibernate整合开发学习笔记:Spring_EventHandler
    吴裕雄--天生自然轻量级JAVA EE企业应用开发Struts2Sping4Hibernate整合开发学习笔记:Spring_ApplicationContextAware
    吴裕雄--天生自然轻量级JAVA EE企业应用开发Struts2Sping4Hibernate整合开发学习笔记:Spring_setter
    吴裕雄--天生自然轻量级JAVA EE企业应用开发Struts2Sping4Hibernate整合开发学习笔记:Spring_constructor
    吴裕雄--天生自然轻量级JAVA EE企业应用开发Struts2Sping4Hibernate整合开发学习笔记:Spring_springQs
    吴裕雄--天生自然轻量级JAVA EE企业应用开发Struts2Sping4Hibernate整合开发学习笔记:Spring_myspring
    吴裕雄--天生自然轻量级JAVA EE企业应用开发Struts2Sping4Hibernate整合开发学习笔记:Hibernate_Interceptor
    吴裕雄--天生自然轻量级JAVA EE企业应用开发Struts2Sping4Hibernate整合开发学习笔记:Hibernate_EventFrame
    吴裕雄--天生自然轻量级JAVA EE企业应用开发Struts2Sping4Hibernate整合开发学习笔记:Hibernate_SecondCache
    吴裕雄--天生自然轻量级JAVA EE企业应用开发Struts2Sping4Hibernate整合开发学习笔记:Hibernate_QueryCache
  • 原文地址:https://www.cnblogs.com/liang123/p/6325417.html
Copyright © 2011-2022 走看看