| Aaron Durbin | cddcc80 | 2013-02-08 17:15:53 -0600 | [diff] [blame] | 1 | /* |
| 2 | * This file is part of the coreboot project. |
| 3 | * |
| 4 | * Copyright (C) 2013 ChromeOS Authors |
| 5 | * |
| 6 | * This program is free software; you can redistribute it and/or modify |
| 7 | * it under the terms of the GNU General Public License as published by |
| 8 | * the Free Software Foundation; version 2 of the License. |
| 9 | * |
| 10 | * This program is distributed in the hope that it will be useful, |
| 11 | * but WITHOUT ANY WARRANTY; without even the implied warranty of |
| 12 | * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
| 13 | * GNU General Public License for more details. |
| 14 | * |
| 15 | * You should have received a copy of the GNU General Public License |
| 16 | * along with this program; if not, write to the Free Software |
| 17 | * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA |
| 18 | */ |
| 19 | #ifndef ROMSTAGE_HANDOFF_H |
| 20 | #define ROMSTAGE_HANDOFF_H |
| 21 | |
| 22 | #include <stdint.h> |
| Aaron Durbin | f2b20d8 | 2013-02-11 21:07:18 -0600 | [diff] [blame] | 23 | #include <string.h> |
| 24 | #include <cbmem.h> |
| Aaron Durbin | cddcc80 | 2013-02-08 17:15:53 -0600 | [diff] [blame] | 25 | |
| 26 | /* It is the chipset's responsbility for maintaining the integrity of this |
| 27 | * structure in CBMEM. For instance, if chipset code adds this structure |
| 28 | * using the CBMEM_ID_ROMSTAGE_INFO id it needs to ensure it doesn't clobber |
| 29 | * fields it doesn't own. */ |
| 30 | struct romstage_handoff { |
| 31 | /* This indicates to the ramstage to reserve a chunk of memory. */ |
| 32 | uint32_t reserve_base; |
| 33 | uint32_t reserve_size; |
| Aaron Durbin | 159f2ef | 2013-02-12 00:50:47 -0600 | [diff] [blame^] | 34 | /* Inidicate if the current boot is an S3 resume. If |
| 35 | * CONFIG_RELOCTABLE_RAMSTAGE is enabled the chipset code is |
| 36 | * responsible for initializing this variable. Otherwise, ramstage |
| 37 | * will be re-loaded from cbfs (which can be slower since it lives |
| 38 | * in flash). */ |
| Aaron Durbin | c00457d | 2013-02-11 21:15:12 -0600 | [diff] [blame] | 39 | uint32_t s3_resume; |
| Aaron Durbin | 159f2ef | 2013-02-12 00:50:47 -0600 | [diff] [blame^] | 40 | /* The ramstage_entry_point is cached in the stag loading path. This |
| 41 | * cached value can only be utilized when the chipset code properly |
| 42 | * fills in the s3_resume field above. */ |
| 43 | uint32_t ramstage_entry_point; |
| Aaron Durbin | cddcc80 | 2013-02-08 17:15:53 -0600 | [diff] [blame] | 44 | }; |
| 45 | |
| Aaron Durbin | f2b20d8 | 2013-02-11 21:07:18 -0600 | [diff] [blame] | 46 | #if defined(__PRE_RAM__) |
| 47 | /* The romstage_handoff_find_or_add() function provides the necessary logic |
| 48 | * for initializng the romstage_handoff structure in cbmem. Different components |
| 49 | * of the romstage may be responsible for setting up different fields. Therefore |
| 50 | * that same logic flow should be used for allocating and initializing the |
| 51 | * structure. A newly allocated structure will be memset to 0. */ |
| 52 | static inline struct romstage_handoff *romstage_handoff_find_or_add(void) |
| 53 | { |
| 54 | struct romstage_handoff *handoff; |
| 55 | |
| 56 | /* cbmem_add() first does a find and uses the old location before the |
| 57 | * real add. However, it is important to know when the structure is not |
| 58 | * found so it can be initialized to 0. */ |
| 59 | handoff = cbmem_find(CBMEM_ID_ROMSTAGE_INFO); |
| 60 | |
| 61 | if (handoff == NULL) { |
| 62 | handoff = cbmem_add(CBMEM_ID_ROMSTAGE_INFO, sizeof(*handoff)); |
| 63 | if (handoff != NULL) |
| 64 | memset(handoff, 0, sizeof(*handoff)); |
| 65 | } |
| 66 | |
| 67 | return handoff; |
| 68 | } |
| 69 | #endif |
| 70 | |
| Aaron Durbin | cddcc80 | 2013-02-08 17:15:53 -0600 | [diff] [blame] | 71 | #endif /* ROMSTAGE_HANDOFF_H */ |
| 72 | |