mirror of
https://github.com/hsoft/collapseos.git
synced 2024-09-07 19:58:46 +10:00
Recipes contain bits and pieces of hardware-related knowledge, but these bits feel sparse. I've been wanting to consolidate hardware- related documentation for a while, but always fell at odds with the recipes organisation. We don't have recipes anymore, just a /doc/hw section that contains hardware-related documentation which often translate to precise instructions to run Collapse OS on a specific machine. With this new organisation, I hope to end up with a better, more solid documentation.
23 lines
812 B
Plaintext
23 lines
812 B
Plaintext
# Using Zilog's SIO as a console
|
|
|
|
The RC2014 has an optional module called the Dual Serial Module
|
|
SIO/2 which is built around Zilog's SIO chip. This module is
|
|
nice because when paired with the Dual Clock Module and when
|
|
using port B, it's possible to run a UART with a baud rate lower
|
|
than 115200.
|
|
|
|
Collapse OS has a driver for it (although for now, only port A
|
|
is supported by it). Let's use it.
|
|
|
|
* Let's assume a xcomp unit similar to the one in
|
|
/arch/z80/rc2014.
|
|
* Locate SIO driver in /arch/z80/rc2014/blk
|
|
* The driver main page gives you references for declarations and
|
|
for code.
|
|
* In the base xcomp unit, replace ACIA declarations with SIO's
|
|
* Replace ACIA code with SIO's
|
|
* At the bottom, replace "ACIA$" with "SIO$".
|
|
|
|
Rebuild the binary and you're done. "(key)" and "(emit)" will
|
|
go through the SIO.
|