drivers/media/pci/b2c2/flexcop-dma.c

Source file repositories/reference/linux-study-clean/drivers/media/pci/b2c2/flexcop-dma.c

File Facts

System
Linux kernel
Corpus path
drivers/media/pci/b2c2/flexcop-dma.c
Extension
.c
Size
4020 bytes
Lines
159
Domain
Driver Families
Bucket
drivers/media
Inferred role
Driver Families: exported/initcall integration point
Status
integration implementation candidate

Why This File Exists

Repeatable hardware-adapter layer. Deep compatibility for every driver is out of scope; this atlas records patterns, probe lifecycles, bus glue, IRQ/DMA usage, and links back to core abstractions.

Dependency Surface

Detected Declarations

Annotated Snippet

// SPDX-License-Identifier: GPL-2.0
/*
 * Linux driver for digital TV devices equipped with B2C2 FlexcopII(b)/III
 * flexcop-dma.c - configuring and controlling the DMA of the FlexCop
 * see flexcop.c for copyright information
 */
#include "flexcop.h"

int flexcop_dma_allocate(struct pci_dev *pdev,
		struct flexcop_dma *dma, u32 size)
{
	u8 *tcpu;
	dma_addr_t tdma = 0;

	if (size % 2) {
		err("dma buffersize has to be even.");
		return -EINVAL;
	}

	tcpu = dma_alloc_coherent(&pdev->dev, size, &tdma, GFP_KERNEL);
	if (tcpu != NULL) {
		dma->pdev = pdev;
		dma->cpu_addr0 = tcpu;
		dma->dma_addr0 = tdma;
		dma->cpu_addr1 = tcpu + size/2;
		dma->dma_addr1 = tdma + size/2;
		dma->size = size/2;
		return 0;
	}
	return -ENOMEM;
}
EXPORT_SYMBOL(flexcop_dma_allocate);

void flexcop_dma_free(struct flexcop_dma *dma)
{
	dma_free_coherent(&dma->pdev->dev, dma->size * 2, dma->cpu_addr0,
			  dma->dma_addr0);
	memset(dma, 0, sizeof(struct flexcop_dma));
}
EXPORT_SYMBOL(flexcop_dma_free);

int flexcop_dma_config(struct flexcop_device *fc,
		struct flexcop_dma *dma,
		flexcop_dma_index_t dma_idx)
{
	flexcop_ibi_value v0x0, v0x4, v0xc;

	v0x0.raw = v0x4.raw = v0xc.raw = 0;
	v0x0.dma_0x0.dma_address0 = dma->dma_addr0 >> 2;
	v0xc.dma_0xc.dma_address1 = dma->dma_addr1 >> 2;
	v0x4.dma_0x4_write.dma_addr_size = dma->size / 4;

	if ((dma_idx & FC_DMA_1) == dma_idx) {
		fc->write_ibi_reg(fc, dma1_000, v0x0);
		fc->write_ibi_reg(fc, dma1_004, v0x4);
		fc->write_ibi_reg(fc, dma1_00c, v0xc);
	} else if ((dma_idx & FC_DMA_2) == dma_idx) {
		fc->write_ibi_reg(fc, dma2_010, v0x0);
		fc->write_ibi_reg(fc, dma2_014, v0x4);
		fc->write_ibi_reg(fc, dma2_01c, v0xc);
	} else {
		err("either DMA1 or DMA2 can be configured within one %s call.",
			__func__);
		return -EINVAL;
	}

	return 0;
}
EXPORT_SYMBOL(flexcop_dma_config);

/* start the DMA transfers, but not the DMA IRQs */
int flexcop_dma_xfer_control(struct flexcop_device *fc,
		flexcop_dma_index_t dma_idx,
		flexcop_dma_addr_index_t index,
		int onoff)
{
	flexcop_ibi_value v0x0, v0xc;
	flexcop_ibi_register r0x0, r0xc;

	if ((dma_idx & FC_DMA_1) == dma_idx) {
		r0x0 = dma1_000;
		r0xc = dma1_00c;
	} else if ((dma_idx & FC_DMA_2) == dma_idx) {
		r0x0 = dma2_010;
		r0xc = dma2_01c;
	} else {
		err("transfer DMA1 or DMA2 can be started within one %s call.",
			__func__);
		return -EINVAL;
	}

Annotation

Implementation Notes