renamed and clarified serial chapter, cleaned up UART chapter a bit #80
Conversation
BartMassey
force-pushed
the
serial-intro
branch
from
ea3c951 to
a399c36
Compare
BartMassey
force-pushed
the
serial-intro
branch
3 times, most recently
from
ef9ff3e to
d3b8c4e
Compare
| 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 |
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.
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.
There was a problem hiding this comment.
Supporting a small tutorial / section on screen as well. I've only used it once, and it was neat.
| <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" /> |
There was a problem hiding this comment.
A few issues here:
-
If you save as PDF, at least in my browser, the image is missing, only the link remains.
-
So I recommend keeping
"../assets/i2c-bus.svg", which works fine.- This option needs
class="white_bg"or it will break again.
- This option needs
-
And here is the
altattribute (taken from Wikipedia's image footer.):alt="The schematic shows controller (a microcontroller), three target nodes (an ADC, a DAC, and a microcontroller), and pull-up resistors Rp." -
Also,
<p align="center">does not exist to my knowledge? (I mean theattribute=value)
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
3 participants
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