summaryrefslogtreecommitdiff
path: root/components/mm/ioremap.h
blob: f17b5d5fff71e47d3f8896b67f2746a4b91a25d9 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
/*
 * Copyright (c) 2006-2020, RT-Thread Development Team
 *
 * SPDX-License-Identifier: Apache-2.0
 *
 * Change Logs:
 * Date           Author       Notes
 * 2021-05-06     Jesven       first version
 */
#ifndef  __IOREMAP_H__
#define  __IOREMAP_H__

#include <stddef.h>

#ifdef __cplusplus
extern "C" {
#endif

/**
 * IOREMAP family
 * `rt_ioremap` default to map physical memory in MMIO region as DEVICE memory
 * to kernel space. And there are 3 variants currently supported.
 *
 * name               | attribution
 * ------------------ | -----------
 * rt_ioremap_nocache | Device (MMU_MAP_K_DEVICE)
 * rt_ioremap_cache   | Normal memory (MMU_MAP_K_RWCB)
 * rt_ioremap_wt      | Normal memory but guarantee that
 *                    | Each write access should go to system memory directly
 *                    | Currently as non-cacheable
 */

void *rt_ioremap_early(void *paddr, size_t size);
void *rt_ioremap(void *paddr, size_t size);
void *rt_ioremap_nocache(void *paddr, size_t size);
void *rt_ioremap_cached(void *paddr, size_t size);
void *rt_ioremap_wt(void *paddr, size_t size);
void rt_iounmap(volatile void *addr);

extern void *rt_ioremap_start;
extern size_t rt_ioremap_size;

#ifdef __cplusplus
}
#endif

#endif  /*__LWP_IOREMAP_H__*/