1 /* SPDX-License-Identifier: GPL-2.0+ */
3 * Copyright (c) 2012 The Chromium OS Authors.
4 * (C) Copyright 2002-2010
5 * Wolfgang Denk, DENX Software Engineering, wd@denx.de.
8 #ifndef __ASM_GENERIC_GBL_DATA_H
9 #define __ASM_GENERIC_GBL_DATA_H
11 * The following data structure is placed in some memory which is
12 * available very early after boot (like DPRAM on MPC8xx/MPC82xx, or
13 * some locked parts of the data cache) to allow for a minimum set of
14 * global variables during system initialization (until we have set
15 * up the memory controller so that we can use RAM).
17 * Keep it *SMALL* and remember to set GENERATED_GBL_DATA_SIZE > sizeof(gd_t)
19 * Each architecture has its own private fields. For now all are private
24 #include <event_internal.h>
27 #include <linux/list.h>
28 #include <linux/build_bug.h>
29 #include <asm-offsets.h>
34 typedef struct global_data gd_t;
37 * struct global_data - global data structure
41 * @bd: board information
45 * @flags: global data flags
51 * @baudrate: baud rate of the serial interface
53 unsigned int baudrate;
55 * @cpu_clk: CPU clock rate in Hz
57 unsigned long cpu_clk;
59 * @bus_clk: platform clock rate in Hz
61 unsigned long bus_clk;
63 * @pci_clk: PCI clock rate in Hz
65 /* We cannot bracket this with CONFIG_PCI due to mpc5xxx */
66 unsigned long pci_clk;
68 * @mem_clk: memory clock rate in Hz
70 unsigned long mem_clk;
71 #if CONFIG_IS_ENABLED(VIDEO)
73 * @fb_base: base address of frame buffer memory
75 unsigned long fb_base;
77 #if defined(CONFIG_POST)
79 * @post_log_word: active POST tests
81 * @post_log_word is a bit mask defining which POST tests are recorded
82 * (see constants POST_*).
84 unsigned long post_log_word;
86 * @post_log_res: POST results
88 * @post_log_res is a bit mask with the POST results. A bit with value 1
89 * indicates successful execution.
91 unsigned long post_log_res;
93 * @post_init_f_time: time in ms when post_init_f() started
95 unsigned long post_init_f_time;
97 #ifdef CONFIG_BOARD_TYPES
99 * @board_type: board type
101 * If a U-Boot configuration supports multiple board types, the actual
102 * board type may be stored in this field.
104 unsigned long board_type;
107 * @have_console: console is available
109 * A value of 1 indicates that serial_init() was called and a console
111 * A value of 0 indicates that console input and output drivers shall
114 unsigned long have_console;
115 #if CONFIG_IS_ENABLED(PRE_CONSOLE_BUFFER)
117 * @precon_buf_idx: pre-console buffer index
119 * @precon_buf_idx indicates the current position of the
120 * buffer used to collect output before the console becomes
121 * available. When negative, the pre-console buffer is
122 * temporarily disabled (used when the pre-console buffer is
123 * being written out, to prevent adding its contents to
129 * @env_addr: address of environment structure
131 * @env_addr contains the address of the structure holding the
132 * environment variables.
134 unsigned long env_addr;
136 * @env_valid: environment is valid
138 * See &enum env_valid
140 unsigned long env_valid;
142 * @env_has_init: bit mask indicating environment locations
144 * &enum env_location defines which bit relates to which location
146 unsigned long env_has_init;
148 * @env_load_prio: priority of the loaded environment
152 * @ram_base: base address of RAM used by U-Boot
154 unsigned long ram_base;
156 * @ram_top: top address of RAM used by U-Boot
160 * @relocaddr: start address of U-Boot in RAM
162 * After relocation this field indicates the address to which U-Boot
163 * has been relocated. It can be displayed using the bdinfo command.
164 * Its value is needed to display the source code when debugging with
165 * GDB using the 'add-symbol-file u-boot <relocaddr>' command.
167 unsigned long relocaddr;
169 * @ram_size: RAM size in bytes
171 phys_size_t ram_size;
173 * @mon_len: monitor length in bytes
175 unsigned long mon_len;
177 * @irq_sp: IRQ stack pointer
179 unsigned long irq_sp;
181 * @start_addr_sp: initial stack pointer address
183 unsigned long start_addr_sp;
185 * @reloc_off: relocation offset
187 unsigned long reloc_off;
189 * @new_gd: pointer to relocated global data
191 struct global_data *new_gd;
195 * @dm_root: root instance for Driver Model
197 struct udevice *dm_root;
200 * head of core tree when uclasses are not in read-only memory.
202 * When uclasses are in read-only memory, @uclass_root_s is not used and
203 * @uclass_root points to the root node generated by dtoc.
205 struct list_head uclass_root_s;
208 * pointer to head of core tree, if uclasses are in read-only memory and
209 * cannot be adjusted to use @uclass_root as a list head.
211 * When not in read-only memory, @uclass_root_s is used to hold the
212 * uclass root, and @uclass_root points to the address of
215 struct list_head *uclass_root;
216 # if CONFIG_IS_ENABLED(OF_PLATDATA_DRIVER_RT)
217 /** @dm_driver_rt: Dynamic info about the driver */
218 struct driver_rt *dm_driver_rt;
220 #if CONFIG_IS_ENABLED(OF_PLATDATA_RT)
221 /** @dm_udevice_rt: Dynamic info about the udevice */
222 struct udevice_rt *dm_udevice_rt;
224 * @dm_priv_base: Base address of the priv/plat region used when
225 * udevices and uclasses are in read-only memory. This is NULL if not
233 * @timer: timer instance for Driver Model
235 struct udevice *timer;
238 * @fdt_blob: U-Boot's own device tree, NULL if none
240 const void *fdt_blob;
242 * @new_fdt: relocated device tree
246 * @fdt_size: space reserved for relocated device space
248 unsigned long fdt_size;
250 * @fdt_src: Source of FDT
252 enum fdt_source_t fdt_src;
253 #if CONFIG_IS_ENABLED(OF_LIVE)
255 * @of_root: root node of the live tree
257 struct device_node *of_root;
260 #if CONFIG_IS_ENABLED(MULTI_DTB_FIT)
262 * @multi_dtb_fit: pointer to uncompressed multi-dtb FIT image
264 const void *multi_dtb_fit;
269 * The jump table contains pointers to exported functions. A pointer to
270 * the jump table is passed to standalone applications.
274 * @env_buf: buffer for env_get() before reloc
279 * @trace_buff: trace buffer
281 * When tracing function in U-Boot this field points to the buffer
282 * recording the function calls.
286 #if CONFIG_IS_ENABLED(SYS_I2C_LEGACY)
288 * @cur_i2c_bus: currently used I2C bus
293 * @timebase_h: high 32 bits of timer
295 unsigned int timebase_h;
297 * @timebase_l: low 32 bits of timer
299 unsigned int timebase_l;
301 * @malloc_start: start of malloc() region
303 #if CONFIG_IS_ENABLED(CMD_BDINFO_EXTRA)
304 unsigned long malloc_start;
306 #if CONFIG_IS_ENABLED(SYS_MALLOC_F)
308 * @malloc_base: base address of early malloc()
310 unsigned long malloc_base;
312 * @malloc_limit: limit address of early malloc()
314 unsigned long malloc_limit;
316 * @malloc_ptr: current address of early malloc()
318 unsigned long malloc_ptr;
322 * @hose: PCI hose for early use
324 struct pci_controller *hose;
326 * @pci_ram_top: top of region accessible to PCI
328 phys_addr_t pci_ram_top;
330 #ifdef CONFIG_PCI_BOOTDELAY
332 * @pcidelay_done: delay time before scanning of PIC hose expired
334 * If CONFIG_PCI_BOOTDELAY=y, pci_hose_scan() waits for the number of
335 * milliseconds defined by environment variable pcidelay before
336 * scanning. Once this delay has expired the flag @pcidelay_done
342 * @cur_serial_dev: current serial device
344 struct udevice *cur_serial_dev;
346 * @arch: architecture-specific data
348 struct arch_global_data arch;
349 #ifdef CONFIG_CONSOLE_RECORD
351 * @console_out: output buffer for console recording
353 * This buffer is used to collect output during console recording.
355 struct membuff console_out;
357 * @console_in: input buffer for console recording
359 * If console recording is activated, this buffer can be used to
362 struct membuff console_in;
364 #if CONFIG_IS_ENABLED(VIDEO)
366 * @video_top: top of video frame buffer area
370 * @video_bottom: bottom of video frame buffer area
374 #ifdef CONFIG_BOOTSTAGE
376 * @bootstage: boot stage information
378 struct bootstage_data *bootstage;
380 * @new_bootstage: relocated boot stage information
382 struct bootstage_data *new_bootstage;
386 * @log_drop_count: number of dropped log messages
388 * This counter is incremented for each log message which can not
389 * be processed because logging is not yet available as signaled by
390 * flag %GD_FLG_LOG_READY in @flags.
394 * @default_log_level: default logging level
396 * For logging devices without filters @default_log_level defines the
397 * logging level, cf. &enum log_level_t.
399 int default_log_level;
401 * @log_head: list of logging devices
403 struct list_head log_head;
405 * @log_fmt: bit mask for logging format
407 * The @log_fmt bit mask selects the fields to be shown in log messages.
408 * &enum log_fmt defines the bits of the bit mask.
413 * @processing_msg: a log message is being processed
415 * This flag is used to suppress the creation of additional messages
416 * while another message is being processed.
420 * @logc_prev: logging category of previous message
422 * This value is used as logging category for continuation messages.
426 * @logl_prev: logging level of the previous message
428 * This value is used as logging level for continuation messages.
432 * @log_cont: Previous log line did not finished wtih \n
434 * This allows for chained log messages on the same line
438 #if CONFIG_IS_ENABLED(BLOBLIST)
440 * @bloblist: blob list information
442 struct bloblist_hdr *bloblist;
444 * @new_bloblist: relocated blob list information
446 struct bloblist_hdr *new_bloblist;
448 #if CONFIG_IS_ENABLED(HANDOFF)
450 * @spl_handoff: SPL hand-off information
452 struct spl_handoff *spl_handoff;
454 #if defined(CONFIG_TRANSLATION_OFFSET)
456 * @translation_offset: optional translation offset
458 * See CONFIG_TRANSLATION_OFFSET.
460 fdt_addr_t translation_offset;
464 * @acpi_ctx: ACPI context pointer
466 struct acpi_ctx *acpi_ctx;
468 * @acpi_start: Start address of ACPI tables
472 #if CONFIG_IS_ENABLED(GENERATE_SMBIOS_TABLE)
474 * @smbios_version: Points to SMBIOS type 0 version
476 char *smbios_version;
478 #if CONFIG_IS_ENABLED(EVENT)
480 * @event_state: Points to the current state of events
482 struct event_state event_state;
484 #if CONFIG_IS_ENABLED(CYCLIC)
486 * @cyclic_list: list of registered cyclic functions
488 struct hlist_head cyclic_list;
491 * @dmtag_list: List of DM tags
493 struct list_head dmtag_list;
496 static_assert(sizeof(struct global_data) == GD_SIZE);
500 * gd_board_type() - retrieve board type
502 * Return: global board type
504 #ifdef CONFIG_BOARD_TYPES
505 #define gd_board_type() gd->board_type
507 #define gd_board_type() 0
510 /* These macros help avoid #ifdefs in the code */
511 #if CONFIG_IS_ENABLED(OF_LIVE)
512 #define gd_of_root() gd->of_root
513 #define gd_of_root_ptr() &gd->of_root
514 #define gd_set_of_root(_root) gd->of_root = (_root)
516 #define gd_of_root() NULL
517 #define gd_of_root_ptr() NULL
518 #define gd_set_of_root(_root)
521 #if CONFIG_IS_ENABLED(OF_PLATDATA_DRIVER_RT)
522 #define gd_set_dm_driver_rt(dyn) gd->dm_driver_rt = dyn
523 #define gd_dm_driver_rt() gd->dm_driver_rt
525 #define gd_set_dm_driver_rt(dyn)
526 #define gd_dm_driver_rt() NULL
529 #if CONFIG_IS_ENABLED(OF_PLATDATA_RT)
530 #define gd_set_dm_udevice_rt(dyn) gd->dm_udevice_rt = dyn
531 #define gd_dm_udevice_rt() gd->dm_udevice_rt
532 #define gd_set_dm_priv_base(dyn) gd->dm_priv_base = dyn
533 #define gd_dm_priv_base() gd->dm_priv_base
535 #define gd_set_dm_udevice_rt(dyn)
536 #define gd_dm_udevice_rt() NULL
537 #define gd_set_dm_priv_base(dyn)
538 #define gd_dm_priv_base() NULL
542 #define gd_acpi_ctx() gd->acpi_ctx
543 #define gd_acpi_start() gd->acpi_start
544 #define gd_set_acpi_start(addr) gd->acpi_start = addr
546 #define gd_acpi_ctx() NULL
547 #define gd_acpi_start() 0UL
548 #define gd_set_acpi_start(addr)
552 #define gd_smbios_start() gd->arch.smbios_start
553 #define gd_set_smbios_start(addr) gd->arch.smbios_start = addr
555 #define gd_smbios_start() 0UL
556 #define gd_set_smbios_start(addr)
559 #if CONFIG_IS_ENABLED(MULTI_DTB_FIT)
560 #define gd_multi_dtb_fit() gd->multi_dtb_fit
561 #define gd_set_multi_dtb_fit(_dtb) gd->multi_dtb_fit = _dtb
563 #define gd_multi_dtb_fit() NULL
564 #define gd_set_multi_dtb_fit(_dtb)
567 #if CONFIG_IS_ENABLED(EVENT_DYNAMIC)
568 #define gd_event_state() ((struct event_state *)&gd->event_state)
570 #define gd_event_state() NULL
573 #if CONFIG_IS_ENABLED(CMD_BDINFO_EXTRA)
574 #define gd_malloc_start() gd->malloc_start
575 #define gd_set_malloc_start(_val) gd->malloc_start = (_val)
577 #define gd_malloc_start() 0
578 #define gd_set_malloc_start(val)
581 #if CONFIG_IS_ENABLED(PCI)
582 #define gd_set_pci_ram_top(val) gd->pci_ram_top = val
584 #define gd_set_pci_ram_top(val)
587 #if CONFIG_VAL(SYS_MALLOC_F_LEN)
588 #define gd_malloc_ptr() gd->malloc_ptr
590 #define gd_malloc_ptr() 0L
594 * enum gd_flags - global data flags
596 * See field flags of &struct global_data.
600 * @GD_FLG_RELOC: code was relocated to RAM
602 GD_FLG_RELOC = 0x00001,
604 * @GD_FLG_DEVINIT: devices have been initialized
606 GD_FLG_DEVINIT = 0x00002,
608 * @GD_FLG_SILENT: silent mode
610 GD_FLG_SILENT = 0x00004,
612 * @GD_FLG_POSTFAIL: critical POST test failed
614 GD_FLG_POSTFAIL = 0x00008,
616 * @GD_FLG_POSTSTOP: POST sequence aborted
618 GD_FLG_POSTSTOP = 0x00010,
620 * @GD_FLG_LOGINIT: log Buffer has been initialized
622 GD_FLG_LOGINIT = 0x00020,
624 * @GD_FLG_DISABLE_CONSOLE: disable console (in & out)
626 GD_FLG_DISABLE_CONSOLE = 0x00040,
628 * @GD_FLG_ENV_READY: environment imported into hash table
630 GD_FLG_ENV_READY = 0x00080,
632 * @GD_FLG_SERIAL_READY: pre-relocation serial console ready
634 GD_FLG_SERIAL_READY = 0x00100,
636 * @GD_FLG_FULL_MALLOC_INIT: full malloc() is ready
638 GD_FLG_FULL_MALLOC_INIT = 0x00200,
640 * @GD_FLG_SPL_INIT: spl_init() has been called
642 GD_FLG_SPL_INIT = 0x00400,
644 * @GD_FLG_SKIP_RELOC: don't relocate
646 GD_FLG_SKIP_RELOC = 0x00800,
648 * @GD_FLG_RECORD: record console
650 GD_FLG_RECORD = 0x01000,
652 * @GD_FLG_RECORD_OVF: record console overflow
654 GD_FLG_RECORD_OVF = 0x02000,
656 * @GD_FLG_ENV_DEFAULT: default variable flag
658 GD_FLG_ENV_DEFAULT = 0x04000,
660 * @GD_FLG_SPL_EARLY_INIT: early SPL initialization is done
662 GD_FLG_SPL_EARLY_INIT = 0x08000,
664 * @GD_FLG_LOG_READY: log system is ready for use
666 GD_FLG_LOG_READY = 0x10000,
668 * @GD_FLG_CYCLIC_RUNNING: cyclic_run is in progress
670 GD_FLG_CYCLIC_RUNNING = 0x20000,
672 * @GD_FLG_SKIP_LL_INIT: don't perform low-level initialization
674 GD_FLG_SKIP_LL_INIT = 0x40000,
676 * @GD_FLG_SMP_READY: SMP initialization is complete
678 GD_FLG_SMP_READY = 0x80000,
680 * @GD_FLG_FDT_CHANGED: Device tree change has been detected by tests
682 GD_FLG_FDT_CHANGED = 0x100000,
684 * @GD_FLG_OF_TAG_MIGRATE: Device tree has old u-boot,dm- tags
686 GD_FLG_OF_TAG_MIGRATE = 0x200000,
688 * @GD_FLG_DM_DEAD: Driver model is not accessible. This can be set when
689 * the memory used to holds its tables has been mapped out.
691 GD_FLG_DM_DEAD = 0x400000,
693 * @GD_FLG_BLOBLIST_READY: bloblist is ready for use
695 GD_FLG_BLOBLIST_READY = 0x800000,
697 * @GD_FLG_HUSH_OLD_PARSER: Use hush old parser.
699 GD_FLG_HUSH_OLD_PARSER = 0x1000000,
701 * @GD_FLG_HUSH_MODERN_PARSER: Use hush 2021 parser.
703 GD_FLG_HUSH_MODERN_PARSER = 0x2000000,
706 #endif /* __ASSEMBLY__ */
708 #endif /* __ASM_GENERIC_GBL_DATA_H */