Christoph Pomaska has uploaded this change for review. ( https://review.coreboot.org/c/coreboot/+/35912 )
Change subject: [WIP] Documentation/basics: Add Super I/O section ......................................................................
[WIP] Documentation/basics: Add Super I/O section
This file contains and is supposed to contain basic information about what a Super I/O is and what it does.
Change-Id: If288dcd79c4622a712868229b18f8b38e71d4af9 Signed-off-by: Christoph Pomaska c.pomaska@hosting.de --- A Documentation/basics/superio.md 1 file changed, 29 insertions(+), 0 deletions(-)
git pull ssh://review.coreboot.org:29418/coreboot refs/changes/12/35912/1
diff --git a/Documentation/basics/superio.md b/Documentation/basics/superio.md new file mode 100644 index 0000000..5f17a4c --- /dev/null +++ b/Documentation/basics/superio.md @@ -0,0 +1,29 @@ +# What is super I/O? + +Super I/O chips are a component that exist in PCs since the 1980s +and are usually connected via ISA/LPC. They are specific to x86 based platforms. + +Super I/O components have a wide range of tasks, from which the most widely known are: +- serial (e.g. RS232) +- PS/2 +- parallel (IEEE 1284) +- floppy-disk-controller +- PECI (Platform Enviroment Controller Interface) + +They can also act as an EC (Embedded Controller) managing things like: +- fancontrol +- battery charge controlling (on laptops) +- LED control + +BMC (Board Management Controller) and manage IPMI (Intelligent Platform Management Interface). +Very most x86 mainboards have at least one Super I/O chip. + +In case of the Supermicro [X10SLM+-F](https://www.supermicro.com/en/products/motherboard/x10slm+-f) there is a Nuvoton NCT6776 and an Aspeed AST2400 used. +The Nuvoton chip manages serial, PS/2 and hardware monitoring while the Aspeed chip manages the BMC functionality. +As another example does the Supermicro X11SSH-TF board solely use the same Aspeed chip as BMC, but also for serial. + + +## Super I/O and coreboot +The registers that need to be configured to make a Super I/O work are mostly vendor-specific, but sometimes also chip-specific. +coreboot ships a tool called [superiotool](../util.md) that reads out the most commonly used registers to determine which chip could be used on the board. +Conveniently it also prints out the registers and their contents in case a superio is detected.
Hello Felix Held, Felix Singer,
I'd like you to reexamine a change. Please visit
https://review.coreboot.org/c/coreboot/+/35912
to look at the new patch set (#2).
Change subject: [WIP] Documentation/basics: Add Super I/O section ......................................................................
[WIP] Documentation/basics: Add Super I/O section
This file contains and is supposed to contain basic information about what a Super I/O is and what it does.
Change-Id: If288dcd79c4622a712868229b18f8b38e71d4af9 Signed-off-by: Christoph Pomaska c.pomaska@hosting.de --- M Documentation/basics/index.md A Documentation/basics/superio.md 2 files changed, 31 insertions(+), 0 deletions(-)
git pull ssh://review.coreboot.org:29418/coreboot refs/changes/12/35912/2
Hello Felix Held, Felix Singer, build bot (Jenkins),
I'd like you to reexamine a change. Please visit
https://review.coreboot.org/c/coreboot/+/35912
to look at the new patch set (#3).
Change subject: [WIP] Documentation/basics: Add Super I/O section ......................................................................
[WIP] Documentation/basics: Add Super I/O section
This file contains and is supposed to contain basic information about what a Super I/O is and what it does.
Change-Id: If288dcd79c4622a712868229b18f8b38e71d4af9 Signed-off-by: Christoph Pomaska c.pomaska@hosting.de --- M Documentation/basics/index.md A Documentation/basics/superio.md 2 files changed, 35 insertions(+), 0 deletions(-)
git pull ssh://review.coreboot.org:29418/coreboot refs/changes/12/35912/3
Hello Felix Held, Felix Singer, build bot (Jenkins),
I'd like you to reexamine a change. Please visit
https://review.coreboot.org/c/coreboot/+/35912
to look at the new patch set (#4).
Change subject: [WIP] Documentation/basics: Add Super I/O section ......................................................................
[WIP] Documentation/basics: Add Super I/O section
This file contains and is supposed to contain basic information about what a Super I/O is and what it does.
Change-Id: If288dcd79c4622a712868229b18f8b38e71d4af9 Signed-off-by: Christoph Pomaska c.pomaska@hosting.de --- M Documentation/basics/index.md A Documentation/basics/superio.md 2 files changed, 35 insertions(+), 0 deletions(-)
git pull ssh://review.coreboot.org:29418/coreboot refs/changes/12/35912/4
Paul Menzel has posted comments on this change. ( https://review.coreboot.org/c/coreboot/+/35912 )
Change subject: [WIP] Documentation/basics: Add Super I/O section ......................................................................
Patch Set 4:
(5 comments)
Maybe link to wiki.osdev.org and Wikipedia(?)?
https://review.coreboot.org/c/coreboot/+/35912/4/Documentation/basics/superi... File Documentation/basics/superio.md:
https://review.coreboot.org/c/coreboot/+/35912/4/Documentation/basics/superi... PS4, Line 4: and are usually Fits on the line above?
https://review.coreboot.org/c/coreboot/+/35912/4/Documentation/basics/superi... PS4, Line 18: BMCs (Board Management Controller) - mostly found on server boards - are also connected via LPC and can manage Super I/O tasks next to their usual ones like: Wrap line?
https://review.coreboot.org/c/coreboot/+/35912/4/Documentation/basics/superi... PS4, Line 23: Very most x86 mainboards have at least one Super I/O chip. Most x86 …
https://review.coreboot.org/c/coreboot/+/35912/4/Documentation/basics/superi... PS4, Line 27: does the Supermicro X11SSH-TF *does* at the end
https://review.coreboot.org/c/coreboot/+/35912/4/Documentation/basics/superi... PS4, Line 33: superio Super I/O
Hello Felix Held, Felix Singer, build bot (Jenkins),
I'd like you to reexamine a change. Please visit
https://review.coreboot.org/c/coreboot/+/35912
to look at the new patch set (#5).
Change subject: [WIP] Documentation/basics: Add Super I/O section ......................................................................
[WIP] Documentation/basics: Add Super I/O section
This file contains and is supposed to contain basic information about what a Super I/O is and what it does.
Change-Id: If288dcd79c4622a712868229b18f8b38e71d4af9 Signed-off-by: Christoph Pomaska c.pomaska@hosting.de --- M Documentation/basics/index.md A Documentation/basics/superio.md 2 files changed, 35 insertions(+), 0 deletions(-)
git pull ssh://review.coreboot.org:29418/coreboot refs/changes/12/35912/5
Felix Held has posted comments on this change. ( https://review.coreboot.org/c/coreboot/+/35912 )
Change subject: [WIP] Documentation/basics: Add Super I/O section ......................................................................
Patch Set 5:
(3 comments)
https://review.coreboot.org/c/coreboot/+/35912/5/Documentation/basics/superi... File Documentation/basics/superio.md:
https://review.coreboot.org/c/coreboot/+/35912/5/Documentation/basics/superi... PS5, Line 10: - floppy-disk-controller no dashes needed
https://review.coreboot.org/c/coreboot/+/35912/5/Documentation/basics/superi... PS5, Line 14: - fancontrol fan control. it only is in the ec part if the sio has an ec part; otherwise it's in the hardware monitor or environment controller
https://review.coreboot.org/c/coreboot/+/35912/5/Documentation/basics/superi... PS5, Line 23: Very most "most" is sufficient; "very most" sounds wrong to me
Martin L Roth has abandoned this change. ( https://review.coreboot.org/c/coreboot/+/35912?usp=email )
Change subject: [WIP] Documentation/basics: Add Super I/O section ......................................................................
Abandoned
This patch has not been touched in over 12 months. Anyone who wants to take over work on this patch, please feel free to restore it and do any work needed to get it merged. If you create a new patch based on this work, please credit the original author.