coreboot-kgpe-d16/Documentation
Tim Wawrzynczak 13e240c602 util/sconfig: Add support for discontiguous FW_CONFIG fields
Sooner or later, some board was going to need extra FW_CONFIG bits for
a field that was already in production, so this patch adds support for
adding extra (unused) bits to a field.

The extra are appended via a syntax like:
`field FIELD_NAME START0 END0 | START1 END1 | START2 END2 ...`
and the suffixed bits are all treated as if they are contiguous when
defining option values.

BUG=b:185190978
TEST=Modified volteer fw_config to the following:
field AUDIO 8 10 | 29 29 | 31 31
        option NONE 0
	option MAX98357_ALC5682I_I2S 1
        option MAX98373_ALC5682I_I2S 2
	option MAX98373_ALC5682_SNDW 3
        option MAX98373_ALC5682I_I2S_UP4 4
        option MAX98360_ALC5682I_I2S 5
        option RT1011_ALC5682I_I2S 6
        option AUDIO_FOO 7
	option AUDIO_BAR 8
        option AUDIO_QUUX 9
        option AUDIO_BLAH1 10
        option AUDIO_BLAH2 15
        option AUDIO_BLAH3 16
        option AUDIO_BLAH4 31
end

which yielded (in static_fw_config.h):
 FW_CONFIG_FIELD_AUDIO_MASK 0xa0000700
 FW_CONFIG_FIELD_AUDIO_OPTION_NONE_VALUE 0x0
 FW_CONFIG_FIELD_AUDIO_OPTION_MAX98357_ALC5682I_I2S_VALUE 0x100
 FW_CONFIG_FIELD_AUDIO_OPTION_MAX98373_ALC5682I_I2S_VALUE 0x200
 FW_CONFIG_FIELD_AUDIO_OPTION_MAX98373_ALC5682_SNDW_VALUE 0x300
 FW_CONFIG_FIELD_AUDIO_OPTION_MAX98373_ALC5682I_I2S_UP4_VALUE 0x400
 FW_CONFIG_FIELD_AUDIO_OPTION_MAX98360_ALC5682I_I2S_VALUE 0x500
 FW_CONFIG_FIELD_AUDIO_OPTION_RT1011_ALC5682I_I2S_VALUE 0x600
 FW_CONFIG_FIELD_AUDIO_OPTION_AUDIO_FOO_VALUE 0x700
 FW_CONFIG_FIELD_AUDIO_OPTION_AUDIO_BAR_VALUE 0x20000000
 FW_CONFIG_FIELD_AUDIO_OPTION_AUDIO_QUUX_VALUE 0x20000100
 FW_CONFIG_FIELD_AUDIO_OPTION_AUDIO_BLAH1_VALUE 0x20000200
 FW_CONFIG_FIELD_AUDIO_OPTION_AUDIO_BLAH2_VALUE 0x20000700
 FW_CONFIG_FIELD_AUDIO_OPTION_AUDIO_BLAH3_VALUE 0x80000000
 FW_CONFIG_FIELD_AUDIO_OPTION_AUDIO_BLAH4_VALUE 0xa0000700

Change-Id: I5ed76706347ee9642198efc77139abdc3af1b8a6
Signed-off-by: Tim Wawrzynczak <twawrzynczak@chromium.org>
Reviewed-on: https://review.coreboot.org/c/coreboot/+/52747
Reviewed-by: Duncan Laurie <duncan@iceblink.org>
Tested-by: build bot (Jenkins) <no-reply@coreboot.org>
2021-05-03 07:40:57 +00:00
..
Intel mb,soc/intel: Rename acpi_fill_in_fadt() to acpi_fill_fadt() 2020-06-07 21:45:45 +00:00
RFC [RFC] Address the leftover TODO in soc/intel/cannonlake 2021-04-16 17:42:12 +00:00
_static
acpi acpi/acpigen.h: Add more intuitive AML package closing functions 2021-03-22 11:21:55 +00:00
arch Documentation: Add known bugs of x86_64 code on real hardware 2021-01-12 13:36:30 +00:00
cbfstool Docs/cbfstool: Add details about memory mapped window handling 2020-12-11 01:11:16 +00:00
community Documentation: List the leadership meeting as one of our forums 2021-04-15 19:11:01 +00:00
contributing Documentation/coding_style: Issues not mentioned and cleanup patches 2021-03-26 05:09:40 +00:00
doxygen
drivers Documentation: Fix toctree and remove dead links 2021-01-12 13:36:36 +00:00
flash_tutorial
getting_started device: Add unit to Kconfig option name: `PRE_GRAPHICS_DELAY_MS` 2021-02-15 17:05:18 +00:00
gfx drivers/intel/gma: Add override for presence straps 2020-05-20 23:38:05 +00:00
ifdtool Documentation: Use correct KiB/MiB units instead of KB/MB 2021-02-09 07:47:41 +00:00
infrastructure Documentation: Add documentation on jenkins builders 2021-01-25 08:56:27 +00:00
lib util/sconfig: Add support for discontiguous FW_CONFIG fields 2021-05-03 07:40:57 +00:00
mainboard docs/mb/supermicro/x11ssm-f: rework flashing section 2021-04-29 05:23:38 +00:00
northbridge
releases Documentation/releases: Add note about CBFS stage format change 2021-03-18 08:21:02 +00:00
security google/trogdor: Add new variant Marzipan 2021-03-20 01:31:06 +00:00
soc sc7280: Provide initial SoC support 2021-04-15 19:07:26 +00:00
superio
technotes Documentation: Add ASan documentation 2020-09-21 07:45:37 +00:00
tutorial Documentation: Describe the site-local hook in our config/build system 2021-03-17 23:07:07 +00:00
vendorcode
.gitignore .gitignore: Split into subdirectory files 2020-10-30 07:05:27 +00:00
AMD-S3.txt
COPYING
Doxyfile.coreboot
Doxyfile.coreboot_simple
Makefile
Makefile.sphinx Documentation: Add several fixes 2020-07-01 21:51:26 +00:00
POSTCODES
beginverbatim.tex
cbfs.txt
codeflow.svg
conf.py Documentation: Fix sphinx configuration 2020-08-04 12:18:29 +00:00
corebootBuildingGuide.tex
coreboot_logo.png
distributions.md
endverbatim.tex
gcov.txt
hypertransport.svg
index.md Documentation: move `coding_style.md` inside contributing/ 2021-02-22 07:20:59 +00:00
mainboard_io_trap_handler_sample.c ACPI GNVS: Replace uses of smm_get_gnvs() 2020-07-01 05:14:24 +00:00
payloads.md
util.md Update util.md documentation 2021-01-28 20:17:11 +00:00