static int __devinit s3cmci_probe(struct platform_device *pdev) { //该结构体定义在头文件中,现在实例一个名为host的结构体指针为结构体中的成员赋值做准备 struct s3cmci_host *host; //实例一个名为mmc的结构体指针,用于与Core核心层中的mmc_host结构体指针相关联 struct mmc_host *mmc; int ret; //初始化一个名为complete_lock的自旋锁以备后用,该自旋锁的定义在s3cmci_host结构体中 spin_lock_init(&host->complete_lock); //初始化一个名为pio_tasklet的tasklet,用于实现中断的底半部机制,底半部服务函数为pio_tasklet, //将host结构体变量作为服务函数的参数。注意:这里tasklet的变量名与服务函数名称同名了(这是可以的)。 tasklet_init(&host->pio_tasklet, pio_tasklet, (unsigned long) host);
//分配mmc_host结构体指针的内存空间大小,该函数在host.c中实现,这里要注意一点,为什么参数 //是s3cmci_host结构体的大小,到host.c中看,实际这里分配的是mmc_host加s3cmci_host的大小。 mmc = mmc_alloc_host(sizeof(struct s3cmci_host), &pdev->dev); if (!mmc) { ret = -ENOMEM; goto probe_out; }
//调用mmc_priv函数将mmc_host和s3cmci_host结构体的对象关联起来,mmc_priv定义在host.h中 host = mmc_priv(mmc); //下面就开始初始化s3cmci_host结构体的各成员 host->mmc = mmc; host->pdev = pdev;
host->pdata = pdev->dev.platform_data; //SDI主机控制器的中断屏蔽寄存器和数据寄存器,他们定义在mach-s3c2410/include/mach/regs-sdi.h中 host->sdiimsk = S3C2440_SDIIMSK; host->sdidata = S3C2440_SDIDATA; //complete_what定义在s3cmci_host结构体中,用来记录请求处理所处的当前状态,这里初始化为 //COMPLETION_NONE即无状态,定义在头文件的s3cmci_waitfor中,里面枚举了6种状态。 host->complete_what = COMPLETION_NONE; //pio_active定义在s3cmci_host结构体中,用来标记请求处理数据在FIFO方式下的数据方向是读还是写 host->pio_active = XFER_NONE; //dodma和dma方便用于标记是否要使用DMA数据传输方式和DMA通道资源,0表示不使用DMA功能 host->dodma = 0; host->dma = S3CMCI_DMA; //从SDI平台设备资源中获取SDI的IO端口资源,该资源在plat-s3c24xx/devs.c的s3c_sdi_resource中指定的 host->mem = platform_get_resource(pdev, IORESOURCE_MEM, 0); if (!host->mem) { dev_err(&pdev->dev, "failed to get io memory region resouce.\n"); ret = -ENOENT; goto probe_free_host; } //申请SDI的IO端口资源所占用的IO空间(要注意理解IO空间和内存空间的区别) host->mem = request_mem_region(host->mem->start, RESSIZE(host->mem), pdev->name); if (!host->mem) { dev_err(&pdev->dev, "failed to request io memory region.\n"); ret = -ENOENT; goto probe_free_host; }
//将SDI的IO端口占用的这段IO空间映射到内存的虚拟地址,ioremap定义在io.h中。 //注意:IO空间要映射后才能使用,以后对虚拟地址的操作就是对IO空间的操作。 host->base = ioremap(host->mem->start, RESSIZE(host->mem)); if (!host->base) { dev_err(&pdev->dev, "failed to ioremap() io memory region.\n"); ret = -EINVAL; goto probe_free_mem_region; }
//同样从SDI平台设备资源中获取SDI的中断号 host->irq = platform_get_irq(pdev, 0); if (host->irq == 0) { dev_err(&pdev->dev, "failed to get interrupt resouce.\n"); ret = -EINVAL; goto probe_iounmap; }
//申请SDI的中断服务,服务函数为s3cmci_irq,主要参数为host if (request_irq(host->irq, s3cmci_irq, 0, DRIVER_NAME, host)) { dev_err(&pdev->dev, "failed to request mci interrupt.\n"); ret = -ENOENT; goto probe_iounmap; }
//在SDI未准备好之前先屏蔽SDI的中断功能 disable_irq(host->irq);
//根据开发板原理图分别设置GPG8、GPH8端口为SD卡插入拔出的检测和有无写保护的检查,
//注意:其实有没有写保护就是检查SD卡侧面有个移动按钮的开关,MMC卡无此功能
host->pdata->gpio_detect = S3C2410_GPG8;
host->pdata->gpio_wprotect = S3C2410_GPH8;
//获取GPG8复用端口中断功能的中断号 host->irq_cd = s3c2410_gpio_getirq(host->pdata->gpio_detect); //GPG8是复用端口,要使用中断功能则要配置成中断功能,GPG8对应的中断功能是外部中断EINT16,这个数据手册上有讲到 s3c2410_gpio_cfgpin(S3C2410_GPG8, S3C2410_GPG8_EINT16);
//申请SDI的卡检测中断服务,服务函数为s3cmci_irq_cd,主要参数也为host if (request_irq(host->irq_cd, s3cmci_irq_cd, IRQF_TRIGGER_RISING | IRQF_TRIGGER_FALLING, DRIVER_NAME, host)) { dev_err(&pdev->dev, "can't get card detect irq.\n"); ret = -ENOENT; goto probe_free_irq; }
//获取DMA通道并申请DMA中断,S3C2440中DMA的使用在后续的文章中再了解 if (s3c2410_dma_request(S3CMCI_DMA, &s3cmci_dma_client, NULL) < 0) { dev_err(&pdev->dev, "unable to get DMA channel.\n"); ret = -EBUSY; goto probe_free_irq_cd; }
//从平台时钟队列中获取SDI的时钟源,在arch/arm/plat-s3c24xx/s3c2410-clock.c中有定义 host->clk = clk_get(&pdev->dev, "sdi"); if (IS_ERR(host->clk)) { dev_err(&pdev->dev, "failed to find clock source.\n"); ret = PTR_ERR(host->clk); host->clk = NULL; goto probe_free_host; }
//启动获取的时钟源 ret = clk_enable(host->clk); if (ret) { dev_err(&pdev->dev, "failed to enable clock source.\n"); goto clk_free; }
//通过SDI的时钟源获取CPU的PCLK频率,这里为什么要获得CPU的PCLK频率呢, //通过数据手册SDI控制器的方框图得知,SDI的时钟频率(SDCLK)=PCLK/(Prescaler+1) host->clk_rate = clk_get_rate(host->clk); host->clk_div = 1;//设置预分频值,即:Prescaler的值 //下面对mmc_host进行初始化 mmc->ops = &s3cmci_ops; //SDI主机控制器操作结构体 mmc->ocr_avail = MMC_VDD_32_33 | MMC_VDD_33_34; //设置工作电压范围 mmc->caps = MMC_CAP_4_BIT_DATA; //设置总线宽度为4位 mmc->f_min = host->clk_rate / (host->clk_div * 256); //设置最小工作频率 mmc->f_max = host->clk_rate / host->clk_div; //设置最大工作频率 mmc->max_blk_count = 4095; mmc->max_blk_size = 4095; mmc->max_req_size = 4095 * 512; mmc->max_seg_size = mmc->max_req_size; mmc->max_phys_segs = 128; mmc->max_hw_segs = 128;
//Linux的通知链机制,实现到后面再讲 ret = s3cmci_cpufreq_register(host); if (ret) { dev_err(&pdev->dev, "failed to register cpufreq\n"); goto free_dmabuf; }
//将SDI host设备注册到系统中 ret = mmc_add_host(mmc); if (ret) { dev_err(&pdev->dev, "failed to add mmc host.\n"); goto free_cpufreq; }
//将SDI host设备的数据赋值给系统平台设备 platform_set_drvdata(pdev, mmc);
return 0;
//以下是错误处理 free_cpufreq: s3cmci_cpufreq_deregister(host);
free_dmabuf: clk_disable(host->clk);
clk_free: clk_put(host->clk);
probe_free_irq_cd: if (host->irq_cd >= 0) free_irq(host->irq_cd, host);
probe_free_irq: free_irq(host->irq, host);
probe_iounmap: iounmap(host->base);
probe_free_mem_region: release_mem_region(host->mem->start, RESSIZE(host->mem));
probe_free_host: mmc_free_host(mmc); probe_out: return ret; }
|