2 * Instruction SRAM accessor functions for the Blackfin
4 * Copyright 2008 Analog Devices Inc.
6 * Licensed under the GPL-2 or later
9 #define pr_fmt(fmt) "isram: " fmt
11 #include <linux/module.h>
12 #include <linux/kernel.h>
13 #include <linux/types.h>
14 #include <linux/slab.h>
15 #include <linux/spinlock.h>
16 #include <linux/sched.h>
18 #include <asm/blackfin.h>
22 * IMPORTANT WARNING ABOUT THESE FUNCTIONS
24 * The emulator will not function correctly if a write command is left in
25 * ITEST_COMMAND or DTEST_COMMAND AND access to cache memory is needed by
26 * the emulator. To avoid such problems, ensure that both ITEST_COMMAND
27 * and DTEST_COMMAND are zero when exiting these functions.
32 * On the Blackfin, L1 instruction sram (which operates at core speeds) can not
33 * be accessed by a normal core load, so we need to go through a few hoops to
35 * To try to make it easier - we export a memcpy interface, where either src or
36 * dest can be in this special L1 memory area.
37 * The low level read/write functions should not be exposed to the rest of the
38 * kernel, since they operate on 64-bit data, and need specific address alignment
41 static DEFINE_SPINLOCK(dtest_lock
);
43 /* Takes a void pointer */
44 #define IADDR2DTEST(x) \
45 ({ unsigned long __addr = (unsigned long)(x); \
46 ((__addr & (1 << 11)) << (26 - 11)) | /* addr bit 11 (Way0/Way1) */ \
47 (1 << 24) | /* instruction access = 1 */ \
48 ((__addr & (1 << 15)) << (23 - 15)) | /* addr bit 15 (Data Bank) */ \
49 ((__addr & (3 << 12)) << (16 - 12)) | /* addr bits 13:12 (Subbank) */ \
50 (__addr & 0x47F8) | /* addr bits 14 & 10:3 */ \
51 (1 << 2); /* data array = 1 */ \
54 /* Takes a pointer, and returns the offset (in bits) which things should be shifted */
55 #define ADDR2OFFSET(x) ((((unsigned long)(x)) & 0x7) * 8)
57 /* Takes a pointer, determines if it is the last byte in the isram 64-bit data type */
58 #define ADDR2LAST(x) ((((unsigned long)x) & 0x7) == 0x7)
60 static void isram_write(const void *addr
, uint64_t data
)
65 if (unlikely(addr
>= (void *)(L1_CODE_START
+ L1_CODE_LENGTH
)))
68 cmd
= IADDR2DTEST(addr
) | 2; /* write */
71 * Writes to DTEST_DATA[0:1] need to be atomic with write to DTEST_COMMAND
72 * While in exception context - atomicity is guaranteed or double fault
74 spin_lock_irqsave(&dtest_lock
, flags
);
76 bfin_write_DTEST_DATA0(data
& 0xFFFFFFFF);
77 bfin_write_DTEST_DATA1(data
>> 32);
79 /* use the builtin, since interrupts are already turned off */
80 __builtin_bfin_csync();
81 bfin_write_DTEST_COMMAND(cmd
);
82 __builtin_bfin_csync();
84 bfin_write_DTEST_COMMAND(0);
85 __builtin_bfin_csync();
87 spin_unlock_irqrestore(&dtest_lock
, flags
);
90 static uint64_t isram_read(const void *addr
)
96 if (unlikely(addr
> (void *)(L1_CODE_START
+ L1_CODE_LENGTH
)))
99 cmd
= IADDR2DTEST(addr
) | 0; /* read */
102 * Reads of DTEST_DATA[0:1] need to be atomic with write to DTEST_COMMAND
103 * While in exception context - atomicity is guaranteed or double fault
105 spin_lock_irqsave(&dtest_lock
, flags
);
106 /* use the builtin, since interrupts are already turned off */
107 __builtin_bfin_csync();
108 bfin_write_DTEST_COMMAND(cmd
);
109 __builtin_bfin_csync();
110 ret
= bfin_read_DTEST_DATA0() | ((uint64_t)bfin_read_DTEST_DATA1() << 32);
112 bfin_write_DTEST_COMMAND(0);
113 __builtin_bfin_csync();
114 spin_unlock_irqrestore(&dtest_lock
, flags
);
119 static bool isram_check_addr(const void *addr
, size_t n
)
121 if ((addr
>= (void *)L1_CODE_START
) &&
122 (addr
< (void *)(L1_CODE_START
+ L1_CODE_LENGTH
))) {
123 if (unlikely((addr
+ n
) > (void *)(L1_CODE_START
+ L1_CODE_LENGTH
))) {
124 show_stack(NULL
, NULL
);
125 pr_err("copy involving %p length (%zu) too long\n", addr
, n
);
133 * The isram_memcpy() function copies n bytes from memory area src to memory area dest.
134 * The isram_memcpy() function returns a pointer to dest.
135 * Either dest or src can be in L1 instruction sram.
137 void *isram_memcpy(void *dest
, const void *src
, size_t n
)
139 uint64_t data_in
= 0, data_out
= 0;
141 bool dest_in_l1
, src_in_l1
, need_data
, put_data
;
142 unsigned char byte
, *src_byte
, *dest_byte
;
144 src_byte
= (unsigned char *)src
;
145 dest_byte
= (unsigned char *)dest
;
147 dest_in_l1
= isram_check_addr(dest
, n
);
148 src_in_l1
= isram_check_addr(src
, n
);
152 for (count
= 0; count
< n
; count
++) {
155 data_in
= isram_read(src
+ count
);
159 if (ADDR2LAST(src
+ count
))
162 byte
= (unsigned char)((data_in
>> ADDR2OFFSET(src
+ count
)) & 0xff);
165 /* src is in L2 or L3 - so just dereference*/
166 byte
= src_byte
[count
];
171 data_out
= isram_read(dest
+ count
);
175 data_out
&= ~((uint64_t)0xff << ADDR2OFFSET(dest
+ count
));
176 data_out
|= ((uint64_t)byte
<< ADDR2OFFSET(dest
+ count
));
178 if (ADDR2LAST(dest
+ count
)) {
180 isram_write(dest
+ count
, data_out
);
183 /* dest in L2 or L3 - so just dereference */
184 dest_byte
[count
] = byte
;
188 /* make sure we dump the last byte if necessary */
189 if (dest_in_l1
&& !put_data
)
190 isram_write(dest
+ count
, data_out
);
194 EXPORT_SYMBOL(isram_memcpy
);
196 #ifdef CONFIG_BFIN_ISRAM_SELF_TEST
198 static int test_len
= 0x20000;
200 static __init
void hex_dump(unsigned char *buf
, int len
)
203 pr_cont("%02x", *buf
++);
206 static __init
int isram_read_test(char *sdram
, void *l1inst
)
209 uint64_t data1
, data2
;
211 pr_info("INFO: running isram_read tests\n");
213 /* setup some different data to play with */
214 for (i
= 0; i
< test_len
; ++i
)
216 dma_memcpy(l1inst
, sdram
, test_len
);
218 /* make sure we can read the L1 inst */
219 for (i
= 0; i
< test_len
; i
+= sizeof(uint64_t)) {
220 data1
= isram_read(l1inst
+ i
);
221 memcpy(&data2
, sdram
+ i
, sizeof(data2
));
222 if (data1
!= data2
) {
223 pr_err("FAIL: isram_read(%p) returned %#llx but wanted %#llx\n",
224 l1inst
+ i
, data1
, data2
);
232 static __init
int isram_write_test(char *sdram
, void *l1inst
)
235 uint64_t data1
, data2
;
237 pr_info("INFO: running isram_write tests\n");
239 /* setup some different data to play with */
240 memset(sdram
, 0, test_len
* 2);
241 dma_memcpy(l1inst
, sdram
, test_len
);
242 for (i
= 0; i
< test_len
; ++i
)
245 /* make sure we can write the L1 inst */
246 for (i
= 0; i
< test_len
; i
+= sizeof(uint64_t)) {
247 memcpy(&data1
, sdram
+ i
, sizeof(data1
));
248 isram_write(l1inst
+ i
, data1
);
249 data2
= isram_read(l1inst
+ i
);
250 if (data1
!= data2
) {
251 pr_err("FAIL: isram_write(%p, %#llx) != %#llx\n",
252 l1inst
+ i
, data1
, data2
);
257 dma_memcpy(sdram
+ test_len
, l1inst
, test_len
);
258 if (memcmp(sdram
, sdram
+ test_len
, test_len
)) {
259 pr_err("FAIL: isram_write() did not work properly\n");
267 _isram_memcpy_test(char pattern
, void *sdram
, void *l1inst
, const char *smemcpy
,
268 void *(*fmemcpy
)(void *, const void *, size_t))
270 memset(sdram
, pattern
, test_len
);
271 fmemcpy(l1inst
, sdram
, test_len
);
272 fmemcpy(sdram
+ test_len
, l1inst
, test_len
);
273 if (memcmp(sdram
, sdram
+ test_len
, test_len
)) {
274 pr_err("FAIL: %s(%p <=> %p, %#x) failed (data is %#x)\n",
275 smemcpy
, l1inst
, sdram
, test_len
, pattern
);
280 #define _isram_memcpy_test(a, b, c, d) _isram_memcpy_test(a, b, c, #d, d)
282 static __init
int isram_memcpy_test(char *sdram
, void *l1inst
)
284 int i
, j
, thisret
, ret
= 0;
286 /* check broad isram_memcpy() */
287 pr_info("INFO: running broad isram_memcpy tests\n");
288 for (i
= 0xf; i
>= 0; --i
)
289 ret
+= _isram_memcpy_test(i
, sdram
, l1inst
, isram_memcpy
);
291 /* check read of small, unaligned, and hardware 64bit limits */
292 pr_info("INFO: running isram_memcpy (read) tests\n");
294 /* setup some different data to play with */
295 for (i
= 0; i
< test_len
; ++i
)
297 dma_memcpy(l1inst
, sdram
, test_len
);
300 for (i
= 0; i
< test_len
- 32; ++i
) {
301 unsigned char cmp
[32];
302 for (j
= 1; j
<= 32; ++j
) {
303 memset(cmp
, 0, sizeof(cmp
));
304 isram_memcpy(cmp
, l1inst
+ i
, j
);
305 if (memcmp(cmp
, sdram
+ i
, j
)) {
306 pr_err("FAIL: %p:", l1inst
+ 1);
309 hex_dump(sdram
+ i
, j
);
311 if (++thisret
> 20) {
312 pr_err("FAIL: skipping remaining series\n");
321 /* check write of small, unaligned, and hardware 64bit limits */
322 pr_info("INFO: running isram_memcpy (write) tests\n");
324 memset(sdram
+ test_len
, 0, test_len
);
325 dma_memcpy(l1inst
, sdram
+ test_len
, test_len
);
328 for (i
= 0; i
< test_len
- 32; ++i
) {
329 unsigned char cmp
[32];
330 for (j
= 1; j
<= 32; ++j
) {
331 isram_memcpy(l1inst
+ i
, sdram
+ i
, j
);
332 dma_memcpy(cmp
, l1inst
+ i
, j
);
333 if (memcmp(cmp
, sdram
+ i
, j
)) {
334 pr_err("FAIL: %p:", l1inst
+ i
);
337 hex_dump(sdram
+ i
, j
);
339 if (++thisret
> 20) {
340 pr_err("FAIL: skipping remaining series\n");
352 static __init
int isram_test_init(void)
358 /* Try to test as much of L1SRAM as possible */
361 l1inst
= l1_inst_sram_alloc(test_len
);
366 pr_warning("SKIP: could not allocate L1 inst\n");
369 pr_info("INFO: testing %#x bytes (%p - %p)\n",
370 test_len
, l1inst
, l1inst
+ test_len
);
372 sdram
= kmalloc(test_len
* 2, GFP_KERNEL
);
375 pr_warning("SKIP: could not allocate sdram\n");
379 /* sanity check initial L1 inst state */
381 pr_info("INFO: running initial dma_memcpy checks %p\n", sdram
);
382 if (_isram_memcpy_test(0xa, sdram
, l1inst
, dma_memcpy
))
384 if (_isram_memcpy_test(0x5, sdram
, l1inst
, dma_memcpy
))
388 ret
+= isram_read_test(sdram
, l1inst
);
389 ret
+= isram_write_test(sdram
, l1inst
);
390 ret
+= isram_memcpy_test(sdram
, l1inst
);
399 pr_info("PASS: all tests worked !\n");
402 late_initcall(isram_test_init
);
404 static __exit
void isram_test_exit(void)
406 /* stub to allow unloading */
408 module_exit(isram_test_exit
);