1 // SPDX-License-Identifier: GPL-2.0 2 // Copyright (c) 2017-2018, The Linux Foundation. All rights reserved. 3 4 #include <linux/acpi.h> 5 #include <linux/clk.h> 6 #include <linux/console.h> 7 #include <linux/slab.h> 8 #include <linux/dma-mapping.h> 9 #include <linux/io.h> 10 #include <linux/module.h> 11 #include <linux/of.h> 12 #include <linux/of_platform.h> 13 #include <linux/pinctrl/consumer.h> 14 #include <linux/platform_device.h> 15 #include <linux/qcom-geni-se.h> 16 17 /** 18 * DOC: Overview 19 * 20 * Generic Interface (GENI) Serial Engine (SE) Wrapper driver is introduced 21 * to manage GENI firmware based Qualcomm Universal Peripheral (QUP) Wrapper 22 * controller. QUP Wrapper is designed to support various serial bus protocols 23 * like UART, SPI, I2C, I3C, etc. 24 */ 25 26 /** 27 * DOC: Hardware description 28 * 29 * GENI based QUP is a highly-flexible and programmable module for supporting 30 * a wide range of serial interfaces like UART, SPI, I2C, I3C, etc. A single 31 * QUP module can provide upto 8 serial interfaces, using its internal 32 * serial engines. The actual configuration is determined by the target 33 * platform configuration. The protocol supported by each interface is 34 * determined by the firmware loaded to the serial engine. Each SE consists 35 * of a DMA Engine and GENI sub modules which enable serial engines to 36 * support FIFO and DMA modes of operation. 37 * 38 * 39 * +-----------------------------------------+ 40 * |QUP Wrapper | 41 * | +----------------------------+ | 42 * --QUP & SE Clocks--> | Serial Engine N | +-IO------> 43 * | | ... | | Interface 44 * <---Clock Perf.----+ +----+-----------------------+ | | 45 * State Interface | | Serial Engine 1 | | | 46 * | | | | | 47 * | | | | | 48 * <--------AHB-------> | | | | 49 * | | +----+ | 50 * | | | | 51 * | | | | 52 * <------SE IRQ------+ +----------------------------+ | 53 * | | 54 * +-----------------------------------------+ 55 * 56 * Figure 1: GENI based QUP Wrapper 57 * 58 * The GENI submodules include primary and secondary sequencers which are 59 * used to drive TX & RX operations. On serial interfaces that operate using 60 * master-slave model, primary sequencer drives both TX & RX operations. On 61 * serial interfaces that operate using peer-to-peer model, primary sequencer 62 * drives TX operation and secondary sequencer drives RX operation. 63 */ 64 65 /** 66 * DOC: Software description 67 * 68 * GENI SE Wrapper driver is structured into 2 parts: 69 * 70 * geni_wrapper represents QUP Wrapper controller. This part of the driver 71 * manages QUP Wrapper information such as hardware version, clock 72 * performance table that is common to all the internal serial engines. 73 * 74 * geni_se represents serial engine. This part of the driver manages serial 75 * engine information such as clocks, containing QUP Wrapper, etc. This part 76 * of driver also supports operations (eg. initialize the concerned serial 77 * engine, select between FIFO and DMA mode of operation etc.) that are 78 * common to all the serial engines and are independent of serial interfaces. 79 */ 80 81 #define MAX_CLK_PERF_LEVEL 32 82 #define NUM_AHB_CLKS 2 83 84 /** 85 * struct geni_wrapper - Data structure to represent the QUP Wrapper Core 86 * @dev: Device pointer of the QUP wrapper core 87 * @base: Base address of this instance of QUP wrapper core 88 * @ahb_clks: Handle to the primary & secondary AHB clocks 89 * @to_core: Core ICC path 90 */ 91 struct geni_wrapper { 92 struct device *dev; 93 void __iomem *base; 94 struct clk_bulk_data ahb_clks[NUM_AHB_CLKS]; 95 struct geni_icc_path to_core; 96 }; 97 98 static const char * const icc_path_names[] = {"qup-core", "qup-config", 99 "qup-memory"}; 100 101 static struct geni_wrapper *earlycon_wrapper; 102 103 #define QUP_HW_VER_REG 0x4 104 105 /* Common SE registers */ 106 #define GENI_INIT_CFG_REVISION 0x0 107 #define GENI_S_INIT_CFG_REVISION 0x4 108 #define GENI_OUTPUT_CTRL 0x24 109 #define GENI_CGC_CTRL 0x28 110 #define GENI_CLK_CTRL_RO 0x60 111 #define GENI_IF_DISABLE_RO 0x64 112 #define GENI_FW_S_REVISION_RO 0x6c 113 #define SE_GENI_BYTE_GRAN 0x254 114 #define SE_GENI_TX_PACKING_CFG0 0x260 115 #define SE_GENI_TX_PACKING_CFG1 0x264 116 #define SE_GENI_RX_PACKING_CFG0 0x284 117 #define SE_GENI_RX_PACKING_CFG1 0x288 118 #define SE_GENI_M_GP_LENGTH 0x910 119 #define SE_GENI_S_GP_LENGTH 0x914 120 #define SE_DMA_TX_PTR_L 0xc30 121 #define SE_DMA_TX_PTR_H 0xc34 122 #define SE_DMA_TX_ATTR 0xc38 123 #define SE_DMA_TX_LEN 0xc3c 124 #define SE_DMA_TX_IRQ_EN 0xc48 125 #define SE_DMA_TX_IRQ_EN_SET 0xc4c 126 #define SE_DMA_TX_IRQ_EN_CLR 0xc50 127 #define SE_DMA_TX_LEN_IN 0xc54 128 #define SE_DMA_TX_MAX_BURST 0xc5c 129 #define SE_DMA_RX_PTR_L 0xd30 130 #define SE_DMA_RX_PTR_H 0xd34 131 #define SE_DMA_RX_ATTR 0xd38 132 #define SE_DMA_RX_LEN 0xd3c 133 #define SE_DMA_RX_IRQ_EN 0xd48 134 #define SE_DMA_RX_IRQ_EN_SET 0xd4c 135 #define SE_DMA_RX_IRQ_EN_CLR 0xd50 136 #define SE_DMA_RX_LEN_IN 0xd54 137 #define SE_DMA_RX_MAX_BURST 0xd5c 138 #define SE_DMA_RX_FLUSH 0xd60 139 #define SE_GSI_EVENT_EN 0xe18 140 #define SE_IRQ_EN 0xe1c 141 #define SE_DMA_GENERAL_CFG 0xe30 142 143 /* GENI_OUTPUT_CTRL fields */ 144 #define DEFAULT_IO_OUTPUT_CTRL_MSK GENMASK(6, 0) 145 146 /* GENI_CGC_CTRL fields */ 147 #define CFG_AHB_CLK_CGC_ON BIT(0) 148 #define CFG_AHB_WR_ACLK_CGC_ON BIT(1) 149 #define DATA_AHB_CLK_CGC_ON BIT(2) 150 #define SCLK_CGC_ON BIT(3) 151 #define TX_CLK_CGC_ON BIT(4) 152 #define RX_CLK_CGC_ON BIT(5) 153 #define EXT_CLK_CGC_ON BIT(6) 154 #define PROG_RAM_HCLK_OFF BIT(8) 155 #define PROG_RAM_SCLK_OFF BIT(9) 156 #define DEFAULT_CGC_EN GENMASK(6, 0) 157 158 /* SE_GSI_EVENT_EN fields */ 159 #define DMA_RX_EVENT_EN BIT(0) 160 #define DMA_TX_EVENT_EN BIT(1) 161 #define GENI_M_EVENT_EN BIT(2) 162 #define GENI_S_EVENT_EN BIT(3) 163 164 /* SE_IRQ_EN fields */ 165 #define DMA_RX_IRQ_EN BIT(0) 166 #define DMA_TX_IRQ_EN BIT(1) 167 #define GENI_M_IRQ_EN BIT(2) 168 #define GENI_S_IRQ_EN BIT(3) 169 170 /* SE_DMA_GENERAL_CFG */ 171 #define DMA_RX_CLK_CGC_ON BIT(0) 172 #define DMA_TX_CLK_CGC_ON BIT(1) 173 #define DMA_AHB_SLV_CFG_ON BIT(2) 174 #define AHB_SEC_SLV_CLK_CGC_ON BIT(3) 175 #define DUMMY_RX_NON_BUFFERABLE BIT(4) 176 #define RX_DMA_ZERO_PADDING_EN BIT(5) 177 #define RX_DMA_IRQ_DELAY_MSK GENMASK(8, 6) 178 #define RX_DMA_IRQ_DELAY_SHFT 6 179 180 /** 181 * geni_se_get_qup_hw_version() - Read the QUP wrapper Hardware version 182 * @se: Pointer to the corresponding serial engine. 183 * 184 * Return: Hardware Version of the wrapper. 185 */ 186 u32 geni_se_get_qup_hw_version(struct geni_se *se) 187 { 188 struct geni_wrapper *wrapper = se->wrapper; 189 190 return readl_relaxed(wrapper->base + QUP_HW_VER_REG); 191 } 192 EXPORT_SYMBOL(geni_se_get_qup_hw_version); 193 194 static void geni_se_io_set_mode(void __iomem *base) 195 { 196 u32 val; 197 198 val = readl_relaxed(base + SE_IRQ_EN); 199 val |= GENI_M_IRQ_EN | GENI_S_IRQ_EN; 200 val |= DMA_TX_IRQ_EN | DMA_RX_IRQ_EN; 201 writel_relaxed(val, base + SE_IRQ_EN); 202 203 val = readl_relaxed(base + SE_GENI_DMA_MODE_EN); 204 val &= ~GENI_DMA_MODE_EN; 205 writel_relaxed(val, base + SE_GENI_DMA_MODE_EN); 206 207 writel_relaxed(0, base + SE_GSI_EVENT_EN); 208 } 209 210 static void geni_se_io_init(void __iomem *base) 211 { 212 u32 val; 213 214 val = readl_relaxed(base + GENI_CGC_CTRL); 215 val |= DEFAULT_CGC_EN; 216 writel_relaxed(val, base + GENI_CGC_CTRL); 217 218 val = readl_relaxed(base + SE_DMA_GENERAL_CFG); 219 val |= AHB_SEC_SLV_CLK_CGC_ON | DMA_AHB_SLV_CFG_ON; 220 val |= DMA_TX_CLK_CGC_ON | DMA_RX_CLK_CGC_ON; 221 writel_relaxed(val, base + SE_DMA_GENERAL_CFG); 222 223 writel_relaxed(DEFAULT_IO_OUTPUT_CTRL_MSK, base + GENI_OUTPUT_CTRL); 224 writel_relaxed(FORCE_DEFAULT, base + GENI_FORCE_DEFAULT_REG); 225 } 226 227 static void geni_se_irq_clear(struct geni_se *se) 228 { 229 writel_relaxed(0, se->base + SE_GSI_EVENT_EN); 230 writel_relaxed(0xffffffff, se->base + SE_GENI_M_IRQ_CLEAR); 231 writel_relaxed(0xffffffff, se->base + SE_GENI_S_IRQ_CLEAR); 232 writel_relaxed(0xffffffff, se->base + SE_DMA_TX_IRQ_CLR); 233 writel_relaxed(0xffffffff, se->base + SE_DMA_RX_IRQ_CLR); 234 writel_relaxed(0xffffffff, se->base + SE_IRQ_EN); 235 } 236 237 /** 238 * geni_se_init() - Initialize the GENI serial engine 239 * @se: Pointer to the concerned serial engine. 240 * @rx_wm: Receive watermark, in units of FIFO words. 241 * @rx_rfr: Ready-for-receive watermark, in units of FIFO words. 242 * 243 * This function is used to initialize the GENI serial engine, configure 244 * receive watermark and ready-for-receive watermarks. 245 */ 246 void geni_se_init(struct geni_se *se, u32 rx_wm, u32 rx_rfr) 247 { 248 u32 val; 249 250 geni_se_irq_clear(se); 251 geni_se_io_init(se->base); 252 geni_se_io_set_mode(se->base); 253 254 writel_relaxed(rx_wm, se->base + SE_GENI_RX_WATERMARK_REG); 255 writel_relaxed(rx_rfr, se->base + SE_GENI_RX_RFR_WATERMARK_REG); 256 257 val = readl_relaxed(se->base + SE_GENI_M_IRQ_EN); 258 val |= M_COMMON_GENI_M_IRQ_EN; 259 writel_relaxed(val, se->base + SE_GENI_M_IRQ_EN); 260 261 val = readl_relaxed(se->base + SE_GENI_S_IRQ_EN); 262 val |= S_COMMON_GENI_S_IRQ_EN; 263 writel_relaxed(val, se->base + SE_GENI_S_IRQ_EN); 264 } 265 EXPORT_SYMBOL(geni_se_init); 266 267 static void geni_se_select_fifo_mode(struct geni_se *se) 268 { 269 u32 proto = geni_se_read_proto(se); 270 u32 val, val_old; 271 272 geni_se_irq_clear(se); 273 274 /* 275 * The RX path for the UART is asynchronous and so needs more 276 * complex logic for enabling / disabling its interrupts. 277 * 278 * Specific notes: 279 * - The done and TX-related interrupts are managed manually. 280 * - We don't RX from the main sequencer (we use the secondary) so 281 * we don't need the RX-related interrupts enabled in the main 282 * sequencer for UART. 283 */ 284 if (proto != GENI_SE_UART) { 285 val_old = val = readl_relaxed(se->base + SE_GENI_M_IRQ_EN); 286 val |= M_CMD_DONE_EN | M_TX_FIFO_WATERMARK_EN; 287 val |= M_RX_FIFO_WATERMARK_EN | M_RX_FIFO_LAST_EN; 288 if (val != val_old) 289 writel_relaxed(val, se->base + SE_GENI_M_IRQ_EN); 290 291 val_old = val = readl_relaxed(se->base + SE_GENI_S_IRQ_EN); 292 val |= S_CMD_DONE_EN; 293 if (val != val_old) 294 writel_relaxed(val, se->base + SE_GENI_S_IRQ_EN); 295 } 296 297 val_old = val = readl_relaxed(se->base + SE_GENI_DMA_MODE_EN); 298 val &= ~GENI_DMA_MODE_EN; 299 if (val != val_old) 300 writel_relaxed(val, se->base + SE_GENI_DMA_MODE_EN); 301 } 302 303 static void geni_se_select_dma_mode(struct geni_se *se) 304 { 305 u32 proto = geni_se_read_proto(se); 306 u32 val, val_old; 307 308 geni_se_irq_clear(se); 309 310 if (proto != GENI_SE_UART) { 311 val_old = val = readl_relaxed(se->base + SE_GENI_M_IRQ_EN); 312 val &= ~(M_CMD_DONE_EN | M_TX_FIFO_WATERMARK_EN); 313 val &= ~(M_RX_FIFO_WATERMARK_EN | M_RX_FIFO_LAST_EN); 314 if (val != val_old) 315 writel_relaxed(val, se->base + SE_GENI_M_IRQ_EN); 316 317 val_old = val = readl_relaxed(se->base + SE_GENI_S_IRQ_EN); 318 val &= ~S_CMD_DONE_EN; 319 if (val != val_old) 320 writel_relaxed(val, se->base + SE_GENI_S_IRQ_EN); 321 } 322 323 val_old = val = readl_relaxed(se->base + SE_GENI_DMA_MODE_EN); 324 val |= GENI_DMA_MODE_EN; 325 if (val != val_old) 326 writel_relaxed(val, se->base + SE_GENI_DMA_MODE_EN); 327 } 328 329 /** 330 * geni_se_select_mode() - Select the serial engine transfer mode 331 * @se: Pointer to the concerned serial engine. 332 * @mode: Transfer mode to be selected. 333 */ 334 void geni_se_select_mode(struct geni_se *se, enum geni_se_xfer_mode mode) 335 { 336 WARN_ON(mode != GENI_SE_FIFO && mode != GENI_SE_DMA); 337 338 switch (mode) { 339 case GENI_SE_FIFO: 340 geni_se_select_fifo_mode(se); 341 break; 342 case GENI_SE_DMA: 343 geni_se_select_dma_mode(se); 344 break; 345 case GENI_SE_INVALID: 346 default: 347 break; 348 } 349 } 350 EXPORT_SYMBOL(geni_se_select_mode); 351 352 /** 353 * DOC: Overview 354 * 355 * GENI FIFO packing is highly configurable. TX/RX packing/unpacking consist 356 * of up to 4 operations, each operation represented by 4 configuration vectors 357 * of 10 bits programmed in GENI_TX_PACKING_CFG0 and GENI_TX_PACKING_CFG1 for 358 * TX FIFO and in GENI_RX_PACKING_CFG0 and GENI_RX_PACKING_CFG1 for RX FIFO. 359 * Refer to below examples for detailed bit-field description. 360 * 361 * Example 1: word_size = 7, packing_mode = 4 x 8, msb_to_lsb = 1 362 * 363 * +-----------+-------+-------+-------+-------+ 364 * | | vec_0 | vec_1 | vec_2 | vec_3 | 365 * +-----------+-------+-------+-------+-------+ 366 * | start | 0x6 | 0xe | 0x16 | 0x1e | 367 * | direction | 1 | 1 | 1 | 1 | 368 * | length | 6 | 6 | 6 | 6 | 369 * | stop | 0 | 0 | 0 | 1 | 370 * +-----------+-------+-------+-------+-------+ 371 * 372 * Example 2: word_size = 15, packing_mode = 2 x 16, msb_to_lsb = 0 373 * 374 * +-----------+-------+-------+-------+-------+ 375 * | | vec_0 | vec_1 | vec_2 | vec_3 | 376 * +-----------+-------+-------+-------+-------+ 377 * | start | 0x0 | 0x8 | 0x10 | 0x18 | 378 * | direction | 0 | 0 | 0 | 0 | 379 * | length | 7 | 6 | 7 | 6 | 380 * | stop | 0 | 0 | 0 | 1 | 381 * +-----------+-------+-------+-------+-------+ 382 * 383 * Example 3: word_size = 23, packing_mode = 1 x 32, msb_to_lsb = 1 384 * 385 * +-----------+-------+-------+-------+-------+ 386 * | | vec_0 | vec_1 | vec_2 | vec_3 | 387 * +-----------+-------+-------+-------+-------+ 388 * | start | 0x16 | 0xe | 0x6 | 0x0 | 389 * | direction | 1 | 1 | 1 | 1 | 390 * | length | 7 | 7 | 6 | 0 | 391 * | stop | 0 | 0 | 1 | 0 | 392 * +-----------+-------+-------+-------+-------+ 393 * 394 */ 395 396 #define NUM_PACKING_VECTORS 4 397 #define PACKING_START_SHIFT 5 398 #define PACKING_DIR_SHIFT 4 399 #define PACKING_LEN_SHIFT 1 400 #define PACKING_STOP_BIT BIT(0) 401 #define PACKING_VECTOR_SHIFT 10 402 /** 403 * geni_se_config_packing() - Packing configuration of the serial engine 404 * @se: Pointer to the concerned serial engine 405 * @bpw: Bits of data per transfer word. 406 * @pack_words: Number of words per fifo element. 407 * @msb_to_lsb: Transfer from MSB to LSB or vice-versa. 408 * @tx_cfg: Flag to configure the TX Packing. 409 * @rx_cfg: Flag to configure the RX Packing. 410 * 411 * This function is used to configure the packing rules for the current 412 * transfer. 413 */ 414 void geni_se_config_packing(struct geni_se *se, int bpw, int pack_words, 415 bool msb_to_lsb, bool tx_cfg, bool rx_cfg) 416 { 417 u32 cfg0, cfg1, cfg[NUM_PACKING_VECTORS] = {0}; 418 int len; 419 int temp_bpw = bpw; 420 int idx_start = msb_to_lsb ? bpw - 1 : 0; 421 int idx = idx_start; 422 int idx_delta = msb_to_lsb ? -BITS_PER_BYTE : BITS_PER_BYTE; 423 int ceil_bpw = ALIGN(bpw, BITS_PER_BYTE); 424 int iter = (ceil_bpw * pack_words) / BITS_PER_BYTE; 425 int i; 426 427 if (iter <= 0 || iter > NUM_PACKING_VECTORS) 428 return; 429 430 for (i = 0; i < iter; i++) { 431 len = min_t(int, temp_bpw, BITS_PER_BYTE) - 1; 432 cfg[i] = idx << PACKING_START_SHIFT; 433 cfg[i] |= msb_to_lsb << PACKING_DIR_SHIFT; 434 cfg[i] |= len << PACKING_LEN_SHIFT; 435 436 if (temp_bpw <= BITS_PER_BYTE) { 437 idx = ((i + 1) * BITS_PER_BYTE) + idx_start; 438 temp_bpw = bpw; 439 } else { 440 idx = idx + idx_delta; 441 temp_bpw = temp_bpw - BITS_PER_BYTE; 442 } 443 } 444 cfg[iter - 1] |= PACKING_STOP_BIT; 445 cfg0 = cfg[0] | (cfg[1] << PACKING_VECTOR_SHIFT); 446 cfg1 = cfg[2] | (cfg[3] << PACKING_VECTOR_SHIFT); 447 448 if (tx_cfg) { 449 writel_relaxed(cfg0, se->base + SE_GENI_TX_PACKING_CFG0); 450 writel_relaxed(cfg1, se->base + SE_GENI_TX_PACKING_CFG1); 451 } 452 if (rx_cfg) { 453 writel_relaxed(cfg0, se->base + SE_GENI_RX_PACKING_CFG0); 454 writel_relaxed(cfg1, se->base + SE_GENI_RX_PACKING_CFG1); 455 } 456 457 /* 458 * Number of protocol words in each FIFO entry 459 * 0 - 4x8, four words in each entry, max word size of 8 bits 460 * 1 - 2x16, two words in each entry, max word size of 16 bits 461 * 2 - 1x32, one word in each entry, max word size of 32 bits 462 * 3 - undefined 463 */ 464 if (pack_words || bpw == 32) 465 writel_relaxed(bpw / 16, se->base + SE_GENI_BYTE_GRAN); 466 } 467 EXPORT_SYMBOL(geni_se_config_packing); 468 469 static void geni_se_clks_off(struct geni_se *se) 470 { 471 struct geni_wrapper *wrapper = se->wrapper; 472 473 clk_disable_unprepare(se->clk); 474 clk_bulk_disable_unprepare(ARRAY_SIZE(wrapper->ahb_clks), 475 wrapper->ahb_clks); 476 } 477 478 /** 479 * geni_se_resources_off() - Turn off resources associated with the serial 480 * engine 481 * @se: Pointer to the concerned serial engine. 482 * 483 * Return: 0 on success, standard Linux error codes on failure/error. 484 */ 485 int geni_se_resources_off(struct geni_se *se) 486 { 487 int ret; 488 489 if (has_acpi_companion(se->dev)) 490 return 0; 491 492 ret = pinctrl_pm_select_sleep_state(se->dev); 493 if (ret) 494 return ret; 495 496 geni_se_clks_off(se); 497 return 0; 498 } 499 EXPORT_SYMBOL(geni_se_resources_off); 500 501 static int geni_se_clks_on(struct geni_se *se) 502 { 503 int ret; 504 struct geni_wrapper *wrapper = se->wrapper; 505 506 ret = clk_bulk_prepare_enable(ARRAY_SIZE(wrapper->ahb_clks), 507 wrapper->ahb_clks); 508 if (ret) 509 return ret; 510 511 ret = clk_prepare_enable(se->clk); 512 if (ret) 513 clk_bulk_disable_unprepare(ARRAY_SIZE(wrapper->ahb_clks), 514 wrapper->ahb_clks); 515 return ret; 516 } 517 518 /** 519 * geni_se_resources_on() - Turn on resources associated with the serial 520 * engine 521 * @se: Pointer to the concerned serial engine. 522 * 523 * Return: 0 on success, standard Linux error codes on failure/error. 524 */ 525 int geni_se_resources_on(struct geni_se *se) 526 { 527 int ret; 528 529 if (has_acpi_companion(se->dev)) 530 return 0; 531 532 ret = geni_se_clks_on(se); 533 if (ret) 534 return ret; 535 536 ret = pinctrl_pm_select_default_state(se->dev); 537 if (ret) 538 geni_se_clks_off(se); 539 540 return ret; 541 } 542 EXPORT_SYMBOL(geni_se_resources_on); 543 544 /** 545 * geni_se_clk_tbl_get() - Get the clock table to program DFS 546 * @se: Pointer to the concerned serial engine. 547 * @tbl: Table in which the output is returned. 548 * 549 * This function is called by the protocol drivers to determine the different 550 * clock frequencies supported by serial engine core clock. The protocol 551 * drivers use the output to determine the clock frequency index to be 552 * programmed into DFS. 553 * 554 * Return: number of valid performance levels in the table on success, 555 * standard Linux error codes on failure. 556 */ 557 int geni_se_clk_tbl_get(struct geni_se *se, unsigned long **tbl) 558 { 559 long freq = 0; 560 int i; 561 562 if (se->clk_perf_tbl) { 563 *tbl = se->clk_perf_tbl; 564 return se->num_clk_levels; 565 } 566 567 se->clk_perf_tbl = devm_kcalloc(se->dev, MAX_CLK_PERF_LEVEL, 568 sizeof(*se->clk_perf_tbl), 569 GFP_KERNEL); 570 if (!se->clk_perf_tbl) 571 return -ENOMEM; 572 573 for (i = 0; i < MAX_CLK_PERF_LEVEL; i++) { 574 freq = clk_round_rate(se->clk, freq + 1); 575 if (freq <= 0 || freq == se->clk_perf_tbl[i - 1]) 576 break; 577 se->clk_perf_tbl[i] = freq; 578 } 579 se->num_clk_levels = i; 580 *tbl = se->clk_perf_tbl; 581 return se->num_clk_levels; 582 } 583 EXPORT_SYMBOL(geni_se_clk_tbl_get); 584 585 /** 586 * geni_se_clk_freq_match() - Get the matching or closest SE clock frequency 587 * @se: Pointer to the concerned serial engine. 588 * @req_freq: Requested clock frequency. 589 * @index: Index of the resultant frequency in the table. 590 * @res_freq: Resultant frequency of the source clock. 591 * @exact: Flag to indicate exact multiple requirement of the requested 592 * frequency. 593 * 594 * This function is called by the protocol drivers to determine the best match 595 * of the requested frequency as provided by the serial engine clock in order 596 * to meet the performance requirements. 597 * 598 * If we return success: 599 * - if @exact is true then @res_freq / <an_integer> == @req_freq 600 * - if @exact is false then @res_freq / <an_integer> <= @req_freq 601 * 602 * Return: 0 on success, standard Linux error codes on failure. 603 */ 604 int geni_se_clk_freq_match(struct geni_se *se, unsigned long req_freq, 605 unsigned int *index, unsigned long *res_freq, 606 bool exact) 607 { 608 unsigned long *tbl; 609 int num_clk_levels; 610 int i; 611 unsigned long best_delta; 612 unsigned long new_delta; 613 unsigned int divider; 614 615 num_clk_levels = geni_se_clk_tbl_get(se, &tbl); 616 if (num_clk_levels < 0) 617 return num_clk_levels; 618 619 if (num_clk_levels == 0) 620 return -EINVAL; 621 622 best_delta = ULONG_MAX; 623 for (i = 0; i < num_clk_levels; i++) { 624 divider = DIV_ROUND_UP(tbl[i], req_freq); 625 new_delta = req_freq - tbl[i] / divider; 626 if (new_delta < best_delta) { 627 /* We have a new best! */ 628 *index = i; 629 *res_freq = tbl[i]; 630 631 /* If the new best is exact then we're done */ 632 if (new_delta == 0) 633 return 0; 634 635 /* Record how close we got */ 636 best_delta = new_delta; 637 } 638 } 639 640 if (exact) 641 return -EINVAL; 642 643 return 0; 644 } 645 EXPORT_SYMBOL(geni_se_clk_freq_match); 646 647 #define GENI_SE_DMA_DONE_EN BIT(0) 648 #define GENI_SE_DMA_EOT_EN BIT(1) 649 #define GENI_SE_DMA_AHB_ERR_EN BIT(2) 650 #define GENI_SE_DMA_EOT_BUF BIT(0) 651 /** 652 * geni_se_tx_dma_prep() - Prepare the serial engine for TX DMA transfer 653 * @se: Pointer to the concerned serial engine. 654 * @buf: Pointer to the TX buffer. 655 * @len: Length of the TX buffer. 656 * @iova: Pointer to store the mapped DMA address. 657 * 658 * This function is used to prepare the buffers for DMA TX. 659 * 660 * Return: 0 on success, standard Linux error codes on failure. 661 */ 662 int geni_se_tx_dma_prep(struct geni_se *se, void *buf, size_t len, 663 dma_addr_t *iova) 664 { 665 struct geni_wrapper *wrapper = se->wrapper; 666 u32 val; 667 668 if (!wrapper) 669 return -EINVAL; 670 671 *iova = dma_map_single(wrapper->dev, buf, len, DMA_TO_DEVICE); 672 if (dma_mapping_error(wrapper->dev, *iova)) 673 return -EIO; 674 675 val = GENI_SE_DMA_DONE_EN; 676 val |= GENI_SE_DMA_EOT_EN; 677 val |= GENI_SE_DMA_AHB_ERR_EN; 678 writel_relaxed(val, se->base + SE_DMA_TX_IRQ_EN_SET); 679 writel_relaxed(lower_32_bits(*iova), se->base + SE_DMA_TX_PTR_L); 680 writel_relaxed(upper_32_bits(*iova), se->base + SE_DMA_TX_PTR_H); 681 writel_relaxed(GENI_SE_DMA_EOT_BUF, se->base + SE_DMA_TX_ATTR); 682 writel(len, se->base + SE_DMA_TX_LEN); 683 return 0; 684 } 685 EXPORT_SYMBOL(geni_se_tx_dma_prep); 686 687 /** 688 * geni_se_rx_dma_prep() - Prepare the serial engine for RX DMA transfer 689 * @se: Pointer to the concerned serial engine. 690 * @buf: Pointer to the RX buffer. 691 * @len: Length of the RX buffer. 692 * @iova: Pointer to store the mapped DMA address. 693 * 694 * This function is used to prepare the buffers for DMA RX. 695 * 696 * Return: 0 on success, standard Linux error codes on failure. 697 */ 698 int geni_se_rx_dma_prep(struct geni_se *se, void *buf, size_t len, 699 dma_addr_t *iova) 700 { 701 struct geni_wrapper *wrapper = se->wrapper; 702 u32 val; 703 704 if (!wrapper) 705 return -EINVAL; 706 707 *iova = dma_map_single(wrapper->dev, buf, len, DMA_FROM_DEVICE); 708 if (dma_mapping_error(wrapper->dev, *iova)) 709 return -EIO; 710 711 val = GENI_SE_DMA_DONE_EN; 712 val |= GENI_SE_DMA_EOT_EN; 713 val |= GENI_SE_DMA_AHB_ERR_EN; 714 writel_relaxed(val, se->base + SE_DMA_RX_IRQ_EN_SET); 715 writel_relaxed(lower_32_bits(*iova), se->base + SE_DMA_RX_PTR_L); 716 writel_relaxed(upper_32_bits(*iova), se->base + SE_DMA_RX_PTR_H); 717 /* RX does not have EOT buffer type bit. So just reset RX_ATTR */ 718 writel_relaxed(0, se->base + SE_DMA_RX_ATTR); 719 writel(len, se->base + SE_DMA_RX_LEN); 720 return 0; 721 } 722 EXPORT_SYMBOL(geni_se_rx_dma_prep); 723 724 /** 725 * geni_se_tx_dma_unprep() - Unprepare the serial engine after TX DMA transfer 726 * @se: Pointer to the concerned serial engine. 727 * @iova: DMA address of the TX buffer. 728 * @len: Length of the TX buffer. 729 * 730 * This function is used to unprepare the DMA buffers after DMA TX. 731 */ 732 void geni_se_tx_dma_unprep(struct geni_se *se, dma_addr_t iova, size_t len) 733 { 734 struct geni_wrapper *wrapper = se->wrapper; 735 736 if (!dma_mapping_error(wrapper->dev, iova)) 737 dma_unmap_single(wrapper->dev, iova, len, DMA_TO_DEVICE); 738 } 739 EXPORT_SYMBOL(geni_se_tx_dma_unprep); 740 741 /** 742 * geni_se_rx_dma_unprep() - Unprepare the serial engine after RX DMA transfer 743 * @se: Pointer to the concerned serial engine. 744 * @iova: DMA address of the RX buffer. 745 * @len: Length of the RX buffer. 746 * 747 * This function is used to unprepare the DMA buffers after DMA RX. 748 */ 749 void geni_se_rx_dma_unprep(struct geni_se *se, dma_addr_t iova, size_t len) 750 { 751 struct geni_wrapper *wrapper = se->wrapper; 752 753 if (!dma_mapping_error(wrapper->dev, iova)) 754 dma_unmap_single(wrapper->dev, iova, len, DMA_FROM_DEVICE); 755 } 756 EXPORT_SYMBOL(geni_se_rx_dma_unprep); 757 758 int geni_icc_get(struct geni_se *se, const char *icc_ddr) 759 { 760 int i, err; 761 const char *icc_names[] = {"qup-core", "qup-config", icc_ddr}; 762 763 for (i = 0; i < ARRAY_SIZE(se->icc_paths); i++) { 764 if (!icc_names[i]) 765 continue; 766 767 se->icc_paths[i].path = devm_of_icc_get(se->dev, icc_names[i]); 768 if (IS_ERR(se->icc_paths[i].path)) 769 goto err; 770 } 771 772 return 0; 773 774 err: 775 err = PTR_ERR(se->icc_paths[i].path); 776 if (err != -EPROBE_DEFER) 777 dev_err_ratelimited(se->dev, "Failed to get ICC path '%s': %d\n", 778 icc_names[i], err); 779 return err; 780 781 } 782 EXPORT_SYMBOL(geni_icc_get); 783 784 int geni_icc_set_bw(struct geni_se *se) 785 { 786 int i, ret; 787 788 for (i = 0; i < ARRAY_SIZE(se->icc_paths); i++) { 789 ret = icc_set_bw(se->icc_paths[i].path, 790 se->icc_paths[i].avg_bw, se->icc_paths[i].avg_bw); 791 if (ret) { 792 dev_err_ratelimited(se->dev, "ICC BW voting failed on path '%s': %d\n", 793 icc_path_names[i], ret); 794 return ret; 795 } 796 } 797 798 return 0; 799 } 800 EXPORT_SYMBOL(geni_icc_set_bw); 801 802 void geni_icc_set_tag(struct geni_se *se, u32 tag) 803 { 804 int i; 805 806 for (i = 0; i < ARRAY_SIZE(se->icc_paths); i++) 807 icc_set_tag(se->icc_paths[i].path, tag); 808 } 809 EXPORT_SYMBOL(geni_icc_set_tag); 810 811 /* To do: Replace this by icc_bulk_enable once it's implemented in ICC core */ 812 int geni_icc_enable(struct geni_se *se) 813 { 814 int i, ret; 815 816 for (i = 0; i < ARRAY_SIZE(se->icc_paths); i++) { 817 ret = icc_enable(se->icc_paths[i].path); 818 if (ret) { 819 dev_err_ratelimited(se->dev, "ICC enable failed on path '%s': %d\n", 820 icc_path_names[i], ret); 821 return ret; 822 } 823 } 824 825 return 0; 826 } 827 EXPORT_SYMBOL(geni_icc_enable); 828 829 int geni_icc_disable(struct geni_se *se) 830 { 831 int i, ret; 832 833 for (i = 0; i < ARRAY_SIZE(se->icc_paths); i++) { 834 ret = icc_disable(se->icc_paths[i].path); 835 if (ret) { 836 dev_err_ratelimited(se->dev, "ICC disable failed on path '%s': %d\n", 837 icc_path_names[i], ret); 838 return ret; 839 } 840 } 841 842 return 0; 843 } 844 EXPORT_SYMBOL(geni_icc_disable); 845 846 void geni_remove_earlycon_icc_vote(void) 847 { 848 struct platform_device *pdev; 849 struct geni_wrapper *wrapper; 850 struct device_node *parent; 851 struct device_node *child; 852 853 if (!earlycon_wrapper) 854 return; 855 856 wrapper = earlycon_wrapper; 857 parent = of_get_next_parent(wrapper->dev->of_node); 858 for_each_child_of_node(parent, child) { 859 if (!of_device_is_compatible(child, "qcom,geni-se-qup")) 860 continue; 861 862 pdev = of_find_device_by_node(child); 863 if (!pdev) 864 continue; 865 866 wrapper = platform_get_drvdata(pdev); 867 icc_put(wrapper->to_core.path); 868 wrapper->to_core.path = NULL; 869 870 } 871 of_node_put(parent); 872 873 earlycon_wrapper = NULL; 874 } 875 EXPORT_SYMBOL(geni_remove_earlycon_icc_vote); 876 877 static int geni_se_probe(struct platform_device *pdev) 878 { 879 struct device *dev = &pdev->dev; 880 struct resource *res; 881 struct geni_wrapper *wrapper; 882 struct console __maybe_unused *bcon; 883 bool __maybe_unused has_earlycon = false; 884 int ret; 885 886 wrapper = devm_kzalloc(dev, sizeof(*wrapper), GFP_KERNEL); 887 if (!wrapper) 888 return -ENOMEM; 889 890 wrapper->dev = dev; 891 res = platform_get_resource(pdev, IORESOURCE_MEM, 0); 892 wrapper->base = devm_ioremap_resource(dev, res); 893 if (IS_ERR(wrapper->base)) 894 return PTR_ERR(wrapper->base); 895 896 if (!has_acpi_companion(&pdev->dev)) { 897 wrapper->ahb_clks[0].id = "m-ahb"; 898 wrapper->ahb_clks[1].id = "s-ahb"; 899 ret = devm_clk_bulk_get(dev, NUM_AHB_CLKS, wrapper->ahb_clks); 900 if (ret) { 901 dev_err(dev, "Err getting AHB clks %d\n", ret); 902 return ret; 903 } 904 } 905 906 #ifdef CONFIG_SERIAL_EARLYCON 907 for_each_console(bcon) { 908 if (!strcmp(bcon->name, "qcom_geni")) { 909 has_earlycon = true; 910 break; 911 } 912 } 913 if (!has_earlycon) 914 goto exit; 915 916 wrapper->to_core.path = devm_of_icc_get(dev, "qup-core"); 917 if (IS_ERR(wrapper->to_core.path)) 918 return PTR_ERR(wrapper->to_core.path); 919 /* 920 * Put minmal BW request on core clocks on behalf of early console. 921 * The vote will be removed earlycon exit function. 922 * 923 * Note: We are putting vote on each QUP wrapper instead only to which 924 * earlycon is connected because QUP core clock of different wrapper 925 * share same voltage domain. If core1 is put to 0, then core2 will 926 * also run at 0, if not voted. Default ICC vote will be removed ASA 927 * we touch any of the core clock. 928 * core1 = core2 = max(core1, core2) 929 */ 930 ret = icc_set_bw(wrapper->to_core.path, GENI_DEFAULT_BW, 931 GENI_DEFAULT_BW); 932 if (ret) { 933 dev_err(&pdev->dev, "%s: ICC BW voting failed for core: %d\n", 934 __func__, ret); 935 return ret; 936 } 937 938 if (of_get_compatible_child(pdev->dev.of_node, "qcom,geni-debug-uart")) 939 earlycon_wrapper = wrapper; 940 of_node_put(pdev->dev.of_node); 941 exit: 942 #endif 943 dev_set_drvdata(dev, wrapper); 944 dev_dbg(dev, "GENI SE Driver probed\n"); 945 return devm_of_platform_populate(dev); 946 } 947 948 static const struct of_device_id geni_se_dt_match[] = { 949 { .compatible = "qcom,geni-se-qup", }, 950 {} 951 }; 952 MODULE_DEVICE_TABLE(of, geni_se_dt_match); 953 954 static struct platform_driver geni_se_driver = { 955 .driver = { 956 .name = "geni_se_qup", 957 .of_match_table = geni_se_dt_match, 958 }, 959 .probe = geni_se_probe, 960 }; 961 module_platform_driver(geni_se_driver); 962 963 MODULE_DESCRIPTION("GENI Serial Engine Driver"); 964 MODULE_LICENSE("GPL v2"); 965