| 1 | /* |
| 2 | * Flattened Image Tree loader. |
| 3 | * |
| 4 | * Copyright (c) 2016 Imagination Technologies |
| 5 | * |
| 6 | * This library is free software; you can redistribute it and/or |
| 7 | * modify it under the terms of the GNU Lesser General Public |
| 8 | * License as published by the Free Software Foundation; either |
| 9 | * version 2.1 of the License, or (at your option) any later version. |
| 10 | * |
| 11 | * This library is distributed in the hope that it will be useful, |
| 12 | * but WITHOUT ANY WARRANTY; without even the implied warranty of |
| 13 | * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU |
| 14 | * Lesser General Public License for more details. |
| 15 | * |
| 16 | * You should have received a copy of the GNU Lesser General Public |
| 17 | * License along with this library; if not, see <http://www.gnu.org/licenses/>. |
| 18 | */ |
| 19 | |
| 20 | #ifndef HW_LOADER_FIT_H |
| 21 | #define HW_LOADER_FIT_H |
| 22 | |
| 23 | #include "exec/hwaddr.h" |
| 24 | |
| 25 | struct fit_loader_match { |
| 26 | const char *compatible; |
| 27 | const void *data; |
| 28 | }; |
| 29 | |
| 30 | struct fit_loader { |
| 31 | const struct fit_loader_match *matches; |
| 32 | hwaddr (*addr_to_phys)(void *opaque, uint64_t addr); |
| 33 | void *(*fdt_filter)(void *opaque, const void *fdt, |
| 34 | const void *match_data, hwaddr *load_addr); |
| 35 | const void *(*kernel_filter)(void *opaque, const void *kernel, |
| 36 | hwaddr *load_addr, hwaddr *entry_addr); |
| 37 | }; |
| 38 | |
| 39 | /** |
| 40 | * load_fit: load a FIT format image |
| 41 | * @ldr: structure defining board specific properties and hooks |
| 42 | * @filename: image to load |
| 43 | * @pfdt: pointer to update with address of FDT blob |
| 44 | * @opaque: opaque value passed back to the hook functions in @ldr |
| 45 | * Returns: 0 on success, or a negative errno on failure |
| 46 | * |
| 47 | * @pfdt is used to tell the caller about the FDT blob. On return, it |
| 48 | * has been set to point to the FDT blob, and it is now the caller's |
| 49 | * responsibility to free that memory with g_free(). Usually the caller |
| 50 | * will want to pass in &machine->fdt here, to record the FDT blob for |
| 51 | * the dumpdtb option and QMP/HMP commands. |
| 52 | */ |
| 53 | int load_fit(const struct fit_loader *ldr, const char *filename, void **pfdt, |
| 54 | void *opaque); |
| 55 | |
| 56 | #endif /* HW_LOADER_FIT_H */ |