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
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
|
/* SPDX-License-Identifier: BSD-2-Clause */
/*
* Copyright (c) 2016, Linaro Limited
* All rights reserved.
*/
#ifndef KERNEL_DT_H
#define KERNEL_DT_H
#include <compiler.h>
#include <stdint.h>
#include <types_ext.h>
#include <util.h>
/*
* Bitfield to reflect status and secure-status values ("okay", "disabled"
* or not present)
*/
#define DT_STATUS_DISABLED 0
#define DT_STATUS_OK_NSEC BIT(0)
#define DT_STATUS_OK_SEC BIT(1)
#if defined(CFG_DT)
/*
* DT-aware drivers
*/
struct dt_device_match {
const char *compatible;
};
struct dt_driver {
const char *name;
const struct dt_device_match *match_table; /* null-terminated */
const void *driver;
};
#define __dt_driver __section(".rodata.dtdrv")
/*
* Find a driver that is suitable for the given DT node, that is, with
* a matching "compatible" property.
*
* @fdt: pointer to the device tree
* @offs: node offset
*/
const struct dt_driver *dt_find_compatible_driver(const void *fdt, int offs);
const struct dt_driver *__dt_driver_start(void);
const struct dt_driver *__dt_driver_end(void);
/*
* Map a device into secure or non-secure memory and return the base VA and
* the mapping size. The mapping is done with type MEM_AREA_IO_SEC or
* MEM_AREA_IO_NSEC, depending on the device status.
* If the mapping already exists, the function simply returns the @vbase and
* @size information.
*
* @offs is the offset of the node that describes the device in @fdt.
* @base receives the base virtual address corresponding to the base physical
* address of the "reg" property
* @size receives the size of the mapping
*
* Returns 0 on success or -1 in case of error.
*/
int dt_map_dev(const void *fdt, int offs, vaddr_t *base, size_t *size);
/*
* Check whether the node at @offs contains the property with propname or not.
*
* @offs is the offset of the node that describes the device in @fdt.
* @propname is the property that need to check
*
* Returns true on success or false if no propname.
*/
bool dt_have_prop(const void *fdt, int offs, const char *propname);
/*
* FDT manipulation functions, not provided by <libfdt.h>
*/
/*
* Return the base address for the "reg" property of the specified node or
* (paddr_t)-1 in case of error
*/
paddr_t _fdt_reg_base_address(const void *fdt, int offs);
/*
* Return the reg size for the reg property of the specified node or -1 in case
* of error
*/
ssize_t _fdt_reg_size(const void *fdt, int offs);
/*
* Read the status and secure-status properties into a bitfield.
* @status is set to DT_STATUS_DISABLED or a combination of DT_STATUS_OK_NSEC
* and DT_STATUS_OK_SEC
* Returns 0 on success or -1 in case of error.
*/
int _fdt_get_status(const void *fdt, int offs);
#else /* !CFG_DT */
static inline const struct dt_driver *__dt_driver_start(void)
{
return NULL;
}
static inline const struct dt_driver *__dt_driver_end(void)
{
return NULL;
}
static inline const struct dt_driver *dt_find_compatible_driver(
const void *fdt __unused,
int offs __unused)
{
return NULL;
}
static inline int dt_map_dev(const void *fdt __unused, int offs __unused,
vaddr_t *vbase __unused, size_t *size __unused)
{
return -1;
}
static inline paddr_t _fdt_reg_base_address(const void *fdt __unused,
int offs __unused)
{
return (paddr_t)-1;
}
static inline ssize_t _fdt_reg_size(const void *fdt __unused,
int offs __unused)
{
return -1;
}
static inline int _fdt_get_status(const void *fdt __unused, int offs __unused)
{
return -1;
}
#endif /* !CFG_DT */
#define for_each_dt_driver(drv) \
for (drv = __dt_driver_start(); drv < __dt_driver_end(); drv++)
#endif /* KERNEL_DT_H */
|
