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
101  * struct geni_se_desc - Data structure to represent the QUP Wrapper resources
190  * geni_se_get_qup_hw_version() - Read the QUP wrapper Hardware version
193  * Return: Hardware Version of the wrapper.
197 	struct geni_wrapper *wrapper = se->wrapper;  in geni_se_get_qup_hw_version()  local
199 	return readl_relaxed(wrapper->base + QUP_HW_VER_REG);  in geni_se_get_qup_hw_version()
487 	struct geni_wrapper *wrapper = se->wrapper;  in geni_se_clks_off()  local
490 	clk_bulk_disable_unprepare(wrapper->num_clks, wrapper->clks);  in geni_se_clks_off()
519 	struct geni_wrapper *wrapper = se->wrapper;  in geni_se_clks_on()  local
521 	ret = clk_bulk_prepare_enable(wrapper->num_clks, wrapper->clks);  in geni_se_clks_on()
527 		clk_bulk_disable_unprepare(wrapper->num_clks, wrapper->clks);  in geni_se_clks_on()
703 	struct geni_wrapper *wrapper = se->wrapper;  in geni_se_tx_dma_prep()  local
705 	if (!wrapper)  in geni_se_tx_dma_prep()
708 	*iova = dma_map_single(wrapper->dev, buf, len, DMA_TO_DEVICE);  in geni_se_tx_dma_prep()
709 	if (dma_mapping_error(wrapper->dev, *iova))  in geni_se_tx_dma_prep()
755 	struct geni_wrapper *wrapper = se->wrapper;  in geni_se_rx_dma_prep()  local
757 	if (!wrapper)  in geni_se_rx_dma_prep()
760 	*iova = dma_map_single(wrapper->dev, buf, len, DMA_FROM_DEVICE);  in geni_se_rx_dma_prep()
761 	if (dma_mapping_error(wrapper->dev, *iova))  in geni_se_rx_dma_prep()
779 	struct geni_wrapper *wrapper = se->wrapper;  in geni_se_tx_dma_unprep()  local
781 	if (!dma_mapping_error(wrapper->dev, iova))  in geni_se_tx_dma_unprep()
782 		dma_unmap_single(wrapper->dev, iova, len, DMA_TO_DEVICE);  in geni_se_tx_dma_unprep()
796 	struct geni_wrapper *wrapper = se->wrapper;  in geni_se_rx_dma_unprep()  local
798 	if (!dma_mapping_error(wrapper->dev, iova))  in geni_se_rx_dma_unprep()
799 		dma_unmap_single(wrapper->dev, iova, len, DMA_FROM_DEVICE);  in geni_se_rx_dma_unprep()
897 	struct geni_wrapper *wrapper;  in geni_se_probe()  local
900 	wrapper = devm_kzalloc(dev, sizeof(*wrapper), GFP_KERNEL);  in geni_se_probe()
901 	if (!wrapper)  in geni_se_probe()
904 	wrapper->dev = dev;  in geni_se_probe()
905 	wrapper->base = devm_platform_ioremap_resource(pdev, 0);  in geni_se_probe()
906 	if (IS_ERR(wrapper->base))  in geni_se_probe()
907 		return PTR_ERR(wrapper->base);  in geni_se_probe()
917 		wrapper->num_clks = min_t(unsigned int, desc->num_clks, MAX_CLKS);  in geni_se_probe()
919 		for (i = 0; i < wrapper->num_clks; ++i)  in geni_se_probe()
920 			wrapper->clks[i].id = desc->clks[i];  in geni_se_probe()
928 		if (ret < wrapper->num_clks) {  in geni_se_probe()
930 				dev->of_node, wrapper->num_clks);  in geni_se_probe()
934 		ret = devm_clk_bulk_get(dev, wrapper->num_clks, wrapper->clks);  in geni_se_probe()
941 	dev_set_drvdata(dev, wrapper);  in geni_se_probe()