camera host的驱动
下面开始分析camera host吧，如果仅仅是想知道camera sensor驱动怎么写，而不想知道内部具体怎么个调用流程，怎么个架构设计，那可以跳过该部分，直接去看i2c camera sensor的驱动了。前面说了我们选择at91平台，那对应的camera host 文件就是drivers/media/platform/soc_camera/atmel-isi.c了。
static struct platform_driver atmel_isi_driver = {
.remove = atmel_isi_remove,
.driver = {
.name = "atmel_isi",
.owner = THIS_MODULE,
},
};
module_platform_driver_probe(atmel_isi_driver, atmel_isi_probe);
直接看atmel_isi_probe吧，它怎么和它对应的平台设备匹配的过程就不再描述了，和上面说的类似，具体实现在文件arch/arm/mach-at91/at91sam9g45_devices.c里。
atmel_isi_probe里面有一部分会设计到该soc isi(camera host)的硬件初始化，我这里不跟踪进去，只是将和camera sensor驱动相关的代码摘取出来：
static int atmel_isi_probe(struct platform_device *pdev)
{
unsigned int irq;
struct atmel_isi *isi;
struct resource *regs;
int ret, i;
struct device *dev = &pdev->dev;
struct soc_camera_host *soc_host;
struct isi_platform_data *pdata;
.....
.....
.....
soc_host = &isi->soc_host;
soc_host->drv_name = "isi-camera";
soc_host->ops = &isi_soc_camera_host_ops;
soc_host->priv = isi;
soc_host->v4l2_dev.dev = &pdev->dev;
soc_host->nr = pdev->id;
ret = soc_camera_host_register(soc_host);
if (ret) {
dev_err(&pdev->dev, "Unable to register soc camera host\n");
goto err_register_soc_camera_host;
}
return 0;
.....
.....
.....
return ret;
}
这里我们会开始接触第三个重要的数据结构soc_camera_host，他在内核里代表的就是一个camera host设备。另外，第四个重要的数据结构soc_camera_host_ops，它是soc_camera架构为camera host定义的，用来实现所有host相关的操作回调。soc_camera在适当的时候，会调用里面的接口。camera host驱动主要工作的一部分就是实现该数据结构了。里面有一句soc_host->v4l2_dev.dev= &pdev->dev;表示soc_camera_host内嵌的v4l2框架定义的父对象（子对象v4l2_subdev，后面会出现的）对应的设备就是该camera host平台设备。将soc_camera_host进行适当的初始化后，再调用soc_camera架构定义的api soc_camera_host_register来实现camera host的注册。也就是在这里，会处理上面soc_camera_device_register注册进系统的camera sensor了。它里面核心的动作主要有两个
第一个，ret = v4l2_device_register(ici->v4l2_dev.dev, &ici->v4l2_dev)，这是v4l2框架给出的api，camera host在v4l2架构里面应该算是一个v4l2_device，camera里面的sensor控制部分，即i2c设备对应就应该是v4l2_subdev了。
第二个，scan_add_host(ici)，就是这个函数完成了对soc_camera_device_register注册进系统的camera的扫描及处理。
static void scan_add_host(struct soc_camera_host *ici)
{
struct soc_camera_device *icd;
mutex_lock(&list_lock);
list_for_each_entry(icd, &devices, list)
if (icd->iface == ici->nr) {
struct soc_camera_desc *sdesc = to_soc_camera_desc(icd);
struct soc_camera_subdev_desc *ssdd = &sdesc->subdev_desc;
/* The camera could have been already on, try to reset */
if (ssdd->reset)
ssdd->reset(icd->pdev);
icd->parent = ici->v4l2_dev.dev;
/* Ignore errors */
soc_camera_probe(ici, icd);
}
mutex_unlock(&list_lock);
}
它主要就是扫描devices全局链表，找里面icd->iface和自己的nr相同的。这里的icd->iface其实就是在soc_camera_link里面的bus_id，而nr对应着camera host平台设备描述信息里面的id。这里找到匹配的设备后，就调用soc_camera_probe(ici, icd)来处理挂载在该总线上的设备了。传入的两个参数ici，是我们camera host驱动分配并初始化的数据结构，由camera host负责初始化它里面的v4l2_dev以及ops等等，而icd是通用驱动soc_camera分配并根据我们在扳级相关的文件里面用soc_camera_link描述的信息初始化的对象。另外，还一个需要注意的地方，icd->parent = ici->v4l2_dev.dev;这里指定icd，也就是soc camera的parent为camera host，ici->v4l2_dev.dev就代表着camera host platform device对应的device，不信请回到atmel_isi_probe，里面有一句soc_host->v4l2_dev.dev = &pdev->dev;可以证实啦。这其实很好理解啦，camera host 当然就应该是camera的parent，对吧！
到这里，host driver就开始正式的访问那些之前就注册到全局链表devices里面camera了（icd）。分析之前，可以想象一下，它会做什么事情呢？我觉得怎么也得将扳级相关的文件里面用soc_camera_link的board_info对应的i2c控制部分给处理了吧，也就是找到对应用i2c控制的sensor driver。还有就是将该icd加入到host管理数据结构里啦，然后创建一个导出给应用层的设备节点，让对该设备节点的操作能够最终转到host或者sensor driver提供的ops里。下面正式开始分析吧，验证下对不对。这里直接将说明插入到代码中：
/* Called during host-driver probe */
static int soc_camera_probe(struct soc_camera_host *ici,
struct soc_camera_device *icd)
{
struct soc_camera_desc *sdesc = to_soc_camera_desc(icd);//拿到扳级相关的文件里面用soc_camera_link信息，和我们预想一样 果然是要开始处理它了
struct soc_camera_host_desc *shd = &sdesc->host_desc;//同上
struct device *control = NULL;
int ret;
dev_info(icd->pdev, "Probing %s\n", dev_name(icd->pdev));
/*
* Currently the subdev with the largest number of controls (13) is
* ov6550. So let's pick 16 as a hint for the control handler. Note
* that this is a hint only: too large and you waste some memory, too
* small and there is a (very) small performance hit when looking up
* controls in the internal hash.
*/
ret = v4l2_ctrl_handler_init(&icd->ctrl_handler, 16);//v4l2_ctrl是v4l2框架提供的一种ioctl处理机制，我们只需要知道它这里主要是服务于sensor驱动，让sensor驱动里的一些ioctl控制能够注入到导出给应用层ioctl的里面，这样，应用层调用相关的ioctl，最终会有一部分进入到sensor驱动里面
if (ret < 0)
return ret;
/* Must have icd->vdev before registering the device */
ret = video_dev_create(icd);//这也是v4l2框架提供的api，用于创建一个导出给应用层操作的设备文件（这里仅仅是初始化对应的数据结构），一个camera设备对应一个设备文件导出，这个很容易理解吧
if (ret < 0)
goto evdc;
/*
* ..._video_start() will create a device node, video_register_device()
* itself is protected against concurrent open() calls, but we also have
* to protect our data also during client probing.
*/
/* Non-i2c cameras, e.g., soc_camera_platform, have no board_info */
if (shd->board_info) {//我只分析这种情况，后面会详细分析soc_camera_i2c_init
ret = soc_camera_i2c_init(icd, sdesc);
if (ret < 0 && ret != -EPROBE_DEFER)
goto eadd;
} else if (!shd->add_device || !shd->del_device) {
ret = -EINVAL;
goto eadd;
} else {
mutex_lock(&ici->clk_lock);
ret = ici->ops->clock_start(ici);
mutex_unlock(&ici->clk_lock);
if (ret < 0)
goto eadd;
if (shd->module_name)
ret = request_module(shd->module_name);
ret = shd->add_device(icd);
if (ret < 0)
goto eadddev;
/*
* FIXME: this is racy, have to use driver-binding notification,
* when it is available
*/
control = to_soc_camera_control(icd);
if (!control || !control->driver || !dev_get_drvdata(control) ||
!try_module_get(control->driver->owner)) {
shd->del_device(icd);
ret = -ENODEV;
goto enodrv;
}
}
mutex_lock(&ici->host_lock);
ret = soc_camera_probe_finish(icd);//一切都准备好后，就可以正式添加video_device到系统来导出给应用层使用了，后面也会对该函数进一步分析
mutex_unlock(&ici->host_lock);
if (ret < 0)
goto efinish;
return 0;
efinish:
if (shd->board_info) {
soc_camera_i2c_free(icd);
} else {
shd->del_device(icd);
module_put(control->driver->owner);
enodrv:
eadddev:
mutex_lock(&ici->clk_lock);
ici->ops->clock_stop(ici);
mutex_unlock(&ici->clk_lock);
}
eadd:
video_device_release(icd->vdev);
icd->vdev = NULL;
if (icd->vdev) {
video_device_release(icd->vdev);
icd->vdev = NULL;
}
evdc:
v4l2_ctrl_handler_free(&icd->ctrl_handler);
return ret;
}
下面重点分析soc_camera_i2c_init，它才是处理board_info的函数。还是直接将说明插入到代码中：
static int soc_camera_i2c_init(struct soc_camera_device *icd,
struct soc_camera_desc *sdesc)
{
struct soc_camera_subdev_desc *ssdd;
struct i2c_client *client;
struct soc_camera_host *ici;
struct soc_camera_host_desc *shd = &sdesc->host_desc;
struct i2c_adapter *adap;
struct v4l2_subdev *subdev;
char clk_name[V4L2_SUBDEV_NAME_SIZE];
int ret;
/* First find out how we link the main client */
if (icd->sasc) {
/* Async non-OF probing handled by the subdevice list */
return -EPROBE_DEFER;
}
ici = to_soc_camera_host(icd->parent);//前面说了,icd的parent当然就是host对应的device，而该device里面的driver data部分早就被设置为v4l2_device了(详情请看v4l2_device_register)，前面也说了v4l2_device在v4l2框架里就代表着老大，i2c sensor对应的就是v4l2_subdev，代表着小弟。to_soc_camera_host里面通过container_of从v4l2_device找到ici
adap = i2c_get_adapter(shd->i2c_adapter_id);//通过扳级相关文件里指定的i2c_adapter_id寻找该i2c host对应的数据结构，i2c驱动框架就不多说了，原理也差不多
if (!adap) {
dev_err(icd->pdev, "Cannot get I2C adapter #%d. No driver?\n",
shd->i2c_adapter_id);
return -ENODEV;
}
ssdd = kzalloc(sizeof(*ssdd), GFP_KERNEL);
if (!ssdd) {
ret = -ENOMEM;
goto ealloc;
}
memcpy(ssdd, &sdesc->subdev_desc, sizeof(*ssdd));
/*
* In synchronous case we request regulators ourselves in
* soc_camera_pdrv_probe(), make sure the subdevice driver doesn't try
* to allocate them again.
*/
ssdd->sd_pdata.num_regulators = 0;
ssdd->sd_pdata.regulators = NULL;
shd->board_info->platform_data = ssdd;
snprintf(clk_name, sizeof(clk_name), "%d-%04x",
shd->i2c_adapter_id, shd->board_info->addr);
icd->clk = v4l2_clk_register(&soc_camera_clk_ops, clk_name, "mclk", icd);//注册一个v4l2_clk，i2c sensor驱动里会请求这个clk，操作集里的函数最终将定向到ici的操作集合里的函数中，也就是camera host实现的操作集中去
if (IS_ERR(icd->clk)) {
ret = PTR_ERR(icd->clk);
goto eclkreg;
}
subdev = v4l2_i2c_new_subdev_board(&ici->v4l2_dev, adap,
shd->board_info, NULL);//这里面就是处理i2c sensor了，后面会详细分析
if (!subdev) {
ret = -ENODEV;
goto ei2cnd;
}
client = v4l2_get_subdevdata(subdev);
/* Use to_i2c_client(dev) to recover the i2c client */
icd->control = &client->dev;
return 0;
ei2cnd:
v4l2_clk_unregister(icd->clk);
icd->clk = NULL;
eclkreg:
kfree(ssdd);
ealloc:
i2c_put_adapter(adap);
return ret;
}
未完，待续！
2015年6月