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 | |
Martin Roth | 0cb07e3 | 2013-07-09 21:46:01 -0600 | [diff] [blame] | 26 | /* It is the chipset's responsibility for maintaining the integrity of this |
Aaron Durbin | cddcc80 | 2013-02-08 17:15:53 -0600 | [diff] [blame] | 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 { |
Martin Roth | 0cb07e3 | 2013-07-09 21:46:01 -0600 | [diff] [blame] | 31 | /* Indicate if the current boot is an S3 resume. If |
Aaron Durbin | 159f2ef | 2013-02-12 00:50:47 -0600 | [diff] [blame] | 32 | * CONFIG_RELOCTABLE_RAMSTAGE is enabled the chipset code is |
| 33 | * responsible for initializing this variable. Otherwise, ramstage |
| 34 | * will be re-loaded from cbfs (which can be slower since it lives |
| 35 | * in flash). */ |
Aaron Durbin | c00457d | 2013-02-11 21:15:12 -0600 | [diff] [blame] | 36 | uint32_t s3_resume; |
Aaron Durbin | 159f2ef | 2013-02-12 00:50:47 -0600 | [diff] [blame] | 37 | /* The ramstage_entry_point is cached in the stag loading path. This |
| 38 | * cached value can only be utilized when the chipset code properly |
| 39 | * fills in the s3_resume field above. */ |
| 40 | uint32_t ramstage_entry_point; |
Aaron Durbin | cddcc80 | 2013-02-08 17:15:53 -0600 | [diff] [blame] | 41 | }; |
| 42 | |
Aaron Durbin | f2b20d8 | 2013-02-11 21:07:18 -0600 | [diff] [blame] | 43 | #if defined(__PRE_RAM__) |
Aaron Durbin | 0f33307 | 2014-01-30 17:19:46 -0600 | [diff] [blame^] | 44 | #if CONFIG_EARLY_CBMEM_INIT |
Aaron Durbin | f2b20d8 | 2013-02-11 21:07:18 -0600 | [diff] [blame] | 45 | /* The romstage_handoff_find_or_add() function provides the necessary logic |
Martin Roth | 0cb07e3 | 2013-07-09 21:46:01 -0600 | [diff] [blame] | 46 | * for initializing the romstage_handoff structure in cbmem. Different components |
Aaron Durbin | f2b20d8 | 2013-02-11 21:07:18 -0600 | [diff] [blame] | 47 | * of the romstage may be responsible for setting up different fields. Therefore |
| 48 | * that same logic flow should be used for allocating and initializing the |
| 49 | * structure. A newly allocated structure will be memset to 0. */ |
| 50 | static inline struct romstage_handoff *romstage_handoff_find_or_add(void) |
| 51 | { |
| 52 | struct romstage_handoff *handoff; |
| 53 | |
| 54 | /* cbmem_add() first does a find and uses the old location before the |
| 55 | * real add. However, it is important to know when the structure is not |
| 56 | * found so it can be initialized to 0. */ |
| 57 | handoff = cbmem_find(CBMEM_ID_ROMSTAGE_INFO); |
| 58 | |
| 59 | if (handoff == NULL) { |
| 60 | handoff = cbmem_add(CBMEM_ID_ROMSTAGE_INFO, sizeof(*handoff)); |
| 61 | if (handoff != NULL) |
| 62 | memset(handoff, 0, sizeof(*handoff)); |
| 63 | } |
| 64 | |
| 65 | return handoff; |
| 66 | } |
Aaron Durbin | 0f33307 | 2014-01-30 17:19:46 -0600 | [diff] [blame^] | 67 | #else /* CONFIG_EARLY_CBMEM_INIT */ |
| 68 | static inline struct romstage_handoff *romstage_handoff_find_or_add(void) |
| 69 | { |
| 70 | return NULL; |
| 71 | } |
| 72 | #endif /* CONFIG_EARLY_CBMEM_INIT */ |
| 73 | |
| 74 | #endif /* defined(__PRE_RAM__) */ |
Aaron Durbin | f2b20d8 | 2013-02-11 21:07:18 -0600 | [diff] [blame] | 75 | |
Aaron Durbin | cddcc80 | 2013-02-08 17:15:53 -0600 | [diff] [blame] | 76 | #endif /* ROMSTAGE_HANDOFF_H */ |
| 77 | |