No warnings day, next round.
[coreboot.git] / src / Kconfig
1 ##
2 ## This file is part of the coreboot project.
3 ##
4 ## Copyright (C) 2009-2010 coresystems GmbH
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
20 mainmenu "Coreboot Configuration"
21
22 menu "General setup"
23
24 config EXPERT
25         bool "Expert mode"
26         help
27           This allows you to select certain advanced configuration options.
28
29           Warning: Only enable this option if you really know what you are
30           doing! You have been warned!
31
32 config LOCALVERSION
33         string "Local version string"
34         help
35           Append an extra string to the end of the coreboot version.
36
37           This can be useful if, for instance, you want to append the
38           respective board's hostname or some other identifying string to
39           the coreboot version number, so that you can easily distinguish
40           boot logs of different boards from each other.
41
42 config CBFS_PREFIX
43         string "CBFS prefix to use"
44         default "fallback"
45         help
46           Select the prefix to all files put into the image. It's "fallback"
47           by default, "normal" is a common alternative.
48
49 choice
50         prompt "Compiler"
51         default COMPILER_GCC
52         help
53           This option allows you to select the compiler used for building
54           coreboot.
55
56 config COMPILER_GCC
57         bool "GCC"
58 config COMPILER_LLVM_CLANG
59         bool "LLVM/clang"
60 endchoice
61
62 config SCANBUILD_ENABLE
63         bool "Build with scan-build for static analysis"
64         default n
65         help
66           Changes the build process to scan-build is used.
67           Requires scan-build in path.
68
69 config SCANBUILD_REPORT_LOCATION
70         string "Directory to put scan-build report in"
71         default ""
72         depends on SCANBUILD_ENABLE
73         help
74           Where the scan-build report should be stored
75
76 config CCACHE
77         bool "ccache"
78         default n
79         help
80           Enables the use of ccache for faster builds.
81           Requires ccache in path.
82
83 endmenu
84
85 source src/mainboard/Kconfig
86 source src/arch/i386/Kconfig
87
88 menu "Chipset"
89
90 comment "CPU"
91 source src/cpu/Kconfig
92 comment "Northbridge"
93
94 menu "HyperTransport setup"
95         depends on (NORTHBRIDGE_AMD_AMDK8 || NORTHBRIDGE_AMD_AMDFAM10) && EXPERT
96
97 choice
98         prompt "HyperTransport frequency"
99         default LIMIT_HT_SPEED_AUTO
100         help
101           This option sets the maximum permissible HyperTransport link
102           frequency.
103
104           Use of this option will only limit the autodetected HT frequency.
105           It will not (and cannot) increase the frequency beyond the
106           autodetected limits.
107
108           This is primarily used to work around poorly designed or laid out
109           HT traces on certain motherboards.
110
111 config LIMIT_HT_SPEED_200
112         bool "Limit HT frequency to 200MHz"
113 config LIMIT_HT_SPEED_400
114         bool "Limit HT frequency to 400MHz"
115 config LIMIT_HT_SPEED_600
116         bool "Limit HT frequency to 600MHz"
117 config LIMIT_HT_SPEED_800
118         bool "Limit HT frequency to 800MHz"
119 config LIMIT_HT_SPEED_1000
120         bool "Limit HT frequency to 1.0GHz"
121 config LIMIT_HT_SPEED_1200
122         bool "Limit HT frequency to 1.2GHz"
123 config LIMIT_HT_SPEED_1400
124         bool "Limit HT frequency to 1.4GHz"
125 config LIMIT_HT_SPEED_1600
126         bool "Limit HT frequency to 1.6GHz"
127 config LIMIT_HT_SPEED_1800
128         bool "Limit HT frequency to 1.8GHz"
129 config LIMIT_HT_SPEED_2000
130         bool "Limit HT frequency to 2.0GHz"
131 config LIMIT_HT_SPEED_2200
132         bool "Limit HT frequency to 2.2GHz"
133 config LIMIT_HT_SPEED_2400
134         bool "Limit HT frequency to 2.4GHz"
135 config LIMIT_HT_SPEED_2600
136         bool "Limit HT frequency to 2.6GHz"
137 config LIMIT_HT_SPEED_AUTO
138         bool "Autodetect HT frequency"
139 endchoice
140
141 choice
142         prompt "HyperTransport downlink width"
143         default LIMIT_HT_DOWN_WIDTH_16
144         help
145           This option sets the maximum permissible HyperTransport
146           downlink width.
147
148           Use of this option will only limit the autodetected HT width.
149           It will not (and cannot) increase the width beyond the autodetected
150           limits.
151
152           This is primarily used to work around poorly designed or laid out HT
153           traces on certain motherboards.
154
155 config LIMIT_HT_DOWN_WIDTH_8
156         bool "8 bits"
157 config LIMIT_HT_DOWN_WIDTH_16
158         bool "16 bits"
159 endchoice
160
161 choice
162         prompt "HyperTransport uplink width"
163         default LIMIT_HT_UP_WIDTH_16
164         help
165           This option sets the maximum permissible HyperTransport
166           uplink width.
167
168           Use of this option will only limit the autodetected HT width.
169           It will not (and cannot) increase the width beyond the autodetected
170           limits.
171
172           This is primarily used to work around poorly designed or laid out HT
173           traces on certain motherboards.
174
175 config LIMIT_HT_UP_WIDTH_8
176         bool "8 bits"
177 config LIMIT_HT_UP_WIDTH_16
178         bool "16 bits"
179 endchoice
180
181 endmenu
182
183 source src/northbridge/Kconfig
184 comment "Southbridge"
185 source src/southbridge/Kconfig
186 comment "Super I/O"
187 source src/superio/Kconfig
188 comment "Devices"
189 source src/devices/Kconfig
190
191 endmenu
192
193 config PCI_BUS_SEGN_BITS
194         int
195         default 0
196
197 config MAINBOARD_PCI_SUBSYSTEM_VENDOR_ID
198         hex
199         default 0x0
200
201 config MAINBOARD_PCI_SUBSYSTEM_DEVICE_ID
202         hex
203         default 0x0
204
205 config CPU_ADDR_BITS
206         int
207         default 36
208
209 config XIP_ROM_BASE
210         hex
211         default 0xfffe0000
212
213 config XIP_ROM_SIZE
214         hex
215         default 0x20000
216
217 config LOGICAL_CPUS
218         bool
219         default y
220
221 config PCI_ROM_RUN
222         bool
223         default n
224
225 config HEAP_SIZE
226         hex
227         default 0x4000
228
229 config DEBUG
230         bool
231         default n
232
233 config USE_PRINTK_IN_CAR
234         bool
235         default n
236
237 config USE_OPTION_TABLE
238         bool
239         default n
240
241 config MAX_CPUS
242         int
243         default 1
244
245 config MMCONF_SUPPORT_DEFAULT
246         bool
247         default n
248
249 config MMCONF_SUPPORT
250         bool
251         default n
252
253 config RAMTOP
254         hex
255         default 0x200000
256
257 config ATI_RAGE_XL
258         bool
259
260 source src/console/Kconfig
261
262 config HAVE_ACPI_RESUME
263         bool
264         default n
265
266 config ACPI_SSDTX_NUM
267         int
268         default 0
269
270 config HAVE_HARD_RESET
271         bool
272         default y if BOARD_HAS_HARD_RESET
273         default n
274         help
275           This variable specifies whether a given board has a hard_reset
276           function, no matter if it's provided by board code or chipset code.
277
278 config HAVE_INIT_TIMER
279         bool
280         default n if UDELAY_IO
281         default y
282
283 config HAVE_MAINBOARD_RESOURCES
284         bool
285         default n
286
287 config HAVE_OPTION_TABLE
288         bool
289         default y
290         help
291           This variable specifies whether a given board has a cmos.layout
292           file containing NVRAM/CMOS bit definitions.
293           It defaults to 'y' but can be changed to 'n' in mainboard/*/Kconfig.
294
295 config PIRQ_ROUTE
296         bool
297         default n
298
299 config HAVE_SMI_HANDLER
300         bool
301         default n
302
303 config PCI_IO_CFG_EXT
304         bool
305         default n
306
307 config IOAPIC
308         bool
309         default n
310
311 # TODO: Can probably be removed once all chipsets have kconfig options for it.
312 config VIDEO_MB
313         int
314         default 0
315
316 config USE_WATCHDOG_ON_BOOT
317         bool
318         default n
319
320 config VGA
321         bool
322         default n
323         help
324           Build board-specific VGA code.
325
326 config GFXUMA
327         bool
328         default n
329         help
330           Enable Unified Memory Architecture for graphics.
331
332 # TODO
333 # menu "Drivers"
334 #
335 # endmenu
336
337 #TODO Remove this option or make it useful.
338 config HAVE_LOW_TABLES
339         bool
340         default y
341         help
342           This Option is unused in the code.  Since two boards try to set it to
343           'n', they may be broken.  We either need to make the option useful or
344           get rid of it.  The broken boards are:
345           asus/m2v-mx_se
346           supermicro/h8dme
347
348 config HAVE_HIGH_TABLES
349         bool
350         default y
351         help
352           This variable specifies whether a given northbridge has high table
353           support.
354           It is set in northbridge/*/Kconfig.
355           Whether or not the high tables are actually written by coreboot is
356           configurable by the user via WRITE_HIGH_TABLES.
357
358 config HAVE_ACPI_TABLES
359         bool
360         help
361           This variable specifies whether a given board has ACPI table support.
362           It is usually set in mainboard/*/Kconfig.
363           Whether or not the ACPI tables are actually generated by coreboot
364           is configurable by the user via GENERATE_ACPI_TABLES.
365
366 config HAVE_MP_TABLE
367         bool
368         help
369           This variable specifies whether a given board has MP table support.
370           It is usually set in mainboard/*/Kconfig.
371           Whether or not the MP table is actually generated by coreboot
372           is configurable by the user via GENERATE_MP_TABLE.
373
374 config HAVE_PIRQ_TABLE
375         bool
376         help
377           This variable specifies whether a given board has PIRQ table support.
378           It is usually set in mainboard/*/Kconfig.
379           Whether or not the PIRQ table is actually generated by coreboot
380           is configurable by the user via GENERATE_PIRQ_TABLE.
381
382 #These Options are here to avoid "undefined" warnings.
383 #The actual selection and help texts are in the following menu.
384
385 config GENERATE_ACPI_TABLES
386         bool
387         default HAVE_ACPI_TABLES
388
389 config GENERATE_MP_TABLE
390         bool
391         default HAVE_MP_TABLE
392
393 config GENERATE_PIRQ_TABLE
394         bool
395         default HAVE_PIRQ_TABLE
396
397 config WRITE_HIGH_TABLES
398         bool
399         default HAVE_HIGH_TABLES
400
401 menu "System tables"
402
403 config WRITE_HIGH_TABLES
404         bool "Write 'high' tables to avoid being overwritten in F segment"
405         depends on HAVE_HIGH_TABLES
406         default y
407
408 config MULTIBOOT
409         bool "Generate Multiboot tables (for GRUB2)"
410         default y
411
412 config GENERATE_ACPI_TABLES
413         depends on HAVE_ACPI_TABLES
414         bool "Generate ACPI tables"
415         default y
416         help
417           Generate ACPI tables for this board.
418
419           If unsure, say Y.
420
421 config GENERATE_MP_TABLE
422         depends on HAVE_MP_TABLE
423         bool "Generate an MP table"
424         default y
425         help
426           Generate an MP table (conforming to the Intel MultiProcessor
427           specification 1.4) for this board.
428
429           If unsure, say Y.
430
431 config GENERATE_PIRQ_TABLE
432         depends on HAVE_PIRQ_TABLE
433         bool "Generate a PIRQ table"
434         default y
435         help
436           Generate a PIRQ table for this board.
437
438           If unsure, say Y.
439
440 endmenu
441
442 menu "Payload"
443
444 choice
445         prompt "Add a payload"
446         default PAYLOAD_NONE
447
448 config PAYLOAD_NONE
449         bool "None"
450         help
451           Select this option if you want to create an "empty" coreboot
452           ROM image for a certain mainboard, i.e. a coreboot ROM image
453           which does not yet contain a payload.
454
455           For such an image to be useful, you have to use 'cbfstool'
456           to add a payload to the ROM image later.
457
458 config PAYLOAD_ELF
459         bool "An ELF executable payload"
460         help
461           Select this option if you have a payload image (an ELF file)
462           which coreboot should run as soon as the basic hardware
463           initialization is completed.
464
465           You will be able to specify the location and file name of the
466           payload image later.
467
468 endchoice
469
470 config FALLBACK_PAYLOAD_FILE
471         string "Payload path and filename"
472         depends on PAYLOAD_ELF
473         default "payload.elf"
474         help
475           The path and filename of the ELF executable file to use as payload.
476
477 # TODO: Defined if no payload? Breaks build?
478 config COMPRESSED_PAYLOAD_LZMA
479         bool "Use LZMA compression for payloads"
480         default y
481         depends on PAYLOAD_ELF
482         help
483           In order to reduce the size payloads take up in the ROM chip
484           coreboot can compress them using the LZMA algorithm.
485
486 config COMPRESSED_PAYLOAD_NRV2B
487         bool
488         default n
489
490 endmenu
491
492 menu "VGA BIOS"
493
494 config VGA_BIOS
495         bool "Add a VGA BIOS image"
496         help
497           Select this option if you have a VGA BIOS image that you would
498           like to add to your ROM.
499
500           You will be able to specify the location and file name of the
501           image later.
502
503 config FALLBACK_VGA_BIOS_FILE
504         string "VGA BIOS path and filename"
505         depends on VGA_BIOS
506         default "vgabios.bin"
507         help
508           The path and filename of the file to use as VGA BIOS.
509
510 config FALLBACK_VGA_BIOS_ID
511         string "VGA device PCI IDs"
512         depends on VGA_BIOS
513         default "1106,3230"
514         help
515           The comma-separated PCI vendor and device ID that would associate
516           your VGA BIOS to your video card.
517
518           Example: 1106,3230
519
520           In the above example 1106 is the PCI vendor ID (in hex, but without
521           the "0x" prefix) and 3230 specifies the PCI device ID of the
522           video card (also in hex, without "0x" prefix).
523
524 config INTEL_MBI
525         bool "Add an MBI image"
526         depends on NORTHBRIDGE_INTEL_I82830
527         help
528           Select this option if you have an Intel MBI image that you would
529           like to add to your ROM.
530
531           You will be able to specify the location and file name of the
532           image later.
533
534 config FALLBACK_MBI_FILE
535         string "Intel MBI path and filename"
536         depends on INTEL_MBI
537         default "mbi.bin"
538         help
539           The path and filename of the file to use as VGA BIOS.
540
541 endmenu
542
543 menu "Bootsplash"
544         depends on PCI_OPTION_ROM_RUN_YABEL
545
546 config BOOTSPLASH
547         prompt "Show graphical bootsplash"
548         bool
549         depends on PCI_OPTION_ROM_RUN_YABEL
550         help
551           This option shows a graphical bootsplash screen. The grapics are
552           loaded from the CBFS file bootsplash.jpg.
553
554 config FALLBACK_BOOTSPLASH_FILE
555         string "Bootsplash path and filename"
556         depends on BOOTSPLASH
557         default "bootsplash.jpg"
558         help
559           The path and filename of the file to use as graphical bootsplash 
560           screen. The file format has to be jpg. 
561
562 # TODO: Turn this into a "choice".
563 config FRAMEBUFFER_VESA_MODE
564         prompt "VESA framebuffer video mode"
565         hex
566         default 0x117
567         depends on BOOTSPLASH
568         help
569           This option sets the resolution used for the coreboot framebuffer and
570           bootsplash screen. Set to 0x117 for 1024x768x16. A diligent soul will
571           some day make this a "choice".
572
573 config COREBOOT_KEEP_FRAMEBUFFER
574         prompt "Keep VESA framebuffer"
575         bool
576         depends on BOOTSPLASH
577         help
578           This option keeps the framebuffer mode set after coreboot finishes
579           execution. If this option is enabled, coreboot will pass a
580           framebuffer entry in its coreboot table and the payload will need a
581           framebuffer driver. If this option is disabled, coreboot will switch
582           back to text mode before handing control to a payload.
583
584 endmenu
585
586 menu "Debugging"
587
588 # TODO: Better help text and detailed instructions.
589 config GDB_STUB
590         bool "GDB debugging support"
591         default y
592         help
593           If enabled, you will be able to set breakpoints for gdb debugging.
594           See src/arch/i386/lib/c_start.S for details.
595
596 config DEBUG_RAM_SETUP
597         bool "Output verbose RAM init debug messages"
598         default n
599         depends on (NORTHBRIDGE_AMD_AMDFAM10 \
600                  || NORTHBRIDGE_AMD_AMDK8 \
601                  || NORTHBRIDGE_VIA_CN700 \
602                  || NORTHBRIDGE_VIA_CX700 \
603                  || NORTHBRIDGE_VIA_VX800 \
604                  || NORTHBRIDGE_INTEL_E7501 \
605                  || NORTHBRIDGE_INTEL_I440BX \
606                  || NORTHBRIDGE_INTEL_I82810 \
607                  || NORTHBRIDGE_INTEL_I82830 \
608                  || NORTHBRIDGE_INTEL_I945)
609         help
610           This option enables additional RAM init related debug messages.
611           It is recommended to enable this when debugging issues on your
612           board which might be RAM init related.
613
614           Note: This option will increase the size of the coreboot image.
615
616           If unsure, say N.
617
618 config DEBUG_SMBUS
619         bool "Output verbose SMBus debug messages"
620         default n
621         depends on (SOUTHBRIDGE_VIA_VT8237R \
622                  || NORTHBRIDGE_VIA_VX800 \
623                  || NORTHBRIDGE_VIA_CX700 \
624                  || NORTHBRIDGE_AMD_AMDK8 \
625                  || NORTHBRIDGE_AMD_AMDFAM10)
626         help
627           This option enables additional SMBus (and SPD) debug messages.
628
629           Note: This option will increase the size of the coreboot image.
630
631           If unsure, say N.
632
633 config DEBUG_SMI
634         bool "Output verbose SMI debug messages"
635         default n
636         depends on HAVE_SMI_HANDLER
637         help
638           This option enables additional SMI related debug messages.
639
640           Note: This option will increase the size of the coreboot image.
641
642           If unsure, say N.
643
644 config X86EMU_DEBUG
645         bool "Output verbose x86emu debug messages"
646         default n
647         depends on PCI_OPTION_ROM_RUN_YABEL
648         help
649           This option enables additional x86emu related debug messages.
650
651           Note: This option will increase the size of the coreboot image.
652
653           If unsure, say N.
654
655 config X86EMU_DEBUG_JMP
656         bool "Trace JMP/RETF"
657         default n
658         depends on X86EMU_DEBUG
659         help
660           Print information about JMP and RETF opcodes from x86emu.
661
662           Note: This option will increase the size of the coreboot image.
663
664           If unsure, say N.
665
666 config X86EMU_DEBUG_TRACE
667         bool "Trace all opcodes"
668         default n
669         depends on X86EMU_DEBUG
670         help
671           Print _all_ opcodes that are executed by x86emu.
672           
673           WARNING: This will produce a LOT of output and take a long time.
674
675           Note: This option will increase the size of the coreboot image.
676
677           If unsure, say N.
678
679 config X86EMU_DEBUG_PNP
680         bool "Log Plug&Play accesses"
681         default n
682         depends on X86EMU_DEBUG
683         help
684           Print Plug And Play accesses made by option ROMs.
685
686           Note: This option will increase the size of the coreboot image.
687
688           If unsure, say N.
689
690 config X86EMU_DEBUG_DISK
691         bool "Log Disk I/O"
692         default n
693         depends on X86EMU_DEBUG
694         help
695           Print Disk I/O related messages.
696
697           Note: This option will increase the size of the coreboot image.
698
699           If unsure, say N.
700
701 config X86EMU_DEBUG_PMM
702         bool "Log PMM"
703         default n
704         depends on X86EMU_DEBUG
705         help
706           Print messages related to POST Memory Manager (PMM).
707
708           Note: This option will increase the size of the coreboot image.
709
710           If unsure, say N.
711
712
713 config X86EMU_DEBUG_VBE
714         bool "Debug VESA BIOS Extensions"
715         default n
716         depends on X86EMU_DEBUG
717         help
718           Print messages related to VESA BIOS Extension (VBE) functions.
719
720           Note: This option will increase the size of the coreboot image.
721
722           If unsure, say N.
723
724 config X86EMU_DEBUG_INT10
725         bool "Redirect INT10 output to console"
726         default n
727         depends on X86EMU_DEBUG
728         help
729           Let INT10 (i.e. character output) calls print messages to debug output.
730
731           Note: This option will increase the size of the coreboot image.
732
733           If unsure, say N.
734
735 config X86EMU_DEBUG_INTERRUPTS
736         bool "Log intXX calls"
737         default n
738         depends on X86EMU_DEBUG
739         help
740           Print messages related to interrupt handling.
741
742           Note: This option will increase the size of the coreboot image.
743
744           If unsure, say N.
745
746 config X86EMU_DEBUG_CHECK_VMEM_ACCESS
747         bool "Log special memory accesses"
748         default n
749         depends on X86EMU_DEBUG
750         help
751           Print messages related to accesses to certain areas of the virtual
752           memory (e.g. BDA (BIOS Data Area) or interrupt vectors)
753
754           Note: This option will increase the size of the coreboot image.
755
756           If unsure, say N.
757
758 config X86EMU_DEBUG_MEM
759         bool "Log all memory accesses"
760         default n
761         depends on X86EMU_DEBUG
762         help
763           Print memory accesses made by option ROM.
764           Note: This also includes accesses to fetch instructions.
765
766           Note: This option will increase the size of the coreboot image.
767
768           If unsure, say N.
769
770 config X86EMU_DEBUG_IO
771         bool "Log IO accesses"
772         default n
773         depends on X86EMU_DEBUG
774         help
775           Print I/O accesses made by option ROM.
776
777           Note: This option will increase the size of the coreboot image.
778
779           If unsure, say N.
780
781 config LLSHELL
782         bool "Built-in low-level shell"
783         default n
784         help
785           If enabled, you will have a low level shell to examine your machine.
786           Put llshell() in your (romstage) code to start the shell.
787           See src/arch/i386/llshell/llshell.inc for details.
788
789 endmenu
790
791 config LIFT_BSP_APIC_ID
792         bool
793         default n
794
795 # These probably belong somewhere else, but they are needed somewhere.
796 config AP_CODE_IN_CAR
797         bool
798         default n
799
800 config ENABLE_APIC_EXT_ID
801         bool
802         default n
803
804 config WARNINGS_ARE_ERRORS
805         bool
806         default n
807
808 config ID_SECTION_OFFSET
809         hex
810         default 0x10
811
812 source src/Kconfig.deprecated_options