1266301Sandrew/*- 2266301Sandrew * Copyright (c) 2014 Andrew Turner 3266301Sandrew * All rights reserved. 4266301Sandrew * 5266301Sandrew * Redistribution and use in source and binary forms, with or without 6266301Sandrew * modification, are permitted provided that the following conditions 7266301Sandrew * are met: 8266301Sandrew * 1. Redistributions of source code must retain the above copyright 9266301Sandrew * notice, this list of conditions and the following disclaimer. 10266301Sandrew * 2. Redistributions in binary form must reproduce the above copyright 11266301Sandrew * notice, this list of conditions and the following disclaimer in the 12266301Sandrew * documentation and/or other materials provided with the distribution. 13266301Sandrew * 14266301Sandrew * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND 15266301Sandrew * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 16266301Sandrew * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 17266301Sandrew * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE 18266301Sandrew * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 19266301Sandrew * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 20266301Sandrew * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 21266301Sandrew * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 22266301Sandrew * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 23266301Sandrew * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 24266301Sandrew * SUCH DAMAGE. 25266301Sandrew * 26266301Sandrew * $FreeBSD$ 27266301Sandrew */ 28266301Sandrew 29266301Sandrew#ifndef _MACHINE_PLATFORM_H_ 30266301Sandrew#define _MACHINE_PLATFORM_H_ 31266301Sandrew 32270081Sian/* 33270081Sian * Initialization functions called by the common initarm() function in 34270081Sian * arm/machdep.c (but not necessarily from the custom initarm() functions of 35270081Sian * older code). 36270081Sian * 37270081Sian * - platform_probe_and_attach() is called very early, after parsing the boot 38270081Sian * params and after physical memory has been located and sized. 39270081Sian * 40270081Sian * - platform_devmap_init() is called as one of the last steps of early virtual 41270081Sian * memory initialization, shortly before the new page tables are installed. 42270081Sian * 43270081Sian * - platform_lastaddr() is called after platform_devmap_init(), and must return 44270081Sian * the address of the first byte of unusable KVA space. This allows a 45270081Sian * platform to carve out of the top of the KVA space whatever reserves it 46270081Sian * needs for things like static device mapping, and this is called to get the 47270081Sian * value before calling pmap_bootstrap() which uses the value to size the 48270081Sian * available KVA. 49270081Sian * 50270081Sian * - platform_gpio_init() is called after the static device mappings are 51270081Sian * established and just before cninit(). The intention is that the routine 52270081Sian * can do any hardware setup (such as gpio or pinmux) necessary to make the 53270081Sian * console functional. 54270081Sian * 55270081Sian * - platform_late_init() is called just after cninit(). This is the first of 56270081Sian * the init routines that can use printf() and expect the output to appear on 57270081Sian * a standard console. 58270081Sian * 59270081Sian */ 60266301Sandrewvoid platform_probe_and_attach(void); 61266301Sandrewint platform_devmap_init(void); 62266301Sandrewvm_offset_t platform_lastaddr(void); 63266301Sandrewvoid platform_gpio_init(void); 64266301Sandrewvoid platform_late_init(void); 65266301Sandrew 66266301Sandrew#endif /* _MACHINE_PLATFORM_H_ */ 67