root/arch/arm/kernel/tcm.c

/* [<][>][^][v][top][bottom][index][help] */

DEFINITIONS

This source file includes following definitions.
  1. tcm_alloc
  2. tcm_free
  3. tcm_dtcm_present
  4. tcm_itcm_present
  5. setup_tcm_bank
  6. tcm_handler
  7. tcm_init
  8. setup_tcm_pool

   1 // SPDX-License-Identifier: GPL-2.0-only
   2 /*
   3  * Copyright (C) 2008-2009 ST-Ericsson AB
   4  * TCM memory handling for ARM systems
   5  *
   6  * Author: Linus Walleij <linus.walleij@stericsson.com>
   7  * Author: Rickard Andersson <rickard.andersson@stericsson.com>
   8  */
   9 #include <linux/init.h>
  10 #include <linux/kernel.h>
  11 #include <linux/module.h>
  12 #include <linux/stddef.h>
  13 #include <linux/ioport.h>
  14 #include <linux/genalloc.h>
  15 #include <linux/string.h> /* memcpy */
  16 #include <asm/cputype.h>
  17 #include <asm/mach/map.h>
  18 #include <asm/memory.h>
  19 #include <asm/system_info.h>
  20 #include <asm/traps.h>
  21 
  22 #define TCMTR_FORMAT_MASK       0xe0000000U
  23 
  24 static struct gen_pool *tcm_pool;
  25 static bool dtcm_present;
  26 static bool itcm_present;
  27 
  28 /* TCM section definitions from the linker */
  29 extern char __itcm_start, __sitcm_text, __eitcm_text;
  30 extern char __dtcm_start, __sdtcm_data, __edtcm_data;
  31 
  32 /* These will be increased as we run */
  33 u32 dtcm_end = DTCM_OFFSET;
  34 u32 itcm_end = ITCM_OFFSET;
  35 
  36 /*
  37  * TCM memory resources
  38  */
  39 static struct resource dtcm_res = {
  40         .name = "DTCM RAM",
  41         .start = DTCM_OFFSET,
  42         .end = DTCM_OFFSET,
  43         .flags = IORESOURCE_MEM
  44 };
  45 
  46 static struct resource itcm_res = {
  47         .name = "ITCM RAM",
  48         .start = ITCM_OFFSET,
  49         .end = ITCM_OFFSET,
  50         .flags = IORESOURCE_MEM
  51 };
  52 
  53 static struct map_desc dtcm_iomap[] __initdata = {
  54         {
  55                 .virtual        = DTCM_OFFSET,
  56                 .pfn            = __phys_to_pfn(DTCM_OFFSET),
  57                 .length         = 0,
  58                 .type           = MT_MEMORY_RW_DTCM
  59         }
  60 };
  61 
  62 static struct map_desc itcm_iomap[] __initdata = {
  63         {
  64                 .virtual        = ITCM_OFFSET,
  65                 .pfn            = __phys_to_pfn(ITCM_OFFSET),
  66                 .length         = 0,
  67                 .type           = MT_MEMORY_RWX_ITCM,
  68         }
  69 };
  70 
  71 /*
  72  * Allocate a chunk of TCM memory
  73  */
  74 void *tcm_alloc(size_t len)
  75 {
  76         unsigned long vaddr;
  77 
  78         if (!tcm_pool)
  79                 return NULL;
  80 
  81         vaddr = gen_pool_alloc(tcm_pool, len);
  82         if (!vaddr)
  83                 return NULL;
  84 
  85         return (void *) vaddr;
  86 }
  87 EXPORT_SYMBOL(tcm_alloc);
  88 
  89 /*
  90  * Free a chunk of TCM memory
  91  */
  92 void tcm_free(void *addr, size_t len)
  93 {
  94         gen_pool_free(tcm_pool, (unsigned long) addr, len);
  95 }
  96 EXPORT_SYMBOL(tcm_free);
  97 
  98 bool tcm_dtcm_present(void)
  99 {
 100         return dtcm_present;
 101 }
 102 EXPORT_SYMBOL(tcm_dtcm_present);
 103 
 104 bool tcm_itcm_present(void)
 105 {
 106         return itcm_present;
 107 }
 108 EXPORT_SYMBOL(tcm_itcm_present);
 109 
 110 static int __init setup_tcm_bank(u8 type, u8 bank, u8 banks,
 111                                   u32 *offset)
 112 {
 113         const int tcm_sizes[16] = { 0, -1, -1, 4, 8, 16, 32, 64, 128,
 114                                     256, 512, 1024, -1, -1, -1, -1 };
 115         u32 tcm_region;
 116         int tcm_size;
 117 
 118         /*
 119          * If there are more than one TCM bank of this type,
 120          * select the TCM bank to operate on in the TCM selection
 121          * register.
 122          */
 123         if (banks > 1)
 124                 asm("mcr        p15, 0, %0, c9, c2, 0"
 125                     : /* No output operands */
 126                     : "r" (bank));
 127 
 128         /* Read the special TCM region register c9, 0 */
 129         if (!type)
 130                 asm("mrc        p15, 0, %0, c9, c1, 0"
 131                     : "=r" (tcm_region));
 132         else
 133                 asm("mrc        p15, 0, %0, c9, c1, 1"
 134                     : "=r" (tcm_region));
 135 
 136         tcm_size = tcm_sizes[(tcm_region >> 2) & 0x0f];
 137         if (tcm_size < 0) {
 138                 pr_err("CPU: %sTCM%d of unknown size\n",
 139                        type ? "I" : "D", bank);
 140                 return -EINVAL;
 141         } else if (tcm_size > 32) {
 142                 pr_err("CPU: %sTCM%d larger than 32k found\n",
 143                        type ? "I" : "D", bank);
 144                 return -EINVAL;
 145         } else {
 146                 pr_info("CPU: found %sTCM%d %dk @ %08x, %senabled\n",
 147                         type ? "I" : "D",
 148                         bank,
 149                         tcm_size,
 150                         (tcm_region & 0xfffff000U),
 151                         (tcm_region & 1) ? "" : "not ");
 152         }
 153 
 154         /* Not much fun you can do with a size 0 bank */
 155         if (tcm_size == 0)
 156                 return 0;
 157 
 158         /* Force move the TCM bank to where we want it, enable */
 159         tcm_region = *offset | (tcm_region & 0x00000ffeU) | 1;
 160 
 161         if (!type)
 162                 asm("mcr        p15, 0, %0, c9, c1, 0"
 163                     : /* No output operands */
 164                     : "r" (tcm_region));
 165         else
 166                 asm("mcr        p15, 0, %0, c9, c1, 1"
 167                     : /* No output operands */
 168                     : "r" (tcm_region));
 169 
 170         /* Increase offset */
 171         *offset += (tcm_size << 10);
 172 
 173         pr_info("CPU: moved %sTCM%d %dk to %08x, enabled\n",
 174                 type ? "I" : "D",
 175                 bank,
 176                 tcm_size,
 177                 (tcm_region & 0xfffff000U));
 178         return 0;
 179 }
 180 
 181 /*
 182  * When we are running in the non-secure world and the secure world
 183  * has not explicitly given us access to the TCM we will get an
 184  * undefined error when reading the TCM region register in the
 185  * setup_tcm_bank function (above).
 186  *
 187  * There are two variants of this register read that we need to trap,
 188  * the read for the data TCM and the read for the instruction TCM:
 189  *  c0370628:       ee196f11        mrc     15, 0, r6, cr9, cr1, {0}
 190  *  c0370674:       ee196f31        mrc     15, 0, r6, cr9, cr1, {1}
 191  *
 192  * Our undef hook mask explicitly matches all fields of the encoded
 193  * instruction other than the destination register.  The mask also
 194  * only allows operand 2 to have the values 0 or 1.
 195  *
 196  * The undefined hook is defined as __init and __initdata, and therefore
 197  * must be removed before tcm_init returns.
 198  *
 199  * In this particular case (MRC with ARM condition code ALways) the
 200  * Thumb-2 and ARM instruction encoding are identical, so this hook
 201  * will work on a Thumb-2 kernel.
 202  *
 203  * See A8.8.107, DDI0406C_C ARM Architecture Reference Manual, Encoding
 204  * T1/A1 for the bit-by-bit details.
 205  *
 206  *  mrc   p15, 0, XX, c9, c1, 0
 207  *  mrc   p15, 0, XX, c9, c1, 1
 208  *   |  |  |   |   |   |   |  +---- opc2           0|1 = 000|001
 209  *   |  |  |   |   |   |   +------- CRm              0 = 0001
 210  *   |  |  |   |   |   +----------- CRn              0 = 1001
 211  *   |  |  |   |   +--------------- Rt               ? = ????
 212  *   |  |  |   +------------------- opc1             0 =  000
 213  *   |  |  +----------------------- coproc          15 = 1111
 214  *   |  +-------------------------- condition   ALways = 1110
 215  *   +----------------------------- instruction    MRC = 1110
 216  *
 217  * Encoding this as per A8.8.107 of DDI0406C, Encoding T1/A1, yields:
 218  *  1111 1111 1111 1111 0000 1111 1101 1111 Required Mask
 219  *  1110 1110 0001 1001 ???? 1111 0001 0001 mrc p15, 0, XX, c9, c1, 0
 220  *  1110 1110 0001 1001 ???? 1111 0011 0001 mrc p15, 0, XX, c9, c1, 1
 221  *  [  ] [  ] [ ]| [  ] [  ] [  ] [ ]| +--- CRm
 222  *    |    |   | |   |    |    |   | +----- SBO
 223  *    |    |   | |   |    |    |   +------- opc2
 224  *    |    |   | |   |    |    +----------- coproc
 225  *    |    |   | |   |    +---------------- Rt
 226  *    |    |   | |   +--------------------- CRn
 227  *    |    |   | +------------------------- SBO
 228  *    |    |   +--------------------------- opc1
 229  *    |    +------------------------------- instruction
 230  *    +------------------------------------ condition
 231  */
 232 #define TCM_REGION_READ_MASK            0xffff0fdf
 233 #define TCM_REGION_READ_INSTR           0xee190f11
 234 #define DEST_REG_SHIFT                  12
 235 #define DEST_REG_MASK                   0xf
 236 
 237 static int __init tcm_handler(struct pt_regs *regs, unsigned int instr)
 238 {
 239         regs->uregs[(instr >> DEST_REG_SHIFT) & DEST_REG_MASK] = 0;
 240         regs->ARM_pc += 4;
 241         return 0;
 242 }
 243 
 244 static struct undef_hook tcm_hook __initdata = {
 245         .instr_mask     = TCM_REGION_READ_MASK,
 246         .instr_val      = TCM_REGION_READ_INSTR,
 247         .cpsr_mask      = MODE_MASK,
 248         .cpsr_val       = SVC_MODE,
 249         .fn             = tcm_handler
 250 };
 251 
 252 /*
 253  * This initializes the TCM memory
 254  */
 255 void __init tcm_init(void)
 256 {
 257         u32 tcm_status;
 258         u8 dtcm_banks;
 259         u8 itcm_banks;
 260         size_t dtcm_code_sz = &__edtcm_data - &__sdtcm_data;
 261         size_t itcm_code_sz = &__eitcm_text - &__sitcm_text;
 262         char *start;
 263         char *end;
 264         char *ram;
 265         int ret;
 266         int i;
 267 
 268         /*
 269          * Prior to ARMv5 there is no TCM, and trying to read the status
 270          * register will hang the processor.
 271          */
 272         if (cpu_architecture() < CPU_ARCH_ARMv5) {
 273                 if (dtcm_code_sz || itcm_code_sz)
 274                         pr_info("CPU TCM: %u bytes of DTCM and %u bytes of "
 275                                 "ITCM code compiled in, but no TCM present "
 276                                 "in pre-v5 CPU\n", dtcm_code_sz, itcm_code_sz);
 277                 return;
 278         }
 279 
 280         tcm_status = read_cpuid_tcmstatus();
 281 
 282         /*
 283          * This code only supports v6-compatible TCMTR implementations.
 284          */
 285         if (tcm_status & TCMTR_FORMAT_MASK)
 286                 return;
 287 
 288         dtcm_banks = (tcm_status >> 16) & 0x03;
 289         itcm_banks = (tcm_status & 0x03);
 290 
 291         register_undef_hook(&tcm_hook);
 292 
 293         /* Values greater than 2 for D/ITCM banks are "reserved" */
 294         if (dtcm_banks > 2)
 295                 dtcm_banks = 0;
 296         if (itcm_banks > 2)
 297                 itcm_banks = 0;
 298 
 299         /* Setup DTCM if present */
 300         if (dtcm_banks > 0) {
 301                 for (i = 0; i < dtcm_banks; i++) {
 302                         ret = setup_tcm_bank(0, i, dtcm_banks, &dtcm_end);
 303                         if (ret)
 304                                 goto unregister;
 305                 }
 306                 /* This means you compiled more code than fits into DTCM */
 307                 if (dtcm_code_sz > (dtcm_end - DTCM_OFFSET)) {
 308                         pr_info("CPU DTCM: %u bytes of code compiled to "
 309                                 "DTCM but only %lu bytes of DTCM present\n",
 310                                 dtcm_code_sz, (dtcm_end - DTCM_OFFSET));
 311                         goto no_dtcm;
 312                 }
 313                 /*
 314                  * This means that the DTCM sizes were 0 or the DTCM banks
 315                  * were inaccessible due to TrustZone configuration.
 316                  */
 317                 if (!(dtcm_end - DTCM_OFFSET))
 318                         goto no_dtcm;
 319                 dtcm_res.end = dtcm_end - 1;
 320                 request_resource(&iomem_resource, &dtcm_res);
 321                 dtcm_iomap[0].length = dtcm_end - DTCM_OFFSET;
 322                 iotable_init(dtcm_iomap, 1);
 323                 /* Copy data from RAM to DTCM */
 324                 start = &__sdtcm_data;
 325                 end   = &__edtcm_data;
 326                 ram   = &__dtcm_start;
 327                 memcpy(start, ram, dtcm_code_sz);
 328                 pr_debug("CPU DTCM: copied data from %p - %p\n",
 329                          start, end);
 330                 dtcm_present = true;
 331         } else if (dtcm_code_sz) {
 332                 pr_info("CPU DTCM: %u bytes of code compiled to DTCM but no "
 333                         "DTCM banks present in CPU\n", dtcm_code_sz);
 334         }
 335 
 336 no_dtcm:
 337         /* Setup ITCM if present */
 338         if (itcm_banks > 0) {
 339                 for (i = 0; i < itcm_banks; i++) {
 340                         ret = setup_tcm_bank(1, i, itcm_banks, &itcm_end);
 341                         if (ret)
 342                                 goto unregister;
 343                 }
 344                 /* This means you compiled more code than fits into ITCM */
 345                 if (itcm_code_sz > (itcm_end - ITCM_OFFSET)) {
 346                         pr_info("CPU ITCM: %u bytes of code compiled to "
 347                                 "ITCM but only %lu bytes of ITCM present\n",
 348                                 itcm_code_sz, (itcm_end - ITCM_OFFSET));
 349                         goto unregister;
 350                 }
 351                 /*
 352                  * This means that the ITCM sizes were 0 or the ITCM banks
 353                  * were inaccessible due to TrustZone configuration.
 354                  */
 355                 if (!(itcm_end - ITCM_OFFSET))
 356                         goto unregister;
 357                 itcm_res.end = itcm_end - 1;
 358                 request_resource(&iomem_resource, &itcm_res);
 359                 itcm_iomap[0].length = itcm_end - ITCM_OFFSET;
 360                 iotable_init(itcm_iomap, 1);
 361                 /* Copy code from RAM to ITCM */
 362                 start = &__sitcm_text;
 363                 end   = &__eitcm_text;
 364                 ram   = &__itcm_start;
 365                 memcpy(start, ram, itcm_code_sz);
 366                 pr_debug("CPU ITCM: copied code from %p - %p\n",
 367                          start, end);
 368                 itcm_present = true;
 369         } else if (itcm_code_sz) {
 370                 pr_info("CPU ITCM: %u bytes of code compiled to ITCM but no "
 371                         "ITCM banks present in CPU\n", itcm_code_sz);
 372         }
 373 
 374 unregister:
 375         unregister_undef_hook(&tcm_hook);
 376 }
 377 
 378 /*
 379  * This creates the TCM memory pool and has to be done later,
 380  * during the core_initicalls, since the allocator is not yet
 381  * up and running when the first initialization runs.
 382  */
 383 static int __init setup_tcm_pool(void)
 384 {
 385         u32 dtcm_pool_start = (u32) &__edtcm_data;
 386         u32 itcm_pool_start = (u32) &__eitcm_text;
 387         int ret;
 388 
 389         /*
 390          * Set up malloc pool, 2^2 = 4 bytes granularity since
 391          * the TCM is sometimes just 4 KiB. NB: pages and cache
 392          * line alignments does not matter in TCM!
 393          */
 394         tcm_pool = gen_pool_create(2, -1);
 395 
 396         pr_debug("Setting up TCM memory pool\n");
 397 
 398         /* Add the rest of DTCM to the TCM pool */
 399         if (dtcm_present) {
 400                 if (dtcm_pool_start < dtcm_end) {
 401                         ret = gen_pool_add(tcm_pool, dtcm_pool_start,
 402                                            dtcm_end - dtcm_pool_start, -1);
 403                         if (ret) {
 404                                 pr_err("CPU DTCM: could not add DTCM " \
 405                                        "remainder to pool!\n");
 406                                 return ret;
 407                         }
 408                         pr_debug("CPU DTCM: Added %08x bytes @ %08x to " \
 409                                  "the TCM memory pool\n",
 410                                  dtcm_end - dtcm_pool_start,
 411                                  dtcm_pool_start);
 412                 }
 413         }
 414 
 415         /* Add the rest of ITCM to the TCM pool */
 416         if (itcm_present) {
 417                 if (itcm_pool_start < itcm_end) {
 418                         ret = gen_pool_add(tcm_pool, itcm_pool_start,
 419                                            itcm_end - itcm_pool_start, -1);
 420                         if (ret) {
 421                                 pr_err("CPU ITCM: could not add ITCM " \
 422                                        "remainder to pool!\n");
 423                                 return ret;
 424                         }
 425                         pr_debug("CPU ITCM: Added %08x bytes @ %08x to " \
 426                                  "the TCM memory pool\n",
 427                                  itcm_end - itcm_pool_start,
 428                                  itcm_pool_start);
 429                 }
 430         }
 431         return 0;
 432 }
 433 
 434 core_initcall(setup_tcm_pool);

/* [<][>][^][v][top][bottom][index][help] */