1. 概述

在Linux設(shè)備模型中，Bus（總線）是一類特殊的設(shè)備，它是連接處理器和其它設(shè)備之間的通道（channel）。為了方便設(shè)備模型的實(shí)現(xiàn)，內(nèi)核規(guī)定，系統(tǒng)中的每個(gè)設(shè)備都要連接在一個(gè)Bus上，這個(gè)Bus可以是一個(gè)內(nèi)部Bus、虛擬Bus或者Platform Bus。

內(nèi)核通過struct bus_type結(jié)構(gòu)，抽象Bus，它是在include/linux/device.h中定義的。本文會圍繞該結(jié)構(gòu)，描述Linux內(nèi)核中Bus的功能，以及相關(guān)的實(shí)現(xiàn)邏輯。最后，會簡單的介紹一些標(biāo)準(zhǔn)的Bus（如Platform），介紹它們的用途、它們的使用場景。

2. 功能說明

按照老傳統(tǒng)，描述功能前，先介紹一下該模塊的一些核心數(shù)據(jù)結(jié)構(gòu)，對bus模塊而言，核心數(shù)據(jù)結(jié)構(gòu)就是struct bus_type，另外，還有一個(gè)sub system相關(guān)的結(jié)構(gòu)，會一并說明。

2.1 struct bus_type

1: /* inlcude/linux/device.h, line 93 */

2: struct bus_type {

3: ????const char *name;

4: ????const char *dev_name;

5: ????struct device *dev_root;

6: ????struct bus_attribute *bus_attrs;

7: ????struct device_attribute *dev_attrs;

8: ????struct driver_attribute *drv_attrs;

9:

10:????int (*match)(struct device *dev, struct device_driver *drv);

11:????int (*uevent)(struct device *dev, struct kobj_uevent_env *env);

12:????int (*probe)(struct device *dev);

13:????int (*remove)(struct device *dev);

14:????void (*shutdown)(struct device *dev);

15:

16:????int (*suspend)(struct device *dev, pm_message_t state);

17:????int (*resume)(struct device *dev);

18:

19:????const struct dev_pm_ops *pm;

20:

21:????struct iommu_ops *iommu_ops;

22:

23:????struct subsys_private *p;

24:????struct lock_class_key lock_key;

25: };

name，該bus的名稱，會在sysfs中以目錄的形式存在，如platform bus在sysfs中表現(xiàn)為"/sys/bus/platform”。

dev_name，該名稱和"Linux設(shè)備模型(5)_device和device driver”所講述的struct device結(jié)構(gòu)中的init_name有關(guān)。對有些設(shè)備而言（例如批量化的USB設(shè)備），設(shè)計(jì)者根本就懶得為它起名字的，而內(nèi)核也支持這種懶惰，允許將設(shè)備的名字留空。這樣當(dāng)設(shè)備注冊到內(nèi)核后，設(shè)備模型的核心邏輯就會用"bus->dev_name+device ID”的形式，為這樣的設(shè)備生成一個(gè)名稱。

bus_attrs、dev_attrs、drv_attrs，一些默認(rèn)的attribute，可以在bus、device或者device_driver添加到內(nèi)核時(shí)，自動為它們添加相應(yīng)的attribute。

dev_root，根據(jù)內(nèi)核的注釋，dev_root設(shè)備為bus的默認(rèn)父設(shè)備（Default device to use as the parent），但在內(nèi)核實(shí)際實(shí)現(xiàn)中，只和一個(gè)叫sub system的功能有關(guān)，隨后會介紹。

match，一個(gè)由具體的bus driver實(shí)現(xiàn)的回調(diào)函數(shù)。當(dāng)任何屬于該Bus的device或者device_driver添加到內(nèi)核時(shí)，內(nèi)核都會調(diào)用該接口，如果新加的device或device_driver匹配上了自己的另一半的話，該接口要返回非零值，此時(shí)Bus模塊的核心邏輯就會執(zhí)行后續(xù)的處理。

uevent，一個(gè)由具體的bus driver實(shí)現(xiàn)的回調(diào)函數(shù)。當(dāng)任何屬于該Bus的device，發(fā)生添加、移除或者其它動作時(shí)，Bus模塊的核心邏輯就會調(diào)用該接口，以便bus driver能夠修改環(huán)境變量。

probe、remove，這兩個(gè)回調(diào)函數(shù)，和device_driver中的非常類似，但它們的存在是非常有意義的。可以想象一下，如果需要probe（其實(shí)就是初始化）指定的device話，需要保證該device所在的bus是被初始化過、確保能正確工作的。這就要就在執(zhí)行device_driver的probe前，先執(zhí)行它的bus的probe。remove的過程相反。?
注1：并不是所有的bus都需要probe和remove接口的，因?yàn)閷τ行゜us來說（例如platform bus），它本身就是一個(gè)虛擬的總線，無所謂初始化，直接就能使用，因此這些bus的driver就可以將這兩個(gè)回調(diào)函數(shù)留空。

shutdown、suspend、resume，和probe、remove的原理類似，電源管理相關(guān)的實(shí)現(xiàn)，暫不說明。

pm，電源管理相關(guān)的邏輯，暫不說明。

iommu_ops，暫不說明。

p，一個(gè)struct subsys_private類型的指針，后面我們會用一個(gè)小節(jié)說明。

2.2 struct subsys_private

該結(jié)構(gòu)和device_driver中的struct driver_private類似，在"Linux設(shè)備模型(5)_device和device driver”章節(jié)中有提到它，但沒有詳細(xì)說明。

要說明subsys_private的功能，讓我們先看一下該結(jié)構(gòu)的定義：

1: /* drivers/base/base.h, line 28 */

2: struct subsys_private {

3: ????struct kset subsys;

4: ????struct kset *devices_kset;

5: ????struct list_head interfaces;

6: ????struct mutex mutex;

7:

8: ????struct kset *drivers_kset;

9: ????struct klist klist_devices;

10:????struct klist klist_drivers;

11:????struct blocking_notifier_head bus_notifier;

12:????unsigned int drivers_autoprobe:1;

13:????struct bus_type *bus;

14:

15:????struct kset glue_dirs;

16:????struct class *class;

17: };

看到結(jié)構(gòu)內(nèi)部的字段，就清晰多了，沒事不要亂起名字嘛！什么subsys啊，看的暈暈的！不過還是試著先理解一下為什么起名為subsys吧：

按理說，這個(gè)結(jié)構(gòu)就是集合了一些bus模塊需要使用的私有數(shù)據(jù)，例如kset啦、klist啦等等，命名為bus_private會好點(diǎn)（就像device_driver模塊一樣）。不過為什么內(nèi)核沒這么做呢？看看include/linux/device.h中的struct class結(jié)構(gòu)（我們會在下一篇文章中介紹class）就知道了，因?yàn)閏lass結(jié)構(gòu)中也包含了一個(gè)一模一樣的struct subsys_private指針，看來class和bus很相似啊。

想到這里，就好理解了，無論是bus，還是class，還是我們會在后面看到的一些虛擬的子系統(tǒng)，它都構(gòu)成了一個(gè)“子系統(tǒng)（sub-system）”，該子系統(tǒng)會包含形形色色的device或device_driver，就像一個(gè)獨(dú)立的王國一樣，存在于內(nèi)核中。而這些子系統(tǒng)的表現(xiàn)形式，就是/sys/bus（或/sys/class，或其它）目錄下面的子目錄，每一個(gè)子目錄，都是一個(gè)子系統(tǒng)（如/sys/bus/spi/）。

好了，我們回過頭來看一下struct subsys_private中各個(gè)字段的解釋：

subsys、devices_kset、drivers_kset是三個(gè)kset，由"Linux設(shè)備模型(2)_Kobject”中對kset的描述可知，kset是一個(gè)特殊的kobject，用來集合相似的kobject，它在sysfs中也會以目錄的形式體現(xiàn)。其中subsys，代表了本bus（如/sys/bus/spi），它下面可以包含其它的kset或者其它的kobject；devices_kset和drivers_kset則是bus下面的兩個(gè)kset（如/sys/bus/spi/devices和/sys/bus/spi/drivers），分別包括本bus下所有的device和device_driver。

interface是一個(gè)list head，用于保存該bus下所有的interface。有關(guān)interface的概念后面會詳細(xì)介紹。

klist_devices和klist_drivers是兩個(gè)鏈表，分別保存了本bus下所有的device和device_driver的指針，以方便查找。

drivers_autoprobe，用于控制該bus下的drivers或者device是否自動probe，"Linux設(shè)備模型(5)_device和device driver”中有提到。

bus和class指針，分別保存上層的bus或者class指針。

2.3 功能總結(jié)

根據(jù)上面的核心數(shù)據(jù)結(jié)構(gòu)，可以總結(jié)出bus模塊的功能包括：

bus的注冊和注銷

本bus下有device或者device_driver注冊到內(nèi)核時(shí)的處理

本bus下有device或者device_driver從內(nèi)核注銷時(shí)的處理

device_drivers的probe處理

管理bus下的所有device和device_driver

3. 內(nèi)部執(zhí)行邏輯分析

3.1 bus的注冊

bus的注冊是由bus_register接口實(shí)現(xiàn)的，該接口的原型是在include/linux/device.h中聲明的，并在drivers/base/bus.c中實(shí)現(xiàn)，其原型如下：

1: /* include/linux/device.h, line 118 */

2: extern int __must_check bus_register(struct bus_type *bus);

該功能的執(zhí)行邏輯如下：

為bus_type中struct subsys_private類型的指針分配空間，并更新priv->bus和bus->p兩個(gè)指針為正確的值

初始化priv->subsys.kobj的name、kset、ktype等字段，啟動name就是該bus的name（它會體現(xiàn)在sysfs中），kset和ktype由bus模塊實(shí)現(xiàn)，分別為bus_kset和bus_ktype

調(diào)用kset_register將priv->subsys注冊到內(nèi)核中，該接口同時(shí)會向sysfs中添加對應(yīng)的目錄（如/sys/bus/spi）

調(diào)用bus_create_file向bus目錄下添加一個(gè)uevent attribute（如/sys/bus/spi/uevent）

調(diào)用kset_create_and_add分別向內(nèi)核添加devices和device_drivers kset，同時(shí)會體現(xiàn)在sysfs中

初始化priv指針中的mutex、klist_devices和klist_drivers等變量

調(diào)用add_probe_files接口，在bus下添加drivers_probe和drivers_autoprobe兩個(gè)attribute（如/sys/bus/spi/drivers_probe和/sys/bus/spi/drivers_autoprobe），其中drivers_probe允許用戶空間程序主動出發(fā)指定bus下的device_driver的probe動作，而drivers_autoprobe控制是否在device或device_driver添加到內(nèi)核時(shí)，自動執(zhí)行probe

調(diào)用bus_add_attrs，添加由bus_attrs指針定義的bus的默認(rèn)attribute，這些attributes最終會體現(xiàn)在/sys/bus/xxx目錄下

3.2 device和device_driver的添加

我們有在"Linux設(shè)備模型(5)_device和device driver”中講過，內(nèi)核提供了device_register和driver_register兩個(gè)接口，供各個(gè)driver模塊使用。而這兩個(gè)接口的核心邏輯，是通過bus模塊的bus_add_device和bus_add_driver實(shí)現(xiàn)的，下面我們看看這兩個(gè)接口的處理邏輯。

這兩個(gè)接口都是在drivers/base/base.h中聲明，在drivers/base/bus.c中實(shí)現(xiàn)，其原型為：

1: /* drivers/base/base.h, line 106 */

2: extern int bus_add_device(struct device *dev);

3:

4: /* drivers/base/base.h, line 110 */

5: extern int bus_add_driver(struct device_driver *drv);

bus_add_device的處理邏輯：

調(diào)用內(nèi)部的device_add_attrs接口，將由bus->dev_attrs指針定義的默認(rèn)attribute添加到內(nèi)核中，它們會體現(xiàn)在/sys/devices/xxx/xxx_device/目錄中

調(diào)用sysfs_create_link接口，將該device在sysfs中的目錄，鏈接到該bus的devices目錄下，例如：?

xxx# ls /sys/bus/spi/devices/spi1.0 -l?????????????????????????????????????????????????????????
lrwxrwxrwx root???? root????????????? 2014-04-11 10:46?spi1.0?-> ../../../devices/platform/s3c64xx-spi.1/spi_master/spi1/spi1.0?
其中/sys/devices/…/spi1.0，為該device在sysfs中真正的位置，而為了方便管理，內(nèi)核在該設(shè)備所在的bus的xxx_bus/devices目錄中，創(chuàng)建了一個(gè)符號鏈接

調(diào)用sysfs_create_link接口，在該設(shè)備的sysfs目錄中（如/sys/devices/platform/alarm/）中，創(chuàng)建一個(gè)指向該設(shè)備所在bus目錄的鏈接，取名為subsystem，例如：?

xxx # ls /sys/devices/platform/alarm/subsystem?-l?????????????????????????????????????????????????
lrwxrwxrwx root???? root????????????? 2014-04-11 10:28 subsystem ->?../../../bus/platform

最后，毫無疑問，要把該設(shè)備指針保存在bus->priv->klist_devices中

bus_add_driver的處理邏輯：

為該driver的struct driver_private指針（priv）分配空間，并初始化其中的priv->klist_devices、priv->driver、priv->kobj.kset等變量，同時(shí)將該指針保存在device_driver的p處

將driver的kset（priv->kobj.kset）設(shè)置為bus的drivers kset（bus->p->drivers_kset），這就意味著所有driver的kobject都位于bus->p->drivers_kset之下（寄/sys/bus/xxx/drivers目錄下）

以driver的名字為參數(shù)，調(diào)用kobject_init_and_add接口，在sysfs中注冊driver的kobject，體現(xiàn)在/sys/bus/xxx/drivers/目錄下，如/sys/bus/spi/drivers/spidev

將該driver保存在bus的klist_drivers鏈表中，并根據(jù)drivers_autoprobe的值，選擇是否調(diào)用driver_attach進(jìn)行probe

調(diào)用driver_create_file接口，在sysfs的該driver的目錄下，創(chuàng)建uevent attribute

調(diào)用driver_add_attrs接口，在sysfs的該driver的目錄下，創(chuàng)建由bus->drv_attrs指針定義的默認(rèn)attribute

同時(shí)根據(jù)suppress_bind_attrs標(biāo)志，決定是否在sysfs的該driver的目錄下，創(chuàng)建bind和unbind attribute（具體可參考"Linux設(shè)備模型(5)_device和device driver”中的介紹）?

3.3 driver的probe

我們在"Linux設(shè)備模型(5)_device和device driver”中，我們已經(jīng)介紹過driver的probe時(shí)機(jī)及過程，其中大部分的邏輯會依賴bus模塊的實(shí)現(xiàn)，主要為bus_probe_device和driver_attach接口。同樣，這兩個(gè)接口都是在drivers/base/base.h中聲明，在drivers/base/bus.c中實(shí)現(xiàn)。

這兩個(gè)結(jié)構(gòu)的行為類似，邏輯也很簡單，既：搜索所在的bus，比對是否有同名的device_driver（或device），如果有并且該設(shè)備沒有綁定Driver（注：這一點(diǎn)很重要，通過它，可以使同一個(gè)Driver，驅(qū)動相同名稱的多個(gè)設(shè)備，后續(xù)在Platform設(shè)備的描述中會提及）則調(diào)用device_driver的probe接口。

4. 雜項(xiàng)

4.1 再談Subsystem

在舊的Linux內(nèi)核版本中（以蝸蝸使用的linux2.6.23版本的內(nèi)核為例），sysfs下所有的頂層目錄（包括一些二級目錄）都是以調(diào)用subsystem_register接口，以sub-system的形式注冊到內(nèi)核的，如：

/sys/bus/

/sys/devices/

/sys/devices/system/

/sys/block

/sys/kernel/

/sys/slab/

…

那時(shí)的subsystem_register的實(shí)現(xiàn)很簡單，就是調(diào)用kset_register，創(chuàng)建一個(gè)kset。我們知道，kset就是一堆kobject的集合，并會在sysfs中以目錄的形式呈現(xiàn)出來。

在新版本的內(nèi)核中（如“Linux內(nèi)核分析”系列文章所參考的linux3.10.29），subsystem的實(shí)現(xiàn)有了很大變化，例如：去掉了subsystem_register接口（但為了兼容/sys/device/system子系統(tǒng)，在drivers/base/bus.c中，增加了一個(gè)subsys_register的內(nèi)部接口，用于實(shí)現(xiàn)相應(yīng)的功能）。根據(jù)這些變化，現(xiàn)在注冊subsystem有兩種方式：

方式一，在各自的初始化函數(shù)中，調(diào)用kset_create_and_add接口，創(chuàng)建對應(yīng)的子系統(tǒng)，包括：

bus子系統(tǒng)，/sys/bus/，buses_init（drivers/base/bus.c）

class子系統(tǒng)，/sys/class

kernel子系統(tǒng)，/sys/kernel

firmware子系統(tǒng)，/sys/firmware

等等

其中bus子系統(tǒng)就是本文所講的Bus模塊，而其它的，我們會在后續(xù)的文章中陸續(xù)講述。這個(gè)方式和舊版本內(nèi)核使用kset_register接口的方式基本一樣。

方式二，在bus模塊中，利用subsys_register接口，封裝出兩個(gè)API：subsys_system_register和subsys_virtual_register，分別用于注冊system設(shè)備(/sys/devices/system/*)和virtual設(shè)備(/sys/devices/virtual/*)。 而該方式和方式一的區(qū)別是：它不僅僅創(chuàng)建了sysfs中的目錄，同時(shí)會注冊同名的bus和device。

4.2 system/virtual/platform

在Linux內(nèi)核中，有三種比較特殊的bus（或者是子系統(tǒng)），分別是system bus、virtual bus和platform bus。它們并不是一個(gè)實(shí)際存在的bus（像USB、I2C等），而是為了方便設(shè)備模型的抽象，而虛構(gòu)的。

system bus是舊版內(nèi)核提出的概念，用于抽象系統(tǒng)設(shè)備（如CPU、Timer等等）。而新版內(nèi)核認(rèn)為它是個(gè)壞點(diǎn)子，因?yàn)槿魏卧O(shè)備都應(yīng)歸屬于一個(gè)普通的子系統(tǒng)（New subsystems should use plain subsystems, drivers/base/bus.c, line 1264），所以就把它拋棄了（不建議再使用，它的存在只為兼容舊有的實(shí)現(xiàn)）。

virtaul bus是一個(gè)比較新的bus，主要用來抽象那些虛擬設(shè)備，所謂的虛擬設(shè)備，是指不是真實(shí)的硬件設(shè)備，而是用軟件模擬出來的設(shè)備，例如虛擬機(jī)中使用的虛擬的網(wǎng)絡(luò)設(shè)備（有關(guān)該bus的描述，可參考該鏈接處的解釋：https://lwn.net/Articles/326540/）。

platform bus就比較普通，它主要抽象集成在CPU（SOC）中的各種設(shè)備。這些設(shè)備直接和CPU連接，通過總線尋址和中斷的方式，和CPU交互信息。?

我們會在后續(xù)的文章中，進(jìn)一步分析這些特殊的bus，這里就暫時(shí)不詳細(xì)描述了。

4.3 subsys interface

subsys interface是一個(gè)很奇怪的東西，除非有一個(gè)例子，否則很難理解。代碼中是這樣注釋的：

Interfaces usually represent?a specific functionality of a subsystem/class of devices.

字面上理解，它抽象了bus下所有設(shè)備的一些特定功能。

kernel使用struct subsys_interface結(jié)構(gòu)抽象subsys interface，并提供了subsys_interface_register/subsys_interface_unregister用于注冊/注銷subsys interface，bus下所有的interface都掛載在struct subsys_private變量的“interface”鏈表上（具體可參考2.2小節(jié)的描述）。struct subsys_interface的定義如下：

/**

* struct subsys_interface - interfaces to device functions

* @name: name of the device function

* @subsys: subsytem of the devices to attach to

* @node: the list of functions registered at the subsystem

* @add_dev: device hookup to device function handler

* @remove_dev: device hookup to device function handler

*

* Simple interfaces attached to a subsystem. Multiple interfaces can

* attach to a subsystem and its devices. Unlike drivers, they do not

* exclusively claim or control devices. Interfaces usually represent

* a specific functionality of a subsystem/class of devices.

*/

struct subsys_interface {

const char *name;

struct bus_type *subsys;

struct list_head node;

int (*add_dev)(struct device *dev, struct subsys_interface *sif);

int (*remove_dev)(struct device *dev, struct subsys_interface *sif);

};

name，interface的名稱。

subsys，interface所屬的bus。

node，用于將interface掛到bus中。

add_dev/remove_dev，兩個(gè)回調(diào)函數(shù)，subsys interface的核心功能。當(dāng)bus下有設(shè)備增加或者刪除的時(shí)候，bus core會調(diào)用它下面所有subsys interface的add_dev或者remove_dev回調(diào)。設(shè)計(jì)者可以在這兩個(gè)回調(diào)函數(shù)中實(shí)現(xiàn)所需功能，例如綁定該“specific functionality”所對應(yīng)的driver，等等。

subsys interface的實(shí)現(xiàn)邏輯比較簡單，這里不再詳細(xì)描述了，具體可參考“drivers/base/bus.c”中相應(yīng)的代碼。另外，后續(xù)分析cpufreq framework的時(shí)候，會遇到使用subsys interface的例子，到時(shí)候我們再進(jìn)一步理解它的現(xiàn)實(shí)意義。

?