Lines Matching +full:geni +full:- +full:se +full:- +full:qup
1 // SPDX-License-Identifier: GPL-2.0
2 // Copyright (c) 2017-2018, The Linux Foundation. All rights reserved.
6 #include <linux/dma-mapping.h>
13 #include <linux/qcom-geni-se.h>
18 * Generic Interface (GENI) Serial Engine (SE) Wrapper driver is introduced
19 * to manage GENI firmware based Qualcomm Universal Peripheral (QUP) Wrapper
20 * controller. QUP Wrapper is designed to support various serial bus protocols
27 * GENI based QUP is a highly-flexible and programmable module for supporting
29 * QUP module can provide upto 8 serial interfaces, using its internal
32 * determined by the firmware loaded to the serial engine. Each SE consists
33 * of a DMA Engine and GENI sub modules which enable serial engines to
37 * +-----------------------------------------+
38 * |QUP Wrapper |
39 * | +----------------------------+ |
40 * --QUP & SE Clocks--> | Serial Engine N | +-IO------>
42 * <---Clock Perf.----+ +----+-----------------------+ | |
46 * <--------AHB-------> | | | |
47 * | | +----+ |
50 * <------SE IRQ------+ +----------------------------+ |
52 * +-----------------------------------------+
54 * Figure 1: GENI based QUP Wrapper
56 * The GENI submodules include primary and secondary sequencers which are
58 * master-slave model, primary sequencer drives both TX & RX operations. On
59 * serial interfaces that operate using peer-to-peer model, primary sequencer
66 * GENI SE Wrapper driver is structured into 2 parts:
68 * geni_wrapper represents QUP Wrapper controller. This part of the driver
69 * manages QUP Wrapper information such as hardware version, clock
73 * engine information such as clocks, containing QUP Wrapper, etc. This part
83 * @struct geni_wrapper - Data structure to represent the QUP Wrapper Core
84 * @dev: Device pointer of the QUP wrapper core
85 * @base: Base address of this instance of QUP wrapper core
96 /* Common SE registers */
172 * geni_se_get_qup_hw_version() - Read the QUP wrapper Hardware version
173 * @se: Pointer to the corresponding serial engine.
177 u32 geni_se_get_qup_hw_version(struct geni_se *se) in geni_se_get_qup_hw_version() argument
179 struct geni_wrapper *wrapper = se->wrapper; in geni_se_get_qup_hw_version()
181 return readl_relaxed(wrapper->base + QUP_HW_VER_REG); in geni_se_get_qup_hw_version()
219 * geni_se_init() - Initialize the GENI serial engine
220 * @se: Pointer to the concerned serial engine.
222 * @rx_rfr_wm: Ready-for-receive watermark, in units of FIFO words.
224 * This function is used to initialize the GENI serial engine, configure
225 * receive watermark and ready-for-receive watermarks.
227 void geni_se_init(struct geni_se *se, u32 rx_wm, u32 rx_rfr) in geni_se_init() argument
231 geni_se_io_init(se->base); in geni_se_init()
232 geni_se_io_set_mode(se->base); in geni_se_init()
234 writel_relaxed(rx_wm, se->base + SE_GENI_RX_WATERMARK_REG); in geni_se_init()
235 writel_relaxed(rx_rfr, se->base + SE_GENI_RX_RFR_WATERMARK_REG); in geni_se_init()
237 val = readl_relaxed(se->base + SE_GENI_M_IRQ_EN); in geni_se_init()
239 writel_relaxed(val, se->base + SE_GENI_M_IRQ_EN); in geni_se_init()
241 val = readl_relaxed(se->base + SE_GENI_S_IRQ_EN); in geni_se_init()
243 writel_relaxed(val, se->base + SE_GENI_S_IRQ_EN); in geni_se_init()
247 static void geni_se_select_fifo_mode(struct geni_se *se) in geni_se_select_fifo_mode() argument
249 u32 proto = geni_se_read_proto(se); in geni_se_select_fifo_mode()
252 writel_relaxed(0, se->base + SE_GSI_EVENT_EN); in geni_se_select_fifo_mode()
253 writel_relaxed(0xffffffff, se->base + SE_GENI_M_IRQ_CLEAR); in geni_se_select_fifo_mode()
254 writel_relaxed(0xffffffff, se->base + SE_GENI_S_IRQ_CLEAR); in geni_se_select_fifo_mode()
255 writel_relaxed(0xffffffff, se->base + SE_DMA_TX_IRQ_CLR); in geni_se_select_fifo_mode()
256 writel_relaxed(0xffffffff, se->base + SE_DMA_RX_IRQ_CLR); in geni_se_select_fifo_mode()
257 writel_relaxed(0xffffffff, se->base + SE_IRQ_EN); in geni_se_select_fifo_mode()
259 val = readl_relaxed(se->base + SE_GENI_M_IRQ_EN); in geni_se_select_fifo_mode()
264 writel_relaxed(val, se->base + SE_GENI_M_IRQ_EN); in geni_se_select_fifo_mode()
266 val = readl_relaxed(se->base + SE_GENI_S_IRQ_EN); in geni_se_select_fifo_mode()
269 writel_relaxed(val, se->base + SE_GENI_S_IRQ_EN); in geni_se_select_fifo_mode()
271 val = readl_relaxed(se->base + SE_GENI_DMA_MODE_EN); in geni_se_select_fifo_mode()
273 writel_relaxed(val, se->base + SE_GENI_DMA_MODE_EN); in geni_se_select_fifo_mode()
276 static void geni_se_select_dma_mode(struct geni_se *se) in geni_se_select_dma_mode() argument
280 writel_relaxed(0, se->base + SE_GSI_EVENT_EN); in geni_se_select_dma_mode()
281 writel_relaxed(0xffffffff, se->base + SE_GENI_M_IRQ_CLEAR); in geni_se_select_dma_mode()
282 writel_relaxed(0xffffffff, se->base + SE_GENI_S_IRQ_CLEAR); in geni_se_select_dma_mode()
283 writel_relaxed(0xffffffff, se->base + SE_DMA_TX_IRQ_CLR); in geni_se_select_dma_mode()
284 writel_relaxed(0xffffffff, se->base + SE_DMA_RX_IRQ_CLR); in geni_se_select_dma_mode()
285 writel_relaxed(0xffffffff, se->base + SE_IRQ_EN); in geni_se_select_dma_mode()
287 val = readl_relaxed(se->base + SE_GENI_DMA_MODE_EN); in geni_se_select_dma_mode()
289 writel_relaxed(val, se->base + SE_GENI_DMA_MODE_EN); in geni_se_select_dma_mode()
293 * geni_se_select_mode() - Select the serial engine transfer mode
294 * @se: Pointer to the concerned serial engine.
297 void geni_se_select_mode(struct geni_se *se, enum geni_se_xfer_mode mode) in geni_se_select_mode() argument
303 geni_se_select_fifo_mode(se); in geni_se_select_mode()
306 geni_se_select_dma_mode(se); in geni_se_select_mode()
318 * GENI FIFO packing is highly configurable. TX/RX packing/unpacking consist
322 * Refer to below examples for detailed bit-field description.
326 * +-----------+-------+-------+-------+-------+
328 * +-----------+-------+-------+-------+-------+
333 * +-----------+-------+-------+-------+-------+
337 * +-----------+-------+-------+-------+-------+
339 * +-----------+-------+-------+-------+-------+
344 * +-----------+-------+-------+-------+-------+
348 * +-----------+-------+-------+-------+-------+
350 * +-----------+-------+-------+-------+-------+
355 * +-----------+-------+-------+-------+-------+
366 * geni_se_config_packing() - Packing configuration of the serial engine
367 * @se: Pointer to the concerned serial engine
370 * @msb_to_lsb: Transfer from MSB to LSB or vice-versa.
377 void geni_se_config_packing(struct geni_se *se, int bpw, int pack_words, in geni_se_config_packing() argument
383 int idx_start = msb_to_lsb ? bpw - 1 : 0; in geni_se_config_packing()
385 int idx_delta = msb_to_lsb ? -BITS_PER_BYTE : BITS_PER_BYTE; in geni_se_config_packing()
394 len = min_t(int, temp_bpw, BITS_PER_BYTE) - 1; in geni_se_config_packing()
404 temp_bpw = temp_bpw - BITS_PER_BYTE; in geni_se_config_packing()
407 cfg[iter - 1] |= PACKING_STOP_BIT; in geni_se_config_packing()
412 writel_relaxed(cfg0, se->base + SE_GENI_TX_PACKING_CFG0); in geni_se_config_packing()
413 writel_relaxed(cfg1, se->base + SE_GENI_TX_PACKING_CFG1); in geni_se_config_packing()
416 writel_relaxed(cfg0, se->base + SE_GENI_RX_PACKING_CFG0); in geni_se_config_packing()
417 writel_relaxed(cfg1, se->base + SE_GENI_RX_PACKING_CFG1); in geni_se_config_packing()
422 * 0 - 4x8, four words in each entry, max word size of 8 bits in geni_se_config_packing()
423 * 1 - 2x16, two words in each entry, max word size of 16 bits in geni_se_config_packing()
424 * 2 - 1x32, one word in each entry, max word size of 32 bits in geni_se_config_packing()
425 * 3 - undefined in geni_se_config_packing()
428 writel_relaxed(bpw / 16, se->base + SE_GENI_BYTE_GRAN); in geni_se_config_packing()
432 static void geni_se_clks_off(struct geni_se *se) in geni_se_clks_off() argument
434 struct geni_wrapper *wrapper = se->wrapper; in geni_se_clks_off()
436 clk_disable_unprepare(se->clk); in geni_se_clks_off()
437 clk_bulk_disable_unprepare(ARRAY_SIZE(wrapper->ahb_clks), in geni_se_clks_off()
438 wrapper->ahb_clks); in geni_se_clks_off()
442 * geni_se_resources_off() - Turn off resources associated with the serial
444 * @se: Pointer to the concerned serial engine.
448 int geni_se_resources_off(struct geni_se *se) in geni_se_resources_off() argument
452 ret = pinctrl_pm_select_sleep_state(se->dev); in geni_se_resources_off()
456 geni_se_clks_off(se); in geni_se_resources_off()
461 static int geni_se_clks_on(struct geni_se *se) in geni_se_clks_on() argument
464 struct geni_wrapper *wrapper = se->wrapper; in geni_se_clks_on()
466 ret = clk_bulk_prepare_enable(ARRAY_SIZE(wrapper->ahb_clks), in geni_se_clks_on()
467 wrapper->ahb_clks); in geni_se_clks_on()
471 ret = clk_prepare_enable(se->clk); in geni_se_clks_on()
473 clk_bulk_disable_unprepare(ARRAY_SIZE(wrapper->ahb_clks), in geni_se_clks_on()
474 wrapper->ahb_clks); in geni_se_clks_on()
479 * geni_se_resources_on() - Turn on resources associated with the serial
481 * @se: Pointer to the concerned serial engine.
485 int geni_se_resources_on(struct geni_se *se) in geni_se_resources_on() argument
489 ret = geni_se_clks_on(se); in geni_se_resources_on()
493 ret = pinctrl_pm_select_default_state(se->dev); in geni_se_resources_on()
495 geni_se_clks_off(se); in geni_se_resources_on()
502 * geni_se_clk_tbl_get() - Get the clock table to program DFS
503 * @se: Pointer to the concerned serial engine.
514 int geni_se_clk_tbl_get(struct geni_se *se, unsigned long **tbl) in geni_se_clk_tbl_get() argument
519 if (se->clk_perf_tbl) { in geni_se_clk_tbl_get()
520 *tbl = se->clk_perf_tbl; in geni_se_clk_tbl_get()
521 return se->num_clk_levels; in geni_se_clk_tbl_get()
524 se->clk_perf_tbl = devm_kcalloc(se->dev, MAX_CLK_PERF_LEVEL, in geni_se_clk_tbl_get()
525 sizeof(*se->clk_perf_tbl), in geni_se_clk_tbl_get()
527 if (!se->clk_perf_tbl) in geni_se_clk_tbl_get()
528 return -ENOMEM; in geni_se_clk_tbl_get()
531 freq = clk_round_rate(se->clk, freq + 1); in geni_se_clk_tbl_get()
532 if (freq <= 0 || freq == se->clk_perf_tbl[i - 1]) in geni_se_clk_tbl_get()
534 se->clk_perf_tbl[i] = freq; in geni_se_clk_tbl_get()
536 se->num_clk_levels = i; in geni_se_clk_tbl_get()
537 *tbl = se->clk_perf_tbl; in geni_se_clk_tbl_get()
538 return se->num_clk_levels; in geni_se_clk_tbl_get()
543 * geni_se_clk_freq_match() - Get the matching or closest SE clock frequency
544 * @se: Pointer to the concerned serial engine.
556 * - if @exact is true then @res_freq / <an_integer> == @req_freq
557 * - if @exact is false then @res_freq / <an_integer> <= @req_freq
561 int geni_se_clk_freq_match(struct geni_se *se, unsigned long req_freq, in geni_se_clk_freq_match() argument
572 num_clk_levels = geni_se_clk_tbl_get(se, &tbl); in geni_se_clk_freq_match()
577 return -EINVAL; in geni_se_clk_freq_match()
582 new_delta = req_freq - tbl[i] / divider; in geni_se_clk_freq_match()
598 return -EINVAL; in geni_se_clk_freq_match()
609 * geni_se_tx_dma_prep() - Prepare the serial engine for TX DMA transfer
610 * @se: Pointer to the concerned serial engine.
619 int geni_se_tx_dma_prep(struct geni_se *se, void *buf, size_t len, in geni_se_tx_dma_prep() argument
622 struct geni_wrapper *wrapper = se->wrapper; in geni_se_tx_dma_prep()
625 *iova = dma_map_single(wrapper->dev, buf, len, DMA_TO_DEVICE); in geni_se_tx_dma_prep()
626 if (dma_mapping_error(wrapper->dev, *iova)) in geni_se_tx_dma_prep()
627 return -EIO; in geni_se_tx_dma_prep()
632 writel_relaxed(val, se->base + SE_DMA_TX_IRQ_EN_SET); in geni_se_tx_dma_prep()
633 writel_relaxed(lower_32_bits(*iova), se->base + SE_DMA_TX_PTR_L); in geni_se_tx_dma_prep()
634 writel_relaxed(upper_32_bits(*iova), se->base + SE_DMA_TX_PTR_H); in geni_se_tx_dma_prep()
635 writel_relaxed(GENI_SE_DMA_EOT_BUF, se->base + SE_DMA_TX_ATTR); in geni_se_tx_dma_prep()
636 writel_relaxed(len, se->base + SE_DMA_TX_LEN); in geni_se_tx_dma_prep()
642 * geni_se_rx_dma_prep() - Prepare the serial engine for RX DMA transfer
643 * @se: Pointer to the concerned serial engine.
652 int geni_se_rx_dma_prep(struct geni_se *se, void *buf, size_t len, in geni_se_rx_dma_prep() argument
655 struct geni_wrapper *wrapper = se->wrapper; in geni_se_rx_dma_prep()
658 *iova = dma_map_single(wrapper->dev, buf, len, DMA_FROM_DEVICE); in geni_se_rx_dma_prep()
659 if (dma_mapping_error(wrapper->dev, *iova)) in geni_se_rx_dma_prep()
660 return -EIO; in geni_se_rx_dma_prep()
665 writel_relaxed(val, se->base + SE_DMA_RX_IRQ_EN_SET); in geni_se_rx_dma_prep()
666 writel_relaxed(lower_32_bits(*iova), se->base + SE_DMA_RX_PTR_L); in geni_se_rx_dma_prep()
667 writel_relaxed(upper_32_bits(*iova), se->base + SE_DMA_RX_PTR_H); in geni_se_rx_dma_prep()
669 writel_relaxed(0, se->base + SE_DMA_RX_ATTR); in geni_se_rx_dma_prep()
670 writel_relaxed(len, se->base + SE_DMA_RX_LEN); in geni_se_rx_dma_prep()
676 * geni_se_tx_dma_unprep() - Unprepare the serial engine after TX DMA transfer
677 * @se: Pointer to the concerned serial engine.
683 void geni_se_tx_dma_unprep(struct geni_se *se, dma_addr_t iova, size_t len) in geni_se_tx_dma_unprep() argument
685 struct geni_wrapper *wrapper = se->wrapper; in geni_se_tx_dma_unprep()
687 if (iova && !dma_mapping_error(wrapper->dev, iova)) in geni_se_tx_dma_unprep()
688 dma_unmap_single(wrapper->dev, iova, len, DMA_TO_DEVICE); in geni_se_tx_dma_unprep()
693 * geni_se_rx_dma_unprep() - Unprepare the serial engine after RX DMA transfer
694 * @se: Pointer to the concerned serial engine.
700 void geni_se_rx_dma_unprep(struct geni_se *se, dma_addr_t iova, size_t len) in geni_se_rx_dma_unprep() argument
702 struct geni_wrapper *wrapper = se->wrapper; in geni_se_rx_dma_unprep()
704 if (iova && !dma_mapping_error(wrapper->dev, iova)) in geni_se_rx_dma_unprep()
705 dma_unmap_single(wrapper->dev, iova, len, DMA_FROM_DEVICE); in geni_se_rx_dma_unprep()
711 struct device *dev = &pdev->dev; in geni_se_probe()
718 return -ENOMEM; in geni_se_probe()
720 wrapper->dev = dev; in geni_se_probe()
722 wrapper->base = devm_ioremap_resource(dev, res); in geni_se_probe()
723 if (IS_ERR(wrapper->base)) in geni_se_probe()
724 return PTR_ERR(wrapper->base); in geni_se_probe()
726 wrapper->ahb_clks[0].id = "m-ahb"; in geni_se_probe()
727 wrapper->ahb_clks[1].id = "s-ahb"; in geni_se_probe()
728 ret = devm_clk_bulk_get(dev, NUM_AHB_CLKS, wrapper->ahb_clks); in geni_se_probe()
735 dev_dbg(dev, "GENI SE Driver probed\n"); in geni_se_probe()
740 { .compatible = "qcom,geni-se-qup", },
754 MODULE_DESCRIPTION("GENI Serial Engine Driver");