4.1 ipu_common.c分析---入口函数及probe函数分析

这个ipu_common.c函数提供ipu底层函数调用的一些关系和函数。

（一）分析这个文件从init函数入口，发现有这个subsys_initcall，说明ipu是作为一个子系统注册到内核中的：

int32_t __init ipu_gen_init(void) 
{ 
	int32_t ret; 

	ret = platform_driver_register(&mxcipu_driver); 
	return 0; 
} 

subsys_initcall(ipu_gen_init);

（二）这个mxcipu_driver结构体注册到平台以后，如果有匹配的设备的话，就会调用其中的probe函

static int ipu_probe(struct platform_device *pdev) 
{ 
	struct ipu_soc *ipu; 
	struct resource *res; 
	unsigned long ipu_base; 
	const struct of_device_id *of_id = 
			of_match_device(imx_ipuv3_dt_ids, &pdev->dev); 
	const struct ipu_platform_type *iputype = of_id->data; 
	const struct ipu_devtype *devtype = &iputype->devtype; 
	int ret = 0, id; 
	u32 bypass_reset, reg; 

/*以imx6qp为例（后面本文件中如果有涉及到板子的一些资源，都以imx6qp为例），

*iputype= of_id->data，这个of_id返回的是imx_ipuv3_dt_ids[]数组中的某一项，

static const struct of_device_id imx_ipuv3_dt_ids[] = { 
	{ .compatible = "fsl,imx51-ipu", .data = &ipu_type_imx51, }, 
	{ .compatible = "fsl,imx53-ipu", .data = &ipu_type_imx53, }, 
	{ .compatible = "fsl,imx6q-ipu", .data = &ipu_type_imx6q, }, 
	{ .compatible = "fsl,imx6qp-ipu", .data = &ipu_type_imx6qp, }, 
	{ /* sentinel */ } 
}; 
MODULE_DEVICE_TABLE(of, imx_ipuv3_dt_ids);

在本文件中就是{.compatible = "fsl,imx6qp-ipu", .data = &ipu_type_imx6qp,}这一项。所以：

*iputype= &ipu_type_imx6qp，

*devtype= 下面标红的部分：

static struct ipu_platform_type ipu_type_imx6qp = { 
	<span style="color:#FF0000;">.devtype = { 
		.name = "IPUv3H", 
		.cm_ofs =	0x00200000, 
		.idmac_ofs =	0x00208000, 
		.ic_ofs =	0x00220000, 
		.csi0_ofs =	0x00230000, 
		.csi1_ofs =	0x00238000, 
		.di0_ofs =	0x00240000, 
		.di1_ofs =	0x00248000, 
		.smfc_ofs =	0x00250000, 
		.dc_ofs =	0x00258000, 
		.dmfc_ofs =	0x00260000, 
		.vdi_ofs =	0x00268000, 
		.cpmem_ofs =	0x00300000, 
		.srm_ofs =	0x00340000, 
		.tpm_ofs =	0x00360000, 
		.dc_tmpl_ofs =	0x00380000, 
		.type =		IPUv3H, 
		.idmac_used_bufs_present = true, 
	}, </span>
	.ch0123_axi = 0, 
	.ch23_axi = 0, 
	.ch27_axi = 2, 
	.ch28_axi = 3, 
	.normal_axi = 1, 
	.idmac_used_bufs_en_r = true, 
	.idmac_used_bufs_en_w = true, 
	.idmac_used_bufs_max_r = 0x3, 
	.idmac_used_bufs_max_w = 0x3, 
	.smfc_idmac_12bit_3planar_bs_fixup = true, 
 };

*/

	dev_dbg(&pdev->dev, "<%s>\n", __func__); 

	ret = of_property_read_u32(pdev->dev.of_node, 
					"bypass_reset", &bypass_reset); 
	if (ret < 0) { 
		dev_dbg(&pdev->dev, "can not get bypass_reset\n"); 
		return ret; 
	} 

/*从pdev->dev.of_node这个devicenode结构体里面读取“bypass_reset”这一项，将读出的结果存在&bypass_reset中。*/

	id = of_alias_get_id(pdev->dev.of_node, "ipu"); 
	if (id < 0) { 
		dev_dbg(&pdev->dev, "can not get alias id\n"); 
		return id; 
	} 

/*这个of_alias_get_id函数的大致意思是根据名字“ipu”获取到它的id，将这个id返回。但是有两个ipu呢，这个怎么选择？？如果根据名字的话，怎么区分这两个ipu？*/

	ipu = &ipu_array[id]; 
	memset(ipu, 0, sizeof(struct ipu_soc)); 
	ipu->bypass_reset = (bool)bypass_reset; 
	ipu->dev = &pdev->dev; 
	ipu->id = id; 
	ipu->devtype = devtype->type; 
	ipu->ch0123_axi = iputype->ch0123_axi; 
	ipu->ch23_axi = iputype->ch23_axi; 
	ipu->ch27_axi = iputype->ch27_axi; 
	ipu->ch28_axi = iputype->ch28_axi; 
	ipu->normal_axi = iputype->normal_axi; 
	ipu->smfc_idmac_12bit_3planar_bs_fixup = 
			iputype->smfc_idmac_12bit_3planar_bs_fixup; 
	spin_lock_init(&ipu->int_reg_spin_lock); 
	spin_lock_init(&ipu->rdy_reg_spin_lock); 
	mutex_init(&ipu->mutex_lock); 

/*这一些就是根据上面获取到的信息来填充这个structipu_soc *ipu结构体。*/

	dev_dbg(&pdev->dev, "revision is %s\n", devtype->name); 

	ipu->irq_sync = platform_get_irq(pdev, 0); 
	ipu->irq_err = platform_get_irq(pdev, 1); 
	res = platform_get_resource(pdev, IORESOURCE_MEM, 0); 

	if (!res || ipu->irq_sync < 0 || ipu->irq_err < 0) { 
		dev_err(&pdev->dev, "can't get device resources\n"); 
		return -ENODEV; 
	} 

/*获取irq资源和内存资源。*/

	if (!devm_request_mem_region(&pdev->dev, res->start, 
				     resource_size(res), pdev->name)) 
		return -EBUSY; 

/*申请I/O内存资源，申请后还需要通过ioremap等函数映射后才能够使用。*/

	ret = devm_request_irq(&pdev->dev, ipu->irq_sync, 
			ipu_sync_irq_handler, 0, pdev->name, ipu); 
	if (ret) { 
		dev_err(ipu->dev, "request SYNC interrupt failed\n"); 
		return ret; 
	} 
	ret = devm_request_irq(&pdev->dev, ipu->irq_err, 
			ipu_err_irq_handler, 0, pdev->name, ipu); 
	if (ret) { 
		dev_err(ipu->dev, "request ERR interrupt failed\n"); 
		return ret; 
	} 

/*为上面获取到的irq资源注册中断服务函数。*/

	ipu_base = res->start; //ipu地址的初始值。

	ipu->cm_reg = devm_ioremap(&pdev->dev, 
				ipu_base + devtype->cm_ofs, PAGE_SIZE); 
	ipu->ic_reg = devm_ioremap(&pdev->dev, 
				ipu_base + devtype->ic_ofs, PAGE_SIZE); 
	ipu->idmac_reg = devm_ioremap(&pdev->dev, 
				ipu_base + devtype->idmac_ofs, PAGE_SIZE); 
	/* DP Registers are accessed thru the SRM */ 
	ipu->dp_reg = devm_ioremap(&pdev->dev, 
				ipu_base + devtype->srm_ofs, PAGE_SIZE); 
	ipu->dc_reg = devm_ioremap(&pdev->dev, 
				ipu_base + devtype->dc_ofs, PAGE_SIZE); 
	ipu->dmfc_reg = devm_ioremap(&pdev->dev, 
				ipu_base + devtype->dmfc_ofs, PAGE_SIZE); 
	ipu->di_reg[0] = devm_ioremap(&pdev->dev, 
				ipu_base + devtype->di0_ofs, PAGE_SIZE); 
	ipu->di_reg[1] = devm_ioremap(&pdev->dev, 
				ipu_base + devtype->di1_ofs, PAGE_SIZE); 
	ipu->smfc_reg = devm_ioremap(&pdev->dev, 
				ipu_base + devtype->smfc_ofs, PAGE_SIZE); 
	ipu->csi_reg[0] = devm_ioremap(&pdev->dev, 
				ipu_base + devtype->csi0_ofs, PAGE_SIZE); 
	ipu->csi_reg[1] = devm_ioremap(&pdev->dev, 
				ipu_base + devtype->csi1_ofs, PAGE_SIZE); 
	ipu->cpmem_base = devm_ioremap(&pdev->dev, 
				ipu_base + devtype->cpmem_ofs, SZ_128K); 
	ipu->tpmem_base = devm_ioremap(&pdev->dev, 
				ipu_base + devtype->tpm_ofs, SZ_64K); 
	ipu->dc_tmpl_reg = devm_ioremap(&pdev->dev, 
				ipu_base + devtype->dc_tmpl_ofs, SZ_128K); 
	ipu->vdi_reg = devm_ioremap(&pdev->dev, 
				ipu_base + devtype->vdi_ofs, PAGE_SIZE); 
	if (!ipu->cm_reg || !ipu->ic_reg || !ipu->idmac_reg || 
		!ipu->dp_reg || !ipu->dc_reg || !ipu->dmfc_reg || 
		!ipu->di_reg[0] || !ipu->di_reg[1] || !ipu->smfc_reg || 
		!ipu->csi_reg[0] || !ipu->csi_reg[1] || !ipu->cpmem_base || 
		!ipu->tpmem_base || !ipu->dc_tmpl_reg || !ipu->vdi_reg) 
		return -ENOMEM; 

	dev_dbg(ipu->dev, "IPU CM Regs = %p\n", ipu->cm_reg); 
	dev_dbg(ipu->dev, "IPU IC Regs = %p\n", ipu->ic_reg); 
	dev_dbg(ipu->dev, "IPU IDMAC Regs = %p\n", ipu->idmac_reg); 
	dev_dbg(ipu->dev, "IPU DP Regs = %p\n", ipu->dp_reg); 
	dev_dbg(ipu->dev, "IPU DC Regs = %p\n", ipu->dc_reg); 
	dev_dbg(ipu->dev, "IPU DMFC Regs = %p\n", ipu->dmfc_reg); 
	dev_dbg(ipu->dev, "IPU DI0 Regs = %p\n", ipu->di_reg[0]); 
	dev_dbg(ipu->dev, "IPU DI1 Regs = %p\n", ipu->di_reg[1]); 
	dev_dbg(ipu->dev, "IPU SMFC Regs = %p\n", ipu->smfc_reg); 
	dev_dbg(ipu->dev, "IPU CSI0 Regs = %p\n", ipu->csi_reg[0]); 
	dev_dbg(ipu->dev, "IPU CSI1 Regs = %p\n", ipu->csi_reg[1]); 
	dev_dbg(ipu->dev, "IPU CPMem = %p\n", ipu->cpmem_base); 
	dev_dbg(ipu->dev, "IPU TPMem = %p\n", ipu->tpmem_base); 
	dev_dbg(ipu->dev, "IPU DC Template Mem = %p\n", ipu->dc_tmpl_reg); 
	dev_dbg(ipu->dev, "IPU VDI Regs = %p\n", ipu->vdi_reg); 

/*根据获取到的资源来为每个寄存器映射内存空间。*/

	ipu->ipu_clk = devm_clk_get(ipu->dev, "bus"); 
	if (IS_ERR(ipu->ipu_clk)) { 
		dev_err(ipu->dev, "clk_get ipu failed"); 
		return PTR_ERR(ipu->ipu_clk); 
	} 

/*获取"bus"的时钟。*/

	/* ipu_clk is always prepared */ 
	ret = clk_prepare_enable(ipu->ipu_clk); 
	if (ret < 0) { 
		dev_err(ipu->dev, "ipu clk enable failed\n"); 
		return ret; 
	} 

/*这个函数是clk_prepare和clk_enable两个函数的集合，其中clk_prepare函数是个预定义的函数，需要定义CONFIG_HAVE_CLK_PREPARE这个宏，然后就是调用clk_enable函数来使能时钟。*/

	ipu->prg_clk = devm_clk_get(ipu->dev, "prg"); 
	if (IS_ERR(ipu->prg_clk)) 
		ipu->prg_clk = NULL; 

/*获取"prg"的时钟。*/

	ipu->online = true; 

/*这个online是一个bool类型的变量，表示当前这个ipu是否正在使用中。*/

	platform_set_drvdata(pdev, ipu); 

/*设置私有数据。*/

/*下面这个bypass_reset参数在前面通过of_property_read_u32函数获得了，从dts文件中可以看到它等于0.同时在structipu_soc中关于这个bypass_reset有这样的注释：Bypassreset to avoid display channel being stopped by probe since it maystarts to work inbootloader.这个值是从dts文件中获得的bypass_reset，因为在开发板启动过程中，需要使能屏幕来显示，所以显示通道可能已将在bootloader中开启了，在这里设置这个值，使得显示通道在probe函数中不会关闭，也就是这个参数的含义（旁路）。*/

	if (!bypass_reset) { 
		ret = device_reset(&pdev->dev); 
		if (ret) { 
			dev_err(&pdev->dev, "failed to reset: %d\n", ret); 
			return ret; 
		} 

		ipu_mem_reset(ipu); 

		ipu_disp_init(ipu); 

		/* Set MCU_T to divide MCU access window into 2 */ 
		ipu_cm_write(ipu, 0x00400000L | (IPU_MCU_T_DEFAULT << 18), 
			     IPU_DISP_GEN); 
	} 

/*这个ipu_mem_reset函数同样在这个文件中，如下所示：

static int ipu_mem_reset(struct ipu_soc *ipu) 
{ 
	int timeout = 1000; 

	ipu_cm_write(ipu, 0x807FFFFF, IPU_MEM_RST); 

	while (ipu_cm_read(ipu, IPU_MEM_RST) & 0x80000000) { 
		if (!timeout--) 
			return -ETIME; 
		msleep(1); 
	} 

	return 0; 
}

这个ipu_disp_init函数同样在ipu_common.c文件中，如下所示：

void ipu_disp_init(struct ipu_soc *ipu) 
{ 
	ipu->fg_csc_type = ipu->bg_csc_type = CSC_NONE; 
	ipu->color_key_4rgb = true; 
	_ipu_init_dc_mappings(ipu); 
	_ipu_dmfc_init(ipu, DMFC_NORMAL, 1); 
}

最后通过ipu_cm_write函数来设置有关显示的一些寄存器。

*/

	/* setup ipu clk tree after ipu reset  */ 
	ret = ipu_clk_setup_enable(ipu); 
	if (ret < 0) { 
		dev_err(ipu->dev, "ipu clk setup failed\n"); 
		ipu->online = false; 
		return ret; 
	} 

/*然后调用ipu_clk_setup_enable函数设置时钟树，这个函数也在这个ipu_common.c文件中，在后面分析。*/

	if (devtype->idmac_used_bufs_present) { 
/* devtype->idmac_used_bufs_present = true。 */
		reg = ipu_idmac_read(ipu, IDMAC_CONF); 
		if (iputype->idmac_used_bufs_en_r) //idmac_used_bufs_en_r = true
			reg |= IDMAC_CONF_USED_BUFS_EN_R; 
		else 
			reg &= ~IDMAC_CONF_USED_BUFS_EN_R; 
		if (iputype->idmac_used_bufs_en_w) //idmac_used_bufs_en_w = true
			reg |= IDMAC_CONF_USED_BUFS_EN_W; 
		else 
			reg &= ~IDMAC_CONF_USED_BUFS_EN_W; 

		reg &= ~IDMAC_CONF_USED_BUFS_MAX_R_MASK; 
		reg |= (iputype->idmac_used_bufs_max_r << 
			IDMAC_CONF_USED_BUFS_MAX_R_OFFSET); 
		reg &= ~IDMAC_CONF_USED_BUFS_MAX_W_MASK; 
		reg |= (iputype->idmac_used_bufs_max_w << 
			IDMAC_CONF_USED_BUFS_MAX_W_OFFSET); 
/* idmac_used_bufs_max_r = 0x3，
   idmac_used_bufs_max_w = 0x3。 */
		ipu_idmac_write(ipu, reg, IDMAC_CONF); 
	} 

/*上面这段代码先通过ipu_idmac_read函数来读取IDMAC_CONF寄存器的值，然后根据iputype的一些信息设置它们在寄存器中对应的值，最后将新值通过ipu_idmac_write函数重新写入寄存器中。这个函数用来配置IDMAC。*/

	/* Set sync refresh channels and CSI->mem channel as high priority */ 
	ipu_idmac_write(ipu, 0x18800003L, IDMAC_CHA_PRI(0)); 

/*通过设置IDMAC_CHA_PRI(0)寄存器，将syncrefresh channels 和CSI->memchannel的设为高优先级*/

	/* Enable error interrupts by default */ 
	ipu_cm_write(ipu, 0xFFFFFFFF, IPU_INT_CTRL(5)); 
	ipu_cm_write(ipu, 0xFFFFFFFF, IPU_INT_CTRL(6)); 
	ipu_cm_write(ipu, 0xFFFFFFFF, IPU_INT_CTRL(9)); 
	ipu_cm_write(ipu, 0xFFFFFFFF, IPU_INT_CTRL(10)); 

/*将IPU_INT_CTRL(5)，IPU_INT_CTRL(6)，IPU_INT_CTRL(9)，IPU_INT_CTRL(10)这几个寄存器设置为默认值0xFFFFFFFF，这几个寄存器应该是错误中断使能的寄存器。*/

	if (!bypass_reset) 
		clk_disable(ipu->ipu_clk); 

/*同样是这个bypass_reset参数，暂时不知道它是多少。*/

	register_ipu_device(ipu, id); 

/*注册ipu_device设备，这个函数在ipu_device.c文件中*/

	pm_runtime_enable(&pdev->dev); 

/*使能设备的电源管理*/

	return ret; 
}<span style="font-family:Courier 10 Pitch;"><span style="font-size:12px;"></span></span>