arch/sandbox/include/asm/u-boot-sandbox.h

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