renamed and clarified serial chapter, cleaned up UART chapter a bit#80
Merged
Conversation
BartMassey
force-pushed
the
serial-intro
branch
from
ea3c951 to
a399c36
Compare
iampi31415
reviewed
Nov 27, 2025
iampi31415
reviewed
Nov 27, 2025
BartMassey
force-pushed
the
serial-intro
branch
3 times, most recently
from
ef9ff3e to
d3b8c4e
Compare
iampi31415
reviewed
Dec 2, 2025
BartMassey
commented
Dec 2, 2025
BartMassey
commented
Dec 2, 2025
BartMassey
commented
Dec 2, 2025
therealprof
reviewed
Dec 2, 2025
therealprof
reviewed
Dec 2, 2025
therealprof
reviewed
Dec 2, 2025
| the text UI will *not* echo back what you type. If you pay attention to the yellow LED | ||
| on top of the MB2 though, you will notice that it blinks whenever you type something. | ||
|
|
||
| ## `minicom` commands |
Contributor
There was a problem hiding this comment.
I've never quite understood why people use minicom. 🤷🏻♂️ screen is much easier and nicer to use and more readily available on a lot of systems, including macOS.
Member
Author
There was a problem hiding this comment.
I'm not a huge minicom fan either, but I decided not to fight that battle yet. I haven't tried using screen as a serial terminal: if you wanted to write a tutorial for that (or know of where a good one is) that would be cool.
BartMassey
commented
Dec 2, 2025
| <a href="https://en.wikipedia.org/wiki/I2C#/media/File:I2C_controller-target.svg"> | ||
| <p align="center"> | ||
| <img class="white_bg" height="360" title="I2C bus" src="../assets/i2c-bus.svg" /> | ||
| <img height="360" title="I2C Controller and Targets" src="https://en.wikipedia.org/wiki/I2C#/media/File:I2C_controller-target.svg" /> |
Member
Author
There was a problem hiding this comment.
I want to handle all the Wikipedia/Wikimedia links in the Book the same way; I'll try to figure out what the best plan is.
<p align="center"> is standard pre-CSS HTML that still works. I will probably replace it with CSS styling for images shortly, but would like to get this PR finished before I go hacking at this stuff again.
BartMassey
force-pushed
the
serial-intro
branch
2 times, most recently
from
6533752 to
9f123a9
Compare
The description of serial ports and serial communication was pretty confusing: now it's much cleaner. The new chapter name `Serial Port` should help, as it unambiguously describes the thing we will actually be working with. The I2C chapter had some slightly weird stuff going on that was fixed up a bit. The handling of figures was cleaned up. A Wikimedia Commons diagram that was incorrectly copied instead of linked was fixed. Figure background was added and slightly darkened with additional CSS to work reasonably with dark-mode reading. Thanks much to Github @iampi31 for contributions and feedback that became part of this PR. closes #78, closes #79, closes #81
BartMassey
force-pushed
the
serial-intro
branch
from
9f123a9 to
325af0a
Compare
BartMassey
force-pushed
the
serial-intro
branch
2 times, most recently
from
7217a44 to
e628f50
Compare
BartMassey
force-pushed
the
serial-intro
branch
from
e628f50 to
6dc95bf
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
3 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
The description of serial ports and serial communication was pretty confusing: now it's much cleaner. The new chapter name
Serial Portshould help, as it unambiguously describes the thing we will actually be working with.closes #78