diff --git a/doc/configuration.adoc b/doc/configuration.adoc index f088960..28a7a37 100644 --- a/doc/configuration.adoc +++ b/doc/configuration.adoc @@ -1,7 +1,7 @@ == Configuration -There are many things you can specify in a configuration, but these are -the ones you most commonly need to change: +There are many things you can specify in a configuration, but most +commonly you need to change: * which services (processes) to run * what packages to install diff --git a/doc/installation.adoc b/doc/installation.adoc index dc40f41..c6a963d 100644 --- a/doc/installation.adoc +++ b/doc/installation.adoc @@ -55,7 +55,7 @@ early boot, the risk of "bricking" is substantially reduced and you have options for recovering if you misstep or flash a bad image. [[serial]] -==== U-Boot and serial shenanigans +==== Serial connections Every device that we have so far encountered in Liminix uses https://docs.u-boot.org/en/latest/[U-Boot, the "Universal Boot @@ -97,7 +97,9 @@ When you turn the router on you should be greeted with some messages from U-Boot, followed by the instruction to hit some key to stop autoboot. Do this and you will get to the prompt. If you didn't see anything, the strong likelihood is that TX and RX are the wrong way -around. If you see garbage, try a different speed. +around, or your computer is expecting flow control which the 3 wire +connection does not provide. . If you see garbage, try a different +speed. Interesting commands to try first in U-Boot are `+help+` and `+printenv+`. diff --git a/doc/tutorial.adoc b/doc/tutorial.adoc index 2b96e81..7fd1184 100644 --- a/doc/tutorial.adoc +++ b/doc/tutorial.adoc @@ -136,12 +136,12 @@ to attach serial cables to (soldering not required), so it is lower-risk than some devices. Using some other Liminix-supported MIPS hardware device also _ought_ to work here, but you accept the slightly greater bricking risk if it doesn't. -==== See <<_supported_hardware>> for device support status. +==== -You may want to read and inwardly digest the section about <> -connections when you start working with Liminix on real hardware. You +You may want to read and inwardly digest the section on <> +when you start working with Liminix on real hardware. You won't _need_ serial access for this example, assuming it works, but it allows you to see the boot monitor and kernel messages, and to login directly to the device if for some reason it doesn't bring its network