1 /* SPDX-License-Identifier: GPL-2.0+ */ 2 /* 3 * Copyright (c) 2011 The Chromium OS Authors. 4 * 5 * (C) Copyright 2002 6 * Sysgo Real-Time Solutions, GmbH <www.elinos.com> 7 * Marius Groeger <mgroeger@sysgo.de> 8 * 9 * (C) Copyright 2002 10 * Sysgo Real-Time Solutions, GmbH <www.elinos.com> 11 * Alex Zuepke <azu@sysgo.de> 12 */ 13 14 #ifndef _U_BOOT_SANDBOX_H_ 15 #define _U_BOOT_SANDBOX_H_ 16 17 /* board/.../... */ 18 int board_init(void); 19 20 /* start.c */ 21 int sandbox_early_getopt_check(void); 22 int sandbox_main_loop_init(void); 23 24 int cleanup_before_linux(void); 25 26 /* drivers/video/sandbox_sdl.c */ 27 int sandbox_lcd_sdl_early_init(void); 28 29 /** 30 * pci_map_physmem() - map a PCI device into memory 31 * 32 * This is used on sandbox to map a device into memory so that it can be 33 * used with normal memory access. After this call, some part of the device's 34 * internal structure becomes visible. 35 * 36 * This function is normally called from sandbox's map_sysmem() automatically. 37 * 38 * @paddr: Physical memory address, normally corresponding to a PCI BAR 39 * @lenp: On entry, the size of the area to map, On exit it is updated 40 * to the size actually mapped, which may be less if the device 41 * has less space 42 * @devp: Returns the device which mapped into this space 43 * @ptrp: Returns a pointer to the mapped address. The device's space 44 * can be accessed as @lenp bytes starting here 45 * @return 0 if OK, -ve on error 46 */ 47 int pci_map_physmem(phys_addr_t paddr, unsigned long *lenp, 48 struct udevice **devp, void **ptrp); 49 50 /** 51 * pci_unmap_physmem() - undo a memory mapping 52 * 53 * This must be called after pci_map_physmem() to undo the mapping. 54 * 55 * @paddr: Physical memory address, as passed to pci_map_physmem() 56 * @len: Size of area mapped, as returned by pci_map_physmem() 57 * @dev: Device to unmap, as returned by pci_map_physmem() 58 * @return 0 if OK, -ve on error 59 */ 60 int pci_unmap_physmem(const void *addr, unsigned long len, 61 struct udevice *dev); 62 63 /** 64 * sandbox_set_enable_pci_map() - Enable / disable PCI address mapping 65 * 66 * Since address mapping involves calling every driver, provide a way to 67 * enable and disable this. It can be handled automatically by the emulator 68 * uclass, which knows if any emulators are currently active. 69 * 70 * If this is disabled, pci_map_physmem() will not be called from 71 * map_sysmem(). 72 * 73 * @enable: 0 to disable, 1 to enable 74 */ 75 void sandbox_set_enable_pci_map(int enable); 76 77 /** 78 * sandbox_read_fdt_from_file() - Read a device tree from a file 79 * 80 * Read a device tree file from a host file and set it up for use as the 81 * control FDT. 82 */ 83 int sandbox_read_fdt_from_file(void); 84 85 /* Exit sandbox (quit U-Boot) */ 86 void sandbox_exit(void); 87 88 #endif /* _U_BOOT_SANDBOX_H_ */ 89