Commit | Line | Data |
---|---|---|
eb6adf7d | 1 | .. _cn_submittingdrivers: |
09792200 | 2 | |
eb6adf7d | 3 | .. include:: ../disclaimer-zh_CN.rst |
09792200 | 4 | |
eb6adf7d AS |
5 | :Original: :ref:`Documentation/process/submitting-drivers.rst |
6 | <submittingdrivers>` | |
09792200 LY |
7 | |
8 | 如果想评论或更新本文的内容,请直接联系原文档的维护者。如果你使用英文 | |
9 | 交流有困难的话,也可以向中文版维护者求助。如果本翻译更新不及时或者翻 | |
eb6adf7d | 10 | 译存在问题,请联系中文版维护者:: |
09792200 | 11 | |
707a680e AS |
12 | 中文版维护者: 李阳 Li Yang <leoyang.li@nxp.com> |
13 | 中文版翻译者: 李阳 Li Yang <leoyang.li@nxp.com> | |
eb6adf7d AS |
14 | 中文版校译者: 陈琦 Maggie Chen <chenqi@beyondsoft.com> |
15 | 王聪 Wang Cong <xiyou.wangcong@gmail.com> | |
89870c21 | 16 | 张巍 Zhang Wei <wezhang@outlook.com> |
09792200 LY |
17 | |
18 | 如何向 Linux 内核提交驱动程序 | |
eb6adf7d | 19 | ============================= |
09792200 LY |
20 | |
21 | 这篇文档将会解释如何向不同的内核源码树提交设备驱动程序。请注意,如果你感 | |
22 | 兴趣的是显卡驱动程序,你也许应该访问 XFree86 项目(http://www.xfree86.org/) | |
23 | 和/或 X.org 项目 (http://x.org)。 | |
24 | ||
6db147a8 | 25 | 另请参阅 Documentation/Documentation/translations/zh_CN/process/submitting-patches.rst 文档。 |
09792200 LY |
26 | |
27 | ||
28 | 分配设备号 | |
29 | ---------- | |
30 | ||
31 | 块设备和字符设备的主设备号与从设备号是由 Linux 命名编号分配权威 LANANA( | |
32 | 现在是 Torben Mathiasen)负责分配。申请的网址是 http://www.lanana.org/。 | |
33 | 即使不准备提交到主流内核的设备驱动也需要在这里分配设备号。有关详细信息, | |
8c27ceff | 34 | 请参阅 Documentation/admin-guide/devices.rst。 |
09792200 LY |
35 | |
36 | 如果你使用的不是已经分配的设备号,那么当你提交设备驱动的时候,它将会被强 | |
37 | 制分配一个新的设备号,即便这个设备号和你之前发给客户的截然不同。 | |
38 | ||
39 | 设备驱动的提交对象 | |
40 | ------------------ | |
41 | ||
42 | Linux 2.0: | |
43 | 此内核源码树不接受新的驱动程序。 | |
44 | ||
45 | Linux 2.2: | |
46 | 此内核源码树不接受新的驱动程序。 | |
47 | ||
48 | Linux 2.4: | |
49 | 如果所属的代码领域在内核的 MAINTAINERS 文件中列有一个总维护者, | |
50 | 那么请将驱动程序提交给他。如果此维护者没有回应或者你找不到恰当的 | |
51 | 维护者,那么请联系 Willy Tarreau <w@1wt.eu>。 | |
52 | ||
53 | Linux 2.6: | |
54 | 除了遵循和 2.4 版内核同样的规则外,你还需要在 linux-kernel 邮件 | |
55 | 列表上跟踪最新的 API 变化。向 Linux 2.6 内核提交驱动的顶级联系人 | |
c996d8b9 | 56 | 是 Andrew Morton <akpm@linux-foundation.org>。 |
09792200 LY |
57 | |
58 | 决定设备驱动能否被接受的条件 | |
59 | ---------------------------- | |
60 | ||
61 | 许可: 代码必须使用 GNU 通用公开许可证 (GPL) 提交给 Linux,但是 | |
62 | 我们并不要求 GPL 是唯一的许可。你或许会希望同时使用多种 | |
63 | 许可证发布,如果希望驱动程序可以被其他开源社区(比如BSD) | |
64 | 使用。请参考 include/linux/module.h 文件中所列出的可被 | |
65 | 接受共存的许可。 | |
66 | ||
67 | 版权: 版权所有者必须同意使用 GPL 许可。最好提交者和版权所有者 | |
68 | 是相同个人或实体。否则,必需列出授权使用 GPL 的版权所有 | |
69 | 人或实体,以备验证之需。 | |
70 | ||
71 | 接口: 如果你的驱动程序使用现成的接口并且和其他同类的驱动程序行 | |
72 | 为相似,而不是去发明无谓的新接口,那么它将会更容易被接受。 | |
73 | 如果你需要一个 Linux 和 NT 的通用驱动接口,那么请在用 | |
74 | 户空间实现它。 | |
75 | ||
8c27ceff | 76 | 代码: 请使用 Documentation/process/coding-style.rst 中所描述的 Linux 代码风 |
09792200 LY |
77 | 格。如果你的某些代码段(例如那些与 Windows 驱动程序包共 |
78 | 享的代码段)需要使用其他格式,而你却只希望维护一份代码, | |
79 | 那么请将它们很好地区分出来,并且注明原因。 | |
80 | ||
81 | 可移植性: 请注意,指针并不永远是 32 位的,不是所有的计算机都使用小 | |
82 | 尾模式 (little endian) 存储数据,不是所有的人都拥有浮点 | |
83 | 单元,不要随便在你的驱动程序里嵌入 x86 汇编指令。只能在 | |
84 | x86 上运行的驱动程序一般是不受欢迎的。虽然你可能只有 x86 | |
85 | 硬件,很难测试驱动程序在其他平台上是否可用,但是确保代码 | |
86 | 可以被轻松地移植却是很简单的。 | |
87 | ||
88 | 清晰度: 做到所有人都能修补这个驱动程序将会很有好处,因为这样你将 | |
89 | 会直接收到修复的补丁而不是 bug 报告。如果你提交一个试图 | |
90 | 隐藏硬件工作机理的驱动程序,那么它将会被扔进废纸篓。 | |
91 | ||
92 | 电源管理: 因为 Linux 正在被很多移动设备和桌面系统使用,所以你的驱 | |
93 | 动程序也很有可能被使用在这些设备上。它应该支持最基本的电 | |
94 | 源管理,即在需要的情况下实现系统级休眠和唤醒要用到的 | |
95 | .suspend 和 .resume 函数。你应该检查你的驱动程序是否能正 | |
96 | 确地处理休眠与唤醒,如果实在无法确认,请至少把 .suspend | |
97 | 函数定义成返回 -ENOSYS(功能未实现)错误。你还应该尝试确 | |
98 | 保你的驱动在什么都不干的情况下将耗电降到最低。要获得驱动 | |
99 | 程序测试的指导,请参阅 | |
100 | Documentation/power/drivers-testing.txt。有关驱动程序电 | |
101 | 源管理问题相对全面的概述,请参阅 | |
ec15872d | 102 | Documentation/driver-api/pm/devices.rst。 |
09792200 LY |
103 | |
104 | 管理: 如果一个驱动程序的作者还在进行有效的维护,那么通常除了那 | |
105 | 些明显正确且不需要任何检查的补丁以外,其他所有的补丁都会 | |
106 | 被转发给作者。如果你希望成为驱动程序的联系人和更新者,最 | |
107 | 好在代码注释中写明并且在 MAINTAINERS 文件中加入这个驱动 | |
108 | 程序的条目。 | |
109 | ||
110 | 不影响设备驱动能否被接受的条件 | |
111 | ------------------------------ | |
112 | ||
113 | 供应商: 由硬件供应商来维护驱动程序通常是一件好事。不过,如果源码 | |
114 | 树里已经有其他人提供了可稳定工作的驱动程序,那么请不要期 | |
115 | 望“我是供应商”会成为内核改用你的驱动程序的理由。理想的情 | |
116 | 况是:供应商与现有驱动程序的作者合作,构建一个统一完美的 | |
117 | 驱动程序。 | |
118 | ||
119 | 作者: 驱动程序是由大的 Linux 公司研发还是由你个人编写,并不影 | |
120 | 响其是否能被内核接受。没有人对内核源码树享有特权。只要你 | |
121 | 充分了解内核社区,你就会发现这一点。 | |
122 | ||
123 | ||
124 | 资源列表 | |
125 | -------- | |
126 | ||
127 | Linux 内核主源码树: | |
128 | ftp.??.kernel.org:/pub/linux/kernel/... | |
129 | ?? == 你的国家代码,例如 "cn"、"us"、"uk"、"fr" 等等 | |
130 | ||
131 | Linux 内核邮件列表: | |
132 | linux-kernel@vger.kernel.org | |
133 | [可通过向majordomo@vger.kernel.org发邮件来订阅] | |
134 | ||
135 | Linux 设备驱动程序,第三版(探讨 2.6.10 版内核): | |
136 | http://lwn.net/Kernel/LDD3/ (免费版) | |
137 | ||
138 | LWN.net: | |
139 | 每周内核开发活动摘要 - http://lwn.net/ | |
ce8ee3a8 | 140 | |
09792200 | 141 | 2.6 版中 API 的变更: |
ce8ee3a8 | 142 | |
09792200 | 143 | http://lwn.net/Articles/2.6-kernel-api/ |
ce8ee3a8 | 144 | |
09792200 | 145 | 将旧版内核的驱动程序移植到 2.6 版: |
ce8ee3a8 | 146 | |
09792200 LY |
147 | http://lwn.net/Articles/driver-porting/ |
148 | ||
09792200 LY |
149 | 内核新手(KernelNewbies): |
150 | 为新的内核开发者提供文档和帮助 | |
151 | http://kernelnewbies.org/ | |
152 | ||
153 | Linux USB项目: | |
154 | http://www.linux-usb.org/ | |
155 | ||
156 | 写内核驱动的“不要”(Arjan van de Ven著): | |
157 | http://www.fenrus.org/how-to-not-write-a-device-driver-paper.pdf | |
158 | ||
159 | 内核清洁工 (Kernel Janitor): | |
0ea6e611 | 160 | http://kernelnewbies.org/KernelJanitors |