22  * Generic Interface (GENI) Serial Engine (SE) Wrapper driver is introduced
23  * to manage GENI firmware based Qualcomm Universal Peripheral (QUP) Wrapper
24  * controller. QUP Wrapper is designed to support various serial bus protocols
42  *                      |QUP Wrapper                              |
58  *                         Figure 1: GENI based QUP Wrapper
70  * GENI SE Wrapper driver is structured into 2 parts:
72  * geni_wrapper represents QUP Wrapper controller. This part of the driver
73  * manages QUP Wrapper information such as hardware version, clock
77  * engine information such as clocks, containing QUP Wrapper, etc. This part
87  * struct geni_wrapper - Data structure to represent the QUP Wrapper Core
88  * @dev:		Device pointer of the QUP wrapper core
89  * @base:		Base address of this instance of QUP wrapper core
102  * struct geni_se_desc - Data structure to represent the QUP Wrapper resources
191  * geni_se_get_qup_hw_version() - Read the QUP wrapper Hardware version
194  * Return: Hardware Version of the wrapper.
198 	struct geni_wrapper *wrapper = se->wrapper;  in geni_se_get_qup_hw_version()  local
200 	return readl_relaxed(wrapper->base + QUP_HW_VER_REG);  in geni_se_get_qup_hw_version()
488 	struct geni_wrapper *wrapper = se->wrapper;  in geni_se_clks_off()  local
491 	clk_bulk_disable_unprepare(wrapper->num_clks, wrapper->clks);  in geni_se_clks_off()
520 	struct geni_wrapper *wrapper = se->wrapper;  in geni_se_clks_on()  local
522 	ret = clk_bulk_prepare_enable(wrapper->num_clks, wrapper->clks);  in geni_se_clks_on()
528 		clk_bulk_disable_unprepare(wrapper->num_clks, wrapper->clks);  in geni_se_clks_on()
704 	struct geni_wrapper *wrapper = se->wrapper;  in geni_se_tx_dma_prep()  local
706 	if (!wrapper)  in geni_se_tx_dma_prep()
709 	*iova = dma_map_single(wrapper->dev, buf, len, DMA_TO_DEVICE);  in geni_se_tx_dma_prep()
710 	if (dma_mapping_error(wrapper->dev, *iova))  in geni_se_tx_dma_prep()
756 	struct geni_wrapper *wrapper = se->wrapper;  in geni_se_rx_dma_prep()  local
758 	if (!wrapper)  in geni_se_rx_dma_prep()
761 	*iova = dma_map_single(wrapper->dev, buf, len, DMA_FROM_DEVICE);  in geni_se_rx_dma_prep()
762 	if (dma_mapping_error(wrapper->dev, *iova))  in geni_se_rx_dma_prep()
780 	struct geni_wrapper *wrapper = se->wrapper;  in geni_se_tx_dma_unprep()  local
782 	if (!dma_mapping_error(wrapper->dev, iova))  in geni_se_tx_dma_unprep()
783 		dma_unmap_single(wrapper->dev, iova, len, DMA_TO_DEVICE);  in geni_se_tx_dma_unprep()
797 	struct geni_wrapper *wrapper = se->wrapper;  in geni_se_rx_dma_unprep()  local
799 	if (!dma_mapping_error(wrapper->dev, iova))  in geni_se_rx_dma_unprep()
800 		dma_unmap_single(wrapper->dev, iova, len, DMA_FROM_DEVICE);  in geni_se_rx_dma_unprep()
898 	struct geni_wrapper *wrapper;  in geni_se_probe()  local
901 	wrapper = devm_kzalloc(dev, sizeof(*wrapper), GFP_KERNEL);  in geni_se_probe()
902 	if (!wrapper)  in geni_se_probe()
905 	wrapper->dev = dev;  in geni_se_probe()
906 	wrapper->base = devm_platform_ioremap_resource(pdev, 0);  in geni_se_probe()
907 	if (IS_ERR(wrapper->base))  in geni_se_probe()
908 		return PTR_ERR(wrapper->base);  in geni_se_probe()
918 		wrapper->num_clks = min_t(unsigned int, desc->num_clks, MAX_CLKS);  in geni_se_probe()
920 		for (i = 0; i < wrapper->num_clks; ++i)  in geni_se_probe()
921 			wrapper->clks[i].id = desc->clks[i];  in geni_se_probe()
929 		if (ret < wrapper->num_clks) {  in geni_se_probe()
931 				dev->of_node, wrapper->num_clks);  in geni_se_probe()
935 		ret = devm_clk_bulk_get(dev, wrapper->num_clks, wrapper->clks);  in geni_se_probe()
942 	dev_set_drvdata(dev, wrapper);  in geni_se_probe()