12dd/dd

   1 %Device Driver Model
   2 %Thadeu Cascardo
   3
   4 # Linux 2.6 Device Driver Model
   5
   6 * Design and Implementation by GregKH
   7 * kobjects
   8 * sysfs
   9
  10 # Buses
  11
  12 * A way to communicate with device
  13 * Interface between Linux and hardware
  14 * May allow hotplug of devices
  15 * Examples:
  16         - USB
  17         - PCI
  18         - I2C
  19         - SPI
  20         - ACPI
  21         - Platform
  22 * /sys/bus/
  23
  24 # Classes
  25
  26 * A view of the device
  27 * Interface between Linux and user space software
  28 * The interface may use character devices and/or sysfs or other interfaces
  29 * Specific interface classes:
  30         - block devices
  31         - network devices
  32 * Other classes:
  33         - tty
  34         - video4linux
  35         - input
  36         - backlight
  37         - rtc
  38 * /sys/class/
  39
  40 # Drivers
  41
  42 * Implement the communication with the hardware, usually through a bus
  43 * Present a view of the device, communicating with user space
  44 * Basically, links the bus and the class for a given device model (or a family)
  45
  46 # Device
  47
  48 * An object representing a device in the bus or a class device
  49 * Establishes an hierarchy through the parent link
  50 * A class device usually has a device in the bus as its parent
  51
  52 # API
  53
  54 # Classes
  55
  56 * linux/device.h
  57 * struct class
  58         - name
  59         - owner
  60         - dev_release
  61 * class\\_create(owner, name)
  62 * class\\_destroy(class)
  63 * class\\_register(class)
  64 * class\\_unregister(class)
  65
  66 # Devices
  67
  68 * struct device
  69         - parent
  70         - devt
  71         - class
  72         - release
  73
  74 # Devices API
  75
  76 * device\\_initialize(dev)
  77 * get\\_device(dev)
  78 * put\\_device(dev)
  79 * dev\\_set\\_name(dev, fmt, ...)
  80 * dev\\_set\\_drvdata(dev, drvdata)
  81 * dev\\_get\\_drvdata(dev)
  82
  83 # Devices API (cont...)
  84
  85 * device\\_add(dev)
  86 * device\\_del(dev)
  87 * device\\_register(dev)
  88 * device\\_unregister(dev)
  89 * device\\_create(class, parent, devt, drvdata, fmt, ...)
  90 * device\\_destroy(class, devt)
  91
  92 # Attributes
  93
  94 * struct device\\_attribute
  95         - attr
  96                 * name
  97                 * mode
  98         - show
  99         - store
 100 * ssize\\_t show(dev, attr, char *buf)
 101 * ssize\\_t store(dev, attr, char *buf, size\\_t count)
 102 * sprintf
 103 * strict\\_strtol
 104 * strnlen
 105
 106 # Adding attributes
 107
 108 * class.dev\\_attrs
 109 * device\\_create\\_file(dev, attr)
 110 * device\\_remove\\_file(dev, attr)
 111
 112 # devtmpfs
 113
 114 * class.devnode
 115 * char *devnode(dev, mode_t *)